# Runner AI
> Help guides, documentation, and policies for the Runner AI platform.
# Konto und Einstellungen
Source: https://www.runnerai.com/docs/de/guides/account-and-settings
Runner gruppiert Einstellungen danach, wer oder was sie beeinflussen: der Arbeitsbereich, der aktuelle Shop oder Sie. Dies hält gemeinsame Abrechnung und Mitglieder getrennt von Shop-spezifischen Domains und Ihrem persönlichen Profil.
## Was dieser Leitfaden abdeckt
Sie werden wissen, wo sich jede Einstellungsgruppe befindet und welche Seiten eine Rolle, einen Plan, einen veröffentlichten Shop oder eine gestaffelte Funktion erfordern.
## Verfügbarkeit und Voraussetzungen
- Sie müssen angemeldet sein.
- Öffnen Sie **Einstellungen** über das Arbeitsbereichs- oder Projektmenü.
- Shop-Einstellungen werden nur angezeigt, wenn Sie Einstellungen aus einem Projekt öffnen.
- Prüfen Sie vor Änderungen den Arbeitsbereichs- oder Store-Namen in der Einstellungsseitenleiste. Persönliche Einstellungen erscheinen unter Ihrem Kontonamen.
- Um Sitzungen auf anderen Geräten zu beenden oder Ihr Konto zu löschen, wenden Sie sich an den Runner-Support. Siehe [Sicherheit und Sitzungen](/de/guides/account-and-settings/security-and-sessions).
- Einige Steuerelemente erfordern Arbeitsbereichsbesitzer- oder Admin-Berechtigung.
- Domain-, API-Schlüssel- und Experimente-Seiten können nach Plan, Veröffentlichungszustand oder gestaffelter Verfügbarkeit ausgeblendet oder gated sein.
## Öffnen Sie Einstellungen
1. Öffnen Sie im gewünschten Arbeitsbereich oder Projekt das entsprechende Menü.
2. Wählen Sie **Einstellungen**.
3. Prüfen Sie die Auswahl **Arbeitsbereich: _Arbeitsbereichsname_**. Wählen Sie dann eine Seite unter dieser Gruppe, unter **Store: _Store-Name_** oder unter Ihrem Kontonamen. Wenn Sie Einstellungen innerhalb eines Stores öffnen, kann zunächst dessen Seite Allgemein erscheinen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie die Überschriften für Arbeitsbereich und Store, bevor Sie eine Seite auswählen. Die Kontoeinstellungen stehen unter diesen Gruppen.
## Einstellungskarte
| Gruppe und Seite | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| Arbeitsbereich → **Allgemein** | Benennen oder beschreiben Sie den Arbeitsbereich. | Gültige Änderungen werden automatisch gespeichert. Die Gefahrenzone enthält auch Arbeitsbereich löschen. |
| Arbeitsbereich → **Mitglieder** | Laden Sie Personen ein und verwalten Sie aktiven oder ausstehenden Zugriff. | Besitzer können einladen, Einladungen stornieren oder Mitglieder entfernen; berechtigte Mitglieder können verlassen. |
| Arbeitsbereich → **Plan & Abrechnung** | Überprüfen Sie den aktuellen Plan und verfügbare Abrechnungsaktionen. | Plan-Karten, Bestätigung, Kasse, Abrechnungsverwaltung und zusätzliche Kreditoptionen werden je nach Kontostatus angezeigt. |
| Arbeitsbereich → **Nutzung & Credits** | Verstehen Sie Saldo, Quellen und Ausgaben. | Ein Datumsbereichs-Steuerelement aktualisiert die Zusammenfassung, das Diagramm, die Kategoriekarten und den Aktivitätsfeed. |
| Shop → **Allgemein** | Verwalten Sie die Identität und das Sucherscheinungsbild des aktuellen Shops. | Name, Seitentitel, Beschreibung, Favicon, Wasserzeichen und Steuerelemente zum Löschen des Shops werden angezeigt. |
| Shop → **Domain** | Verbinden, kaufen, erneuern oder übertragen Sie eine Domain. | Die Verfügbarkeit hängt von Plan, Veröffentlichung, Berechtigung und Domain-Zustand ab. |
| Shop → **Benutzerdefinierte Skripte** | Fügen Sie JavaScript zur Storefront hinzu. | Änderungen bleiben ungespeichert, bis Sie **Änderungen speichern** wählen. |
| Shop → **Agent** | Wählen Sie Skills aus, die in diesem Projekt verfügbar sind. | Sie können konfigurierbare Skills für diesen Shop hinzufügen oder deaktivieren. |
| Shop → **Experimente** | Konfigurieren Sie automatisierte Experimentziele und Verkehr. | Diese Beta-Seite wird nur angezeigt, wenn sie aktiviert ist, und erfordert einen veröffentlichten Shop. |
| Ihr Kontoname → **Meine Einstellungen** | Sprache, wöchentliche Leistungs-E-Mails und Oberflächentöne auswählen. | Einstellungen werden gespeichert; ein Sprachwechsel lädt die aktuelle Seite in der gewählten Sprache neu. |
| Ihr Kontoname → **API-Schlüssel** | Zugangsdaten für programmgesteuerten Zugriff erstellen. | Der vollständige geheime Schlüssel erscheint nur einmal. Ein Widerruf ist endgültig. Diese Seite ist nur bedingt verfügbar. |
## Wählen Sie den richtigen Umfang
1. Verwenden Sie **Arbeitsbereich** für Mitglieder, gemeinsame Credits, Plan und Abrechnung.
2. Verwenden Sie **Shop** für die aktuelle Storefront, Domain, Skripte und Projekt-Agent-Einstellungen.
3. Verwenden Sie **Persönlich** für Ihr Profil, Ihre Sprache und Ihre [API-Schlüssel](/de/guides/account-and-settings/api-keys).
4. Bestätigen Sie vor einer sensiblen Aktion die im Dialog angezeigten Arbeitsbereichs- und Shop-Namen.
## Häufige Zustände und Limits
- **Wird gespeichert…** gefolgt von **Gespeichert** bestätigt, dass ein Auto-Save-Feld abgeschlossen wurde.
- Ein deaktiviertes Steuerelement kann auf fehlende Berechtigung, ein Plan-Gate, eine Shop-Voraussetzung oder einen bereits laufenden Vorgang hinweisen.
- Abrechnungs- und Domain-Seiten zeigen die aktuellen Bedingungen und den Betrag. Verlassen Sie sich nicht auf einen alten Screenshot oder kopierten Preis.
- Destruktive Aktionen erfordern Bestätigung, aber die genaue Bestätigung unterscheidet sich je nach Aktion.
- Verborgene Seiten sollten nicht über kopierte Links geöffnet werden, es sei denn, die aktuelle Schnittstelle zeigt sie für Ihr Konto.
## Fehlerbehebung
- Wenn die Shop-Gruppe fehlt, schließen Sie Einstellungen, geben Sie das beabsichtigte Projekt ein und öffnen Sie Einstellungen erneut.
- Wenn eine Seite einen Upgrade- oder Veröffentlichungs-Zuerst-Zustand zeigt, schließen Sie diese Voraussetzung nur ab, wenn sie zu Ihrem beabsichtigten Workflow passt.
- Wenn ein Auto-Save fehlschlägt, bleibt der vorherige Wert oder kehrt zurück; korrigieren Sie das Feld und versuchen Sie es erneut.
- Wenn Sie unsicher sind, welcher Arbeitsbereich geändert wird, schließen Sie den Dialog und öffnen Sie Einstellungen erneut aus diesem Arbeitsbereich.
- Wenn Sie Hilfe zur Kontosicherheit benötigen, aber kein genehmigter Eintrag sichtbar ist, kontaktieren Sie stattdessen Runner-Support, anstatt eine direkte Route zu erraten.
## Verwandte Anleitungen
- [Arbeitsbereich Allgemein](/de/guides/account-and-settings/workspace-general)
- [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations)
- [Abonnementpläne](/de/guides/plans-and-billing/subscription-plans)
- [Shop Allgemein](/de/guides/account-and-settings/store-general)
- [Sicherheit und Sitzungen](/de/guides/account-and-settings/security-and-sessions)
---
# Experimente-Einstellungen
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/ai-lab
Experimente-Einstellungen konfigurieren automatisierte Storefront-Experimente für einen berechtigten veröffentlichten Shop. Verwenden Sie diese Funktion, wenn Sie Runner absichtlich dazu bringen möchten, ein ausgewähltes Geschäftsziel mit einem Teil Ihres Live-Verkehrs zu optimieren.
## Was dieser Leitfaden abdeckt
Sie werden wissen, wie Sie die Beta-Einstellung aktivieren, ein Ziel und eine Verkehrszuteilung wählen, speichern und Start- oder Stoppzustände erkennen.
## Verfügbarkeit und Voraussetzungen
- **Experimente** sind eine bedingte Beta-Seite und werden ausgeblendet, sofern sie nicht für das Konto aktiviert sind.
- Der Shop muss veröffentlicht sein. Ein Entwurf zeigt einen nicht verfügbaren Veröffentlichungszustand an.
- Das Aktivieren von Experimenten erfordert die Zustimmung zu den verknüpften **Experimente-Bedingungen**.
- Das Ändern von Live-Experimenteinstellungen kann sich auf Storefront-Besucher auswirken. Überprüfen Sie das ausgewählte Ziel und den Verkehr vor dem Speichern.
## Eingabepfad
Wählen Sie im entsprechenden Projekt **Einstellungen → Store: _Store-Name_ → Experimente**.
## Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Experimente aktivieren**-Schalter | Zeigen Sie die Experimente-Konfiguration des Shops an oder beenden Sie sie. | Das Einschalten zeigt Ziel- und Verkehrssteuerelemente an; Speichern sendet die aktivierte Konfiguration. Das Ausschalten einer aktiven Konfiguration startet das Stoppen. |
| **Experimente-Bedingungen** | Überprüfen Sie die Bedingungen, die mit der Aktivierung der Beta verknüpft sind. | Der Rechtsbereich wird in einem neuen Tab geöffnet. |
| **Definieren Sie Ihr Ziel** | Teilen Sie Runner mit, welche Metrik das Experiment verbessern soll. | Das Auswählen eines Ziels markiert diese Karte als aktiv. |
| **Verkehr**-Schieberegler/Eingabe | Wählen Sie den Anteil des Storefront-Verkehrs, der für Experimente zugewiesen ist. | Der Wert bleibt innerhalb des angezeigten Minimums und 100%. |
| Schnelle Prozentschaltflächen | Wählen Sie einen häufigen Verkehrswert. | Der Schieberegler und der numerische Wert werden zusammen aktualisiert. |
| **Speichern** | Wenden Sie die aktivierten Ziel- und Verkehrseinstellungen an. | Runner startet den Konfigurationsvorgang und deaktiviert Steuerelemente, bis dieser abgeschlossen ist. |
Verfügbare Ziele sind Konversionsrate, Zum-Warenkorb-Rate, Kasse-Initiiert-Rate, Banner-Engagement-Rate, Schaltflächen-Klickrate und durchschnittlicher Bestellwert.
Die folgenden Schritte gelten erst, wenn der Store veröffentlicht ist. Falls eine Modellauswahl angezeigt wird, prüfen Sie vor dem Speichern das verfügbare Modell; die Auswahl hängt von Ihrem Konto ab. Lesen Sie [Veröffentlichen](/de/guides/storefront-and-publishing), wenn der Store noch ein Entwurf ist.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Der unveröffentlichte Store zeigt eine Voraussetzung anstelle von Experimentkontrollen. Es wurde kein Experiment gestartet oder gemessen.
## Konfigurieren Sie Experimente
1. Veröffentlichen Sie den Shop und öffnen Sie dann **Shop → Experimente**.
2. Lesen Sie die Beta-Beschreibung und die **Experimente-Bedingungen**.
3. Schalten Sie **Experimente aktivieren** ein.
4. Wählen Sie ein Ziel.
5. Wählen Sie eine Verkehrszuteilung auf oder über dem angezeigten Minimum.
6. Überprüfen Sie das ausgewählte Ziel und den Prozentsatz.
7. Wählen Sie **Speichern**.
8. Warten Sie, bis der Startstatus abgeschlossen ist, und bestätigen Sie den gespeicherten Zustand, bevor Sie die Seite verlassen.
## Stoppen Sie Experimente
1. Kehren Sie zu den Experimente-Einstellungen desselben Shops zurück.
2. Schalten Sie **Experimente aktivieren** aus.
3. Warten Sie durch **Experiment wird gestoppt, bitte warten…**.
4. Bestätigen Sie den deaktivierten Zustand, nachdem der Vorgang endet.
Wiederholen Sie den Umschalter nicht, während ein Vorgang läuft.
## Zustände und Limits
- Ein unveröffentlichter Shop zeigt an, dass die Funktion derzeit nicht verfügbar ist, und fordert Sie auf, zuerst zu veröffentlichen.
- **Experiment wird gestartet, bitte warten…** blockiert gleichzeitige Änderungen.
- **Experiment wird gestoppt, bitte warten…** blockiert gleichzeitige Änderungen.
- Ziel ist erforderlich, bevor Sie speichern.
- Der Verkehr ist auf das angezeigte Minimum bis 100% begrenzt.
- Der gesamte Einstellungseintrag kann für Konten ohne die Funktion fehlen.
## Fehlerbehebung
- Wenn Experimente fehlt, verlassen Sie sich nicht auf einen kopierten direkten Link; die Funktion ist nicht für das Konto aktiviert.
- Wenn die Seite Sie auffordert zu veröffentlichen, schließen Sie die Veröffentlichung ab, bevor Sie ein Live-Experiment konfigurieren.
- Wenn Speichern meldet, dass ein Ziel erforderlich ist, wählen Sie eine Zielkarte aus und versuchen Sie es erneut.
- Wenn Steuerelemente deaktiviert sind, warten Sie, bis der aktuelle Start- oder Stoppvorgang abgeschlossen ist.
- Wenn der gespeicherte Zustand unklar ist, öffnen Sie die Seite erneut, bevor Sie erneut umschalten.
## Verwandte Anleitungen
- [Shop Allgemein](./store-general)
- [Abonnementpläne](../plans-and-billing/subscription-plans)
- [Konto- und Einstellungsübersicht](/de/guides/account-and-settings)
---
# API-Schlüssel
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/api-keys
API-Schlüssel sind persönliche Geheimnisse für programmatischen Runner-Zugriff. Erstellen Sie einen nur für eine Anwendung, der Sie vertrauen, speichern Sie ihn sicher und widerrufen Sie ihn, wenn er nicht mehr benötigt wird.
## Was dieser Leitfaden abdeckt
Sie werden wissen, wie Sie das einmalige Geheimnis erstellen und speichern, vorhandene Schlüssel identifizieren, ohne sie offenzulegen, und einen Schlüssel mit Bestätigung widerrufen.
## Verfügbarkeit und Voraussetzungen
- **API-Schlüssel** ist bedingt und wird nur angezeigt, wenn es für Ihr Konto aktiviert ist.
- Die Seite weist darauf hin, dass **jeder Schlüssel in Ihrem Namen handelt**. Die Schlüssel gehören zu Ihrem persönlichen Konto, nicht zu einem einzelnen Store.
- Verwechseln Sie diese Schlüssel nicht mit den schreibgeschützten **Analytics-API-Schlüsseln** unter [Arbeitsbereich – Allgemein](/de/guides/account-and-settings/workspace-general).
- Geben Sie niemals einen vollständigen Schlüssel in Chat, Agent Memory, eine Skill, einen Screenshot, die Quellcodeverwaltung oder die Produktdokumentation ein.
## Eingabepfad
Wählen Sie **Einstellungen → Ihr Kontoname → API-Schlüssel**. Fehlt der Eintrag, ist die Funktion für das aktuelle Konto nicht verfügbar.
## Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Neuen Schlüssel generieren** | Erstellen Sie eine neue Anmeldeinformation. | Ein Dialog wird mit einem optionalen Namensfeld geöffnet. |
| **Name** | Identifizieren Sie die Anwendung später, ohne das Geheimnis offenzulegen. | Der Name wird in der Schlüsseltabelle angezeigt; leer erstellt einen unbenannten Schlüssel. |
| **Schlüssel erstellen** | Generieren Sie die Anmeldeinformation. | Runner öffnet **API-Schlüssel generiert** und zeigt das vollständige Geheimnis einmal an. |
| Augensymbol | Überprüfen Sie den vollständigen neu generierten Wert, bevor Sie ihn speichern. | Der einmalige Wert wird im Erfolgsdialog angezeigt oder verborgen. |
| Kopiersymbol | Kopieren Sie den neuen Schlüssel genau. | Runner kopiert ihn in die Zwischenablage und zeigt eine Bestätigung an. |
| **Ich habe es gespeichert** | Schließen Sie die einmalige Geheimnisansicht. | Der vollständige Wert wird aus dem Dialog gelöscht und kann dort nicht erneut angezeigt werden. |
| Vorhandene Schlüsseltabelle | Identifizieren Sie Schlüssel sicher. | Runner zeigt Name, Präfix, Erstellt und Zuletzt verwendet an, nicht das vollständige Geheimnis. |
| Löschsymbol | Widerrufen Sie einen vorhandenen Schlüssel. | Eine Bestätigung erklärt, dass der Widerruf nicht rückgängig gemacht werden kann. |
| **Widerrufen** | Deaktivieren Sie den ausgewählten Schlüssel. | Nach dem Erfolg wird der Schlüssel aus der Liste entfernt und kann sich nicht mehr authentifizieren. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg0z7QP9dmUDVzwn9xNJv4t2isec7IFkOaWAro)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Die leere Liste zeigt den Ausgangszustand. In diesem Beispiel wurde kein geheimer Schlüssel erstellt oder angezeigt.
## Überprüfen Sie den Dialog, bevor Sie einen Berechtigungsnachweis erstellen
1. Wählen Sie **Neuen Schlüssel erstellen**.
2. Suchen Sie das optionale Feld **Name**. Eine Bezeichnung wie `Reporting integration` hilft Ihnen später, die Anwendung zu erkennen.
3. Wählen Sie **Abbrechen**, wenn Sie die Funktion nur kennenlernen möchten. Erst mit **Schlüssel erstellen** wird ein Schlüssel angelegt.
Der folgende Ablauf gilt, wenn API-Schlüssel verfügbar sind und Sie einen neuen geheimen Schlüssel sicher speichern können.
## Generieren und speichern Sie einen Schlüssel
1. Öffnen Sie **Ihr Kontoname → API-Schlüssel**.
2. Wählen Sie **Neuen Schlüssel generieren**.
3. Geben Sie einen beschreibenden Namen ein, z. B. die Anwendung oder Umgebung. Geben Sie kein Geheimnis in den Namen ein.
4. Wählen Sie **Schlüssel erstellen**.
5. Geben Sie in **API-Schlüssel generiert** den Schlüssel nur bei Bedarf frei und wählen Sie Kopieren.
6. Speichern Sie ihn in einem vertrauenswürdigen Secret Manager.
7. Bestätigen Sie den gespeicherten Wert, bevor Sie **Ich habe es gespeichert** wählen.
8. Verwenden Sie das Tabellenpräfix, um den Schlüssel später zu identifizieren, ohne den vollständigen Wert offenzulegen.
Runner warnt, dass der vollständige Schlüssel nicht erneut angezeigt wird. Wenn Sie den Dialog schließen, ohne ihn zu speichern, widerrufen Sie diesen Schlüssel und erstellen Sie einen Ersatz, anstatt zu versuchen, das Geheimnis wiederherzustellen.
## Widerrufen Sie einen Schlüssel
1. Stimmen Sie den beabsichtigten Schlüssel nach Name und Präfix ab.
2. Wählen Sie sein Löschsymbol.
3. Überprüfen Sie die **Widerrufen**-Bestätigung.
4. Wählen Sie **Widerrufen** nur, wenn die abhängige Anwendung bereit ist, ihn nicht mehr zu verwenden.
5. Bestätigen Sie **API-Schlüssel widerrufen** und entfernen Sie das alte Geheimnis aus der Anwendung.
Der Widerruf ist destruktiv und kann nicht rückgängig gemacht werden. Erstellen Sie einen neuen Schlüssel, wenn der Zugriff später erforderlich ist.
## Zustände und Limits
- **Noch keine API-Schlüssel** ist der normale leere Zustand.
- Der vollständige Wert eines neuen Schlüssels wird nur in seinem Erfolgsdialog angezeigt.
- Vorhandene Zeilen zeigen ein Präfix und Nutzungsdaten an, keinen wiederherstellbaren Schlüssel.
- **Nie** unter Zuletzt verwendet bedeutet, dass Runner keine Anfrage für diesen Schlüssel aufgezeichnet hat.
- Die Schaltflächen Erstellen und Widerrufen zeigen den Fortschritt an und sollten nicht wiederholt eingereicht werden.
## Fehlerbehebung
- Wenn API-Schlüssel fehlen, verwenden Sie keinen kopierten direkten Link; die Funktion ist für dieses Konto deaktiviert.
- Wenn das Kopieren in die Zwischenablage fehlschlägt, geben Sie den neuen Wert frei und kopieren Sie ihn manuell in einen sicheren Secret Manager, dann verbergen Sie ihn erneut.
- Wenn Sie einen vollständigen Schlüssel verloren haben, widerrufen Sie seine Zeile und generieren Sie einen Ersatz.
- Wenn eine Anwendung nach dem Widerruf nicht mehr funktioniert, aktualisieren Sie sie mit einem neu erstellten Schlüssel; der alte Schlüssel kann nicht wiederhergestellt werden.
- Wenn der falsche Schlüssel ausgewählt wurde, brechen Sie die Bestätigung ab und vergleichen Sie Name und Präfix erneut.
## Verwandte Anleitungen
- [Sicherheit und Sitzungen](./security-and-sessions)
- [Persönliche Einstellungen und Arbeitsbereiche](./personal-settings-and-workspaces)
- [Speichersicherheit](../agent/memory)
---
# Benutzerdefinierte Skripte und Store Agent
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/custom-scripts-and-store-agent
Benutzerdefinierte Skripte ändern das Storefront-Verhalten, während Store Agent ändert, welche Skills Runner für das aktuelle Projekt verwenden kann. Beide sind Shop-spezifische Einstellungen und sollten mit besonderer Sorgfalt überprüft werden.
## Was dieser Leitfaden abdeckt
Sie können ein Skript hinzufügen und speichern, es pausieren, ohne es zu löschen, und eine Skill für nur das aktuelle Projekt hinzufügen oder deaktivieren.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie Einstellungen aus dem beabsichtigten Projekt.
- Benutzerdefiniertes JavaScript kann das Storefront-Verhalten ändern. Fügen Sie nur Code hinzu, den Sie verstehen und dem Sie vertrauen.
- Skill-Aktionen hängen von verfügbaren Workspace-Skills und davon ab, ob eine System-Skill konfigurierbar ist.
- Die vollständige Agent-Seite und das Plan-Gate steuern weiterhin die breitere Skill-Verfügbarkeit.
## Eingabepfade
- Skripte: **Einstellungen → Store: _Store-Name_ → Benutzerdefinierte Skripte**
- Projekt-Skills: **Einstellungen → Store: _Store-Name_ → Agent**
## Steuerelemente für benutzerdefinierte Skripte
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Skript hinzufügen** | Erstellen Sie einen Storefront-Skripteintrag. | Eine neue aktivierte Skriptzeile wird mit leerem JavaScript-Code geöffnet. |
| Skriptzeile | Erweitern oder reduzieren Sie seinen Editor. | **Skriptname** und **JavaScript-Code** werden sichtbar. |
| Auge / verstecktes Augensymbol | Aktivieren oder deaktivieren Sie ein Skript. | Die lokale Zeile ändert den Zustand; wählen Sie Änderungen speichern, um sie anzuwenden. |
| Löschsymbol | Entfernen Sie ein Skript aus der ausstehenden Liste. | Die Zeile verschwindet ohne einen zweiten Dialog; Änderungen speichern wendet die Entfernung an. |
| **Änderungen speichern** | Wenden Sie jede ausstehende Skriptbearbeitung an. | Runner speichert die vollständige Skriptliste und zeigt eine Erfolgs- oder Fehlermeldung an. |
Runner erlaubt bis zu zehn Skripteinträge. Die Schaltfläche Änderungen speichern bleibt deaktiviert, wenn sich nichts geändert hat.
Mit dem leeren Editor können Sie die Skriptfelder vor der Installation überprüfen. In diesem Beispiel wurde kein Tracking-Skript gespeichert.
## Hinzufügen oder Ändern eines Skripts
1. Öffnen Sie **Shop → Benutzerdefinierte Skripte**.
2. Wählen Sie **Skript hinzufügen**.
3. Geben Sie einen klaren **Skriptnamen** und vertrauenswürdigen **JavaScript-Code** ein.
4. Lassen Sie das Skript nur aktiviert, wenn es auf der Storefront ausgeführt werden soll.
5. Überprüfen Sie alle anderen Zeilen, da **Änderungen speichern** die gesamte Liste anwendet.
6. Wählen Sie **Änderungen speichern** und warten Sie auf **Gespeichert**.
7. Überprüfen Sie die Storefront sicher nach dem Speichern.
Runner versucht zu verhindern, dass ein Skriptfehler die Seite zum Absturz bringt, aber das macht unbekannten Code nicht sicher. Ein Skript kann immer noch Datenschutz, Leistung, Tracking und Kundenerlebnis beeinflussen.
### Zuerst einen Skriptentwurf ansehen
Wählen Sie zum Kennenlernen **Skript hinzufügen**, nennen Sie es `Store analytics` und deaktivieren Sie es über das Augensymbol. Lassen Sie den Code leer und wählen Sie nicht **Änderungen speichern**. So sehen Sie den Editor und den deaktivierten Zustand, bevor Sie Code eines vertrauenswürdigen Anbieters hinzufügen. Wenn Sie später ein echtes Skript speichern, öffnen Sie die Liste erneut und prüfen Sie Code und Aktivierungszustand.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wählen Sie für Projekt-Skills **Agent** unter der Store-Überschrift. Das Bild zeigt den Menüeintrag, nicht das Hinzufügen oder Deaktivieren eines Skills.
## Store Agent-Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| Aktive Skill-Zeile | Sehen Sie, welche Skill in diesem Projekt verfügbar ist. | Die Zeile zeigt Name, Beschreibung und System- oder Custom-Typ. |
| **Deaktivieren** | Entfernen Sie eine konfigurierbare Skill aus diesem Projekt. | Die Skill verlässt die aktive Liste dieses Projekts; sie wird nicht global gelöscht. |
| **Skill hinzufügen** | Fügen Sie eine verfügbare Workspace-Skill zu diesem Projekt hinzu. | Das Auswählen einer aufgelisteten Skill aktiviert sie für das aktuelle Projekt. |
| **Benutzerdefinierten Skill erstellen…** | Erstellen Sie einen neuen benutzerdefinierten Skill. | Der Skill-Editor wird geöffnet, dann wird die Projektliste nach dem Erfolg aktualisiert. |
## Konfigurieren Sie Projekt-Skills
1. Öffnen Sie **Shop → Agent**.
2. Überprüfen Sie die derzeit aktiven Skills.
3. Wählen Sie **Skill hinzufügen**, dann wählen Sie eine verfügbare Skill oder **Benutzerdefinierte Skill erstellen…**.
4. Warten Sie auf die Erfolgsmeldung und bestätigen Sie, dass die Skill angezeigt wird.
5. Verwenden Sie **Deaktivieren**, wenn eine konfigurierbare Skill nicht mehr auf dieses Projekt angewendet werden soll.
6. Öffnen Sie **Agent** in der Projektnavigation, um Skill-Details anzuzeigen oder Skills zu pausieren, zu bearbeiten, zu importieren oder zu löschen.
## Zustände und Limits
- Skriptänderungen bleiben lokal, bis **Änderungen speichern** erfolgreich ist.
- Das Entfernen einer Skriptzeile hat keine separate Bestätigung vor Änderungen speichern.
- Das Erreichen von zehn Skripten deaktiviert **Skript hinzufügen**.
- Store Agent kann Laden, einen Fehler, **Keine Skills aktiviert** oder die aktive Liste anzeigen.
- Feste System-Skills zeigen nicht **Deaktivieren**.
- Das Deaktivieren in Store Agent ändert den Umfang dieses Projekts; es löscht oder pausiert die Skill nicht global.
## Fehlerbehebung
- Wenn ein Skript immer noch ausgeführt wird, bestätigen Sie seinen deaktivierten Zustand, gefolgt von **Änderungen speichern**.
- Wenn Speichern fehlschlägt, bleibt die zuvor gespeicherte Liste unverändert; korrigieren Sie den Code oder versuchen Sie es nach dem Fehler erneut.
- Wenn **Skill hinzufügen** keinen erwarteten Eintrag hat, überprüfen Sie die vollständige Agent-Seite und den aktuellen Plan.
- Wenn **Deaktivieren** fehlt, ist die System-Skill nicht für dieses Projekt konfigurierbar.
- Wenn eine neue Skill global angezeigt wird, aber nicht hier, fügen Sie sie von Store Agent zum Projekt hinzu.
## Verwandte Anleitungen
- [Shop Allgemein](./store-general)
- [Agent-Skills](../agent/skills)
- [Skills erstellen, importieren und verwalten](../agent/create-import-manage-skills)
- [API-Schlüsselsicherheit](./api-keys)
---
# Löschen, Wiederherstellen und Verlassen
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/delete-recover-and-leave
Runner verwendet verschiedene Bestätigungsabläufe zum Löschen eines Shops, Löschen eines Arbeitsbereichs, Verlassen eines Arbeitsbereichs und Anfordern der Kontolöschung. Überprüfen Sie den genauen Umfang vor jeder destruktiven Aktion.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Prüfen Sie vor dem Öffnen einer Entfernen-Aktion in **Settings**, ob der Workspace oder der Store ausgewählt ist. Das Bild zeigt nur die Navigation; es wurde nichts gelöscht oder wiederhergestellt.
Die Markierungen sind auf Englisch. Wählen Sie das Bild zum Vergrößern aus.
## Was dieser Leitfaden abdeckt
Sie werden wissen, was jede Aktion entfernt, welche Bestätigung sie erfordert, und wann die bedingte Shop-Wiederherstellung möglicherweise angezeigt wird.
## Verfügbarkeit und Voraussetzungen
- Sie benötigen Berechtigung für das Element, das Sie ändern.
- Der letzte Arbeitsbereich kann nicht gelöscht werden.
- Die Store-Wiederherstellung ist eine Funktion älterer Ansichten und nur bedingt verfügbar. Verwenden Sie sie nur, wenn Runner **Kürzlich gelöscht** anzeigt und der Store dort aufgeführt ist. Die aktuelle Store-Navigation bietet diesen Eintrag nicht grundsätzlich an.
- Behandeln Sie die bedingte Wiederherstellung nicht als Garantie, wenn Sie das Löschen genehmigen.
- Das aktuelle globale Avatar- und Einstellungsmenü zeigt die geschützte Kontosicherheitsseite nicht. Verwenden Sie die Kontolöschung nur, wenn Runner oder Runner-Support Ihnen einen genehmigten Eintrag gibt.
## Eingabepfade und Aktionskarte
| Aktion und Eingabepfad | Bestätigung | Was passiert nach dem Erfolg |
| --- | --- | --- |
| Einstellungen → Store: _Store-Name_ → **Allgemein → Löschen** | Geben Sie den genauen Store-Namen ein und wählen Sie **Löschen**. | Der Store wird entfernt. Wenn Sie den aktuellen Store löschen, öffnet Runner einen anderen verfügbaren Store oder den Einstieg zum Erstellen eines Stores. |
| Bedingte Mehrfachauswahl → **Ausgewählte löschen** | Geben Sie `DELETE` ein, dann wählen Sie **Alle löschen**. | Die ausgewählten Shops verlassen das aktive Raster, nachdem der Vorgang erfolgreich ist. |
| Bedingt verfügbare ältere Store-Liste → **Kürzlich gelöscht → Projekt wiederherstellen** | Keine Bestätigung einer löschenden Aktion; wählen Sie Projekt wiederherstellen. | Der Store kehrt in die aktive Projektliste zurück und seine Arbeitsbereichsressourcen werden erneut vorbereitet. |
| Einstellungen → Arbeitsbereich → Allgemein → **Arbeitsbereich löschen** | Der Besitzer gibt den genauen Arbeitsbereichsnamen ein, dann wählt **Löschen**. | Runner entfernt den Arbeitsbereich und wechselt zu einem anderen verfügbaren Arbeitsbereich. |
| Einstellungen → Arbeitsbereich → Mitglieder → Ihre Zeile → **Verlassen** | Überprüfen Sie den benannten Arbeitsbereichsdialog, dann wählen Sie **Verlassen**. | Sie verlieren den Zugriff auf seine Projekte und Runner leitet Sie zu einem anderen verfügbaren Arbeitsbereich oder einer Auswahl um. |
| Kontolöschung → E-Mail an support@adaptivemachines.ai | Senden Sie die Anfrage von der E-Mail-Adresse Ihres Runner-Kontos. | Der Runner-Support antwortet mit dem nächsten Schritt. |
## Löschen Sie einen Shop
1. Öffnen Sie im gewünschten Store **Einstellungen → Store: _Store-Name_ → Allgemein** und prüfen Sie die Namen von Arbeitsbereich und Store.
2. Wählen Sie **Löschen**.
3. Lesen Sie die Warnung zu Shop-Daten.
4. Geben Sie den genauen Shop-Namen ein.
5. Wählen Sie die destruktive Schaltfläche **Löschen**.
6. Warten Sie auf das Löschergebnis. Prüfen Sie, ob Runner einen anderen Store oder den Einstieg zum Erstellen geöffnet hat und der gelöschte Store nicht mehr verfügbar ist.
Die Bestätigung warnt, dass die Aktion nicht rückgängig gemacht werden kann. Obwohl einige Konten eine separate Wiederherstellungsfunktion zeigen, kann sie fehlen oder nicht verfügbar sein; löschen Sie nicht in der Annahme, dass Wiederherstellen angezeigt wird.
## Einen Store aus einer älteren Ansicht wiederherstellen, falls verfügbar
1. Fahren Sie nur fort, wenn Ihr Arbeitsbereich die ältere Store-Liste und ihren Eintrag **Kürzlich gelöscht** anzeigt.
2. Öffnen Sie **Kürzlich gelöscht**. Suchen Sie den Eintrag nicht in der aktuellen Store-Navigation und erraten Sie keinen direkten Link.
3. Stimmen Sie den Shop nach Name und Löschdatum ab.
4. Wählen Sie **Projekt wiederherstellen** einmal.
5. Warten Sie auf **Projekt wiederhergestellt** und bestätigen Sie, dass der Shop zur aktiven Liste zurückkehrt.
6. Öffnen Sie ihn nur, nachdem seine erforderlichen Arbeitsbereichsressourcen verfügbar werden.
Wenn **Kürzlich gelöscht** fehlt, bietet diese Ansicht keinen Wiederherstellungsweg. Wenden Sie sich bei Bedarf an den Support. Diese Anleitung garantiert weder die Verfügbarkeit noch eine Wiederherstellungsfrist.
## Löschen Sie einen Arbeitsbereich
1. Öffnen Sie als Arbeitsbereichsbesitzer **Einstellungen → Arbeitsbereich → Allgemein** für den genauen Arbeitsbereich.
2. Wählen Sie **Arbeitsbereich löschen**.
3. Lesen Sie die Warnung zur permanenten Entfernung.
4. Geben Sie den genauen Arbeitsbereichsnamen ein.
5. Wählen Sie **Löschen**.
6. Bestätigen Sie, dass Runner zu einem anderen Arbeitsbereich wechselt.
Der einzige Arbeitsbereich kann nicht gelöscht werden. Das Löschen eines Arbeitsbereichs wird als permanent und nicht wiederherstellbar dargestellt.
## Verlassen Sie einen Arbeitsbereich
1. Öffnen Sie **Einstellungen → Arbeitsbereich → Mitglieder**.
2. Finden Sie Ihre Zeile, die mit **(Sie)** gekennzeichnet ist.
3. Wählen Sie **Verlassen**, falls verfügbar.
4. Bestätigen Sie den Arbeitsbereichsnamen und wählen Sie **Verlassen** im Dialog.
5. Bestätigen Sie, dass Sie umgeleitet werden und keinen Zugriff mehr auf seine Projekte haben.
Das Verlassen löscht den Arbeitsbereich nicht für seine verbleibenden Mitglieder. Die Besitzerzeile bietet diese Verlassen-Aktion nicht auf der Seite Mitglieder.
## Fordern Sie die Kontolöschung an
1. Schreiben Sie von der E-Mail-Adresse Ihres Runner-Kontos an support@adaptivemachines.ai.
2. Bitten Sie darum, das Konto zu löschen.
3. Folgen Sie den Anweisungen in der Antwort des Runner-Supports.
Diese Anfrage ist breiter als das Löschen eines Shops oder Arbeitsbereichs. Überprüfen Sie [Sicherheit und Sitzungen](./security-and-sessions), bevor Sie fortfahren.
## Fehlerbehebung
- Eine deaktivierte endgültige Schaltfläche bedeutet, dass der Bestätigungstext nicht genau übereinstimmt oder die Aktion noch läuft.
- Ein Löschfehler beweist nicht, dass sich nichts geändert hat. Aktualisieren Sie die aktive Liste und überprüfen Sie das Element, bevor Sie es erneut versuchen.
- **Wird wiederhergestellt…** sperrt andere Wiederherstellen-Schaltflächen, bis die aktuelle Anfrage abgeschlossen ist.
- Wenn bei der Wiederherstellung ein Fehler gemeldet wird, überprüfen Sie die aktiven und kürzlich gelöschten Listen, bevor Sie es erneut versuchen.
- Falls das Verlassen einen Fehler meldet, prüfen Sie Ihren aktuellen Zugriff und Arbeitsbereich, bevor Sie es erneut versuchen.
- Wenn Sie keine Antwort zur Kontolöschung erhalten, senden Sie nicht mehrere Anfragen. Antworten Sie stattdessen im selben E-Mail-Verlauf.
## Verwandte Anleitungen
- [Shop Allgemein](./store-general)
- [Arbeitsbereich Allgemein](./workspace-general)
- [Mitglieder und Einladungen](../workspace/members-and-invitations)
- [Sicherheit und Sitzungen](./security-and-sessions)
---
# Persönliche Einstellungen und Arbeitsbereiche
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/personal-settings-and-workspaces
Unter Meine Einstellungen ändern Sie Ihre Runner-Einstellungen projektübergreifend. Verwenden Sie die Arbeitsbereichsauswahl, wenn Sie in einem anderen Team arbeiten möchten.
## Was dieser Leitfaden abdeckt
Wählen Sie Oberflächensprache, wöchentliche Leistungs-E-Mails und Oberflächentöne, ohne die Arbeitsbereichseinstellungen zu ändern.
## Verfügbarkeit und Voraussetzungen
- Sie müssen angemeldet sein.
- Die überprüfte Ansicht **Meine Einstellungen** zeigt Sprache, wöchentliche Leistungs-E-Mails und Oberflächentöne. Profileinstellungen können je nach Konto oder Oberfläche abweichen.
- Aktionen zur Arbeitsbereichserstellung und Mitgliedschaft können durch Kontoberechtigung oder aktuellen Arbeitsbereichsstatus eingeschränkt werden.
## Eingabepfade
- Einstellungen: **Einstellungen → Ihr Kontoname → Meine Einstellungen**
- Arbeitsbereichswechsel: Folgen Sie [Arbeitsbereichsnavigation](/de/guides/workspace).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBH6DLmxmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wählen Sie **Meine Einstellungen** für die Benutzeroberfläche. **API-Schlüssel** öffnet die separate Seite für persönliche Zugangsdaten.
## Steuerelemente für "Meine Einstellungen"
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Sprache** | Ändern Sie die Oberflächensprache von Runner. | Runner speichert die Auswahl und lädt die aktuelle Seite in diesem Gebietsschema neu. |
| **Wöchentliche Leistungs-E-Mails** | Erhalten Sie einmal pro Woche den Leistungsbericht Ihres Stores per E-Mail. | Der Schalter speichert, ob Runner den Bericht sendet; er ist standardmäßig aktiviert. |
| **Töne der Benutzeroberfläche** | Hören Sie ein leises Klicken bei Tippen, Umschalten und Benachrichtigungen. | Der Schalter speichert die Einstellung; schalten Sie ihn für Stille aus. |
## Sprache oder Bericht-E-Mails ändern
1. Öffnen Sie **Meine Einstellungen** unter Ihrem Kontonamen.
2. Wählen Sie **Sprache**, wenn Sie bereit sind, die Seite neu zu laden.
3. Bestätigen Sie, dass die Benutzeroberfläche nach dem Neuladen die ausgewählte Sprache verwendet.
4. Ändern Sie **Wöchentliche Leistungs-E-Mails** nur, wenn Sie die Zustellung Ihrer Store-Berichte anpassen möchten.
5. Warten Sie, bis die Einstellung gespeichert ist, und öffnen Sie dann die Seite erneut, um sie zu überprüfen.
## Überprüfen Sie eine Präferenz, ohne Ihr Profil zu ändern
1. Öffnen Sie **Meine Einstellungen** und suchen Sie **Töne der Benutzeroberfläche**.
2. Wählen Sie aus, ob Klicks und Benachrichtigungen einen Ton erzeugen sollen.
3. Warten Sie, bis die Einstellung gespeichert ist, schließen Sie dann **Meine Einstellungen** und öffnen Sie es erneut.
4. Bestätigen Sie, dass der Schalter immer noch Ihrer Wahl entspricht.
Verwenden Sie zum Wechseln oder Erstellen von Arbeitsbereichen die [Arbeitsbereichsanleitung](/de/guides/workspace). In der aktuellen Seitenleiste „Einstellungen“ gibt es kein öffentliches **Workspaces**-Ziel. Um einen Arbeitsbereich zu verlassen, folgen Sie [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations).
## Zustände und Limits
- Eine Sprachaktualisierung hält das Steuerelement beschäftigt, bis Persistierung und Navigation abgeschlossen sind.
- "Meine Einstellungen" zeigt keine Steuerelemente für Sitzungen, Kontolöschung oder API-Schlüssel. Siehe [Sicherheit und Sitzungen](./security-and-sessions) und [API-Schlüssel](./api-keys).
## Fehlerbehebung
- Wenn sich die Sprache nicht ändert, warten Sie, bis die aktuelle Aktualisierung abgeschlossen ist, und wählen Sie sie dann erneut aus.
- Wenn Sie die Einstellungen des falschen Arbeitsbereichs geöffnet haben, schließen Sie das Dialogfeld, wechseln Sie den Arbeitsbereich und öffnen Sie dann die Einstellungen erneut.
- Wenn Sie verlassen müssen, öffnen Sie stattdessen die Seite "Mitglieder" dieses Arbeitsbereichs, anstatt hier nach "Verlassen" zu suchen.
## Verwandte Leitfäden
- [Mitglieder und Einladungen](../workspace/members-and-invitations)
- [Arbeitsbereich Allgemein](./workspace-general)
- [Sicherheit und Sitzungen](./security-and-sessions)
- [Löschen, Wiederherstellen und Verlassen](./delete-recover-and-leave)
---
# Sicherheit und Sitzungen
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/security-and-sessions
Runner hat keine Seite in der App, die Ihre Sitzungen auflistet oder Ihr Konto löscht. Sie melden sich über das Avatar-Menü ab. Der Runner-Support bearbeitet Anfragen, Sitzungen auf anderen Geräten zu beenden oder Ihr Konto zu löschen.
## Was dieser Leitfaden abdeckt
Sie wissen, wie Sie sich auf dem aktuellen Gerät abmelden. Sie wissen auch, wie Sie den Runner-Support bitten, andere Sitzungen zu beenden oder Ihr Konto zu löschen.
## Verfügbarkeit und Voraussetzungen
- Zum Abmelden müssen Sie angemeldet sein.
- Senden Sie Support-Anfragen von der E-Mail-Adresse Ihres Runner-Kontos. So kann der Support bestätigen, dass das Konto Ihnen gehört.
- Die Kontolöschung ist endgültig. Sie entfernt alle Daten, die zum Konto gehören.
## Auf diesem Gerät abmelden
1. Wählen Sie Ihren Avatar in der oberen Navigation.
2. Wählen Sie **Abmelden**.
3. Prüfen Sie, dass Runner die Startseite für abgemeldete Nutzer zeigt.
## Sitzungen auf anderen Geräten beenden
1. Melden Sie sich auf jedem Gerät ab, auf das Sie noch Zugriff haben.
2. Wenn Sie ein Gerät nicht erreichen oder eine Anmeldung nicht erkennen, schreiben Sie an support@adaptivemachines.ai.
3. Nennen Sie das betroffene Konto und beschreiben Sie, was Sie gesehen haben.
## Fordern Sie die Kontolöschung an
1. Schreiben Sie von der E-Mail-Adresse Ihres Runner-Kontos an support@adaptivemachines.ai.
2. Bitten Sie darum, das Konto zu löschen.
3. Folgen Sie den Anweisungen in der Antwort des Runner-Supports.
Das Löschen eines Shops oder Arbeitsbereichs löscht Ihr Konto nicht. Diese Aktionen finden Sie unter [Löschen, Wiederherstellen und Verlassen](./delete-recover-and-leave).
## Fehlerbehebung
- Wenn Runner Sie nach **Abmelden** weiterhin als angemeldet zeigt, laden Sie die Seite neu.
- Wenn der Support Ihre Anfrage keinem Konto zuordnen kann, senden Sie sie erneut von der E-Mail-Adresse, mit der Sie sich anmelden.
## Verwandte Leitfäden
- [API-Schlüssel](./api-keys)
- [Persönliche Einstellungen und Arbeitsbereiche](./personal-settings-and-workspaces)
- [Löschen, Wiederherstellen und Verlassen](./delete-recover-and-leave)
---
# Store Allgemein
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/store-general
Store Allgemein steuert die aktuelle Storefront und nicht den gesamten Arbeitsbereich. Verwenden Sie es, um den Store umzubenennen, sein Browser- und Sucherscheinungsbild zu aktualisieren oder seine Löschgrenze zu überprüfen.
## Was dieser Leitfaden abdeckt
Sie können Store-Identitätsfelder aktualisieren, ein Favicon speichern, die plangesteuerte Wasserzeichenkontrolle verstehen und vermeiden, den falschen Store zu löschen.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie "Einstellungen" aus dem beabsichtigten Projekt; andernfalls wird die Store-Gruppe nicht angezeigt.
- Suchfelder erfordern das Laden der Store-Backend-Einstellungen.
- Das Entfernen des Runner-Wasserzeichens erfordert den neben diesem Steuerelement angezeigten Plan.
- "Store löschen" ist destruktiv und erfordert den genauen Store-Namen.
## Eingabepfad
Wählen Sie im gewünschten Projekt **Einstellungen → Store: _Store-Name_ → Allgemein**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wählen Sie **Allgemein** unter der Store-Überschrift, nicht unter Arbeitsbereich. Dieser Navigationsausschnitt zeigt keine geänderten oder gespeicherten Store-Felder.
## Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| Zugeordneter Arbeitsbereich, Ersteller, Erstellungszeit | Bestätigen Sie, welchen Store und Eigentümerkontext Sie anzeigen. | Diese Details sind schreibgeschützt. |
| **Name** | Benennen Sie den Store in Runner um. | Eine gültige Änderung wird automatisch gespeichert. |
| **Seitentitel** | Legen Sie den Titel fest, der in Browser-Registerkarten und Suchergebnissen angezeigt wird. | Eine gültige Änderung wird automatisch gespeichert und aktualisiert die Vorschau. |
| **Beschreibung** | Legen Sie die kurze Suchbeschreibung des Stores fest. | Eine gültige Änderung wird automatisch gespeichert. |
| Favicon-Schaltfläche | Ändern Sie das Symbol der Browser-Registerkarte. | Ein Popover wird mit den Optionen **Hochladen** und **KI-generiert** geöffnet. |
| **Bild hochladen** | Verwenden Sie Ihre eigene Favicon-Datei. | Runner validiert die Datei und zeigt eine Vorschau vor **Speichern**. |
| **Ausführen** | Generieren Sie ein Favicon aus der Eingabeaufforderung. | Runner zeigt eine generierte Vorschau an; sie wird erst nach **Speichern** angewendet. |
| Wasserzeichen entfernen-Schalter | Steuern Sie das Runner-Storefront-Wasserzeichen. | Die Änderung ist nur auf dem neben dem Steuerelement angezeigten Plan verfügbar. |
| **Shopper-Chat** | Ermöglichen Sie Käufern, im Storefront sofort Antworten zu erhalten. | Der Schalter speichert die Store-Einstellung und aktualisiert eine geöffnete Vorschau. Er ist standardmäßig aktiviert. |
| **Löschen** | Entfernen Sie den aktuellen Store. | **Store löschen** wird geöffnet und erfordert den genauen Store-Namen. |
## Aktualisieren Sie die Store-Identität
1. Öffnen Sie **Store → Allgemein** und bestätigen Sie den zugeordneten Arbeitsbereich und den Store-Namen.
2. Bearbeiten Sie **Name**, **Seitentitel** oder **Beschreibung**.
3. Warten Sie nach jedem automatisch gespeicherten Feld auf **Gespeichert**.
4. Überprüfen Sie die Browser-ähnliche Vorschau neben dem Favicon-Bereich.
Seitentitel und Beschreibung erzwingen die aktuellen Zeichenlimits, die von ihren Feldern angezeigt werden. Wenn ein Feld keine weiteren Texte akzeptiert, kürzen Sie es, anstatt um das Limit herumzufügen.
### Beispiel: Store-Name und Titel für Suchergebnisse unterscheiden
Bei einem Kerzenshop könnte der Runner-**Name** `Candle Studio` lauten und der **Seitentitel** `Candle Studio | Hand-poured candles`. Schreiben Sie eine kurze **Beschreibung** der tatsächlich angebotenen Produkte. Öffnen Sie nach jeder Meldung **Gespeichert** die Seite Allgemein erneut und prüfen Sie den Wert. Suchmaschinen benötigen möglicherweise Zeit für die Aktualisierung und können andere Texte im Suchergebnis verwenden.
## Ändern Sie das Favicon
1. Wählen Sie die aktuelle Favicon-Schaltfläche.
2. Wählen Sie **Hochladen** oder **KI-generiert**.
3. Wählen Sie für "Hochladen" eine ICO-, PNG- oder SVG-Datei unter dem angezeigten Dateigrößenlimit.
4. Wählen Sie für "KI-generiert" optional eine Eingabeaufforderung ein und wählen Sie **Ausführen**.
5. Überprüfen Sie die Vorschau.
6. Wählen Sie **Speichern**, um es anzuwenden. Das Schließen des Popovers verwirft eine ungespeicherte Vorschau.
## Zustände und Limits
- Automatisch gespeicherte Felder zeigen Speicherungs-, Erfolgs- oder Fehler-Feedback.
- Favicon-Upload lehnt nicht unterstützte Formate und zu große Dateien ab.
- **Wird generiert…** und **Wird hochgeladen…** sind Fortschrittszustände; warten Sie auf eine Vorschau.
- Das Wasserzeichen-Steuerelement kann ein Plan-Badge anzeigen und die Änderung blockieren.
- "Store löschen" bleibt nicht verfügbar, bis das Projekt und sein Name geladen sind.
## Gefahrenzone
Das Auswählen von **Löschen** öffnet eine Bestätigung, die warnt, dass alle Store-Daten verloren gehen. Die endgültige Schaltfläche bleibt deaktiviert, bis Sie den genauen Store-Namen eingeben. Einige Konten zeigen separat bedingte Wiederherstellung, aber Sie dürfen sich bei der Entscheidung zum Löschen nicht auf Wiederherstellung verlassen.
## Fehlerbehebung
- Wenn die Store-Gruppe fehlt, öffnen Sie "Einstellungen" erneut aus dem Projekt.
- Wenn ein Titel oder eine Beschreibung zurückkehrt, korrigieren Sie das Validierungsproblem und warten Sie auf "Gespeichert".
- Wenn das Favicon-Upload fehlschlägt, überprüfen Sie Typ und Größe und wählen Sie die Datei erneut.
- Wenn die Erstellung von generierten Favicons fehlschlägt, überarbeiten Sie die Eingabeaufforderung und versuchen Sie es erneut, nachdem der vorherige Versuch endet.
- Wenn "Wasserzeichen entfernen" blockiert ist, verwenden Sie das Plan-Badge, um die Verfügbarkeit zu überprüfen.
## Verwandte Leitfäden
- [Verbinden Sie eine benutzerdefinierte Domäne](../storefront-and-publishing/custom-domains)
- [Benutzerdefinierte Skripte und Store-Agent](./custom-scripts-and-store-agent)
- [Löschen, Wiederherstellen und Verlassen](./delete-recover-and-leave)
---
# Arbeitsbereich Allgemein
Source: https://www.runnerai.com/docs/de/guides/account-and-settings/workspace-general
Arbeitsbereich Allgemein steuert die gemeinsame Identität eines Runner-Arbeitsbereichs. Verwenden Sie es, wenn sich der Teamname oder die Beschreibung ändert, oder wenn Sie die Gefahrenzone des Arbeitsbereichs überprüfen müssen.
## Was dieser Leitfaden abdeckt
Sie können Arbeitsbereichsdetails aktualisieren und erkennen, wenn eine Änderung erfolgreich gespeichert wurde.
## Verfügbarkeit und Voraussetzungen
- Ein Arbeitsbereichs-Admin oder Eigentümer ist erforderlich, um den gemeinsamen Namen oder die Beschreibung zu ändern.
- Nur der Arbeitsbereichs-Eigentümer kann die Arbeitsbereichslöschung abschließen.
- Runner erlaubt nicht, dass der letzte verbleibende Arbeitsbereich gelöscht wird.
## Eingabepfad
Öffnen Sie **Einstellungen**, prüfen Sie **Arbeitsbereich: _Arbeitsbereichsname_** in der Seitenleiste und wählen Sie **Allgemein** unter dieser Gruppe.
## Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Name** | Legen Sie den vollständigen Arbeitsbereichsnamen fest, der für andere Mitglieder sichtbar ist. | Eine gültige Änderung wird nach dem Bearbeiten automatisch gespeichert. |
| **Beschreibung** | Erklären Sie, wofür der Arbeitsbereich oder das Team ist. | Eine gültige Änderung wird automatisch gespeichert. |
| **Arbeitsbereich löschen** | Entfernen Sie einen Arbeitsbereich, den Sie nicht mehr benötigen. | Ein Namensbestätigungs-Popover wird geöffnet. Die Schaltfläche ist für den letzten Arbeitsbereich deaktiviert. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTBoRI6D7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
In diesem Beispielarbeitsbereich sind keine Analytics-Schlüssel aufgeführt. Das Ändern der Arbeitsbereichsdaten und das Erstellen eines Analytics-Zugangs sind getrennte Aktionen.
## Aktualisieren Sie Arbeitsbereichsdetails
1. Öffnen Sie **Einstellungen → Arbeitsbereich → Allgemein**.
2. Bearbeiten Sie **Name** oder **Beschreibung**.
3. Verlassen Sie das Feld und beobachten Sie den Status.
4. Warten Sie auf **Gespeichert**, bevor Sie "Einstellungen" schließen oder den Arbeitsbereich wechseln.
5. Öffnen Sie die Seite erneut, wenn Sie den persistierten Wert überprüfen müssen.
**Prüfpunkt:** Schließen Sie Einstellungen, öffnen Sie Allgemein für denselben Arbeitsbereich erneut und prüfen Sie den gespeicherten Namen oder die Beschreibung. Ein geändertes Feld mit **Wird gespeichert…** erfüllt diesen Prüfpunkt noch nicht.
## Zustände und Limits
- Der Name darf nicht leer sein und muss innerhalb der angezeigten Validierungslimits bleiben.
- Die Beschreibung akzeptiert eine kurze Arbeitsbereichszusammenfassung und hat ein angezeigtes Zeichenlimit.
- **Wird gespeichert…** bedeutet, dass die Änderung noch läuft.
- **Gespeichert** bestätigt, dass der aktuelle Wert akzeptiert wurde.
- Ein Speicherfehler stellt den vorherigen gespeicherten Wert wieder her oder behält ihn bei.
- **Arbeitsbereich löschen** ist deaktiviert, wenn dies Ihr letzter Arbeitsbereich ist.
## Analytics-API-Schlüssel sind ein separater Bereich
Arbeitsbereich Allgemein kann **Analytics-API-Schlüssel** für externe Berichtstools mit schreibgeschütztem Analytics-Zugriff enthalten. Diese unterscheiden sich von [persönlichen API-Schlüsseln](/de/guides/account-and-settings/api-keys), die in Ihrem Namen handeln. Prüfen Sie den Zugriffsumfang, bevor Sie Zugangsdaten erstellen oder weitergeben. Eine leere Analytics-Schlüsselliste bedeutet nur, dass hier kein Schlüssel aufgeführt ist; sie ist nicht die Liste persönlicher Schlüssel.
## Löschgrenze
Das Auswählen von **Arbeitsbereich löschen** löscht nicht sofort. Runner fordert einen Eigentümer auf, den genauen Arbeitsbereichsnamen einzugeben, und aktiviert dann die destruktive Schaltfläche **Löschen**. Die Löschung kann nicht von diesem Bildschirm aus wiederhergestellt werden und entfernt die Daten und Einstellungen des Arbeitsbereichs.
## Fehlerbehebung
- Wenn ein leerer Name zu seinem früheren Wert zurückkehrt, geben Sie einen gültigen nicht leeren Namen ein.
- Wenn **Gespeichert** nie angezeigt wird, halten Sie das Dialogfeld offen, überprüfen Sie den Fehler und versuchen Sie es erneut.
- Wenn "Arbeitsbereich löschen" deaktiviert ist, ist dies wahrscheinlich der letzte Arbeitsbereich oder der Arbeitsbereich hat nicht geladen.
- Wenn Sie die Einstellungen des falschen Arbeitsbereichs geöffnet haben, schließen Sie das Dialogfeld und öffnen Sie es erneut vom beabsichtigten Arbeitsbereich.
## Verwandte Leitfäden
- [Mitglieder und Einladungen](../workspace/members-and-invitations)
- [Persönliche Einstellungen und Arbeitsbereiche](./personal-settings-and-workspaces)
- [Löschen, Wiederherstellen und Verlassen](./delete-recover-and-leave)
---
# Erweiterte Funktionen
Source: https://www.runnerai.com/docs/de/guides/advanced
Runner bietet erweiterte Möglichkeiten zum Recherchieren von Kunden, Planen von Arbeiten, Erstellen wiederverwendbarer Workflows und Empfangen von Ereignissen. Diese Seiten sind absichtlich vom Kern-Shop-Journey getrennt, da Verfügbarkeit und Einstiegspunkte je nach Arbeitsbereich unterschiedlich sein können.
> **Verfügbarkeit:** **Forschung** kann unter **Messen**, **Fly** in der Hauptnavigation und **Webhooks** unter **Aufbauen** erscheinen. **Workflow** bleibt bedingt verfügbar: Verwenden Sie die Funktion nur, wenn Runner einen Einstieg für Ihren Arbeitsbereich zeigt oder der Support einen bereitstellt. Erraten oder bearbeiten Sie keine URL, um eine verborgene Seite zu erreichen. Fehlt ein erwarteter Eintrag, lesen Sie [Funktionsverfügbarkeit](/de/guides/advanced/feature-availability).
| Funktion | Verwenden Sie es für | Leitfaden |
| --- | --- | --- |
| Recherche | Verwandeln Sie eine Geschäftsfrage in eine strukturierte Studie und einen Bericht. | [Recherche](/de/guides/advanced/research) |
| Fly | Legen Sie eine Mission fest und folgen Sie einem geführten Geschäftsplanungs-Arbeitsbereich. | [Fly](/de/guides/advanced/fly) |
| Workflow | Zeigen Sie wiederverwendbare mehrstufige Flows an und führen Sie sie aus, wenn Runner einen Eintrag bereitstellt. | [Workflow](/de/guides/advanced/workflows) |
| Webhooks | Konfigurieren Sie unterstützte Ereignislieferungen, wenn Runner einen Eintrag bereitstellt. | [Webhooks](/de/guides/advanced/webhooks) |
Informationen zu Tools, die unter **Wachstum** und **Messen** gruppiert sind, finden Sie unter [Automatisieren, testen und erstellen](/de/guides/automate-test-and-create).
---
# Verfügbarkeit von Funktionen
Source: https://www.runnerai.com/docs/de/guides/advanced/feature-availability
Runner kann verschiedene Funktionen je nach Arbeitsbereich, Rolle, Plan, Shop-Typ, Veröffentlichungsstatus, verbundenen Diensten, Daten und gestaffeltem Zugriff anzeigen.
**Einstiegspfad:** Runner-Dokumentation → **Erweiterte Funktionen** → **Verfügbarkeit von Funktionen**.
## Häufige Verfügbarkeitsbeschränkungen
| Was Sie sehen | Wahrscheinliche Anforderung | Was zu tun ist |
| --- | --- | --- |
| Eintrag fehlt | Die Funktion ist gestaffelt, deaktiviert oder nicht für diesen Arbeitsbereich verfügbar. | Überprüfen Sie den Arbeitsbereich und fragen Sie einen Besitzer oder den Support. Verwenden Sie keine erratene URL. |
| Upgrade-Nachricht | Der aktuelle Plan beinhaltet die Aktion nicht oder sein Limit wurde erreicht. | Öffnen Sie **Plan & Abrechnung** und überprüfen Sie das aktuelle Angebot auf dem Bildschirm. |
| Veröffentlichungsanforderung | Das Tool benötigt einen Live-Shop oder veröffentlichte Website-Daten. | Füllen Sie die Veröffentlichungs-Checkliste aus und kehren Sie nach einer erfolgreichen Veröffentlichung zurück. |
| Schaltfläche Verbinden | Ein Anbieter oder Konto muss zuerst verbunden werden. | Öffnen Sie die benannte App und schließen Sie ihren offiziellen Verbindungsablauf ab. |
| Leeres Dashboard | Die Funktion ist verfügbar, hat aber keine Daten für den ausgewählten Shop, Filter oder Zeitraum. | Bestätigen Sie Shop, Datumsbereich, Veröffentlichung und Ereigniserfassung. |
| Berechtigungsmeldung | Ihre Arbeitsbereichsrolle kann die Aktion nicht ausführen. | Bitten Sie einen Besitzer, dies zu tun, oder ändern Sie den Zugriff. |
| Seite nicht gefunden | Die Route ist nicht verfügbar, veraltet oder nicht gültig für diesen Kontext. | Kehren Sie durch sichtbare Navigation zurück und kontaktieren Sie den Support, wenn der Eintrag selbst beschädigt ist. |
## Überprüfen Sie in dieser Reihenfolge
1. Bestätigen Sie den ausgewählten Arbeitsbereich und Shop.
2. Erweitern Sie **Aufbauen**, **Wachstum** und **Messen** in der Projektnavigation, bevor Sie entscheiden, dass ein Eintrag fehlt. Öffnen Sie auf Mobilgeräten zunächst das Projektmenü.
3. Überprüfen Sie, ob die Seite eine Voraussetzung nennt.
4. Überprüfen Sie Ihre Rolle und den aktuellen Plan in den Arbeitsbereichseinstellungen.
5. Bestätigen Sie erforderliche Veröffentlichung, Daten oder App-Verbindung.
6. Laden Sie einmal neu, nachdem sich der Zugriff oder die Verbindung kürzlich geändert hat.
7. Kontaktieren Sie den Support mit der genauen Seite, dem sichtbaren Status, dem Arbeitsbereich und dem Shop-Namen. ### Was Sie nicht annehmen sollten
- Ein versteckter Eintrag beweist nicht, dass die Funktion aus jedem Konto entfernt wurde.
- Eine leere Seite beweist nicht, dass die Erfassung beschädigt ist.
- Eine Quellroute beweist nicht, dass Ihr Arbeitsbereich die Funktion nutzen kann.
- Eine erfolgreiche Verbindung beweist nicht, dass Checkout, Erfüllung oder Berichterstattung ohne ein End-to-End-Ergebnis funktionieren.
## Wenn die Seite nur eine Vorschau zeigt
Eine Funktionsvorschau kann Beispielkarten zeigen, während ein Upgrade-Hinweis echte Aktionen blockiert. Lesen Sie den Hinweis, bevor Sie die Karten als Daten Ihres Stores interpretieren. Alle Statusbegriffe stehen unter [Zustände und Verfügbarkeit](../help-and-reference/states-and-availability).
## Verwandte Leitfäden
- [Zustände und Verfügbarkeit](../help-and-reference/states-and-availability)
- [Abonnementpläne](../plans-and-billing/subscription-plans)
- [Beheben Sie Probleme mit Veröffentlichung, Checkout und Apps](../help-and-reference/troubleshoot-publishing-checkout-apps)
- [Support und Community](../help-and-reference/support-and-community)
---
# Fly
Source: https://www.runnerai.com/docs/de/guides/advanced/fly
Fly ist ein geführter Arbeitsbereich, in dem Sie ein Shop-Ziel in eine Mission umwandeln, vorgeschlagene Arbeiten prüfen und den Fortschritt über ein Dashboard verfolgen.
## Einstiegspfad
Öffnen Sie ein Shop-Projekt und wählen Sie **Fly** aus, wenn es verfügbar ist. Wenn der Eintrag fehlt, siehe [Funktionsverfügbarkeit](./feature-availability).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOvxtCXuJCcW62zHrU8smjSnqvixd1twlAf4u)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie die erste Mission und ihre Startphasen vor Diese Mission starten. Diese Ansicht zeigt die Einrichtung, keine aktive Mission.
## Bevor Sie beginnen
- Fly muss für das aktuelle Projekt aktiviert sein.
- Überprüfen Sie den Shop, die Mission und die betroffenen Aufgaben des Vorschlags, bevor Sie die Arbeit genehmigen.
- Entscheidungen über Vorschläge, Abbrüche und die nächste Mission können echte Projektarbeit verändern. Maßgeblich ist der jeweilige Bestätigungstext.
## Starten Sie die erste Mission
Projekte ohne eine Mission öffnen das Onboarding automatisch.
1. Öffnen Sie **Fly** und lesen Sie das vorgeschlagene Store-Ziel.
2. Wenn ein Dashboard bereits eine Mission anzeigt, überprüfen Sie diese Mission, anstatt eine andere zu starten.
3. Prüfen Sie die vorgeschlagene Mission und ihre Phasen. Die Einführung **Holen Sie sich Ihre erste bezahlte Bestellung** zeigt fünf Phasen und **Diese Mission starten**. Wählen Sie die Aktion nur, wenn Sie diese Mission beginnen möchten; schließen Sie andernfalls das Onboarding.
4. Vergewissern Sie sich, dass auf dem Dashboard die beabsichtigte Mission angezeigt wird, bevor Sie Vorschläge prüfen.
**Prüfpunkt:** Das Öffnen des Onboardings zeigt nur einen Missionsvorschlag. Erst nach Ihrer Bestätigung und der Anzeige im Dashboard existiert die Mission.
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Starten Sie Ihre erste Mission** | Öffnet das Onboarding erneut, wenn das Projekt immer noch keine Mission hat. |
| **Diese Mission starten** | Startet die in der Einleitung beschriebene Mission. Überprüfen Sie das Ziel und die Phasen, bevor Sie es bestätigen. |
| **Diese Mission festlegen**, falls in der Missionseinrichtung angezeigt | Erstellt die vorgeschlagene Mission für das aktuelle Projekt und öffnet das Fly-Dashboard. Prüfen Sie Store und Ziel vor der Bestätigung. |
Wenn Sie das Onboarding ohne Bestätigung schließen, entsteht keine neue Mission. Sie können über **Erste Mission starten** zurückkehren.
Nach dem Onboarding kann **Erhalten Sie Ihren ersten Vorschlag** eine schreibgeschützte Startcheckliste öffnen. Wenn **Details anzeigen** bei **Ihren Onlineshop erstellen** angezeigt wird, öffnet die Schaltfläche das erste Runner-Gespräch des Projekts. Sie fehlt, wenn kein erstes Gespräch aufgezeichnet wurde.
## Lesen Sie das Dashboard
Das Dashboard bringt die aktuelle Mission und Shop-Aktivität zusammen. Auf kleineren Bildschirmen werden die gleichen Abschnitte vertikal gestapelt.
| Abschnitt | Was es zeigt |
| --- | --- |
| Missionfortschritt | Das aktive Ziel und der Fortschritt zu diesem Ziel. |
| Bestellungen, Umsatz und Sitzungen | Die wichtigsten Shop-Kennzahlen für heute. Dies sind schreibgeschützte Zusammenfassungen. |
| **Feeds** | Aktuelle Signale und aktuelle Beobachtungen von Fly. Wählen Sie eine Story aus, um ihren Viewer zu öffnen. |
| **Laufende Arbeiten** | Genehmigte Vorschläge, die ausgeführt werden oder auf Ihre Aktion warten. Wählen Sie eine Karte aus, um ihre Vorschlagsdetails zu öffnen. |
| **Vergangene Arbeiten** | Abgeschlossene oder fehlgeschlagene Vorschläge. Wählen Sie eine Karte aus, um sie zu überprüfen; **Mehr anzeigen** lädt ältere Einträge. |
| **Ihre Aufgaben** | Aufgaben, die Ihre Aufmerksamkeit benötigen. **Zurück** und **Weiter** bewegen sich durch mehr als eine Seite mit Elementen. |
| Shop-Vorschau | Zeigt den aktuellen Veröffentlichungsstatus, wenn verfügbar. Wählen Sie sie aus, um **Shop** zu öffnen. |
| **Chat öffnen** | Öffnet den Fly-Chat, damit Sie Fragen zur Mission oder sichtbaren Arbeit stellen können. **Chat schließen** schließt ihn. |
| **Alles erledigt** | Wird angezeigt, wenn keine Aufgaben oder Vorschläge eine Entscheidung benötigen. Es bestätigt, dass Fly den Shop weiterhin überwacht; es bedeutet nicht, dass jede laufende Aufgabe abgeschlossen ist. |
| **Runner erkunden** | Wenn die Warteschlange leer ist, bietet **Kreativstudio öffnen** an, wenn aktiviert, **Skills durchsuchen** und **Automationen erkunden**. Jede Schaltfläche öffnet dieses Projekttool, ohne die Arbeit selbst zu starten. |
Ein leerer Abschnitt **Laufende Arbeiten** oder **Vergangene Arbeiten** kann ausgeblendet sein. Das bedeutet, dass sich nichts in diesem Status befindet, nicht dass die Projekthistorie gelöscht wurde.
Im Fly-Chat startet **Neues Gespräch** einen neuen Thread, während die [Historie](/de/guides/work-with-runner/chats-and-history) einen früheren öffnet. Die erste Nachricht erstellt das Gespräch. Wenn das Senden fehlschlägt, bleibt der Entwurf im Composer, damit Sie ihn erneut versuchen können, ohne ihn umzuschreiben.
### Lesen Sie eine Fly-Story
Der Story-Viewer zeigt **aktuelles Element von insgesamt** in seiner Kopfzeile. Verwenden Sie die vorherigen und nächsten Pfeile, um zwischen Elementen zu wechseln, oder schließen Sie den Viewer, um zum Dashboard zurückzukehren. Wenn eine Story einen verknüpften Quellchip enthält, wird dieser in einer neuen Browserregisterkarte geöffnet. Wenn die Story nicht geladen werden kann, wählen Sie **Erneut versuchen** aus, ohne Fly zu verlassen. Marktnachrichten-Karten können verschwinden, nachdem sie nicht mehr aktuell sind.
## Überprüfen Sie einen Vorschlag
Öffnen Sie einen Vorschlag vom Dashboard, bevor Sie die Arbeit beginnen lassen. Ein Vorschlag kann mehrere Aufgaben enthalten; das Auswählen einer Aufgabe kann auch Voraussetzungen einschließen, von denen sie abhängt.
| Steuerelement oder Status | Was passiert als Nächstes |
| --- | --- |
| Aufgabenauswahl | Wählt aus, welche Aufgaben genehmigt werden sollen. Erforderliche Voraussetzungsaufgaben sind enthalten, damit die ausgewählte Arbeit in der richtigen Reihenfolge ausgeführt werden kann. |
| **Genehmigen und Ausführen** | Genehmigt die ausgewählten Aufgaben und startet die Ausführung. Es ist nicht verfügbar, wenn keine Aufgabe ausgewählt ist. Verbundene Aktionen können echte Auswirkungen haben. |
| **Ablehnen** | Öffnet eine Bestätigung. Das Bestätigen schließt den Vorschlag und führt keine seiner Aufgaben aus; dies kann nicht rückgängig gemacht werden. |
| **Abbrechen** | Öffnet **Diesen Vorschlag abbrechen?** während die Arbeit läuft. **Abbruch bestätigen** stoppt unvollendete Aufgaben; abgeschlossene Arbeiten werden beibehalten. **Weiter ausführen** schließt die Bestätigung. |
| **Vorschau** | Öffnet das abgeschlossene Workflow-Ergebnis, wenn eine Vorschau verfügbar ist. |
| **Details anzeigen** | Bei einer unterstützten ersten Vorschlagsaufgabe öffnet das zugehörige Runner-Gespräch, damit Sie den Arbeitskontext überprüfen können. |
| Wartet auf Ihre Aktion | Die Ausführung wird angehalten, bis Sie die angeforderte manuelle Aktion abgeschlossen haben und **Auflösen** auswählen. |
| **Hilfreich** / **Nicht hilfreich** | **Hilfreich** wird sofort gespeichert. **Nicht hilfreich** öffnet bearbeitbare Gründe und Details; beim Schließen bleibt das vorhandene Feedback erhalten, und Änderungen werden erst nach **Absenden** gespeichert. |
Einige Vorschlagsseiten zeigen während der Prüfung auch ein Chat-Panel für den Vorschlag. Verwenden Sie es, um Fragen zu diesem Vorschlag zu stellen. Es ersetzt nicht **Genehmigen und Ausführen**, **Ablehnen**, **Abbrechen** oder **Auflösen**, wenn die jeweilige Aktion angezeigt wird.
Der Abschnitt **Ergebnisse** bleibt ausgeblendet, während ein Vorschlag zur Prüfung vorliegt, ausgeführt oder abschließend verifiziert wird. Er kann nach Abschluss oder Fehler nur angezeigt werden, wenn Ergebnisdaten verfügbar sind. Ein fehlender Abschnitt **Ergebnisse** während aktiver Arbeit ist kein Beweis dafür, dass der Vorschlag fehlgeschlagen ist.
Bei Dokument- und Medienergebnissen speichert **Herunterladen** das verfügbare Ergebnis, **Medien wiederherstellen** versucht nicht verfügbare Medien erneut abzurufen und **Im Chat fortfahren** öffnet bearbeitbare Folgeanweisungen. Diese Aktionen ändern weder die Annahme noch den Prüfstatus des Vorschlags.
Wenn ein Vorschlag Fly-Videogenerierung enthält, erzeugt die aktuelle Aufgabe ein 6-Sekunden-720p-Video mit Audio. Das Anfordern einer anderen Dauer in der Aufgabenaufforderung ändert nicht diese Ausgabelänge.
## Lösen Sie eine benutzergesteuerte Aufgabe auf
Wenn eine Aufgabe mit der Markierung **Ihre Aufgabe** für eine Aktion angehalten wird, die nur Sie abschließen können, lesen Sie ihre Anweisungen, führen Sie die Aktion außerhalb der Karte aus und wählen Sie dann **Auflösen** aus.
**Auflösen** ist Ihre Bestätigung, dass Sie die angeforderte Aktion abgeschlossen haben; Runner überprüft dieses externe Ergebnis nicht unabhängig. Während Runner den Status überprüft, zeigt die Karte **Aufgabenaktion wird geladen**. Während es übermittelt wird, zeigt die Schaltfläche **Wird aufgelöst…**. **Diese Aufgabe wartet nicht mehr auf Ihre Aktion.** bedeutet, dass sie nicht von der aktuellen Karte aus aufgelöst werden kann. Wenn Sie **Diese Aufgabe konnte nicht aufgelöst werden. Bitte versuchen Sie es erneut.** sehen, überprüfen Sie die Verbindung und versuchen Sie es erneut. Markieren Sie eine Aufgabe nicht als aufgelöst, bevor die angeforderte Aktion tatsächlich abgeschlossen ist.
## Lösen Sie Aufgaben auf
Wählen Sie **Auflösen** nur bei einer berechtigten One-Click-Aufgabe aus. Runner zeichnet dann Ihre Bestätigung vom Dashboard auf. Detailliertere Aufgaben, einschließlich Aufgaben mit Dateiausgaben, bleiben schreibgeschützt in der Aufgabenliste; öffnen Sie den zugehörigen Vorschlag, um ihre Anweisungen und den aktuellen Status zu überprüfen.
Wenn das Auflösen fehlschlägt, halten Sie die Aufgabe offen und versuchen Sie es erneut, nachdem Sie die Verbindung überprüft haben. Gehen Sie nicht davon aus, dass die Aufgabe abgeschlossen ist, bis sich ihr Status ändert.
## Folgen Sie laufenden und vergangenen Arbeiten
1. Öffnen Sie eine Karte in **Laufende Arbeiten**, um ihre aktuellen Vorschlag- und Aufgabenstatus zu sehen.
2. Wenn es **Wartet auf Ihre Aktion** sagt, führen Sie die angeforderte manuelle Aktion aus und wählen Sie **Auflösen** aus, anstatt den Vorschlag erneut zu genehmigen.
3. Verwenden Sie Abbrechen nur, wenn unvollendete Arbeiten gestoppt werden sollen. Bereits abgeschlossene Arbeiten werden nicht zurückgerollt.
4. Öffnen Sie **Vergangene Arbeiten**, um Ergebnisse und fehlgeschlagene Vorschläge zu überprüfen.
5. Bei einem Fehler behalten Sie den Vorschlagstitel und den sichtbaren Aufgabenfehler, bevor Sie um Hilfe bitten.
## Schließen Sie eine Mission ab und wählen Sie die nächste aus
Wenn Runner erkennt, dass eine Mission erreicht ist, öffnet **Mission abgeschlossen** einen geführten Ablauf. Wenn Sie ihn schließen, bevor Sie ein anderes Ziel auswählen, kann **Wählen Sie Ihre nächste Mission** den Ablauf erneut öffnen.
1. Wählen Sie **Rückblick ansehen**, um den Missionsrückblick, wichtige Momente und die Arbeit zu sehen, die Fly an Ihrer Seite abgeschlossen hat.
2. Wählen Sie **Sehen Sie, was als Nächstes kommt**, um die vorgeschlagene nächste Mission zu prüfen.
3. Passen Sie das Ziel mit dem verfügbaren Voreinstellung oder Erhöhen/Verringern-Steuerelementen an und wählen Sie dann **Weiter** aus.
4. Lesen Sie die Rollout-Zusammenfassung sorgfältig durch.
5. Wählen Sie **Mission starten** nur aus, wenn das neue Ziel korrekt ist.
6. Wenn die nächste Mission live ist, wählen Sie **Zur Missionszentrale**, um zum Dashboard zurückzukehren.
**Mission starten** hat echte Projektauswirkungen: bereits laufende Aufgaben werden fortgesetzt, die Vorschlagsgenerierung wird gegen das neue Ziel fortgesetzt, und Vorschläge, auf die Sie nicht reagiert haben, werden geschlossen, damit Fly sie für das neue Ziel neu generieren kann. Der aktuelle Fortschritt wird übertragen.
## Fehlerbehebung
| Status | Nächster Schritt |
| --- | --- |
| Onboarding öffnet sich automatisch | Legen Sie die Mission fest oder schließen Sie das Onboarding und kehren Sie später zurück. |
| Dashboard wird angezeigt | Eine Mission existiert; verwenden Sie das Dashboard, anstatt ein Duplikat zu erstellen. |
| **Wartet auf Ihre Aktion** | Öffnen Sie den Vorschlag, führen Sie die spezifische manuelle Aktion aus und wählen Sie dann **Auflösen** aus. |
| Abbruchkonflikt oder Status hat sich anderswo geändert | Aktualisieren Sie den Vorschlag und verwenden Sie seinen aktuellen Status. |
| Abgeschlossene Vorschau kann nicht geladen werden | Wählen Sie **Erneut versuchen** in der Workflow-Vorschau aus, oder öffnen Sie den abgeschlossenen Vorschlag erneut für das neueste Ergebnis. |
| Vorschlag fehlgeschlagen | Öffnen Sie ihn aus **Vergangene Arbeiten** und behalten Sie den sichtbaren Aufgabenfehler. |
| Endgültige Überprüfung kann nicht wiederhergestellt werden | Der Vorschlag endet mit dem Status „fehlgeschlagen“, anstatt in den laufenden Arbeiten zu bleiben. Öffnen Sie ihn aus **Vergangene Arbeiten** und behalten Sie den sichtbaren Fehler, bevor Sie es erneut versuchen. |
| Nächste Mission kann nicht gestartet werden | Versuchen Sie es erneut. Wenn eine andere Sitzung sie bereits gestartet hat, wird das Dashboard zur Live-Mission aktualisiert. |
| Eintrag fehlt oder Seite nicht gefunden | Fly ist in diesem Kontext nicht verfügbar. Siehe [Funktionsverfügbarkeit](./feature-availability). |
## Verwandte Leitfäden
- [Funktionsverfügbarkeit](./feature-availability)
- [Aufgabenstatus und Details](../work-with-runner/task-states-and-details)
- [Fehlerbehebung bei Runner-Aufgaben](../help-and-reference/troubleshoot-runner-tasks)
---
# Recherche
Source: https://www.runnerai.com/docs/de/guides/advanced/research
Recherche bietet einen projektgesteuerten Ort zur Untersuchung von Käuferbedürfnissen, Konzepten, Positionierung und anderen Geschäftsentscheidungen.
## Einstiegspfad
Öffnen Sie ein Store-Projekt, erweitern Sie **Messen** und wählen Sie **Forschung** aus, wenn die Funktion verfügbar ist. Öffnen Sie auf Mobilgeräten zunächst das Projektmenü. Wenn **Forschung** nicht vorhanden ist, stellt dieser Arbeitsbereich die Funktion derzeit nicht zur Verfügung; siehe [Funktionsverfügbarkeit](./feature-availability).
## Bevor Sie beginnen
- Recherche muss für das aktuelle Projekt aktiviert sein.
- Bereiten Sie eine Geschäftsfrage mit mindestens fünf Zeichen vor und entfernen Sie unnötige Kundendaten.
- Live-Scouting, Panels und Berichte können externe Daten oder Guthaben verwenden; überprüfen Sie jede verfügbare Aktion, bevor Sie sie starten.
## Starten oder öffnen Sie eine Studie erneut
Die Recherche-Startseite hat zwei Modi: **Neue Studie** und **Gespeicherte Panels**.
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Neue Studie** | Öffnet das Frageformular und die aktuellen Studien des Projekts. |
| Fragefeld | Nimmt die Geschäftsentscheidung auf, die Sie untersuchen möchten. **Studie starten** bleibt gesperrt, bis die Frage gültig ist. |
| Szenario-Karte | Platziert eine vorgeschlagene Forschungsrichtung in das Fragefeld, damit Sie sie bearbeiten können. |
| **Studie beginnen** | Erstellt eine Live-Studie aus der aktuellen Frage und öffnet den zugehörigen geführten Arbeitsbereich. |
| **Sehen Sie sich zuerst ein fertiges Beispiel an** | Öffnet eine schreibgeschützte Beispielvorschau. Es wird keine Live-Studie erstellt und Aktionen, die eine Live-Studie erfordern, sind möglicherweise nicht verfügbar. |
| Aktuelle Studienkarte | Öffnet die vorhandene Studie dieses Projekts erneut. |
| **Gespeicherte Panels** | Öffnet Panels, die zur Wiederverwendung gespeichert wurden. |
| **Studie starten** | Wählt das gespeicherte Panel aus und kehrt zu **Neue Studie** zurück. Geben Sie eine neue Forschungsfrage ein und wählen Sie dann **Studie starten**, um die Studie zu erstellen. |
| **Mehr laden** | Lädt zusätzliche Studien oder gespeicherte Panels. |
| **Erneut versuchen** | Fordert die aktuelle Bibliothek oder fehlgeschlagene Phase erneut an. |
Verwenden Sie eine fokussierte Entscheidung als Frage. Eine Frage wie "Welche Produktaussage sollten wir für Erstkäufer führen?" gibt der Studie eine klarere Aufgabe als ein breites Thema wie "Marketing".
## Bewegen Sie sich durch die geführten Phasen
Die linke Seite einer Studie stellt Fragen und bietet Auswahlmöglichkeiten. Wählen Sie die relevanten Auswahlmöglichkeiten aus, fügen Sie bei Bedarf eine benutzerdefinierte Antwort hinzu und verwenden Sie dann die primäre Aktion für die aktuelle Phase.
| Aktion | Was Runner startet |
| --- | --- |
| **Forschungsplan erstellen** | Verwandelt Ihre Frage und Antworten in einen Studienplan. |
| **Eingaben ändern** | Öffnet die Planungseingaben erneut, bevor das Scouting beginnt. |
| **Forschungsplan neu erstellen** | Ersetzt den aktuellen Plan durch einen neuen Plan basierend auf den geänderten Eingaben. |
| **Scouting starten [Quelle]** (z. B. **Scouting X starten**) | Startet das Scouting auf der Quelle, die vom genehmigten Plan benannt wird. |
| **Validierungspanel erstellen** | Erstellt das Zielgruppenpanel, das verwendet wird, um die Ergebnisse zu überprüfen und zu validieren. |
| **Panel-Diskussion starten** | Beginnt die Panel-Konversation. |
| **Zusammenfassung, Protokoll und Bericht generieren** | Erzeugt die endgültigen schriftlichen Artefakte aus der abgeschlossenen Diskussion. |
| **Erneut versuchen** gefolgt von einem Phasennamen | Wiederholt die fehlgeschlagene Phase. Überprüfen Sie den Fehler zuerst, damit Sie nicht blind die gleiche Eingabe wiederholen. |
Die genaue primäre Aktion ändert sich, wenn jede Phase bereit wird. Wählen Sie keine Aktion einer späteren Phase, bis Sie mit dem aktuellen Plan, den Ergebnissen oder dem Panel zufrieden sind.
## Überprüfen Sie Studienartefakte
Auf dem Desktop sitzen geführter Chat und die Artefakt-Leinwand nebeneinander und können in der Größe geändert werden. Auf Mobilgeräten verwenden Sie **Studien-Chat** und **Artefakte**, um zwischen ihnen zu wechseln.
| Artefakt-Registerkarte | Was es enthält |
| --- | --- |
| **Übersicht** | Die Studien-Zeitleiste und welche Phasen bereit oder ausstehend sind. Das Auswählen eines bereiten Elements öffnet sein Artefakt. |
| **Plan** | Der genehmigte Forschungsansatz. Es bleibt leer, bis die Planung abgeschlossen ist. |
| **[Quelle] Scout** (z. B. **X Scout**) | Der Scouting-Fortschritt und die Quellen für die aktuelle Quelle der Studie. |
| **Ergebnisse** | Themen und Beweise, die nach dem Scouting erzeugt werden. |
| **Panel** | Die Validierungszielgruppe, die aus den Ergebnissen erstellt wurde. |
| **Diskussion** | Die Panel-Konversation und Folgeantworten. |
| **Bericht** | Der endgültige Bericht-Arbeitsbereich nach Abschluss der Diskussion. |
Eine ausstehende Registerkarte ist kein Fehler: ihr leerer Status erklärt, welche frühere Phase zuerst abgeschlossen werden muss. Die Übersichts-Zeitleiste markiert auch nicht verfügbare Phasen als ausstehend.
## Speichern Sie ein nützliches Panel
Öffnen Sie **Panel** und wählen Sie **Panel speichern**, wenn seine Zielgruppe für zukünftige Studien nützlich ist. Geben Sie den Panel-Namen und eine optionale Beschreibung in das Speicherformular ein und bestätigen Sie dann. Runner meldet **Panel für zukünftige Studien gespeichert**, und das Panel wird unter **Gespeicherte Panels** angezeigt.
Das Speichern bewahrt das Panel zur Wiederverwendung; es startet keine weitere Studie. In einer Beispielvorschau ist das Speichern nicht verfügbar, da das Beispiel keine Live-Projektdaten sind.
## Lesen und teilen Sie den Bericht
Der endgültige Bericht-Arbeitsbereich trennt drei Ansichten:
- **Bericht** präsentiert das vollständige Forschungsergebnis.
- **Zusammenfassung** gibt die kürzere entscheidungsorientierte Version.
- **Protokoll** zeichnet die Panel-Diskussion auf.
Wählen Sie **Teilen**, um den aktuellen Studien-Link mit dem Freigabepanel des Geräts zu teilen, wenn unterstützt. Wenn native Freigabe nicht verfügbar ist, kopiert Runner den Link und zeigt **Studien-Link kopiert**. Das Teilen sendet einen Link, keinen heruntergeladenen statischen Bericht; der Empfänger benötigt immer noch angemessenen Zugriff.
## Setzen Sie die Panel-Diskussion fort
Während der Diskussionsphase verwenden Sie den Folgekomponierer, um eine klarere Antwort zu erhalten oder einen anderen Winkel zu testen.
| Steuerelement | Ergebnis |
| --- | --- |
| **Hinterfragen Sie einen Fund** | Füllt den Composer mit einer Herausforderungsaufforderung, die Sie bearbeiten können. |
| **Fragen Sie das Panel** | Füllt den Composer mit einer direkten Panel-Frage. |
| **Ändern Sie die Zielgruppe** | Füllt den Composer mit einer Anfrage, eine andere Zielgruppe zu berücksichtigen. |
| **Folgefrage senden** | Sendet die aktuelle Nachricht in die Live-Panel-Diskussion. |
Vorschlag-Chips bereiten Text vor; sie senden nichts, bis Sie **Folgefrage senden** auswählen. Wenn der Composer sein Limit überschritten hat oder die Studie nicht bereit ist, bleibt die Sendeaktion nicht verfügbar.
## Fehlerbehebung
| Status | Bedeutung und nächster Schritt |
| --- | --- |
| Beispiel | Eine abgeschlossene Demonstration, keine Live-Projektforschung. Kehren Sie zu **Neue Studie** zurück, um Ihre eigene zu erstellen. |
| Ausstehende Artefakt | Eine frühere Phase hat nicht abgeschlossen. Kehren Sie zur Übersicht oder zum Studien-Chat zurück und fahren Sie mit der verfügbaren Phase fort. |
| Phase wird ausgeführt | Runner bereitet das nächste Artefakt vor. Sie können später durch aktuelle Studien zurückkehren. |
| Wiederholbarer Fehler | Lesen Sie den sichtbaren Fehler und verwenden Sie dann die phasenspezifische **Erneut versuchen** einmal. |
| Wiederherstellung ist blockiert | Wählen Sie **Studie aktualisieren**, um den aktuellen Serverstatus zu laden, bevor Sie fortfahren. |
| Folgefrage schlägt fehl | Behalten Sie die Nachricht, verwenden Sie Erneut versuchen, wenn angeboten, oder aktualisieren Sie die Studie, bevor Sie erneut senden. |
| Studien- oder Panel-Bibliothek schlägt fehl | Wählen Sie **Erneut versuchen**. Bewahren Sie die Frage und den sichtbaren Fehler auf, wenn er sich wiederholt. |
| Leere Studienhistorie | Dieses Projekt hat noch keine Studie. Beginnen Sie mit einer fokussierten Frage. |
## Empfohlener Pfad
1. Öffnen Sie **Neue Studie** und geben Sie eine entscheidungsorientierte Frage ein.
2. Wählen Sie **Studie starten** und beantworten Sie die geführten Fragen.
3. Überprüfen Sie den Plan; verwenden Sie **Eingaben ändern**, bevor Sie scouten, wenn der Umfang falsch ist.
4. Bewegen Sie sich durch Scout, Ergebnisse, Panel und Diskussion und überprüfen Sie jedes bereite Artefakt.
5. Speichern Sie das Panel nur, wenn seine Zielgruppe wieder nützlich sein wird.
6. Generieren und lesen Sie den Bericht, die Zusammenfassung und das Protokoll.
7. Teilen Sie den Studien-Link nur mit Personen, die Zugriff haben sollten.
8. Verwenden Sie Folgefragen für spezifische Lücken, anstatt eine doppelte Studie zu starten.
## Probieren Sie das Beispiel vor einer Live-Studie aus
1. Öffnen Sie **Messen** → **Forschung** → **Neue Studie**.
2. Wählen Sie **Zuerst ein fertiges Beispiel ansehen**.
3. Lesen Sie Beispielplan und Beispielbericht über die verfügbaren Ergebnisregisterkarten.
4. Kehren Sie zu **Neue Studie** zurück und schreiben Sie eine Entscheidung, die Sie untersuchen möchten.
5. Wählen Sie **Studie starten** nur aus, wenn Sie bereit sind, eine Live-Studie zu erstellen.
**Prüfpunkt:** Mit dem Beispiel können Sie das Ausgabeformat überprüfen, ohne eine Studie zu erstellen. Vergewissern Sie sich für Ihre eigene Studie, dass Ihre Frage im Arbeitsbereich angezeigt wird. Spätere Erkundungs- und Berichtsaktionen haben ihre eigenen Fortschritte und Ergebnisse.
## Verwandte Leitfäden
- [Verfügbarkeit von Funktionen](./feature-availability)
- [Experimente](../automate-test-and-create/experiments)
- [Analyse-Übersicht](../analytics-and-seo/analytics-overview)
- [Support und Community](../help-and-reference/support-and-community)
---
# Webhooks
Source: https://www.runnerai.com/docs/de/guides/advanced/webhooks
Webhooks ermöglichen es einem anderen Service, ausgewählte Ereignisse aus einem Runner-Projekt zu empfangen. Dies ist eine erweiterte, sicherheitsempfindliche Funktion: Verwenden Sie sie nur, wenn Sie wissen, welcher Service die Ereignisse empfangen soll und wie dieser Service sie überprüft.
## Eingabepfad
Öffnen Sie **Aufbauen** → **Webhooks**, wenn Runner den Eintrag für Ihren Arbeitsbereich verfügbar macht. Wenn kein Eintrag vorhanden ist, erraten Sie keine URL; siehe [Funktionsverfügbarkeit](./feature-availability) oder fragen Sie den Support, ob die Funktion aktiviert ist.
## Bevor Sie beginnen
- Verwenden Sie Webhooks nur, wenn Runner oder der Support einen genehmigten Eintrag verfügbar macht.
- Kennen Sie den beabsichtigten empfangenden Service und wie er Ereignisse überprüft.
- Behandeln Sie Endpunktadressen, Signaturschlüssel und übermittelte Daten als vertraulich.
## Was Runner anzeigt
Ihr Arbeitsbereich zeigt möglicherweise die Webhook-Workbench von Runner oder ein eingebettetes Anbieterportal an. Folgen Sie dem Abschnitt, der Ihrem Bildschirm entspricht.
### Die Runner-Workbench prüfen
**Bedingt verfügbar:** Wenn Runners eigene Workbench aktiviert ist, verwenden Sie diese Registerkarten:
| Tab | Was Sie überprüfen sollten |
| --- | --- |
| **Endpunkte** | Konfigurierte Empfangsziele und deren Status. |
| **Katalog** | Verfügbare Ereignistypen, bevor Sie auswählen, was ein Ziel empfängt. |
| **Protokolle** | Erfasste Zustellungen und ihre Rückgabestatus. |
| **Aktivitäten** | Aktuelle Webhook-Aktivität. |
1. Öffnen Sie **Endpunkte** und wählen Sie das Ziel, das Sie prüfen möchten.
2. Lesen Sie **Katalog**, um den relevanten Ereignistyp zu überprüfen.
3. Öffnen Sie **Protokolle** und prüfen Sie eine vorhandene Zustellung an dieses Ziel.
4. Vergleichen Sie seinen Status mit dem Datensatz des empfangenden Dienstes, bevor Sie die Zustellung als erfolgreich bezeichnen.
**Prüfpunkt:** Ein gespeicherter Endpunkt bestätigt die Konfiguration. Ein erfolgreicher Zustellungsdatensatz und ein passender Eintrag beim Empfänger bestätigen das konkrete Ereignis. Ein leeres Protokoll beweist keine funktionierende Zustellung. Test-, Erneut-senden- und Wiederholungsaktionen senden Ereignisse. Verwenden Sie sie nur für einen beabsichtigten Test.
### Eingebettetes Anbieterportal
Runner bereitet den Webhook-Service vor, bevor das eingebettete Verwaltungsportal angezeigt wird.
| Seitenzustand oder Steuerelement | Was es bedeutet oder tut |
| --- | --- |
| **Wird geladen…** | Runner überprüft, ob der Webhook-Service bereit ist. |
| **Webhook-Plattform wird initialisiert** | Die Einrichtung ist noch nicht abgeschlossen. Warten Sie und halten Sie die Seite offen, oder kehren Sie später zurück. |
| **Initialisierung dauert länger als erwartet** | Die Einrichtung wurde nach der normalen Wartezeit nicht abgeschlossen. **Erneut versuchen** fordert Runner auf, den Service erneut bereitzustellen. |
| **Wird erneut versucht…** | Der Wiederholungsversuch ist in Bearbeitung; die Schaltfläche bleibt nicht verfügbar, bis die Anfrage abgeschlossen ist. |
| Fehlermeldung | Runner konnte den Service nicht vorbereiten. Behalten Sie die sichtbare Meldung für den Support. |
| Eingebettetes Webhook-Portal | Der Service ist bereit. Die genauen Bezeichnungen und Steuerelemente in diesem vom Anbieter verwalteten Portal können sich ändern. Folgen Sie daher den dort angezeigten Anweisungen, anstatt sich auf feste Schaltflächennamen in diesem Leitfaden zu verlassen. |
| **Shopify erneut verbinden** | Öffnet die Shopify-Integrationenseite, wenn eine ältere Shopify-Verbindung neue Webhook-Berechtigungen benötigt. Verbinden Sie erneut, bevor Sie erwarten, dass Shopify-Ereignisse ankommen. |
## Wiederherstellung nach einer langen Initialisierung
1. Warten Sie, bis die Initialisierungsmeldung abgeschlossen ist.
2. Wenn **Initialisierung dauert länger als erwartet** angezeigt wird, wählen Sie **Erneut versuchen** einmal aus.
3. Warten Sie, bis das eingebettete Portal den Initialisierungsbildschirm ersetzt.
4. Wenn ein Fehler erneut angezeigt wird, speichern Sie den Projektnamen und die genaue Meldung und kontaktieren Sie stattdessen den Support, anstatt wiederholt zu versuchen.
## Shopify erneut verbinden, wenn aufgefordert
1. Lesen Sie die Mitteilung **Shopify-Store erneut verbinden**.
2. Wählen Sie **Shopify erneut verbinden** aus.
3. Schließen Sie den Verbindungsfluss auf der Shopify-Integrationenseite ab.
4. Kehren Sie zu Webhooks zurück und bestätigen Sie, dass die Wiederverbindungsmitteilung weg ist, bevor Sie sich auf die Ereignisbereitstellung verlassen.
Das erneute Verbinden ändert die Integrationsgenehmigung des Stores. Nur eine Person, die berechtigt ist, diese Store-Verbindung zu verwalten, sollte fortfahren.
## Sicherheitshinweise
- Behandeln Sie Endpunktadressen, Signaturschlüssel und Ereignisinhalte als vertraulich.
- Fügen Sie ein Ziel hinzu oder ändern Sie es nur, wenn sein Besitzer die korrekte sichere Adresse angegeben hat.
- Überprüfen Sie jede Bestätigung, die im eingebetteten Portal angezeigt wird; ihre Aktionen können zukünftige Lieferungen beeinflussen.
- Wenn ein Signaturwert offengelegt wird, ersetzen Sie ihn sowohl im Webhook-Service von Runner als auch im empfangenden System, bevor Sie weitere Ereignisse senden.
## Fehlerbehebung
| Problem | Nächster Schritt |
| --- | --- |
| Kein Webhooks-Eintrag | Die Funktion ist in diesem Workspace nicht verfügbar. Überprüfen Sie [Funktionsverfügbarkeit](./feature-availability). |
| Initialisierung wird nicht abgeschlossen | Verwenden Sie **Erneut versuchen** einmal, melden Sie dann den genauen Zustand, wenn er sich wiederholt. |
| Fehlermeldung wird angezeigt | Behalten Sie die vollständige Meldung und den Projektnamen für den Support. |
| Shopify-Wiederverbindungsmitteilung bleibt bestehen | Schließen Sie die Wiederverbindung von der Integrationenseite ab und laden Sie Webhooks dann einmal neu. |
| Eingebettetes Portal ist leer oder verhält sich anders | Laden Sie einmal neu. Wenn es weiterhin besteht, erfassen Sie, was sichtbar ist; die eingebettete Anbieteroberfläche kann je nach Konto oder Version unterschiedlich sein. |
## Verwandte Leitfäden
- [Funktionsverfügbarkeit](./feature-availability)
- [Sicherheit und Sitzungen](../account-and-settings/security-and-sessions)
- [Apps-Fehlerbehebung](../apps-and-integrations/troubleshooting)
- [Support und Community](../help-and-reference/support-and-community)
---
# Workflow
Source: https://www.runnerai.com/docs/de/guides/advanced/workflows
Workflow wandelt einen wiederholbaren Prozess in verbundene Schritte um, die Runner mit denselben Eingaben und Regeln erneut ausführen kann.
> **Bedingt:** Die Workflow-Oberfläche existiert, aber die aktuelle Standard-Projektnavigation zeigt keinen Workflow-Eintrag an. Verwenden Sie sie nur, wenn Runner einen genehmigten Workflow-Eintrag für Ihren Workspace anzeigt oder Runner-Support einen genehmigten Pfad bereitstellt. Raten Sie nicht und bearbeiten Sie keine URL, um darauf zuzugreifen. Wenn Ihr Plan nur eine Vorschau erlaubt, kann Runner die Seite anzeigen, während ihre Steuerelemente blockiert bleiben.
## Eingabepfad
Öffnen Sie den **Workflow**-Eintrag nur, wenn Runner ihn in Ihrem Workspace anzeigt. Die Seite listet Workflows für das aktuelle Projekt auf. Wenn kein Eintrag vorhanden ist, verwenden Sie [Feature-Verfügbarkeit](./feature-availability) oder kontaktieren Sie den Support, anstatt eine direkte URL zu versuchen.
## Bevor Sie beginnen
- Der Workflow-Zugriff hängt vom aktuellen Feature-Rollout und Plan ab.
- Bestätigen Sie das Projekt und die verbundenen Dienste vor dem Testen oder Bereitstellen eines Workflows.
- Eine Vorschau oder ein gespeicherter Entwurf ist nicht aktiv; Bereitstellung und Aktivierung sind separate folgenreiche Aktionen.
## Workflow-Liste
Wenn es keine Workflows gibt, wählen Sie **Workflow erstellen**. Wenn die Liste bereits Elemente enthält, verwenden Sie **Neuer Workflow**.
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| **Workflow erstellen** oder **Neuer Workflow** | Öffnet **Workflow erstellen**. |
| **Leerer Workflow** | Erstellt einen Workflow namens **Unbenannter Workflow** und öffnet seinen Builder. |
| Vorlagenkarte | Erstellt einen Workflow aus dieser Vorlage und öffnet seinen Builder. Wenn Vorlagen nicht geladen werden, fordert **Erneut versuchen** sie erneut an. |
| Workflow-Name | Öffnet diesen Workflow im Builder. |
| **Umbenennen** | Macht den Namen bearbeitbar. Eingabe oder Wegklicken speichert ihn; Escape bricht die Bearbeitung ab. |
| **Oben anheften** / **Loslösen** | Verschiebt den Workflow in oder aus der angehefteten Gruppe. Der Workflow wird nicht ausgeführt. |
| **Duplizieren** | Erstellt eine Kopie und öffnet die Kopie im Builder. |
| **Exportieren** | Lädt den Workflow als JSON-Datei herunter. Es wird nichts bereitgestellt oder ausgeführt. |
| **Löschen** | Öffnet eine Bestätigung. Das Bestätigen entfernt diesen Workflow dauerhaft und kann nicht rückgängig gemacht werden. |
Verwenden Sie das Menü „Mehr" jeder Zeile, um **Umbenennen**, **Oben anheften** oder **Loslösen**, **Duplizieren**, **Exportieren** und **Löschen** zu finden.
Zeilenbeschriftungen können auch anzeigen, ob eine Version **Live** ist, den Status **Neuer Entwurf** hat, einen Endpoint verfügbar macht oder an einen Schedule oder Event gebunden ist. Eine pausierte oder Plan-blockierte Beschriftung bedeutet, dass automatisches Auslösen derzeit nicht aktiv ist.
### Mit mehreren Workflows arbeiten
Wählen Sie das Kontrollkästchen neben einer oder mehreren Zeilen aus. Die Auswahlleiste zeigt, wie viele ausgewählt sind, und bietet:
- **Exportieren**, um die ausgewählten Workflows herunterzuladen.
- **Löschen**, um eine Massenbestätigung zu öffnen. Das Bestätigen entfernt jeden ausgewählten Workflow dauerhaft.
- **Leeren**, um die Auswahl zu entfernen, ohne Workflows zu ändern.
**Alle auswählen** wählt die in der aktuellen Liste angezeigten Workflows aus. Überprüfen Sie immer die Anzahl vor dem Massenlöschen erneut.
## Erstellen und speichern
Die Builder-Canvas ist der Ort, an dem Sie Schritte hinzufügen, verbinden und konfigurieren, was jeder Schritt empfängt und tut. **Komponente hinzufügen** öffnet die durchsuchbare Komponentenbibliothek. Canvas-Steuerelemente zoomen ein, zoomen aus, passen den Workflow auf den Bildschirm an und ordnen verbundene Schritte automatisch an.
Änderungen werden automatisch gespeichert; es gibt keine separate Schaltfläche „Speichern". Der Zurück-Pfeil beendet einen ausstehenden Speichervorgang, bevor er zur Workflow-Liste zurückkehrt.
| Speicherstatus | Was zu tun ist |
| --- | --- |
| **Wird gespeichert…** | Warten Sie, bevor Sie die Seite schließen oder bereitstellen. |
| **Gerade eben gespeichert** (die Zeitangabe ändert sich) | Die neueste Canvas-Änderung ist gespeichert. |
| **Speichern fehlgeschlagen** | Wählen Sie **Erneut versuchen**, nachdem Sie die Verbindung überprüft haben. |
| **Konflikt – Ihre Änderungen wurden nicht gespeichert** | Eine andere gespeicherte Version ist neuer. **Neu laden** verwirft die in Konflikt stehenden lokalen Bearbeitungen und lädt die gespeicherte Version. |
Das untere Panel enthält **Testbereich** und **Läufe**. Im Testbereich füllen Sie die erforderlichen Text-, Produkt- oder Medieneingaben aus, bevor Sie ausführen. Das Ausführungssteuerelement bleibt nicht verfügbar, während erforderliche Eingaben fehlen. Ergebnisse werden im Ausgabebereich angezeigt.
Das Menü „Mehr" des Builders bietet auch **JSON exportieren** und **JSON importieren…**. Export lädt die aktuelle Canvas herunter. Import ersetzt sofort die aktuelle Canvas und löst automatisches Speichern ohne Bestätigung aus. Exportieren Sie daher eine Sicherung und überprüfen Sie die ausgewählte Datei vor dem Importieren.
## Wählen Sie den richtigen Test
Testing kann sehr unterschiedliche Konsequenzen haben.
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| **Simulieren** | Öffnet einen Simulationsdialog. Verwenden Sie generierte Beispieldaten oder fügen Sie JSON ein, wählen Sie dann **Simulation ausführen**. Schreibseitige Aktionen wie E-Mails, Slack-Beiträge und Store-Änderungen werden gestubbt. |
| **Live-Test** | Öffnet einen Live-Test-Dialog. Verwenden Sie generierte Daten, eingefügtes JSON oder ein aktuelles Event, falls verfügbar. **Live-Test durchführen** führt echte API-Aufrufe durch und kann Nachrichten senden oder verbundene Dienste ändern. Der Durchlauf wird im Verlauf als Test markiert. |
| **Wartezeiten überspringen** | Während eines Live-Tests werden konfigurierte Wartezeiten übersprungen, damit der Test schneller fortgesetzt werden kann. Es werden keine anderen echten Effekte entfernt. |
| **Workflow ausführen** | Startet den konfigurierten Workflow sofort und öffnet Läufe. Seine Schritte können echte Effekte haben; überprüfen Sie jeden Schritt und jede Eingabe zuerst. |
| **Stopp** | Fordert an, dass der aktuelle Durchlauf stoppt. Bereits abgeschlossene Arbeiten werden nicht rückgängig gemacht. |
| **Zwischenspeichern** | Bei einer erneuten Ausführung werden berechtigte Knoten übersprungen, deren Eingaben sich nicht geändert haben, damit Sie sich auf geänderte nachgelagerte Arbeiten konzentrieren können. |
Verwenden Sie Simulation, um Verzweigungen und Datenfluss zu überprüfen. Verwenden Sie Live-Test nur, wenn echte Nebenwirkungen in den verbundenen Konten akzeptabel sind.
Beide Tests verwenden den gewählten Auslöser, auch vor der Bereitstellung. Bei einem Auslöser vom Typ **Zeitplan** oder **Einmalig** startet der Test den Lauf so, als würde der Auslöser genau jetzt auslösen. So können Sie einen einmaligen Workflow vor seinem geplanten Datum testen.
## Überprüfen Sie den Ausführungsverlauf
Öffnen Sie **Läufe** im unteren Panel, um vorherige Durchläufe anzuzeigen. Filtern Sie die Liste mit **Live**, **Test** oder **Alle Läufe**, wählen Sie dann einen Durchlauf aus, um seine Knotenergebnisse, Ausgabe, Timing und Fehler zu überprüfen. Die Status umfassen Abgeschlossen, Fehlgeschlagen, Wird ausgeführt und Abgebrochen.
Wenn die Liste **Noch keine Läufe** anzeigt, hat der aktuelle Workflow keine aufgezeichnete Ausführung. Das Starten eines weiteren Durchlaufs ist keine Lösung für einen fehlgeschlagenen; öffnen Sie zuerst den fehlgeschlagenen Durchlauf und lesen Sie seinen Fehler.
Einige berechtigte fehlgeschlagene Knoten bieten **Ab "Knoten" wiederholen**. Dies startet sofort einen neuen Versuch, ohne eine weitere Bestätigung. Nachgelagerte Aktionen können erneut ausgeführt werden. Überprüfen Sie daher zuerst auf Nachrichten oder Store-Änderungen, die bereits vom fehlgeschlagenen Durchlauf erzeugt wurden.
## Bereitstellen und aktivieren
Wählen Sie **Bereitstellen**, um **Workflow bereitstellen** zu öffnen. Überprüfen Sie die Änderungszusammenfassung, API-Vertragskompatibilität, Validierungsergebnisse und optionales Änderungsprotokoll, bevor Sie fortfahren.
Sie können den bereitgestellten Workflow optional an ein Ereignis, einen wiederkehrenden Zeitplan oder eine einmalige Ausführung binden. Es kann jeweils nur ein Auslösetyp ausgewählt werden. Eine einmalige Ausführung braucht ein Datum und eine Uhrzeit in der Zukunft, angegeben in Ihrer eigenen Zeitzone.
- **Workflow bereitstellen** veröffentlicht eine Version mit den ausgewählten Einstellungen.
- **Aktivieren und bereitstellen** wird angezeigt, wenn eine neue Ereignis-, Zeitplan- oder einmalige Bindung die Automatisierung aktiv machen würde. Das Bestätigen veröffentlicht die Version und ermöglicht zukünftige Auslöser, automatisch mit echten Effekten ausgeführt zu werden.
Ein Speicherfehler, ein ungelöster Konflikt oder ein Validierungsproblem kann die Bereitstellung blockieren. Beheben Sie es, anstatt wiederholt „Bereitstellen" auszuwählen.
Der Produktionsstatus zeigt **Nicht bereitgestellt**, **Neuer Entwurf** oder **Live** sowie den Auslöser. Vor der ersten Bereitstellung ist das der gewählte Auslöser (**Ereignis**, **Zeitplan**, **Einmalig** oder **Manuell**) oder **Kein Auslöser**. Nach einer Bereitstellung ist es **Manuell**, wenn kein Auslöser gebunden ist, sonst der Status der Bindung, etwa **Aktiv**, **Geplant**, **Abgeschlossen** oder **Pausiert**. Das Öffnen einer vorhandenen Bindung bietet folgenreiche Steuerelemente:
- **Pausieren** stoppt automatische Auslöser, behält aber den Workflow und die Bindung bei.
- **Auslöser fortsetzen** ermöglicht der beibehaltenen Bindung, erneut ausgelöst zu werden.
- **Auslöser entfernen** löscht die Bindung dauerhaft, löscht aber nicht den Workflow.
Jede Aktion öffnet eine Bestätigung und kann einen Grund enthalten. Das Entfernen des Häkchens aus einer vorhandenen Bindung während der Bereitstellung pausiert diese Bindung, anstatt sie dauerhaft zu entfernen.
## Versionsverlauf und Rollback
Wählen Sie **Versionshistorie**, um das Panel **Versionshistorie** zu öffnen.
| Aktion | Ergebnis |
| --- | --- |
| **Rollback der Bewertung** | Öffnet **Rollback auf diese Version?**. **Rollback bestätigen** macht die ausgewählte bereitgestellte Version zur aktuellen bereitgestellten Version. Dies kann ändern, was zukünftige Durchläufe tun, ersetzt aber nicht die aktuelle Draft-Canvas. |
| **Wiederherstellen** im Draft-Verlauf | Ersetzt die aktuelle Canvas nach Bestätigung mit dem ausgewählten gespeicherten Entwurf. Nicht gespeicherte oder neuere Canvas-Änderungen können verloren gehen. |
Fügen Sie einen optionalen Rollback-Grund hinzu, damit andere Workspace-Mitglieder die Änderung verstehen. Überprüfen Sie die wiederhergestellte Canvas und den Bereitstellungsstatus, bevor Sie einen weiteren Durchlauf starten.
## Checkliste für sicheren Betrieb
1. Bestätigen Sie, dass Sie sich im richtigen Projekt und Workflow befinden.
2. Warten Sie, bis eine Meldung wie **Gerade eben gespeichert** angezeigt wird, bevor Sie testen oder bereitstellen.
3. Füllen Sie jede erforderliche Eingabe aus und überprüfen Sie sie.
4. Beginnen Sie mit **Simulation ausführen**, wenn möglich.
5. Verwenden Sie Live-Test oder Workflow ausführen nur, wenn ihre Effekte auf verbundene Dienste akzeptabel sind.
6. Überprüfen Sie **Läufe** und Ausgaben vor der Bereitstellung.
7. Behandeln Sie **Aktivieren und bereitstellen**, Rollback, Wiederherstellen und Löschen als folgenreiche Aktionen, die eine abschließende Überprüfung erfordern.
## Fehlerbehebung
| Problem | Nächster Schritt |
| --- | --- |
| Kein **Workflow**-Eintrag ist sichtbar | Dies ist in der Standard-Navigation zu erwarten. Raten Sie nicht zu einer URL; siehe [Feature-Verfügbarkeit](./feature-availability) oder fragen Sie Runner-Support, ob Ihr Workspace einen genehmigten Eintrag hat. |
| Steuerelemente werden durch eine Plan-Vorschau blockiert | Folgen Sie der Plan-Nachricht auf dem Bildschirm oder fragen Sie einen Workspace-Besitzer nach Zugriff. |
| Vorlagenliste schlägt fehl | Wählen Sie **Erneut versuchen** oder **Leerer Workflow**. |
| Schaltfläche „Ausführen" ist nicht verfügbar | Füllen Sie jede erforderliche Eingabe aus und beheben Sie jeden ungültigen Wert. |
| Speicherkonflikt wird angezeigt | Entscheiden Sie, ob die gespeicherte Version gewinnen sollte, bevor Sie **Neu laden** auswählen, da lokale in Konflikt stehende Bearbeitungen verworfen werden. |
| Durchlauf schlägt fehl | Öffnen Sie ihn unter **Läufe**, behalten Sie den sichtbaren Fehler und die Eingaben bei und vermeiden Sie das wiederholte Starten identischer Durchläufe. |
| Bereitstellung ist blockiert | Beheben Sie Speicher-, Konflikt-, Vertrags- oder Validierungsmeldungen, die im Bereitstellungsdialog angezeigt werden. |
## Überprüfen Sie das Ergebnis vor dem nächsten Schritt
Öffnen Sie nach dem Speichern denselben Workflow erneut und prüfen Sie seine Schritte und Eingaben. Ein gespeicherter Workflow ist zur Prüfung verfügbar, aber nicht unbedingt ausgeführt worden. Falls Ihr Arbeitsbereich Test- oder Bereitstellungsfunktionen anbietet, prüfen Sie Ausführungsstatus und Ausgabe vor der Bereitstellung. Korrigieren Sie bei einem Fehlschlag die Eingabe oder den betroffenen Schritt vor einem weiteren Versuch.
## Verwandte Leitfäden
- [Automationen](../automate-test-and-create/automations)
- [Task-Status und Details](../work-with-runner/task-states-and-details)
- [Fehlerbehebung bei Runner-Tasks](../help-and-reference/troubleshoot-runner-tasks)
- [Feature-Verfügbarkeit](./feature-availability)
---
# Agent-Anpassung
Source: https://www.runnerai.com/docs/de/guides/agent
Die **Agent**-Seite mit der Überschrift **Bringe Runner bei, wie du arbeitest** bündelt Skills und Erinnerungen an einem durchsuchbaren Ort. Verwenden Sie sie, wenn Runner eine bewährte Methode wiederholen, eine dauerhafte Information behalten oder einen nicht mehr benötigten Skill nicht länger verwenden soll.
## Was dieser Leitfaden abdeckt
Sie werden wissen, wie Sie die Agent-Anpassung öffnen, eine vorhandene Funktion finden und entscheiden, ob ein Skill oder Speicher das richtige Werkzeug ist.
## Verfügbarkeit und Voraussetzungen
- Sie benötigen Zugriff auf ein Store-Projekt.
- Skills können von Ihrem aktuellen Plan abhängen. Wenn Ihr Plan Skills nicht enthält, zeigt Runner stattdessen den verfügbaren Upgrade-Pfad an, anstatt die Aktion zu aktivieren.
- Speicher wird nur angezeigt, wenn die einheitliche Speicherfunktion für Ihr Konto aktiviert ist.
- Ältere **Skills**-, **Speicher**- und **Customize**-Links werden auf diese Agent-Seite umgeleitet.
## Agent-Anpassung öffnen
Wählen Sie in einem Projekt in der Seitenleiste **Agent** aus. Verwenden Sie die Filter **Alle**, **Skills** und **Speicher**, um die Seite einzugrenzen. **Für Sie empfohlen**, **Hinzugefügt** und **Entdecken** sind Abschnitte innerhalb dieser Seite, keine separaten Navigationsregisterkarten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Filtern Sie die Seite nach Skills oder Erinnerungen. Bereits aktive Skills erscheinen unter **Hinzugefügt**. Das Ansehen einer Empfehlung installiert sie nicht.
## Hauptsteuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Skills und Erinnerungen suchen** | Findet einen Skill ohne Durchsuchen aller Bereiche. | Die Seite filtert Skills und Erinnerungen. Das Leeren der Suche stellt die vollständige Liste wieder her. |
| **Alle** | Überprüfen Sie alles, was auf der Agent-Seite verfügbar ist. | Runner zeigt den Skills-Bereich und, wenn aktiviert, den Speicher. |
| **Skills** | Konzentrieren Sie sich auf wiederverwendbare Anweisungen und Skills. | Runner zeigt empfohlene, hinzugefügte, pausierte und erkennbare Skills. |
| **Speicher** | Konzentrieren Sie sich auf Tatsachen, die Runner behalten sollte. | Runner zeigt Speichereinträge gruppiert nach Umfang. Diese Registerkarte ist ausgeblendet, wenn Speicher nicht verfügbar ist. |
| **Hinzufügen** | Installieren oder reaktivieren Sie einen Skill. | Der Skill wird nach Abschluss der Aktion in **Hinzugefügt** verschoben. |
| **Hinzugefügt** | Sehen Sie, dass ein Skill aktiv ist. | Für konfigurierbare Skills pausiert die Auswahl diesen Skill. |
| **Importieren** | Bringen Sie einen kompatiblen Skill von einer URL ein. | Runner überprüft die Quelle und öffnet dann einen bearbeitbaren Import oder einen Multi-Skill-Wähler. |
| **Skill erstellen** | Schreiben Sie eine benutzerdefinierte wiederverwendbare Anweisung. | Der Skill-Editor wird geöffnet. Erforderliche Felder müssen vollständig sein, bevor sie gespeichert werden können. |
| **Speicher hinzufügen** | Speichern Sie eine stabile Tatsache oder Vorliebe. | Das Dialogfeld **Neuer Speicher** wird geöffnet. |
## Wählen Sie zwischen einem Skill und Speicher
1. Verwenden Sie einen **Skill**, wenn Runner einen wiederholbaren Prozess, ein Format oder eine Reihe von Anweisungen befolgen sollte.
2. Verwenden Sie **Speicher**, wenn Runner eine prägnante Tatsache, Vorliebe, Korrektur, Konvention oder Entscheidung behalten sollte.
3. Halten Sie Geheimnisse aus beiden fern. Speichern Sie niemals Passwörter, API-Schlüssel, Zahlungsdetails oder private Anmeldedaten.
4. Kehren Sie zu **Alle** zurück und suchen Sie nach einem Begriff, um zu bestätigen, dass das neue Element angezeigt wird.
## Zustände und Limits
- **Für Sie empfohlen** zeigt eine kleine Reihe von Trend-Skills.
- **Hinzugefügt** enthält aktive Skills; **Pausiert** enthält inaktive Skills.
- **Entdecken** kann Ladezeilen, Suchergebnisse oder eine Meldung ohne Ergebnisse anzeigen.
- Ein System-Skill kann schreibgeschützt oder fest sein. Ein Custom-Skill kann Bearbeitungs- und Löschaktionen anbieten.
- Ein leerer Speicherbereich bietet **Speicher hinzufügen**. Eine Suche ohne Übereinstimmung bietet **Suche löschen**, ohne etwas zu löschen.
- Lade-, Plan- und nicht verfügbare Zustände bedeuten nicht, dass eine Funktion hinzugefügt wurde.
## Fehlerbehebung
- Wenn **Speicher** fehlt, ist die Funktion für das aktuelle Konto nicht aktiviert. Verwenden Sie weiterhin Skills oder überprüfen Sie später erneut in der sichtbaren Navigation.
- Wenn **Hinzufügen** einen Upgrade-Bildschirm öffnet, vergleichen Sie die Pläne, bevor Sie eine Abrechnungsentscheidung treffen.
- Wenn die Suche nichts findet, löschen Sie die Abfrage und überprüfen Sie **Alle**, **Skills** und **Speicher** separat.
- Wenn eine Änderung fehlschlägt, halten Sie das Dialogfeld offen, korrigieren Sie das angezeigte Problem und versuchen Sie es erneut. Gehen Sie nicht davon aus, dass ein Toast oder Ladezustand bedeutet, dass die Änderung abgeschlossen ist.
## Verwandte Leitfäden
- [Skills verwenden und pausieren](/de/guides/agent/skills)
- [Skills erstellen, importieren und verwalten](/de/guides/agent/create-import-manage-skills)
- [Speicher hinzufügen und bearbeiten](/de/guides/agent/memory)
- [Verwenden Sie die Agent-Befehlspalette](/de/guides/agent/command-palette)
---
# Agent-Befehlspalette
Source: https://www.runnerai.com/docs/de/guides/agent/command-palette
Die Agent-Befehlspalette ist eine Tastatur-erste Verknüpfung für Agent-Funktionen. Sie ist nützlich, wenn Sie wissen, was Sie benötigen, und nicht die vollständige Agent-Seite durchsuchen möchten.
## Was dieser Leitfaden abdeckt
Sie können die Palette öffnen, ihre drei Funktionsgruppen durchsuchen, die Tastatur verwenden und verstehen, was die Auswahl jedes Ergebnisses bewirkt.
## Verfügbarkeit und Voraussetzungen
- Sie müssen sich in einem Projekt befinden.
- Skills unterliegen weiterhin dem Tarifzugriff und dem konfigurierbaren Status jedes Skills.
- Speicherergebnisse werden nur angezeigt, wenn der einheitliche Speicher aktiviert ist.
- Diese Palette unterscheidet sich von der Projektnavigationssuche: **Command/Ctrl + K** durchsucht Ziele und Unterhaltungen, während **Command/Ctrl + Shift + K** Agent-Funktionen öffnet.
## Eingabepfad
Drücken Sie in einem Projekt mit verfügbarer Palette **Command + Shift + K** unter macOS oder **Control + Shift + K** unter Windows und Linux. Prüfen Sie vor der Auswahl eines Ergebnisses, ob die Filter **Skills** und **Speicher** erscheinen. Falls stattdessen die Navigationssuche öffnet, schließen Sie sie und verwenden Sie **Agent** in der Seitenleiste.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Falls das Tastenkürzel die Skill-Palette nicht öffnet, finden Sie dieselben Skills auf dieser **Agent**-Seite. Das Bild zeigt die alternative Seite, nicht die Befehlspalette.
## Steuerelemente
| Eingabe oder Taste | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| Suchfeld | Suchen Sie Skills nach Name, Beschreibung, Kategorie oder Typ und Speicher nach Inhalt, Tags, Typ oder Umfang. | Ergebnisse werden unter Hinzugefügt, Entdecken und Speicher aktualisiert. |
| **Alle** | Suchen Sie jeden verfügbaren Funktionstyp. | Skills und, falls verfügbar, Speicher werden zusammen angezeigt. |
| **Skills** | Begrenzen Sie die Ergebnisse auf installierte und erkennbare Skills. | Speicherzeilen sind ausgeblendet. |
| **Speicher** | Begrenzen Sie die Ergebnisse auf gespeicherte Einträge. | Diese Registerkarte ist ausgeblendet, wenn Speicher nicht verfügbar ist. |
| Pfeile nach oben/unten | Bewegen Sie sich durch Ergebnisse ohne Maus. | Die hervorgehobene Zeile ändert sich. |
| Eingabe | Wählen Sie die hervorgehobene Zeile aus. | Das Ergebnis führt seine typspezifische Aktion aus. |
| Escape | Verlassen Sie, ohne etwas zu ändern. | Die Palette wird geschlossen. |
## Was die Auswahl bewirkt
| Ergebnistyp | Was passiert, wenn ausgewählt |
| --- | --- |
| Hinzugefügter konfigurierbarer Skill | Runner schaltet den aktiven Status des Skills um, wenn Ihr Tarif dies zulässt. |
| Fester System-Skill | Die Zeile bleibt unverändert, wenn dieser Skill nicht umgeschaltet werden kann. |
| Skill entdecken | Runner beginnt mit dem Hinzufügen des Skills; die Zeile kann **Wird hinzugefügt…** anzeigen. |
| Speicher | Die Palette wird geschlossen und öffnet **Agent → Speicher** mit einer Suche basierend auf diesem Speicher. |
| Skill ohne Tarifzugriff | Runner öffnet **Agent → Skills**, wo das Plan-Gate den verfügbaren nächsten Schritt erklärt. |
## Verwenden Sie die Palette
1. Drücken Sie **Command/Ctrl + Shift + K**.
2. Geben Sie ein charakteristisches Wort aus dem Skill-Namen, der Quelle oder dem Speicherinhalt ein.
3. Wählen Sie bei Bedarf **Skills** oder **Speicher**, um die Liste einzugrenzen.
4. Verwenden Sie die Pfeiltasten, um eine Zeile hervorzuheben.
5. Überprüfen Sie den Aktionstext auf der rechten Seite, z. B. **Hinzufügen** oder **Öffnen**.
6. Drücken Sie die Eingabetaste nur, wenn dies die gewünschte Aktion ist.
7. Bestätigen Sie das Ergebnis auf der Agent-Seite oder im aktualisierten Palettenzustand.
## Zustände und Grenzen
- **Nichts anzuzeigen** bedeutet, dass die aktuelle Registerkarte und Abfrage keine Zeilen zurückgegeben haben.
- **Wird hinzugefügt…** ist ein Fortschrittszustand, keine Bestätigung, dass die Installation abgeschlossen ist.
- Die Palette ist für schnelle Auswahl optimiert; Erstellen, Bearbeiten, Löschen, Speicherumfang und detaillierte Skill-Einstellungen bleiben auf der vollständigen Agent-Seite.
- Die Auswahl eines aktiven Skills kann diesen anhalten. Lesen Sie den Zeilenzustand, bevor Sie die Eingabetaste drücken.
## Fehlerbehebung
- Falls das Tastenkürzel die Projektsuche oder mehrere Dialoge öffnet, schließen Sie diese mit Escape. Verwalten Sie dieselben Skills über **Agent** in der Seitenleiste.
- Wenn Speicher fehlt, hat das Konto derzeit nicht die einheitliche Speicheroberfläche.
- Wenn Enter die Agent-Seite öffnet, anstatt einen Skill umzuschalten, folgen Sie dem angezeigten Plan-Gate.
- Wenn keine Ergebnisse vorhanden sind, löschen Sie die Suche oder wählen Sie **Alle**.
- Wenn ein Skill unverändert bleibt, kann es sich um einen festen System-Skill handeln.
## Verwandte Leitfäden
- [Übersicht zur Agent-Anpassung](/de/guides/agent)
- [Skills](./skills)
- [Speicher](./memory)
- [Abonnementpläne](../plans-and-billing/subscription-plans)
---
# Skills erstellen, importieren und verwalten
Source: https://www.runnerai.com/docs/de/guides/agent/create-import-manage-skills
Benutzerdefinierte Skills ermöglichen es Ihnen, Ihre eigenen Anweisungen zur wiederholten Verwendung zu verpacken. Der Import ist nützlich, wenn bereits ein kompatibler Skill vorhanden ist und Sie diesen vor dem Hinzufügen zu Runner überprüfen möchten.
## Was dieser Leitfaden abdeckt
Sie werden wissen, wie Sie einen Skill erstellen oder importieren, jedes Editor-Steuerelement verstehen und reversibles Pausieren von permanentem Löschen unterscheiden können.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie ein Projekt mit Zugriff auf **Agent → Skills**.
- Skills erfordern den passenden Tarif.
- Der Import erfordert eine kompatible Quell-URL, die Runner lesen kann.
- Importieren Sie keine Anweisungen, denen Sie nicht vertrauen. Überprüfen Sie den Namen, die Beschreibung, den Inhalt, die Einstellungen und die enthaltenen Dateien vor dem Speichern.
## Eingabepfade
- Erstellen: Seitenleiste **Agent** → **Skills**-Filter → **Skill erstellen** im Abschnitt **Entdecken**.
- Import: Seitenleiste **Agent** → **Skills**-Filter → **Importieren** in **Entdecken**.
- Bearbeiten oder löschen: Seitenleiste **Agent** → **Skills**-Filter → eine Zeile in **Hinzugefügt** → **Weitere Aktionen**.
## Skill-Editor-Steuerelemente
| Eingabe oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Name** | Gibt dem Skill seine Identität in Listen und Befehlen. | Runner validiert, dass ein Name vorhanden ist, bevor gespeichert wird. |
| **Beschreibung** | Erklärt, wann der Skill verwendet werden sollte. | Die Beschreibung wird in Skill-Listen und Selektoren angezeigt. |
| **Inhalt** | Speichert wiederverwendbare Anweisungen. | Schreiben Sie unter **Bearbeiten** und prüfen Sie die formatierten Anweisungen unter **Vorschau**. |
| **Erweiterte Konfiguration** | Zeigt optionale Aufruf- und Organisationseinstellungen an. | Erweitern Sie es nur, wenn Sie diese Einstellungen ändern müssen. |
| **Zu Markdown wechseln** / **Zu Formular wechseln** | Ändert die Art und Weise, wie Sie den Skill bearbeiten. | Öffnet den Markdown- oder feldbasierten Editor; Beim Wechseln der Ansichten wird der Skill nicht gespeichert. |
| **Kategorie** | Gruppiert verwandte Skills. | Dieses optionale Label beeinflusst die Organisation von Skills. |
| **Tastenkombinations-Label** | Gibt dem Skill ein klareres Befehls-Label. | Das optionale Label wird mit befehlsorientierten Steuerelementen angezeigt. |
| **Aktiviert** | Bestimmt, ob der neue oder bearbeitete Skill aktiv startet. | Bei einem neuen Skill ist die Option eingeschaltet. Deaktivieren Sie sie vor dem Erstellen, wenn der Skill pausiert starten soll. |
| **KI-Auto-Aufruf deaktivieren** | Verhindert, dass Runner den Skill automatisch auswählt. | Der Skill bleibt für manuelle Verwendung verfügbar. |
| **Benutzer-Aufrufbar** | Ermöglicht manuelle Schrägstrich-Befehls-Verwendung. | Das Ausschalten entfernt den manuellen Aufruf, während andere zulässige Verwendungen erhalten bleiben. |
| **Argument-Hinweis** | Zeigt die erwartete Eingabe nach einem Befehl an. | Der Hinweis kann Beispiele wie eine URL oder Problemnummer anzeigen. |
| Dateienbereich | Fügen Sie unterstützende Text- oder Asset-Dateien hinzu, die der Skill benötigt. | Runner validiert einzelne und Gesamtdateigrößenlimits vor dem Speichern. |
| **Abbrechen** | Beenden Sie, ohne die aktuelle Bearbeitung anzuwenden. | Das Dialogfeld wird geschlossen; nicht gespeicherte Änderungen werden verworfen. |
| **Erstellen** / **Speichern** | Speichert einen gültigen Skill. | Runner schließt nach Erfolg den Editor und aktualisiert die Skill-Liste. |
## Erstellen Sie einen benutzerdefinierten Skill
1. Öffnen Sie die Seitenleiste **Agent** und wählen Sie den Filter **Skills** aus.
2. Wählen Sie in **Entdecken** die Option **Skill erstellen**.
3. Geben Sie im Feld **Name** Kleinbuchstaben und Bindestriche ein, etwa `homepage-copy-review`. Ergänzen Sie eine kurze **Beschreibung** und den **Inhalt** des Skills. Diese Felder sind erforderlich.
4. Wählen Sie **Vorschau** im Inhalt aus, um die Anweisungen zu überprüfen. Erweitern Sie **Erweiterte Konfiguration** für optionale Einstellungen nur dann, wenn Sie sie benötigen.
5. Prüfen Sie **Aktiviert** und geänderte erweiterte Aufrufeinstellungen. Sie bestimmen, wie Runner den Skill verwenden kann.
6. Wählen Sie **Erstellen**.
7. Bestätigen Sie, dass der Skill unter **Hinzugefügt** oder **Pausiert** angezeigt wird, je nach der Einstellung "Aktiviert".
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4coukNWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
In diesem Beispiel werden Anweisungen vor **Erstellen** in der Vorschau angezeigt. Der Entwurf wurde nicht gespeichert.
### Ansehen: Einen Skill-Entwurf prüfen
Die Aufnahme wechselt im Beispiel zwischen Markdown und Formularvorschau und bricht anschließend ab. Um Ihren eigenen Skill zu behalten, wählen Sie **Erstellen** und prüfen Sie seinen Eintrag in der Liste.
## Importieren Sie einen Skill
1. Öffnen Sie **Agent**, wählen Sie den Filter **Skills** aus und suchen Sie **Importieren** in **Entdecken**.
2. Fügen Sie die kompatible Quell-URL ein.
3. Wählen Sie **Importieren**.
4. Für einen entdeckten Skill öffnet Runner den Editor mit gefüllten importierten Feldern. Für eine Quelle mit mehreren Skills öffnet Runner einen Auswahlbereich.
5. Überprüfen Sie jedes importierte Feld und alle Warnungen zu ausgeschlossenen Dateien oder Größe.
6. Nehmen Sie die erforderlichen Änderungen vor und wählen Sie dann **Erstellen** aus.
7. Bestätigen Sie, dass der Skill auf der Agent-Seite angezeigt wird, bevor Sie Ihren Workflow schließen.
Der Import macht nicht überprüfte Inhalte nicht vertrauenswürdig. Behandeln Sie importierte Anweisungen wie jeden anderen Inhalt, der die Arbeit von Runner beeinflussen kann.
## Bearbeiten, pausieren oder löschen
1. Wählen Sie eine Zeile mit benutzerdefinierten Skills oder öffnen Sie **Weitere Aktionen → Bearbeiten**.
2. Ändern Sie die benötigten Felder und wählen Sie **Speichern** aus. Öffnen Sie den Skill erneut, um die aktualisierten Anweisungen zu bestätigen.
3. Um die Verwendung zu beenden, ohne sie zu verlieren, wählen Sie **Hinzugefügt**, um sie zu **Pausiert** zu verschieben.
4. Um sie zu entfernen, öffnen Sie **Weitere Aktionen → Löschen**.
5. Überprüfen Sie das benannte Bestätigungsdialogfeld und wählen Sie **Löschen** nur, wenn Sie den Skill entfernen möchten.
**Löschen ist destruktiv.** Es ist nicht dasselbe wie Pausieren, und die Seite präsentiert es nicht als rückgängig machbare Aktion. System-Skills bieten keine Löschoption.
## Zustände und Limits
- Fehlender Name, Beschreibung oder Inhalt blockiert das Speichern und zeigt eine Validierungsmeldung an.
- Ein doppelter importierter Skill-Name kann abgelehnt oder als bereits vorhanden markiert werden.
- Dateien, die akzeptierte Limits überschreiten, können übersprungen werden; eine Gesamtgrößenwarnung kann das Speichern blockieren, bis der Inhalt reduziert wird.
- Während Speichern, Importieren oder Löschen ausgeführt wird, warten Sie auf die Erfolgs- oder Fehlermeldung, bevor Sie eine andere Aktion ausführen.
- Schreibgeschützte System-Skills können Details anzeigen, aber keine Bearbeitungssteuerelemente für benutzerdefinierte Skills verfügbar machen.
## Fehlerbehebung
- Wenn **Importieren** nicht verfügbar bleibt, warten Sie, bis die Überprüfung des vorhandenen Skills abgeschlossen ist, und bestätigen Sie, dass das URL-Feld nicht leer ist.
- Wenn der Import einen Batch-Auswahlbereich öffnet, wählen Sie nur die Skills aus, die Sie erkennen und benötigen.
- Wenn das Speichern blockiert ist, überprüfen Sie die erforderlichen Felder und alle Dateiwarnungen oben im Editor.
- Wenn ein Skill nach Auswahl von **Hinzugefügt** verschwunden ist, überprüfen Sie **Pausiert**, bevor Sie ihn neu erstellen.
- Wenn das Löschen fehlschlägt, bleibt der Skill erhalten; schließen Sie den Fehler und versuchen Sie es erneut, nachdem Sie Ihre Berechtigungen überprüft haben.
## Verwandte Leitfäden
- [Skills](./skills)
- [Agent-Anpassungsübersicht](/de/guides/agent)
- [Verwenden Sie die Agent-Befehlspalette](./command-palette)
- [Speichern Sie Agent-Einstellungen](../account-and-settings/custom-scripts-and-store-agent)
---
# Speicher
Source: https://www.runnerai.com/docs/de/guides/agent/memory
Speicher ist für prägnante Fakten, die Runner behalten sollte, wie eine Schreibpräferenz, eine korrigierte Geschäftsregel oder eine genehmigte Entscheidung. Es reduziert wiederholte Erklärungen über Aufgaben hinweg.
## Was dieser Leitfaden abdeckt
Sie können einen Speicher hinzufügen, suchen, bearbeiten und sicher löschen.
## Verfügbarkeit und Voraussetzungen
- Sie benötigen ein Store-Projekt.
- Die Registerkarte **Speicher** wird nur angezeigt, wenn der einheitliche Speicher für Ihr Konto aktiviert ist.
- Speicher ist unabhängig vom Skills-Plan-Gate.
- Speichern Sie niemals Passwörter, API-Schlüssel, Zahlungsdetails, private Anmeldedaten oder andere Geheimnisse im Speicher.
## Eingabepfad
Wählen Sie in der Seitenleiste **Agent** und dann den Filter **Speicher** aus.
## Speichersteuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Speicher hinzufügen** | Speichern Sie einen neuen Fakt für Runner. | Das Dialogfeld **Neuer Speicher** wird geöffnet. |
| **Inhalt** | Geben Sie den Fakt an, den Runner behalten sollte. | Dieser Text wird zum sichtbaren Speicher. |
| **Bereich** | Wählen Sie, wo der Fakt gelten sollte. | Wählen Sie **Diesen Store**, **Persönlich** oder **Organisation**. |
| **Typ** | Erklären Sie, um welche Art von Fakt es sich handelt. | Wählen Sie Voreinstellung, Korrektur, Konvention, Wissen oder Entscheidung. |
| **Tags** | Machen Sie den Speicher leichter zu finden und zu gruppieren. | Geben Sie ein oder mehrere durch Kommas getrennte Tags ein. Mindestens ein Tag ist erforderlich zum Speichern. |
| **Wichtigkeit** | Teilen Sie Runner mit, wie stark der Fakt gewichtet werden sollte. | Wählen Sie Niedrig, Mittel oder Hoch. |
| **Speicher hinzufügen** | Speichern Sie einen gültigen neuen Speicher. | Das Dialogfeld wird nach erfolgreichem Abschluss geschlossen und der Speicher wird in seiner Bereichsgruppe angezeigt. |
| Bearbeitungssymbol | Korrigieren oder verfeinern Sie einen Speicher. | **Speicher bearbeiten** wird mit den aktuellen Werten geöffnet. |
| **Speichern** | Wenden Sie eine Bearbeitung an. | Die Zeile wird nach erfolgreichem Update aktualisiert. |
| Löschsymbol oder **Löschen** | Entfernen Sie einen Speicher. | Runner öffnet ein destruktives Bestätigungsdialogfeld. |
## Speicher hinzufügen
1. Öffnen Sie die Seitenleiste **Agent** und wählen Sie dann den Filter **Speicher** aus.
2. Wählen Sie **Speicher hinzufügen**.
3. Schreiben Sie unter **Inhalt** eine klare Information, etwa „Verwende für Überschriften in diesem Store normale Satzschreibung.“
4. Wählen Sie den engsten korrekten **Bereich**.
5. Wählen Sie den nächsten **Typ**.
6. Fügen Sie nützliche kommagetrennte **Tags** hinzu, z. B. `copy, headings`.
7. Legen Sie **Wichtigkeit** fest. Verwenden Sie Hoch sparsam für Fakten, die Runner priorisieren sollte, wenn Informationen konkurrieren.
8. Wählen Sie **Speicher hinzufügen**.
9. Bestätigen Sie, dass die neue Zeile unter dem beabsichtigten Bereich angezeigt wird.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Das Beispiel ist eine ungespeicherte Präferenz. Wählen Sie den kleinsten passenden Geltungsbereich, bevor Sie **Erinnerung hinzufügen** wählen.
### Ansehen: Den Geltungsbereich einer Erinnerung wählen
Die Aufnahme prüft die Geltungsbereichsauswahl einer Beispielpräferenz und bricht ab. Es wird keine Erinnerung gespeichert. Folgen Sie zum Speichern Ihrer eigenen Erinnerung den obigen Schritten und prüfen Sie die neue Zeile.
## Speicher bearbeiten oder löschen
1. Suchen Sie den Speicher, indem Sie seine Bereichsgruppe durchsuchen oder die Suche verwenden.
2. Wählen Sie das Bearbeitungssymbol aus, aktualisieren Sie die Felder und wählen Sie **Speichern** aus. Öffnen Sie die Zeile erneut, um den neuen Inhalt und Umfang zu überprüfen.
3. Um ihn zu entfernen, wählen Sie das Löschsymbol oder **Löschen** im Bearbeitungsdialogfeld.
4. Überprüfen Sie **Speicher löschen** und wählen Sie **Löschen** zur Bestätigung.
Das Löschen eines Speichers kann nicht aus diesem Dialogfeld rückgängig gemacht werden. Abbrechen schließt die Bestätigung, ohne ihn zu entfernen.
## Zustände und Limits
- Ein neues Konto kann **Noch keine Speicher** mit einer Aktion **Speicher hinzufügen** anzeigen.
- Eine Suche ohne Treffer zeigt, wie viele Speicher verborgen sind, und bietet **Suche löschen**.
- Inhalt und mindestens ein Tag sind erforderlich, bevor die Speicherschaltfläche verfügbar wird.
- Speicher werden nach Bereich gruppiert und zeigen ihren Typ, Bereich, Nutzungsanzahl und letzte Nutzungszeit.
- Speicher macht einen Fakt für Runner verfügbar; es ist keine Garantie, dass der Fakt jede Anweisung oder Sicherheitsgrenze außer Kraft setzt.
## Fehlerbehebung
- Wenn die Registerkarte **Speicher** fehlt, verwenden Sie die sichtbare Navigation anstelle eines alten direkten Links. Die Funktion ist für das aktuelle Konto nicht aktiviert.
- Wenn **Speicher hinzufügen** deaktiviert ist, fügen Sie Inhalt und mindestens ein durch Kommas getrenntes Tag hinzu.
- Wenn die Liste nach der Suche leer erscheint, wählen Sie **Suche löschen**.
- Wenn eine Bearbeitung fehlschlägt, bleibt der vorherige Speicher erhalten. Korrigieren Sie das angezeigte Problem und versuchen Sie es erneut.
- Wenn ein Speicher zu breit angewendet wird, bearbeiten Sie ihn und wählen Sie einen engeren Bereich.
## Verwandte Leitfäden
- [Speichertypen und -bereiche](./memory-types-and-scopes)
- [Übersicht über Agent-Anpassung](/de/guides/agent)
- [Verwenden Sie die Agent-Befehlspalette](./command-palette)
- [API-Schlüsselsicherheit](../account-and-settings/api-keys)
---
# Speichertypen und Bereiche
Source: https://www.runnerai.com/docs/de/guides/agent/memory-types-and-scopes
Der Bereich verhindert, dass eine Information die falsche Arbeit erreicht, während Typ und Wichtigkeit Runner helfen, sie zu interpretieren. Verwenden Sie diese Seite, wenn ein Speicher auf mehr als eine Aufgabe angewendet werden sollte, aber nicht unbedingt auf jeden Shop oder jede Person.
**Eingabepfad:** **Seitenleiste → Agent → Speicher → Speicher hinzufügen**, oder öffnen Sie einen vorhandenen Speicher, um ihn zu bearbeiten.
## Was dieser Leitfaden abdeckt
Sie können den engsten korrekten Bereich wählen, einen Speicher klassifizieren und Tags sowie Wichtigkeit verwenden, ohne sensible Daten zu speichern.
## Verfügbarkeit und Voraussetzungen
- Unified Memory muss für das Konto aktiviert sein.
- Öffnen Sie **Seitenleiste → Agent → Speicher → Speicher hinzufügen** oder bearbeiten Sie einen vorhandenen Speicher.
- Verwenden Sie keinen Bereich für Passwörter, API-Schlüssel, Kartendaten, Authentifizierungscodes oder andere Geheimnisse.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wählen Sie mit **Geltungsbereich**, wo eine Information gilt, und mit **Typ**, was sie darstellt. Dies ist ein ungespeichertes Beispiel. [Erinnerungen hinzufügen und bearbeiten](/de/guides/agent/memory) enthält die vollständige Anleitung und Aufnahme.
## Bereichsoptionen
| Bereich | Verwenden Sie ihn, wenn | Was passiert als Nächstes |
| --- | --- | --- |
| **Dieser Shop** | Die Information ist spezifisch für die aktuelle Storefront, den Katalog, die Marke oder den Workflow. | Runner gruppiert den Speicher unter dem Shop-Bereich und kann ihn auf Arbeiten für diesen Shop anwenden. Ein neuer Speicher verwendet standardmäßig diesen Bereich, den Typ **Präferenz** und die Wichtigkeit **Mittel**. |
| **Persönlich** | Die Information beschreibt Ihre eigene Arbeitspräferenz. | Runner gruppiert ihn als Persönlich, anstatt ihn als arbeitsbereichsweite Regel zu teilen. |
| **Organisation** | Die Information ist eine genehmigte Regel oder Konvention, die im gesamten Arbeitsbereich geteilt wird. | Runner gruppiert ihn unter Organisation, damit er Arbeiten über einen Shop hinaus informieren kann. |
Wählen Sie den engsten Bereich, der immer noch nützlich ist. Eine Shop-spezifische Versandregel sollte beispielsweise kein Organisations-Speicher sein, es sei denn, sie gilt wirklich überall.
## Typoptionen
| Typ | Gute Verwendung | Beispiel |
| --- | --- | --- |
| **Präferenz** | Ein gewünschter Stil oder eine Arbeitswahl | "Verwenden Sie prägnante, redaktionelle Produktbeschreibungen." |
| **Korrektur** | Eine Information, die Runner zuvor falsch verstanden hat | "Das Rückgabefenster ist im genehmigten Richtliniendokument angegeben." |
| **Konvention** | Eine wiederholbare Benennungs- oder Formatierungsregel | "Verwenden Sie Satzanfang-Großschreibung für Kollektion-Überschriften." |
| **Wissen** | Eine stabile Geschäfts- oder Produktinformation | "Die Flaggschiff-Kollektion heißt Studio Essentials." |
| **Entscheidung** | Eine genehmigte Wahl, die zukünftige Arbeiten respektieren sollten | "Halten Sie den Gastkasse aktiviert." |
Fügen Sie kein Geheimnis in ein Beispiel oder einen Speicher ein. Verweisen Sie stattdessen auf den Speicherort einer geschützten Anmeldeinformation, anstatt ihren Wert zu speichern.
## Wichtigkeit und Tags
| Steuerelement | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Niedrig** | Halten Sie eine hilfreiche, aber optionale Information verfügbar. | Runner gibt ihr weniger Gewicht, wenn Informationen konkurrieren. |
| **Mittel** | Verwenden Sie die normale Priorität für stabile Arbeitsfakten. | Runner gibt ihr das Standard-Mittelgewicht. |
| **Hoch** | Markieren Sie eine wichtige genehmigte Regel oder Entscheidung. | Runner gibt ihr mehr Gewicht, wenn zwischen relevanten Speichern gewählt wird. |
| **Tags** | Vereinfachen Sie Suche und Gruppierung. | Komma-getrennte Tags werden mit dem Speicher gespeichert; mindestens eines ist erforderlich. |
Wichtigkeit ist ein Prioritätshinweis, keine Anweisung, die aktuelle Anfrage, Kontoberechtigungen oder Sicherheitsbeschränkungen zu ignorieren.
## Klassifizieren Sie einen Speicher
1. Schreiben Sie die Information als einen klaren Satz.
2. Fragen Sie, wo sie gelten sollte: nur dieser Shop, nur für Sie oder im gesamten Unternehmen.
3. Wählen Sie den nächsten Typ basierend darauf, warum die Information existiert.
4. Fügen Sie einen kleinen Satz spezifischer Tags hinzu.
5. Beginnen Sie mit Mittlerer Wichtigkeit, es sei denn, es gibt einen klaren Grund, Niedrig oder Hoch zu wählen.
6. Speichern Sie und bestätigen Sie, dass die Zeile unter der erwarteten Bereichsüberschrift angezeigt wird.
## Zustände und Limits
- Die Liste zeigt Typ, Bereich, wie oft der Speicher verwendet wurde, und eine relative aktuelle Nutzungszeit.
- Das Bearbeiten des Bereichs verschiebt den Speicher nach erfolgreichem Speichern in eine andere Gruppe.
- Die Speicherauswahl hängt von Relevanz und Priorität ab; ein Speicher mit Hoher Wichtigkeit ist nicht garantiert in jeder Antwort vorhanden.
## Fehlerbehebung
- Wenn ein Speicher den falschen Shop beeinflusst, ändern Sie seinen Bereich zu **Dieser Shop** im korrekten Projekt.
- Wenn zwei Speicher in Konflikt stehen, bearbeiten oder löschen Sie den veralteten, anstatt beide auf Hoch zu setzen.
- Wenn die Suche einen Speicher vermisst, versuchen Sie Wörter aus seinem Inhalt oder Tags, dann löschen Sie den Filter.
- Wenn eine gemeinsame Konvention für Mitarbeiter nicht sichtbar ist, bestätigen Sie, dass sie als **Organisation** gespeichert wurde, nicht als Persönlich.
## Verwandte Leitfäden
- [Speicher hinzufügen und bearbeiten](./memory)
- [Agent-Anpassungsübersicht](/de/guides/agent)
- [Sicherheit und Sitzungen](../account-and-settings/security-and-sessions)
---
# Skills
Source: https://www.runnerai.com/docs/de/guides/agent/skills
Skills geben Runner einen wiederholbaren Satz von Anweisungen für eine Art von Arbeit. Sie sind nützlich, wenn Sie einen zuverlässigen Prozess über zukünftige Gespräche hinweg verfügbar haben möchten, anstatt jedes Mal die gleiche Eingabeaufforderung neu zu schreiben.
## Was dieser Leitfaden abdeckt
Sie können einen Skill hinzufügen, feststellen, ob er aktiv ist, ihn pausieren und verstehen, welche Aktionen für System- und benutzerdefinierte Skills verfügbar sind.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie ein Store-Projekt, für das Sie die Berechtigung zum Verwalten von Agent-Funktionen haben.
- Die Nutzung von Skills ist tarifabhängig. Runner zeigt einen Upgrade-Pfad an, wenn der aktuelle Tarif dies nicht beinhaltet.
- Einige System-Skills können nicht pausiert, bearbeitet oder gelöscht werden.
## Einstiegspfad
Wählen Sie in der Seitenleiste **Agent** und dann den Filter **Skills** aus. Scrollen Sie auf derselben Seite zu **Für Sie empfohlen**, **Hinzugefügt** oder **Entdecken**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Lesen Sie die Skill-Quelle und den aktuellen Status, bevor Sie **Hinzufügen** oder **Hinzugefügt** auswählen. Der Screenshot zeigt vorhandene Skills, nicht das Ergebnis der Installation eines neuen.
## Skill-Bereiche und Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Für Sie empfohlen** | Überprüfen Sie schnell eine kleine Auswahl an beliebten Skills. | Wenn Sie **Hinzufügen** auswählen, wird die Installation gestartet. |
| **Hinzugefügt** | Sehen Sie, welche Skills aktiv sind. | Jede Zeile zeigt den Namen des Skills, die Beschreibung, den Typ und die verfügbaren Aktionen. |
| **Pausiert** | Finden Sie Skills, die derzeit deaktiviert sind. | Wenn Sie **Hinzufügen** auswählen, wird ein konfigurierbarer Skill reaktiviert. |
| **Entdecken** | Durchsuchen oder suchen Sie nach zusätzlichen Skills. | Ein Skill-Name kann seine Quelle in einem neuen Tab öffnen; **Hinzufügen** installiert den Skill in Ihrem Workspace. |
| Skill-Zeile | Lesen Sie die Skill-Details. | Ein benutzerdefinierter Skill wird im Bearbeitungsmodus geöffnet. Ein System-Skill wird im Ansichtsmodus geöffnet. |
| Schaltfläche **Hinzugefügt** | Pausieren Sie einen aktiven konfigurierbaren Skill. | Der Skill wird nach erfolgreicher Aktualisierung zu **Pausiert** verschoben. |
| Schaltfläche **Hinzufügen** | Installieren oder reaktivieren Sie einen Skill. | Die Schaltfläche zeigt den Fortschritt an, dann wird der Skill unter **Hinzugefügt** angezeigt. |
| Weitere Aktionen | Finden Sie Bearbeitungs-, Ansichts- oder Löschaktionen. | Verfügbare Aktionen hängen davon ab, ob der Skill System oder Benutzerdefiniert ist. |
## Fügen Sie einen entdeckten Skill hinzu
1. Wählen Sie in der Seitenleiste **Agent** und dann den Filter **Skills** aus. Scrollen Sie auf derselben Seite zu **Für Sie empfohlen**, **Hinzugefügt** oder **Entdecken**.
2. Suchen Sie nach der Aufgabe oder dem Format, das Sie benötigen.
3. Überprüfen Sie den Namen des Skills, die Quelle und die Beschreibung.
4. Wählen Sie **Hinzufügen** aus.
5. Warten Sie, bis der Fortschrittsstatus abgeschlossen ist.
6. Bestätigen Sie, dass der Skill unter **Hinzugefügt** angezeigt wird, bevor Sie ihn im Chat verwenden.
## Pausieren oder reaktivieren Sie einen Skill
1. Finden Sie den Skill unter **Hinzugefügt**.
2. Wählen Sie die Schaltfläche **Hinzugefügt** aus.
3. Bestätigen Sie, dass sie zu **Pausiert** verschoben wird.
4. Um sie zu reaktivieren, wählen Sie **Hinzufügen** im Abschnitt Pausiert aus.
Das Pausieren ist reversibel. Es deaktiviert den Skill, ohne seine Definition zu löschen.
## System- und benutzerdefinierte Skills
| Skill-Typ | Typische Aktionen | Wichtige Einschränkung |
| --- | --- | --- |
| **System** | Details anzeigen; nur pausieren, wenn der Skill dies zulässt | Feste System-Skills bieten möglicherweise keine Lösch- und Pausierungsoption. |
| **Benutzerdefiniert** | Bearbeiten, pausieren, reaktivieren oder löschen | Das Löschen erfordert eine Bestätigung und entfernt den Skill, anstatt ihn nur zu pausieren. |
## Zustände und Grenzen
- **Wird hinzugefügt…** bedeutet, dass die Installation noch läuft. Warten Sie auf **Hinzugefügt**.
- Suchergebnisse können aus dem öffentlichen Skill-Verzeichnis sowie aus Skills stammen, die sich bereits in Ihrem Workspace befinden.
- Ein Plangate blockiert die Aktivierung; es entfernt keine vorhandenen Skill-Definitionen.
- Importierter Inhalt kann Dateien auslassen, die akzeptierte Grenzen überschreiten. Überprüfen Sie vor dem Speichern alle Warnungen.
- **Keine skills.sh-Ergebnisse für diese Suche** bedeutet, dass kein kompatibles Erkennungsergebnis zurückgegeben wurde; dies wirkt sich nicht auf hinzugefügte Skills aus.
## Fehlerbehebung
- Wenn **Hinzufügen** nicht abgeschlossen wird, versuchen Sie es erneut, nachdem Sie den angezeigten Fehler überprüft haben. Vermeiden Sie wiederholtes Klicken, während die Schaltfläche beschäftigt ist.
- Wenn ein Skill nicht pausiert werden kann, handelt es sich wahrscheinlich um einen festen System-Skill. Öffnen Sie seine Details, um dies zu bestätigen.
- Wenn der erwartete Skill fehlt, löschen Sie die Suche und überprüfen Sie sowohl **Hinzugefügt** als auch **Pausiert**.
- Wenn ein neu hinzugefügter Skill in einem Projekt nicht verfügbar ist, überprüfen Sie **Einstellungen → Store → Agent** für die Skill-Auswahl dieses Projekts.
## Verwandte Leitfäden
- [Erstellen, importieren und verwalten Sie Skills](./create-import-manage-skills)
- [Übersicht über die Agent-Anpassung](/de/guides/agent)
- [Verwenden Sie die Agent-Befehlspalette](./command-palette)
- [Store-Agent-Einstellungen](../account-and-settings/custom-scripts-and-store-agent)
---
# Analytics und SEO
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo
Beginnen Sie in **Messen** → **Analysen** für aufgezeichnetes Shop-Verhalten oder **Wachstum** → **SEO** für die **SEO & GEO**-Übersicht. Wählen Sie unten einen Leitfaden für die Frage aus, die Sie beantworten müssen.
> **Verfügbarkeit:** **Analysen** hängt von Ihrem Plan und aufgezeichneten Store-Daten ab. **SEO** erfordert einen kostenpflichtigen Plan: **Plus** oder höher oder AppSumo License Tier 2, 3 oder 4. Es kann außerdem von einer veröffentlichten Storefront, Anbieter-Zugriff und ausreichend öffentlichen Daten zur Analyse abhängen.
| Ziel | Beginnen Sie hier |
| --- | --- |
| Verstehen Sie die gesamte Leistungsseite | [Analytics-Übersicht](/de/guides/analytics-and-seo/analytics-overview) |
| Ändern Sie das Berichtsfenster | [Metriken und Filter](/de/guides/analytics-and-seo/metrics-filters) |
| Finden Sie Trichter- oder Warenkorb-Reibung | [Verkehr und Konvertierung](/de/guides/analytics-and-seo/traffic-and-conversion) |
| Starten Sie eine Storefront-Sichtbarkeitsprüfung | [SEO-Übersicht](/de/guides/analytics-and-seo/seo-overview) |
| Lesen Sie Schätzungen der organischen Suche | [Suchleistung](/de/guides/analytics-and-seo/search-performance) |
| Überprüfen Sie Links und technische Probleme | [Backlinks und Site-Audit](/de/guides/analytics-and-seo/backlinks-and-site-audit) |
| Verstehen Sie die Sichtbarkeit in KI-Antworten | [KI-Sichtbarkeit](/de/guides/analytics-and-seo/ai-visibility) |
| Testen Sie Prompts und überprüfen Sie Quellen | [Prompts, Keywords und Zitierungen](/de/guides/analytics-and-seo/prompts-keywords-citations) |
| Stellen Sie leere oder blockierte Seiten wieder her | [Fehlerbehebung bei Daten und Veröffentlichung](/de/guides/analytics-and-seo/troubleshoot-data-and-publication) |
Diese Ansichten berichten oder analysieren verfügbare Daten. Das Öffnen eines Berichts ändert die Storefront nicht, und ein Einrichtungsbildschirm ist kein Beweis dafür, dass Verkehr, Rankings oder KI-Erwähnungen verbessert wurden.
---
# KI-Sichtbarkeit
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/ai-visibility
Die KI-Sichtbarkeit hilft Ihnen zu überprüfen, ob verfügbare KI-Suchdaten Ihre Marke, Konkurrenten oder öffentliche Quellen erwähnen.
> **Bedingt:** Die KI-Sichtbarkeit kann von Workspace-Zugriff, Plan, Anbieter-Verfügbarkeit, einer öffentlichen Storefront und ausreichenden Daten abhängen. Das Abschließen der Einrichtung erstellt keine Erwähnungen und verbessert die Sichtbarkeit nicht automatisch.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **SEO** → **KI-Sichtbarkeit** → **Öffnen**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein neuer Shop muss die SEO-Veröffentlichungsvoraussetzung erfüllen, bevor er Berichte verwenden kann. Die Vorschau der Beispieldaten dient der Veranschaulichung. Hier wird kein Analyseergebnis angezeigt.
## Bevor Sie beginnen
Wenn SEO die Checkliste für die Einrichtung des ersten Shops anzeigt, erfüllen Sie die Veröffentlichungsanforderungen, bevor Sie Berichtsdaten erwarten. Bei den mit **Vorschau · Beispieldaten** gekennzeichneten Werten handelt es sich um Beispiele und nicht um die Ergebnisse Ihres Shops. Die folgenden Schritte setzen voraus, dass der entsprechende Bericht verfügbar ist.
- Veröffentlichen Sie die Storefront und schließen Sie den Hauptschritt zur SEO-Berechtigung ab.
- Überprüfen Sie, dass Runner die öffentliche Storefront-Domain erkennt, die Sie verfolgen möchten. Die Einrichtung bietet kein separates bearbeitbares Markenfeld.
- Fügen Sie nur relevante Konkurrenten hinzu, damit Vergleiche des Sprachanteils nützlich bleiben.
- Verbinden Sie Google Search Console nur, wenn der optionale Eintrag verfügbar ist und Sie ihn autorisieren möchten.
## Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| Erkannte Storefront | Zeigt den öffentlichen Store, den die Einrichtung als Startziel verwendet. |
| Konkurrenzfelder in der Einrichtung | Fügt Vergleichsmarken zu den Einrichtungsoptionen hinzu. Das Eingeben eines Namens führt keine Suche durch. |
| Vorschau des Starter-Prompts | Zeigt Beispiel-Prompt-Ideen für die Einrichtung. Das Anzeigen einer Vorschau führt die Ergebnisse nicht aus oder speichert sie. |
| Google Search Console → **Verbinden** | Öffnet **Apps** für die optionale Google Search Console-Verbindung. |
| **Fortfahren** | Wechselt zum nächsten Einrichtungsschritt, wenn die aktuelle Eingabe gültig ist. |
| **Jetzt überspringen** | Schließt die Einrichtung, ohne Brand Lookup zu starten oder einen Snapshot zu erstellen. |
| **Markensuche ausführen** | Öffnet die dreistufige KI-Sichtbarkeitseinrichtung für die erkannte Storefront. |
| **Einrichtung abschließen** | Sendet die erkannte Storefront und Konkurrenzoptionen, schließt die Einrichtung und startet Brand Lookup. Die Ergebnisse bleiben ausstehend, bis die Suche abgeschlossen ist. |
| **Bitten Sie Runner, dies zu beheben** | Öffnet ein neues Runner-Gespräch mit den gespeicherten KI-Sichtbarkeitsnachweisen und der empfohlenen Verbesserung. Der Store wird nicht automatisch bearbeitet oder veröffentlicht. |
| **Zitierungslücken anzeigen** | Öffnet ein evidenzgestütztes Runner-Gespräch, das sich auf fehlende Zitierungsmöglichkeiten konzentriert. Überprüfen Sie die Vorschläge, bevor Sie Änderungen vornehmen. |
## Einrichtung abschließen
1. Öffnen Sie **Wachstum** → **SEO** und dann die Karte **KI-Sichtbarkeit**.
2. Wählen Sie **Markensuche ausführen**, um das Setup zu öffnen.
3. Bestätigen Sie, dass die erkannte öffentliche Storefront der Store ist, den Sie überprüfen möchten.
4. Fügen Sie eine kleine Anzahl relevanter Konkurrenten hinzu und wählen Sie dann **Fortfahren**.
5. Überprüfen Sie die Vorschau des Starter-Prompts, ohne sie als abgeschlossenen Test zu behandeln, und fahren Sie fort.
6. Verbinden Sie Search Console nur, wenn die Option nützlich ist und Sie berechtigt sind, das Konto zu verbinden.
7. Wählen Sie **Einrichtung abschließen**, um zu senden und Brand Lookup zu starten.
8. Warten Sie auf einen abgeschlossenen Status. Starten Sie keine doppelte Suche, während sie ausstehend ist.
9. Lesen Sie Erwähnungen, geschätztes KI-Suchvolumen, Sprachanteil, Abfragen und zitierte Quellen zusammen.
## Dashboard lesen
- **Erwähnungen** zählt verfügbare Antworten oder Datensätze, die die verfolgte Marke referenzieren.
- **Sprachanteil** vergleicht verfolgte Marken innerhalb des verfügbaren Datensatzes. Es ist nicht das gesamte Internet.
- **Abfragen** zeigen Fragen, die mit den gesammelten Ergebnissen verknüpft sind.
- **Zitierte Quellen** zeigen Seiten, auf die in verfügbaren Antworten verwiesen wird, und können Websites enthalten, die Sie nicht kontrollieren.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Ausstehend | Die Suche wurde akzeptiert, ist aber nicht abgeschlossen. Warten Sie, bevor Sie sie erneut starten. |
| Abgeschlossen ohne Erwähnungen | Das Ergebnis enthält keine Erwähnung der Marke. Überprüfen Sie die Abfragen und Quellen, anstatt anzunehmen, dass die Einrichtung fehlgeschlagen ist. |
| Fehlgeschlagen | Öffnen Sie den sichtbaren Fehler, bestätigen Sie das öffentliche Ziel und versuchen Sie es später erneut. |
| Anbieter nicht verfügbar oder Zugriff fehlt | Das angeforderte Modell oder die Datenquelle kann jetzt nicht verwendet werden. Verwenden Sie abgeschlossene Abschnitte und versuchen Sie es später erneut. |
| Nicht genug Daten | Der Anbieter konnte keine zuverlässige Ansicht für das Ziel erstellen. Halten Sie die Website öffentlich und besuchen Sie sie erneut, nachdem sie mehr auffindbare Inhalte hat. |
## Überprüfen Sie dies, bevor Sie mit der Suche beginnen
In der Einrichtung prüfen Sie die erkannte Storefront und Wettbewerber. **Einrichtung abschließen** startet die Suche und kann kostenpflichtige Kapazität verbrauchen. Verwenden Sie **Vorerst überspringen**, um das Formular ohne Ausführung anzusehen. Prüfen Sie nach einer abgeschlossenen Suche Ziel und zurückgegebene Belege, bevor Sie das Dashboard interpretieren.
## Verwandte Leitfäden
- [Prompts, Keywords und Zitierungen](./prompts-keywords-citations)
- [SEO-Übersicht](./seo-overview)
- [Suchleistung](./search-performance)
---
# Analytics-Übersicht
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/analytics-overview
Analytics hilft Ihnen, aufgezeichnete Besuche, Einkaufsaktivitäten und Verkäufe für das ausgewählte Geschäft zu verknüpfen.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Messen** → **Analysen**.
## Bevor Sie beginnen
- Ihr Plan muss die Berichtsoberfläche enthalten. Eine Planvorschau zeigt Ihre gemessenen Shop-Ergebnisse nicht an.
- Für aussagekräftige Berichte über Besuche und Verkäufe brauchen Sie einen veröffentlichten Store und erfasste Käuferaktivität.
- Wählen Sie beim Vergleichen von Berichten denselben Shop, denselben Zeitraum und dieselben Filter aus.
## Das angezeigte Layout auswählen
Wenn über einer einzelnen scrollbaren Seite **Nettoumsatz**, **GMV**, **Sitzungen** und **Conversion-Rate** stehen, folgen Sie unten der [Anleitung für das frühere Dashboard](#if-you-see-the-earlier-dashboard). Bei gruppierter Berichtsnavigation verwenden Sie die folgende Workbench-Anleitung. Wenn über dem Diagramm **Bericht dieser Woche** und **Weitere Berichte** stehen, folgen Sie der [Anleitung für dieses Layout](#if-you-see-the-sections-layout). Die Layouts bieten unterschiedliche Steuerelemente.
## Wählen Sie einen Bericht
**Bedingt:** Wenn auf Ihrem Bildschirm **Onlineshop-Analysen** angezeigt werden, verwenden Sie die gruppierte Workbench unten. In einigen Arbeitsbereichen wird immer noch das frühere einseitige Dashboard angezeigt, das später beschrieben wird.
| Steuerelement | Geöffnetes Ziel |
| --- | --- |
| **Übersicht** | Eine Zusammenfassung der Aktivitäten des ausgewählten Shops. Verwenden Sie einen verfügbaren Link **Details anzeigen**, um den zugrunde liegenden Bericht zu überprüfen. |
| **Handel** | Handels-, Funnel-, Produkt-, Akquise- und Zielberichte. |
| **Verhalten** | Berichte zu Seiten, Ereignissen, Kundenpfaden und weiteren unterstützten Besuchsaktivitäten. |
| **Zielgruppe** | Besucher-, Benutzer-, Segment- und Merkmalsberichte. |
| **Live-Seite** | Die verfügbare Live-Aktivitätsansicht. |
| **Konfigurieren** | Tracking- und andere Analyse-Konfigurationstools. Durch das Öffnen werden keine Ereignisse erstellt. |
| Datumsauswahl | Aktualisiert den ausgewählten Bericht für den ausgewählten Zeitraum. |
| **Vergleichen**, wenn angezeigt | Fügt den unterstützten Vergleichszeitraum hinzu. |
## Überprüfen Sie Ihren ersten Bericht
1. Öffnen Sie **Übersicht** und bestätigen Sie den ausgewählten Store.
2. Wählen Sie einen Zeitraum aus, der bekannte Geschäftsaktivitäten enthält, z. B. **7d** oder **30d**.
3. Lesen Sie die sichtbare Zusammenfassung und öffnen Sie **Commerce** für Umsatz- und Funnel-Daten.
4. Öffnen Sie den passenden Unterbericht zu Ihrer Frage. Vergleichen Sie etwa die Funnel-Stufen, bevor Sie ein vermutetes Checkout-Problem untersuchen.
5. Öffnen Sie **Verhalten**, um eine betroffene Seite oder Journey zu überprüfen, wenn diese Berichte Daten enthalten.
6. Kehren Sie zu **Übersicht** zurück, um die Details mit der Zusammenfassung zu vergleichen.
**Prüfpunkt:** Sie können Bericht, aktiven Zeitraum und Ereignisse hinter einem Ergebnis benennen. Ein leerer Bericht beweist weder eine funktionierende Datenerfassung noch einen defekten Store.
## Wenn Sie Weitere Berichte sehen [#if-you-see-the-sections-layout]
Die Übersicht zeigt **Besucher**, **Umsatz**, **Bestellungen**, **Besucher mit Kauf**, **Umsatz pro Besucher** und **Jetzt online**, darunter das Verlaufsdiagramm und Listen zu Kanälen, Produkten und Orten. Zeitraum, **Täglich** / **Wöchentlich** und **Filter** stehen darüber.
Wählen Sie **Weitere Berichte**, um **Alle Berichte** zu öffnen. Dort sind alle Berichte gruppiert:
| Gruppe | Berichte |
| --- | --- |
| **Verkäufe** | **Umsatz**, **Produkte**, **Trichter**, **Kanäle** und **Ziele**. |
| **Kunden** | **Besucher**, **Personen**, **Segmente**, **Live** und **Karte**, sofern verfügbar. |
| **Shop-Zustand** | **Seiten**, **Ereignisse**, **Tempo & Fehler**, **Sitzungen**, **Aufzeichnungen** und **Tracking-Zustand**. |
| **Einrichtung** | **Tracking**, **Feature-Flags**, **Eigene Dashboards**, **API**, **Nutzung** und **Einstellungen**. Das Öffnen erzeugt keine Ereignisse. |
Durchsuchen Sie die Liste nach Berichtsnamen, etwa **Trichter** oder **Karte**. In einem Bericht wechseln Tabs zu den anderen Berichten seiner Gruppe; der Zurück-Pfeil führt zur Übersicht.
1. Prüfen Sie den Zeitraum über dem Diagramm.
2. Lesen Sie die Zahlen oben zusammen. Eine Kaufrate sagt wenig ohne die Besucherzahl daneben.
3. Wählen Sie **Bericht dieser Woche** für die letzte volle Woche: Umsatz nach Gerät, Besuche und Tage bis zum Kauf, die Kaufzeiten und die Top-Länder.
4. Wählen Sie **Weitere Berichte** und öffnen Sie den Bericht für Ihre Frage, etwa **Kanäle** für die Herkunft der Käufer.
Ein neuer Shop zeigt **Neuer Shop** und eine Besucherzahl, bis genug Personen für Diagramme da waren. Das Abzeichen **Beispieldaten · nicht Ihr Shop** bedeutet, dass die Zahlen ein Beispiel sind, nicht Ihre Ergebnisse. Ein Bereich mit **Bald verfügbar** hat noch keine Datenquelle; das ist kein Problem Ihres Shops.
## Wenn Sie das frühere Dashboard sehen [#if-you-see-the-earlier-dashboard]
Verwenden Sie die Zeitraumwahl und lesen Sie **Nettoumsatz**, **GMV**, **Sitzungen** und **Conversion-Rate** gemeinsam. Scrollen Sie zu Produkten, Quellen, Funnel, Abbrüchen und Erstattungen.
## Fehlerbehebung
| Zustand | Nächster Schritt |
| --- | --- |
| Strich, Null oder leeres Diagramm | Löschen Sie optionale Filter, versuchen Sie es mit einem längeren Zeitraum und bestätigen Sie, dass tatsächliche Besuche oder Bestellungen vorliegen. |
| Upgrade-Hinweis oder Tarifvorschau | Prüfen Sie den Zugriff unter Tarif und Abrechnung, bevor Sie die Datenerfassung untersuchen. |
| Bericht wird geladen | Warten Sie, bis die Anfrage abgeschlossen ist, bevor Sie die Filter erneut ändern. |
| Ein Bericht enthält Daten und ein anderer nicht | Überprüfen Sie das Ereignis, das jeder Bericht benötigt. Vor Bestellungen können Besuche erfolgen. |
| Bericht kann nicht geladen werden | Laden Sie den Bericht einmal neu und behalten Sie den Berichtsnamen, den Zeitraum und den Fehler bei, falls er erneut fehlschlägt. |
| **Dieser Bereich wurde nicht geladen.** | Wählen Sie **Erneut versuchen**, wenn es angezeigt wird, oder laden Sie die Seite neu. Die anderen Bereiche zeigen Ihre Daten weiter. |
| Navigationseintrag fehlt | Erweitern Sie **Messen** und bestätigen Sie den ausgewählten Arbeitsbereich. Siehe [Funktionsverfügbarkeit](../advanced/feature-availability). |
## Verwandte Leitfäden
- [Metriken und Filter](./metrics-filters)
- [Verkehr und Konvertierung](./traffic-and-conversion)
- [Fehlerbehebung bei Daten und Veröffentlichung](./troubleshoot-data-and-publication)
---
# Backlinks und Site-Audit
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/backlinks-and-site-audit
Backlinks und Site-Audit helfen Ihnen, Off-Site-Referenzen und On-Site-technische Probleme aus demselben SEO-Workspace zu überprüfen.
> **Bedingt:** Beide Abschnitte erfordern ein berechtigtes analysiertes Ziel. Link- und Crawl-Daten können unvollständig sein, und optionale Lighthouse-Ergebnisse hängen von einer erfolgreichen Seitenprüfung ab.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **SEO** → **Backlinks** oder **Site-Health**-Karte → **Öffnen**. Der technische Bericht kann in der geöffneten Ansicht **Site-Audit** verwenden.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein neuer Shop muss die SEO-Veröffentlichungsvoraussetzung erfüllen, bevor er Berichte verwenden kann. Die Vorschau der Beispieldaten dient der Veranschaulichung. Hier wird kein Analyseergebnis angezeigt.
## Bevor Sie beginnen
Wenn SEO die Checkliste für die Einrichtung des ersten Shops anzeigt, erfüllen Sie die Veröffentlichungsanforderungen, bevor Sie Berichtsdaten erwarten. Bei den mit **Vorschau · Beispieldaten** gekennzeichneten Werten handelt es sich um Beispiele und nicht um die Ergebnisse Ihres Shops. Die folgenden Schritte setzen voraus, dass der entsprechende Bericht verfügbar ist.
- Veröffentlichen Sie und öffnen Sie die Ziel-Storefront erfolgreich.
- Schließen Sie die anfängliche SEO-Analyse ab.
- Entscheiden Sie, ob Sie Link-Kontext, einen technischen Crawl oder beides benötigen.
- Entfernen oder leiten Sie Seiten nicht nur aufgrund einer automatisierten Problembezeichnung um. Überprüfen Sie zuerst die betroffene Seite.
## Backlink-Steuerelemente und Ergebnisse
| Steuerelement oder Bereich | Was es zeigt oder tut |
| --- | --- |
| **Backlinks** | Öffnet Gesamtlinks, verweisende Domains, Top-Domains und Top-verlinkte Seiten. |
| Follow / Nofollow-Ansicht | Trennt Link-Typen, wenn der Anbieter diese Informationen enthält. |
| Neue / Verlorene Historie | Zeigt Link-Änderungen, die vom Anbieter aufgezeichnet wurden. |
| Unterbrochene Backlinks | Listet Links auf, die zu einem nicht verfügbaren Ziel führen. |
| Spam-Score | Bietet ein Anbieter-Signal zur Überprüfung. Es ist kein Beweis dafür, dass eine Domain schädlich ist. |
| **Bitten Sie Runner, diese zu überprüfen** | Öffnet ein neues Runner-Gespräch mit den gespeicherten Backlink-Nachweisen und einer Audit-Anfrage. Es entfernt keine Links und ändert den Store nicht. |
## Site-Audit-Steuerelemente und Ergebnisse
| Steuerelement oder Bereich | Was es zeigt oder tut |
| --- | --- |
| **Neues Audit starten** | Öffnet die Crawl-Einrichtung. Der Storefront wird nicht geändert. |
| Maximale Seiten-Steuerung | Begrenzt, wie viel der öffentlichen Website das Audit zu crawlen versucht. |
| **Lighthouse einschließen** | Fügt unterstützte Leistungs-, Zugangs-, Best-Practice- und SEO-Prüfungen hinzu. |
| **Audit ausführen** | Startet den konfigurierten Crawl. |
| **Probleme** | Listet gruppierte Erkenntnisse auf, damit Sie die Erklärung, Empfehlung und betroffene Seiten öffnen können. |
| **Seiten** | Zeigt jede gecrawlte URL mit Status, Titel, H1, Wortanzahl, Bildanzahl und Antwortzeit. |
| **Alle mit Runner beheben** | Öffnet ein neues Runner-Gespräch mit den gespeicherten Audit-Nachweisen und einer breiten Reparaturanfrage. Der Store wird nicht automatisch bearbeitet oder veröffentlicht. |
| Problemzeile | Öffnet, warum das Problem wichtig ist, die Empfehlung und betroffene Seiten. |
| **Mit Runner beheben** | Öffnet ein neues Runner-Gespräch mit dem ausgewählten Problem, betroffenen URLs und einer Reparaturanfrage. Der Store wird nicht automatisch bearbeitet oder veröffentlicht. |
## Führen Sie ein fokussiertes Audit durch
1. Öffnen Sie **Site-Audit**.
2. Wählen Sie **Neues Audit starten**.
3. Wählen Sie ein Seitenlimit, das für den öffentlichen Store geeignet ist.
4. Aktivieren Sie Lighthouse nur, wenn Sie die zusätzlichen Seitenqualitätsprüfungen benötigen.
5. Wählen Sie **Audit ausführen** und warten Sie auf den Abschluss.
6. Verwenden Sie **Probleme**, um mit hochgradig auswirkenden Erkenntnissen zu beginnen, und verwenden Sie dann **Seiten**, um die betroffenen URLs und Seitendaten zu überprüfen.
7. Öffnen Sie ein Problem und überprüfen Sie seine betroffenen Seiten manuell.
8. Verwenden Sie **Mit Runner beheben** für eine geeignete Erkenntnis oder **Alle mit Runner beheben** für eine breite Überprüfungsanfrage. Beide öffnen ein Runner-Gespräch und erfordern, dass Sie alle vorgeschlagenen Arbeiten überprüfen, bevor Sie Änderungen akzeptieren oder veröffentlichen.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Keine Backlinks | Der Anbieter hat keine Link-Daten für das Ziel gefunden. Dies ist kein Beweis dafür, dass keine Links vorhanden sind. |
| Verlorener Link | Der Anbieter sieht einen vorherigen Link nicht mehr. Öffnen Sie die Quelle und das Ziel, bevor Sie handeln. |
| Crawl fehlgeschlagen | Bestätigen Sie, dass die öffentliche URL erreichbar ist und nicht blockiert wird, und führen Sie dann ein kleineres Audit durch. |
| Lighthouse nicht verfügbar | Verwenden Sie die Crawl-Ergebnisse, die abgeschlossen wurden, und versuchen Sie die optionale Prüfung später erneut. |
| Problemanzahl ist Null | Dieses Audit hat keine übereinstimmenden Probleme zurückgegeben. Fahren Sie mit der normalen Storefront-Überprüfung fort. |
## Vor einem weiteren Crawl vorhandene Ergebnisse prüfen
1. Öffnen Sie **Backlinks**, um die verfügbaren Links und verweisenden Domains zu überprüfen.
2. Kehren Sie zur SEO-Übersicht zurück und öffnen Sie **Site Health**.
3. Wenn eine Prüfung vorliegt, wählen Sie ein Problem aus und lesen Sie dessen Empfehlung und betroffene URLs.
4. Öffnen Sie eine betroffene öffentliche Seite und bestätigen Sie, dass das Problem vorliegt.
5. Falls eine Korrekturwarteschlange erscheint, prüfen Sie die gewählte Korrektur, bevor Sie sie Runner übergeben.
**Prüfpunkt:** Sie haben eine betroffene URL, Belege und einen Korrekturvorschlag. Das Auswählen eines Ergebnisses oder das Öffnen einer Runner-Konversation bedeutet nicht, dass die Korrektur angewendet oder veröffentlicht wurde.
## Verwandte Leitfäden
- [SEO-Übersicht](./seo-overview)
- [Suchleistung](./search-performance)
- [Fehlerbehebung bei Daten und Veröffentlichung](./troubleshoot-data-and-publication)
---
# Metriken und Filter
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/metrics-filters
Verwenden Sie denselben Zeitraum und dieselben Filter, um einen aussagekräftigen Vergleich zwischen Traffic, Bestellungen und Verkäufen durchzuführen.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Messen** → **Analysen** → Berichtssteuerelemente.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEkGsXzhdR6T0uwqnz73letZimQpFvYfSrhLM)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wählen Sie im einseitigen Analytics-Datumsmenü „Letzte 24 Stunden“, „Letzte 7 Tage“ oder „Letzte 30 Tage“ aus.
## Bevor Sie beginnen
- Entscheiden Sie, welche Frage der Zeitraum beantworten soll: aktuelle Aktivität, eine vergangene Woche oder einen längerfristigen Trend.
- Der noch laufende heutige Tag ist nicht direkt mit einem vollständigen vergangenen Tag vergleichbar.
- Die Filtersteuerelemente variieren je nach Bericht und dem für Ihren Arbeitsbereich verfügbaren Analytics-Layout.
## Steuerelemente und Klickergebnisse
Überprüfen Sie zunächst Ihr sichtbares Layout. Das einseitige Dashboard bietet **Letzte 24 Stunden**, **Letzte 7 Tage** und **Letzte 30 Tage**. Wenn Ihr Arbeitsbereich stattdessen die **Storefront Analytics**-Workbench anzeigt, verwenden Sie die folgenden Steuerelemente:
| Steuerelement | Ergebnis |
| --- | --- |
| **Heute** / **Gestern** | Wählt den aktuellen oder vorherigen Tag aus. |
| **7d** / **30d** | Wählt einen aktuellen Wochen- oder Monatszeitraum. |
| Eigener Zeitraum | Ermöglicht die Auswahl von Start- und Enddatum des Berichts. |
| **Vergleichen**, wenn angezeigt | Fügt einen Vergleichszeitraum hinzu oder entfernt ihn. |
| **Segment**, wenn angezeigt | Schränkt den Bericht auf die ausgewählte Zielgruppe ein. |
| Weitere Filter | Grenzt passende Ereignisse oder Datensätze ein. Verwenden Sie nur die für Ihre Frage nötigen Bedingungen und beachten Sie die angezeigte Höchstzahl. |
Im früheren Dashboard bietet die Auswahl stattdessen **Letzte 24 Stunden**, **Letzte 7 Tage** und **Letzte 30 Tage**.
### Steuerelemente neben Weitere Berichte
Wenn Ihre Analytik-Seite über dem Diagramm **Bericht dieser Woche** und **Weitere Berichte** zeigt, verwenden Sie diese Steuerelemente:
| Steuerelement | Ergebnis |
| --- | --- |
| Zeitraum | Wählen Sie **Heute**, **Gestern**, **Letzte 7 Tage**, **Letzte 30 Tage**, **Letzte 90 Tage**, **Dieser Monat** oder **Benutzerdefiniert…**. Die Pfeile springen zum vorherigen oder nächsten Zeitraum. |
| Vergleichsoption im Zeitraum | Zeigt jede Zahl neben dem gleich langen Zeitraum direkt davor. Bei 30 Tagen heißt die Option **Mit den 30 Tagen davor vergleichen**. |
| **Filter** | Grenzt Berichte nach **Quelle**, **Land**, **Gerät** oder **Angesehenes Produkt** ein. Die Schaltfläche unten zeigt, wie viele Besucher passen, etwa **136 Besucher anzeigen**; wählen Sie sie, um den Filter anzuwenden. |
| Filter-Chips | Jeder aktive Filter erscheint über dem Bericht, neben einer Zahl wie **40 von 136 Besuchern**. Entfernen Sie ihn am Chip oder wählen Sie **Alle löschen**. |
| **Täglich** / **Wöchentlich** | Ändert, wie das Verlaufsdiagramm die Tage gruppiert. |
**Angesehenes Produkt** behält Besucher, die dieses Produkt angesehen haben; jeder Bericht beschreibt dann diese Kunden. Einige Berichte wie **Produkte** und **Live** ignorieren Zeitraum oder Filter; dort sind diese Steuerelemente ausgeblendet.
## Vergleichen Sie einen Zeitraum
1. Öffnen Sie den Bericht und wählen Sie im einseitigen Dashboard **Letzte 7 Tage** oder **Letzte 30 Tage**. Wählen Sie in der Workbench **7d**, **30d** oder einen eigenen Zeitraum.
2. Warten Sie, bis der Bericht aktualisiert ist, und bestätigen Sie, dass die Datumsbezeichnung mit Ihrer Auswahl übereinstimmt.
3. Aktivieren Sie **Vergleichen**, falls verfügbar, und prüfen Sie, welcher Zeitraum verwendet wird.
4. Wenden Sie ein Segment oder einen Filter nur an, wenn die Frage diese Zielgruppe oder dieses Ereignis betrifft.
5. Stellen Sie sicher, dass die ausgewählte Bedingung sichtbar bleibt, bevor Sie die Zahlen interpretieren.
6. Entfernen Sie die Bedingung und deaktivieren Sie den Vergleich, um zur breiteren Ansicht zurückzukehren.
**Prüfpunkt:** Sie können die Datumsgrenzen und Bedingungen hinter den angezeigten Zahlen benennen. Das Entfernen der Filter stellt die umfassendere Abfrage wieder her, auch wenn beide Abfragen leer bleiben.
## Kennzahlen zusammen mit ihren Fallzahlen lesen
- Überprüfen Sie aufgezeichnete Sitzungen und Käufe, bevor Sie Conversion-Prozentsätze interpretieren.
- Lesen Sie GMV und Nettoumsatz getrennt: Sie beschreiben unterschiedliche Verkaufskennzahlen.
- Eine starke prozentuale Änderung bei einer kleinen Stichprobe benötigt weitere Belege.
- Gleichen Sie Zeitraumlänge, Filter und Kennzahlendefinitionen ab, bevor Sie mit einem anderen Dienst vergleichen.
## Fehlerbehebung
| Zustand | Nächster Schritt |
| --- | --- |
| Auch der neue Zeitraum ist leer | Entfernen Sie Filter und prüfen Sie, ob im Store in diesem Zeitraum passende Aktivitäten stattfanden. |
| Ein Filter ist nicht verfügbar | Verwenden Sie die von diesem Bericht unterstützten Steuerelemente. Gehen Sie nicht davon aus, dass jede Ansicht dieselben Felder hat. |
| Filtergrenze erreicht | Entfernen Sie eine unnötige Bedingung, bevor Sie eine weitere hinzufügen. |
| Werte ändern sich unerwartet | Prüfen Sie eigenen Zeitraum, aktives Segment, Vergleichszeitraum sowie ungewöhnliche Bestellungen oder Erstattungen. |
| Bericht aktualisiert sich nicht | Laden Sie einmal neu und notieren Sie Zeitraum und sichtbaren Fehler für den Support. |
## Verwandte Leitfäden
- [Analytics-Übersicht](./analytics-overview)
- [Verkehr und Konvertierung](./traffic-and-conversion)
- [Fehlerbehebung bei Daten und Veröffentlichung](./troubleshoot-data-and-publication)
---
# Prompts, Keywords und Zitierungen
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/prompts-keywords-citations
Die KI-Sichtbarkeits-Detailbereiche helfen Ihnen zu erfahren, welche Fragen Ihre Marke an die Oberfläche bringen und welche Quellen die verfügbaren Antworten unterstützen.
> **Bedingt:** Prompt Explorer und seine Modelle können Plan- oder Anbieter-gated sein. Das Ausführen eines Prompts fordert neue Modell-Ausgabe an und kann bezahlte Kapazität verwenden. Überprüfen Sie die aktuelle Workspace-Benachrichtigung, bevor Sie es ausführen.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **SEO** → **KI-Sichtbarkeit** → **Öffnen** → **Eingabeaufforderungen**, **Schlüsselwörter** oder **Zitate**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein neuer Shop muss die SEO-Veröffentlichungsvoraussetzung erfüllen, bevor er Berichte verwenden kann. Die Vorschau der Beispieldaten dient der Veranschaulichung. Hier wird kein Analyseergebnis angezeigt.
## Bevor Sie beginnen
Wenn SEO die Checkliste für die Einrichtung des ersten Shops anzeigt, erfüllen Sie die Veröffentlichungsanforderungen, bevor Sie Berichtsdaten erwarten. Bei den mit **Vorschau · Beispieldaten** gekennzeichneten Werten handelt es sich um Beispiele und nicht um die Ergebnisse Ihres Shops. Die folgenden Schritte setzen voraus, dass der entsprechende Bericht verfügbar ist.
- Schließen Sie die KI-Sichtbarkeits-Einrichtung ab.
- Schreiben Sie eine fokussierte Käuferfrage.
- Wählen Sie mindestens ein verfügbares Modell.
- Verwenden Sie die Websuche nur, wenn das Modell aktuelle öffentliche Quellen konsultieren soll.
## Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| Prompt-Feld | Akzeptiert die zu testende Frage und warnt, wenn die Eingabe zu lang ist. |
| Modell-Selector | Wählt, welche verfügbaren Modell-Antworten angefordert werden sollen. |
| **Websuche zulassen** | Lässt unterstützte Modelle öffentliche Web-Quellen für diesen Lauf konsultieren. |
| Marken-Hervorhebung | Teilt der Ergebnis-Ansicht mit, welche Markenerwähnung hervorgehoben werden soll. Es zwingt das Modell nicht, die Marke zu erwähnen. |
| **Prompt Explorer ausführen** | Startet die ausgewählten Modell-Anfragen. Der Store wird nicht bearbeitet oder eine Sichtbarkeitsverbesserung gespeichert. |
| **Prompts** | Zeigt verfolgte oder erkundete Fragen und ihre verfügbaren Ergebnisse. |
| **Keywords** | Zeigt Begriffe, die mit dem KI-Sichtbarkeitsdatensatz verknüpft sind. |
| **Zitierungen** | Zeigt Quellen, die in verfügbaren Modell-Antworten zitiert werden. |
| **Erwähnungen** | Zeigt Antworten oder Datensätze, in denen die verfolgte Marke erkannt wurde. |
## Erkunden Sie eine Käuferfrage
1. Öffnen Sie **Prompts**.
2. Geben Sie eine natürlichsprachige Frage ein, die ein Käufer stellen könnte.
3. Wählen Sie das verfügbare Modell oder die Modelle, die Sie benötigen.
4. Entscheiden Sie, ob Sie **Websuche zulassen** aktivieren möchten.
5. Wählen Sie optional die verfolgte Marke zur Hervorhebung.
6. Wählen Sie **Prompt Explorer ausführen** einmal.
7. Warten Sie, bis jedes angeforderte Modell fertig ist oder fehlschlägt.
8. Vergleichen Sie die Antwort, den Zustand **Marke erwähnt** oder **Marke nicht erwähnt**, Zitierungen und verwandte Abfragen.
9. Öffnen Sie **Keywords** und **Zitierungen**, um wiederkehrende Themen und Quellen zu finden.
## Ergebnisse sicher interpretieren
- Eine Antwort ist ein Beispiel, keine stabile Rangliste.
- "Marke nicht erwähnt" beschreibt diese Antwort, nicht jede mögliche Antwort.
- Eine Zitierung bedeutet, dass das Modell auf eine Quelle verwiesen hat. Es bedeutet nicht, dass Runner die Quelle unterstützt.
- Ergebnisse ohne Websuche und mit Websuche beantworten unterschiedliche Fragen und sollten nicht als identische Tests behandelt werden.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Schaltfläche "Ausführen" deaktiviert | Geben Sie einen gültigen Prompt ein und wählen Sie mindestens ein Modell. |
| Ein Modell schlägt fehl | Verwenden Sie die abgeschlossenen Modell-Ergebnisse und versuchen Sie den fehlgeschlagenen Anbieter später erneut. |
| Keine Zitierungen | Die Antwort hat möglicherweise keine öffentlichen Quellen verwendet oder zurückgegeben. Versuchen Sie es erneut nur mit Websuche, wenn das Ihrem Ziel entspricht. |
| Nicht verwandte Ergebnisse | Machen Sie den Prompt spezifischer zum Produkt, zur Zielgruppe oder zum Kaufbedarf. |
| Anbieter-Zugriffsfehler | Wählen Sie ein verfügbares Modell oder fragen Sie einen Workspace-Besitzer nach Zugriff. |
## Zuerst gespeicherte Belege prüfen
1. Öffnen Sie **KI-Sichtbarkeit** in der [SEO-Übersicht](/de/guides/analytics-and-seo/seo-overview) und wählen Sie **Zitate**.
2. Überprüfen Sie eine verfügbare Quelle und die zugehörige Antwort. Folgen Sie dem Quelllink, wenn einer bereitgestellt wird.
3. Kehren Sie zu Runner zurück und vergleichen Sie die Quelle mit der zugehörigen Eingabeaufforderung oder dem zugehörigen Schlüsselwort.
4. Starten Sie nur dann eine neue Ausführung des **Prompt Explorer**, wenn die gespeicherte Suche Ihre Frage nicht beantwortet.
**Prüfpunkt:** Sie können Antwort und zitierte Seite hinter einem Ergebnis zuordnen. Eine gespeicherte Markensuche und ein neuer Prompt-Explorer-Lauf sind getrennte Stichproben. Das Öffnen gespeicherter Belege führt keinen weiteren Prompt aus.
## Verwandte Leitfäden
- [KI-Sichtbarkeit](./ai-visibility)
- [Suchleistung](./search-performance)
- [Fehlerbehebung bei Daten und Veröffentlichung](./troubleshoot-data-and-publication)
---
# Suchleistung
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/search-performance
Die Suchleistung hilft Ihnen, zu identifizieren, welche Abfragen und Seiten in den für Runner verfügbaren Daten am wichtigsten erscheinen.
> **Bedingt:** Diese Schätzungen werden nur angezeigt, nachdem eine berechtigte SEO-Analyse Anbieter-Daten zurückgibt. Eine neue oder wenig besuchte Domain hat möglicherweise wenig oder keine Daten.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **SEO** → Karte **Suchleistung** → **Öffnen**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein neuer Shop muss die SEO-Veröffentlichungsvoraussetzung erfüllen, bevor er Berichte verwenden kann. Die Vorschau der Beispieldaten dient der Veranschaulichung. Hier wird kein Analyseergebnis angezeigt.
## Bevor Sie beginnen
Wenn SEO die Checkliste für die Einrichtung des ersten Shops anzeigt, erfüllen Sie die Veröffentlichungsanforderungen, bevor Sie Berichtsdaten erwarten. Bei den mit **Vorschau · Beispieldaten** gekennzeichneten Werten handelt es sich um Beispiele und nicht um die Ergebnisse Ihres Shops. Die folgenden Schritte setzen voraus, dass der entsprechende Bericht verfügbar ist.
- Schließen Sie eine erfolgreiche SEO-Analyse für das öffentliche Ziel ab.
- Verwenden Sie die von Runner angezeigte analysierte Domain, besonders wenn das Projekt mehr als eine Domain hat.
- Lesen Sie Anbieter-Schätzungen als Richtungssignale. Sie stimmen möglicherweise nicht genau mit First-Party-Analytics überein.
## Hauptbereiche
| Bereich | Was es bedeutet |
| --- | --- |
| Geschätzter organischer Verkehr | Eine Anbieter-Schätzung von Besuchen aus unbezahlter Suche. |
| Organische Keywords | Suchbegriffe, für die die Domain verfügbare Sichtbarkeitsdaten hat. |
| Domain-Rang | Ein vergleichendes Autoritäts- oder Sichtbarkeitsmass vom verfügbaren Anbieter. |
| Top-3-Keywords | Keywords, die geschätzt werden, um in der Nähe der Spitze der Suchergebnisse zu ranken. |
| **Top Keywords** | Abfragen mit ihren verfügbaren Positions- oder Verkehrsinformationen. |
| **Top-Seiten** | Öffentliche Seiten mit der stärksten geschätzten organischen Sichtbarkeit. |
| **Bitten Sie Runner** | Erstellt ein neues Runner-Gespräch mit den gespeicherten Berichtsnachweisen und einer vorgeschlagenen Verbesserungsanfrage. Der Store wird nicht automatisch bearbeitet oder veröffentlicht. |
| **Siehe 5 schnelle Gewinne** | Erstellt denselben evidenzgestützten Runner-Handoff, damit Sie im Chat nach priorisierten Möglichkeiten fragen können. Überprüfen Sie alle vorgeschlagenen Arbeiten, bevor Sie sie anwenden oder veröffentlichen. |
| **Erneut analysieren** | Fordert einen neuen Snapshot an. Der Inhalt oder das Ranking wird nicht geändert. |
## Überprüfen Sie Suchgelegenheiten
1. Öffnen Sie **Suchleistung**, nachdem die Analyse abgeschlossen ist.
2. Bestätigen Sie, dass die analysierte Domain die öffentliche Storefront ist, die Sie beabsichtigt haben.
3. Lesen Sie die Zusammenfassungsmetriken als Baseline, nicht als Versprechen.
4. Scannen Sie **Top Keywords** auf Begriffe, die zu den Produkten und der Zielgruppe passen.
5. Öffnen Sie oder notieren Sie die entsprechenden **Top-Seiten**.
6. Vergleichen Sie den Seiteninhalt mit der Käuferfrage hinter jedem nützlichen Keyword.
7. Nehmen Sie Storefront-Änderungen über Runner oder den Store-Editor vor und veröffentlichen Sie sie separat.
8. Kehren Sie später zurück und wählen Sie **Erneut analysieren**, wenn genug Zeit vergangen ist, damit sich öffentliche Quellen ändern.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Keine organischen Daten | Der Anbieter hat möglicherweise nicht genug Informationen für die Domain. Bestätigen Sie die Veröffentlichung und versuchen Sie es später erneut. |
| Keyword aber keine übereinstimmende Seite | Öffnen Sie die Seitenliste und die öffentliche Website. Der Anbieter kann die Abfrage einer anderen URL zuordnen. |
| Schätzung unterscheidet sich von Analytics | Analytics zeichnet Store-Ereignisse auf. SEO verwendet externe Suchschätzungen. Richten Sie die Frage aus, bevor Sie sie vergleichen. |
| Neu veröffentlichter Inhalt fehlt | Die Suchentdeckung ist nicht sofort. Bestätigen Sie, dass die Seite öffentlich ist, und warten Sie, bevor Sie aktualisieren. |
## Wählen Sie eine überprüfbare Verbesserung aus
Verknüpfen Sie im geöffneten Bericht über **Keywords** und **Seiten** eine relevante Suchanfrage mit einer öffentlichen Seite. Falls **Korrekturwarteschlange öffnen** erscheint, prüfen Sie Korrekturvorschlag und betroffene Seite, bevor Sie die Arbeit mit Runner starten.
**Prüfpunkt:** Sie können Suchanfrage, Seite und zu prüfende Änderung benennen. Externe Suchzahlen sind Schätzungen. Eine optionale Google-Search-Console-Verbindung kann eigene Klickdaten liefern, falls verfügbar. Sie wird nicht automatisch verbunden; ihre Daten sind von Schätzungen zu unterscheiden.
## Verwandte Leitfäden
- [SEO-Übersicht](./seo-overview)
- [Backlinks und Site-Audit](./backlinks-and-site-audit)
- [Verkehr und Konvertierung](./traffic-and-conversion)
---
# SEO-Übersicht
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/seo-overview
SEO hilft Ihnen zu überprüfen, wie ein öffentliches Geschäft in Suchergebnissen und KI-generierten Antworten entdeckt werden kann.
## Eingabepfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **SEO**. Die **SEO & GEO**-Übersicht verlinkt auf einzelne Berichte.
## Wenn dies Ihr erster SEO-Besuch ist
Die Einführung erklärt den Arbeitsbereich. **Tour überspringen** öffnet die Übersicht. Bei einem neuen Store zeigt **Machen wir deinen Store auffindbar** drei Einrichtungsschritte: Storefront veröffentlichen, automatische KI-Prüfungen und automatische Keyword-Erfassung. Beginnen Sie mit der Veröffentlichung.
Metriken mit der Bezeichnung **Vorschau · Beispieldaten** veranschaulichen das Berichtsformat. Es handelt sich nicht um Messungen aus Ihrem Geschäft. Die folgenden Berichtsanweisungen gelten, nachdem die erforderliche Einrichtung abgeschlossen ist und echte Ergebnisse verfügbar sind.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein neuer Shop muss die SEO-Veröffentlichungsvoraussetzung erfüllen, bevor er Berichte verwenden kann. Die Vorschau der Beispieldaten dient der Veranschaulichung. Hier wird kein Analyseergebnis angezeigt.
## Bevor Sie beginnen
- Veröffentlichen Sie das Geschäft, es sei denn, Runner bietet ein berechtigtes benutzerdefiniertes Ziel in Ihrem Arbeitsbereich.
- Bestätigen Sie, dass die öffentliche Seite geladen wird, bevor Sie die Analyse starten.
- Geben Sie Such- und KI-Anbietern Zeit, um Daten über eine neu veröffentlichte Website zu haben.
- Behandeln Sie die Analyse als Momentaufnahme verfügbarer Quellen, nicht als Garantie für Ranking oder Erwähnungen.
## Hauptsteuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| Berichtskarten der Übersicht → **Öffnen** | Öffnet **Suchleistung**, **KI-Sichtbarkeit**, **Backlinks** oder **Website-Zustand**. |
| Korrekturwarteschlange oder Prüfpanel, falls angezeigt | Zeigt eine vorgeschlagene Korrektur und die betroffenen Seiten, bevor Sie die Arbeit starten. |
| **Suchleistung** | Öffnet organische Verkehrs-, Schlüsselwort-, Rang-, Top-Schlüsselwort- und Top-Seiten-Schätzungen. |
| **Backlinks** | Öffnet Links, verweisende Domains, Link-Verlauf und Link-Qualitätsansichten. |
| **Website-Audit** | Öffnet technische Crawl- und Problemergebnisse. |
| KI-Sichtbarkeitsbereiche | Öffnet das Dashboard, Eingabeaufforderungen, Schlüsselwörter, Zitate oder Erwähnungen, falls verfügbar. |
| **Analysieren** | Startet die Analyse für das berechtigte Ziel. Es bearbeitet oder veröffentlicht das Geschäft nicht. |
| **Erneut analysieren** | Fordert eine aktualisierte Analyse an und ersetzt veraltete Ergebnisse, wenn die Aktualisierung abgeschlossen ist. |
| **Veröffentlichen** | Startet den separaten Veröffentlichungsbereitschaftspfad, wenn der Speicher noch ein Entwurf ist. |
| Google Search Console → **Verbinden** | Öffnet **Apps** gefiltert nach Google Search Console, wenn diese Verbindung verfügbar ist. |
## Starten Sie eine SEO-Überprüfung
1. Öffnen Sie **Wachstum** → **SEO** und bestätigen Sie das Ziel in der Übersicht.
2. Wenn Sie das Veröffentlichungsgate sehen, verwenden Sie den Veröffentlichungspfad und kehren Sie erst zurück, nachdem die Live-URL funktioniert.
3. Lesen Sie zunächst vorhandene Berichte. Wählen Sie **Analysieren** nur aus, wenn eine neue Analyse erforderlich ist, nachdem Sie den aktuellen Nutzungshinweis gelesen haben.
4. Warten Sie, bis der Analysestatus abgeschlossen ist; starten Sie nicht wiederholt die gleiche Analyse.
5. Öffnen Sie die Karten **Suchleistung**, **Backlinks** und **Site-Zustand**, um die verfügbaren Berichte zu überprüfen.
6. Kehren Sie zur Übersicht zurück, öffnen Sie **KI-Sichtbarkeit** und überprüfen Sie die verfügbaren Detailabschnitte.
7. Führen Sie mit **Erneut analysieren** nach aussagekräftigen öffentlichen Änderungen oder wenn Runner das Ergebnis als veraltet markiert erneut aus.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Veröffentlichungsgate | Das aktuelle Geschäft ist nicht berechtigt für öffentliche Analyse. Veröffentlichen und überprüfen Sie zuerst die Live-URL. |
| Wird analysiert | Runner sammelt verfügbare Daten. Warten Sie auf Abschluss. |
| Aktualisiert | Die angezeigte Momentaufnahme wurde erfolgreich abgeschlossen. |
| Veraltet | Öffentliche Daten können sich geändert haben; verwenden Sie **Erneut analysieren**, wenn eine Aktualisierung nützlich ist. |
| Teilergebnis | Einige Anbieter haben Daten zurückgegeben und andere nicht. Verwenden Sie die verfügbaren Abschnitte und versuchen Sie es später erneut. |
| Ziel nicht erreichbar | Öffnen Sie die öffentliche URL direkt, beheben Sie Zugriffs- oder Veröffentlichungsprobleme und analysieren Sie dann erneut. |
## Verwandte Leitfäden
- [Suchleistung](./search-performance)
- [Backlinks und Website-Audit](./backlinks-and-site-audit)
- [KI-Sichtbarkeit](./ai-visibility)
- [Fehlerbehebung bei Daten und Veröffentlichung](./troubleshoot-data-and-publication)
---
# Verkehr und Konvertierung
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/traffic-and-conversion
Verkehrs- und Konvertierungsansichten helfen Ihnen zu sehen, wo Käufer ankommen, wie weit sie fortschreiten und wo eine Reise möglicherweise Aufmerksamkeit benötigt.
## Eingabepfad
Öffnen Sie ein Store-Projekt → **Messen** → **Analysen** → **Übersicht**, **Commerce** oder **Verhalten** in der Workbench. Scrollen Sie im früheren Dashboard unter die Zusammenfassungskarten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvR648EFhEHcK82Y0dyL6sSr9NUGjnQeMWZJk)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Analytics als einzelne Seite in einem Tutorial-Store ohne erfasste Aktivität. Die Alpha-Diagnosegrafik ist kein Nachweis eines Store-Problems.
## Bevor Sie beginnen
- Wählen Sie einen Zeitraum aus und halten Sie ihn aktiv, während Sie Abschnitte vergleichen.
- Der Speicher benötigt aufgezeichnete Sitzungen für die Verkehrsanalyse und Bestellungen für Verkaufs- oder Rückerstattungsanalyse.
- Verwenden Sie den Trichter als Beweis dafür, wo Sie überprüfen sollten, nicht als Beweis dafür, warum Käufer gegangen sind.
## Öffnen Sie den Bericht für Ihre Frage
Behalten Sie im einseitigen Dashboard den Zeitraum bei und scrollen Sie zu **Traffic-Sitzungen**, Quellen, Verkäufen im Zeitverlauf, Funnel, Abbrüchen und Erstattungen. Die folgenden gruppierten Ziele gelten nur für die Analytics-Workbench.
| Frage | Workbench-Ziel |
| --- | --- |
| Wo wurde der Einkauf abgebrochen? | **Commerce** → Funnel-Bericht |
| Welche Produkte oder Quellen haben dazu beigetragen? | **Commerce** → Produkt- oder Akquisitionsbericht |
| Welche Seite oder welcher Kundenpfad muss geprüft werden? | **Verhalten** → Seiten- oder Kundenpfadbericht |
Verwenden Sie **Details anzeigen** in der Übersicht, wenn dies zum passenden Bericht führt. Verfügbarkeit und Daten hängen vom Store ab.
Wenn Ihre Analytik-Seite über dem Diagramm **Bericht dieser Woche** und **Weitere Berichte** zeigt, öffnen Sie stattdessen diese Berichte über **Weitere Berichte**:
| Frage | Bericht |
| --- | --- |
| Wo hat das Einkaufen aufgehört? | **Trichter** |
| Welche Kanäle und Kampagnen haben Käufer gebracht? | **Kanäle**. Wechseln Sie zwischen **Letzter Klick** und **Erster Besuch**, um zu sehen, welcher Besuch den Kauf angerechnet bekommt. |
| Welche Produkte verkaufen sich, und woher? | **Produkte**, dann ein Produkt wählen für seine Quellen, Orte und zusammen gekauften Produkte. |
| Welche Quellen und Einstiegsseiten machen aus Besuchen Bestellungen? | **Besucher**. Lesen Sie die Kaufrate jeder Quelle neben ihrer Besuchszahl. |
| Wo wohnen die Käufer? | **Karte** |
| Auf welcher Seite gehen Besucher? | **Seiten** → **Ausstiegsseiten** |
## Abschnitte und Klickergebnisse
| Abschnitt oder Steuerelement | Was es zeigt oder tut |
| --- | --- |
| **Verkehrssitzungen** | Zeigt den Besuchstrend im ausgewählten Zeitraum. |
| Verkaufsquellenansicht | Schlüsselt aufgezeichnete Verkäufe nach Quelle auf, wenn Quelldaten verfügbar sind. |
| Netto-Verkaufsansicht für Produkte | Vergleicht den Produktbeitrag zum Netto-Umsatz. |
| **Konvertierungsrate**-Trichter | Zeigt den Fortschritt durch **Verkehr**, **Zum Warenkorb hinzufügen**, **Kasse** und **Kauf**. |
| **Warenkorbabbruchquote** | Fasst Warenkörbe zusammen, die keinen abgeschlossenen Kauf erreicht haben. |
| **Rückerstattungsquote** | Zeigt rückerstattete Aktivität für das Berichtsfenster. |
| Zeitbereichswähler | Berechnet jeden Abschnitt für den neuen Zeitraum neu. |
## Diagnostizieren Sie einen Rückgang der Konvertierung
1. Scrollen Sie im einseitigen Dashboard zum Funnel oder öffnen Sie den passenden **Commerce**-Bericht in der Workbench. Wählen Sie einen aussagekräftigen Zeitraum mit ausreichend Sitzungen. Prüfen Sie bei fehlenden Daten zuerst Erfassung und Zeitraum, bevor Sie die Conversion untersuchen.
2. Überprüfen Sie, ob der Verkehr gestiegen, gefallen oder gleich geblieben ist.
3. Vergleichen Sie Verkehrsquellen, um zu sehen, ob sich die Mischung geändert hat.
4. Finden Sie den größten Rückgang zwischen benachbarten Trichterstadien.
5. Wenn **Verkehr → Zum Warenkorb hinzufügen** sinkt, überprüfen Sie Produktinformationen, Preisgestaltung, Vertrauen und Klarheit der Produktseite.
6. Wenn **Zum Warenkorb hinzufügen → Kasse** sinkt, überprüfen Sie Warenkorb-Kosten, Versandklarheit und den Weg zur Kasse.
7. Wenn **Kasse → Kauf** sinkt, testen Sie den Zahlungs- und Kassenpfad, ohne eine unnötige echte Bestellung aufzugeben.
8. Überprüfen Sie Rückerstattungen separat, damit Probleme nach dem Kauf nicht in den Top-Line-Verkäufen verborgen sind.
**Prüfpunkt:** Benennen Sie Stufe, Seite, Zeitraum und zugrunde liegende Fallzahl, bevor Sie eine Änderung vorschlagen. Testen Sie Ihre Erklärung auf der betroffenen Storefront-Seite. Der Funnel zeigt, wo Sie prüfen sollten, nicht die Ursache des Rückgangs.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Trichterstadium ist null | Kein passendes Ereignis hat dieses Stadium im ausgewählten Bereich erreicht. Bestätigen Sie das Tracking mit einem sicheren Geschäftsdurchgang. |
| Verkehr existiert, aber Verkäufe nicht | Der Speicher erhielt Besuche ohne einen aufgezeichneten Kauf. Überprüfen Sie den ersten großen Trichterabfall. |
| Verkäufe existieren, aber Quelle ist leer | Quellzuordnung war für diese Verkäufe nicht verfügbar; weisen Sie eine Quelle nicht durch Vermutung zu. |
| Rückerstattungsquote ändert sich stark | Überprüfen Sie den zugrunde liegenden Bestellzeitraum und die Anzahl der Bestellungen, bevor Sie eine Schlussfolgerung ziehen. |
| Diagramme stimmen nicht mit einem anderen Dienst überein | Richten Sie Datumsbereiche, Zeitzonen, Ereignisdefinitionen und Filter aus, bevor Sie Summen vergleichen. |
## Verwandte Leitfäden
- [Metriken und Filter](./metrics-filters)
- [Analytik-Übersicht](./analytics-overview)
- [Suchleistung](./search-performance)
---
# Fehlerbehebung bei Daten und Veröffentlichung
Source: https://www.runnerai.com/docs/de/guides/analytics-and-seo/troubleshoot-data-and-publication
Verwenden Sie diese Seite, um zu ermitteln, ob ein fehlendes Ergebnis aus dem Geschäftszustand, dem Zeitraum, dem Planzugriff, dem Funktionszugriff oder einer externen Datenquelle stammt.
## Eingabepfade
- Store-Projekt → **Messen** → **Analysen** für Store-Ereignisdaten.
- Store-Projekt → **Wachstum** → **SEO** für öffentliche Such- und KI-Sichtbarkeitsdaten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Diese Veröffentlichungsanforderung erklärt, warum ein neuer Store keinen SEO-Bericht hat. Beispieldaten sind keine abgeschlossene Analyse.
## Bevor Sie beginnen
- Notieren Sie die genaue Seite, den Speicher, den ausgewählten Zeitraum und die sichtbare Nachricht.
- Überprüfen Sie, ob das Problem einen Abschnitt oder die ganze Seite betrifft.
- Öffnen Sie für SEO das öffentliche Geschäft direkt, bevor Sie eine andere Analyse starten.
- Bestätigen Sie für Analytik, dass der ausgewählte Zeitraum das erwartete Ereignis enthalten könnte.
## Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| Analytik-Zeitbereich | Aktualisiert den Bericht für den ausgewählten Zeitraum; es erstellt keine fehlenden Verkehrs- oder Bestellungsereignisse. |
| **Analysieren** | Startet die verfügbare SEO- oder KI-Sichtbarkeitsanalyse für das aktuelle öffentliche Ziel. |
| **Erneut analysieren** | Fordert eine neue Momentaufnahme nach einer aussagekräftigen öffentlichen Website-Änderung an. |
| **Erneut versuchen** | Wiederholt den fehlgeschlagenen Abschnitt oder die Anfrage, wenn angeboten; es behebt keine Veröffentlichungs-, Zugriffs- oder Anbietervoraussetzungen. |
## Fehlerbehebung
| Was Sie sehen | Wahrscheinliche Bedeutung | Nächster Schritt |
| --- | --- | --- |
| Upgrade- oder Planbildschirm | Der aktuelle Plan enthält die Seite nicht. | Überprüfen Sie den Planzugriff; wiederholtes Neuladen wird ihn nicht entsperren. |
| Navigationseintrag fehlt | Die Funktion ist für diesen Arbeitsbereich nicht aktiviert. | Behandeln Sie es als bedingt und fragen Sie einen Arbeitsbereichseigentümer oder den Support. |
| **Veröffentlichen Sie Ihren Geschäft, um mit der Analyse zu beginnen** | SEO hat kein berechtigtes öffentliches Ziel. | Schließen Sie die Veröffentlichung ab, öffnen Sie die Live-URL und kehren Sie dann zu SEO zurück. |
| Analytik-Dashboard, Null oder leeres Diagramm | Für den ausgewählten Zeitraum existieren keine passenden Ereignisse. | Versuchen Sie ein längeres Fenster und überprüfen Sie, ob der Speicher Besuche oder Bestellungen hat. |
| **Neuer Shop** mit einer Besucherzahl | Diagramme erscheinen, sobald genug Personen da waren, damit die Zahlen aussagekräftig sind. | Teilen Sie den Shop-Link; die Zahl zeigt, wie viele Besuche noch fehlen. |
| **Beispieldaten · nicht Ihr Shop** | Die Seite zeigt Beispielzahlen, nicht Ihre Ergebnisse. | Wenn Sie **Beispieldaten ansehen** gewählt haben, wählen Sie **Zurück zu den Projektdaten**. Bietet die Seite **Auf Pro upgraden** an, enthält Ihr Tarif diese Berichte nicht; die Beispiele bleiben bis zum Upgrade. |
| **Bald verfügbar** in einem Bereich | Dieser Bereich hat noch keine Datenquelle. | Nutzen Sie die anderen Bereiche; es ist kein Shop- oder Tracking-Problem. |
| **Dieser Bereich wurde nicht geladen.** | Eine Anfrage ist fehlgeschlagen. | Wählen Sie **Erneut versuchen**, wenn es angezeigt wird, oder laden Sie die Seite neu. Die anderen Bereiche zeigen Ihre Daten weiter. |
| Ziel nicht erreichbar | Der Analyzer konnte die öffentliche Seite nicht laden. | Öffnen Sie die genaue URL direkt und beheben Sie Veröffentlichungs-, Domänen- oder Zugriffsprobleme. |
| Nicht genug Daten | Der Anbieter kann noch keine nützliche Schätzung zurückgeben. | Halten Sie die Website öffentlich und versuchen Sie es später nach mehr öffentlicher Aktivität oder Entdeckung erneut. |
| Teilabschnitte | Einige Anbieter haben abgeschlossen und andere nicht. | Verwenden Sie abgeschlossene Ergebnisse; versuchen Sie nur den fehlenden Abschnitt später erneut. |
| Veraltete Bezeichnung | Die gespeicherte Momentaufnahme spiegelt möglicherweise nicht mehr die öffentliche Website wider. | Wählen Sie **Erneut analysieren** nach aussagekräftigen Änderungen. |
## Überprüfen Sie Analytik-Daten
1. Öffnen Sie **Analytik** und notieren Sie den ausgewählten Zeitraum.
2. Wählen Sie **30d** oder im früheren Layout **Letzte 30 Tage** und entfernen Sie [optionale Filter](/de/guides/analytics-and-seo/metrics-filters), um eine zu enge Abfrage auszuschließen.
3. Bestätigen Sie, dass der Live-Shop echte Sitzungen erhalten hat.
4. Bestätigen Sie, dass Bestellungen oder Rückerstattungen vorhanden sind, bevor Sie Verkaufs- oder Rückerstattungsmetriken erwarten.
5. Vergleichen Sie Trichterstadien, um zu sehen, welche Ereignisse vorhanden sind.
6. Laden Sie einmal neu. Wenn die ganze Seite immer noch fehlschlägt, notieren Sie den Speicher und den Zeitraum für den Support.
## Überprüfen Sie SEO-Veröffentlichung und -Analyse
1. Öffnen Sie das öffentliche Geschäft in einem separaten Tab.
2. Bestätigen Sie, dass es ohne private Vorschau oder Anmeldeanforderung geladen wird.
3. Kehren Sie zu **SEO** zurück und bestätigen Sie die beabsichtigte Domäne oder das Ziel.
4. Wählen Sie **Analysieren** oder **Erneut analysieren** einmal aus.
5. Warten Sie auf ein Endergebnis, anstatt wiederholte Jobs zu starten.
6. Wenn ein Abschnitt fehlschlägt, bewahren Sie die erfolgreichen Abschnitte auf und versuchen Sie es später erneut.
## Was ein erfolgreicher Setup nicht beweist
- Veröffentlichung garantiert keine Suchindexierung.
- Suchindexierung garantiert keinen Verkehr oder eine Top-Position.
- SEO-Setup garantiert keine Erwähnung.
- Ein erfolgreicher Prompt-Lauf sagt nicht jede zukünftige Modellantwort voraus.
- Ein Analytik-Ereignis erklärt nicht, warum ein Käufer handelte.
## Berichtszugriff und Datenerfassung trennen
Klappen Sie **Messen** oder **Wachstum** auf, bevor Sie einen Eintrag als fehlend betrachten. Eine Tarifvorschau ist kein Live-Bericht. **Konfigurieren** in der Analytics-Workbench enthält Tracking- und Einstellungsfunktionen; das Öffnen erzeugt keine Käuferereignisse. Prüfen Sie Store, Zeitraum, Filter und tatsächliche Aktivität vor Änderungen an der Erfassung.
**Prüfpunkt:** Stellen Sie fest, ob der Zugriff blockiert ist, die Abfrage leer ist oder eine konkrete Anfrage fehlschlug. Ein leerer Bericht allein unterscheidet nicht zwischen fehlender Aktivität und fehlender Erfassung.
## Verwandte Leitfäden
- [Analytik-Übersicht](./analytics-overview)
- [SEO-Übersicht](./seo-overview)
- [KI-Sichtbarkeit](./ai-visibility)
- [Runner-Dokumentation](../product-guide)
---
# Apps und Integrationen
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations
Apps bringt Ihre Store-Dienste und optionale Agent Apps an einen Ort. Verwenden Sie es, wenn Sie wollen, dass Runner Zahlungen akzeptiert, Store-E-Mails sendet, mit Versand- oder Fulfillment- ANBIETERN arbeitet, Shopify verbindet oder den Agent einen anderen Dienst verwenden lässt.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Die Übersicht zeigt vorhandene Verbindungszustände und verfügbare Steuerelemente. Durch das Öffnen entsteht keine Verbindung.
## Öffnen Sie Apps
Wählen Sie in einem offenen Store **Apps** in der Projektnavigation aus.
**Eingabepfad:** **Projekt → Apps**
Die Seite kann zwei Abschnitte anzeigen:
- **Shop betreiben** enthält Dienste für Storefront und Store-Betrieb.
- **Tools verbinden** enthält Dienste, die der Runner-Agent bei seiner Arbeit für Sie verwenden kann.
Agent Apps und Shopify sind bedingt. Sie können für einige Workspaces ausgeblendet oder nicht verfügbar sein. Anbieteranforderungen können auch verhindern, dass eine sichtbare Karte verbunden wird.
## Seitensteuerlemente
| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Tools suchen** | Findet einen Dienst, ohne jede Karte durchzugehen. | Runner filtert den Tool-Katalog. Ein leeres Suchfeld zeigt wieder die vollständige Liste. |
| **Verbinden** | Startet eine neue Verbindung. | Runner öffnet den anbieterspezifischen Anmeldedaten-Dialog oder Autorisierungsablauf. Die Verbindung ist nicht abgeschlossen, bis sich der Kartenzustand ändert. |
| **Verbindung wird hergestellt...** | Zeigt, dass Runner die Anfrage verarbeitet. | Die Aktion bleibt nicht verfügbar, bis die Anfrage erfolgreich ist, fehlschlägt oder außerhalb von Runner abgebrochen wird. |
| **Verbunden** oder eine verbundene Aktion | Bestätigt, dass Runner die Verbindung erkennt. | Anbieterspezifische Karten können einen Dashboard-Link, Trennungssteuerelement, Schalter oder Verwaltungsdialog verfügbar machen. |
| **Verwalten** | Öffnet eine vorhandene Agent App-Verbindung. | Sie können ihre Werkzeuge überprüfen oder sie trennen. |
| **Erneut verbinden** | Repariert eine Verbindung, die erneut autorisiert werden muss. | Runner startet den Verbindungsablauf des Anbieters neu. |
| **Überprüfung ausstehend** | Zeigt, dass Stripe das Konto noch überprüft. | Warten Sie, bis sich der Status ändert, oder folgen Sie einer auf der Karte angezeigten Aktionsanfrage. |
| Löschen oder **Trennen** | Entfernt eine Verbindung nach Bestätigung. | Die anbieterspezifische Warnung erklärt, welche Projekte und zukünftigen Aktionen betroffen sind. |
## Eine vorhandene Verbindung finden oder ein Tool anfragen
Öffnen Sie über **Verbunden** eine bereits verbundene App, um ihre Verwaltungsfunktionen zu prüfen. Neue Agent-Apps finden Sie unter **Tools verbinden** mit **Tools suchen**. Leeren Sie die Suche, bevor Sie von einer fehlenden App ausgehen.
**App anfragen** öffnet ein Anfrageformular. Das Absenden verbindet keinen Anbieter und macht ihn nicht sofort verfügbar. CJ-Lieferantenverbindungen beginnen unter [Dropshipping](/de/guides/apps-and-integrations/cj-dropshipping), nicht auf einer Apps-Karte.
## Verbinden Sie eine App sicher
1. Öffnen Sie **Projekt → Apps**.
2. Suchen Sie den Dienst oder finden Sie ihn unter **Shop betreiben** oder **Tools verbinden**.
3. Wählen Sie **Verbinden**.
4. Lesen Sie den Dialog, bevor Sie eine Domain, einen API-Schlüssel, einen Geheimwert oder Anbieterzugangsdaten eingeben.
5. Schließen Sie gegebenenfalls die Autorisierung auf der Website des Anbieters ab.
6. Kehren Sie zu Apps zurück und prüfen Sie die Karte. Erst ein bestätigter Verbindungsstatus oder die Verwaltungsfunktionen einer verbundenen App gelten als abgeschlossene Verbindung.
7. Zeigt Runner **Erneut verbinden**, **Prüfung läuft** oder einen Handlungshinweis, folgen Sie diesem Zustand, statt die Ersteinrichtung blind zu wiederholen.
:::warning Fügen Sie API-Schlüssel oder Geheimnisse niemals in einen Runner-Chat ein. Geben Sie sie nur in den Integrations- Dialog ein, der danach fragt. :::
## Wählen Sie eine Anleitung
- [App verbinden, verwalten, erneut verbinden oder trennen](/de/guides/apps-and-integrations/connect-manage-reconnect)
- [Stripe für Zahlungen verbinden](/de/guides/apps-and-integrations/stripe-payments)
- [Store-E-Mails aktivieren](/de/guides/apps-and-integrations/resend-email)
- [Shippo für den Versand verbinden](/de/guides/apps-and-integrations/shippo-shipping)
- [Shopify verbinden](/de/guides/apps-and-integrations/shopify)
- [CJ über Dropshipping verbinden](/de/guides/apps-and-integrations/cj-dropshipping)
- [4PX-Fulfillment verbinden](/de/guides/apps-and-integrations/4px-fulfillment)
- [Agent-Apps verbinden und steuern](/de/guides/apps-and-integrations/agent-apps)
- [Probleme mit einer App-Verbindung beheben](/de/guides/apps-and-integrations/troubleshooting)
---
# Verbinden Sie 4PX-Erfüllung
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/4px-fulfillment
Verbinden Sie 4PX, wenn Sie möchten, dass Runner Ihr 4PX-Konto für grenzüberschreitenden Versand und Erfüllung verwendet. Diese Verbindung erfordert sowohl einen API-Schlüssel als auch ein API-Geheimnis.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Apps → Shop betreiben → 4PX**
Sie benötigen:
- ein 4PX-Konto mit einem aktuellen API-Schlüssel und API-Geheimnis;
- die Berechtigung, diese Anmeldedaten für diesen Runner-Shop zu verwenden; und
- das Bewusstsein, dass das Trennen beide Anmeldedaten entfernt und 4PX nur für diesen Shop deaktiviert. Andere Shops behalten ihre eigene 4PX-Verbindung.
Behandeln Sie beide Felder als Geheimnisse. Fügen Sie sie nicht in Runner-Chat ein.
Wählen Sie auf Mobilgeräten zuerst die Anbieterzeile **4PX**, um die Details zu öffnen. Verwenden Sie dann die Steuerelemente im Dialog. Ein sichtbares Einrichtungsformular zeigt nur den Einstieg; die folgenden Verbindungs- und Anbieterschritte gelten erst nach Ihrer Autorisierung.
## 4PX-Steuerelemente und Ergebnisse
| Steuerelement | Warum es nützlich ist | Was passiert danach |
| --- | --- | --- |
| **Verbinden** | Öffnet 4PX-Setup. | Runner fragt nach **4PX-API-Schlüssel** und **4PX-API-Geheimnis**. |
| API-Schlüssel- und Geheimnis-Felder | Identifizieren und autorisieren das 4PX-Konto. | Runner reicht nur ein, nachdem beide Felder einen Wert enthalten. |
| Augensymbole | Helfen, einen Tippfehler in einem Feld zu überprüfen. | Jedes Symbol schaltet dieses Feld unabhängig zwischen verborgenem und sichtbarem Text um. |
| Dialog **Verbinden** | Reicht beide Anmeldedaten ein. | Bei Erfolg löscht Runner beide Felder, schließt den Dialog und markiert 4PX als verbunden. |
| **Abbrechen** oder schließen | Stoppt vor der Einreichung. | Runner löscht beide Felder aus dem Dialog. |
| Löschen oder **Trennen** | Startet die Entfernung. | Runner öffnet **4PX trennen?**. |
| Bestätigung **Trennen** | Entfernt die Anmeldedaten dieses Shops. | Runner deaktiviert 4PX für diesen Shop. Andere Shops sind nicht betroffen. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGp76tmTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie die beiden Zugangsdatenfelder vor dem Verbinden. Dieses Beispiel endet vor dem Absenden; es bestätigt weder Fulfillment noch eine Sendung.
## Verbinden Sie 4PX
1. Öffnen Sie **Projekt → Apps**.
2. Finden Sie **4PX** und wählen Sie **Verbinden**.
3. Kopieren Sie den API-Schlüssel und das API-Geheimnis aus dem 4PX-Konto, das Sie verwenden möchten.
4. Fügen Sie sie in **4PX-API-Schlüssel** und **4PX-API-Geheimnis** ein.
5. Überprüfen Sie, dass die beiden Werte in den richtigen Feldern sind.
6. Wählen Sie **Verbinden**.
7. Warten Sie auf **4PX erfolgreich verbunden** und bestätigen Sie, dass die Karte sein verbundenes Trennsteuerelement anzeigt.
8. Überprüfen Sie ein sicheres grenzüberschreitendes Versand- oder Erfüllungsszenario, bevor Sie es für eine echte Kundenbestellung verwenden.
## Trennen oder ersetzen Sie Anmeldedaten
Wählen Sie das Trennsteuerelement und lesen Sie **4PX trennen?**. Bestätigen Sie nur, wenn das Deaktivieren von 4PX für diesen Shop akzeptabel ist. Andere Shops im Arbeitsbereich behalten ihre eigene Verbindung.
Um Anmeldedaten zu rotieren, trennen Sie die aktuelle Verbindung, bestätigen Sie, dass die Karte nicht mehr verbunden ist, und verbinden Sie sich dann mit dem Ersatzschlüssel und -geheimnis erneut.
## Wenn 4PX nicht verbunden ist
- Bestätigen Sie, dass der Schlüssel und das Geheimnis aus demselben 4PX-Konto stammen.
- Kopieren Sie beide Werte erneut, anstatt eines der Geheimnisse durch Vermutung zu bearbeiten.
- **Fehler beim Verbinden von 4PX** bedeutet, dass Runner die Anbieterverbindung nicht abgeschlossen hat. Überprüfen Sie die Anmeldedaten in 4PX und versuchen Sie es erneut.
- Wenn die Karte verbunden ist, aber die Erfüllung fehlschlägt, überprüfen Sie den Kontenzugriff, die Zielunterstützung und die von 4PX erforderlichen Bestelldaten.
- Wenn das Trennen fehlschlägt, gehen Sie davon aus, dass die aktuellen Anmeldedaten aktiv bleiben.
## Verwandte Leitfäden
- [Verbinden, verwalten und erneut verbinden Sie eine App](./connect-manage-reconnect)
- [Verbinden Sie Shippo für Versand](./shippo-shipping)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
---
# Verbinden und steuern Sie Agent Apps
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/agent-apps
Agent Apps ermöglichen es dem Runner Agent, einen externen Dienst zu nutzen, während er an Ihrem Projekt arbeitet. Sie können die Tools der App überprüfen und Tools ausschalten, die der Agent nicht verwenden soll.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Apps → Tools verbinden**
Agent Apps sind bedingt. Der Abschnitt kann verborgen sein, eine einzelne App kann nicht verfügbar sein oder der Katalog kann nicht geladen werden. Die Verfügbarkeit kann je nach Arbeitsbereich, Projekt, Anbieter und gestaffeltem Produktzugriff variieren.
Sie benötigen:
- Zugriff auf das Projekt;
- ein Konto oder Anmeldedaten, die vom ausgewählten Anbieter akzeptiert werden; und
- die Berechtigung, Runner die Tools zu verwenden, die Sie aktiviert lassen.
Überprüfen Sie jeden Tool, bevor Sie verbinden. Der Tool-Zugriff gilt für das aktuelle Projekt und kann dem Agent ermöglichen, Daten im externen Dienst zu lesen oder zu ändern.
Die externe Kontoverbindung gehört zu Ihrem angemeldeten Runner-Konto, während Tool-Schalter für das aktuelle Projekt gespeichert werden. Das Trennen kann daher die Verbindung entfernen, die von anderen Projekten verwendet wird, obwohl ihre Tool-Auswahl separat ist.
Beginnen Sie unter **Tools verbinden**. Öffnen Sie eine App, lesen Sie ihre Tool-Liste und schließen Sie die Details, wenn Sie nur Funktionen vergleichen möchten. Die Autorisierung ist eine eigene Entscheidung; das Prüfen der Tools verbindet kein externes Konto.
## Finden und überprüfen Sie eine App
| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert danach |
| --- | --- | --- |
| **Tools suchen** | Filtert den Tool-Katalog. | Der Katalog zeigt passende Namen und Beschreibungen. |
| Kategorienwähler | Verengt den Agent Apps-Katalog. | Wählen Sie **Alle**, um den Kategoriefilter zu entfernen. |
| **Zurück** und **Weiter** | Bewegt sich durch einen langen Katalog. | Runner zeigt die vorherige oder nächste Seite passender Apps. |
| App-Karte | Zeigt den App-Namen, die Beschreibung und den Verbindungsstatus. | Die Auswahl öffnet **App-Details**. |
| **Keine Apps gefunden** | Zeigt, dass aktuelle Filter keine Übereinstimmung haben. | **Suche löschen** setzt die Suche und Kategorie zurück. |
| Lade-Platzhalter | Zeigt, dass Runner den Katalog abruft. | Warten Sie auf Karten, bevor Sie eine App auswählen. |
## App-Details-Steuerelemente
| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert danach |
| --- | --- | --- |
| App-Beschreibung und Kategorie | Hilft zu bestätigen, dass Sie den beabsichtigten Dienst geöffnet haben. | Kein externer Zugriff wird durch das Anzeigen von Details gewährt. |
| Tool-Schalter | Begrenzt, was Runner den verbundenen App zu tun bitten kann. | Vor dem Verbinden speichert Runner Ihre Auswahl mit der Verbindung. Nach dem Verbinden wird eine Änderung sofort gespeichert. |
| **Zurück** und **Weiter** in der Tool-Liste | Überprüft Apps mit vielen Tools. | Bewegt sich durch Tools, ohne den Dialog zu schließen. |
| Erforderliche Anmeldedatenfelder | Unterstützt Apps, die keine Browser-Autorisierung verwenden. | **Verbinden** bleibt nicht verfügbar, bis erforderliche Felder ausgefüllt sind. Geheimnisähnliche Felder sind maskiert. |
| **Verbinden** | Reicht Anbieter-Anmeldedaten ein, wenn diese Strategie erforderlich ist. | Runner versucht die Verbindung mit Ihrem gewählten Tool-Zugriff. |
| **Verbinden & Autorisieren** | Startet die Anbieter-Autorisierung. | Runner öffnet ein Autorisierungsfenster. |
| **Verbindung wird hergestellt...** | Zeigt, dass die Autorisierung läuft. | Die Aktion bleibt nicht verfügbar, bis Runner ein Ergebnis erhält. |
| **Verbunden** | Bestätigt, dass Runner das Konto erkennt. | Schließen Sie den Dialog oder verwalten Sie den Tool-Zugriff. |
| **Verwalten** | Öffnet eine verbundene App erneut. | Überprüfen und ändern Sie ihre aktivierten Tools oder trennen Sie sie. |
| **Trennen** | Startet die Entfernung. | Runner fragt **Sind Sie sicher, dass Sie trennen möchten?** |
| **Abbrechen** oder **Bestätigen** | Löst die Trennwarnung auf. | Abbrechen behält den Zugriff; Bestätigen entfernt die Agent App-Verbindung auf Kontoebene von Runner. Projekt-Tool-Einstellungen sind separat. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgkttueHjXIfFwWx7Qu1lJBZMSPHcazYdR0voC)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie Tools mit **Weiter** Seite für Seite. Das Öffnen der Liste autorisiert Notion nicht. **Verbinden & Autorisieren** startet diesen separaten Schritt.
## Verbinden Sie eine Agent App
1. Öffnen Sie **Projekt → Apps** und scrollen Sie zu **Tools verbinden**.
2. Suchen Sie eine App oder wählen Sie eine Kategorie.
3. Wählen Sie die App-Karte, um **App-Details** zu öffnen.
4. Lesen Sie die Beschreibung und prüfen Sie alle verfügbaren Tools.
5. Deaktivieren Sie Tools, die Runner in diesem Projekt nicht verwenden soll.
6. Geben Sie erforderliche Anbieterzugangsdaten ein oder wählen Sie **Verbinden & Autorisieren**.
7. Schließen Sie den Anbieterschritt ab. Falls Ihr Browser das Autorisierungsfenster blockiert, erlauben Sie das Pop-up für Runner und starten Sie erneut.
8. Kehren Sie zum Dialog zurück und prüfen Sie **Verbunden**.
9. Öffnen Sie später **Verwalten**, um Tool-Zugriff zu prüfen oder die App zu trennen.
Der Verbindungsdialog besagt, dass Anbieter-Anmeldedaten durch den Verbindungsdienst gesendet werden und nicht von Runner gespeichert werden. Sie sollten dennoch jede Anmeldedaten als Geheimnis behandeln und sie nur in den Anmeldedatenfeldern der App eingeben.
## Ändern Sie den Tool-Zugriff
1. Wählen Sie **Verwalten** auf der verbundenen App.
2. Finden Sie den Tool, den Sie ändern möchten.
3. Schalten Sie seinen Schalter ein oder aus.
4. Warten Sie auf **Tool aktiviert** oder **Tool deaktiviert**.
5. Wenn Runner **Fehler beim Aktualisieren des Tools** anzeigt, lassen Sie den Dialog offen, überprüfen Sie den aktuellen Schalter nach dem Aktualisieren und versuchen Sie es nur erneut, wenn der gespeicherte Zustand klar ist.
Das Deaktivieren eines Tools begrenzt Runners Verwendung dieses Tools. Es löscht keine Daten, die zuvor im externen Dienst erstellt wurden.
## Reparieren oder trennen Sie eine Verbindung
Wenn der Katalog keine verwendbare Verbindung mehr anzeigt, öffnen Sie die App und starten Sie **Verbinden** oder **Verbinden & Autorisieren** erneut, und bestätigen Sie dann **Verbunden**.
Um den Zugriff zu entfernen, wählen Sie **Verwalten → Trennen**, überprüfen Sie die Bestätigung und wählen Sie **Bestätigen**. Dies entfernt die Agent App-Verbindung des angemeldeten Kontos, nicht nur den Tool-Zugriff des aktuellen Projekts. Wenn das Trennen fehlschlägt, behält Runner den verbundenen Zustand; gehen Sie nicht davon aus, dass das externe Konto entfernt wurde.
## Wenn Agent Apps fehlen
- Die Funktion ist möglicherweise nicht für den Arbeitsbereich aktiviert.
- Löschen Sie die Suche und setzen Sie die Kategorie auf **Alle**.
- Aktualisieren Sie Apps, wenn der Katalog seinen Ladezustand nie verlässt.
- Eine einzelne App kann melden, dass sie noch nicht verbunden werden kann.
- Wenn die Tools-Liste fehlschlägt, wählen Sie **Erneut versuchen** in **App-Details**.
- Keine spezifische Katalogeinträge sollten versprochen werden, bis sie im aktuellen Arbeitsbereich angezeigt werden.
## Verwandte Leitfäden
- [Apps und Integrationen Übersicht](../apps-and-integrations)
- [Verbinden, verwalten und erneut verbinden Sie eine App](./connect-manage-reconnect)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
---
# CJ Dropshipping verbinden
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/cj-dropshipping
Verbinden Sie CJ Dropshipping, um CJ-Produkte mit Ihrem eigenen CJ-Konto zu suchen, zu importieren und zu betreiben.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Dropshipping → Lieferant verbinden**
Verwendet Ihr Projekt die ältere Navigation, öffnen Sie stattdessen **Shop-Betrieb → Dropshipping**. Die aktuelle Apps-Seite listet CJ nicht; verwenden Sie den Lieferanteneinstieg.
Sie benötigen:
- ein CJ-Dropshipping-Konto mit aktuellem API-Schlüssel;
- die Berechtigung, es mit der Organisation zu verbinden; und
- ein geeignetes Beispielprodukt, um die Verbindung vor dem Einsatz zu prüfen.
Halten Sie den API-Schlüssel geheim und geben Sie ihn nur in Runners CJ-Verbindungsdialog ein. Durch das Trennen verlieren händlereigene CJ-Importe ihre Lieferantenautorisierung, bis Sie erneut verbinden.
## CJ-Steuerelemente und Ergebnisse
| Steuerelement | Zweck | Was danach geschieht |
| --- | --- | --- |
| **Lieferant verbinden** | Öffnet die Anbieterauswahl in Dropshipping. | Wählen Sie CJ Dropshipping, um die API-Schlüssel-Einrichtung zu öffnen. |
| Anbieter **CJ Dropshipping** | Öffnet die CJ-Einrichtung aus Dropshipping. | Runner fragt nach dem **CJ API-Schlüssel**. |
| **CJ API-Schlüssel** | Verbindet Ihr eigenes Lieferantenkonto. | Ein nicht leerer Schlüssel kann im Dialog gesendet werden. |
| Augensymbol | Hilft beim Prüfen eines Tippfehlers. | Blendet den Schlüssel ein oder aus. Verbergen Sie ihn, bevor Sie Ihren Bildschirm teilen. |
| **Verbinden** im Dialog | Sendet den Schlüssel. | Bei Erfolg leert Runner das Feld, schließt den Dialog und zeigt CJ als verbunden an. |
| **Abbrechen** oder schließen | Beendet den Vorgang ohne Verbindung. | Runner entfernt den Schlüssel aus dem Dialog. |
| Löschen oder **Trennen** | Startet das Entfernen. | Runner öffnet vor dem Trennen eine Bestätigung. |
| **Trennen** in der Bestätigung | Entfernt Ihren Schlüssel. | Vom Händler autorisierte CJ-Suche, Importe, Checkout und Lieferantenvorgänge bleiben gesperrt, bis eine gültige Verbindung wiederhergestellt ist. |
Um die Einrichtung ohne CJ-Autorisierung anzusehen, öffnen Sie die Anbieterauswahl und das leere Schlüsselformular und wählen Sie **Abbrechen**. Für die folgenden Verbindungs- und Importschritte benötigen Sie ein gültiges eigenes Lieferantenkonto. Eine Katalogvorschau bestätigt keinen dieser Vorgänge.
## CJ-Konto verbinden
1. Öffnen Sie **Projekt → Dropshipping** oder den älteren Eintrag Store Operations, falls angezeigt.
2. Wählen Sie **Lieferant verbinden** und anschließend **CJ Dropshipping**.
3. Kopieren Sie den API-Schlüssel aus dem CJ-Konto, das Runner verwenden soll.
4. Fügen Sie ihn unter **CJ API-Schlüssel** ein.
5. Wählen Sie im Dialog **Verbinden**.
6. Warten Sie, bis Runner die Verbindung bestätigt.
7. Führen Sie eine geeignete Testsuche aus oder öffnen Sie ein CJ-Beispielprodukt in Dropshipping, um den Zugriff auf den gewünschten Katalog zu prüfen.
Die Organisation teilt ihre Lieferantenverbindungen. Prüfen Sie CJ und AliExpress unter **Lieferanten verwalten** getrennt; das Verbinden eines Anbieters verbindet nicht den anderen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Dieses Beispiel zeigt vorhandene Lieferantenverbindungen und deren Prüfstelle. Für diese Anleitung wurde keine Verbindung hergestellt, kein Produkt importiert und keine Verbindung getrennt.
## Schlüssel trennen oder ersetzen
Durch das Trennen wird Ihr CJ-API-Schlüssel entfernt. Händlerimporte werden nicht transparent auf ein anderes CJ-Konto übertragen. Für künftige Suche und Importe müssen Sie die Verbindung wiederherstellen.
Bei betroffenen Händlerimporten werden Verbindung, Produkt, Variante, Bestand, Preis und Fracht beim Checkout und unmittelbar vor Bestellabschluss live geprüft. Kann Runner diese Daten nicht bestätigen, wird der Checkout gestoppt. Verbinden Sie dasselbe CJ-Konto erneut. Wenn Identität oder Live-Daten nicht mehr passen, entfernen und importieren Sie den Artikel erneut.
Zum Ersetzen trennen Sie den aktuellen Schlüssel, prüfen den getrennten Zustand und verbinden den neuen Schlüssel. Prüfen Sie bestehende CJ-Produkte vor neuen Bestellungen, da ein Kontowechsel Importe unbrauchbar machen kann.
## Wenn CJ keine Verbindung herstellt
- Kopieren Sie den API-Schlüssel erneut aus dem vorgesehenen CJ-Konto. Ändern Sie ihn nicht auf Verdacht.
- **CJ Dropshipping konnte nicht verbunden werden** bedeutet, dass Runner die Verbindung nicht akzeptiert hat. Prüfen Sie den Schlüssel in CJ und versuchen Sie es erneut.
- Wenn sich der Dialog ohne Verbindungsbestätigung schließt, aktualisieren Sie die Seite vor einem erneuten Versuch.
- Falls Suche oder Import nach dem Verbinden fehlschlagen, prüfen Sie die Berechtigungen dieses CJ-Kontos für den betreffenden Katalogvorgang.
- Falls das Trennen fehlschlägt, behandeln Sie Schlüssel und Kontozugriff weiterhin als aktiv, bis Runner das Entfernen bestätigt.
- Falls der Checkout nach einer erneuten Verbindung stoppt, prüfen Sie, ob Produkt und Varianten zum verbundenen CJ-Konto gehören. Importieren Sie den Artikel erneut, wenn das nicht zutrifft.
## Verwandte Leitfäden
- [App verbinden, verwalten und erneut verbinden](./connect-manage-reconnect)
- [4PX-Fulfillment verbinden](./4px-fulfillment)
- [App-Verbindung beheben](./troubleshooting)
---
# App verbinden, verwalten und erneut verbinden
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/connect-manage-reconnect
Verwenden Sie diese Anleitung, um eine App durch ihren Verbindungslebenszyklus zu führen: Starten Sie die Verbindung, bestätigen Sie ihren tatsächlichen Zustand, reparieren Sie die Autorisierung bei Bedarf und trennen Sie sie sicher.
**Eingabepfad:** **Projekt → Apps**
## Bevor Sie beginnen
Verwenden Sie es, wenn:
- eine App **Verbinden**, **Verbindung wird hergestellt...**, **Erneut verbinden** oder **Überprüfung ausstehend** anzeigt;
- Sie überprüfen müssen, ob ein vorheriger Anbieterablauf wirklich abgeschlossen wurde;
- eine Agent-App anderen Werkzeugzugriff benötigt; oder
- Sie beabsichtigen, eine Verbindung zu entfernen und die Warnung zuerst verstehen müssen.
Sie benötigen Zugriff auf das Projekt und alle Konten, Anmeldedaten oder Genehmigungen, die vom external provider angefordert werden. Einige Apps sind bedingt und erscheinen möglicherweise nicht in jedem Workspace.
Tippen Sie auf Mobilgeräten auf die Anbieterzeile, um die Details vor **Verbinden** zu öffnen. Agent-Apps finden Sie unter **Tools verbinden**, Store-Anbieter unter **Shop betreiben**. Verwenden Sie für CJ die [Anleitung zur Lieferantenverbindung](/de/guides/apps-and-integrations/cj-dropshipping).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie Anbieter und aktuellen Status, bevor Sie die Einrichtung öffnen. Vorhandene Verbindungssteuerungen belegen keine neue Autorisierung.
## Lesen Sie die Karte vor dem Handeln
| Kartenzustand oder Steuerelement | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Ladeanzeige | Runner überprüft die gespeicherte Verbindung. | Warten Sie, bevor Sie eine andere Aktion auswählen. |
| **Verbinden** | Runner hat keine verwendbare Verbindung für diese App. | Öffnen Sie den Setup-Dialog oder den Anbieter-Autorisierungsablauf. |
| **Verbindung wird hergestellt...** | Eine Verbindungsanfrage ist in Bearbeitung. | Beenden Sie den Anbieterablauf oder warten Sie auf ein Ergebnis von Runner. |
| **Verbunden** | Runner erkennt eine verwendbare Verbindung. | Verwenden Sie sein Verwaltungs- oder Trennungssteuerelement, wenn Sie eine Änderung benötigen. |
| **Verwalten** | Die verbundene Agent-App hat konfigurierbare Werkzeuge. | Öffnen Sie die App-Details und überprüfen Sie den Werkzeugzugriff. |
| **Erneut verbinden** | Autorisierung fehlt, ist abgelaufen oder benötigt anderweitig Aufmerksamkeit. | Starten Sie die Autorisierung erneut. Nehmen Sie nicht an, dass die alte Verbindung noch funktioniert. |
| **Überprüfung ausstehend** | Stripe hat das Konto, hat es aber noch nicht bereit gemacht. | Folgen Sie dem Status oder der Aktionsmitteilung; das Label ist keine Connect-Schaltfläche. |
| **Onboarding fortsetzen** | Stripe benötigt noch Informationen. | Setzen Sie das vorhandene Setup fort, anstatt ein anderes Konto zu erstellen. |
| Löschen oder **Trennen** | Eine Verbindung kann entfernt werden. | Lesen und bestätigen Sie die anbieterspezifische Auswirkung. |
## Eine Verbindung herstellen oder reparieren
1. Öffnen Sie **Apps** und suchen Sie die App.
2. Wählen Sie **Verbinden**.
3. Füllen Sie nur die angezeigten Felder aus. Je nach App sind dies eine Shop-Domain, ein API-Schlüssel, Schlüssel und Geheimwert, Anbieterzugangsdaten oder eine externe Autorisierung.
4. Schließen Sie den Anbieterschritt ab und kehren Sie zu Apps zurück.
5. Prüfen Sie, ob die Karte einen Verbindungsstatus oder die Verwaltungsfunktionen des verbundenen Anbieters zeigt. Ein geschlossenes Dialog- oder Anbieterfenster beweist keinen Erfolg.
6. Wenn **Erneut verbinden** oder **Onboarding fortsetzen** erscheint, wählen Sie diese Aktion und setzen Sie die vorhandene Verbindung fort.
## Nur trennen, wenn Sie den Zugriff entfernen möchten
1. Wählen Sie zum Entfernen die Trennfunktion, lesen Sie die Bestätigung und wählen Sie **Trennen** oder **Bestätigen** nur, wenn die genannten Auswirkungen auf den gesamten Arbeitsbereich beabsichtigt sind.
2. Öffnen Sie Apps erneut und prüfen Sie den getrennten Zustand der Karte.
Die Aufnahme öffnet und schließt die leeren Formulare für Shippo, 4PX und Shopify. Es werden keine Zugangsdaten eingegeben und keine Anbieter verbunden.
## Store-Anbieter und Agent-Apps unterscheiden
Die Anbieter unter **Shop betreiben** haben jeweils eigene Steuerelemente:
- **E-Mail** verwendet einen Ein-/Ausschalter.
- **Stripe** kann Funktionen für Onboarding, Prüfung, erforderliche Aktionen, Dashboard und Trennung anzeigen.
- **Shippo**, **4PX** und **Shopify** fragen nach ihren jeweiligen Einrichtungsdaten und zeigen vor dem Trennen eine Bestätigung.
## Verbindungssicherheit
- Behandeln Sie Anbieterschlüssel und Geheimwerte wie Passwörter.
- Prüfen Sie, ob eine Verbindung zum Arbeitsbereich oder nur zum aktuellen Projekt gehört.
- Ein abgeschlossener Vorgang im Anbieterfenster garantiert kein nutzbares Ergebnis in Runner.
- Trennen Sie während des laufenden Store-Betriebs keinen Versand-, Zahlungs-, E-Mail- oder Fulfillment-Anbieter, ohne die Warnung und aktuelle Bestellungen zu prüfen.
- Aktualisieren Sie bei einem Trennfehler die Ansicht und prüfen Sie den aktuellen Status vor einem erneuten Versuch. Gehen Sie nicht davon aus, dass der Anbieter entfernt wurde.
## Verwandte Anleitungen
- [Apps und Integrationen – Übersicht](../apps-and-integrations)
- [Agent Apps verbinden und steuern](./agent-apps)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
---
# Store-E-Mail aktivieren
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/resend-email
Die **E-Mail** Store App ermöglicht transaktionale Nachrichten von Ihrem Store, wenn der E-Mail-Dienst für den Workspace verfügbar ist. Verwenden Sie es für Store-Ereignisse, die eine automatisierte Kundennachricht benötigen, anstatt einer manuellen Kampagne.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Apps → Shop betreiben → E-Mail**
Die Karte ist in Runner mit **E-Mail** gekennzeichnet. Sie geben in diesem Ablauf keinen Resend API-Schlüssel ein. Die Verfügbarkeit kann je nach Workspace-Konfiguration, Store-Bereitschaft und E-Mail-Unterstützung variieren.
Vor der Aktivierung:
- bestätigen Sie, dass Sie im beabsichtigten Workspace arbeiten;
- überprüfen Sie den kundenorientierten E-Mail-Inhalt des Stores, wo dieser Editor verfügbar ist; und
- planen Sie, die vollständige E-Mail-Journey mit einer Adresse zu überprüfen, die Sie kontrollieren.
Wählen Sie auf Mobilgeräten zuerst die Anbieterzeile **E-Mail**, um die Details zu öffnen. Verwenden Sie dann die Steuerelemente im Dialog. Ein sichtbares Einrichtungsformular zeigt nur den Einstieg; die folgenden Verbindungs- und Anbieterschritte gelten erst nach Ihrer Autorisierung.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Suchen Sie **E-Mail** unter **Shop betreiben**. Diese Übersicht zeigt den Einstieg. Es wurden weder E-Mail-Einstellungen geändert noch Nachrichten an Kunden gesendet.
## E-Mail-Steuerelemente und Ergebnisse
| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| Ladeanzeige | Verhindert Änderungen, bevor Runner den gespeicherten Zustand kennt. | Der Schalter wird angezeigt, nachdem die aktuelle Einstellung geladen wurde. |
| E-Mail-Schalter aus | Zeigt, dass Kunden keine E-Mail-Updates mehr von Ihrem Shop erhalten. | Das Einschalten erstellt oder aktiviert die Workspace-E-Mail-Verbindung. |
| E-Mail-Schalter an | Zeigt, dass Runner die E-Mail-Integration aktiviert hat. | Das Ausschalten trennt die Integration. |
| Schalter-Ladezustand | Zeigt, dass die Änderung gespeichert wird. | Weitere Änderungen warten, bis Runner erfolgreich ist oder fehlschlägt. |
| Erfolgsmeldung | Bestätigt, dass Runner die Einstellungsänderung akzeptiert hat. | Der Schalter bleibt im neuen Zustand. |
| Fehlermeldung | Zeigt, dass Runner E-Mail nicht aktivieren oder deaktivieren konnte. | Der Schalter kehrt zum gespeicherten Zustand zurück, damit Sie es erneut versuchen können. |
## E-Mail aktivieren
1. Öffnen Sie **Projekt → Apps**.
2. Suchen Sie **E-Mail** unter **Shop betreiben**.
3. Aktivieren Sie den Schalter.
4. Warten Sie auf **Kunden erhalten jetzt E-Mail-Updates von Ihrem Shop.** und prüfen Sie, ob der Schalter eingeschaltet bleibt.
5. Falls Runner an anderer Stelle eine neue Veröffentlichung verlangt, veröffentlichen Sie vor dem Live-Test die aktuelle Store-Version.
6. Lösen Sie mit geeigneten Testdaten ein Store-Ereignis aus und prüfen Sie den Nachrichteneingang.
## E-Mail ausschalten
Schalten Sie den Schalter nur aus, nachdem Sie überprüft haben, ob andere Stores im Workspace auf die gleiche Verbindung angewiesen sind. Runner zeigt **Kunden erhalten keine E-Mail-Updates mehr von Ihrem Shop.** an, nachdem die Änderung erfolgreich ist. Wenn das Speichern fehlschlägt, zeigt Runner einen Fehler an und stellt den vorherigen Zustand wieder her.
Das Deaktivieren der Integration beschreibt nicht, was mit bereits gesendeten Nachrichten geschieht. Es ändert nur, ob Runner die aktuelle E-Mail-Verbindung für zukünftige Store-Ereignisse verwenden kann.
## Wenn E-Mail nicht funktioniert
- Wenn die Karte weiterhin geladen wird, aktualisieren Sie Apps, bevor Sie den Schalter erneut ändern.
- Wenn das Aktivieren fehlschlägt, überprüfen Sie, dass E-Mail für den Workspace verfügbar ist, und versuchen Sie es einmal erneut.
- Wenn der Schalter an ist, aber keine Nachricht ankommt, überprüfen Sie das Store-Ereignis, die Empfängeradresse, die Nachrichtenkonfiguration und die neueste veröffentlichte Version.
- Überprüfen Sie Spam oder Filterung mit einer Adresse, die Sie kontrollieren; testen Sie nicht mit der Bestellung eines echten Kunden.
- Wenn das Deaktivieren fehlschlägt, nehmen Sie an, dass der vorherige Zustand noch aktiv ist.
## Verwandte Anleitungen
- [App verbinden, verwalten und erneut verbinden](./connect-manage-reconnect)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
- [Apps und Integrationen – Übersicht](../apps-and-integrations)
---
# Shippo für Versand verbinden
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/shippo-shipping
Verbinden Sie Shippo, wenn Sie möchten, dass Runner Ihr Shippo-Konto für Versand und Fulfillment verwendet. Die Verbindung verwendet einen API-Schlüssel, der von Shippo bereitgestellt wird.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Apps → Shop betreiben → Shippo**
Sie benötigen:
- ein Shippo-Konto und einen aktuellen Shippo API-Schlüssel;
- die Berechtigung, dieses Konto mit diesem Runner-Shop zu verbinden; und
- das Bewusstsein, dass das Trennen von Shippo seinen Schlüssel entfernt und es nur für diesen Shop deaktiviert. Andere Shops behalten ihre eigene Shippo-Verbindung.
Fügen Sie den API-Schlüssel nicht in den Chat oder die Dokumentation ein.
Wählen Sie auf Mobilgeräten zuerst die Anbieterzeile **Shippo**, um die Details zu öffnen. Verwenden Sie dann die Steuerelemente im Dialog. Ein sichtbares Einrichtungsformular zeigt nur den Einstieg; die folgenden Verbindungs- und Anbieterschritte gelten erst nach Ihrer Autorisierung.
## Shippo-Steuerelemente und Ergebnisse
| Steuerelement | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Verbinden** | Öffnet das Shippo-Setup. | Runner fragt nach dem **Shippo-API-Schlüssel**. |
| **Shippo-API-Schlüssel** | Identifiziert Ihr Shippo-Konto. | Runner überprüft das Schlüsselformat und zeigt einen Fehler an, während der Wert ungültig ist. |
| Augensymbol | Ermöglicht es Ihnen, den Wert auf Tippfehler zu überprüfen. | Schaltet das Feld zwischen verborgenem und sichtbarem Text um. Blenden Sie es erneut aus, bevor Sie Ihren Bildschirm freigeben. |
| Dialog **Verbinden** | Reicht den Schlüssel ein. | Bei Erfolg schließt Runner den Dialog, löscht das Feld und ändert die Karte in verbunden. |
| **Abbrechen** oder schließen | Beendet das Setup ohne Einreichung. | Runner löscht den eingegebenen Schlüssel aus dem Dialog. |
| Löschen oder **Trennen** | Startet die Entfernung. | Runner öffnet **Shippo trennen?** für diesen Shop. |
| Bestätigung **Trennen** | Entfernt die Verbindung dieses Shops. | Runner entfernt den API-Schlüssel aus diesem Shop und deaktiviert Shippo dafür. Andere Shops sind nicht betroffen. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg2lkPdDEah7FSPqAV903v8Lem6fdQJcxZEiXo)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Das leere Formular zeigt, wo der Shippo-Schlüssel eingetragen wird. Wählen Sie **Abbrechen**, um ohne Zugangsdaten zu senden zu schließen. Prüfen Sie Versandvorgänge nach dem Verbinden separat.
## Verbinden Sie Shippo
1. Öffnen Sie **Projekt → Apps**.
2. Suchen Sie **Shippo** und wählen Sie **Verbinden**.
3. Kopieren Sie den API-Schlüssel aus dem Shippo-Konto, das Sie verwenden möchten.
4. Fügen Sie ihn in **Shippo-API-Schlüssel** ein.
5. Wenn Runner einen ungültigen Schlüssel meldet, kehren Sie zu Shippo zurück und kopieren Sie ihn erneut, anstatt das Geheimnis durch Vermutung zu bearbeiten.
6. Wählen Sie **Verbinden** im Dialog.
7. Warten Sie auf die Erfolgsmeldung und bestätigen Sie, dass die Karte ihr verbundenes Trennungssteuerelement anzeigt.
8. Verwenden Sie sichere Testdaten, um den Versand-Workflow zu überprüfen, bevor Sie sich darauf für Kundenbestellungen verlassen.
## Trennen oder ersetzen Sie den Schlüssel
Wählen Sie das Trennungssteuerelement der Karte und lesen Sie **Shippo trennen?**. Bestätigen Sie nur, wenn es akzeptabel ist, den Schlüssel zu entfernen und Shippo für diesen Shop zu deaktivieren. Andere Shops im Workspace behalten ihre eigene Verbindung.
Um einen anderen Schlüssel zu verwenden, trennen Sie die aktuelle Integration, bestätigen Sie, dass die Karte nicht mehr verbunden ist, und schließen Sie dann den Verbindungs-Workflow mit dem Ersatzschlüssel ab.
## Wenn Shippo nicht verbunden wird
- **Ungültiger API-Schlüssel** bedeutet, dass der Wert nicht dem akzeptierten Shippo-Schlüsselformat entspricht.
- **Fehler beim Verbinden von Shippo** bedeutet, dass Runner den Anbieter-Verbindung nicht abgeschlossen hat. Halten Sie den Schlüssel privat, bestätigen Sie, dass er in Shippo aktuell ist, und versuchen Sie es erneut von der Karte.
- Wenn der Dialog geschlossen wird, aber die Karte nicht verbunden wird, aktualisieren Sie Apps, bevor Sie erneut einreichen.
- Wenn das Trennen fehlschlägt, nehmen Sie an, dass der vorhandene Schlüssel noch aktiv ist.
- Eine verbundene Karte beweist nicht, dass Tarife, Etiketten, Spediteure oder eine bestimmte Sendung funktionieren. Überprüfen Sie diese Operationen separat mit sicheren Testdaten.
## Verwandte Anleitungen
- [App verbinden, verwalten und erneut verbinden](./connect-manage-reconnect)
- [4PX Fulfillment verbinden](./4px-fulfillment)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
---
# Shopify verbinden
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/shopify
Verbinden Sie Shopify, wenn Ihre Storefront oder Runner-Workflow Zugriff auf einen vorhandenen Shopify-Store benötigt. Runner startet die Autorisierung von der `myshopify.com`-Domain des Stores und Shopify fordert Sie auf, die Runner-App zu installieren und zu autorisieren.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Apps → Shop betreiben → Shopify**
Sie können auch **Shopify verbinden** wählen, wenn Sie einen Store aus dem Workspace erstellen. Diese Anleitung konzentriert sich auf die Verbindungskarte unter Apps.
Sie benötigen:
- Shopify-Integrationsverfügbarkeit im Workspace;
- eine Shopify-Store-Domain in der Form `your-store.myshopify.com`;
- die Berechtigung, die Runner-App in diesem Shopify-Store zu installieren und zu autorisieren; und
- die Berechtigung, den Store mit dem Runner-Workspace zu verbinden.
Ein Workspace, der bereits einen verbundenen Shopify-Store hat, kann Sie auffordern, ihn zu trennen, bevor Sie einen anderen verbinden.
Wählen Sie auf Mobilgeräten zuerst die Anbieterzeile **Shopify**, um die Details zu öffnen. Verwenden Sie dann die Steuerelemente im Dialog. Ein sichtbares Einrichtungsformular zeigt nur den Einstieg; die folgenden Verbindungs- und Anbieterschritte gelten erst nach Ihrer Autorisierung.
## Shopify-Steuerelemente und Ergebnisse
| Steuerelement | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Verbinden** | Öffnet das Shopify-Setup. | Runner fragt nach **Shop-Domain**. |
| **Shop-Domain** | Identifiziert den genauen Shopify-Store. | Runner akzeptiert das `your-store.myshopify.com`-Format und zeigt einen Fehler für eine ungültige Domain an. |
| **Zu Shopify fortfahren** | Startet die Anbieter-Autorisierung. | Runner leitet zu Shopify um, um die Runner-App zu installieren und den Zugriff zu autorisieren. |
| **Abbrechen** oder schließen | Stoppt vor der Autorisierung. | Runner schließt den Dialog und löscht die eingegebene Domain. |
| **Verbindung wird hergestellt...** | Zeigt, dass die Autorisierungsumleitung startet. | Die Aktion bleibt nicht verfügbar, während Runner zu Shopify geht. |
| Löschen oder **Trennen** | Startet die Entfernung. | Runner öffnet **Shopify trennen?**. |
| Bestätigung **Trennen** | Entfernt die Shopify-Verbindung von Runner. | Runner entfernt das Shopify-Storefront-Token aus allen Workspace-Projekten. Der Shopify-Store und seine Bestellungen werden nicht gelöscht. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgzy8MJHxvQbMAZ2hlg7w6ye8S5vnLIHkGPOqr)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Geben Sie die permanente Shopify-Domain ein, wenn Sie den Zugriff autorisieren möchten. Dieses Beispiel endet vor **Weiter zu Shopify**.
## Verbinden Sie Shopify
1. Öffnen Sie **Projekt → Apps** und suchen Sie **Shopify**.
2. Wählen Sie **Verbinden**.
3. Geben Sie die genaue `myshopify.com`-Domain des Stores in **Shop-Domain** ein.
4. Korrigieren Sie alle ungültige-Domain-Meldungen, bevor Sie fortfahren.
5. Wählen Sie **Zu Shopify fortfahren**.
6. Überprüfen Sie auf Shopify den Store-Namen und den angeforderten Zugriff, bevor Sie die Runner- App autorisieren.
7. Kehren Sie zu Runner zurück und bestätigen Sie, dass die Shopify-Karte ihr verbundenes Trennungssteuerelement anzeigt.
8. Überprüfen Sie die beabsichtigten Store-Daten und den Checkout-Pfad, bevor Sie Live-Änderungen vornehmen.
## Trennen oder Stores wechseln
Wählen Sie das Trennungssteuerelement und lesen Sie **Shopify trennen?**. Das Bestätigen entfernt das Shopify-Storefront-Token aus allen Projekten im Workspace. Es löscht nicht den Shopify-Store oder vorhandene Shopify-Bestellungen.
Um einen anderen Shopify-Store zu verbinden, trennen Sie zuerst die vorhandene Workspace-Verbindung, bestätigen Sie, dass die Karte nicht mehr verbunden ist, und wiederholen Sie dann das Setup mit der Domain des anderen Stores.
## Wenn Shopify nicht verbunden wird
- Verwenden Sie die permanente `myshopify.com`-Domain, nicht eine benutzerdefinierte Storefront-Domain.
- Wenn Runner sagt, dass der Workspace bereits einen verbundenen Store hat, überprüfen Sie diese Verbindung bevor Sie sie entfernen.
- Wenn Shopify die Autorisierung ablehnt, starten Sie erneut von der Shopify-Karte.
- Wenn der zurückgegebene Store nicht der Domain entspricht, die Sie eingegeben haben, stoppen Sie und überprüfen Sie, welcher Shopify-Account und Store offen sind.
- Wenn der Verbindungslink abgelaufen ist, starten Sie erneut von **Verbinden**, anstatt die alte Anbieter-Seite wiederzuverwenden.
- Wenn Runner meldet, dass erforderlicher Zugriff fehlt, überprüfen Sie die App-Berechtigungen in Shopify.
- Wenn das Trennen fehlschlägt, nehmen Sie an, dass die vorhandene Verbindung noch aktiv ist.
## Verwandte Anleitungen
- [App verbinden, verwalten und erneut verbinden](./connect-manage-reconnect)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
- [Apps und Integrationen – Übersicht](../apps-and-integrations)
---
# Stripe für Zahlungen verbinden
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/stripe-payments
Verbinden Sie Stripe, wenn Sie möchten, dass ein veröffentlichter Runner-Shop Kundenzahlungen akzeptiert. Runner zeigt den Verbindungszustand an, während Stripe die Geschäftsinformationen sammelt und überprüft, die für Zahlungs- und Auszahlungszugriff erforderlich sind.
## Bevor Sie beginnen
**Einstiegspfad:** **Projekt → Apps → Shop betreiben → Stripe**
Nach der Veröffentlichung kann Runner in der Shop-Übergabe auch **Stripe verbinden** anzeigen. Diese Schaltfläche öffnet denselben Einrichtungsablauf für Zahlungen.
Sie benötigen:
- die Berechtigung, die Verbindung des Arbeitsbereichs zu verwalten;
- die Geschäfts- und Identitätsinformationen, die Stripe anfordert; und
- einen Browser, der das Stripe-Setup-Fenster öffnen lässt.
Die Storefront kann veröffentlicht werden, während der Checkout noch pausiert oder überprüft wird. Eine Live- Shop-URL ist kein Beweis dafür, dass Zahlungen verfügbar sind.
Wählen Sie auf Mobilgeräten zuerst die Anbieterzeile **Stripe**, um die Details zu öffnen. Verwenden Sie dann die Steuerelemente im Dialog. Ein sichtbares Einrichtungsformular zeigt nur den Einstieg; die folgenden Verbindungs- und Anbieterschritte gelten erst nach Ihrer Autorisierung.
## Stripe-Steuerelemente und Ergebnisse
| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **Verbinden** | Startet das Zahlungs-Onboarding. | Runner öffnet einen von Stripe gehosteten Setup-Ablauf in einem neuen Fenster. |
| **Verbindung wird hergestellt...** | Zeigt, dass Runner das Stripe-Konto oder den Setup-Link vorbereitet. | Die Aktion bleibt deaktiviert, bis Runner ein Ergebnis zurückgibt. |
| **Erneut verbinden** | Setzt ein Konto fort, das existiert, aber nicht bereit ist. | Runner öffnet einen frischen Onboarding-Link für das vorhandene Konto. |
| **Prüfung läuft** | Zeigt, dass Stripe eingereichte Angaben prüft. | Die Beschriftung ist informativ; folgen Sie allen separaten Aktionshinweisen. |
| **Stripe-Aktionen erforderlich** | Listet Angaben oder Prüfungen auf, die Ihre Aufmerksamkeit erfordern. | Prüfen Sie die Details unter **Jetzt fällig**, **Später fällig**, **In Prüfung**, **Zahlungen pausiert** oder **Auszahlungen pausiert**. |
| **Onboarding fortsetzen** | Schließt ausstehende Stripe-Anforderungen ab. | Runner öffnet Stripe für das vorhandene Konto. |
| Symbol **Stripe-Dashboard öffnen** | Ermöglicht die Verwaltung eines aktivierten Kontos bei Stripe. | Öffnet das verbundene Stripe-Dashboard in einem neuen Tab. |
| Löschsymbol | Startet die Trennung. | Öffnet **Stripe trennen?** anstatt es sofort zu entfernen. |
| **Trennen** | Bestätigt die Entfernung aus Runner. | Runner entfernt die Stripe-Integration aus dem Workspace und allen zugehörigen Projekten. Bestehende Bestellungen bleiben erhalten, aber neue Checkout-Zahlungen können ausfallen, bis eine nutzbare Zahlungsverbindung wiederhergestellt ist. |
## Verbinden Sie Stripe
1. Öffnen Sie **Projekt → Apps**.
2. Suchen Sie **Stripe** unter **Shop betreiben**.
3. Wählen Sie **Verbinden**. Runner öffnet Stripe in einem neuen Fenster.
4. Führen Sie nur die von Stripe angezeigten Schritte aus.
5. Kehren Sie zu Runner zurück und öffnen Sie Apps erneut.
6. Prüfen Sie, ob die Karte Verwaltungsfunktionen der Verbindung zeigt und Runner die Zahlungseinrichtung als bereit meldet, bevor Sie Zahlungen im Checkout erwarten.
7. Folgen Sie bei **Erneut verbinden**, **Onboarding fortsetzen**, **Prüfung läuft** oder **Stripe-Aktionen erforderlich** dem jeweiligen Status, statt neu zu beginnen.
8. Testen Sie den Live-Checkout erst, wenn Runner die Zahlungsbereitschaft meldet.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgdRbFueMh3McYFndyrWQxNbi4IRHOVuEC8JtX)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Diese Verwaltungsfunktionen können bei einer vorhandenen Verbindung erscheinen. Der Screenshot zeigt, wo Sie die Verbindung prüfen; er bestätigt weder Checkout noch Zahlungen oder Auszahlungen.
## Verstehen Sie das Ergebnis
| Zustand | Was es für Sie bedeutet |
| --- | --- |
| Nicht verbunden | Der Checkout benötigt noch einen Zahlungsanbieter. |
| Erneute Verbindung erforderlich | Ein Stripe-Konto existiert, aber seine Autorisierung oder sein Onboarding ist unvollständig. |
| Prüfung läuft | Stripe hat Angaben erhalten, das Konto aber noch nicht freigegeben. |
| Aktionen erforderlich | Stripe benötigt spezifische Informationen, oder Zahlungen oder Auszahlungen können pausiert sein. |
| Verbunden | Runner erkennt die Stripe-Verbindung. Überprüfen Sie den Live-Checkout, bevor Sie ankündigen, dass Zahlungen verfügbar sind. |
## Trennen oder erneut verbinden
Um die Verbindung zu trennen, wählen Sie das Löschsymbol, lesen Sie **Stripe trennen?** und wählen Sie dann **Trennen**. Runner entfernt die Integration aus dem Workspace und allen zugehörigen Projekten. Bestehende Bestellungen bleiben erhalten; neue Checkout-Zahlungen können jedoch ausfallen, bis eine nutzbare Zahlungsverbindung wiederhergestellt wurde.
Um erneut zu verbinden, wählen Sie **Erneut verbinden** oder **Onboarding fortsetzen**. Runner verwendet das vorhandene Konto, wenn möglich; erstellen Sie nicht einfach ein zweites Setup, weil das erste Anbieter-Fenster geschlossen wurde.
## Wenn Stripe nicht verbunden wird
- Falls sich das Einrichtungsfenster zu früh schließt, kehren Sie zu Apps zurück und wählen Sie **Erneut verbinden**.
- Erfüllen Sie bei **Stripe-Aktionen erforderlich** die aufgeführten Anbieteranforderungen.
- Starten Sie bei **Prüfung läuft** nicht wiederholt neue Onboarding-Vorgänge.
- Bei Verbindungs- oder Linkfehlern prüfen Sie zunächst, ob Ihr Browser neue Fenster zulässt, und versuchen es über die Stripe-Karte erneut.
- Senden Sie keine Ausweisdokumente, Konto-IDs oder Zahlungsdaten im Runner-Chat.
## Verwandte Anleitungen
- [App verbinden, verwalten und erneut verbinden](./connect-manage-reconnect)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)
- [Apps und Integrationen – Übersicht](../apps-and-integrations)
---
# App-Verbindungen beheben
Source: https://www.runnerai.com/docs/de/guides/apps-and-integrations/troubleshooting
Verwenden Sie diesen Leitfaden, wenn eine App nicht geladen wird, sich nicht verbindet, nicht erneut verbindet, ihren Werkzeugzugriff nicht speichert oder sich nicht wie erwartet trennt. Beginnen Sie mit dem Status, den Runner tatsächlich anzeigt, anstatt einen Anbieterablauf blind zu wiederholen.
**Eingabepfad:** **Projekt → Apps**
## Bevor Sie beginnen
1. Prüfen Sie, ob Apps für das beabsichtigte Projekt und den richtigen Arbeitsbereich geöffnet ist.
2. Leeren Sie **Tools suchen** und alle Kategoriefilter für Agent-Apps.
3. Aktualisieren Sie einmal und warten Sie auf die Verbindungszustände.
4. Lesen Sie den genauen Kartenstatus: **Verbinden**, **Verbindung wird hergestellt...**, **Verbunden**, **Erneut verbinden**, **Prüfung läuft** oder einen Handlungshinweis.
5. Öffnen Sie nur die zu diesem Zustand passende Wiederherstellungsaktion.
6. Nehmen Sie keine API-Schlüssel, Geheimwerte, Ausweisdokumente, Zahlungsdaten oder vollständigen Anbieter-Callback-URLs in Supportnachrichten oder Screenshots auf.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgJFpud5MziL9zFEdkGCVveD1jTZUlSay3IctK)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Die Suche grenzt den Tool-Katalog ein. Leeren Sie Suche und Filter, bevor Sie eine fehlende App anfragen. Ein Suchergebnis ist keine autorisierte Verbindung.
## Wichtige Steuerelemente und Ergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| **Suche löschen** | Entfernt die aktuelle Agent Apps-Suche, damit der verfügbare Katalog wieder angezeigt werden kann. |
| **Verbinden** / **Verbinden & Autorisieren** | Öffnet den Setup- oder externen Autorisierungsablauf für diese App. |
| **Erneut verbinden**, wenn angezeigt | Startet die Autorisierung für eine vorhandene Anbieterverbindung neu. |
| **Erneut versuchen** | Wiederholt die fehlgeschlagene Katalog-, Werkzeuglisten- oder Verbindungsanfrage, die im aktuellen Bereich angezeigt wird. |
| **Onboarding fortsetzen** | Kehrt zum vorhandenen Stripe-Onboarding-Ablauf zurück, wenn eine Maßnahme erforderlich ist. |
| **Trennen** | Öffnet eine Bestätigung oder startet den dokumentierten Entfernungsablauf; überprüfen Sie den gespeicherten Status, bevor Sie Anbieter-seitige Anmeldedaten ändern. |
## Symptom- und Wiederherstellungstabelle
| Was Sie sehen | Wahrscheinliche Bedeutung | Sichere nächste Maßnahme |
| --- | --- | --- |
| App fehlt | Suche, eine Kategorie, Arbeitsbereichszugriff oder eine bedingte Funktion versteckt sie. | Löschen Sie die Suche, wählen Sie **Alle**, und bestätigen Sie dann, dass die Funktion für diesen Arbeitsbereich verfügbar ist. |
| Karte wird ständig geladen | Runner hat die gespeicherte Verbindung nicht aufgelöst. | Aktualisieren Sie Apps einmal. Vermeiden Sie das Absenden einer weiteren Verbindung, während der Status unbekannt ist. |
| **Keine Apps gefunden** | Keine Agent App entspricht den aktuellen Filtern. | Wählen Sie **Suche löschen**. |
| **Verbinden** funktioniert nicht | Ein erforderliches Feld ist leer oder ungültig, oder der Anbieterablauf konnte nicht gestartet werden. | Lesen Sie Feldfehler, kopieren Sie den erforderlichen Wert erneut, und erlauben Sie Anbieter-Popups, falls zutreffend. |
| **Wird verbunden...** wird nicht beendet | Die externe Autorisierung wurde geschlossen, blockiert oder hat nie ein Ergebnis zurückgegeben. | Kehren Sie zu Apps zurück, aktualisieren Sie den Status, und verwenden Sie dann **Erneut verbinden**, wenn Runner es anbietet. |
| Anbieter sagt Erfolg, aber Runner nicht | Runner hat eine verwendbare Verbindung nicht bestätigt. | Öffnen Sie Apps erneut. Behandeln Sie nur **Verbunden** als Erfolg; verwenden Sie **Erneut verbinden**, anstatt Duplikate zu erstellen. |
| **Erneut verbinden** | Vorhandene Autorisierung benötigt Aufmerksamkeit. | Wählen Sie es aus und führen Sie den Anbieterablauf erneut aus. |
| **Überprüfung ausstehend** | Stripe überprüft eingereichte Details. | Folgen Sie Aktionsbenachrichtigungen; starten Sie nicht einfach ein anderes Konto, um das Label zu entfernen. |
| **Stripe-Maßnahmen erforderlich** | Stripe benötigt Informationen oder hat eine Funktion angehalten. | Überprüfen Sie **Jetzt fällig**, **Später fällig**, **Wird überprüft**, Zahlungs- und Auszahlungsbenachrichtigungen, und verwenden Sie dann **Onboarding fortsetzen**, wenn angezeigt. |
| API-Schlüssel oder Geheimnis abgelehnt | Der Wert ist falsch, abgelaufen, aus dem falschen Konto oder wird für diese Integration nicht akzeptiert. | Kopieren Sie ihn erneut vom Anbieter. Bearbeiten Sie Geheimnisse nicht durch Vermutungen. |
| Shopify-Domäne ungültig | Der Wert ist nicht die permanente Shopify-Store-Domäne. | Verwenden Sie `your-store.myshopify.com`, nicht eine benutzerdefinierte Storefront-Domäne. |
| Agent App-Autorisierungsfenster ist blockiert | Der Browser hat den externen Ablauf verhindert. | Erlauben Sie Popups für Runner und starten Sie **Verbinden & Autorisieren** erneut. |
| Agent App-Werkzeuge können nicht geladen werden | Runner konnte die Werkzeugliste dieser App nicht abrufen. | Wählen Sie **Erneut versuchen** in **App-Details**. |
| Werkzeugschalter meldet Fehler | Die neue Werkzeugeinstellung wurde nicht gespeichert. | Warten Sie, bis sich der Schalter aktualisiert, bestätigen Sie seinen aktuellen Status, und versuchen Sie es dann einmal erneut. |
| Trennung meldet Fehler | Runner hat die Entfernung nicht bestätigt. | Gehen Sie davon aus, dass die vorhandene Verbindung noch aktiv ist, und öffnen Sie Apps erneut, bevor Sie es erneut versuchen. |
## Anbieter-spezifische Überprüfungen
### Stripe
- Setzen Sie einen vorhandenen Onboarding-Versuch mit **Erneut verbinden** oder **Onboarding fortsetzen** fort.
- Lesen Sie Aktionsanforderungen, anstatt sich nur auf die Kartenfarbe zu verlassen.
- Ein veröffentlichtes Storefront kann immer noch Zahlungen angehalten oder nicht verfügbar haben.
- Verwenden Sie die Stripe-Dashboard-Aktion nur, nachdem Runner ein zugeordnetes Konto hat.
### E-Mail
- Ein fehlgeschlagener Schalterwechsel kehrt zum gespeicherten Zustand zurück.
- Ein aktivierter Schalter beweist nicht, dass eine bestimmte E-Mail zugestellt wurde.
- Prüfen Sie Store-Ereignis, Empfänger, E-Mail-Konfiguration und veröffentlichte Version mit geeigneten Testdaten.
### Shippo
- Kopieren Sie den Shippo API-Schlüssel erneut vom beabsichtigten Konto.
- Eine verbundene Karte überprüft nicht Tarife, Spediteure, Etiketten oder Sendungserstellung.
### Shopify
- Verwenden Sie die permanente `myshopify.com`-Domain.
- Prüfen Sie eine vorhandene Store-Verbindung des Arbeitsbereichs, bevor Sie sie trennen.
- Starten Sie die Autorisierung erneut, wenn der Link abläuft oder der zurückgegebene Store nicht zur eingegebenen Domain passt.
### CJ Dropshipping
- Prüfen Sie, ob der API-Schlüssel zum vorgesehenen CJ-Konto gehört.
- Nach dem Trennen bleiben vom Händler autorisierte CJ-Suche, Importe, Checkout und Lieferantenvorgänge gesperrt, bis wieder eine gültige Verbindung besteht.
- Verbinden Sie dasselbe CJ-Konto erneut und prüfen Sie vorhandene Importe. Stimmen Lieferantenidentität oder Live-Daten eines Artikels nicht mehr, entfernen Sie ihn und importieren Sie ihn erneut.
### 4PX
- Bestätigen Sie, dass der API-Schlüssel und das Geheimnis zum selben Konto gehören und sich in den richtigen Feldern befinden.
- Eine verbundene Karte beweist nicht, dass ein Ziel oder eine Bestellung für die Erfüllung berechtigt ist.
### Agent-Apps
- Der gesamte Bereich oder einzelne Apps können bedingt nicht verfügbar sein.
- Leeren Sie die Filter, bevor Sie eine App als fehlend betrachten.
- Prüfen Sie vor dem erneuten Verbinden die Tool-Schalter. Gewähren Sie keinen zusätzlichen Zugriff nur für eine einfachere Einrichtung.
## Trennung fehlgeschlagen oder erzeugte ein unsicheres Ergebnis
1. Lassen Sie Anbieterkonto und laufenden Store-Betrieb unverändert.
2. Öffnen Sie **Projekt → Apps** erneut und prüfen Sie den Kartenstatus.
3. Zeigt die Karte weiterhin Verbunden, behandeln Sie die Verbindung als aktiv.
4. Löschen Sie Anbieterzugangsdaten erst, wenn geklärt ist, ob Checkout, E-Mail, Versand, Lieferanten- oder Fulfillment-Vorgänge davon abhängen.
5. Wiederholen Sie das Trennen in Runner erst, wenn der Zustand eindeutig ist.
## Sicher um Hilfe bitten
Bereitstellen:
- den App-Namen;
- den genauen sichtbaren Status und Fehlertext;
- ob das Problem beim Verbinden, Zurückkehren, Verwalten von Werkzeugen oder Trennen auftritt;
- die Projekt-URL ohne geheime Abfragewerte; und
- einen datenschutzfreundlichen Screenshot, wenn er das Problem wesentlich zeigt.
Geben Sie nicht den tatsächlichen API-Schlüssel, das Geheimnis, das Anbieter-Passwort, das Identitätsdokument, Zahlungsdetails, Kundendaten oder versteckte Autorisierungsparameter an.
Wenn das gewünschte Tool nach dem Leeren von Suche und Filtern weiterhin fehlt, wählen Sie **App anfragen** oder **Diese App anfragen** im leeren Ergebnis. Das Formular fragt Anbieterunterstützung an; es verbindet den Anbieter nicht. Öffnen Sie für CJ-Verbindungsprobleme die [Dropshipping-Lieferanteneinrichtung](/de/guides/apps-and-integrations/cj-dropshipping).
## Verwandte Leitfäden
- [Apps und Integrationen – Übersicht](../apps-and-integrations)
- [Verbinden, verwalten und erneut verbinden einer App](./connect-manage-reconnect)
- [Verbinden und Steuern von Agent Apps](./agent-apps)
---
# Automatisieren, testen und erstellen
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create
Unter **Wachstum** finden Sie Automatisierungen, Creative Studio, Medienbibliothek und Ads. Unter **Messen** finden Sie Simulation und Experimente. Diese Anleitungen führen von der Einrichtung bis zur Prüfung der Ergebnisse.
> **Verfügbarkeit:** Jede Funktion in diesem Abschnitt kann von einem Plan, Workspace-Zugriff, Rolle, Store-Status, Credits, Daten oder Provider-Verbindung abhängen. Ein fehlender Eintrag ist ein Verfügbarkeitszustand, kein Beweis dafür, dass das Projekt beschädigt ist.
| Ziel | Beginnen Sie hier |
| --- | --- |
| Wiederkehrende Arbeiten finden und verstehen | [Automatisierungen](/de/guides/automate-test-and-create/automations) |
| Eine Automatisierung aktivieren oder ihre E-Mail anpassen | [Automatisierungen erstellen und verwalten](/de/guides/automate-test-and-create/create-and-manage-automations) |
| Einen Käufertest oder, falls verfügbar, eine Kampagnenprognose einrichten | [Simulationen](/de/guides/automate-test-and-create/simulations) |
| Journeys, Trichter, Ergebnisse und Empfehlungen lesen | [Simulationsdurchläufe und Ergebnisse](/de/guides/automate-test-and-create/simulation-runs-and-results) |
| Ein kontrolliertes Store-Experiment starten | [Experimente](/de/guides/automate-test-and-create/experiments) |
| Leistung lesen und entscheiden, was angewendet werden soll | [Experimentmessung](/de/guides/automate-test-and-create/experiment-measurement) |
| Bilder und Videos generieren oder bearbeiten | [Creative Studio](/de/guides/automate-test-and-create/creative-studio) |
| Generierte Medien finden und wiederverwenden | [Medienbibliothek](/de/guides/automate-test-and-create/media-library) |
| Ad-Konten verbinden und Kampagnen verstehen | [Runner Ads](/de/guides/automate-test-and-create/runner-ads) |
| Creative-Leistung überprüfen und Inspiration speichern | [Ad-Creatives und Trends](/de/guides/automate-test-and-create/ad-creatives-and-trending) |
---
# Anzeigenkreative und Trends
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/ad-creatives-and-trending
Creatives hilft Ihnen, Medien aus verbundenen Kampagnen zu vergleichen, während Trending Ihnen hilft, öffentliche Anzeigeninspiration zu entdecken und zu organisieren.
> **Bedingt verfügbar:** Beide Seiten benötigen Zugang zu Runner Ads und einen passenden Tarif. Creative-Leistungsdaten benötigen ein unterstütztes verbundenes Konto und zurückgegebene Kampagnendaten. **Trends** kann die öffentliche Meta- oder TikTok-Bibliothek ohne Verbindung Ihres Werbekontos durchsuchen; die Ergebnisse hängen von der externen Quelle ab.
## Eingabepfade
- Store-Projekt → **Wachstum** → **Werbung** → **Creatives**.
- Store-Projekt → **Wachstum** → **Werbung** → **Trends**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEooJlJchdR6T0uwqnz73letZimQpFvYfSrhL)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Trending öffnet eine Suche in einer öffentlichen Bibliothek. Suchergebnisse und Leistungsdaten verbundener Kampagnen sind getrennte Datensätze.
## Bevor Sie beginnen
- Bestätigen Sie, dass der Arbeitsbereich und der Plan Runner Ads öffnen können.
- Verbinden Sie ein autorisiertes Google- oder Meta-Konto, bevor Sie Kreativ-Performance-Daten erwarten.
- Wählen Sie eine Leistungsfrage oder ein Inspirationsthema, damit Filter nützlich bleiben.
- Behandeln Sie externe Trend-Daten als Referenzmaterial, nicht als gemessenes Ergebnis Ihres Stores.
## Kreative Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| Zeitbereich | Aktualisiert kreative Metriken für die letzte Woche, den letzten Monat oder einen breiteren aktuellen Zeitraum. |
| Kontoauswahl | Filtert kreative Daten, wenn mehrere unterstützte Konten verbunden sind. |
| Sortieren | Ordnet Karten nach Ausgaben, Return on Ad Spend, Klicks, Impressionen, Umsatz, Klick-Score oder Konvertierungs-Score. |
| Metrik-Chips | Fügt Metriken auf kreativen Karten hinzu, entfernt oder ordnet sie neu an. |
| Kreative Karte | Öffnet die kreative Vorschau und verfügbare Leistungsdetails. |
## Überprüfen Sie verbundene Kreative
1. Öffnen Sie **Anzeigen** → **Kreative**.
2. Wenn die Verbindungsaufforderung angezeigt wird, verbinden Sie zuerst das autorisierte Google- oder Meta-Konto.
3. Wählen Sie das Berichtsfenster und das Konto.
4. Wählen Sie die Sortierung, die Ihrer Frage entspricht.
5. Halten Sie eine kleine Anzahl von Metrik-Chips sichtbar, damit Vergleiche lesbar bleiben.
6. Öffnen Sie eine kreative Karte, um das Asset und seine verfügbaren Metriken zu überprüfen.
7. Vergleichen Sie mehrere Kreative, bevor Sie entscheiden, dass ein Bild oder Video das Ergebnis verursacht hat.
## Trend-Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| **Meta** / **TikTok** | Wechselt die externe Anzeigenbibliothek, die durchsucht wird. |
| Schlüsselwort **Suche** | Fordert Anzeigen an, die dem eingereichten Schlüsselwort entsprechen. |
| Land-, Medien-, Status- oder Zeitfilter | Grenzt die aktuelle Bibliothek ein, wenn von dieser Quelle unterstützt. |
| Sortieren | Ordnet Ergebnisse mit verfügbaren Aktualitäts-, Impressions-, Publikations- oder Reichweitensignalen neu an. |
| **Löschen** | Entfernt aktive Filter und kehrt zur Standard-Bibliotheksabfrage zurück. |
| Anzeigenkarte | Öffnet eine größere Vorschau mit den von der Quelle zurückgegebenen Details. |
| **Impressions-Index** in einem Meta-Detail | Zeigt den nicht-negativen Index an, der für diese externe Momentaufnahme bereitgestellt wird, wenn einer verfügbar ist. Es ist nicht die gemessene Kampagnenleistung Ihres Stores. |
| Stern / **In Sammlung speichern** | Öffnet vorhandene Sammlungen für die Anzeigen-Momentaufnahme. |
| **Neue Sammlung** | Erstellt eine benannte Sammlung und speichert die ausgewählte Anzeige nach Erfolg darin. |
| **Sammlungen** | Öffnet gespeicherte Inspiration; das Auswählen einer Sammlung zeigt ihre gespeicherten Anzeigen-Momentaufnahmen. |
| **Zurück zu Trends** | Kehrt von Sammlungen zur Erkennungsansicht zurück. |
## Speichern Sie Anzeigeninspiration
1. Öffnen Sie **Anzeigen** → **Trends**.
2. Wählen Sie **Meta** oder **TikTok**.
3. Suchen Sie nach einem Produkt, einer Zielgruppe oder einem Nachrichtenthema.
4. Grenzen Sie Ergebnisse mit nur den für die Frage erforderlichen Filtern ein.
5. Öffnen Sie eine Anzeige, um sie zu überprüfen.
6. Wählen Sie den Stern, um **In Sammlung speichern** zu öffnen.
7. Wählen Sie eine vorhandene Sammlung oder erstellen Sie eine klar benannte neue.
8. Öffnen Sie **Sammlungen**, um zu bestätigen, dass die Momentaufnahme gespeichert wurde.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Verbindungsaufforderung in Kreative | Kein unterstütztes Performance-Konto ist verbunden. Schließen Sie zuerst die Verbindung ab. |
| Leeres Kreativ-Raster | Das ausgewählte Konto, der Zeitraum oder der Anbieter hat keine Kreative zurückgegeben. Erweitern Sie den Filter und bestätigen Sie, dass Kampagnen vorhanden sind. |
| Leere Trend-Ergebnisse | Löschen Sie Filter oder verwenden Sie ein breiteres Schlüsselwort; die Quelle hat möglicherweise keine übereinstimmenden Daten. |
| Meta-Detail hat keinen **Impressions-Index** | Die aktuelle externe Momentaufnahme hat keinen verwendbaren Wert. Fehlend bedeutet nicht Null. |
| Leere Sammlung | Keine gespeicherte Momentaufnahme ist in dieser Sammlung. Kehren Sie zu Trends zurück und speichern Sie eine Anzeige. |
| Speichern fehlgeschlagen | Die Momentaufnahme oder Sammlung wurde nicht bestätigt. Versuchen Sie es erneut, nachdem Sie die Quellkarte neu geladen haben. |
| Starke Trend-Anzeige | Es ist Inspiration, kein Beweis, dass die gleiche Kreative für Ihren Store funktioniert. Erstellen und messen Sie Ihre eigene Kampagne separat. |
## Prüfen, was die Karte darstellt
Prüfen Sie unter **Creatives** das gewählte Konto und den Zeitraum, bevor Sie Kartenkennzahlen vergleichen. Prüfen Sie unter **Trends** die externe Bibliothek und Filter, bevor Sie eine Anzeige als passende Inspiration verwenden.
**Prüfpunkt:** Nach erfolgreichem Speichern erscheint die Inspiration in der ausgewählten Sammlung. Sie ist eine gespeicherte Referenz, keine von Ihnen veröffentlichte Kampagne und kein gemessenes Ergebnis Ihres Stores.
## Verwandte Leitfäden
- [Runner Ads](./runner-ads)
- [Creative Studio](./creative-studio)
- [Medienbibliothek](./media-library)
---
# Automatisierungen
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/automations
Automatisierungen helfen Ihnen, wiederkehrende Arbeiten zu finden, die Runner ausführen kann, wenn ein aufgelisteter Trigger auftritt.
## Eingabepfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **Automatisierungen**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgUokxtnwmWbL01zqS4swQkOHahZevAM9fnVpR)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Automatisierungskarten zeigen den konfigurierten Zustand. Ein Live-Status allein bestätigt weder eine Ausführung noch eine E-Mail-Zustellung.
## Bevor Sie beginnen
- **Order Confirmation**, **Welcome Email** und **Account Closed Email** funktionieren in jedem Plan. Andere Automatisierungen brauchen einen Plan mit Automatisierungen; ohne ihn öffnet das Einschalten einen Upgrade-Hinweis.
- Jede Automatisierungskarte hat ihre eigene Verfügbarkeit und ihren eigenen Status.
- Das Aktivieren einer Automatisierung führt sie nicht sofort aus; sie wartet auf den in dieser Automatisierung beschriebenen Trigger.
## Bibliotheks-Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| **Suche** | Filtert Karten nach Wörtern im Automatisierungsnamen oder in der Beschreibung. |
| **Alle** oder eine Kategorie | Zeigt alle Automatisierungen oder nur Karten aus Kategorien wie **Kundenverwaltung**, **Shop-Betrieb** oder **Berichte & Analysen**. Die verfügbaren Kategorien hängen von der angezeigten Bibliothek ab. |
| Statusfilter | Zeigt **Alle Zustände**, **Aktiv**, **Angehalten**, **Durch Plan blockiert** oder **Demnächst verfügbar** Karten. |
| Kartenschalter | Fordert **Aktiv** an, wenn aktiviert, und **Angehalten**, wenn deaktiviert, falls die Automatisierung verfügbar ist. |
| Info-Schaltfläche | Öffnet **Automatisierungsdetails** mit Beschreibung, Status, Kategorie und letztem Lauf. |
| Bearbeitungsschaltfläche | Öffnet **E-Mail verfassen** für Automatisierungen, die eine E-Mail-Vorlage unterstützen. |
| **Erneut versuchen** | Lädt die Bibliothek nach einem Ladefehler neu. |
> **Bildschirmgröße:** Die Info- und E-Mail-Bearbeitungsschaltflächen werden auf breiteren Desktop-Layouts angezeigt. Wenn Sie sie auf einem telefongroßen Bildschirm nicht sehen, öffnen Sie Automatisierungen in einem breiteren Fenster erneut.
## Finden Sie die richtige Automatisierung
1. Öffnen Sie **Automatisierungen**.
2. Suchen Sie nach dem Ergebnis, das Sie benötigen, z. B. eine Kundennachricht oder einen Bericht.
3. Grenzen Sie die Liste mit einer Kategorie ein, wenn das Ergebnis breit ist.
4. Verwenden Sie den Statusfilter, um Live- oder blockierte Elemente zu finden.
5. Wählen Sie die Info-Schaltfläche auf einer Karte.
6. Lesen Sie die Beschreibung, den Status, die Kategorie und den letzten Lauf, bevor Sie den Schalter ändern.
7. Wenn eine E-Mail-Bearbeitungsschaltfläche angezeigt wird, überprüfen Sie die Vorlage, bevor Sie die Automatisierung aktivieren.
## Statusbedeutungen
| Status | Bedeutung und nächster Schritt |
| --- | --- |
| **Aktiv** | Die Automatisierung ist aktiviert und wartet auf ihren Trigger. Dies bedeutet nicht, dass sie bereits ausgeführt wurde. |
| **Angehalten** | Die Automatisierung ist verfügbar, wird aber erst neue ausgelöste Arbeiten starten, wenn sie aktiviert wird. |
| **Durch Plan blockiert** | Der aktuelle Plan verhindert, dass die Automatisierung ausgeführt wird. Überprüfen Sie den Zugriff, bevor Sie sich darauf verlassen. |
| **Demnächst verfügbar** | Die Karte ist für die Entdeckung sichtbar, kann aber nicht aktiviert werden. |
| **Nie ausgeführt** oder **Letzte Ausführung —** | Für dieses Projekt ist kein Zeitpunkt einer abgeschlossenen Ausführung verfügbar. |
## Fehlerbehebung
- Wenn keine Karten übereinstimmen, löschen Sie **Suche**, wählen Sie **Alle**, und wählen Sie **Alle Zustände**.
- Wenn ein Schalter deaktiviert ist, lesen Sie den Kartenstatus und den Verfügbarkeitsgrund.
- Wenn ein Schalter zu seinem früheren Status zurückkehrt, lesen Sie die Fehlermeldung und laden Sie die Bibliothek neu, bevor Sie es erneut versuchen.
- Wenn die Bibliothek nicht geladen wird, wählen Sie **Erneut versuchen** einmal aus und kontaktieren Sie den Support, wenn es sich wiederholt.
## Prüfpunkt vor dem Aktivieren
Die Detailansicht sollte Auslöser und aktuellen Status der Automatisierung erklären. Schließen Sie sie, um zur Karte zurückzukehren. **Live** erlaubt künftige Auslöser. Prüfen Sie die tatsächliche Ausführung anhand der letzten Ausführung und der entstandenen Nachricht oder des Berichts.
### Ansehen: Eine pausierte Automatisierung prüfen
Die Aufnahme filtert nach Pausiert, öffnet die Details der Bewertungsanfrage und schließt sie wieder. Sie aktiviert keine Automatisierung, bearbeitet keine E-Mail und sendet keine Nachricht.
## Verwandte Leitfäden
- [Erstellen und verwalten Sie Automatisierungen](./create-and-manage-automations)
- [Runner Ads](./runner-ads)
- [Analytik-Übersicht](../analytics-and-seo/analytics-overview)
---
# Erstellen und verwalten Sie Automatisierungen
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/create-and-manage-automations
Verwenden Sie Automatisierungssteuerelemente, um zu entscheiden, welche verfügbaren Workflows ausgeführt werden dürfen und welche unterstützten Kunden-E-Mails enthalten sollen.
> **Bedingt:** Die aktuelle Seite verwaltet von Runner bereitgestellte Automatisierungskarten; sie präsentiert keinen leeren Workflow-Builder zum Erstellen einer beliebigen Automatisierung. Die E-Mail-Bearbeitung wird nur auf unterstützten Karten angezeigt.
## Eingabepfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **Automatisierungen** → Karte auswählen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgu7RtXsbqHvBxClMcD3zm6P2XTVQw91N0sga5)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Die Bewertungsanfrage ist pausiert und zeigt keinen Zeitpunkt einer letzten Ausführung. Prüfen Sie diese Details vor dem Aktivieren.
## Bevor Sie beginnen
- Lesen Sie die Automatisierungsbeschreibung und den Trigger, bevor Sie sie aktivieren.
- Bestätigen Sie, dass der aktuelle Plan die Automatisierung zulässt.
- Überprüfen Sie für Kunden-E-Mail Absender, Betreff, Variablen, Links und Markendetails, bevor Sie speichern.
- Das Speichern einer Vorlage ändert ihre gespeicherte Konfiguration; es sendet keine Test- oder Kunden-E-Mail von selbst.
## Kartensteuerelement und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| Schalter ein | Ändert den angeforderten Status zu **Aktiv**. Zukünftige übereinstimmende Trigger können die Automatisierung starten. |
| Schalter aus | Ändert den angeforderten Status zu **Angehalten**. Neue übereinstimmende Trigger sollten sie nicht starten. |
| Info-Schaltfläche | Öffnet die Automatisierungsbeschreibung, den Status, die Kategorie, den Verfügbarkeitsgrund und die letzte Laufzeit. |
| E-Mail-Bearbeitungsschaltfläche | Öffnet **E-Mail verfassen**, wenn die Karte eine anpassbare Vorlage hat. |
> **Bildschirmgröße:** Die Info- und E-Mail-Bearbeitungsschaltflächen werden auf breiteren Desktop-Layouts angezeigt. Wenn sie auf einem telefongroßen Bildschirm fehlen, verwenden Sie ein breiteres Fenster, bevor Sie die folgenden Schritte ausführen.
## E-Mail-Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| **Von** | Ändert den gespeicherten Absenderwert für diese Vorlage. |
| **Betreff** | Bearbeitet den E-Mail-Betreff. |
| **Text** | Bearbeitet den E-Mail-Inhalt. |
| **Variable einfügen** | Öffnet die unterstützten Platzhalter und fügt den ausgewählten an der aktuellen Position ein. |
| **Vorschau** | Rendert eine Vorschau des aktuellen Entwurfs; es sendet die E-Mail nicht. |
| Logo-URL und Akzentfarbe | Aktualisiert die Branding-Eingaben, die von der Vorlage verwendet werden. |
| **Speichern** | Speichert die aktuellen E-Mail-Einstellungen und ändert **Nicht gespeichert** nach Erfolg zu **Gespeichert**. |
| Vorschau **Erneut versuchen** | Versucht, den aktuellen Entwurf nach einem Vorschaufehler erneut zu rendern. |
## Aktivieren und passen Sie sicher an
1. Wählen Sie die Info-Schaltfläche und bestätigen Sie, wann die Automatisierung ausgeführt wird.
2. Wenn eine E-Mail-Bearbeitungsschaltfläche verfügbar ist, öffnen Sie **E-Mail verfassen**.
3. Bearbeiten Sie den Betreff und den Text in klarer kundenfreundlicher Sprache.
4. Fügen Sie nur Variablen ein, die vom Menü angeboten werden.
5. Wählen Sie **Vorschau** und überprüfen Sie den gerenderten Inhalt.
6. Kehren Sie zu **Bearbeiten** zurück, wenn etwas fehlt oder unklar ist.
7. Wählen Sie **Speichern** und warten Sie auf **Gespeichert**.
8. Schließen Sie den Composer und aktivieren Sie den Kartenschalter nur, wenn der Trigger und die Nachricht bereit sind.
9. Kehren Sie später zurück, um den **Letzten Lauf** zu überprüfen; ein **Aktiv**-Badge allein beweist nicht die Ausführung.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| **Nicht gespeichert** | Der Entwurf unterscheidet sich von der gespeicherten Vorlage. Speichern oder schließen Sie, ohne sich auf den Entwurf zu verlassen. |
| **Gespeichert** | Die aktuellen Vorlageneinstellungen wurden gespeichert. Keine E-Mail wurde durch die Speicheraktion gesendet. |
| Vorschau fehlgeschlagen | Wählen Sie **Erneut versuchen**. Wenn es sich wiederholt, überprüfen Sie die Variablensyntax und bewahren Sie Ihren Entwurf auf, bevor Sie neu laden. |
| E-Mail-Vorlage nicht gefunden | Diese Karte hat keine abrufbare Anpassung. Schließen Sie den Dialog und laden Sie die Bibliothek neu. |
| Umschalter blockiert | Überprüfen Sie **Durch Plan blockiert**, **Demnächst verfügbar** oder den Verfügbarkeitsgrund auf der Karte. |
## Die E-Mail vor dem Speichern prüfen
Prüfen Sie in **Vorschau** Betreff, Markengestaltung, Links und die Darstellung der Variablen. Korrigieren Sie den Entwurf unter **Bearbeiten**. Schließen ohne Speichern lässt die gespeicherte Vorlage unverändert.
**Prüfpunkt:** **Gespeichert** bestätigt die Vorlagenkonfiguration. Für eine Zustellung sind ein passender Auslöser und eine abgeschlossene Ausführung nötig. Vorschau und Speichern senden keine E-Mail an Kunden.
### Ansehen: Eine pausierte Automatisierung prüfen
Die Aufnahme filtert nach Pausiert, öffnet die Details der Bewertungsanfrage und schließt sie wieder. Sie aktiviert keine Automatisierung, bearbeitet keine E-Mail und sendet keine Nachricht.
## Verwandte Leitfäden
- [Automatisierungen](./automations)
- [Medienbibliothek](./media-library)
- [Fehlerbehebung bei Daten und Veröffentlichung](../analytics-and-seo/troubleshoot-data-and-publication)
---
# Creative Studio
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/creative-studio
Creative Studio bietet Ihnen eine visuelle Leinwand zum Erstellen von Kampagnen- und Produktmedien aus einer Eingabeaufforderung, ausgewählten Bildern oder beiden.
## Eingabepfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **Kreativstudio**. Dort öffnet sich die Arbeitsfläche von **Kreativstudio**.
Wenn die Funktion aktiviert ist, kann eine generierte Bilddetailansicht im Runner-Chat auch **Generiertes Bild in Creative Studio öffnen** anbieten, das die Leinwand mit dieser Ausgabe geöffnet öffnet.
Die Modellauswahl für Bild-zu-Bild zeigt vor dem Ausführen die Anforderungen und die Abrechnungsquelle. Das Öffnen der Auswahl startet keine Generierung.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggKevjc4IC4NbwvYeKD2nM5xTZ76dBjp0auiy)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein vorhandenes Beispielbild ist auf der Arbeitsfläche ausgewählt. Daneben stehen Prompt, Modell und **Ausführen**. Prüfen Sie diese Angaben vor der Generierung.
## Bevor Sie beginnen
- Entscheiden Sie, ob Sie ein neues Bild, eine Bildbearbeitung, ein neues Video oder eine Animation aus einem Bild benötigen.
- Prüfen Sie Eingaben, Ausgaben, Qualität, Grenzen und Abrechnungsquelle des ausgewählten Modells. Die Auswahl kann **Runner-Credits** oder Ihren eigenen Fal-Schlüssel als Abrechnungsquelle anzeigen. Wählen Sie die gewünschte Quelle.
- Für eine Bearbeitung fügen Sie das Quellbild zur Leinwand hinzu und wählen Sie es zuerst aus.
- Halten Sie das Original-Asset verfügbar, bis Sie das Ergebnis genehmigen.
## Generierungssteuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| Eingabeaufforderung | Beschreibt das Bild, die Bearbeitung, die Bewegung oder das Video, das Sie möchten. |
| Modellschaltfläche | Öffnet **Modell auswählen** mit vier Registerkarten für Text-zu-Bild, Bild-zu-Bild, Text-zu-Video und Bild-zu-Video. |
| Modellsuche und Filter | Grenzt Modelle nach Name, Generierungstyp oder Anwendungsfall ein. |
| Stern auf einem Modell | Fügt dieses Modell zu **Favoriten** hinzu oder entfernt es. |
| Bilder hochladen | Öffnet die Dateiauswahl und fügt unterstützte Bilder zur Leinwand hinzu. |
| **Ausführen** | Startet einen Job mit der aktuellen Eingabeaufforderung, dem ausgewählten Modell und den ausgewählten Leinwand-Eingaben. |
| **Generierungen** | Öffnet die Hintergrundwarteschlange mit laufenden, abgeschlossenen, fehlgeschlagenen und unterbrochenen Jobs. |
| **Abgeschlossene löschen** | Entfernt abgeschlossene Warteschlangen-Einträge aus der Warteschlangen-Ansicht; es löscht keine gespeicherten Medien. |
## Leinwand- und Asset-Steuerelemente
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
| --- | --- |
| Asset-Fach | Öffnet generierte Assets aus der aktuellen Konversation oder allen Projekt-Assets. |
| Asset-Suche | Filtert das Asset-Fach. |
| **Zur Leinwand hinzufügen** | Platziert das ausgewählte verfügbare Asset auf der Leinwand. |
| **Auf Leinwand fokussieren** | Verschiebt den Viewport zu diesem Asset, wenn es bereits vorhanden ist. |
| **Medienbibliothek** | Öffnet die vollständige gespeicherte Medienseite. |
| Rückgängig / Wiederherstellen | Kehrt unterstützte Leinwand-Änderungen um oder wendet sie erneut an. |
| Zoom-Steuerelemente und Minimap | Ändert den Viewport, ohne die Medien selbst zu ändern. |
| Element(e) auswählen, dann Rechtsklick | Öffnet das Leinwand-Kontextmenü. Verfügbare Aktionen ändern sich mit der Anzahl und dem Typ der ausgewählten Elemente. |
| **Produkt-Tools** | Für unterstützte Bildauswahlen öffnet sich Produktfotografie, Produktszene, Produktplatzierung, Produkt-Halten, Virtual Try-On, Hintergrund entfernen oder ersetzen, Neubeleuchten, Material-Konzept und Hochskalierungs-Workflows. Werkzeuge mit einem und zwei Bildern bleiben deaktiviert, bis die erforderliche Anzahl ausgewählt ist. |
| **Als Produkt-Miniaturansicht festlegen** | Mit einem ausgewählten Bild öffnet sich die Produktauswahl. Wenn Sie **Als Miniaturansicht verwenden** wählen, wird das Bild hochgeladen und die Miniaturansicht und Bildliste dieses Produkts aktualisiert. |
| **Video erweitern** / **Video-Hintergrund entfernen** | Mit einem ausgewählten Video öffnet sich der entsprechende Video-Workflow, wenn er verfügbar ist. |
| **GIF exportieren** | Konvertiert das ausgewählte Video in ein herunterladbares GIF; ein Konvertierungsfehler lässt das Original-Video unverändert. |
| Duplizieren / Zuschneiden / Bilder kombinieren / Ebenenreihenfolge / Herunterladen | Wendet die ausgewählte Leinwand-Operation an, wenn ihre Bild- und Medientyp-Anforderungen erfüllt sind. |
| **Löschen** | Entfernt nur das ausgewählte Element von der Leinwand. Es löscht das gespeicherte Asset nicht aus der Medienbibliothek. |
## Erstellen Sie Medien
1. Öffnen Sie **Kreativstudio**.
2. Wählen Sie ein Modell und lesen Sie seine Eingabeanforderungen.
3. Für Text-zu-Bild oder Text-zu-Video lassen Sie die Leinwand-Auswahl leer und schreiben Sie eine spezifische Eingabeaufforderung.
4. Wählen Sie beim Ausgangsbild **Zur Arbeitsfläche hinzufügen**, markieren Sie es und wählen Sie ein **Bild-zu-Bild**-Modell. Beispielsweise erscheint **Nano Banana 2 Edit**, wenn es verfügbar ist. Prüfen Sie die Anforderungen; nicht jedes Modell akzeptiert dieselben Eingaben.
5. Für Bild-zu-Video wählen Sie das einzelne Bild aus, das das Modell animiert.
6. Überprüfen Sie die Modell-Finanzierungsbezeichnung und aktuelle Kreditbenachrichtigung.
7. Wählen Sie **Ausführen** einmal aus.
8. Öffnen Sie **Generierungen**, um den Fortschritt zu verfolgen, während Sie andere Leinwand-Arbeiten fortsetzen.
9. Überprüfen Sie die abgeschlossene Ausgabe auf der Leinwand. Generierte Medien werden nach erfolgreicher Generierung in der Medienbibliothek gespeichert.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Nichts in der Warteschlange | Keine aktuelle Hintergrund-Generierung ist aufgelistet. |
| Ausstehend oder läuft | Der Job wird noch verarbeitet. Arbeiten Sie weiter und warten Sie auf Abschluss. |
| Erfolgreich | Die generierte Ausgabe ist auf der Leinwand und in gespeicherten Medien verfügbar. Überprüfen Sie sie vor der Wiederverwendung. |
| Fehlgeschlagen | Der Job hat die erwartete Ausgabe nicht erzeugt. Lesen Sie die Nachricht, korrigieren Sie Eingaben und versuchen Sie es absichtlich erneut. |
| Unterbrochen | Die Verarbeitung endete vor Erfolg. Bestätigen Sie Finanzierung und Anbieter-Zugriff, bevor Sie es erneut versuchen. |
| Ausführung nicht verfügbar | Überprüfen Sie Eingabeaufforderung, ausgewählte Bilder, genaue Eingabeanzahl, Modellzugriff und Credits. |
| Asset nicht verfügbar | Versuchen Sie, das Fach neu zu laden, oder wählen Sie ein anderes gespeichertes Asset; verlassen Sie sich nicht auf eine fehlerhafte Vorschau. |
## Einstellungen prüfen, ohne einen Auftrag zu starten
1. Öffnen Sie **Modell auswählen** und vergleichen Sie die unterstützten Eingabetypen mit Ihrer Aufgabe.
2. Wählen Sie ein geeignetes Modell und schließen Sie die Auswahl.
3. Prüfen Sie den Prompt und die ausgewählten Bilder auf der Arbeitsfläche.
4. Lesen Sie vor **Ausführen** den Hinweis zur Abrechnungsquelle.
**Prüfpunkt:** Modell, Prompt und Bildauswahl entsprechen dem gewünschten Auftrag. Erst **Ausführen** startet die Generierung. Anschließend zeigt die Warteschlange den Status. Prüfen Sie auch ein fertig generiertes Ergebnis selbst auf seine Darstellung.
### Video: ein Modell zur Bildbearbeitung prüfen
Die Aufzeichnung in der englischen Oberfläche zeigt die Anforderungen für Bild-zu-Bild und anschließend wieder ein vorhandenes Beispielbild auf der Arbeitsfläche. Sie startet keine Generierung.
## Verwandte Leitfäden
- [Medienbibliothek](./media-library)
- [Anzeigenkreative und Trends](./ad-creatives-and-trending)
- [Runner Ads](./runner-ads)
---
# Experimentmessung
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/experiment-measurement
Die Experimentmessung hilft Ihnen, die Kontrolle mit der aktiven Variation zu vergleichen, bevor Sie eine Entscheidung für den Live-Shop treffen.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Messen** → **Experimente** → wählen Sie ein Experiment → **Leistung**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Der Store muss veröffentlicht sein, bevor ein echtes Experiment Daten erfassen kann. Hier sind keine Experimentmessungen zu sehen.
## Bevor Sie beginnen
- Bestätigen Sie das Experimentziel und die aktuelle Traffic-Zuweisung.
- Warten Sie auf eine aussagekräftige Stichprobe, bevor Sie kleine prozentuale Änderungen interpretieren.
- Überprüfen Sie Variationsänderungen auf der Registerkarte **Experimente**, bevor Sie **Änderungen anwenden** in Betracht ziehen.
- Fragen Sie einen Workspace-Besitzer, bevor Sie eine Aktion durchführen, die Änderungen bereitstellt oder Live-Tests stoppt.
## Leistungssteuerelemente und Ergebnisse
| Steuerelement oder Abschnitt | Was passiert oder wird angezeigt |
| --- | --- |
| **Experimente** | Öffnet Zyklus-Nachrichten, Pläne, Vorschau, Änderungen und ausstehende Anfragen. |
| **Leistung** | Öffnet Laufzeit, Stichprobengröße, Traffic-Aufteilung, Diagramm und Metriktabelle. |
| Metrik-Selector | Ändert das Diagramm zu einem unterstützten Maß wie Konversion, Zum Warenkorb hinzufügen, Kasse, Kauf, Bestellwert, Umsatz pro Besucher, Banner-Klicks, Warenkorbabbruch oder Fehlerquote. |
| Kontroll-/Variationsdiagramm | Vergleicht die aufgezeichneten Serien für die Original- und Experimentversion. |
| Traffic-Steuerelement → **Aktualisieren** | Speichert eine neue Experimentzuweisung innerhalb des zulässigen Bereichs. |
| **KI-Einblick** → **Zulassen** | Genehmigt den angezeigten Traffic-Vorschlag. |
| **KI-Einblick** → **Abbrechen** | Verwirft diesen Vorschlag, ohne ihn zu genehmigen. |
| **Runner AI fragen** | Sendet eine Nachricht im Experiment-Workspace. |
| **Plan anzeigen** | Öffnet den aktuellen Zyklus-Plan und die To-Do-Liste. |
## Messung überprüfen
1. Öffnen Sie **Leistung**.
2. Bestätigen Sie Laufzeit, Stichprobengröße und Traffic-Aufteilung, bevor Sie den Trend lesen.
3. Wählen Sie die Metrik aus, die dem Experimentziel entspricht.
4. Vergleichen Sie Kontrolle und Variation über denselben Zeitraum.
5. Überprüfen Sie unterstützende Metriken auf Fehler-, Abbruch- oder Umsatzkompromisse.
6. Kehren Sie zur Registerkarte **Experimente** zurück und überprüfen Sie die genauen Änderungen, die die Variation erzeugt haben.
7. Lesen Sie alle **KI-Einblick**-Anfragen, bevor Sie eine Traffic-Änderung zulassen.
8. Wählen Sie, ob Sie weiter messen, den Traffic anpassen, stoppen oder nur nach Überprüfung von Verhalten und Implementierung anwenden möchten.
## Hochauswirkungsmaßnahmen
| Aktion | Was der erste Klick bewirkt | Was Bestätigung bedeutet |
| --- | --- | --- |
| **Änderungen anwenden** | Öffnet **Experimentänderungen anwenden**. | Die Bestätigung wendet die Experimentänderungen auf den Haupt-Store-Pfad an und startet die Produktionsbereitstellung. Überprüfen Sie zuerst das benannte Experiment. |
| **Beenden** | Öffnet **Experiment beenden** mit Warnungen. | Die Bestätigung beendet das aktuelle Experiment. Wenn die Experiment-Autorisierung aktiviert bleibt, kann Runner ein anderes starten; verwenden Sie Projekteinstellungen, wenn Sie Experimente vollständig deaktivieren möchten. |
| Traffic **Aktualisieren** | Sendet die neue Zuweisung. | Zukünftiger berechtigter Traffic verwendet die aktualisierte Aufteilung nach erfolgreicher Durchführung. |
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Keine Zyklus-Daten | Die Messung hat noch kein Zyklus-Ergebnis erzeugt. Halten Sie das Experiment laufen oder überprüfen Sie seinen Status. |
| Metriken können nicht geladen werden | Laden Sie **Leistung** neu und versuchen Sie es später erneut; wenden Sie keine Änderungen aus fehlenden Daten an. |
| Flaches oder gemischtes Ergebnis | Die verfügbaren Beweise zeigen keine klare Verbesserung. Fahren Sie mit der Messung fort oder stoppen Sie ohne Anwendung. |
| Traffic-Update fehlgeschlagen | Der aktuelle Wert wurde nicht gespeichert. Laden Sie neu, bevor Sie eine gültige Zuweisung erneut versuchen. |
| Anwendung fehlgeschlagen | Es wurde keine erfolgreiche Produktionsanwendung bestätigt. Bewahren Sie den Fehler auf und überprüfen Sie den Live-Shop, bevor Sie es erneut versuchen. |
## Vor dem Ändern der Besucheraufteilung prüfen
Bevor Sie eine Aktion wählen, sollten Ziel, Stichprobengröße, aktive Besucheraufteilung und genaue Variante feststehen. Hat eine der beiden Gruppen noch keine aussagekräftigen Daten, ist das Ergebnis weiterhin offen. Das Öffnen von **Leistung** oder eines Bestätigungsdialogs beendet kein Experiment und übernimmt keine Änderungen. Dafür muss die jeweilige Aktion erfolgreich abgeschlossen werden.
## Verwandte Leitfäden
- [Experimente](./experiments)
- [Simulationsdurchläufe und Ergebnisse](./simulation-runs-and-results)
- [Metriken und Filter](../analytics-and-seo/metrics-filters)
---
# Experimente
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/experiments
Experimente ermöglichen es Runner, kontrollierte Storefront-Variationen gegen ein ausgewähltes Geschäftsziel zu testen.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Messen** → **Experimente**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Veröffentlichen Sie die Storefront, bevor Sie ein Experiment starten. Diese Ansicht zeigt die Voraussetzung, kein gestartetes Experiment.
## Bevor Sie beginnen
- Veröffentlichen Sie den Store und bestätigen Sie, dass er echten Traffic empfangen kann.
- Wählen Sie ein primäres Ziel, das der aktuellen Priorität des Stores entspricht.
- Wählen Sie eine Traffic-Zuweisung, die Sie Experimentvariationen zuweisen können.
- Verstehen Sie, dass das Starten eines Experimente einen Experimentprozess beginnt; es garantiert keinen Leistungsgewinn.
## Startsteuerelement und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| Zielkarte | Wählt die Metrik aus, die Runner optimieren sollte, wie Konversion, Zum Warenkorb hinzufügen, Kasse eingeleitet, Banner-Engagement, Button-Durchsatzrate oder durchschnittlicher Bestellwert. |
| Traffic-Schieberegler oder Voreinstellung | Legt den Anteil des berechtigten Traffics fest, der dem Experiment innerhalb des zulässigen Bereichs zugewiesen ist. |
| **Experimente starten** | Autorisiert und startet das Experiment für den ausgewählten Store, das Ziel und den Traffic-Wert. |
| Experimenttitel oder **Experiment anzeigen** | Öffnet den Experiment-Detail-Workspace. |
| **Alle Experimente**, **Laufen** oder **Gestoppt** | Filtert die Experimentliste nach Status. |
## Starten Sie ein Experiment
1. Öffnen Sie **Experimente**.
2. Wenn die Veröffentlichungsmauer angezeigt wird, veröffentlichen und überprüfen Sie zuerst den Store.
3. Lesen Sie jedes Ziel und wählen Sie das aus, das mit der Entscheidung verknüpft ist, die Sie benötigen.
4. Legen Sie die Traffic-Zuweisung fest.
5. Überprüfen Sie den Store, das Ziel und den Traffic noch einmal.
6. Wählen Sie **Experimente starten** einmal aus.
7. Warten Sie, bis die Experimentkarte angezeigt wird.
8. Öffnen Sie das Experiment, um Planung, Änderungen, Zyklen und Messungen zu verfolgen.
## Experiment-Kartensteuerelement
| Steuerelement oder Abschnitt | Was es anzeigt oder bewirkt |
| --- | --- |
| Status-Badge | Zeigt **Ausstehend**, **Laufen**, **Abgeschlossen**, **Fehlgeschlagen** oder **Abgebrochen**. Der Filter **Gestoppt** gruppiert abgeschlossene, fehlgeschlagene und abgebrochene Experimente. |
| Zyklus und Traffic | Zeigt die aktuelle Zykluszahl und Zuweisung. |
| Vorschau | Zeigt die Experimentvariante, wenn eine Vorschau verfügbar ist. |
| **Änderungen** | Listet Storefront-Änderungen auf, die mit dem neuesten Zyklus verknüpft sind. |
| **KI-Einblick** | Öffnet einen ausstehenden Vorschlag, wie eine Traffic-Anpassung. |
| **Zulassen** | Genehmigt den angezeigten Vorschlag mit seinem aktuellen Wert. |
| **Abbrechen** | Verwirft diesen ausstehenden Vorschlag. |
| Menü Weitere Aktionen | Öffnet **Beenden** und **Änderungen anwenden**, wenn diese Aktionen verfügbar sind. |
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Veröffentlichungsmauer | Der Store hat keine erfolgreiche Live-Bereitstellung. Veröffentlichen Sie vor der Aktivierung von Experimenten. |
| Warteliste oder Upgrade-Bildschirm | Die Funktion oder der Plan ist für diesen Workspace nicht verfügbar. |
| Vorbereitung oder Planung | Runner richtet den nächsten Zyklus ein. Warten Sie auf einen Plan oder eine sichtbare Anfrage. |
| Warten auf Genehmigung | Runner benötigt eine Entscheidung, bevor es diesen Vorschlag fortsetzen kann. Lesen Sie ihn, bevor Sie **Zulassen** wählen. |
| Noch keine Änderungen | Das aktuelle Experiment hat noch keine sichtbare Variationsänderung erzeugt. |
| Fehlgeschlagen | Öffnen Sie das Experiment und bewahren Sie den sichtbaren Fehler auf, bevor Sie ein Ersatzexperiment starten. |
## Zugriff prüfen, bevor Sie den Start vorbereiten
Wenn Runner eine Tarifvorschau zeigt, veranschaulichen Beispielkarten die Funktion. Sie sind keine laufenden Experimente in Ihrem Store. Erfüllen Sie zuerst die angezeigte Zugriffsvoraussetzung. Eine erforderliche Veröffentlichung ist eine separate Voraussetzung; dafür muss der öffentliche Store funktionieren.
**Prüfpunkt:** Nach einem zulässigen Start sollte die echte Experimentkarte das gewünschte Ziel und die Besucheraufteilung nennen. Warten Sie auf erfasste Besuche, bevor Sie Ergebnisse interpretieren. Eine erstellte Karte allein belegt weder eine Messung noch eine Verbesserung.
## Verwandte Leitfäden
- [Experimentmessung](./experiment-measurement)
- [Simulationen](./simulations)
- [Traffic und Konversion](../analytics-and-seo/traffic-and-conversion)
---
# Medienbibliothek
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/media-library
Die Medienbibliothek bietet Ihnen einen filterbaren visuellen Datensatz generierter Projekt-Bilder und Videos, die später wiederverwendet werden können.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **Medienbibliothek**. Dadurch öffnet sich die Seite **Medienbibliothek**.
Sie können es auch aus dem Asset-Tablett in [Creative Studio](./creative-studio) öffnen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgPzvLcwpojWS3a1ps2R0mnEqK6T9PkBh7u5zQ)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Eine Bildbibliothek mit Beispielen. Wählen Sie ein Bild, um seine gespeicherten Angaben zu prüfen. Das Öffnen der Bibliothek erzeugt keine neuen Medien.
Die Detailansicht eines Beispielbilds zeigt Prompt, Modell und Aktionen zur Wiederverwendung. Es wurde kein Produktvorschaubild geändert.
## Bevor Sie beginnen
- Generieren oder speichern Sie Medien in einem unterstützten Runner-Workflow.
- Wissen Sie, ob Sie nach einem Bild oder Video suchen.
- Bestätigen Sie für Produkt-Thumbnails, welches Produkt sich ändern sollte, bevor Sie den Auswahlsdialog abschließen.
## Bibliotheks-Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Alle** | Zeigt jedes verfügbare gespeicherte Bild und Video. |
| **Bilder** | Filtert das Raster auf Bilder. |
| **Videos** | Filtert das Raster auf Videos. |
| Medienkarte | Öffnet **Bilddetails** oder **Videodetails**. |
| **Mehr laden** | Ruft zusätzliche Medien ab, wenn mehr Elemente verfügbar sind. |
## Detail-Steuerelemente und Klickergebnisse
| Steuerelement oder Feld | Was passiert oder wird angezeigt |
| --- | --- |
| Typ, Quelle und Erstellt | Erklärt, was das Element ist, woher es kam und wann es gespeichert wurde. |
| Eingabeaufforderung und Modell | Zeigt den Generierungskontext, wenn er verfügbar ist. |
| Titel | Ermöglicht es Ihnen, einen klareren wiederverwendbaren Namen einzugeben. |
| **Speichern** | Speichert einen geänderten Titel; nicht verfügbar, wenn sich nichts geändert hat. |
| **Schließen** | Schließt Details ohne Speicherung eines nicht gespeicherten Titels. |
| **Als Produkt-Thumbnail festlegen** | Öffnet den Produktauswahl- und Bestätigungsfluss für ein Bild. Gilt nicht für Videos. |
| **Löschen** | Öffnet eine irreversible Bestätigung; nur das zweite **Löschen** entfernt das Element. |
| Löschen **Abbrechen** | Kehrt zu Details zurück, ohne das Element zu löschen. |
## Medien finden und prüfen
1. Öffnen Sie **Medienbibliothek**.
2. Wählen Sie **Bilder** oder **Videos**, wenn das Raster groß ist.
3. Wählen Sie eine Karte aus, um Details zu öffnen.
4. Überprüfen Sie Quelle, Datum, Eingabeaufforderung und Modell, um zu bestätigen, dass es das beabsichtigte Asset ist.
5. Schließen Sie die Details, um zur gefilterten Übersicht zurückzukehren.
**Prüfpunkt:** Die Detailansicht zeigt die gewünschte Datei und die verfügbaren Angaben zu ihrer Generierung. Ist die Übersicht leer, wechseln Sie zunächst zu **Alle**, bevor Sie von fehlenden Medien ausgehen.
## Ein Bild umbenennen oder verwenden
1. Öffnen Sie die gewünschte Datei erneut, geben Sie einen aussagekräftigen Titel ein und wählen Sie **Speichern**.
2. Soll ein Bild als Produktvorschaubild dienen, wählen Sie **Als Produktvorschaubild festlegen**.
3. Wählen Sie das gewünschte Produkt und prüfen Sie die Bestätigung, bevor Sie die Änderung übernehmen.
4. Öffnen Sie anschließend das Produkt und prüfen Sie, ob das richtige Bild angezeigt wird.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| **Noch keine Medien** | Keine unterstützten Medien sind verfügbar. Erstellen Sie zuerst ein Bild oder Video in Creative Studio. |
| Leere gefilterte Ansicht | Die Bibliothek hat kein Element dieses Typs. Kehren Sie zu **Alle** zurück. |
| Keine Änderungen zum Speichern | Der Titel entspricht dem gespeicherten Wert. Schließen Sie den Dialog oder bearbeiten Sie ihn. |
| Speichern fehlgeschlagen | Der neue Titel wurde nicht bestätigt. Bewahren Sie ihn auf, laden Sie neu und versuchen Sie es erneut. |
| Thumbnail-Aktion nicht vorhanden | Nur Bilder können den Produkt-Thumbnail-Workflow verwenden. |
| Bestätigung löschen | Die Aktion kann nicht rückgängig gemacht werden. Wählen Sie **Abbrechen**, es sei denn, eine permanente Entfernung ist beabsichtigt und autorisiert. |
## Verwandte Leitfäden
- [Creative Studio](./creative-studio)
- [Runner Ads](./runner-ads)
- [Automatisierungen](./automations)
---
# Runner Ads
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/runner-ads
Runner Ads bringt unterstützte Ad-Konto-Berichte und Kampagnensteuerelemente in das Store-Projekt.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Wachstum** → **Werbung** → **Übersicht**. Das Untermenü von Ads führt auch zu **Creatives** und **Trends**. Dies sind separate Ansichten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglh1549efCuYB97EiQHRN3LVKtUonPdvTgIM4)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Die noch nicht verbundene Ads-Übersicht bietet die Autorisierung für Google, Meta und TikTok an. Die Auswahl eines Anbieters beginnt die Verbindung. Diese Ansicht bestätigt noch kein verbundenes Konto.
## Bevor Sie beginnen
- Bestätigen Sie, dass der Workspace Ads-Zugriff und einen berechtigten Plan hat.
- Verwenden Sie ein Konto, das zum Verbinden des Ad-Providers autorisiert ist.
- Wissen Sie, welcher Provider und welches Ad-Konto zu diesem Unternehmen gehört.
- Das Verbinden startet den Provider-Autorisierungsfluss; es ist nicht abgeschlossen, bis Runner das verbundene Konto anzeigt.
## Verbindungs-Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Google Ads verbinden** | Öffnet den sicheren Google-Autorisierungsfluss. |
| **Facebook & Instagram verbinden** | Öffnet den Meta-Autorisierungsfluss. |
| **TikTok Ads verbinden** | Öffnet die TikTok-Autorisierung, wenn dieser Kanal aktiviert ist. |
| **Verbindung abbrechen** | Bricht einen Provider-Autorisierungsversuch ab, der noch ausstehend ist. |
| Verbindungseinstellungen | Öffnet den Status des verbundenen Kanals sowie die von diesem Provider unterstützten Steuerelemente, wie Verbinden, Synchronisieren, Erneut autorisieren oder Trennen. |
| Synchronisieren | Fordert eine frische Kontoliste für diese Verbindung an. Es erstellt keine Kampagne. |
| **Erneut autorisieren** | Für TikTok startet die Autorisierung erneut, wenn dieses Steuerelement angezeigt wird und die Verbindung es erfordert. |
| Trennen | Öffnet eine Bestätigung, bevor Runners Provider-Verbindung entfernt wird. |
## Verbinden Sie ein Konto
1. Öffnen Sie **Werbung** → **Übersicht**.
2. Wählen Sie die richtige Provider-Schaltfläche.
3. Schließen Sie die Autorisierung im Provider-Fenster ab.
4. Kehren Sie zu Runner zurück und warten Sie auf die Kontosynchronisierung.
5. Bestätigen Sie, dass der Provider- und Kontoname in den Verbindungseinstellungen oder der Kontowahl angezeigt werden.
6. Wenn die Verbindung ausstehend bleibt, warten Sie auf die Synchronisierung oder verwenden Sie den sichtbaren Wiederholungspfad.
7. Behandeln Sie den ersten Schaltflächenklick nicht als abgeschlossene Verbindung.
## Dashboard-Steuerelemente und Ergebnisse
| Steuerelement oder Abschnitt | Was passiert oder wird angezeigt |
| --- | --- |
| Zeitbereich | Aktualisiert die Berichterstattung für die letzte Woche, den letzten Monat oder einen breiteren aktuellen Zeitraum. |
| Kontowahl | Filtert Ergebnisse, wenn mehr als ein verbundenes Konto verfügbar ist. |
| KPI-Karten | Fassen verfügbare Ad-Metriken für die ausgewählten Konten und den Zeitraum zusammen. |
| Kampagnentabelle | Listet Kampagnenmetriken und unterstützte Statussteuerelemente auf. |
| Kampagne **Pausieren** / **Aktivieren** | Für unterstützte Google Ads- oder TikTok-Kampagnen fordert die entsprechende externe Statusänderung an. Meta-Kampagnen zeigen dieses Steuerelement nicht. Verwenden Sie es nur, wenn autorisiert, und bestätigen Sie den zurückgegebenen Status. |
| Trend-Diagramm | Vergleicht die Leistung der ausgewählten Kampagne und des Kontos im Laufe der Zeit. |
| Aktivitäts-Feed | Zeigt verfügbare aktuelle Ad-Konto-Aktivität. |
| **Kampagne erstellen** | Öffnet eine Provider-Wahl oder ein Kampagnenziel nur, wenn ein unterstützter Erstellungskanal verbunden ist. |
## Kampagnenerstellungspfade
- Mit verbundenem Google Ads öffnet **Kampagne erstellen** Runners vierstufigen Fluss: **Kanal & Ziel**, **Plan**, **Kampagnen bearbeiten** und **Überprüfen & Veröffentlichen**.
- Mit verbundenem TikTok Ads öffnet die Erstellung TikTok Ads Manager in einem neuen Tab statt eines In-App-TikTok-Assistenten.
- Mit beiden verfügbar öffnet die Schaltfläche eine Provider-Wahl.
- Eine nur Meta-Verbindung kann Berichte bereitstellen, zeigt aber kein Kampagnenerstellungsziel im aktuellen Fluss.
- Im Google-Fluss rückt **Weiter** nach gültigen erforderlichen Feldern vor, **Zurück** kehrt zu einem abgeschlossenen Schritt zurück, und **Kampagne veröffentlichen** sendet die überprüfte Kampagne an den Provider.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Warteliste | Ads ist für den Workspace deaktiviert. Das Beitreten oder Anzeigen der Warteliste entsperrt ihn nicht sofort. |
| Upgrade-Bildschirm | Der aktuelle Plan kann den Ads-Workspace nicht öffnen. |
| Autorisierung ausstehend | Das Provider-Fenster hat nicht abgeschlossen oder zurückgegeben. Schließen Sie es ab oder brechen Sie den Versuch ab. |
| Muss neu verbunden werden. | Für TikTok öffnen Sie die Verbindungseinstellungen und wählen Sie **Erneut autorisieren**, wenn angezeigt, bevor Sie frische Daten erwarten. |
| Daten vorübergehend verzögert | Behalten Sie verfügbare Teildaten und versuchen Sie es später erneut; vermeiden Sie wiederholte Provider-Anfragen. |
| Berichterstattung nicht verfügbar für einen Kanal | Diese Verbindung kann den angeforderten Bericht nicht bereitstellen. Verwenden Sie unterstützte Kanäle oder Provider-Berichterstattung. |
| Schaltfläche Erstellen nicht vorhanden | Kein aktuell verbundener Kanal unterstützt ein Erstellungsziel. |
## Vor dem Verbinden die angezeigte Ansicht prüfen
Eine Warteliste bedeutet, dass Ads in diesem Arbeitsbereich nicht verfügbar ist. Eine Tarifvorschau kann Beispielberichte zeigen, während echte Aktionen weiterhin gesperrt sind. Eine Verbindungsseite fragt nach dem Anbieterkonto, das für Berichte benötigt wird. Folgen Sie den Verbindungsschritten erst, wenn die Seite einen nutzbaren Verbindungsablauf anbietet.
**Prüfpunkt:** Kontrollieren Sie nach der Autorisierung den genauen Anbieter und das in Runner ausgewählte Konto. Eine leere Kampagnentabelle kann lediglich bedeuten, dass dieses Konto keine passenden Kampagnen oder Daten für den gewählten Zeitraum hat.
## Verwandte Leitfäden
- [Ad-Creatives und Trends](./ad-creatives-and-trending)
- [Creative Studio](./creative-studio)
- [Traffic und Konversion](../analytics-and-seo/traffic-and-conversion)
---
# Simulationsdurchläufe und Ergebnisse
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/simulation-runs-and-results
Die Laufseite verwandelt generierte Käufer-Aktivität in Beweise, die Sie überprüfen können, bevor Sie entscheiden, ob sich der Store ändern sollte.
> **Bedingt:** Eine Laufseite existiert nur nach dem Start einer berechtigten Simulation. Ergebnisse können teilweise, nicht verfügbar oder fehlgeschlagen sein, und generierte Empfehlungen werden nicht automatisch angewendet.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Messen** → **Simulation** → wählen Sie eine kürzlich ausgeführte Simulation.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Käufer- und Seitensimulationen erfordern vor dem Start eine Veröffentlichung. Diese Einrichtungsansicht enthält keine abgeschlossenen Abläufe oder Ergebnisse.
## Bevor Sie beginnen
- Warten Sie, bis der Durchlauf einen abgeschlossenen oder fehlgeschlagenen Zustand erreicht, bevor Sie seine Gesamtzahlen als endgültig behandeln.
- Behalten Sie die Zielseite und den ausgewählten Modus im Hinterkopf, während Sie Ergebnisse interpretieren.
- Behandeln Sie generiertes Persona-Verhalten nicht als beobachtetes Verhalten von echten Käufern.
## Lauf-Steuerelemente und Klickergebnisse
| Steuerelement oder Abschnitt | Was passiert oder wird angezeigt |
| --- | --- |
| Zurück-Link | Kehrt zur Simulationslandungsseite und zu aktuellen Durchläufen zurück. |
| **Einkaufswege** | Öffnet einzelne Persona-Pfade, Entscheidungen, Schritte und verfügbare Screenshots. |
| **Trichter-Board** | Gruppiert Käufer-Sitzungen nach dem weitesten erreichten Journey-Stadium. |
| **Ergebnisse** | Fasst Terminal-Sitzungen, explizite Exits, Turn-Limits und technische Fehler zusammen. |
| Persona- oder Sitzungskarte | Öffnet diese generierte Käufer-Journey. |
| **Schrittdetails anzeigen** | Öffnet die ausgewählte Aktion, Seite, Absicht, Begründung und Screenshot, wenn verfügbar. |
| **An Runner senden** | Erstellt eine Runner-Chat-Übergabe mit dem Empfehlungskontext. Es wendet die Änderung nicht an. |
| **Käufer validieren** | Startet einen Vergleichsdurchlauf mit denselben Käufern für eine berechtigte Empfehlung. |
## Lesen Sie einen Käufer-Verhaltens-Durchlauf
1. Bestätigen Sie, dass der Status **Abgeschlossen** ist, oder notieren Sie, welche Teile noch laufen.
2. Lesen Sie die Sitzungsgesamtzahlen und die Checkout-Erreichungszusammenfassung.
3. Öffnen Sie **Trichter-Board**, um den frühesten gemeinsamen Rückgang zu finden.
4. Öffnen Sie **Einkaufswege** und überprüfen Sie repräsentative Sitzungen an diesem Punkt.
5. Verwenden Sie **Schrittdetails anzeigen**, um den versuchten Vorgang und den sichtbaren Seitenzustand zu überprüfen.
6. Öffnen Sie **Ergebnisse**, um Käufer-Exits von technischen Fehlern oder Turn-Limits zu trennen.
7. Lesen Sie jede Optimierungsempfehlung mit ihren Beweisen, betroffenen Bereich, Risiko und Validierungsplan.
8. Verwenden Sie **An Runner senden** nur, wenn Sie eine überprüfbare Chat-Aufgabe möchten; überprüfen Sie die Aufgabe, bevor Sie Änderungen akzeptieren.
## Lesen Sie einen Seiten-Stimulus-Audit
1. Warten Sie auf den Gesamtbericht.
2. Lesen Sie die Intent-Punktzahl und die Anzahl der Käufer-Perspektiven zusammen.
3. Überprüfen Sie Segment-Unterschiede und Punktzahl-Verteilung.
4. Lesen Sie Reibungs-Themen und unterstützende Kommentare.
5. Verwenden Sie das Ergebnis, um eine testbare Hypothese zu bilden, nicht eine garantierte Konversionsvorhersage.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Ergebnisse ausstehend | Sitzungen haben nicht beendet. Warten Sie auf mehr Terminal-Sitzungen. |
| Kein Bericht verfügbar | Der Durchlauf wurde ohne den erwarteten Gesamtbericht beendet. Bewahren Sie die Durchlauf-ID auf und kontaktieren Sie den Support. |
| Wiedergabe nicht verfügbar | Eine Wiedergabe oder signierter Screenshot konnte nicht geladen werden. Laden Sie den Durchlauf neu, um frischen Zugriff anzufordern. |
| Technischer Fehler | Die Automatisierung konnte diese Journey nicht abschließen; schließen Sie sie von Verhaltensschlussfolgerungen aus. |
| Validierung in Warteschlange oder läuft | Der Vergleich ist nicht bereit. Warten Sie, bevor Sie die Empfehlung beurteilen. |
| Verbessert, verschlechtert oder nicht schlüssig | Der Vergleich mit denselben Käufern bevorzugt, schadet oder kann die vorgeschlagene Änderung innerhalb dieses generierten Tests nicht unterscheiden. |
## Das Ergebnis dem richtigen Modus zuordnen
Die obigen Anweisungen zu Kaufabläufen und Trichtern gelten für Käufersimulationen. Ein Lauf im Modus **Kampagnenprognose** bietet dagegen, sofern verfügbar, **Gesellschaft**, **Chat** und **Bericht**. Lesen Sie vor dem Bericht die Annahmen zur Zielgruppe und die Kampagneneingaben.
**Prüfpunkt:** Stellen Sie fest, ob eine Erkenntnis aus einem generierten Kaufablauf, einer Seitenreaktion oder einer Kampagnenprognose stammt. Keines davon ist ein erfasster Kauf eines echten Kunden. Unterscheiden Sie technische Fehler von Reaktionen der Zielgruppe.
## Verwandte Leitfäden
- [Simulationen](./simulations)
- [Experimente](./experiments)
- [Traffic und Konversion](../analytics-and-seo/traffic-and-conversion)
---
# Simulationen
Source: https://www.runnerai.com/docs/de/guides/automate-test-and-create/simulations
Simulation ermöglicht es Ihnen, generierte Käufer-Personas durch eine Live-Store-Journey zu senden oder sie aufzufordern, eine öffentliche Seite zu bewerten.
## Einstiegspfad
Öffnen Sie ein Store-Projekt → **Messen** → **Simulation**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Käufer- und Seitensimulationen erfordern vor dem Start eine Veröffentlichung. Diese Einrichtungsansicht enthält keine abgeschlossenen Abläufe oder Ergebnisse.
## Bevor Sie beginnen
- Veröffentlichen Sie für **Shopper-Verhalten** und **Seitenwirkungsanalyse** den Store und prüfen Sie, ob seine öffentlichen Seiten laden.
- **Kampagnenprognose** verwendet, sofern verfügbar, Kampagneneingaben und erfordert keine veröffentlichte Storefront.
- Überprüfen Sie den aktuellen Plan oder die Nutzungsmitteilung, bevor Sie bezahlte Arbeiten starten.
- Wählen Sie eine echte Storefront-Frage und eine Zielseite.
- Behandeln Sie generierte Käufer als direktionales Testen, nicht als echte Kundennachfrage.
## Modi
| Modus | Wann man ihn verwendet | Was Runner nach dem Start bewirkt |
| --- | --- | --- |
| **Käufer-Verhalten** | Sie möchten Navigation, Entscheidungen und Journey-Reibung beobachten. | Startet mehrere Käufer-Journeys auf der ausgewählten Live-Seite und bereitet Trichter-, Journey-, Ergebnis- und Empfehlungsansichten vor. |
| **Seiten-Stimulus-Audit** | Sie möchten fokussierte Reaktionen auf eine Seite. | Sammelt generierte Käufer-Bewertungen für Kaufabsicht, Segmente und Reibung auf dieser Seite. |
## Steuerelemente und Klickergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| Modusauswahl | Wählt **Shopper-Verhalten**, **Seitenwirkungsanalyse** oder **Kampagnenprognose**, sofern der jeweilige Modus aktiviert ist. |
| Persona-Anleitung | Fügt optionale Zielgruppen-Richtung hinzu, wie Preissensibilität oder Versandbedenken. |
| **Zielseite** | Öffnet entdeckte öffentliche Storefront-Seiten wie Startseite, Kollektion, Produkt, Warenkorb, Kasse oder eine benutzerdefinierte Seite. |
| Geräte-Viewport | Wählt nur Mobilgeräte, nur Desktop oder eine gewichtete Mischung für Käufer-Verhalten. |
| Panel-Größe | Ändert, wie viele generierte Käufer-Journeys der Durchlauf innerhalb des zulässigen Bereichs anfordert. |
| **Simulation starten** | Startet den konfigurierten Durchlauf und öffnet seine Laufseite. Es ist deaktiviert, bis eine Zielseite ausgewählt ist. |
| Aktuelle Simulations-Karte | Öffnet einen früheren Durchlauf und seinen aktuellen Status oder Ergebnisse. |
| **Alle anzeigen** | Erweitert die aktuelle Durchlauf-Liste, wenn mehr Durchläufe vorhanden sind. |
| **Erneut versuchen** | Lädt Zielseiten oder Durchläufe nach einem sichtbaren Fehler neu. |
## Starten Sie eine fokussierte Simulation
1. Öffnen Sie **Simulation**.
2. Wählen Sie **Käufer-Verhalten** oder **Seiten-Stimulus-Audit**.
3. Fügen Sie prägnante Persona-Anleitung nur hinzu, wenn eine bestimmte Zielgruppe wichtig ist.
4. Wählen Sie **Zielseite** und wählen Sie eine entdeckte Live-Seite.
5. Wählen Sie für Käufer-Verhalten die Gerätemischung und Panel-Größe.
6. Überprüfen Sie die aktuelle Nutzungsmitteilung.
7. Wählen Sie **Simulation starten** einmal aus.
8. Folgen Sie der Laufseite, bis sie abgeschlossen oder fehlgeschlagen ist.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Veröffentlichungsmauer | Keine erfolgreiche Live-Bereitstellung ist verfügbar. Veröffentlichen und überprüfen Sie zuerst den Store. |
| Keine Zielseiten | Runner konnte öffentliche Seiten nicht entdecken. Öffnen Sie den Live-Shop und versuchen Sie, Seiten neu zu laden. |
| Noch keine Simulationen | Konfigurieren Sie das Panel und das Ziel, um den ersten Durchlauf zu erstellen. |
| In Warteschlange oder ausstehend | Der Durchlauf wurde akzeptiert, hat aber nicht alle Arbeiten gestartet. Warten Sie, statt einen Duplikat zu starten. |
| Läuft | Käufer-Arbeit ist noch in Bearbeitung; Ergebnisse können unvollständig bleiben. |
| Fehlgeschlagen | Öffnen Sie den auf dem Durchlauf angezeigten Fehler und starten Sie einen neuen Durchlauf nur nach Korrektur des Ziels oder des vorübergehenden Fehlers. |
## Kampagnenprognose, sofern verfügbar
In diesem Modus bewerten generierte Mitglieder einer Zielgruppe eine Kampagne, statt durch einen veröffentlichten Store zu navigieren.
1. Öffnen Sie **Messen** → **Simulation** und wählen Sie **Kampagnenprognose**, falls angezeigt.
2. Prüfen Sie, welche Kampagnenangaben das Formular verlangt.
3. Fügen Sie die zu bewertende Kampagne hinzu und lesen Sie den aktuellen Nutzungshinweis.
4. Starten Sie die Prognose erst, wenn Eingaben und angezeigter Verbrauch stimmen.
5. Öffnen Sie den daraus entstandenen Arbeitsbereich und prüfen Sie die verfügbaren Ansichten **Gesellschaft**, **Chat** und **Bericht**.
**Prüfpunkt:** Ein abgeschlossener Bericht ist eine generierte Prognose für die angegebene Kampagne. Er schaltet keine Anzeige und misst keine echte Kampagnenleistung. Fehlt dieser Modus, verwenden Sie einen verfügbaren Modus oder lesen Sie [Funktionsverfügbarkeit](../advanced/feature-availability).
## Verwandte Leitfäden
- [Simulationsdurchläufe und Ergebnisse](./simulation-runs-and-results)
- [Experimente](./experiments)
- [Analytics-Übersicht](../analytics-and-seo/analytics-overview)
---
# Hilfe und Referenz
Source: https://www.runnerai.com/docs/de/guides/help-and-reference
Beginnen Sie hier, wenn Sie das gewünschte Ergebnis kennen, aber der aktuelle Bildschirm nicht damit übereinstimmt.
| Situation | Anleitung |
| --- | --- |
| Eine Schaltfläche ist deaktiviert, eine Seite ist leer, ein Eintrag fehlt oder Runner fordert Sie auf, die neueste Version zu laden | [Zustände und Verfügbarkeit](/de/guides/help-and-reference/states-and-availability) |
| Eine Runner-Chat-Aufgabe wartet, ist gestoppt oder fehlgeschlagen | [Fehlerbehebung bei Runner-Aufgaben](/de/guides/help-and-reference/troubleshoot-runner-tasks) |
| Der Storefront-Build oder die Vorschau ist falsch | [Fehlerbehebung bei Storefront-Builds](/de/guides/help-and-reference/troubleshoot-storefront-builds) |
| Veröffentlichung, Checkout oder eine App funktioniert nicht | [Fehlerbehebung bei Veröffentlichung, Checkout und Apps](/de/guides/help-and-reference/troubleshoot-publishing-checkout-apps) |
| Sie benötigen eine Person oder möchten ein Problem melden | [Support und Community](/de/guides/help-and-reference/support-and-community) |
| Sie möchten Runner-Produktaktualisierungen überprüfen | [Änderungsprotokoll](/de/guides/help-and-reference/changelog) |
| Sie haben eine kurze Produktfrage | [Häufig gestellte Fragen](/de/guides/help-and-reference/faq) |
| Ein Runner-Begriff ist Ihnen nicht vertraut | [Glossar](/de/guides/help-and-reference/glossary) |
## Den kürzesten Weg wählen
Nutzen Sie eine Anleitung zur Fehlerbehebung, wenn etwas fehlgeschlagen ist. **Support und Community** hilft bei vertraulichen Konto- oder Projektproblemen. Für Begriffsdefinitionen eignen sich FAQ, Glossar und Statusreferenz. Beginnen Sie die Ersteinrichtung mit [Ihren ersten Store erstellen](/de/guides/start-here/first-store-quickstart).
---
# Änderungsprotokoll
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/changelog
Das Changelog hält Produktveröffentlichungen an einem Ort, damit Sie sehen können, was sich geändert hat, ohne Runner zu verlassen.
## Das öffentliche Changelog lesen
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRzXySfwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXk)
Lesen Sie im [öffentlichen Changelog](https://www.runnerai.com/changelog) den Monat neben **Monthly Update** und den Abschnitt **What’s New**. Scrollen Sie für ältere Updates nach unten. Eine Anmeldung ist nicht erforderlich. Der Monat ist eine Datumsangabe, kein Filter.
Wählen Sie das Bild aus, um es zu vergrößern. Die Anmerkungen sind auf Englisch.
Die folgenden Abschnitte beschreiben das Changelog im Workspace, sofern verfügbar. Filter, Ungelesen-Anzeige und Zurück-Steuerelemente gehören zu dieser Version und erscheinen nicht in der öffentlichen Zeitleiste oben.
## Was dieser Leitfaden abdeckt
Sie öffnen aktuelle Aktualisierungen, filtern diese nach Typ, verstehen die Ungelesen-Markierung und kehren zum richtigen Shop oder Arbeitsbereich zurück.
## Verfügbarkeit und Voraussetzungen
- Nur das Changelog im Workspace oder Projekt erfordert eine Anmeldung; die öffentliche Seite ist ohne Konto zugänglich.
- Der Ungelesen-Punkt wird nur angezeigt, wenn Runner eine Aktualisierung hat, die Sie nicht geöffnet haben.
- Ein Filter ändert nur die auf dieser Seite angezeigten Veröffentlichungen; er ändert keine Produktfunktion.
## Einstiegspfade
| Eintrag | Was passiert, nachdem Sie ihn auswählen |
| --- | --- |
| Arbeitsbereich-Seitenleiste → **Neuigkeiten** | Öffnet alle verfügbaren Produktaktualisierungen im aktuellen Arbeitsbereich. |
| Desktop-Projekt-Avatar → **Neuigkeiten** | Öffnet das gleiche Changelog und behält das aktuelle Projekt als Rückgabeziel bei. |
| Mobiler Projekt-Avatar → **Neuigkeiten** | Öffnet das Changelog aus dem Blatt **Profil & Einstellungen**. |
| Eingeklappte Arbeitsbereich-Seitenleiste → Changelog-Symbol-Vorschau → **Alle anzeigen** | Öffnet das vollständige Changelog nach der Vorschau der neuesten Veröffentlichung. |
Das Öffnen des vollständigen Changelog löscht den Ungelesen-Punkt. Dies markiert die Aktualisierungen als angesehen; es führt die in einer Veröffentlichung beschriebenen Funktionen nicht aus oder aktiviert sie nicht.
## Veröffentlichungen filtern
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Alle** | Zeigt jede verfügbare Veröffentlichung. |
| **Funktion** | Zeigt Veröffentlichungen, die als neue Funktionen kategorisiert sind. |
| **Verbesserung** | Zeigt Veröffentlichungen, die als Verbesserungen kategorisiert sind. |
| **Behebung** | Zeigt Veröffentlichungen, die als Behebungen kategorisiert sind. |
| Veröffentlichungskarte | Zeigt den Titel, das Datum, den Typ, die Beschreibung und verfügbare Medien dieser Veröffentlichung. |
| **Zurück zum Shop** | Kehrt zum aktuellen Projekt zurück, wenn das Changelog dort geöffnet wurde; andernfalls kehrt es zur Arbeitsbereich-Shop-Liste zurück. |
Auf Mobilgeräten innerhalb eines Projekts bietet die Projekt-Shell die Rücksteuerung, sodass die Aktion **Zurück zum Shop** auf Seitenebene ausgeblendet werden kann.
## Aktualisierung überprüfen
1. Öffnen Sie **Neuigkeiten** aus der Arbeitsbereich-Seitenleiste oder dem Avatar-Menü.
2. Beginnen Sie mit **Alle**, um Veröffentlichungen in Datumsreihenfolge zu sehen.
3. Wählen Sie **Funktion**, **Verbesserung** oder **Behebung**, wenn Sie eine Art von Änderung benötigen.
4. Lesen Sie den Veröffentlichungstitel, das Datum, die Beschreibung und alle enthaltenen Medien.
5. Verwenden Sie die Rücksteuerung, um zum Shop oder Arbeitsbereich zurückzukehren, von dem Sie gekommen sind.
## Fehlerbehebung
| Status | Bedeutung und nächster Schritt |
| --- | --- |
| Roter Ungelesen-Punkt | Eine neuere Aktualisierung wurde nicht geöffnet. Öffnen Sie Changelog, um ihn zu löschen. |
| **Heute** | Das Veröffentlichungsdatum entspricht dem aktuellen Tag. |
| Kein Element unter einem Filter | Keine verfügbare Veröffentlichung hat diese Kategorie. Kehren Sie zu **Alle** zurück. |
| Neueste-Veröffentlichungs-Vorschau | Das Anhalten über dem eingeklappten Desktop-Symbol kann die neueste Aktualisierung anzeigen. Wählen Sie **Alle anzeigen** für den vollständigen Verlauf. |
| Zurück kehrt zu einem anderen Bereich zurück | Öffnen Sie den beabsichtigten Arbeitsbereich oder das beabsichtigte Projekt erneut, und öffnen Sie dann Changelog von dort aus, damit Runner den richtigen Rückgabekontext hat. |
## Mit einem Eintrag im Änderungsprotokoll den nächsten Schritt finden
1. Öffnen Sie **Neuigkeiten** und wählen Sie **Funktion**, **Verbesserung**, **Fehlerbehebung** oder **Alle**.
2. Lesen Sie den datierten Eintrag zu dem Verhalten, das Sie kennenlernen möchten.
3. Kehren Sie mit **Zurück zum Store** zurück und öffnen Sie das betreffende Werkzeug über die Projektnavigation.
**Prüfpunkt:** Die gefilterte Liste zeigt die gewählte Änderungskategorie. Das Änderungsprotokoll beschreibt Änderungen. Ob Sie diese nutzen können, hängt vom aktuellen Tarif und den freigeschalteten Funktionen Ihres Arbeitsbereichs ab.
## Verwandte Leitfäden
- [Support und Community](/de/guides/help-and-reference/support-and-community)
- [Arbeitsbereich-Navigation und Suche](/de/guides/workspace/navigation-and-search)
- [Funktionsverfügbarkeit](/de/guides/advanced/feature-availability)
---
# Häufig gestellte Fragen
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/faq
**Eingabepfad:** Runner-Dokumentation → **Hilfe und Referenz** → **Häufig gestellte Fragen**.
### Kann ich ohne technische Erfahrung anfangen?
Ja. Beschreiben Sie das Geschäft und die gewünschte Kundenerfahrung in einfacher Sprache. Runner kann vor Arbeitsbeginn Folgefragen stellen. Siehe [Effektive Anfragen schreiben](../work-with-runner/write-effective-requests).
### Sollte ich einen neuen Store erstellen oder Shopify verbinden?
Wählen Sie **Neu erstellen**, wenn Runner das Store-Projekt und sein Commerce-Setup erstellen soll. Wählen Sie **Shopify verbinden**, wenn Shopify das verbundene Store-System und der Checkout-Pfad bleiben soll. Siehe [Runner-Store erstellen](../start-here/create-runner-store) und [Shopify verbinden](../start-here/connect-shopify).
### Bedeutet eine abgeschlossene Runner-Aufgabe, dass mein Store live ist?
Nein. Aufgabenvollendung, Vorschau-Erfolg, Veröffentlichung, Live-Storefront, Katalog und Checkout sind separate Ergebnisse. Überprüfen Sie jede relevante Ebene.
### Was ist der Unterschied zwischen Veröffentlichen und Erneut veröffentlichen?
**Veröffentlichen** erstellt die erste Live-Version nach Abschluss der Anforderungen. **Erneut veröffentlichen** sendet neuere Entwurfsänderungen an einen Store, der bereits eine Live-Version hat. Siehe [Veröffentlichen und erneut veröffentlichen](../storefront-and-publishing/publish-and-republish).
### Warum ist eine Schaltfläche deaktiviert?
Eingabe, Berechtigung, Planzugriff, Store-Status, Daten oder eine Verbindung können fehlen. Lesen Sie den nahegelegenen Text und siehe [Zustände und Verfügbarkeit](./states-and-availability).
### Warum fehlt ein Navigationseintrag?
Einige Funktionen sind bedingt oder gestaffelt. Bestätigen Sie den Arbeitsbereich, Store, Rolle, Plan, Veröffentlichung und Verbindungen. Siehe [Funktionsverfügbarkeit](../advanced/feature-availability).
### Wo verwalte ich Produkte und Bestellungen?
Öffnen Sie das Store-Projekt, wählen Sie **Shop-Betrieb** und wählen Sie dann **Produkte** oder **Bestellungen**. Siehe [Shop-Betrieb](../store-operations).
### Wo verbinde ich Zahlungen, E-Mail oder Versand?
Öffnen Sie das Projekt und wählen Sie **Apps**. Wählen Sie den Anbieter und folgen Sie seinem offiziellen Verbindungsfluss. Siehe [Apps und Integrationen](../apps-and-integrations).
### Wie mache ich eine Storefront-Änderung rückgängig?
Senden Sie zuerst eine fokussierte Korrektur oder verwenden Sie [Versionsverlauf](../storefront-and-publishing/version-history). Das Wiederherstellen einer Version ändert den Projektstatus, daher überprüfen Sie die ausgewählte Version vor der Bestätigung.
### Warum sind Analytics oder SEO leer?
Der ausgewählte Store, Datumsbereich, Veröffentlichung oder Ereigniserfassung hat möglicherweise noch keine Daten. Ein leerer Zustand unterscheidet sich von einem Lade- oder Fehlerzustand. Siehe [Analytics und SEO](../analytics-and-seo).
### Wo sehe ich Credits und Nutzung?
Öffnen Sie Arbeitsbereich-Einstellungen und wählen Sie das Nutzungs- oder Abrechnungsziel, das für Ihre Rolle verfügbar ist. Siehe [Guthaben und Nutzung](../plans-and-billing/credits-and-usage).
### Wie bekomme ich Hilfe?
Verwenden Sie [Support und Community](./support-and-community). Geben Sie die genaue Seite, Aktion, sichtbaren Zustand und einen datenschutzsicheren Screenshot an.
## Womit sollte ich beginnen?
Für den ersten Aufbau mit Screenshots und Aufzeichnungen folgen Sie [Ihren ersten Store erstellen](../start-here/first-store-quickstart). Läuft bereits eine Aufgabe, lesen Sie [Runner-Aufgaben beheben](./troubleshoot-runner-tasks), bevor Sie dieselbe Anfrage erneut senden.
---
# Glossar
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/glossary
**Eingabepfad:** Runner-Dokumentation → **Hilfe und Referenz** → **Glossar**.
| Begriff | Bedeutung in Runner |
| --- | --- |
| Agent | Runner-Funktionen, die wiederverwendbare Skills und Projekt- oder Arbeitsbereich-Memory verwenden. |
| App | Eine Verbindung zwischen Runner und einem anderen Service oder eine Fähigkeit auf Agent-Ebene, die auf der Apps-Seite angezeigt wird. |
| Artefakt | Eine Ausgabe, die während einer Aufgabe oder eines Workflows erzeugt wird, z. B. ein Bericht, eine Datei, eine Vorschau oder ein früheres Aufgabenergebnis. |
| Automatisierung | Eine konfigurierte Aktion, die von einem Trigger oder Zeitplan aus ausgeführt wird, wenn verfügbar. |
| Chat | Eine Projektkonversation, in der Sie Arbeit anfordern und überprüfen. |
| Kasse | Der Kundenpfad, der Versand- und Zahlungsinformationen erfasst, um eine Bestellung zu erstellen. |
| Guthaben | Arbeitsbereich-Nutzungszulage, die im aktuellen Produkt angezeigt wird. Die Live-Abrechnungsseite ist maßgeblich. |
| Design-Modus | Eine Storefront-Bearbeitungsansicht zum Auswählen und Ändern sichtbarer Inhalte. |
| DNS | Die Internet-Einträge, die einen Domainnamen mit der korrekten Storefront verbinden. Runner zeigt die Werte an, die Sie in Ihren Domain-Anbieter kopieren können. |
| Entwurf | Ein Store ohne aktuelle Live-Veröffentlichung. |
| Endpunkt | Eine Zieladresse, die von einer Integration verwendet wird, z. B. ein Webhook-Empfänger. Behandeln Sie Endpunktadressen und ihre Anmeldedaten als vertraulich. |
| Experiment | Ein kontrollierter Vergleich zur Messung einer Änderung, wenn die Funktion verfügbar ist. |
| Fly | Ein bedingter geführter Missions-Arbeitsbereich. |
| Erfüllung | Die Arbeit der Vorbereitung und des Versands von Artikeln aus einer Bestellung, einschließlich aller unterstützten Lieferanten- oder Versandanbieter-Schritte. |
| Speicher | Gespeicherter Kontext, den Runner in seinem definierten Umfang wiederverwenden kann. |
| Medienbibliothek | Der Ort des Projekts für generierte oder hochgeladene visuelle Assets. |
| Vorschau | Die aktuelle Storefront-Ansicht des Projekts vor oder unabhängig von der Veröffentlichung. |
| Projekt | Der Store-spezifische Runner-Arbeitsbereich mit Chat, Storefront, Betrieb, Apps und Tools. |
| Anbieter | Ein externer Service, der mit Runner für Zahlungen, Versand, E-Mail, Beschaffung, Analytics oder eine andere unterstützte Aufgabe verbunden ist. |
| Veröffentlichen | Erstellen Sie die erste Live-Version nach bestandenen Anforderungen. |
| Erneut veröffentlichen | Senden Sie neuere Entwurfsänderungen an einen Store, der bereits eine Live-Version hat. |
| Recherche | Ein bedingter Arbeitsbereich für strukturierte Geschäftsstudien und Berichte. |
| Sitzung (Analytics) | Ein aufgezeichneter Storefront-Besuch, der in Verkehrs- und Konversionsberichten verwendet wird. Er unterscheidet sich von einer angemeldeten Kontositzung. |
| Sitzung (Konto) | Eine angemeldete Runner-Verbindung auf einem Browser oder Gerät, die in den Sicherheitseinstellungen überprüft oder widerrufen werden kann. |
| Simulation | Ein Tool zum Ausführen eines konfigurierten Szenarios und Überprüfen seines Ergebnisses, wenn verfügbar. |
| Skill | Ein wiederverwendbarer Satz von Anweisungen oder Workflow, den Runner auf Arbeit anwenden kann. |
| SKU | Ein vom Store definierter Code zur Identifizierung eines Produkts oder einer Variante für Bestand und Betrieb. |
| Shop-Betrieb | Produkt-, Bestell-, Kunden-, Promotions-, Versand-, Beschaffungs- und Store-Management-Seiten. |
| Aufgabe | Eine Arbeitseinheit, die Runner in einer Konversation verfolgt. |
| Variante | Eine käufliche Version eines Produkts, z. B. eine bestimmte Größe oder Farbe, mit eigenem Preis oder Bestand. |
| Version | Ein gespeicherter Storefront-Zustand, der im Versionsverlauf angezeigt wird. |
| Webhook | Eine konfigurierte Lieferung eines unterstützten Projektereignisses an einen anderen Service. |
| Workflow | Ein wiederverwendbarer mehrstufiger Projektfluss, wenn die Funktion aktiviert ist. |
| Arbeitsbereich | Die Team- und Abrechnungsgrenze, die Stores, Mitglieder, Einstellungen, Credits und Benachrichtigungen enthält. |
## Die Begriffe in einem echten Ablauf kennenlernen
Folgen Sie [Ihren ersten Store erstellen](../start-here/first-store-quickstart), um eine Unterhaltung, eine Aufgabe, eine Vorschau und eine Veröffentlichungsprüfung im Zusammenhang zu sehen. Bei einer Statusmeldung hilft [Status und Verfügbarkeit](./states-and-availability), die nächste Aktion zu wählen.
## Verwandte Anleitungen
- [Willkommen bei Runner AI](../product-guide)
- [Zustände und Verfügbarkeit](./states-and-availability)
- [Funktionsverfügbarkeit](../advanced/feature-availability)
---
# Zustände und Verfügbarkeit
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/states-and-availability
Runner verwendet Zustände, um Ihnen mitzuteilen, ob eine Aktion bereit, wartend, abgeschlossen, blockiert oder nicht verfügbar ist. Lesen Sie den Zustand, bevor Sie erneut versuchen oder Einstellungen ändern.
**Einstiegspfad:** Runner-Dokumentation → **Hilfe und Referenz** → **Zustände und Verfügbarkeit**.
## Store- und Veröffentlichungszustände
| Zustand | Bedeutung | Sichere nächste Aktion |
| --- | --- | --- |
| Entwurf | Das Projekt hat derzeit keine live veröffentlichte Version. | Fahren Sie mit dem Erstellen fort und erfüllen Sie die Veröffentlichungsanforderungen. |
| Wird bereitgestellt | Runner bereitet eine Veröffentlichung vor. | Warten Sie, bis der Zustand abgeschlossen ist; starten Sie keine wiederholten Veröffentlichungen. |
| Veröffentlicht | Eine Live-Version existiert. | Öffnen Sie die Live-URL und überprüfen Sie die beabsichtigte Änderung. |
| Veröffentlichung blockiert | Ein oder mehrere erforderliche Setup-Elemente sind unvollständig. | Öffnen Sie die benannte Anforderung und schließen Sie sie ab. |
| Neuveröffentlichung verfügbar | Der Entwurf enthält Änderungen, die neuer als die Live-Version sind. | Überprüfen Sie die [Vorschau](/de/guides/storefront-and-publishing/preview-your-store) und veröffentlichen Sie dann erneut, wenn Sie bereit sind. |
## Aufgabenzustände
| Zustand | Bedeutung | Sichere nächste Aktion |
| --- | --- | --- |
| Wartet auf Sie | Runner benötigt eine Antwort, Auswahl, Genehmigung oder fehlende Details. | Öffnen Sie die Frage und antworten Sie einmal. |
| Funktioniert | Die aktuelle Aufgabe wird noch ausgeführt. | Folgen Sie stattdessen ihren Details, anstatt eine doppelte Anfrage zu starten. |
| Abgeschlossen | Runner hat den Endzustand der Aufgabe erreicht. | Überprüfen Sie das sichtbare Ergebnis auf der betroffenen Seite. |
| Gestoppt | Die Arbeit endete vor Abschluss. | Lesen Sie, warum sie gestoppt wurde, korrigieren Sie die Ursache und fahren Sie dann fort oder senden Sie eine fokussierte Nachverfolgung. |
| Fehlgeschlagen | Die Aufgabe konnte nicht abgeschlossen werden. | Speichern Sie den sichtbaren Fehler und versuchen Sie es erneut, nachdem Sie die Ursache überprüft haben. |
## Seiten- und Steuerelementzustände
| Was Sie sehen | Bedeutung |
| --- | --- |
| Deaktivierte Schaltfläche | Erforderliche Eingabe, Berechtigung, Plan oder Zustand fehlt. Nahegelegener Text nennt normalerweise den Grund. |
| Lade-Skelett oder Spinner | Daten werden angefordert. Ein persistenter Ladezustand benötigt ein Neuladen oder eine Support-Überprüfung. |
| Leerer Zustand | Die Seite ist verfügbar, aber der ausgewählte Kontext hat noch keine Elemente. Verwenden Sie die angebotene Erstell- oder Verbindungsaktion. |
| Upgrade-Nachricht | Der aktuelle Plan oder die Grenze erlaubt die Aktion nicht. Überprüfen Sie das Live-Angebot in **Plan & Abrechnung**. |
| Verbinden oder erneut verbinden | Der externe Service ist nicht verbunden oder benötigt erneut Autorisierung. |
| Seite nicht gefunden | Die URL ist im aktuellen Kontext nicht verfügbar, veraltet oder zugriffsbeschränkt. Kehren Sie über die sichtbare Navigation zurück. |
## Runner-Versionswiederherstellung
Wenn Runner aktualisiert wurde, während Ihr Tab offen war, kann eine Vollbildwiederherstellungsseite die aktuelle Ansicht ersetzen. Sie können sie nicht schließen oder die Seite dahinter verwenden, bis Runner eine aktuelle Kopie lädt.
| Was Sie sehen | Was als Nächstes passiert |
| --- | --- |
| **Eine neuere Version von Runner ist bereit** | Wählen Sie **Neueste Version laden**, um den aktuellen Tab mit der neuesten Runner-Version neu zu laden. |
| **Sie sind offline** | **Neueste Version laden** ist deaktiviert. Stellen Sie die Internetverbindung wieder her; die Aktion wird verfügbar, ohne die Wiederherstellungsseite zu verlassen. |
| **Neueste Version wird geladen…** | Runner lädt den Tab neu. Halten Sie ihn offen, während die Aktion abgeschlossen wird. |
| **Wir konnten die neueste Version nicht laden** | Überprüfen Sie die Verbindung und wählen Sie dann **Erneut versuchen**. |
| **Technische Details** | Erweitert den Fehlercode, Grund und Erkennungszeit zur Fehlerbehebung. Es wird nicht erneut versucht oder die Seite repariert. |
## Diagnose in Reihenfolge
1. Bestätigen Sie den ausgewählten Workspace und Store.
2. Klappen Sie **Aufbauen**, **Wachstum** oder **Messen** auf, um das Werkzeug zu finden. Lesen Sie dann den zugehörigen Status, die Warnung oder die Voraussetzung.
3. Überprüfen Sie, ob die relevante Aufgabe bereits ausgeführt wird.
4. Bestätigen Sie Ihre Rolle, Plan, Veröffentlichungszustand und erforderliche App-Verbindung.
5. Laden Sie einmal neu, wenn sich der Zustand gerade geändert haben sollte.
6. Verwenden Sie die relevante Fehlerbehebungsanleitung, bevor Sie eine hochgradig wirkungsvolle Aktion wiederholen.
## Verwandte Anleitungen
- [Feature-Verfügbarkeit](../advanced/feature-availability)
- [Aufgabenzustände und Details](../work-with-runner/task-states-and-details)
- [Store-Status](../workspace/store-statuses)
- [Support und Community](./support-and-community)
---
# Support und Community
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/support-and-community
Verwenden Sie Dokumentation für bekannte Workflows, Community für gemeinsames Lernen und Support für kontospezifische oder reproduzierbare Produktprobleme.
## Was dieser Leitfaden abdeckt
Sie werden wissen, wo jede Hilfemaßnahme geöffnet wird, wie Sie eine Demo buchen oder Feedback geben, und was Sie einbeziehen sollten, wenn Sie Support benötigen.
## Verfügbarkeit und Voraussetzungen
- Sie müssen angemeldet sein, um die Avatar-Menüs des Arbeitsbereichs oder Projekts zu verwenden.
- **Feedback senden** wird nur in Desktop-Arbeitsbereichs- oder Projektansichten angezeigt, die die Feedback-Aktion verfügbar machen.
- **Demo buchen** verwendet einen externen Planungsdienst in Runner und benötigt eine funktionierende Netzwerkverbindung.
- Das mobile Avatar-Blatt hat einen kleineren Aktionssatz als das Desktop-Avatar-Menü.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgNbwG0GU2bm17vuEiZydJjwfYlOaXgBTsQ69k)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Das Hilfemenü im Chat verlinkt auf kontextbezogene Hilfe und das Hilfecenter. Das Tutorial-Vorschaubild ist in dieser Abbildung verdeckt; es wurde kein Video abgespielt und keine Supportmeldung gesendet.
## Eingabepfade
| Eingabe | Was nach der Auswahl passiert |
| --- | --- |
| Hilfeschaltfläche der Seite → **Hilfezentrum** | Öffnet die Runner-Dokumentation. |
| Hilfe-Popover der Seite → **Auf dieser Seite — Chat** | Öffnet die Hilfe zur aktuellen Chat-Seite, wenn dieser Kontext angezeigt wird. |
| Hilfe-Popover der Seite → **Ihr erster Shop in fünf Minuten** | Öffnet die verlinkte Einsteigeranleitung. |
| Seitenleiste des Arbeitsbereichs → **Hilfezentrum**, falls angezeigt | Öffnet die Runner-Dokumentation. |
| Arbeitsbereich-Seitenleiste → **Community** | Öffnet die Runner-Community an ihrem aktuellen Ziel. |
| Arbeitsbereich-Seitenleiste → **Blog** | Öffnet Bildungs- und Unternehmensartikel. |
| Arbeitsbereich-Seitenleiste → **Neuigkeiten** | Öffnet aktuelle Runner-Produktaktualisierungen. |
| Desktop-Avatar-Menü → **Demo buchen** | Öffnet das Planungsfeld in Runner. |
| Desktop-Avatar-Menü → **Feedback senden** | Öffnet das Feedback-Formular, wenn diese Aktion in der aktuellen Ansicht verfügbar ist. |
| Desktop-Avatar-Menü → **Hilfe** | Öffnet die Runner-Dokumentation. |
| Projekt-Avatar-Menü → **Community**, **Blog** oder **Neuigkeiten** | Öffnet die ausgewählte Ressource; das Änderungsprotokoll bleibt in Runner, während Community und Blog ihre aktuellen Ziele öffnen. |
| Dokumentation → **Support** | Öffnet die konfigurierte Support-E-Mail-Aktion. |
## Mit der Hilfe zur aktuellen Seite beginnen
1. Öffnen Sie die Hilfeschaltfläche der Seite.
2. Wählen Sie die Anleitung unter **Auf dieser Seite**, wenn sie zu Ihrer Frage passt, oder **Hilfezentrum**, um die Dokumentation zu durchsuchen.
3. Wenn Sie einen Store einrichten, wählen Sie **Ihr erster Shop in fünf Minuten**, sofern angeboten.
**Prüfpunkt:** Eine Hilfeseite öffnet sich. Es wurde weder eine Supportanfrage gesendet noch ein Termin gebucht. Die angebotenen Seitenlinks hängen von der aktuellen Ansicht ab.
## Demo buchen
1. Öffnen Sie auf dem Desktop das Avatar-Menü und wählen Sie **Demo buchen**.
2. Warten Sie, bis der Planer geladen wird.
3. Wählen Sie ein verfügbares Datum und eine Uhrzeit, füllen Sie dann die vom Planer angeforderten Kontaktdetails aus.
4. Bestätigen Sie die Buchung im Planer.
5. Warten Sie auf Runners Erfolgsmeldung und dass sich das Feld schließt.
Das Schließen des Feldes vor der Bestätigung des Planers erstellt keine Buchung. Wenn der Planer leer bleibt oder meldet, dass er nicht verfügbar ist, schließen Sie ihn, überprüfen Sie die Verbindung und versuchen Sie es erneut. Verwenden Sie die Dokumentations-Support-Aktion, wenn sie wiederholt fehlschlägt.
## Feedback senden
1. Öffnen Sie auf dem Desktop das Avatar-Menü und wählen Sie **Feedback senden**, falls angezeigt.
2. Beschreiben Sie die Seite, die Aktion, das erwartete und das tatsächliche Ergebnis.
3. Fügen Sie optional eine Kategorie und einen Screenshot hinzu, aus dem Sie zuvor vertrauliche Informationen entfernt haben.
4. Prüfen Sie die Meldung vor **Übermitteln**. Schließen Sie das Formular, wenn Sie es nur ansehen möchten.
5. Warten Sie nach dem Absenden auf eine Bestätigung, bevor Sie davon ausgehen, dass die Meldung gesendet wurde.
| Steuerelement | Was nach der Verwendung passiert |
| --- | --- |
| **Beschreiben Sie Ihr Feedback** | Notiert die erforderliche Erklärung. Senden bleibt nicht verfügbar, bis dieses Feld Text enthält. |
| **Usability-Probleme** / **Fehlende Funktionen** | Fügt eine optionale Kategorie hinzu, damit der Bericht leichter weitergeleitet werden kann. |
| Screenshot-Upload | Hängt ein optionales Bild an den Bericht an. Verwenden Sie das Entfernen-Steuerelement, um die Anlage vor dem Senden zu verwerfen. |
| **Senden** | Sendet den Bericht. Während des Sendens kann die Aktion nicht erneut gesendet werden. |
| Schließen | Schließt das Formular, ohne einen neuen Bericht zu senden. |
Beschreiben Sie ein Verhalten, die Seite, auf der es passiert ist, und was Sie erwartet haben. Fügen Sie einen Screenshot nur hinzu, nachdem Sie Kundeninformationen, E-Mails, Zahlungsdetails, Anmeldedaten und andere private Daten entfernt haben. Nach einer erfolgreichen Einreichung zeigt Runner eine Bestätigung an und schließt das Formular. Wenn die Einreichung fehlschlägt, behalten Sie die Beschreibung, überprüfen Sie die Anlage und Verbindung und versuchen Sie es erneut.
## Mobiles Avatar-Menü
Auf Mobilgeräten öffnet der Projekt-Avatar **Profil & Einstellungen**. Es enthält **Sprache**, **Posteingang**, **Hilfe**, **Community**, **Blog**, **Neuigkeiten** und **Abmelden**. **Demo buchen** und **Feedback senden** sind nicht in diesem mobilen Blatt aufgeführt. Verwenden Sie eine breitere Desktop-Ansicht für diese beiden Aktionen oder verwenden Sie die Dokumentations-Support-Aktion für ein privates Problem.
## Einen nützlichen Support-Bericht senden
Geben Sie an:
1. Den Arbeitsbereich- und Store-Namen, ohne Geheimnisse.
2. Die Seite und den genauen Eingabepfad.
3. Was Sie ausgewählt haben und was passiert ist.
4. Was Sie stattdessen erwartet haben.
5. Den sichtbaren Status oder Fehlertext.
6. Ob das Problem nach einem Neuladen wiederholt wird.
7. Einen Screenshot mit entfernten Kundendaten, E-Mails, Zahlungsdetails und Geheimnissen.
Für eine Runner-Aufgabe geben Sie die Konversation und den Aufgabenzustand an. Für die Veröffentlichung geben Sie den Vorschau-Status, den Veröffentlichungszustand und an, ob sich die Live-URL geändert hat. Für eine App geben Sie den Anbieter und den angezeigten Verbindungszustand an, aber niemals Anmeldedaten oder API-Schlüssel.
## Wählen Sie den Kanal
| Bedarf | Bester Startpunkt |
| --- | --- |
| Einen normalen Produkt-Workflow erlernen | Durchsuchen Sie diese Anleitungen. |
| Ansätze mit anderen Benutzern vergleichen | Community. |
| Eine freigegebene Produktänderung verfolgen | Änderungsprotokoll. |
| Zugriff, Abrechnung, Daten, wiederholte Fehler oder privates Projektverhalten beheben | Support. |
## Fehlerbehebung
| Zustand | Bedeutung und nächste Aktion |
| --- | --- |
| Demo-Planer wird geladen | Warten Sie auf seine Datums- und Zeitsteuerelemente, bevor Sie interagieren. |
| Demo bestätigt | Runner zeigt eine Erfolgsmeldung an und schließt das Feld. Überprüfen Sie die Bestätigungsdetails, die vom Planer gesendet wurden. |
| Feedback-Senden ist nicht verfügbar | Fügen Sie die erforderliche Beschreibung hinzu oder warten Sie, bis die aktuelle Einreichung abgeschlossen ist. |
| Feedback-Upload schlägt fehl | Entfernen Sie die Anlage und versuchen Sie es erneut mit einem unterstützten, datenschutzsicheren Bild, oder senden Sie den Text ohne es. |
| Feedback-Einreichung schlägt fehl | Der Bericht wurde nicht bestätigt. Behalten Sie den Text und versuchen Sie es erneut, bevor Sie Support verwenden. |
## Verwandte Anleitungen
- [Runner-Aufgaben fehlerbeheben](./troubleshoot-runner-tasks)
- [Storefront-Builds fehlerbeheben](./troubleshoot-storefront-builds)
- [Veröffentlichung, Checkout und Apps fehlerbeheben](./troubleshoot-publishing-checkout-apps)
- [Änderungsprotokoll](/de/guides/help-and-reference/changelog)
---
# Veröffentlichung, Checkout und Apps fehlerbeheben
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/troubleshoot-publishing-checkout-apps
Ein erfolgreicher Build beweist nicht automatisch Veröffentlichung, Katalogdaten, Checkout oder einen externen Anbieter. Überprüfen Sie jede Ebene separat.
**Zugriff:** Betroffener Store → **Onlineshop** → **Veröffentlichen** für Bereitschaftsprüfungen; **Aufbauen** → **Apps** für Anbieterverbindungen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Die Build-Prüfung besteht, aber die unvollständige Einrichtung lässt **Bestätigen** deaktiviert. Erfüllen Sie die genannte Voraussetzung, bevor Sie die Veröffentlichung erneut versuchen.
## Bevor Sie beginnen
- Notieren Sie den betroffenen Store, die öffentliche URL, den Anbieter und den genauen sichtbaren Zustand.
- Stoppen Sie vor einer echten Gebühr, Bestellung, Anbieter-Trennung oder einer anderen folgenreichen Aktion, es sei denn, der Test ist autorisiert.
- Überprüfen Sie jede Ebene separat; eine funktionierende Vorschau beweist nicht Veröffentlichung oder Checkout.
## Wichtige Steuerelemente und Ergebnisse
| Steuerelement | Was nach der Auswahl passiert |
| --- | --- |
| **Überprüfung erneut versuchen** | Führt die fehlgeschlagene Veröffentlichungs- oder Checkout-Bereitschaftsprüfung erneut aus. Es behebt nicht die benannte Ursache. |
| **Veröffentlichen** / **Erneut veröffentlichen** | Startet die Veröffentlichung, nachdem erforderliche Überprüfungen bestanden sind; es beweist nicht Katalog- oder Checkout-Verhalten. |
| **Stripe verbinden** | Öffnet den Zahlungsverbindungspfad. Keine Zahlung wird akzeptiert, bis der Anbieter und der Live-Checkout nutzbar sind. |
| **Erneut verbinden** in Apps | Startet den offiziellen Autorisierungsfluss des Anbieters für die bestehende Verbindung neu. |
## Identifizieren Sie die fehlgeschlagene Ebene
| Ebene | Beweis zum Suchen | Wenn es fehlt |
| --- | --- | --- |
| Vorschau | Die beabsichtigte Seite und Interaktion funktionieren in **Onlineshop**. | Beheben Sie den Build oder Inhalt vor der Veröffentlichung. |
| Veröffentlichung | Runner zeigt einen erfolgreichen Veröffentlichungszustand und eine Live-URL. | Öffnen Sie den Veröffentlichungsstatus und beheben Sie die benannte Anforderung oder den Fehler. |
| Live-Storefront | Die Live-URL zeigt die beabsichtigte Version bei einem frischen Besuch. | Überprüfen Sie, ob neuere Änderungen **Erneut veröffentlichen** erfordern. |
| Katalog | Das erwartete Produkt, der Preis, die Verfügbarkeit und die Versandwahl sind sichtbar. | Korrigieren Sie Daten im Shop-Betrieb und Storefront-Verfügbarkeit. |
| Kasse | Ein sicherer Test kann den erwarteten Checkout und Zahlungs-/Versandwahlmöglichkeiten erreichen. | Überprüfen Sie Zahlungen, Versand, Store-Modus und Anbieter-Status. Platzieren Sie keine echte Bestellung, es sei denn, dies ist autorisiert. |
| Anbieter | Die App zeigt verbunden und der Anbieter bestätigt das erwartete Konto. | Verbinden Sie sich erneut über den offiziellen App-Fluss und überprüfen Sie die Berechtigungen erneut. |
## Veröffentlichungs-Wiederherstellung
1. Öffnen Sie **Onlineshop** → **Veröffentlichen** und lesen Sie die Bereitschaftsprüfungen. Halten Sie bei einer fehlenden Stripe-, Versand- oder anderen genannten Voraussetzung an. Erfüllen Sie diese anhand von [Veröffentlichung vorbereiten](../storefront-and-publishing/prepare-to-publish), bevor Sie es erneut versuchen.
2. Überprüfen Sie, ob eine andere Veröffentlichung bereits **Wird bereitgestellt**.
3. Wenn die Veröffentlichung fehlschlägt, speichern Sie den angezeigten Fehler.
4. Versuchen Sie es nur erneut, nachdem die benannte Ursache behoben wurde.
5. Öffnen Sie die Live-URL nach dem Erfolg und überprüfen Sie die beabsichtigte Seite.
## Checkout-Wiederherstellung
1. Bestätigen Sie, dass mindestens ein verkäufliches Produkt im Live-Store sichtbar ist.
2. Bestätigen Sie, dass der Versand für das Test-Ziel gilt.
3. Bestätigen Sie, dass die Zahlungs-App mit dem beabsichtigten Modus und Konto verbunden ist.
4. Erreichen Sie den Checkout über die Live-Storefront, anstatt eine direkt erratene URL.
5. Stoppen Sie vor einer echten Gebühr oder Bestellung, es sei denn, der Test ist explizit autorisiert.
## App-Wiederherstellung
1. Öffnen Sie **Aufbauen** → **Apps** und wählen Sie den Anbieter.
2. Lesen Sie den angezeigten Zustand: nicht verbunden, verbunden, benötigt Aufmerksamkeit oder nicht verfügbar.
3. Verbinden Sie sich nur über das offizielle Autorisierungsfenster des Anbieters erneut.
4. Bestätigen Sie das zurückgegebene Konto und die Berechtigungen.
5. Überprüfen Sie das tatsächliche nachgelagerte Ergebnis; ein grünes Verbindungs-Badge allein ist kein End-to-End-Beweis.
### Video: eine Veröffentlichungssperre prüfen
Die Aufzeichnung in der englischen Oberfläche prüft die Voraussetzungen und wählt dann Abbrechen. Dabei wird kein Store veröffentlicht und kein Kauf abgeschlossen.
## Verwandte Anleitungen
- [Veröffentlichen und erneut veröffentlichen](../storefront-and-publishing/publish-and-republish)
- [Live-Store und Checkout](../storefront-and-publishing/live-store-and-checkout)
- [Apps verbinden, verwalten und erneut verbinden](../apps-and-integrations/connect-manage-reconnect)
- [Apps-Fehlerbehebung](../apps-and-integrations/troubleshooting)
---
# Runner-Aufgaben beheben
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/troubleshoot-runner-tasks
Beheben Sie das Problem zunächst anhand der aktuellen Aufgabendetails. Das Wiederholen derselben Anfrage ohne Überprüfung ihres Status kann zu doppelter Arbeit führen und die ursprüngliche Ursache verbergen.
## Einstiegspfad
Öffnen Sie den betroffenen Store, kehren Sie zur Konversation zurück und öffnen Sie dann den Status oder die Details der aktuellen Aufgabe.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Eine offene Frage muss beantwortet werden, bevor die Arbeit fortgesetzt werden kann. Prüfen Sie die letzte Frage, bevor Sie dieselbe Anfrage erneut senden.
## Bevor Sie beginnen
- Halten Sie die ursprüngliche Konversation offen, damit Sie den sichtbaren Status oder Fehler nicht verlieren.
- Warten Sie, bis alle aktiven Aktionen abgeschlossen sind, bevor Sie erneut versuchen.
- Fügen Sie keine Geheimnisse, Zahlungsdetails oder Kundendaten in kopierte Nachweise ein.
## Wiederherstellungs-Checkliste
1. Bestätigen Sie, dass Sie sich in der Konversation befinden, in der die Arbeit begonnen hat.
2. Lesen Sie die neueste Runner-Nachricht und den Aufgabenstatus.
3. Wenn Runner eine Frage gestellt hat, beantworten Sie diese Frage, bevor Sie eine neue Anfrage senden.
4. Wenn die Aufgabe gestoppt hat, bestimmen Sie, ob sie Eingabe, Zugriff, Guthaben oder eine korrigierte Anfrage benötigt.
5. Wenn sie fehlgeschlagen ist, kopieren Sie den sichtbaren Fehler, ohne Geheimnisse oder Kundendaten einzubeziehen.
6. Versuchen Sie erneut, nur wenn die Seite einen Wiederholungsversuch anbietet und die Ursache vorübergehend ist.
7. Senden Sie andernfalls eine fokussierte Nachverfolgung, die das gewünschte Ergebnis und das aktuelle Problem angibt.
8. Überprüfen Sie die betroffene Storefront, Einstellung oder das Asset, nachdem Runner die Fertigstellung meldet.
## Häufige Probleme
| Problem | Was zu tun ist |
| --- | --- |
| Nach dem Senden passiert nichts | Bestätigen Sie, dass die Nachricht in der Konversation angezeigt wird, und überprüfen Sie die Aufgabendetails auf einen Wartestatus. |
| Runner stellt wiederholte Fragen | Beantworten Sie jedes erforderliche Feld direkt und vermeiden Sie es, das Ziel in derselben Antwort zu ändern. |
| Die Aufgabe stoppt wegen Guthaben | Öffnen Sie die Nutzungs- oder Planeinstellungen; wiederholen Sie nicht wiederholt unveränderte Arbeit. |
| Das Ergebnis ist unvollständig | Nennen Sie das fehlende sichtbare Ergebnis in einer Nachverfolgung. Fügen Sie einen Screenshot an, wenn er hilft, das Problem zu lokalisieren. |
| Die falsche Seite wurde geändert | Verwenden Sie die Versionsverlauf, falls angemessen, und identifizieren Sie dann die genaue Seite oder den Abschnitt in der Korrektur. |
| Ein Wiederholungsversuch schlägt auf die gleiche Weise fehl | Beenden Sie die Wiederholungsversuche und kontaktieren Sie den Support mit der Konversation, dem Aufgabenstatus und dem Fehler. |
## Schaltflächen und Ergebnisse
| Steuerelement | Ergebnis |
| --- | --- |
| Aufgabendetails | Öffnet Status, Fortschritt und alle verfügbaren Ergebnisinformationen. |
| Antwort- oder Optionssteuerelement | Sendet die angeforderte Entscheidung und lässt die Aufgabe fortfahren. |
| Stopp, falls verfügbar | Beendet den aktuellen Durchlauf; unvollendete Arbeit kann unvollständig bleiben. |
| Wiederholen oder fortfahren | Startet einen weiteren Versuch aus dem Status, den Runner unterstützt. Verwenden Sie ihn nur nach Überprüfung der Ursache. |
| Neuer Chat | Startet eine separate Konversation; sie repariert die ursprüngliche Aufgabe nicht automatisch. |
## Die Behebung prüfen, bevor Sie eine weitere Anfrage senden
Prüfen Sie nach dem Beantworten einer Frage, ob Ihre Antwort erscheint und die Aufgabe den Wartezustand verlässt. Wiederholen Sie nach einer Korrektur die betroffene Aktion im Store. Kann Runner nicht feststellen, ob eine externe Aktion abgeschlossen wurde, prüfen Sie deren Ergebnis vor einem erneuten Versuch, um Duplikate zu vermeiden. [Aufgabenstatus und Details](../work-with-runner/task-states-and-details) beschreibt die verfügbaren Bedienelemente in der aktuellen Unterhaltung.
## Verwandte Leitfäden
- [Mit Runner chatten](../work-with-runner/chat-with-runner)
- [Wenn Runner eine Frage stellt](../work-with-runner/answer-runner-questions)
- [Effektive Anfragen schreiben](../work-with-runner/write-effective-requests)
- [Support und Community](./support-and-community)
---
# Storefront-Builds beheben
Source: https://www.runnerai.com/docs/de/guides/help-and-reference/troubleshoot-storefront-builds
Die Vorschau ist der sicherste Ort, um Storefront-Probleme zu finden. Veröffentlichen Sie nicht, bis die wichtigen Seiten und Interaktionen dort funktionieren.
**Zugriff:** Betroffener Store → **Onlineshop** → Vorschau-Steuerelemente.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Verwenden Sie die aktuelle Storefront-Vorschau und ihre Geräteauswahl, um das Problem auf der betroffenen Seite vor der Veröffentlichung nachzustellen.
## Bevor Sie beginnen
- Öffnen Sie den betroffenen Store und identifizieren Sie die Seite und Gerätebreite, auf der das Problem auftritt.
- Lassen Sie die neueste Runner-Aufgabe abschließen, bevor Sie ihr Ergebnis mit der Vorschau vergleichen.
- Verwenden Sie zuerst die Vorschau; veröffentlichen Sie kein fehlerhaftes oder unsicheres Ergebnis als Test.
## Beginnen Sie in der Storefront
1. Öffnen Sie den betroffenen Store und wählen Sie **Onlineshop**.
2. Bestätigen Sie, dass die Vorschau das erwartete Projekt und die neueste Version anzeigt.
3. Laden Sie die Vorschau einmal neu.
4. Überprüfen Sie Desktop- und Mobilgeräteansichten.
5. Öffnen Sie die betroffene Seite durch die Vorschaunavigation.
6. Vergleichen Sie das Ergebnis mit der neuesten Runner-Aufgabe und dem Versionsverlauf.
## Häufige Probleme
| Was Sie sehen | Was zu überprüfen ist |
| --- | --- |
| Leere oder fehlerhafte Vorschau | Warten Sie, bis der aktive Build abgeschlossen ist, laden Sie einmal neu und überprüfen Sie die aktuelle Aufgabe auf einen Fehler. |
| Alter Inhalt | Bestätigen Sie, dass die neueste Aufgabe abgeschlossen ist und dass die Vorschau die neueste Version anzeigt. |
| Layout bricht bei einer Breite | Reproduzieren Sie es mit den Gerätesteuerungen und teilen Sie Runner die Seite, den Abschnitt und die Breite mit. |
| Fehlende Abbildung | Überprüfen Sie die Medienbibliothek, die Asset-Auswahl und ob das Bild selbst geladen wird. |
| Link öffnet die falsche Seite | Nennen Sie die Quellschaltfläche und das beabsichtigte Ziel in einer fokussierten Korrektur. |
| Produkt fehlt | Überprüfen Sie, dass das Produkt existiert und für die Storefront verfügbar ist, nicht nur dass die Seite poliert aussieht. |
| Design-Modus-Änderung fehlt | Bestätigen Sie, dass die Bearbeitung gespeichert oder angewendet wurde, öffnen Sie dann die gleiche Seite erneut in der Vorschau. |
## Nützliche Steuerelemente
| Steuerelement | Ergebnis |
| --- | --- |
| Vorschau aktualisieren | Lädt die aktuelle Vorschau neu, ohne sie zu veröffentlichen. |
| Geräteauswahl | Ändert die Vorschaubreite, damit Sie responsive Layouts überprüfen können. |
| Vorschau öffnen oder externe Ansicht | Öffnet eine größere Vorschau; es macht den Store nicht live. |
| Design-Modus | Ermöglicht es Ihnen, sichtbare Storefront-Inhalte auszuwählen und anzupassen. |
| Versionsverlauf | Zeigt gespeicherte Versionen und Wiederherstellungssteuerelemente. Das Wiederherstellen ändert den Projektstatus, daher überprüfen Sie zuerst. |
## Mit nützlichen Nachweisen eskalieren
Fügen Sie den Projektnamen, die Seite, die Gerätegröße, das erwartete Ergebnis, das sichtbare Ergebnis, den neuesten Aufgabenstatus und einen Screenshot ohne persönliche oder Kundendaten ein.
## Die Korrektur überprüfen
Laden Sie nach Abschluss der Reparaturaufgabe dieselbe betroffene Seite neu und wiederholen Sie die Interaktion bei der ursprünglichen Gerätebreite. Prüfen Sie vor der Veröffentlichung eine zweite Breite. Eine funktionierende Startseite allein bestätigt nicht, dass eine defekte Produktseite oder ein Warenkorb repariert wurde.
### Video: Gerätebreiten in der Vorschau vergleichen
Die Aufzeichnung in der englischen Oberfläche wechselt zwischen PC-, Pad- und Phone-Vorschau. Sie zeigt den Vergleich der Breiten, keine Fehlerbehebung und keine veröffentlichte Änderung.
## Verwandte Leitfäden
- [Vorschau Ihres Stores](../storefront-and-publishing/preview-your-store)
- [Design-Modus](../storefront-and-publishing/design-mode)
- [Versionsverlauf](../storefront-and-publishing/version-history)
- [Runner-Aufgaben beheben](./troubleshoot-runner-tasks)
---
# Eröffnen Sie Ihren ersten Store
Source: https://www.runnerai.com/docs/de/guides/open-your-first-store
Dieser Leitfaden ist ein einziger geordneter Weg von der Geschäftsidee zu einem Store, der Geld annehmen kann. Er ist für Menschen geschrieben, die noch nie etwas online verkauft haben, und erklärt die E-Commerce-Grundlagen unterwegs.
Neu bei Runner? Folgen Sie [Ihren ersten Store erstellen](./start-here/first-store-quickstart) mit Screenshots und kurzen Videos. Kehren Sie anschließend für Produkte, Versand, Zahlungen und Geschäftseinstellungen hierher zurück.
Zum Starten brauchen Sie eine Idee und eine E-Mail-Adresse. Ein angemeldetes Gewerbe, eine Domain und ein Stripe-Konto kommen später, in den Schritten, in denen sie tatsächlich benötigt werden.
Verkaufen Sie bereits über Shopify? Nutzen Sie stattdessen [Shopify verbinden](./start-here/connect-shopify). Dieser Leitfaden beschreibt den Aufbau eines Stores von Grund auf.
## Drei Zustände und warum sie getrennt sind
Ein Store durchläuft drei Zustände, und sie treten nicht gleichzeitig ein. Zu wissen, in welchem Sie sich befinden, verhindert die meisten Missverständnisse in diesem Prozess.
| Zustand | Was er bedeutet | Was er nicht bedeutet |
| --- | --- | --- |
| **Vorschau** | Runner hat Ihre Storefront erstellt und Sie können sie ansehen. | Sie ist nicht öffentlich. |
| **Veröffentlicht** | Der Store hat eine öffentliche Webadresse und kann von allen besucht werden. | Eine Veröffentlichung allein bestätigt nicht die Zahlungsbereitschaft. Auch Zahlungs- und Anbietereinrichtung müssen geprüft werden. |
| **Checkout bereit** | Stripe ist verbunden und eine Bestellung kann bezahlt werden. | Das ist der Punkt, an dem der Store geschäftlich geöffnet ist. |
Veröffentlichen ist Schritt 7. Zahlungen sind Schritt 9. Ein Store, der live ist, ist nicht zwangsläufig ein funktionierender Store.
## So nutzen Sie diesen Leitfaden
Elf Schritte in vier Gruppen.
| Gruppe | Schritte |
| --- | --- |
| **Erstellen** | 1. Entscheiden, was Sie verkaufen · 2. Storefront erstellen |
| **Einrichten** | 3. Store-Details · 4. Produkte · 5. Versand · 6. Richtlinien und Vertrauen |
| **Live gehen** | 7. Prüfen und veröffentlichen · 8. Eigene Domain (optional) · 9. Zahlungen verbinden |
| **Wachsen** | 10. Erste Besucher · 11. Wöchentlicher Betrieb |
Arbeiten Sie die Schritte der Reihe nach ab. Mehrere spätere Schritte scheitern still, wenn ein früherer unvollständig ist: Versand lässt sich ohne Lagerort nicht speichern, Produkte zeigen ohne Markt keine Preise, und der Domain-Schritt braucht zuerst eine erfolgreiche Veröffentlichung. Schritt 8 ist die Ausnahme — er ist optional und jederzeit nach dem Veröffentlichen möglich.
Jeder Schritt endet mit etwas, das Sie selbst überprüfen können. Die **Launch-Checkliste** am Ende dieses Leitfadens fasst alles an einer Stelle zusammen.
Runner erstellt mehr als nur die Storefront. Runner kann recherchieren, was sich verkauft, Produkte vorschlagen, Beschreibungen schreiben, Katalogeinträge anlegen und aktualisieren sowie Ihre Richtlinienseiten entwerfen. Jeder Schritt enthält Prompts, die Sie in den Chat kopieren können. Wenn etwas nicht funktioniert, beschreiben Sie es — Runner kann den aktuellen Zustand Ihres Stores lesen und benennen, was fehlt.
Skills geben Runner wiederverwendbare Anweisungen für eine bestimmte Art von Arbeit. Öffnen Sie **Agent** in der Seitenleiste, wählen Sie den Filter **Skills** und suchen Sie unter **Discover** nach Ihrer Aufgabe, etwa `market research`, `product description`, `policy` oder `SEO`. Siehe [Skills](./agent/skills).
**Wenn zuerst ein Setup-Assistent erscheint.** Neue Stores können ein geführtes Setup öffnen, das Store-Basisdaten, Versand, ein erstes Produkt, Zahlung und Sichtbarkeit in einem Durchgang abfragt. Es deckt Teile der Schritte 3, 4, 5 und 9 in anderer Reihenfolge ab. Füllen Sie aus, was Sie können, wählen Sie für den Rest **Überspringen**, und holen Sie die übersprungenen Punkte mit den Schritten unten sauber nach. Siehe [Onboarding und allgemeine Einstellungen](./store-operations/onboarding-and-general-settings).
## Schritt 1 — Entscheiden, was Sie verkaufen
Der Rest des Prozesses geht schneller, sobald das geklärt ist. Planen Sie einen Nachmittag ein.
Sie brauchen drei Antworten: was Sie verkaufen, wer es kauft und woher es kommt. Die dritte Antwort prägt mehrere spätere Schritte.
- **Eigenen Bestand halten.** Sie kaufen oder fertigen die Produkte und versenden jede Bestellung selbst. Höhere Marge, mehr Arbeit und Geld, das vor dem ersten Verkauf ausgegeben wird.
- **Dropshipping.** Ein Lieferant hält den Bestand und versendet jede Bestellung in Ihrem Namen. Schnellerer Start ohne Wareneinkauf, dafür dünnere Margen und weniger Kontrolle über Lieferzeiten.
Runner unterstützt beides, und Sie können später wechseln. Siehe [Dropshipping](./store-operations/dropshipping).
**Fragen Sie Runner**
> Ich möchte einen Onlineshop starten, weiß aber noch nicht, was ich verkaufen soll. > Ich interessiere mich für [Thema] und kann etwa [Budget] investieren. Was verkauft > sich gerade gut, und welche Vor- und Nachteile hat jede Option?
> Sollte ich [Produkt] per Dropshipping verkaufen oder eigenen Bestand halten? > Das ist mein erster Store.
> Wer kauft [Produkt]? Was ist diesen Menschen wichtig, und welchen Preis erwarten sie?
**Fertig, wenn** Sie sagen können, was Sie verkaufen, wer es kauft und woher es kommt. Behalten Sie diese Beschreibung — Sie fügen sie in Schritt 2 in den Chat ein.
**Vorerst überspringen:** Domain, Logo und Gewerbeanmeldung. Alles davon ist günstiger zu entscheiden, wenn das Produkt feststeht.
## Schritt 2 — Storefront erstellen
Mit der bebilderten [Anleitung für den ersten Store](./start-here/first-store-quickstart) erstellen Sie Ihren Store, senden die Beschreibung aus Schritt 1, prüfen die Vorschau und beauftragen eine gezielte Änderung.
Prüfen Sie vor dem Fortfahren Folgendes:
- Der neue Store erscheint in Ihrem Arbeitsbereich.
- Die wichtigsten Vorschauseiten lassen sich auf Desktop und Mobilgerät öffnen.
- Die gewünschte Änderung ist in der Vorschau sichtbar.
Eine funktionierende Vorschau veröffentlicht Ihren Store nicht. Fahren Sie unten mit der Geschäftseinrichtung fort. Die Veröffentlichung folgt in Schritt 7.
## Schritt 3 — Store-Details einrichten
Die öffentliche Identität Ihres Stores und wo er verkauft. Etwa 10 Minuten, und mehrere spätere Schritte hängen davon ab.
**Zugriffspfad:** **Workspace → Store wählen → Shop-Betrieb → Allgemein**
1. Öffnen Sie **Shop-Betrieb → Allgemein**.
2. Geben Sie den Store-Namen, eine Kontakt-E-Mail und Ihre Geschäftsadresse ein. Der Store-Name ist auf 30 Zeichen begrenzt, und die Kontakt-E-Mail muss eine gültige Adresse sein.
3. Fügen Sie unter **Märkte** die Länder hinzu, in die Sie verkaufen, und legen Sie die Währung fest.
4. Fügen Sie unter **Lagerorte** die Adresse hinzu, von der Bestellungen ausgehen. Eine Privatadresse ist zulässig.
5. Wählen Sie **Speichern** und warten Sie auf den gespeicherten Zustand.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ausführlich: [Onboarding und allgemeine Einstellungen](./store-operations/onboarding-and-general-settings).
**Fragen Sie Runner**
> Ich verkaufe nach [Länder]. Welche Markt- und Währungseinstellungen sollte ich nutzen?
**Fertig, wenn** Allgemein mit Store-Namen, gültiger Kontakt-E-Mail, mindestens einem Markt und einem Lagerort gespeichert ist.
**Wissenswert**
- Die Währung wird pro Markt festgelegt, nicht pro Produkt. Ein Produkt mit einer Währung außerhalb Ihrer gespeicherten Märkte zeigt eine Warnung und kann in der Storefront keinen Preis anzeigen.
- Store-Sichtbarkeit und Veröffentlichung sind zweierlei. **Für Kunden sichtbar** steuert, ob die Storefront den Store zeigt. Der Storefront-Code geht dadurch nicht online — das ist Schritt 7.
- Dies ist ein guter Moment, um Stripe zu starten. Zahlungen sind Schritt 9, aber die Prüfung Ihrer Angaben durch Stripe kann dauern. Wenn Sie jetzt beginnen, läuft die Wartezeit im Hintergrund und nicht am Launch-Tag.
## Schritt 4 — Produkte hinzufügen
Sie brauchen mindestens ein vollständiges, verkaufsfähiges Produkt. Wie lange das dauert, hängt ganz von Ihrer Beschaffung ab.
**Zugriffspfad:** **Workspace → Store wählen → Shop-Betrieb → Produkte**
Drei Wege, die sich kombinieren lassen.
| Weg | Wann geeignet | Wo |
| --- | --- | --- |
| **Manuell anlegen** | Sie haben eigene Produkte | **Produkte → Hinzufügen** |
| **Dropshipping** | Ein Lieferant lagert und versendet für Sie | **Store wählen → Shop-Betrieb → Dropshipping** |
| **CSV-Import** | Ihr Katalog liegt bereits in einer Tabelle | **Produkte → Importieren** |
Ein leerer Katalog zeigt **Erstes Produkt hinzufügen** statt **Hinzufügen** und **Importieren**.
Ein vollständiges Produkt braucht Namen und Beschreibung, einen Preis in einer Währung, die zu einem gespeicherten Markt passt, mindestens ein Bild, Bestand und den Status **Veröffentlicht**. Ein Produkt im **Entwurf** erscheint Kunden nicht. Physische Waren brauchen zusätzlich Gewicht und Maße, weil Versand und Fulfillment davon abhängen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ausführlich: [Produkte](./store-operations/products) · [Dropshipping](./store-operations/dropshipping) · [Produkte importieren](./store-operations/import-products) · [Bestand und Varianten](./store-operations/inventory-and-variants)
**Fragen Sie Runner.** Sie müssen diese Formulare nicht selbst ausfüllen. Runner kann Produkte, Bestand und Bilder aus dem Chat anlegen und aktualisieren und Ihnen bei der Auswahl helfen.
> Womit sollte ich starten? [Liste] — berücksichtige Marge und Versandaufwand.
> Schreibe eine Produktbeschreibung für [Produkt]. Kunden ist [Aspekt] am wichtigsten.
> Setze den Bestand für [Produkt] auf 50 und markiere die blaue Variante als nicht verfügbar.
> Prüfe meinen Katalog und nenne mir Produkte ohne Bild, Preis oder Bestand.
Benennen Sie den Datensatz und das genaue gewünschte Ergebnis, und autorisieren Sie destruktive Änderungen ausdrücklich.
**Fertig, wenn** mindestens ein Produkt **Veröffentlicht** ist, in einer gespeicherten Marktwährung ausgezeichnet ist, Bild und Bestand hat und in der Storefront-Vorschau erscheint.
**Wissenswert**
- Bestandsänderungen bleiben erst erhalten, wenn ein Lagerort gespeichert ist. Das gehört zu Schritt 3 — holen Sie es dort nach, falls Sie es übersprungen haben.
- Dropshipping-Produkte können sich bei Kosten und Bestand anders verhalten als manuell gepflegte. Bestätigen Sie vor dem Hinzufügen ein Zielland, eine nutzbare Versandart und einen Verkaufspreis für jede Variante.
- Der CSV-Import benötigt die aktuelle Vorlage von Runner. `Product Handle` und `Product Title` sind Pflicht, Variantenzeilen brauchen `Variant SKU` und Optionswerte.
## Schritt 5 — Versand einrichten
Runner muss wissen, von wo Bestellungen versendet werden und was Sie für die Lieferung berechnen. Etwa 15 Minuten.
Die Reihenfolge zählt hier. Versand lässt sich ohne den in Schritt 3 gespeicherten Lagerort und Markt nicht speichern.
**Zugriffspfad:** **Shop-Betrieb → Allgemein → Versand**
1. Öffnen Sie **Shop-Betrieb → Allgemein**.
2. Prüfen Sie, dass der in Schritt 3 gespeicherte **Lagerort** weiterhin vorhanden ist. Das ist die Adresse, von der Bestellungen ausgehen.
3. Stellen Sie sicher, dass unter **Märkte** mindestens ein Land gespeichert ist.
4. Gehen Sie zu **Versand** und wählen Sie **Hinzufügen**.
5. Geben Sie der Option einen Namen, den Kunden wiedererkennen, etwa die Liefergeschwindigkeit oder -art.
6. Wählen Sie unter **Versand an** das Zielland und öffnen Sie **Versandkosten**. Eine Pauschale ist die einfachste Option. Geben Sie `0` ein, damit die Lieferung als kostenlos angezeigt wird.
7. Wählen Sie **Speichern** im Dialog, dann **Speichern** auf der Seite, und warten Sie auf den gespeicherten Zustand.
Zu preisbasierten Staffeln und den übrigen Tariftypen siehe [Versand](./store-operations/shipping). Wenn ein Carrier oder Lieferant die Zustellung übernimmt, brauchen Sie eventuell zusätzlich eine Verbindung unter **Apps** — siehe [Shippo](./apps-and-integrations/shippo-shipping), [CJ Dropshipping](./apps-and-integrations/cj-dropshipping) oder [4PX Fulfillment](./apps-and-integrations/4px-fulfillment).
**Fragen Sie Runner**
> Ich versende von [Ort] nach [Länder]. Welche Versandoptionen sollte ich einrichten?
> Lohnt sich kostenloser Versand bei einem Produkt für [Preis], oder sollte ich berechnen?
**Fertig, wenn** im Checkout eine Lieferoption mit Preis erscheint. Legen Sie ein Produkt in den Warenkorb und prüfen Sie dort, nicht auf der Einstellungsseite.
**Wissenswert**
- Ein Store ohne gültige Versandoption sieht überall normal aus, außer im Checkout, wo der Kunde die Bestellung nicht abschließen kann. Das ist ein häufiger Grund, warum ein fertig wirkender Store nichts verkauft.
- Versandoptionen nutzen den in Allgemein gespeicherten Lagerort. Es gibt keinen separaten **Versand von**-Selektor pro Zeile.
- Ohne Standard-Marktregion schlägt das Speichern fehl. Speichern Sie Märkte vor Versand.
- Digitale Produkte, Buchungen und vom Lieferanten erfüllte Artikel können anderen Regeln folgen.
## Schritt 6 — Rechtssicherheit und Vertrauen schaffen
Das sind die Seiten, die Kunden sagen, wer Sie sind und was passiert, wenn etwas schiefgeht. Runner kann alle davon entwerfen. Ihre Aufgabe ist zu prüfen, ob sie zu Ihrer tatsächlichen Praxis passen.
Die meisten Stores brauchen eine Rückgabe- und Erstattungsrichtlinie, eine Versandrichtlinie mit realistischen Lieferzeiten, eine Datenschutzerklärung, Nutzungsbedingungen, eine Kontaktmöglichkeit und eine Über-uns-Seite.
**Fragen Sie Runner**
> Entwirf eine Rückgabe- und Erstattungsrichtlinie. Ich verkaufe [was], versende aus > [Ort] und möchte ein Rückgabefenster von [Anzahl] Tagen.
> Entwirf Datenschutz- und Nutzungsbedingungsseiten und füge sie der Storefront-Fußzeile hinzu.
> Schreibe eine Über-uns-Seite auf Basis dessen, was ich dir über mein Geschäft erzählt habe.
Prüfen Sie dann die Entwürfe:
1. Lesen Sie jede Seite und korrigieren Sie alles, was nicht Ihren tatsächlichen Bedingungen entspricht — Rückgabefenster, wer den Rückversand zahlt und wie lange die Lieferung wirklich dauert.
2. Prüfen Sie, dass die Seiten in der Storefront erscheinen und in der Fußzeile verlinkt sind. Siehe [Inhalte, Seiten und Medien bearbeiten](./storefront-and-publishing/edit-content-pages-and-media).
3. Prüfen Sie, ob die Kontaktadresse mit der in Schritt 3 gespeicherten Kontakt-E-Mail übereinstimmt.
**Fertig, wenn** jede Richtlinienseite aus der Storefront-Fußzeile öffnet und Ihre echten Bedingungen widerspiegelt.
**Wissenswert.** Entwürfe sind ein Ausgangspunkt, keine Rechtsberatung. Steuerliche Registrierung, Verbraucherschutzregeln und Pflichtangaben hängen davon ab, wo Sie tätig sind und was Sie verkaufen. Fragen Sie im Zweifel vor dem Launch eine örtliche Fachperson.
Produktbewertungen sind ein eigenes Vertrauenssignal und werden in Allgemein konfiguriert. Bewertungen zu aktivieren fügt einer älteren Storefront keine fehlenden Bewertungskomponenten hinzu — bitten Sie Runner, die Funktion zu ergänzen, und veröffentlichen Sie diese Änderung. Siehe [Bewertungen](./store-operations/reviews-and-advanced-admin).
## Schritt 7 — Prüfen und veröffentlichen
Veröffentlichen bringt Ihren Store unter einer öffentlichen Adresse online. Die Prüfungen dauern wenige Minuten. Das Beheben der Funde kann länger dauern.
**Zugriffspfad:** **Workspace → Store wählen → Storefront → Veröffentlichen**
1. Arbeiten Sie zuerst die [Checkliste zur Veröffentlichungsbereitschaft](./storefront-and-publishing/prepare-to-publish) ab.
2. Öffnen Sie **Onlineshop** und wählen Sie die Veröffentlichungsschaltfläche. Je nach Zustand heißt sie **Veröffentlichen**, **Änderungen veröffentlichen** oder **Erneut veröffentlichen**.
3. Lesen Sie **Bereitstellung bestätigen** und warten Sie, bis die Build-Prüfung abgeschlossen ist.
4. Beheben Sie jede angezeigte Warnung oder bestätigen Sie sie bewusst.
5. Wählen Sie **Bestätigen** erst, wenn die Prüfung erfolgreich war.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ausführlich: [Veröffentlichen und erneut veröffentlichen](./storefront-and-publishing/publish-and-republish).
**Fragen Sie Runner**
> Prüfe, ob mein Store veröffentlichungsbereit ist, und liste auf, was noch fehlt.
> Die Veröffentlichungsprüfung hängt bei [Punkt]. Was soll ich tun?
**Fertig, wenn** die öffentliche URL des Stores in einem privaten Browserfenster öffnet.
**Wissenswert.** Zwei Dinge überraschen an dieser Stelle. Ihr Store ist öffentlich, kann aber noch keine Zahlungen annehmen — das ist Schritt 9, der Schritt, der den Store geschäftlich öffnet. Und spätere Änderungen sind erst live, wenn Sie erneut veröffentlichen: eine gespeicherte Design-Modus-Änderung, eine wiederhergestellte Version oder eine korrekte Vorschau aktualisieren den öffentlichen Store nicht von selbst.
Änderungen im Shop-Betrieb verhalten sich anders. Produkte, Preise, Bestand und Versand greifen ohne erneutes Veröffentlichen.
**Wenn eine Prüfung blockiert,** nutzen Sie die auf dem Punkt angezeigte Aktion — **Shop-Betrieb öffnen**, **Mit KI beheben** oder **Prüfung wiederholen**. Wenn es bestehen bleibt, siehe [Veröffentlichung, Checkout und Apps beheben](./help-and-reference/troubleshoot-publishing-checkout-apps) und [Storefront-Builds beheben](./help-and-reference/troubleshoot-storefront-builds).
## Schritt 8 — Eigene Domain verbinden (optional)
**Dieser Schritt ist optional.** Ihr Store funktioniert bereits unter der Adresse, die Runner beim Veröffentlichen vergeben hat. Eine eigene Domain betrifft die Marke, nicht die Funktion. Sie zu überspringen blockiert weder Zahlungen noch spätere Schritte, und Sie können jederzeit zurückkommen.
Die Einrichtung dauert etwa 10 Minuten, danach folgt eine Wartezeit für DNS. Der Store braucht zuerst eine erfolgreiche Veröffentlichung, und der Zugang hängt von Ihrem Tarif ab.
**Zugriffspfad:** **Onlineshop** → Menü der veröffentlichten Website → **Domain-Einstellungen**. Auf Mobilgeräten oder wenn dieses Menü ausgeblendet ist, nutzen Sie Workspace **Einstellungen → Shop: _Store-Name_ → Domain**.
1. Öffnen Sie **Domain-Einstellungen** über einen der beiden Pfade.
2. Kaufen Sie eine Domain über Runner oder fügen Sie eine hinzu, die Sie bereits besitzen.
3. Wenn Sie eine eigene hinzufügen, übertragen Sie die von Runner angezeigten DNS-Einträge in die Einstellungen Ihres Domain-Anbieters.
4. Warten Sie auf die Prüfung. Die Domain-Zeile zeigt eine Warnung, bis die Einträge greifen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ausführlich: [Eigene Domain verbinden](./storefront-and-publishing/custom-domains).
**Fertig, wenn** Ihre Domain den Store öffnet — oder wenn Sie entschieden haben, das später zu erledigen.
**Wissenswert**
- **Domain hinzugefügt – folgen Sie den DNS-Schritten unten, um sie live zu schalten.** bestätigt nur, dass die Domain mit Ihrem Store verknüpft ist, nicht dass DNS funktioniert. Beides wird getrennt geprüft, und DNS-Änderungen können mehrere Stunden dauern.
- Kauf oder Verlängerung einer Domain startet einen externen Zahlungsvorgang. Prüfen Sie die Angaben, bevor Sie fortfahren.
- Wenn Sie bald launchen, verbinden Sie zuerst Zahlungen. Ein Store unter der Standardadresse, der Geld annimmt, ist mehr wert als ein Store mit eigener Domain, der es nicht kann.
## Schritt 9 — Zahlungen verbinden
Das ist der Schritt, der den Store geschäftlich öffnet. Alles davor war Einrichtung.
Ihr Store kann bereits live sein und fertig aussehen. Bis dieser Schritt erledigt ist, kann ein Kunde, der kaufen möchte, den Kauf nicht abschließen.
**Zugriff:** **Apps → Shop betreiben → Stripe**. Nach der Veröffentlichung kann Runner auch **Stripe verbinden** anzeigen. Diese Aktion öffnet dieselbe Einrichtung.
Stripe erhebt Geschäftsangaben, Identitätsdaten und Bankverbindung für Auszahlungen. Halten Sie diese bereit und nutzen Sie einen Browser, der das Stripe-Fenster zulässt.
1. Öffnen Sie **Apps → Shop betreiben → Stripe** und wählen Sie **Verbinden**.
2. Schließen Sie die Stripe-Einrichtung im neuen Fenster ab.
3. Kehren Sie zu Runner zurück und prüfen Sie, dass die Verbindung als aktiviert angezeigt wird.
| Zustand | Bedeutung |
| --- | --- |
| **Verbinden...** | Runner bereitet das Konto oder den Setup-Link vor. Warten Sie auf ein Ergebnis. |
| **Prüfung ausstehend** | Stripe prüft Ihre Angaben. Das ist der Prozess von Stripe, kein Fehler in Runner, und kann dauern. |
| **Stripe-Aktionen erforderlich** | Etwas Konkretes steht aus. Öffnen Sie es, um **Jetzt fällig**, **Später fällig** oder **In Prüfung** zu sehen. |
| **Erneut verbinden** oder **Onboarding fortsetzen** | Ein Konto existiert, ist aber unvollständig. Die Auswahl setzt dasselbe Konto fort. |
Ausführlich: [Stripe für Zahlungen verbinden](./apps-and-integrations/stripe-payments).
Öffnen Sie Ihren Store auf einem Smartphone. Prüfen Sie ein Produkt, legen Sie es in den Warenkorb, geben Sie eine Lieferadresse ein und kontrollieren Sie, ob eine Versandoption und der Zahlungsschritt erscheinen. Halten Sie vor dem Absenden der Zahlung an.
Wenn Sie eine echte Zahlung testen möchten, führen Sie bewusst eine Testbestellung durch und prüfen Sie sie unter [Bestellungen](./store-operations/orders). Bei einer echten Zahlung und einer Rückerstattung können Gebühren anfallen. Dieser Test ist optional und nicht Teil der Einrichtungsanleitung.
**Fragen Sie Runner**
> Stripe zeigt [Zustand]. Was bedeutet das und was soll ich als Nächstes tun?
> Ein Kunde sagt, der Checkout funktioniert nicht. Was soll ich prüfen?
**Sie sind fertig, wenn** Stripe keine blockierenden Einrichtungsschritte anzeigt und Produkt, Warenkorb, Versandoption und Zahlungsschritt zusammen funktionieren. Diese Prüfungen bestätigen die Bereitschaft des Checkouts. Erst eine abgeschlossene Zahlung bestätigt eine tatsächliche Transaktion.
**Wissenswert.** Eine Live-URL ist kein Beleg dafür, dass Zahlungen verfügbar sind. Die Storefront kann veröffentlicht sein, während der Checkout noch pausiert oder in Prüfung ist. Siehe [Live-Store und Checkout](./storefront-and-publishing/live-store-and-checkout).
## Schritt 10 — Erste Besucher gewinnen
Niemand kommt von allein. Beginnen Sie mit dem, was nichts kostet, und geben Sie kein Geld für Anzeigen aus, bevor Schritt 9 bestätigt ist.
- **Suche.** Produkttitel und Beschreibungen tragen bei einem neuen Store das meiste Gewicht. Siehe [SEO-Überblick](./analytics-and-seo/seo-overview) und [Suchleistung](./analytics-and-seo/search-performance).
- **Analytics.** Prüfen Sie, dass Besuche erfasst werden, bevor Sie irgendetwas beurteilen. Siehe [Analytics-Überblick](./analytics-and-seo/analytics-overview).
- **KI-Sichtbarkeit.** Wie Ihr Store erscheint, wenn Menschen KI-Assistenten um Empfehlungen bitten. Siehe [KI-Sichtbarkeit](./analytics-and-seo/ai-visibility).
- **Kreatives.** Bilder und Anzeigenvarianten aus dem [Creative Studio](./automate-test-and-create/creative-studio) und Kampagnen über [Runner Ads](./automate-test-and-create/runner-ads).
**Fragen Sie Runner**
> Verbessere die SEO-Titel und Beschreibungen auf meinen Produktseiten.
> Erstelle drei Anzeigenmotive für [Produkt] für [Zielgruppe].
> Mein Store ist seit einer Woche live, aber ohne Verkäufe. Was soll ich zuerst prüfen?
**Fertig, wenn** Analytics Sitzungen von anderen Personen als Ihnen zeigt.
**Wissenswert.** Wenig Traffic und niedrige Conversion sind verschiedene Probleme mit verschiedenen Lösungen. Prüfen Sie zuerst den Traffic — Conversion lässt sich bei zehn Besuchen nicht beurteilen. Siehe [Traffic und Conversion](./analytics-and-seo/traffic-and-conversion). Wenn Analytics gar nichts zeigt, prüfen Sie zuerst, ob der Store veröffentlicht und die Datenquelle verbunden ist. Siehe [Daten und Veröffentlichung beheben](./analytics-and-seo/troubleshoot-data-and-publication).
## Schritt 11 — Den Store wöchentlich betreiben
Eine kurze Routine hält den Store gesund, sobald Bestellungen eingehen.
1. Prüfen Sie [Bestellungen](./store-operations/orders) und erfüllen Sie Offenes.
2. Beantworten Sie Kundennachrichten und bearbeiten Sie Rücksendungen. Siehe [Kunden](./store-operations/customers).
3. Prüfen Sie die Bestände unter [Bestand und Varianten](./store-operations/inventory-and-variants).
4. Sehen Sie in [Analytics](./analytics-and-seo/analytics-overview) nach, was sich seit letzter Woche verändert hat.
Wenn Sie genug Traffic haben, testen Sie Änderungen mit [Experimenten](./automate-test-and-create/experiments), statt zu raten, übergeben Sie wiederkehrende Arbeit an [Automatisierungen](./automate-test-and-create/automations) und führen Sie [Aktionen](./store-operations/promotions) für bestimmte Produkte oder Zeiträume durch.
**Fragen Sie Runner**
> Fasse die Bestellungen dieser Woche zusammen und markiere, was Aufmerksamkeit braucht.
> Welche Produkte liefen diesen Monat am besten, und welche bewegen sich nicht?
**Wissenswert.** Storefront-Änderungen müssen erneut veröffentlicht werden, bevor Kunden sie sehen. Änderungen im Shop-Betrieb greifen ohne erneutes Veröffentlichen. Bevor Sie aus dem Chat eine destruktive oder bestellbezogene Aktion autorisieren, lassen Sie Runner zuerst den aktuellen Zustand prüfen und autorisieren Sie dann genau die gewünschte Wirkung.
## Launch-Checkliste
Jeder Punkt ist etwas, das Sie selbst überprüfen können. Wenn Sie alle acht Pflichtpunkte bestätigen können, ist Ihr Store geschäftlich geöffnet.
**Erforderlich**
- [ ] Sie können sagen, was Sie verkaufen, wer es kauft und woher es kommt. (Schritt 1)
- [ ] Die Storefront-Vorschau lädt, und Ihre Hauptseiten funktionieren auf Desktop und Mobilgerät. (Schritt 2)
- [ ] Allgemein ist mit Store-Namen, gültiger Kontakt-E-Mail, mindestens einem Markt und einem Lagerort gespeichert. (Schritt 3)
- [ ] Mindestens ein Produkt ist veröffentlicht, in einer gespeicherten Marktwährung ausgezeichnet, mit Bild und Bestand. (Schritt 4)
- [ ] Im Checkout erscheint eine Lieferoption mit Preis, wenn Sie ein Produkt in den Warenkorb legen. (Schritt 5)
- [ ] Ihre Richtlinienseiten öffnen aus der Storefront-Fußzeile und entsprechen Ihren echten Bedingungen. (Schritt 6)
- [ ] Die öffentliche Store-URL öffnet in einem privaten Browserfenster. (Schritt 7)
- [ ] Stripe zeigt keine blockierenden Einrichtungsschritte. Der Warenkorb erreicht den Zahlungsschritt mit der erwarteten Versandoption. (Schritt 9)
**Optional, jederzeit nach dem Veröffentlichen**
- [ ] Ihre eigene Domain öffnet den Store. (Schritt 8)
**Nach dem Launch**
- [ ] Analytics zeigt Sitzungen von anderen Personen als Ihnen. (Schritt 10)
- [ ] Sie haben eine wöchentliche Routine für Bestellungen, Bestand und Kunden. (Schritt 11)
Wenn sich ein Punkt nicht bestätigen lässt, beschreiben Sie im Chat, was Sie sehen.
> Prüfe meinen Store anhand der Launch-Checkliste und sag mir, was noch offen ist.
## Verwandte Leitfäden
- [Erste Schritte mit Runner](./start-here)
- [Mit Runner chatten](./work-with-runner/chat-with-runner)
- [Übersicht über den Shop-Betrieb](./store-operations)
- [Apps und Integrationen](./apps-and-integrations)
- [Hilfe und Referenz](./help-and-reference)
- [Glossar](./help-and-reference/glossary)
---
# Tarife und Abrechnung
Source: https://www.runnerai.com/docs/de/guides/plans-and-billing
Runner misst Arbeit in Guthaben und verkauft Kapazität als Abonnement. Diese beiden Seiten trennen die Entscheidung vom Alltag: Auf der einen wählen und verwalten Sie einen Plan, auf der anderen lesen und nutzen Sie den daraus entstehenden Saldo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Diese Aufnahme zeigt Free, Plus und Pro. Scrollen Sie in der Anwendung zu Max. Maßgeblich sind die aktuellen Angaben in Ihrem Konto und bei der Zahlungsbestätigung, nicht die hier aufgenommenen Preise.
| Ihr Ziel | Hier beginnen |
| --- | --- |
| Kostenlos, Plus, Pro und Max vergleichen oder ein Abonnement ändern | [Abonnementpläne](/de/guides/plans-and-billing/subscription-plans) |
| Sehen, was ein Saldo leistet, Nutzung lesen oder Guthaben verdienen | [Guthaben und Nutzung](/de/guides/plans-and-billing/credits-and-usage) |
Öffnen Sie das Menü des gewünschten Arbeitsbereichs → **Einstellungen → Plan & Abrechnung**, um Tarife zu vergleichen, oder **Nutzung & Credits**, um Ausgaben zu prüfen. Die aktuelle [Preisseite](https://www.runnerai.com/pricing), Ihr Konto und die Bestätigung vor der Zahlung zeigen die geltenden Werte.
---
# Guthaben und Nutzung
Source: https://www.runnerai.com/docs/de/guides/plans-and-billing/credits-and-usage
Guthaben sind die universelle Nutzungseinheit von Runner. Berechtigte LLM-, Bild-, Video-, Automatisierungs-, Workflow-, Simulations-, Skill- und Bereitstellungsvorgänge werden alle von einem einzigen angezeigten Saldo abgezogen.
## Was dieser Leitfaden abdeckt
Abschätzen, was ein Saldo leistet, einen Berichtszeitraum auswählen und jeden Block dagegen lesen, Bonusguthaben verdienen und verstehen, wie die Nutzung erfasst wird.
## Verfügbarkeit und Voraussetzungen
- Die Nutzung ist auf den aktuellen Arbeitsbereich beschränkt, nicht auf einen Store.
- Daten können leer sein, wenn der Arbeitsbereich in dem ausgewählten Bereich keine Guthaben verwendet hat.
- Guthabenzuweisungen, Ablauf und Kaufberechtigung hängen von der Zuweisung oder dem Plan ab, der in Ihrem Konto angezeigt wird.
- Unter **Nutzung & Credits** finden Sie Ihr Guthaben und den erfassten Verbrauch. Preise entnehmen Sie der aktuellen Kaufbestätigung.
## Eingabepfad
Öffnen Sie den gewünschten Arbeitsbereich und wählen Sie **Einstellungen → Nutzung & Credits**. Prüfen Sie den Namen des Arbeitsbereichs in der Seitenleiste der Einstellungen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Öffnen Sie **Nutzung & Credits** im gewünschten Arbeitsbereich. Das Bild zeigt den Menüeintrag, kein Guthaben und keinen erfassten Verbrauch. Prüfen Sie diese Werte in Ihrem eigenen Arbeitsbereich.
## Was ein Saldo leistet
Schätzen Sie den nächsten ähnlichen Auftrag anhand Ihrer kürzlich ausgeführten Aufgaben. Beginnen Sie mit einer kleinen, klar abgegrenzten Anfrage und prüfen Sie anschließend die dafür erfassten Credits in der Arbeitsbereichsaktivität. Modellwahl, Kontextgröße, Ausgabelänge, Medien, erneute Versuche und Aufgabenkomplexität beeinflussen den Gesamtverbrauch. Es gibt weder einen festen Preis pro Nachricht noch eine garantierte Anzahl von Store-Erstellungen pro Guthaben.
### Den nächsten Store-Aufbau abschätzen
1. Öffnen Sie **Einstellungen → Nutzung & Credits** in dem Arbeitsbereich, in dem Sie den Store erstellen werden.
2. Stellen Sie eine kleine, repräsentative Anfrage und suchen Sie anschließend den erfassten Verbrauch unter **Arbeitsbereichsaktivität**.
3. Vergleichen Sie kürzlich ausgeführte Aufgaben mit ähnlichem Umfang und derselben Modellwahl. Schätzen Sie die erste Generierung und spätere Überarbeitungen getrennt ab.
4. Addieren Sie die voraussichtlich wiederholten Arbeiten und planen Sie Mediengenerierung, erneute Versuche und größere Änderungen ein. Prüfen Sie den erfassten Verbrauch nach jeder Phase erneut.
Wenn **Ihre eigenen Aktivitätsdaten** beispielsweise 200 Credits für die Erstellung und jeweils 20 Credits für drei ähnliche Überarbeitungen ausweisen, ergeben diese Aufgaben zusammen **260 Credits**. Diese Zahlen veranschaulichen nur die Rechnung; sie sind weder typische Kosten noch ein Vergleichswert oder ein Angebot für Ihren nächsten Shop.
**Prüfen Sie:** Ihre Schätzung beruht auf vergleichbaren, erfassten Aufgaben. Ein Credit-Guthaben garantiert keine feste Anzahl von Shops oder Überarbeitungen.
Die monatlich in den einzelnen Tarifen enthaltenen Credits finden Sie unter [Abonnementtarife](./subscription-plans).
## Steuerelemente und Berichte
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| **7 Tage** | Überprüfen Sie die aktuelle Aktivität. | Jedes Diagramm, jede Zusammenfassung, jede Kategorie und jeder Aktivitätsblock werden auf sieben Tage aktualisiert. |
| **Dieser Zyklus** | Überprüfen Sie das aktuelle Abrechnungszyklus-Fenster. | Die Seite verwendet den für den Arbeitsbereich angezeigten verstrichenen aktuellen Zyklus. |
| **90 Tage** | Suchen Sie nach einem längeren Trend. | Jeder Nutzungsblock wird auf den längeren Bereich aktualisiert. |
| Karte "Guthaben verbleibend" | Sehen Sie verbleibende und Gesamtguthaben für den aktuellen Plan/Zuweisungen. | Der Fortschrittsbalken und das angezeigte Aktualisierungsdatum erklären den aktuellen Saldozustand. |
| **Upgrade** | Vergleichen Sie Pläne, wenn mehr enthaltene Kapazität benötigt wird. | Runner öffnet **Plan & Abrechnung**. |
| **Guthaben kaufen** | Überprüfen Sie einen berechtigten zusätzlichen Guthabenkauf. | Runner öffnet **Plan & Abrechnung**; kein Kauf erfolgt, bis die Bestätigung abgeschlossen ist. |
| Guthaben pro Tag | Finden Sie beschäftigte oder ruhige Tage. | Das Bewegen über einen Balken zeigt die Nutzung dieses Tages. |
| Woher Ihre Guthaben kamen | Verstehen Sie Plan-, Tages-, Anmelde-, Kauf- und andere Zuweisungen, die gelten. | Jede Zeile zeigt Quelle, Häufigkeit, Notiz und Guthaben. |
| Wohin Ihre Guthaben gingen | Vergleichen Sie Ausgabenkategorien und Laufzahlen. | Balken zeigen den Anteil jeder Kategorie für den ausgewählten Bereich. |
| Arbeitsbereichsaktivität | Überprüfen Sie aktuelle Aufgaben hinter den Ausgaben. | Kategorie-Registerkarten filtern die gleichen Spalten "Aufgabe", "Projekt", "Typ", "Guthaben" und "Zeit". |
## Überprüfen Sie die Nutzung
1. Öffnen Sie **Arbeitsbereich → Nutzung & Guthaben**.
2. Wählen Sie **7 Tage**, **Dieser Zyklus** oder **90 Tage**.
3. Lesen Sie **Guthaben verbleibend**, bevor Sie Ausgaben interpretieren.
4. Vergleichen Sie **Im Bereich verwendet**, **Täglicher Durchschnitt** und **Geschäftigster Tag**.
5. Verwenden Sie **Guthaben pro Tag**, um zu finden, wann sich die Nutzung geändert hat.
6. Vergleichen Sie Quellen mit Ausgabenkategorien.
7. Filtern Sie **Arbeitsbereichsaktivität**, um die beteiligten Aufgaben zu identifizieren.
8. Wenn Sie mehr Kapazität benötigen, öffnen Sie **Upgrade** oder **Guthaben kaufen** und überprüfen Sie dann die separate Abrechnungsbestätigung.
## Bonusguthaben verdienen
Öffnen Sie den Check-in oder die Quest in Ihrem Konto und lesen Sie die Belohnung, bevor Sie sie anfordern. Kehren Sie nach erfolgreicher Gutschrift zu **Nutzung & Credits** zurück und prüfen Sie Quelle und Guthaben.
Für tägliche Check-ins, Serienboni und Einführungsquests gelten unterschiedliche Voraussetzungen und Grenzen. Lesen Sie die aktuelle Obergrenze und das Ablaufdatum jeder Gutschrift. Eine monatliche Verdienstgrenze ist nicht dasselbe wie das maximal speicherbare Bonusguthaben. Bonus-Credits werden nicht unbegrenzt übertragen.
## Wie die Nutzung erfasst wird
- Die Nutzung wird nach Abschluss eines Vorgangs erfasst und kann kurz brauchen, bis sie erscheint.
- Eine einzelne Anfrage kann mehrere Einträge erzeugen, wenn Runner mehrere Modelle, Werkzeuge, Medienvorgänge, Simulationen oder Bereitstellungen nutzt.
- Wenn ein Betrag unerwartet wirkt, vergleichen Sie Zeitstempel, Projekt, Aktionstyp, Modell oder Anbieter und etwaige Wiederholungen, bevor Sie den Support kontaktieren.
## Verstehen Sie die Zahlen
- Der verbleibende Saldo und die Ausgaben im ausgewählten Bereich beantworten unterschiedliche Fragen; sie müssen nicht gleich sein.
- Das Diagramm "Guthaben pro Tag" meldet tägliche Ausgaben, während die Quellenkarte Zuweisungen und verbleibenden Saldo meldet.
- Eine Kategorie kann Läufe mit null Guthabenausgaben anzeigen.
- Aktivitätszeilen zeigen aktuelle Aufgaben zum Scannen, nicht ein vollständiges permanentes Audit-Protokoll.
- Daten verwenden die Zeitzone auf Ihrem aktuellen Gerät.
## Häufige Fragen
| Frage | Antwort |
| --- | --- |
| Warum haben zwei ähnliche Eingaben unterschiedliche Beträge verbraucht? | Sie können unterschiedliche Kontextgrößen, Ausgabelängen, Werkzeuge, Modelle, Agentenschritte, Wiederholungen, Ausweichpfade, Medien, Simulationen oder Bereitstellungen genutzt haben. |
| Verbraucht das Senden einer Nachricht eine feste Anzahl an Guthaben? | Nein. Guthaben richten sich nach den tatsächlich ausgeführten gemessenen Vorgängen. |
| Verbrauchen manuelle Bearbeitungen Guthaben? | Wenn Sie Inhalte oder Code selbst bearbeiten, entsteht keine Modellnutzung. Runner darum zu bitten, die Bearbeitung vorzunehmen oder zu erklären, kann es. |
| Sind fehlgeschlagene Anfragen immer kostenlos? | Nicht unbedingt. Ein Fehlschlag ohne vom Anbieter gemeldete Nutzung verursacht keine Modellkosten, aber Nutzung, die vor einem Fehlschlag oder während eines anderen erfolgreichen Versuchs gemeldet wurde, kann erfasst werden. |
| Wird ein Skill separat berechnet? | Nein. Das Aktivieren eines Skills verursacht keine Pauschalgebühr; die von ihm ausgeführten Vorgänge werden vom selben Saldo abgezogen. |
| Werden Bonus-Credits übertragen? | Lesen Sie das Ablaufdatum jeder Gutschrift. Für Check-in-Verdienstgrenzen, gespeichertes Guthaben und Serienboni können unterschiedliche Regeln gelten. |
| Wie funktioniert der Bonus beim siebten Check-in? | Jeder berechtigte tägliche Check-in bringt 10 Guthaben, und jede siebte aufeinanderfolgende Beanspruchung fügt einen Serienbonus hinzu. Der Einlösebildschirm zeigt den aktuellen Betrag vor dem Einlösen. |
| Ist ein Boost-Paket ein Abonnement? | Nein. Es ist ein einmaliger Kauf von 350 Guthaben für 9,90 USD. |
## Zustände und Limits
- **Guthaben aufgebraucht** hebt einen Saldo von Null hervor und hält Abrechnungsaktionen verfügbar.
- "Leer" bedeutet, dass es keine Protokolle für den aktuellen Filter oder Bereich gibt.
- Eine Quelle kann null anzeigen, wenn sie umsetzbar ist, aber noch nicht beansprucht wurde.
- Passive Zuweisungstypen werden nur angezeigt, wenn sie Guthaben beigetragen haben.
- Das Laden deckt sowohl Saldo- als auch Verbrauchsdaten ab; warten Sie auf alle Karten, bevor Sie sie vergleichen.
## Fehlerbehebung
- Wenn zwei Zahlen inkonsistent erscheinen, bestätigen Sie, dass jeder Block den gleichen ausgewählten Bereich verwendet.
- Wenn eine Aufgabe fehlt, löschen Sie den Aktivitätskategoriefilter und versuchen Sie einen längeren Bereich.
- Wenn sich der Saldo nach einem Kauf nicht geändert hat, kehren Sie zu "Plan & Abrechnung" zurück und bestätigen Sie, dass der Kauf einen abgeschlossenen Status erreicht hat, bevor Sie aktualisieren.
- Wenn keine Nutzung angezeigt wird, überprüfen Sie, ob Sie den Arbeitsbereich geöffnet haben, in dem die Aufgabe ausgeführt wurde.
- Wenn Sie eine Gebühr oder Planentscheidung benötigen, verwenden Sie "Plan & Abrechnung" anstelle eines alten Nutzungs-Screenshots.
- Bei einer unerwarteten Abbuchung oder einer Anforderung zur Datenverarbeitung wenden Sie sich an team@adaptivemachines.ai und nennen Sie Arbeitsbereich, Projekt, ungefähren Zeitstempel und Details des Nutzungsereignisses.
## Verwandte Leitfäden
- [Abonnementpläne](./subscription-plans)
- [Arbeitsbereich Allgemein](../account-and-settings/workspace-general)
- [Agent-Anpassung](../agent)
---
# Abonnementpläne
Source: https://www.runnerai.com/docs/de/guides/plans-and-billing/subscription-plans
Plan & Abrechnung ist der Ort auf Arbeitsbereichsebene für Abonnements, Planänderungen, Abrechnungsverwaltung und berechtigte zusätzliche Kreditkäufe. Verwenden Sie die dort angezeigten Werte, da sich Plannamen, Limits und Preise ändern können.
## Was dieser Leitfaden abdeckt
Die Runner-Pläne und ihre jeweiligen Leistungen vergleichen, eine Planaktion vor der Zahlung überprüfen, geplante oder ausstehende Änderungen erkennen und die sichere Abrechnungsverwaltung öffnen.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie den Arbeitsbereich, dessen Plan Sie verwalten möchten.
- Abrechnungsaktionen können Abrechnungsberechtigung für den Arbeitsbereich erfordern.
- Boost-Pakete erfordern ein aktives berechtigtes Abonnement.
- Ein überfälliges oder veraltetes Abonnement kann unterschiedliche Steuerelemente anzeigen oder eine neue Aktion blockieren.
## Eingabepfad
Öffnen Sie den gewünschten Arbeitsbereich und wählen Sie **Einstellungen → Plan & Abrechnung**. Prüfen Sie den Namen des Arbeitsbereichs in der Einstellungsseitenleiste.
Die öffentliche Preisseite und Plan & Abrechnung werden standardmäßig mit **Monatlich** geöffnet. Ein bestehendes Abonnement oder ein ausdrücklicher Link zu einem Abrechnungszeitraum kann stattdessen den passenden Zeitraum öffnen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Diese Aufnahme zeigt Free, Plus und Pro; scrollen Sie zu Max. Die abgebildeten Preise sind ein zeitgebundenes Beispiel der Oberfläche. Prüfen Sie vor jeder Zahlung den aktuellen Abrechnungszeitraum und Gesamtbetrag.
## Pläne vergleichen
Diese Tabelle fasst die Pläne zusammen. Maßgeblich sind die aktuelle [Preisseite](https://www.runnerai.com/pricing) und die Bestätigung, die vor der Zahlung angezeigt wird.
| Plan | Enthaltene Guthaben | Modell- und Funktionszugriff | Am besten geeignet für |
| --- | --- | --- | --- |
| Kostenlos | 150 Guthaben bei der Registrierung, plus bis zu 250 über Einführungs-Quests | Runner Lite sowie begrenzte Vorschauen ausgewählter erweiterter Funktionen | Runner ausprobieren und einen ersten Shop generieren |
| Plus | 1.000 Guthaben monatlich aufgeladen | Runner Lite sowie begrenzte Vorschauen ausgewählter erweiterter Funktionen | Regelmäßige kleine Änderungen und stetige Iteration an einem Shop |
| Pro | 2.500 Guthaben monatlich aufgeladen | Runner Pro sowie Creative Studio, Automatisierungen, Workflows, Simulationen, Experimente und Ads | Komplexe Bauarbeiten und den erweiterten Funktionsumfang |
| Max | 10.000 Guthaben monatlich aufgeladen | Runner Max sowie höhere Ausgabelimits und vorrangige Verarbeitung bei hohem Andrang | Umfangreiche oder zeitkritische Arbeit, je nach Verfügbarkeit |
Verfügbarkeit, Dauer und Grenzen von Vorschauen können während der Einführung variieren und werden in Ihrem Konto angezeigt. Was diese Guthaben in der Praxis leisten, steht unter [Guthaben und Nutzung](./credits-and-usage).
## Runner-Modelle
Runner bietet drei Modelle, damit Sie Qualität, Geschwindigkeit und Guthabenverbrauch abwägen können, ohne Modell-IDs der Anbieter zu verwalten.
| Modell | Enthalten in | Beabsichtigte Abwägung |
| --- | --- | --- |
| Runner Lite | Kostenlos und Plus | Schnelle, sparsame Arbeit für einfache Aufgaben |
| Runner Pro | Pro | Ausgewogene Leistung für komplexes Bauen und erweiterte Funktionen |
| Runner Max | Max | Höchste Leistung, höhere Ausgabelimits und vorrangiger Zugriff bei hohem Andrang |
Die Modellauswahl zeigt die für die aktuelle Aufgabe verfügbaren Optionen. Die Verfügbarkeit kann sich ändern; ein Tarif garantiert keine dauerhaft unveränderte Auswahl zugrunde liegender Anbietermodelle.
## Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
| --- | --- | --- |
| Banner des aktuellen Plans | Bestätigen Sie, welcher Arbeitsbereichsplan aktiv ist und seinen angezeigten Status. | Runner kann Erneuerungs-, End-, Gültigkeits- oder ausstehende Änderungsinformationen anzeigen. |
| **Monatlich / Jährlich · 20 % sparen** | Vergleichen Sie Tarife für den gewünschten Abrechnungszeitraum. | Die Tarifkarten werden aktualisiert. Bei einer laufenden Jahresbindung kann Monatlich deaktiviert sein. |
| Plankarte | Vergleichen Sie enthaltene Funktionen und Limits. | Die Auswahl einer verfügbaren Aktion führt zu einem Planbestätigungsschritt. |
| **Upgrade** oder Zeitraumwechselaktion | Starten Sie eine Planänderung. | Runner zeigt eine Bestätigung an, plant die Änderung, fordert Zahlung an oder öffnet den Checkout je nach Kontostatus. |
| **Verwalten** / **Abrechnung verwalten** | Aktualisieren Sie Zahlungsmethoden, überprüfen Sie Rechnungen oder verwalten Sie die Stornierung. | Runner öffnet das sichere Abrechnungsportal. |
| **Abbrechen** neben einer ausstehenden Änderung | Ziehen Sie eine geplante Planänderung zurück. | Runner aktualisiert das aktuelle Abonnement nach erfolgreicher Ausführung. |
| Credit-Boost-Paket | Kaufen Sie zusätzliche Guthaben, wenn berechtigt. | Menge und Gesamtbetrag werden vor **Kauf bestätigen** angezeigt. |
## Überprüfen Sie eine Planänderung
1. Öffnen Sie **Arbeitsbereich → Plan & Abrechnung**.
2. Bestätigen Sie den Arbeitsbereich und das Banner des aktuellen Plans.
3. Wählen Sie **Monatlich** oder **Jährlich · 20 % sparen**, wenn beide Optionen verfügbar sind.
4. Überprüfen Sie die aktuellen Plankarten, Funktionslimits und den angezeigten Betrag.
5. Wählen Sie die beabsichtigte Planaktion.
6. Lesen Sie die Bestätigung sorgfältig. Vergleichen Sie bei jährlicher Abrechnung den Jahresgesamtbetrag, nicht nur einen angezeigten Monatswert. Schließen Sie den Dialog oder brechen Sie ab, wenn Sie nur vergleichen. Fahren Sie nicht fort, wenn Tarif, Zeitraum oder Betrag falsch sind.
7. Schließen Sie die Zahlung nur auf der sicheren Checkout- oder Abrechnungsseite ab.
8. Kehren Sie zu "Plan & Abrechnung" zurück und bestätigen Sie den resultierenden Status. Ein Laden oder Checkout-Umleitung allein ist kein Beweis dafür, dass sich der Plan geändert hat.
## Verwalten Sie die Abrechnung oder Stornierung
1. Wählen Sie **Verwalten** oder **Abrechnung verwalten** für das aktuelle Abonnement.
2. Verwenden Sie das sichere Abrechnungsportal für Zahlungsmethoden, Rechnungen und Stornierungsoptionen, die Ihrem Konto angezeigt werden.
3. Überprüfen Sie die endgültige Bestätigung des Portals, bevor Sie eine finanzielle oder Stornierungsmaßnahme einreichen.
4. Kehren Sie zu Runner zurück und überprüfen Sie das Banner des aktuellen Plans, die End-/Erneuerungsmitteilung oder die ausstehende Änderung.
## Boost-Paket kaufen
Ein Boost-Paket ist ein einmaliger Kauf von 350 Guthaben für 9,90 USD zuzüglich anfallender Steuern. Es ist kein Abonnement, und seine Guthaben werden demselben universellen Saldo hinzugefügt.
1. Bestätigen Sie, dass ein aktives Abonnement angezeigt wird.
2. Öffnen Sie das Credit-Boost-Paket.
3. Wählen Sie die Menge.
4. Überprüfen Sie die Gesamtguthaben und den Gesamtpreis.
5. Wählen Sie **Kauf bestätigen** nur, wenn beide korrekt sind.
6. Warten Sie auf **Kauf abgeschlossen** und überprüfen Sie das Guthaben in [Guthaben und Nutzung](./credits-and-usage).
Dies ist eine finanzielle Aktion. Das Schließen der Bestätigung hinterlässt den Kauf unversendet. Der Checkout zeigt vor dem Kauf den aktuellen Preis, die Menge, den Ablauf und die Zahlungsbedingungen an.
## Zustände und Limits
- **Aktiv**, **Überfällig**, **Wird storniert**, inaktiv, veraltet und ausstehende Änderungszustände können unterschiedliche Aktionen verfügbar machen.
- Nach Ablauf eines früheren Abonnements kann **Verlängern** erscheinen, statt der Optionen eines Free-Arbeitsbereichs, für den noch nie bezahlt wurde. Warten Sie, bis die Abrechnungsdaten geladen sind, bevor Sie Verlängern wählen.
- Eine jährliche Verpflichtung kann monatliche Auswahlmöglichkeiten deaktivieren.
- Eine Planänderung kann sofort, geplant oder ausstehend zusätzliche Zahlung sein. Verwenden Sie den Status, den Runner nach der Anfrage anzeigt.
- **Einrichtung Ihres Abonnements** bedeutet, dass Runner den zurückgegebenen Zahlungsstatus noch bestätigt.
- Ein Verarbeitungs-Timeout fordert Sie auf, zu aktualisieren und zu überprüfen; es beweist nicht Fehler oder Erfolg.
- Der Kauf zusätzlicher Guthaben ist ohne ein aktives berechtigtes Abonnement nicht verfügbar.
## Fehlerbehebung
- Wenn der falsche Arbeitsbereich angezeigt wird, schließen Sie "Einstellungen" und öffnen Sie ihn erneut vom beabsichtigten Arbeitsbereich.
- Wenn der Umschalter "Monatlich" deaktiviert ist, überprüfen Sie die auf der Seite angezeigte aktuelle jährliche Verpflichtung.
- Wenn die Abrechnungsverwaltung nicht geöffnet wird, versuchen Sie es erneut und lassen Sie die sichere Abrechnungsseite öffnen.
- Wenn das Abonnement überfällig ist, folgen Sie der angezeigten Abrechnungsmaßnahme, bevor Sie eine andere Planänderung versuchen.
- Wenn die Zahlung in einen Verarbeitungsstatus zurückkehrt, aktualisieren Sie und überprüfen Sie, bevor Sie erneut einreichen, um einen doppelten Versuch zu vermeiden.
## Verwandte Leitfäden
- [Guthaben und Nutzung](./credits-and-usage)
- [Arbeitsbereich Allgemein](../account-and-settings/workspace-general)
- [Löschen, Wiederherstellen und Verlassen](../account-and-settings/delete-recover-and-leave)
- [Agent-Skills](../agent/skills)
---
# Willkommen bei Runner AI
Source: https://www.runnerai.com/docs/de/guides/product-guide
Runner hilft Ihnen, eine Geschäftsidee in einen funktionierenden Online-Shop umzuwandeln und den Shop dann von einem Workspace aus zu verwalten. Diese Anleitungen erklären jede Hauptseite, jeden Eintrag, jeden Button, jeden Zustand und den sicheren nächsten Schritt in einfacher Sprache.
**[Ihren ersten Shop Schritt für Schritt erstellen](./start-here/first-store-quickstart)**
Folgen Sie den Screenshots und kurzen Videos, um einen Shop zu erstellen, Ihre erste Anfrage zu senden, die Vorschau zu prüfen und die Veröffentlichung vorzubereiten.
## Beginnen Sie mit dem Pfad, der Ihrem Ziel entspricht
**Start**
**Runner vor der Anmeldung erkunden** — Verstehen Sie die aktuelle öffentliche Navigation, Sprache, Demo und Anmeldungsaktionen. **Shop-Vorlagen durchsuchen und remixen** — Vergleichen Sie öffentliche Vorschauen und verstehen Sie, ob Remixing derzeit verfügbar ist. **Runner-Shop erstellen** — Erstellen Sie ein Projekt, senden Sie die erste Anfrage und erreichen Sie den Shop-Workspace. **Shopify verbinden** — Starten Sie den Shopify-Verbindungspfad und verstehen Sie, was in Shopify verbleibt.
**Bauen**
**Mit Runner chatten** — Senden Sie eine klare Anfrage, beantworten Sie Folgefragen und folgen Sie dem Aufgabenfortschritt. **Vorschau Ihres Shops** — Öffnen Sie die aktuelle Vorschau und überprüfen Sie Desktop- oder Mobile-Layouts. **Vorbereitung zur Veröffentlichung** — Schließen Sie das erforderliche Setup ab, bevor Sie **Veröffentlichen** auswählen.
**Betreiben**
**Produkte** — Finden Sie Produktsteuerelemente und verstehen Sie das Ergebnis jeder Aktion. **Apps und Integrationen** — Verbinden, überprüfen, erneut verbinden oder trennen Sie unterstützte Dienste.
**Verbessern**
**Analytics und SEO** — Lesen Sie Shop-, Traffic-, Konversions-, Such- und KI-Sichtbarkeitsansichten. **Funktionsverfügbarkeit** — Identifizieren Sie Voraussetzungen und den sichersten nächsten Schritt ohne zu raten. **Hilfe und Referenz** — Diagnostizieren Sie Aufgaben-, Build-, Veröffentlichungs-, Checkout- oder Integrationszustände.
## Der übliche Ablauf
1. [Melden Sie sich an](./start-here/sign-in) und öffnen Sie Ihren Arbeitsbereich.
2. Öffnen Sie das Shopnamen-Menü in der Seitenleiste und wählen Sie **Geschäft erstellen**. Verwenden Sie in einem leeren Arbeitsbereich **Geschäft erstellen** oder **+ Store**, falls angezeigt. Wählen Sie **Neu erstellen** oder **Shopify verbinden** nur, wenn die Auswahl des Shoptyps erscheint.
3. [Beschreiben Sie Runner Ihren Wunsch](./work-with-runner/write-effective-requests).
4. Verfolgen Sie den Aufgabenstatus und beantworten Sie die Fragen von Runner.
5. Prüfen Sie das Ergebnis unter [Storefront](./storefront-and-publishing/preview-your-store).
6. Nehmen Sie im [Designmodus](./storefront-and-publishing/design-mode) visuelle Änderungen vor oder senden Sie eine Folgeanfrage.
7. Richten Sie Produkte, Versand, Zahlungen und Shopdaten ein.
8. Arbeiten Sie die [Checkliste zur Veröffentlichung](./storefront-and-publishing/prepare-to-publish) ab und veröffentlichen Sie anschließend.
9. Nutzen Sie die Gruppen **Aufbauen**, **Wachstum** und **Messen** in der Seitenleiste, um Ihr Geschäft zu betreiben und zu verbessern.
## Durchsuchen Sie alle Dokumentationen
### Erste Schritte
- [Hier beginnen](./start-here)
melden Sie sich an, erstellen oder verbinden Sie einen Shop und schließen Sie den ersten nützlichen Workflow ab.
- [Arbeitsbereich](./workspace)
verwalten Sie Shops, Status, Teamkollegen, Benachrichtigungen und Workspace-Navigation.
- [Mit Runner arbeiten](./work-with-runner)
verwenden Sie Chat, Verlauf, Suche, Bilder, Profile, Skills und Aufgabendetails.
### Erstellen und betreiben Sie den Shop
- [Storefront und Veröffentlichung](./storefront-and-publishing)
Vorschau, Design, bedingte Code-Bearbeitung, Versionen, Veröffentlichung, Checkout und Domains.
- [Shop-Betrieb](./store-operations)
allgemeine Einstellungen, Versand, Produkte, Bestellungen, Kunden, Promotionen, Sourcing und Bewertungen.
- [Apps und Integrationen](./apps-and-integrations)
Zahlungen, E-Mail, Versand, Shopify, Erfüllung und Agent-Verbindungen.
### Messen, automatisieren und erstellen
- [Analytics und SEO](./analytics-and-seo)
Metriken, Traffic, Konversion, Suchleistung, Site-Gesundheit und KI-Sichtbarkeit.
- [Automatisieren, testen und erstellen](./automate-test-and-create)
Automatisierungen, Simulationen, Experimente, Creative Studio, Medienbibliothek und Ads.
- [Agent](./agent)
wiederverwendbare Skills, Speicher und die Befehlspalette.
### Konfigurieren und Fehlerbehebung
- [Konto und Einstellungen](./account-and-settings)
Workspace, Abrechnung, Nutzung, Shop, persönliche Einstellungen, API-Schlüssel und Sicherheitseinstellungen.
- [Erweiterte Funktionen](./advanced)
bedingte Research, Fly, Workflows, Webhooks und Verfügbarkeitsregeln.
- [Hilfe und Referenz](./help-and-reference)
Zustände, Fehlerbehebung, Support, Changelog, FAQ und Glossar.
## So lesen Sie diese Anleitungen
Jede Aufgabenseite folgt dem gleichen Muster:
### Seitenstruktur anzeigen
1. **Einstiegspfad** sagt Ihnen genau, wo Sie in Runner beginnen.
2. **Bevor Sie beginnen** listet erforderliche Shop-Status, Zugriff, Plan oder Verbindung auf.
3. **Steuerelemente** erklären, was jeder wichtige Button nach der Auswahl tut.
4. **Schritte** beschreiben den kürzesten sicheren Workflow.
5. **Zustände und Fehlerbehebung** erklären, was sich geändert hat und was Sie als nächstes versuchen sollten.
6. **Verwandte Anleitungen** verlinken auf die nächste wahrscheinliche Aufgabe.
## Sicherheitsgrenzen
Vor einem Klick mit hoher Auswirkung:
:::warning - lesen Sie die Bestätigung und den betroffenen Shop- oder Workspace-Namen; - speichern Sie Arbeit, die verfügbar bleiben sollte; - überprüfen Sie, ob die Aktion den Live-Shop, die Abrechnung, die Kundenkommunikation, Geheimnisse oder den Teamzugriff ändert; - fragen Sie einen Workspace-Eigentümer, wenn Ihre Rolle die Aktion nicht zulässt. :::
---
# Erste Schritte mit Runner
Source: https://www.runnerai.com/docs/de/guides/start-here
**Was dieser Leitfaden abdeckt:** Sie wissen, welchen Setup-Pfad Sie befolgen sollen und wohin Runner Sie nach jedem Schritt bringt.
Verwenden Sie diesen Bereich, wenn Sie sich zum ersten Mal anmelden, einen Runner-gestützten Store starten oder einen vorhandenen Shopify-Store verbinden.
**[Ihren ersten Shop Schritt für Schritt erstellen](/de/guides/start-here/first-store-quickstart)**
Folgen Sie den Screenshots und kurzen Videos, um einen Shop zu erstellen, Ihre erste Anfrage zu senden, die Vorschau zu prüfen und die Veröffentlichung vorzubereiten.
**Zugriffspfad:** Anmelden → Arbeitsbereich → Shopnamen-Menü in der Seitenleiste → **Geschäft erstellen**.
## Wählen Sie Ihren Pfad
| Ihre Situation | Beginnen Sie hier | Was als Nächstes geschieht |
| --- | --- | --- |
| Sie möchten die kürzeste vollständige Anleitung | [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart) | Gehen Sie von einer Store-Idee zu Vorschau und Veröffentlichungsprüfungen. |
| Sie möchten Runner vor der Anmeldung erkunden | [Runner vor der Anmeldung erkunden](/de/guides/start-here/explore-runner-before-sign-in) | Überprüfen Sie die öffentliche Navigation, Sprache, Demo und Kontoaktionen, die im aktuellen Rollout verfügbar sind. |
| Sie möchten eine Shop-Vorlage bewerten | [Shop-Vorlagen durchsuchen und remixen](/de/guides/start-here/browse-and-remix-templates) | Vergleichen Sie Desktop-, Mobile- und Screenshot-Vorschauansichten und überprüfen Sie die aktuelle Remix-Verfügbarkeit. |
| Sie haben kein Runner-Konto | [Anmelden](/de/guides/start-here/sign-in) | Überprüfen Sie Ihr Konto und betreten Sie dann einen Arbeitsbereich. |
| Sie möchten, dass Runner die Storefront und das Store-Backend erstellt | [Runner-Store erstellen](/de/guides/start-here/create-runner-store) | Runner erstellt ein Projekt und öffnet seinen Chat. |
| Sie verkaufen bereits über Shopify | [Shopify verbinden](/de/guides/start-here/connect-shopify) | Runner startet eine Shopify-Verbindung oder verwendet eine berechtigte vorhandene Verbindung erneut. |
| Sie sehen einen einleitenden Dialog oder eine Kreditbelohnung | [Willkommenstour und tägliche Credits](/de/guides/start-here/welcome-tour-and-daily-credits) | Erfahren Sie mehr über die Hauptbereiche oder fordern Sie die aktuell angezeigte Belohnung an. |
## Der First-Run-Pfad
1. [Melden Sie sich an](/de/guides/start-here/sign-in) und öffnen Sie Ihren Arbeitsbereich.
2. Beantworten Sie den kurzen Geschäftsfragebogen, falls Runner ihn anzeigt.
3. Öffnen Sie das Shopnamen-Menü in der Seitenleiste und wählen Sie **Geschäft erstellen**. Verwenden Sie in einem leeren Arbeitsbereich **Geschäft erstellen** oder **+ Store**, falls angezeigt.
4. Falls eine Shoptyp-Auswahl erscheint, wählen Sie **Neu erstellen** für einen neuen Runner-Shop oder **Shopify verbinden** für einen bestehenden Shopify-Shop.
5. Geben Sie unter **Geschäftsname** einen Namen ein, wählen Sie **Erstellen** und warten Sie, bis sich der neue Shop öffnet.
6. Beschreiben Sie in der Projektunterhaltung, was Runner erstellen soll.
## Bevor Sie beginnen
- Sie benötigen Zugriff auf die zur Anmeldung verwendete E-Mail-Adresse oder das Google-Konto.
- Ein Arbeitsbereich kann Grenzen für Shops und Mitglieder haben. Runner zeigt eine Upgrade-Option, wenn eine Grenze eine Aktion blockiert.
- **Shopify verbinden** erscheint möglicherweise nicht in jedem Arbeitsbereich.
- Eine erstellte Vorschau, eine veröffentlichte Storefront und ein funktionierender Checkout sind getrennte Zustände.
## Wenn Sie steckenbleiben
- Falls ein E-Mail-Code nicht funktioniert, fordern Sie einen neuen an, sobald **Bestätigungscode erneut senden** verfügbar ist.
- Falls **Geschäft erstellen** eine Upgrade-Meldung öffnet, prüfen Sie vor einem erneuten Versuch den aktuellen Tarif des Arbeitsbereichs.
- Falls Shopify nicht angezeigt wird, erstellen Sie einen Runner-Shop oder prüfen Sie, ob Shopify für Ihren Arbeitsbereich aktiviert ist.
## Verwandte Leitfäden
- [Anmelden](/de/guides/start-here/sign-in)
- [Runner vor der Anmeldung erkunden](/de/guides/start-here/explore-runner-before-sign-in)
- [Shop-Vorlagen durchsuchen und remixen](/de/guides/start-here/browse-and-remix-templates)
- [Runner-Store erstellen](/de/guides/start-here/create-runner-store)
- [Shopify verbinden](/de/guides/start-here/connect-shopify)
- [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart)
---
# Shop-Vorlagen durchsuchen und remixen
Source: https://www.runnerai.com/docs/de/guides/start-here/browse-and-remix-templates
Die öffentliche Shop-Vorlagen-Seite von Runner ermöglicht es Ihnen, veröffentlichte Vorlagen vor der Anmeldung zu überprüfen und, wenn Remixing verfügbar ist, eine Kopie in Ihrem eigenen Workspace anzufordern.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgR0WXr5OLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Wählen Sie eine Kategorie und eine Vorlage, prüfen Sie **Desktop**, **Mobil** oder **Screenshot** und wählen Sie **Diese Vorlage verwenden**, wenn Sie eine Kopie erstellen möchten. Das Bild zeigt den Start, keinen abgeschlossenen Remix.
Wählen Sie das Bild aus, um es zu vergrößern. Die Anmerkungen sind auf Englisch.
## Einstiegspfad
Öffnen Sie die öffentliche **Shop-Vorlagen**-Seite von Runner unter [www.runnerai.com/templates](https://www.runnerai.com/templates) oder folgen Sie einem Runner-Link zu einer Shop-Vorlage. Zum Durchsuchen der Galerie oder zum Öffnen einer Vorlage ist kein Konto erforderlich.
## Bevor Sie beginnen
- Sie benötigen ein Runner-Konto und einen aktiven Workspace, wenn Remixing verfügbar wird.
- Eine Live-Vorschau, ein Screenshot und ein Remix sind unterschiedlich: Vorschau ist schreibgeschützt; nur ein erfolgreiches Remix erstellt Projektarbeit.
- Die verfügbaren Vorlagen, Beschreibungen und Remix-Zählungen können sich ändern.
## Durchsuchen Sie die Galerie
Verwenden Sie den Kategoriefilter, um die Galerie einzugrenzen, einschließlich Vorlagen in **3D-Animation**. Jede Karte zeigt den Vorlagentitel, eine Miniaturansicht, falls verfügbar, und eine kurze Beschreibung. Wählen Sie eine Karte aus, um ihre Detailseite zu öffnen. Wenn die Seite **Noch keine Shop-Vorlagen** anzeigt, ist derzeit keine öffentliche Vorlage verfügbar; kehren Sie später zurück, anstatt es als Kontoproblem zu behandeln.
## Überprüfen Sie eine Vorlage
| Steuerelement oder Abschnitt | Was nach der Auswahl passiert |
| --- | --- |
| **Desktop** | Öffnet die Live-Vorlagenvorschau in einem Desktop-förmigen Rahmen. Die Vorlage wird nicht bearbeitet. |
| **Mobilgerät** | Zeigt die gleiche Live-Vorschau in einem schmalen Telefonrahmen. |
| **Screenshot** | Zeigt das gespeicherte Ganzseitenbild, falls verfügbar. Es ist ein statisches Bild, nicht der Live-Store. |
| **Über diese Vorlage** | Erklärt den Zweck der Vorlage. |
| **Entworfen für** | Listet die Zielgruppen oder Store-Typen auf, auf die sich die Vorlage konzentriert. |
| **Highlights und Funktionen** | Fasst die Hauptideen zusammen, die die Vorlage demonstriert. |
| Remix-Zählung | Zeigt, wie viele Kopien Runner aufgezeichnet hat. Es misst keine Live-Stores oder Verkäufe. |
| **Zurück zur Galerie** | Kehrt zur öffentlichen Vorlagenliste zurück. |
Wenn eine Live-Vorschau nicht verfügbar ist, verwenden Sie **Screenshot**, wenn die Vorlage einen hat. Ein fehlender Screenshot oder eine fehlende Vorschau hindert Sie nicht daran, die Vorlagendetails zu lesen.
## Remixen Sie die Vorlage
1. Überprüfen Sie die Vorlage in **Desktop**, **Mobilgerät** und **Screenshot**, falls verfügbar.
2. Wählen Sie **Diese Vorlage verwenden** nur aus, wenn Sie möchten, dass Runner ein Projekt daraus erstellt.
3. Wenn Sie abgemeldet sind, schließen Sie den Anmeldefluss ab. Runner behält die ausgewählte Vorlage für den Remix-Pfad bei.
4. Nach der Anmeldung, wenn das Setup nicht automatisch gestartet wurde, kehren Sie zum Vorlagendetail zurück und wählen Sie **Diese Vorlage verwenden** erneut aus. Warten Sie dann, während die Schaltfläche **Ihren Store einrichten…** anzeigt.
5. Der Kopiervorgang ist erfolgreich, wenn Runner ein neues Projekt in Ihrem Arbeitsbereich öffnet. Falls Runner einen Fehler meldet oder die Verbindung verliert, prüfen Sie vor einem erneuten Versuch die Shopliste. Die Meldung allein beweist nicht, dass kein Projekt erstellt wurde.
6. Überprüfen Sie die kopierte Storefront, Produkte, Einstellungen und den Veröffentlichungsstatus, bevor Sie sie live machen.
Ein erfolgreicher Remix wird zu Ihrem eigenen Projekt; Änderungen daran verändern die öffentliche Vorlage nicht. Es ist ein Ausgangspunkt, kein Beweis dafür, dass Zahlungen, Versand, Katalogdaten, Veröffentlichung oder Checkout bereit sind.
## Fehlerbehebung
| Status | Was zu tun ist |
| --- | --- |
| **Vorschau nicht verfügbar** | Wechseln Sie zu **Screenshot** oder lesen Sie die Vorlagendetails. |
| **Für diese Vorlage ist kein Screenshot verfügbar** | Verwenden Sie **Desktop** oder **Mobilgerät**, wenn die Live-Vorschau funktioniert. |
| Anmeldung öffnet sich nach **Diese Vorlage verwenden** | Schließen Sie die Anmeldung mit dem Konto ab, das den beabsichtigten Workspace besitzt. Wenn das Setup nicht gestartet wird, kehren Sie zur Vorlage zurück und wählen Sie **Diese Vorlage verwenden** erneut aus. |
| **Ihren Store einrichten…** | Halten Sie die Seite offen, während Runner das Projekt erstellt. Starten Sie nicht den gleichen Remix erneut. |
| **Dieser Shop konnte nicht remixt werden. Bitte versuchen Sie es erneut.** | Prüfen Sie vor einem erneuten Versuch im Shopnamen-Menü, ob bereits ein neues Projekt erstellt wurde. Bleibt Remix nicht verfügbar, sehen Sie sich die Vorlage an oder erstellen Sie stattdessen einen neuen Runner-Shop. |
| Vorlage nicht gefunden | Kehren Sie zur Galerie zurück; die Vorlage wird möglicherweise nicht mehr veröffentlicht. |
## Verwandte Leitfäden
- [Runner vor der Anmeldung erkunden](./explore-runner-before-sign-in)
- [Anmelden](./sign-in)
- [Einen Runner-Store erstellen](./create-runner-store)
- [Vorschau Ihres Stores](../storefront-and-publishing/preview-your-store)
---
# Einen Shopify-Store verbinden
Source: https://www.runnerai.com/docs/de/guides/start-here/connect-shopify
**Was dieser Leitfaden abdeckt:** Sie werden die Shopify-Autorisierung starten oder eine berechtigte Shopify-Verbindung für ein neues Runner-Projekt wiederverwenden.
Verwenden Sie diesen Pfad, wenn Ihr Katalog und Checkout bereits in Shopify live sind.
**Zugriffspfad:** Shopnamen-Menü → **Geschäft erstellen** → **Shopify verbinden**, wenn verfügbar.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Öffnen Sie das Store-Namensmenü und wählen Sie **Create Store**. Fahren Sie nur mit **Connect Shopify** fort, wenn Ihr Workspace diese Option anzeigt.
Die Markierungen sind auf Englisch. Wählen Sie das Bild zum Vergrößern aus.
## Bevor Sie beginnen
- **Shopify verbinden** muss für Ihren Workspace aktiviert sein.
- Sie benötigen die permanente Domain des Stores, die mit `.myshopify.com` endet.
- Für eine neue Verbindung benötigen Sie die Berechtigung, den Zugriff in Shopify zu genehmigen.
- Ihr Runner-Workspace muss Platz für einen weiteren Store haben.
## Store-Steuerelemente erstellen
| Steuerelement | Warum es nützlich ist | Was nach der Auswahl passiert |
| --- | --- | --- |
| **Shopify verbinden** Projekttyp | Behält das vorhandene Shopify-Commerce-System. | Zeigt Shopify-Verbindungsoptionen und das Shop-Domain-Feld. |
| **Store-Name** | Benennt das Runner-Projekt. | Wird im Runner-Workspace verwendet; es benennt den Shopify-Shop nicht um. |
| **Vorhandene Verbindung verwenden: _domain_** | Vermeidet wiederholte Autorisierung für eine berechtigte Verbindung. | Wählt diese Shopify-Verbindung für das neue Runner-Projekt aus. |
| **Einen anderen Store verbinden** | Beginnt mit einem anderen Shopify-Shop. | Zeigt **Shop-Domain**. |
| **Shop-Domain** | Identifiziert den Shopify-Store. | Akzeptiert eine Domain wie `your-store.myshopify.com`. |
| **Shopify verbinden** Absendeschaltfläche | Startet eine neue Autorisierung. | Sendet Sie zu Shopify; Runner beendet die Übergabe nur, nachdem Shopify erfolgreich zurückgekehrt ist. |
| **Erstellen** | Verwendet die ausgewählte vorhandene Verbindung. | Erstellt das Runner-Projekt und öffnet es. |
| **Abbrechen** | Verlässt ohne Verbindung oder Erstellung. | Das Dialogfeld wird geschlossen. |
## Verbinden Sie einen neuen Shopify-Store
1. Öffnen Sie das Shopnamen-Menü, wählen Sie **Geschäft erstellen** und anschließend **Shopify verbinden**.
2. Geben Sie einen **Store-Namen** für das Runner-Projekt ein.
3. Wählen Sie **Einen anderen Store verbinden**, wenn Verbindungsoptionen angezeigt werden.
4. Geben Sie die vollständige `.myshopify.com`-Domain in **Shop-Domain** ein.
5. Wählen Sie **Shopify verbinden**.
6. Überprüfen Sie die Zugriffanfrage auf Shopify und fahren Sie nur fort, wenn sie den erwarteten Store benennt.
7. Nachdem Shopify zu Runner zurückgekehrt ist, bestätigen Sie, dass das neue Projekt im Workspace angezeigt wird.
## Verwenden Sie eine vorhandene Verbindung erneut
1. Wählen Sie **Shopify verbinden** in **Store erstellen**.
2. Geben Sie den Runner **Store-Namen** ein.
3. Wählen Sie **Vorhandene Verbindung verwenden: _domain_**.
4. Wählen Sie **Erstellen**.
5. Prüfen Sie, ob Runner das neue Projekt mit dem gewünschten Shopnamen und der richtigen Shopify-Verbindung öffnet.
## Fehlerbehebung
| Status | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Shopify-Option fehlt | Die Funktion ist für diesen Workspace nicht aktiviert. | Verwenden Sie **Neu erstellen** oder überprüfen Sie die Workspace-Verfügbarkeit. |
| **Shopify verbinden** ist deaktiviert | Der Store-Name oder die `.myshopify.com`-Domain ist unvollständig. | Korrigieren Sie das hervorgehobene Feld. |
| Verbindung bereits verlinkt | Diese Shopify-Verbindung gehört zu einem anderen Runner-Store. | Wählen Sie eine andere berechtigte Verbindung oder einen anderen Shop. |
| Verbindung nicht gefunden | Eine gespeicherte Verbindung ist nicht mehr verfügbar. | Wählen Sie eine andere Verbindung oder starten Sie eine neue Autorisierung. |
| Shopify-Autorisierung ist abgebrochen | Shopify hat keine genehmigte Verbindung zurückgegeben. | Kehren Sie zu **Store erstellen** zurück und versuchen Sie es erneut, wenn Sie bereit sind. |
Der Checkout bleibt in Shopify für diesen Projekttyp. Eine erfolgreiche Verbindung beweist nicht, dass die Runner-Storefront erstellt oder veröffentlicht ist; überprüfen Sie diese Status separat.
## Verwandte Leitfäden
- [Erstellen Sie stattdessen einen Runner-Store](/de/guides/start-here/create-runner-store)
- [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart)
- [Erste Schritte](/de/guides/start-here)
---
# Einen Runner-Store erstellen
Source: https://www.runnerai.com/docs/de/guides/start-here/create-runner-store
**Was dieser Leitfaden abdeckt:** Sie werden ein neues Runner-Projekt erstellen und in seiner Projektkonversation ankommen.
Verwenden Sie **Neu erstellen**, wenn Sie von einer Idee ausgehen und den Shopify-Checkout nicht behalten müssen.
**Einstiegspfad:** Arbeitsbereich → Store-Name oben in der linken Seitenleiste → **Geschäft erstellen**. Klappen Sie die Seitenleiste zuerst auf, falls sie eingeklappt ist. Verwenden Sie in einem leeren Arbeitsbereich **Geschäft erstellen** oder **+ Store**, falls angezeigt.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Folgen Sie [Ihren ersten Store Schritt für Schritt erstellen](./first-store-quickstart) für ein vollständiges Beispiel mit Screenshots und kurzen Aufnahmen.
## Bevor Sie beginnen
- Sie müssen bei einem aktiven Workspace angemeldet sein.
- Ihr Workspace muss Platz für einen weiteren Store haben.
- Geben Sie einen Namen ein, der den Store für Ihr Team klar identifiziert.
## Store-Steuerelemente erstellen
| Steuerelement | Warum es nützlich ist | Was nach der Auswahl passiert |
| --- | --- | --- |
| **Neu erstellen**, falls angezeigt | Wählt den nativen Store-Pfad von Runner. | Das Formular behält nur die für einen Runner-Store erforderlichen Felder. Falls keine Store-Typ-Auswahl erscheint, fahren Sie mit Geschäftsname fort. |
| **Store-Name** | Benennt das Projekt in Ihrem Workspace. | **Erstellen** wird verfügbar, nachdem der Name gültig ist. |
| **Erstellen** | Bestätigt den neuen Store. | Runner erstellt das Projekt und navigiert zu seiner Konversation. |
| **Abbrechen** oder schließen | Verlässt ohne einen Store zu erstellen. | Das Dialogfeld wird geschlossen und der Workspace bleibt unverändert. |
## Erstellen Sie den Store
1. Öffnen Sie das Store-Namensmenü in der Seitenleiste und wählen Sie **Geschäft erstellen**, oder verwenden Sie die Erstellungsaktion im leeren Arbeitsbereich.
2. Wählen Sie **Neu erstellen**, falls das Formular diese Auswahl anbietet. Fahren Sie andernfalls mit **Geschäftsname** fort.
3. Geben Sie den **Store-Namen** ein.
4. Wählen Sie **Erstellen**.
5. Warten Sie, bis das neue Projekt geöffnet wird.
6. Beschreiben Sie im Projektgespräch Ihr Geschäft, Ihre Zielgruppe, die gewünschte Gestaltung und die benötigten Seiten. Sie können auch **Onlineshop** öffnen, um die erste Anfrage einzugeben.
Das Erstellen des Projekts veröffentlicht es nicht. Runner benötigt immer noch Ihre Anfrage, bevor es eine Storefront-Vorschau erstellen kann.
Öffnen Sie nach dem ersten abgeschlossenen Build **Onlineshop**, um die Vorschau zu prüfen. Eine fertige Vorschau ist noch nicht öffentlich. Wenn Sie den Store öffentlich machen möchten, wählen Sie **Veröffentlichen** und erledigen Sie vor der Bestätigung alle angezeigten Voraussetzungen.
## Fehlerbehebung
| Status | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Erstellen** ist deaktiviert | Ein erforderlicher Wert fehlt oder ist ungültig, oder die Erstellung wird bereits ausgeführt. | Überprüfen Sie **Store-Name** und warten Sie auf ausstehende Aktionen. |
| Upgrade-Nachricht | Der Workspace hat sein aktuelles Store-Limit erreicht. | Öffnen Sie die von Runner angezeigte Planinformation oder brechen Sie das Dialogfeld ab. |
| Workspace-Zugriff ist abgelaufen | Neue Stores können in diesem Workspace nicht erstellt werden. | Folgen Sie dem auf dem Bildschirm angezeigten Workspace-Reaktivierungs- oder Planpfad. |
| Erstellung fehlgeschlagen | Runner konnte das Projekt nicht fertig erstellen. | Behalten Sie den beabsichtigten Namen, kehren Sie zum Workspace zurück und versuchen Sie es erneut. |
## Verwandte Leitfäden
- [Anmelden](/de/guides/start-here/sign-in)
- [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart)
- [Verbinden Sie stattdessen Shopify](/de/guides/start-here/connect-shopify)
- [Willkommenstour und tägliche Guthaben](/de/guides/start-here/welcome-tour-and-daily-credits)
---
# Runner vor der Anmeldung erkunden
Source: https://www.runnerai.com/docs/de/guides/start-here/explore-runner-before-sign-in
Runners öffentliche Seiten ermöglichen es Ihnen, das Produkt kennenzulernen, Preise zu vergleichen und einen Demo- oder Kontoverlauf zu starten, bevor Sie einen Arbeitsbereich betreten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1kPfxvrvDHKGRP0BUIpjksTZQ9oN4rSwzeqA)
Erkunden Sie Runner über **Produkte** und **Ressourcen**, wählen Sie über die **Sprachauswahl** eine Sprache und öffnen Sie mit **So funktioniert es** das Demovideo. Dies ist eine andere Aktion als **Demo buchen**, das bei Verfügbarkeit die Terminbuchung öffnet.
Wählen Sie das Bild aus, um es zu vergrößern. Die Anmerkungen sind auf Englisch.
## Was dieser Leitfaden abdeckt
Sie finden sich auf den öffentlichen Seiten von Runner zurecht, wählen eine Sprache aus, buchen eine Demo sicher und wissen, ob die Hauptaktion die Anmeldung startet oder einen Arbeitsbereich öffnet.
## Verfügbarkeit und Voraussetzungen
- Zum Durchsuchen der öffentlichen Seiten ist kein Konto erforderlich.
- Runner kann eines von zwei öffentlichen Navigationslayouts anzeigen. Nur die Version, die dem aktuellen Besuch zugewiesen ist, wird angezeigt; dies ist normal.
- Das Planungsfeld **Demo buchen** verwendet einen externen Service und benötigt eine funktionierende Netzwerkverbindung.
- Die primäre Kontoaktion ändert sich nach der Anmeldung.
## Einstiegspfad
Öffnen Sie Runners öffentliche Startseite in einem Browser. Wählen Sie auf Mobilgeräten **Menü öffnen**, um die Navigation anzuzeigen, und **Menü schließen**, um sie zu schließen.
## Häufige Steuerelemente
| Steuerelement | Was nach der Auswahl geschieht |
| --- | --- |
| Sprachauswahl | Speichert die gewählte Sprache für das angemeldete Konto oder den aktuellen Browser und lädt die aktuelle Seite in dieser Sprache neu. |
| **Demo buchen** oder **Demo buchen** | Öffnet das Planungsfeld, dessen zugänglicher Titel **Demo buchen** ist. Ein Termin wird erst nach der Bestätigung durch den Planer erstellt. |
| **Starten** oder **Kostenlos starten** | Öffnet den Runner-Anmelde- oder Kontoerstellungsverlauf. Das Label hängt von der öffentlichen Navigationsversion ab. |
| **Arbeitsbereich öffnen** | Wird für einen angemeldeten Besucher angezeigt und öffnet den geschützten Arbeitsbereich. |
| Avatar des angemeldeten Benutzers | Öffnet das verfügbare Kontomenü anstelle der Aktion **Starten** oder **Kostenlos starten** für abgemeldete Benutzer. |
| **Menü öffnen** / **Menü schließen** | Zeigt oder verbirgt die mobile Navigation. Wenn Sie ein Ziel auswählen, wird das Menü geschlossen, wenn die Navigation beginnt. |
Das mobile Menü enthält die Links und die Sprachsteuerung für die öffentliche Navigationsversion, der Sie zugewiesen wurden. Die Hauptaktion bleibt leicht erreichbar in der Nähe der Menükante: **Starten** oder **Kostenlos starten**, wenn Sie abgemeldet sind, oder die angemeldete Arbeitsbereichsaktion, wenn verfügbar.
## Wählen Sie Ihren nächsten Schritt
1. Öffnen Sie [Preise](https://www.runnerai.com/pricing), um die öffentlichen Tarife und enthaltenen Funktionen zu vergleichen.
2. Durchsuchen Sie [Vorlagen](https://www.runnerai.com/templates), um einen Ausgangspunkt auf Desktop und Mobilgerät zu prüfen.
3. Kehren Sie zur zentralen Kontoaktion zurück, wenn Sie mit der Erstellung beginnen möchten.
4. Prüfen Sie nach der Anmeldung, ob Runner den gewünschten Arbeitsbereich geöffnet hat, bevor Sie einen Shop erstellen.
## Sprache ändern
1. Öffnen Sie die Sprachauswahl.
2. Wählen Sie die gewünschte Sprache aus.
3. Warten Sie, bis die Seite neu geladen wird.
4. Bestätigen Sie, dass die aktuelle Seite, nicht ein unverwandtes Ziel, in der ausgewählten Sprache erneut geöffnet wurde.
Wenn das Speichern fehlschlägt, behält Runner die vorherige Sprache bei und meldet einen Fehler. Versuchen Sie es erneut, nachdem Sie die Verbindung überprüft haben. Eine Sprachänderung betrifft nur die Oberflächentext; sie übersetzt keine Inhalte, die Sie in ein Store-Projekt eingegeben haben.
## Demo buchen
1. Wählen Sie **Demo buchen** oder **Demo buchen**, je nachdem, welche Navigation angezeigt wird.
2. Warten Sie, bis der Planer verfügbare Daten und Zeiten anzeigt.
3. Wählen Sie eine Zeit aus und füllen Sie die angeforderten Kontaktdaten aus.
4. Bestätigen Sie den Termin im Planer.
5. Warten Sie auf Runners Erfolgsmeldung und das Schließen des Feldes.
Das Schließen des Planers vor der Bestätigung bucht keinen Termin. Wenn er leer bleibt oder nicht verfügbar ist, schließen Sie ihn, überprüfen Sie die Verbindung und versuchen Sie es erneut. Verwenden Sie [Support und Community](/de/guides/help-and-reference/support-and-community), wenn das Problem wiederholt auftritt.
## Runner starten oder erneut öffnen
- Wenn Sie abgemeldet sind, wählen Sie **Starten** oder **Kostenlos starten** und führen Sie die angezeigten Anmelde- oder Kontoerstellungsschritte aus.
- Wenn Sie bereits angemeldet sind, wählen Sie **Arbeitsbereich öffnen**, um das geschützte Produkt zu betreten.
- Wenn eine geschützte Aktion Sie zur Anmeldung zurückbringt, melden Sie sich für das beabsichtigte Konto an, bevor Sie fortfahren.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Andere öffentliche Links als erwartet | Runner hat die andere aktuelle Navigationsversion zugewiesen. Verwenden Sie die sichtbaren Beschriftungen. |
| Mobile Links sind verborgen | Wählen Sie **Menü öffnen**. Nachdem Sie einen Link ausgewählt haben, öffnen Sie das Menü erneut, wenn Sie ein anderes Ziel benötigen. |
| Kontotasten zeigen Platzhalter | Runner überprüft die Sitzung noch. Warten Sie auf **Starten**, **Kostenlos starten** oder **Arbeitsbereich öffnen**, bevor Sie entscheiden, ob Sie angemeldet sind. Die Sprachsteuerung kann während dieser Überprüfung auch nicht verfügbar bleiben. |
| Sprache ändert sich nicht | Die Einstellung wurde nicht bestätigt. Überprüfen Sie den Fehler und die Verbindung, dann versuchen Sie es erneut. |
| Demo-Planer wird geladen | Warten Sie auf die Datums- und Zeitsteuerelemente, bevor Sie Details eingeben. |
| Demo-Feld wird ohne Erfolg geschlossen | Keine Buchung wurde bestätigt. Öffnen Sie es erneut und führen Sie die Planer-Bestätigung aus. |
| **Starten** oder **Kostenlos starten** wird durch **Arbeitsbereich öffnen** ersetzt | Runner erkennt eine angemeldete Sitzung. Öffnen Sie den [Arbeitsbereich](/de/guides/workspace) oder verwenden Sie das Avatar-Menü für Kontoaktionen. |
## Verwandte Leitfäden
- [Anmelden](/de/guides/start-here/sign-in)
- [Shop-Vorlagen durchsuchen und remixen](/de/guides/start-here/browse-and-remix-templates)
- [Runner-Store erstellen](/de/guides/start-here/create-runner-store)
- [Support und Community](/de/guides/help-and-reference/support-and-community)
---
# Ihren ersten Store Schritt für Schritt erstellen
Source: https://www.runnerai.com/docs/de/guides/start-here/first-store-quickstart
Erstellen Sie eine Storefront, die Sie prüfen, ändern und zum Teilen vorbereiten können. Folgen Sie den Schritten der Reihe nach oder springen Sie über das Inhaltsverzeichnis zum gewünschten Schritt.
Das Beispiel heißt **Quiet Mornings**, ein Shop für handgefertigte Kerzen. Sie können stattdessen Ihre eigene Geschäftsidee verwenden. Screenshots und Aufnahmen ohne Ton zeigen die englische Oberfläche; Fragen und verfügbare Steuerelemente können je nach Store abweichen.
**Einstiegspfad:** [Runner AI](https://www.runnerai.com) → **Kostenlos starten** → anmelden → Ihr Arbeitsbereich.
## Der kurze Weg
1. Öffnen Sie das Store-Namensmenü → **Geschäft erstellen** (oder **+ Geschäft** in einem leeren Arbeitsbereich). Wählen Sie **Neu erstellen**, falls angezeigt, oder **Shopify verbinden** für einen bestehenden Shopify-Store.
2. Beschreiben Sie im Projektgespräch Ihr Geschäft, Ihre Zielgruppe, die gewünschte Gestaltung und die benötigten Seiten. Senden Sie die Anfrage und beantworten Sie Runners Fragen.
3. Öffnen Sie nach dem ersten fertigen Build **Onlineshop** und prüfen Sie die Vorschau. Eine fertige Vorschau ist noch nicht öffentlich.
4. Wählen Sie zum Start **Veröffentlichen** und erledigen Sie vor der Bestätigung alle angezeigten Voraussetzungen. Veröffentlichung und funktionierender Checkout müssen getrennt geprüft werden.
## Bevor Sie beginnen
- Verwenden Sie eine E-Mail-Adresse oder ein Google-Konto, auf die Sie zugreifen können.
- Wählen Sie einen [Arbeitsbereich](/de/guides/workspace) mit einem freien Store-Platz und ausreichend Guthaben für die Anfrage. Klären Sie Tarif- oder Zugriffsbeschränkungen, bevor Sie einen weiteren Store erstellen.
- Beschreiben Sie in einem Satz, was Sie verkaufen und wer es kauft. Verfeinern Sie das Design nach der ersten Vorschau.
Sie müssen keinen Zahlungsanbieter verbinden, um eine Storefront zu prüfen. **Vorschau**, **veröffentlicht** und **bereit für Zahlungen** sind getrennte Prüfpunkte.
## 1. Anmelden [#sign-in]
1. Öffnen Sie Runner und wählen Sie **Kostenlos starten**. Wenn Sie bereits angemeldet sind, wählen Sie **Workspace öffnen**.
2. Wählen Sie **Mit Google fortfahren** und Ihr Konto oder geben Sie Ihre **E-Mail** ein, wählen Sie **Fortfahren** und geben Sie den Code aus der E-Mail von Runner ein.
3. Beantworten Sie gegebenenfalls die Fragen zum Konto. Runner öffnet Ihren Arbeitsbereich oder kehrt zur Ausgangsseite zurück.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
**Prüfen:** Sie können Ihren Arbeitsbereich öffnen, ohne zur Anmeldung zurückzukehren. Falls ein Code oder die Kontoauswahl nicht funktioniert, lesen Sie [Anmelden](./sign-in).
## 2. Einen Store erstellen [#create-store]
1. Wählen Sie oben in der linken Seitenleiste den Store-Namen und dann **Geschäft erstellen**. Klappen Sie die Seitenleiste zuerst auf, falls sie eingeklappt ist. Verwenden Sie in einem leeren Arbeitsbereich die dort angezeigte Aktion **Geschäft erstellen** oder **+ Store**.
2. Wählen Sie **Neu erstellen**, falls das Formular eine Auswahl anbietet. Um einen bestehenden Shopify-Store zu behalten, verwenden Sie stattdessen [Shopify verbinden](./connect-shopify).
3. Geben Sie unter **Geschäftsname** den Namen **Quiet Mornings** oder Ihren eigenen Namen ein.
4. Wählen Sie **Erstellen** und warten Sie, bis sich der neue Store öffnet. Wählen Sie Erstellen nicht erneut, während der Vorgang läuft.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
**Prüfen:** Die Seitenleiste zeigt den Namen des neuen Stores. Durch das Erstellen des Stores wird seine Storefront noch nicht aufgebaut oder veröffentlicht.
## 3. Die erste Version beschreiben [#first-request]
1. Wählen Sie **Onlineshop**. Wenn noch keine Version erstellt wurde, zeigt Runner ein Eingabefeld für das gewünschte Aussehen. Sie können auch die Konversation des neuen Stores verwenden.
2. Kopieren Sie dieses Beispiel in das Eingabefeld und passen Sie die Geschäftsdetails an:
~~~text
Build a store for Quiet Mornings, a handmade candle brand for people
who enjoy slow mornings. Use warm cream colors, forest-green accents,
and spacious product photography. Include a homepage, product pages,
About, and Contact. Start with three sample candles: Morning Light,
Cedar Cabin, and Lavender Dusk. Keep the store unpublished.
~~~
3. Wählen Sie den Sendepfeil (**Nachricht senden**). Falls Ihr Startbildschirm **Mit dem Aufbau beginnen** zeigt, verwenden Sie diese Aktion.
4. Runner öffnet die Konversation zum Aufbau und beginnt mit der Arbeit. Bleiben Sie in diesem Store, während Sie das Ergebnis prüfen.
**Prüfen:** Ihre Anfrage erscheint in der Konversation. Darunter sehen Sie eine Fortschrittsanzeige oder eine Rückfrage. Beispielprodukte dienen zum Üben; ersetzen Sie ihre Angaben, bevor Sie sie verkaufen.
## 4. Fragen beantworten und die Arbeit verfolgen [#follow-progress]
1. Lesen Sie jede Frage. Wählen Sie eine Antwort oder verwenden Sie **Andere…**, um eine eigene zu schreiben.
2. Beantworten Sie die übrigen Fragen. In diesem Beispiel wählen wir einen Kerzenpreis und einen Stil für die Produktfotos.
3. Warten Sie, bis Runner fortfährt. Öffnen Sie **Details**, wenn Sie einen fehlgeschlagenen oder blockierten Schritt verstehen möchten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
### Ansehen: Rückfragen beantworten
Die Aufnahme zeigt die Preiswahl, den Wechsel zur Fotofrage und die Auswahl einer visuellen Richtung. **Beantwortet** bestätigt die Auswahl und Runner setzt die Arbeit fort. Ihre Fragen hängen von Ihrer Anfrage ab.
**Prüfen:** Keine Frage wartet mehr auf Ihre Antwort. Eine abgeschlossene Nachricht allein reicht nicht als Abschlussprüfung: Öffnen Sie die Storefront und prüfen Sie, was tatsächlich geladen wird.
## 5. Vorschau prüfen und eine Änderung vornehmen [#preview-and-change]
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
1. Öffnen Sie **Onlineshop** oder wählen Sie **Vorschau** auf der abgeschlossenen Erstellungskarte, falls angeboten.
2. Warten Sie, bis der Store selbst erscheint. **Vorschau wird vorbereitet …** bedeutet, dass Sie ihn noch nicht prüfen können.
3. Öffnen Sie die Startseite, ein Produkt, About und Contact. Prüfen Sie Texte, Bilder, Preise und Navigation.
4. Verwenden Sie die Geräteauswahl, um **PC**, **Tablet** und **Telefon** zu prüfen. Achten Sie auf abgeschnittenen Text, überlappende Schaltflächen und horizontales Scrollen.
5. Kehren Sie zur Konversation zurück und bitten Sie um eine konkrete Änderung:
~~~text
Change the homepage headline to “Make room for a slower morning.”
Keep the colors, layout, and product information unchanged.
~~~
6. Warten Sie auf die Änderung, öffnen Sie die aktuelle Vorschau erneut und prüfen Sie, ob die neue Überschrift sichtbar ist. Prüfen Sie nochmals die Ansicht Telefon.
**Prüfen:** Sie können die gewünschte Änderung in der Vorschau sehen. Der Store ist weiterhin unveröffentlicht. Falls verfügbar, können Sie im [Designmodus](../storefront-and-publishing/design-mode) auch ein Element für eine gezielte Bearbeitung auswählen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
### Ansehen: Desktop- und Telefonlayouts prüfen
Die Geräteauswahl wechselt von **PC** zu **Tablet**, dann **Telefon** und zurück zu **PC**. Nur der Vorschaurahmen ändert sich; diese Aktion veröffentlicht oder bearbeitet Ihren Store nicht.
## 6. Die Prüfungen vor der Veröffentlichung ansehen [#publish-checks]
Für die Veröffentlichung kann ein kostenpflichtiger Tarif oder zusätzlicher Zugriff auf den Arbeitsbereich erforderlich sein. Wenn **Veröffentlichen** eine Upgrade-Meldung öffnet, prüfen Sie die [aktuellen Tarife](https://www.runnerai.com/pricing) oder kehren Sie zur Vorschau zurück. Klären Sie diese Voraussetzung, bevor Sie die Veröffentlichungsbestätigung erwarten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
1. Wählen Sie **Veröffentlichen** in der Storefront-Werkzeugleiste. Das startet Zugriffs- und Bereitschaftsprüfungen; es beweist noch nicht, dass der Store live ist.
2. Lesen Sie **Bereitstellung bestätigen** und warten Sie auf die Build-Prüfung.
3. Beheben Sie die angezeigten Probleme. **Mit KI beheben** fordert eine Reparatur an, **Prüfung wiederholen** führt die Prüfung erneut aus und **Shop-Betrieb öffnen** führt zur Einrichtung, falls angeboten.
4. Wenn Sie üben, wählen Sie **Abbrechen**. Um diese Version öffentlich zu machen, prüfen Sie alle Warnungen und wählen Sie **Bestätigen** erst, wenn die Schaltfläche aktiviert ist.
5. Warten Sie nach der Bestätigung auf eine erfolgreiche Veröffentlichung, öffnen Sie die öffentliche URL und prüfen Sie die Live-Seiten. Gehen Sie bei einem Fehlschlag nicht davon aus, dass Ihre Änderungen live sind.
Im Screenshot ist die Build-Prüfung bestanden, aber die Einrichtung erfordert noch Aufmerksamkeit. **Trotzdem veröffentlichen – ich schließe die Einrichtung später ab.**, falls angeboten, bestätigt die aufgeführte unvollständige Einrichtung; die Arbeit wird dadurch nicht erledigt.
### Ansehen: Prüfungen verlassen, ohne zu veröffentlichen
Die Aufnahme zeigt das Build-Ergebnis und die Warnung zur Einrichtung. Anschließend wird **Abbrechen** gewählt und die Vorschau wieder geöffnet. Der Beispielstore wird nicht veröffentlicht.
**Prüfen:** Eine funktionierende Vorschau zeigt, dass Sie den Build sehen können. Eine erfolgreiche Veröffentlichung und eine funktionierende öffentliche URL zeigen, dass Besucher den Store erreichen. Bevor Sie Bestellungen annehmen, müssen Zahlungsanbindung und Checkout-Prüfungen abgeschlossen sein.
Verwenden Sie [Veröffentlichung vorbereiten](../storefront-and-publishing/prepare-to-publish) für Produkte, Versand, Richtlinien und weitere Einstellungen. Fahren Sie mit [Veröffentlichen und erneut veröffentlichen](../storefront-and-publishing/publish-and-republish) und [Live-Store und Checkout](../storefront-and-publishing/live-store-and-checkout) fort.
## Wenn ein Schritt nicht abgeschlossen wird
| Was Sie sehen | Ihr nächster Schritt |
| --- | --- |
| Noch kein Store | Öffnen Sie das Store-Namensmenü oder die Erstellungsaktion im leeren Arbeitsbereich. |
| Store-Platz- oder Tariflimit | Prüfen Sie den Tarif des Arbeitsbereichs oder wählen Sie einen mit Platz. Wiederholtes Erstellen hebt das Limit nicht auf. |
| Eine Frage wartet auf Eingabe | Beantworten Sie sie, damit Runner fortfahren kann. |
| Vorschau wird vorbereitet | Lassen Sie die aktuelle Version geöffnet. Verwenden Sie Aktualisieren, falls angeboten, wenn die Vorbereitung nicht mehr voranschreitet. |
| Fehlgeschlagene, gestoppte oder widersprüchliche Ergebnisse | Öffnen Sie Details, lesen Sie das verbleibende Problem und prüfen Sie die tatsächliche Vorschau. Bitten Sie Runner, das konkrete Problem zu beheben, statt sich allein auf die Erfolgsmeldung zu verlassen. |
| Bestätigen ist deaktiviert | Schließen Sie den Build oder die aktive Aufgabe ab und erfüllen Sie die aufgeführten Anforderungen. „Keine Änderungen“ erfordert eine neue gespeicherte Änderung; es ist keine Warnung zum Wegklicken. |
| Ein Live-Store kann keine Zahlungen annehmen | Schließen Sie die Zahlungsanbindung und Checkout-Einrichtung ab, die unter Apps oder im Veröffentlichungsablauf angezeigt werden. |
## Verwandte Leitfäden
- [Einen Runner-Store erstellen](./create-runner-store)
- [Wirksame Anfragen schreiben](../work-with-runner/write-effective-requests)
- [Store in der Vorschau prüfen](../storefront-and-publishing/preview-your-store)
- [Ihren ersten Store für Kunden öffnen](../open-your-first-store)
---
# Bei Runner anmelden
Source: https://www.runnerai.com/docs/de/guides/start-here/sign-in
**Was dieser Leitfaden abdeckt:** Sie melden sich an und kehren zur Runner-Seite oder zum Arbeitsbereich zurück, der den Login-Verlauf gestartet hat.
Verwenden Sie E-Mail, wenn Sie einen passwortlosen einmaligen Code möchten. Verwenden Sie Google, wenn dieses Konto bereits in Ihrem Browser verfügbar ist.
**Einstiegspfad:** Runner-Startseite → **Kostenlos starten** oder **Workspace öffnen**, wenn Sie bereits angemeldet sind.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Den vollständigen bebilderten Ablauf finden Sie unter [Ihren ersten Store Schritt für Schritt erstellen](./first-store-quickstart).
## Bevor Sie beginnen
- Verwenden Sie ein E-Mail-Konto, das Sie auf demselben vertrauenswürdigen Gerät öffnen können.
- Wenn Ihre Organisation Sie eingeladen hat, melden Sie sich mit der eingeladenen E-Mail-Adresse an.
- Teilen Sie keinen einmaligen Code und lassen Sie ihn nicht in einem Screenshot sichtbar.
## Anmeldesteuerelement
| Steuerelement | Warum es nützlich ist | Was nach der Auswahl geschieht |
| --- | --- | --- |
| **Mit Google fortfahren** | Verwendet Ihr Google-Konto. | Öffnet Googles Konto- und Zustimmungsverlauf. Runner wird nach erfolgreicher Rückkehr von Google fortgesetzt. |
| **E-Mail** | Ermöglicht die Anmeldung ohne Passwort. | Akzeptiert die Adresse, die den einmaligen Code erhält. |
| **Fortfahren** | Fordert einen E-Mail-Code an. | Runner sendet einen sechsstelligen Verifizierungscode und öffnet das Code-Formular. |
| Verifizierungscodefelder | Bestätigt, dass Sie die E-Mail-Adresse kontrollieren. | Das Formular wird automatisch eingereicht, nachdem alle sechs Ziffern eingegeben wurden. |
| **Verifizierungscode erneut senden** | Ersetzt einen fehlenden oder abgelaufenen Code. | Sendet einen weiteren Code, nachdem der sichtbare Countdown endet. |
## Mit E-Mail anmelden
1. Geben Sie Ihre E-Mail-Adresse ein.
2. Wählen Sie **Fortfahren**.
3. Öffnen Sie die Nachricht von Runner und suchen Sie den sechsstelligen Code.
4. Geben Sie alle sechs Ziffern ein. Sie müssen keine weitere Schaltfläche zum Absenden auswählen.
5. Warten Sie, bis Runner Sie zum sicheren Ziel zurückbringt, das die Anmeldung gestartet hat.
## Füllen Sie die Fragen für neue Konten aus
Einige neue Konten sehen **Erzählen Sie Runner von Ihrem Store**, bevor Sie den Arbeitsbereich betreten.
1. Wählen Sie eine Antwort für die offene Frage.
2. Wählen Sie **Nächste Frage**, um fortzufahren.
3. Verwenden Sie **Ändern**, um eine beantwortete Frage zu überarbeiten.
4. Wählen Sie **Erste Schritte**, wenn alle erforderlichen Fragen beantwortet sind.
Der Fragebogen fragt nach Geschäftskontext; er erstellt oder veröffentlicht nicht selbst einen Store.
## Fehlerbehebung
| Zustand | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Ungültige E-Mail | Die Adresse ist unvollständig oder kann nicht wie eingegeben verwendet werden. | Korrigieren Sie die Adresse und wählen Sie dann **Fortfahren** erneut. |
| Wird gesendet | Runner fordert die Verifizierungs-E-Mail an. | Halten Sie die Seite offen, bis das Code-Formular angezeigt wird. |
| Falscher Code | Der eingegebene Code wurde nicht akzeptiert. | Geben Sie den neuesten Code erneut ein oder fordern Sie einen anderen an. |
| Countdown erneut senden | Ein weiterer Code kann noch nicht gesendet werden. | Warten Sie, bis **Verifizierungscode erneut senden** verfügbar ist. |
| Fragebogen konnte nicht gespeichert werden | Runner konnte die Antworten nicht speichern. | Halten Sie Ihre Antworten auf dem Bildschirm und versuchen Sie die Aktion erneut. |
Teilen Sie einen Verifizierungscode mit niemandem. Der Runner-Support benötigt ihn nicht, um bei einem Kontoproblem zu helfen.
## Verwandte Leitfäden
- [Erste Schritte](/de/guides/start-here)
- [Runner-Store erstellen](/de/guides/start-here/create-runner-store)
- [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart)
---
# Verwenden Sie die Willkommenstour und tägliche Credits
Source: https://www.runnerai.com/docs/de/guides/start-here/welcome-tour-and-daily-credits
**Was dieser Leitfaden abdeckt:** Sie verlassen die Willkommenstour und wissen, wo die Kerntools zu finden sind, und verstehen, was sich nach einer täglichen Anmeldung ändert.
Verwenden Sie diese Seite, wenn Runner **Willkommen bei Runner** öffnet oder wenn **Kostenlose Credits verdienen** sichtbar ist.
## Einstiegspfade
- **Willkommenstour:** Runner öffnet **Willkommen bei Runner** automatisch für ein berechtigtes Konto. Die Tour hat keinen permanenten Navigationseintrag.
- **Tägliche Credits:** **Credits verdienen** → **Täglicher Check-in**.
## Bevor Sie beginnen
- Die Willkommenstour und die tägliche Belohnung können fehlen, wenn das Konto nicht berechtigt ist oder der Schritt bereits abgeschlossen ist.
- Lesen Sie den Betrag, das Ablaufdatum und den Anspruchszustand im aktuellen Dialog, anstatt sich auf einen älteren Screenshot zu verlassen.
- Willkommens-Credits sind von täglichen Check-in-Credits getrennt. Lesen Sie die aktuelle Willkommensnachricht, um zu sehen, was bereits gutgeschrieben wurde, bevor Sie eine tägliche Belohnung anfordern.
## Folgen Sie der Willkommenstour
Die sechs Tourschritte führen in das Erstellen und Vorschauen, Creative Studio, Skills, Dropshipping, Shop-Betrieb und Design Mode ein.
| Steuerelement | Was geschieht |
| --- | --- |
| Schritt-Punkte | Springt direkt zum ausgewählten Tourschritt. |
| **Zurück** | Kehrt zum vorherigen Schritt zurück. Es ist beim ersten Schritt deaktiviert. |
| **Weiter** | Öffnet den nächsten Schritt. |
| **Video vergrößern** | Öffnet die aktuelle Demonstration in größerer Größe, wenn das Video bereit ist. |
| **Tour überspringen** oder schließen | Schließt die Tour, ohne den Store zu ändern. |
| **Mit dem Erstellen beginnen** | Beendet den letzten Schritt und schließt die Tour. |
1. Lesen Sie den Zweck des aktuellen Bereichs.
2. Spielen Sie die Demonstration ab oder vergrößern Sie sie, wenn dies hilfreich ist.
3. Wählen Sie **Weiter**, **Zurück** oder einen Schritt-Punkt, um durch die Tour zu navigieren.
4. Wählen Sie **Mit dem Erstellen beginnen** im letzten Schritt oder **Tour überspringen**, wenn Sie bereit sind zu arbeiten.
Die Tour ist informativ. Sie führt keine Skill aus, importiert kein Produkt und ändert keine Storefront.
## Fordern Sie eine tägliche Belohnung an
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsiEEL0uaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Im Bild: 1. Öffnen Sie **Credits verdienen**. 2. Suchen Sie **Täglicher Check-in**. 3. **Done** im Bild bedeutet, dass die heutige Belohnung bereits abgeholt wurde. Kontowerte sind in diesem Beispiel verdeckt. Wählen Sie das Bild aus, um es zu vergrößern. Die Markierungen verwenden die englische Desktop-Oberfläche.
Der Dialog kann die aktuelle Serie, die heutigen verfügbaren Credits, das Ablaufdatum der Belohnung, Credits, die im aktuellen Zyklus gewährt wurden, und den nächsten Meilenstein anzeigen.
Bei **Willkommensgeschenk** bestätigt die Nachricht, dass die angezeigten Willkommens-Credits bereits im Guthaben enthalten sind. Die tägliche Schaltfläche fordert eine separate Belohnung an; sie schreibt das Willkommensgeschenk nicht erneut gut.
Das Schließen von **Willkommensgeschenk** entfernt nicht die Willkommens-Credits, die bereits im Guthaben vorhanden sind. Das Schließen einer noch anforderbaren täglichen Anmeldung lässt diese separate tägliche Belohnung unangefordert.
1. Bestätigen Sie, dass der Dialog sagt, dass eine Belohnung angefordert werden kann.
2. Überprüfen Sie den angezeigten Betrag und das Ablaufdatum.
3. Wählen Sie **Heute einchecken** oder die sichtbare Anspruchsschaltfläche.
4. Warten Sie auf den angeforderten Zustand, bevor Sie den Dialog schließen.
5. Prüfen Sie das angezeigte Guthaben oder den Belohnungsverlauf, um zu bestätigen, dass die tägliche Belohnung genau einmal gutgeschrieben wurde.
## Fehlerbehebung
| Zustand | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Anspruchsschaltfläche verfügbar | Die heutige Belohnung kann für den angezeigten Arbeitsbereich angefordert werden. | Wählen Sie es einmal aus und warten Sie auf Bestätigung. |
| Eingecheckt / angefordert | Die heutige Belohnung wurde bereits hinzugefügt. | Kehren Sie an einem anderen berechtigten Tag zurück. |
| Belohnung nicht verfügbar | Das Konto ist derzeit nicht berechtigt oder es ist kein Anspruch fällig. | Schließen Sie den Dialog; nehmen Sie nicht an, dass ein Credit hinzugefügt wurde. |
| Anspruch fehlgeschlagen | Runner hat die Belohnung nicht bestätigt. | Halten Sie den Dialog offen und versuchen Sie es später erneut. |
Das Schließen einer anforderbaren Belohnung lässt sie unangefordert. Überprüfen Sie das angezeigte Ablaufdatum, bevor Sie entscheiden, später zurückzukehren.
## Verwandte Leitfäden
- [Erste Schritte](/de/guides/start-here)
- [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart)
- [Runner-Store erstellen](/de/guides/start-here/create-runner-store)
---
# Shop-Betrieb
Source: https://www.runnerai.com/docs/de/guides/store-operations
Verwenden Sie den Shop-Betrieb, um die täglichen Informationen und Aktivitäten hinter Ihrem Runner-Shop zu verwalten.
## Warum und wann Sie den Shop-Betrieb verwenden
Öffnen Sie diesen Bereich, nachdem Runner Ihren Shop erstellt hat. Es ist das praktische Kontrollzentrum für Shop-Details, Versandregeln, Produkte, Bestellungen, Kunden und Promotionen. Einige Arbeiten, wie z. B. Lieferanten-Sourcing oder Bewertungsmoderator, erscheinen nur, wenn die entsprechende Funktion verfügbar ist.
## Verfügbarkeit und Voraussetzungen
- Melden Sie sich an und öffnen Sie ein Runner-Projekt, das einen Shop enthält.
- Warten Sie, wenn Runner **Bitte warten, der Store-Administrator wird bereitgestellt...** anzeigt. Die Seiten werden geladen, wenn das Store-Backend bereit ist.
- Ihre Workspace-Rolle und der Status des Shops können einschränken, welche Steuerelemente angezeigt werden.
- Verbundene Zahlungs-, Versand-, Erfüllungs-, Buchungs- und Lieferantendienste können statusspezifische Steuerelemente hinzufügen.
## Shop-Betrieb öffnen
1. Öffnen Sie **Arbeitsbereich**.
2. Wählen Sie den Shop, den Sie verwalten möchten.
3. Wählen Sie **Shop-Betrieb** in der Projektnavigation.
4. Falls Einrichtungskarten erscheinen, [ergänzen Sie die erforderlichen Shopdaten und klären Sie Produkt- und Versandeinrichtung](/de/guides/store-operations/onboarding-and-general-settings). Wählen Sie anschließend **Shop-Betrieb öffnen**.
5. Wählen Sie einen Bereich im Menü Shop-Betrieb.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRKgUAoOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Falls diese Einrichtungskarten erscheinen, ergänzen Sie die Pflichtangaben und klären Sie die optionalen Schritte, bevor Sie das Verwaltungsmenü nutzen. Das Bild zeigt weder eine Veröffentlichung noch die Einrichtung von Zahlungen.
## Bitten Sie Runner, vom Chat aus zu helfen
**Zugriffspfad:** Projekt öffnen → **Neue Aufgabe** oder eine bestehende Unterhaltung auswählen.
Sie können Runner bitten, genehmigte Store-Datensätze zu inspizieren oder zu aktualisieren, ohne jede Admin-Seite selbst zu finden. Dies umfasst häufige Arbeiten mit Produkten und Varianten, Kunden, Bestand, Versand, Erfüllung, Bestellungen, Rückgaben, Promotionen und verwandten Datensätzen.
1. Nennen Sie den Datensatz und das genaue Ergebnis, das Sie möchten.
2. Bitten Sie Runner, den aktuellen Status zuerst zu inspizieren, wenn die Änderung von einem Bestellungs-, Bestands- oder Erfüllungsstatus abhängt.
3. Autorisieren Sie explizit die genaue Auswirkung vor einer destruktiven oder Bestellungs-Lebenszyklusaktion. Eine allgemeine Anfrage ist keine Berechtigung zum Löschen eines Datensatzes, Abbrechen einer Bestellung oder Vorantreiben der Erfüllung.
4. Warten Sie auf Runners Ergebnis, aktualisieren Sie dann die relevante Seite im Shop-Betrieb und überprüfen Sie den aktualisierten Status, bevor Sie erneut versuchen oder eine andere Änderung starten.
Kontenzugriff, Store-Systemeinstellungen, Zahlungen und Steuerverwaltung sind nicht über diese Chat-Funktion verfügbar. Produktimporte und andere Datei-Uploads verwenden weiterhin ihre dedizierten Flows.
## Wählen Sie den richtigen Abschnitt
| Abschnitt | Verwenden Sie ihn für | Was das Auswählen anzeigt |
| --- | --- | --- |
| **Allgemein** | Shop-Sichtbarkeit, Identität, Märkte, Lagerbestände und Versand- und Bewertungsverfügbarkeit | Öffnet die Seite mit gemeinsamen Einstellungen. Die meisten Felder verwenden die Seite **Speichern**; der Schalter **Produktbewertungen** speichert sofort. |
| **Bestellungen** | Kundenkäufe und Erfüllungsfortschritt | Öffnet die Bestellungsliste; das Auswählen einer Zeile öffnet den vollständigen Bestellungsdatensatz. |
| **Produkte** | Katalogartikel, Preise, Bilder, Varianten, Bestand und SEO | Öffnet die Produktliste; **Hinzufügen** startet ein neues Produkt und eine Zeile öffnet die Bearbeitung. |
| **Kunden** | Kundenkontaktdetails, Adressen und Bestellverlauf | Öffnet die Kundenliste; das Auswählen einer Zeile öffnet den Kundendatensatz. |
| **Promotionen** | Automatische Rabatte und Promotionscodes | Öffnet die Promotionsliste. Verwenden Sie **Erstellen** oder **Erste Promotion hinzufügen** in einer leeren Liste, um einen Rabatttyp auszuwählen. |
| **Dropshipping** (Projektnavigation) | Bedingt verfügbarer Lieferantenkatalog | Öffnen Sie den separaten Projekteintrag; ältere Ansichten können ihn unter Shop-Betrieb anzeigen. |
| **Print-on-Demand** (Projektnavigation) | Bedingt verfügbare, individuell bedruckte Produkte, die Printful abwickelt | Öffnen Sie den separaten Projekteintrag. Siehe [Print-on-Demand mit Printful](/de/guides/store-operations/print-on-demand). |
| **Bewertungen** | Bedingte Bewertungsmoderator | Erscheint, nachdem Produktbewertungen aktiviert und vom Shop unterstützt werden. |
**Allgemein in diesem Bereich** verwaltet Betriebsdaten wie Märkte, Lagerstandorte und Versand. [Shop-Allgemein in den Einstellungen](/de/guides/account-and-settings/store-general) verwaltet dagegen den Runner-Namen, die Suchvorschau, das Favicon und das Wasserzeichen. Prüfen Sie vor Änderungen, welche Allgemein-Seite Sie geöffnet haben.
Die Aufzeichnung wechselt im Tutorial-Shop zwischen Bestellungen, Kunden und Bewertungen. Sie zeigt leere Ansichten und Navigation; es erfolgen weder Kauf noch Kundenerstellung, Erstattung oder Auftragsabwicklung.
## Empfohlene Einrichtungsreihenfolge
1. Schließen Sie [Onboarding und allgemeine Einstellungen](/de/guides/store-operations/onboarding-and-general-settings) ab.
2. Fügen Sie einen Lagerbestand hinzu und konfigurieren Sie [Versand](/de/guides/store-operations/shipping).
3. Erstellen Sie [Produkte](/de/guides/store-operations/products) und überprüfen Sie [Varianten und Bestand](/de/guides/store-operations/inventory-and-variants).
4. Verbinden Sie einen Zahlungsdienst von **Apps**, bevor Sie den Checkout testen.
5. Verwenden Sie [Bestellungen](/de/guides/store-operations/orders), [Kunden](/de/guides/store-operations/customers) und [Promotionen](/de/guides/store-operations/promotions), wenn die Aktivität beginnt.
6. Verwenden Sie [Dropshipping](/de/guides/store-operations/dropshipping), [Print-on-Demand](/de/guides/store-operations/print-on-demand) oder [Bewertungen](/de/guides/store-operations/reviews-and-advanced-admin) nur, wenn diese Einträge und Voraussetzungen verfügbar sind.
## Häufige Zustände und Grenzen
- **Noch keine Daten** ist ein gültiger Zustand. Produkte, Bestellungen, Kunden, Promotionen und Bewertungen zeigen eine leere Nachricht, bis Datensätze vorhanden sind.
- **Laden ist kein Erfolg.** Warten Sie auf eine Liste, gespeicherte Bestätigung oder aktualisierten Status, bevor Sie davon ausgehen, dass eine Aktion abgeschlossen ist.
- **Ungespeicherte Änderungen bleiben auf der Seite.** Verwenden Sie **Speichern**, wo angezeigt; wenn Runner vor dem Verlassen warnt, wählen Sie, ob Sie bleiben, speichern oder ohne Speichern beenden möchten.
- **Destruktive Aktionen erfordern Bestätigung.** Das Löschen eines Produkts, Kunden oder einer Promotion kann nicht als wiederherstellbar angenommen werden.
- **Chat-Ergebnisse müssen noch überprüft werden.** Nachdem Runner einen Store-Datensatz geändert hat, aktualisieren Sie die relevante Seite und bestätigen Sie den neuen Status, bevor Sie erneut versuchen.
- **Bedingte Einträge können fehlen.** Verwenden Sie keine kopierte URL als Beweis, dass Ihr Shop eine versteckte Funktion unterstützt.
## Wenn der Shop-Betrieb nicht geladen wird
1. Bestätigen Sie, dass Sie das beabsichtigte Projekt geöffnet haben.
2. Warten Sie, bis die Bereitstellungsmeldung verschwindet, dann aktualisieren Sie die Seite.
3. Kehren Sie zum Projekt zurück und wählen Sie **Shop-Betrieb** erneut.
4. Wenn nur ein Abschnitt fehlschlägt, versuchen Sie sein **Aktualisieren**-Steuerelement, wenn verfügbar.
5. Wenn das Problem weiterhin besteht, behalten Sie den Projektnamen, Abschnittsnamen, sichtbaren Fehler und ungefähre Zeit für Support.
## Verwandte Anleitungen
- [Willkommen bei Runner AI](/de/guides/product-guide)
- [Allgemeine Einstellungen und Onboarding](/de/guides/store-operations/onboarding-and-general-settings)
- [Produkte](/de/guides/store-operations/products)
- [Bestellungen](/de/guides/store-operations/orders)
---
# Kunden
Source: https://www.runnerai.com/docs/de/guides/store-operations/customers
Verwenden Sie Kunden, um Käuferdatensätze genau zu halten und die Bestellungen zu verstehen, die mit jeder Person verbunden sind.
## Warum und wann Kunden verwenden
Öffnen Sie diesen Bereich, wenn Sie einen Käufer finden, einen Kundendatensatz hinzufügen, Kontakt- oder Versandinformationen korrigieren oder den Bestellverlauf der Person überprüfen müssen.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Ein Kunde kann nach dem Checkout angezeigt werden oder manuell hinzugefügt werden.
- Die Liste kennzeichnet Datensätze als **Gast** oder **Registriert**, wenn diese Kontoinformationen verfügbar sind.
- Ein gespeicherter Lagerort kann von adressbezogenen Store-Workflows erforderlich sein, ist aber keine Behauptung, dass eine Kundenadresse ein Lagerhaus ist.
- Verwenden Sie Kundendaten nur für den Zweck und den Zugriff, der von Ihrer Organisation zulässig ist.
## Öffnen Sie Kunden
**Einstiegspfad:** **Arbeitsbereich → einen Store auswählen → Shop-Betrieb → Kunden**
Wählen Sie eine Kundenzeile, um das Profil, verfügbare Aktivitäts- und Verlaufsdetails sowie Bestellungen zu öffnen. **Bearbeiten** zeigt das Formular Allgemein; während der Bearbeitung ist Bestellungen ausgeblendet.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4cFKBjWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Eine leere Liste ist normal, solange noch keine Kunden vorhanden sind. Für dieses Beispiel wurde kein Kundendatensatz erstellt.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was nach der Auswahl geschieht |
| --- | --- | --- |
| **Kunden suchen...** | Einen Kunden nach bekannten Details finden | Filtert die Kundenliste nach einer kurzen Verzögerung. |
| **Aktualisieren** | Aktuelle Kundendaten anfordern | Lädt die Liste und zugehörige Standortdaten neu. |
| **Erstellen** / **Kunde hinzufügen** | Einen Kunden manuell hinzufügen | Öffnet den Dialog zur Kundenerstellung. |
| **Erstellen** im Dialog | Den neuen Kunden speichern | Erstellt einen gültigen Datensatz und öffnet seine Detailseite nach erfolgreicher Ausführung. |
| Kundenzeile | Einen Kunden überprüfen | Öffnet Kontaktdaten, Versandadresse, Kontotyp und Bestellverlauf. |
| **Bearbeiten** | Kundendaten korrigieren | Öffnet Allgemein mit Namen, schreibgeschützter E-Mail-Adresse, Unternehmen, Telefon und Lieferadresse. Bestellungen ist während der Bearbeitung ausgeblendet. |
| Abschnitt **Bestellungen** | Käufe des Kunden prüfen | Zeigt verknüpfte Bestellungen oder **Noch keine Bestellungen** in der schreibgeschützten Detailansicht. |
| **Speichern** | Änderungen anwenden, ohne zu gehen | Speichert gültige Änderungen und hält die Detailseite offen. |
| Zurück oder Schließen mit ungespeicherten Änderungen | Entscheiden Sie, was mit Änderungen zu tun ist | Öffnet einen Dialog **Ungespeicherte Änderungen** mit **Speichern und beenden** und **Beenden ohne zu speichern**. |
| **Speichern und beenden** | Änderungen anwenden und zurückgeben | Speichert aus dem Dialog für ungespeicherte Änderungen gültige Änderungen und kehrt zur Kundenliste zurück. |
| **Beenden ohne zu speichern** | Änderungen nach einer Warnung verwerfen | Verlässt die Detailseite, ohne ungespeicherte Änderungen anzuwenden. |
| Desktop-Liste Löschen-Symbol / **Löschen** | Einen Kundendatensatz entfernen | Öffnet eine Bestätigung; das Bestätigen kann nicht rückgängig gemacht werden. Die aktuelle mobile Liste zeigt diese Aktion nicht. |
Ein manuell erstellter Kunde wird in **Alle abonnierten Kunden** aufgenommen. Fügen Sie nur einen echten Datensatz hinzu, den Sie verwalten dürfen. Erstellen Sie keine Empfänger, nur um das Formular auszuprobieren. Leere Aktivitäts- oder Verlaufsbereiche bedeuten, dass für diesen Kunden keine Ereignisse vorliegen, nicht dass das Profil nicht gespeichert wurde.
Die leere Liste kann **0 Kunden** anzeigen. Sobald Kunden vorhanden sind, nutzen Sie Suche, Sortierung und Tag-Filter, um Datensätze zu finden. Entfernen Sie Filter, bevor Sie davon ausgehen, dass ein Kunde fehlt.
Das leere Formular zeigt die erforderliche E-Mail-Adresse und verfügbare optionale Felder. **Erstellen** bleibt deaktiviert, bis die Pflichtangaben vorliegen; es wurde kein Datensatz gespeichert.
## Fügen Sie einen Kunden hinzu
1. Wählen Sie **Erstellen** oder **Kunde hinzufügen**.
2. Geben Sie die erforderliche **E-Mail** ein. Ergänzen Sie Vor- und Nachnamen, falls bekannt. Tragen Sie optionale Tags, Adresse, Unternehmen, Telefon, benutzerdefinierte Felder und Erinnerungen nur ein, wenn relevante Informationen vorliegen.
3. Überprüfen Sie die Werte auf Rechtschreibung und den beabsichtigten Kunden.
4. Wählen Sie **Erstellen** einmal aus.
5. Wählen Sie im geöffneten Datensatz **Bearbeiten**, bevor Sie optionale Unternehmens-, Telefon- oder Lieferadressdaten ergänzen.
6. Wählen Sie **Speichern**, kehren Sie dann zur Liste zurück und bestätigen Sie, dass die neue Zeile angezeigt wird. Wenn Sie stattdessen mit ungespeicherten Änderungen gehen, wählen Sie **Speichern und beenden** in der Warnung.
7. Ein gültiger neuer Kunde wird automatisch in **Alle abonnierten Kunden** aufgenommen.
## Aktualisieren Sie einen Kunden
1. Suchen Sie den Kunden und wählen Sie ihn aus.
2. Wählen Sie **Bearbeiten**. Prüfen Sie im Formular **Allgemein** Vorname, Nachname, die schreibgeschützte E-Mail-Adresse, Unternehmen, Telefon und Lieferadresse.
3. Verwenden Sie **Hinzufügen**, um die Adressinformationen hinzuzufügen, die Runner anfordert, oder **Löschen**, um die aktuellen bearbeitbaren Adresswerte zu entfernen.
4. Wählen Sie **Speichern**, um im Datensatz zu bleiben. Um zu speichern und zu gehen, verwenden Sie die Zurück- oder Schließsteuerung und wählen Sie **Speichern und beenden** in der Warnung.
5. Verlassen Sie nach dem Speichern den Bearbeitungsmodus und prüfen Sie unter **Bestellungen** die verknüpften Käufe.
## Zustände und Limits
- **Gast** bedeutet, dass der Datensatz nicht als registriertes Kundenkonto angezeigt wird; er kann immer noch Bestellungen haben.
- Ein Gast, der an der Kasse bestellt oder bucht, wird nicht in **Alle abonnierten Kunden** aufgenommen. Er wird nur über das Newsletter-Formular des Shops oder mit einem Kundenkonto aufgenommen.
- **Registriert** identifiziert einen kontounterstützten Kundendatensatz.
- **Noch keine Kunden** und **Noch keine Bestellungen** sind gültige leere Zustände.
- Die Suche filtert nur das aktuelle Projekt.
- Kundenaktualisierungen ändern nicht die historischen Bestellsummen oder Zahlungszustände.
- Das erneute Erstellen eines Kunden überschreibt weder eine frühere Abmeldung noch die Unterdrückung dieser Adresse durch einen E-Mail-Anbieter.
- Löschen ist explizit irreversibel und derzeit nur in der Desktop-Liste verfügbar. Bestätigen Sie die angezeigte E-Mail, bevor Sie fortfahren, und behalten Sie Daten nur gemäß der Richtlinie Ihrer Organisation.
## Fehlerbehebung
- **Keine Kunden gefunden:** Löschen oder verkürzen Sie die Suche und überprüfen Sie, ob Sie das richtige Projekt geöffnet haben.
- **Speichern fehlgeschlagen:** Füllen Sie erforderliche Felder aus, korrigieren Sie die E-Mail oder Adresse und versuchen Sie es erneut.
- **Sie können den Datensatz nicht verlassen:** Wählen Sie **Speichern und beenden** oder antworten Sie auf den Dialog "Ungespeicherte Änderungen" mit **Beenden ohne zu speichern**.
- **Bestellungen fehlen:** Bestätigen Sie, dass die Bestellung denselben Kundendatensatz oder die E-Mail verwendet hat, und aktualisieren Sie sowohl Kunden als auch Bestellungen.
- **Kundendetails können nicht geladen werden:** Kehren Sie zur Liste zurück, wählen Sie **Aktualisieren** und öffnen Sie die Zeile erneut.
## Verwandte Leitfäden
- [Bestellungen](./orders)
- [Promotionen](./promotions)
- [Onboarding und allgemeine Einstellungen](./onboarding-and-general-settings)
- [Übersicht über den Shop-Betrieb](/de/guides/store-operations)
---
# Digitale Produkte verkaufen
Source: https://www.runnerai.com/docs/de/guides/store-operations/digital-products
Mit digitalen Produkten verkaufen Sie Dateien wie E-Books, PDF-Leitfäden, Vorlagen und andere Downloads. Es wird nichts versendet. Nachdem ein Käufer bezahlt hat, schickt Runner ihm per E-Mail einen privaten Link zu einer Lieferseite in Ihrem Shop. Dort lädt er die Dateien innerhalb der von Ihnen festgelegten Grenzen herunter.
## So funktioniert es
1. **Digitales Produkt anlegen.** Wählen Sie **Digital** als Produkttyp. Digitale Produkte haben keinen Versand und keinen Bestand.
2. **Leistungen hinzufügen.** Eine Leistung ist das, was der Käufer erhält, zum Beispiel eine Gruppe von Dateien. Leistungen lassen sich für alle Produkte Ihres Shops wiederverwenden.
3. **Liefer-E-Mail schreiben.** Runner sendet sie, sobald die Zahlung erfasst ist.
4. **Veröffentlichen.** Runner prüft, dass jede Leistung eine fertige Datei hat und die Shop-E-Mail eingeschaltet ist.
5. **Lieferungen in der Bestellung verwalten.** Senden Sie die E-Mail erneut, entziehen oder gewähren Sie den Zugriff wieder und entscheiden Sie, was nach einer Erstattung mit dem Zugriff geschieht.
### Ansehen: ein digitales Produkt von Anfang bis Ende verkaufen
Die Aufnahme erstellt ein **Digital**-Produkt und fügt je eine Leistung jedes Typs hinzu: **Datei-Downloads**, **Einmalcodes oder -links**, **Geteilter Einladungslink** und **Notiz**. Sie schreibt die **Liefer-E-Mail**, setzt das Produkt auf **Veröffentlicht** und speichert. Danach kauft ein Käufer das Produkt mit einer Karte, sieht den Kauf auf der Bestellseite, öffnet die Liefer-E-Mail, lädt eine Datei herunter, zeigt einen Code an und wählt **Neuen Link per E-Mail senden**. Zurück unter **Bestellungen** zeigt die Karte **Digitale Lieferung** der Bestellung jede Leistung, und die Aufnahme verwendet **Erneut senden**, **Entziehen** und **Wieder gewähren**. Zum Schluss erstattet sie eine zweite Bestellung mit **Zugriff des Käufers entziehen**. Die Kartendaten werden außerhalb der Aufnahme eingegeben. Oberfläche, Untertitel und Sprecherstimme der Aufnahme sind englisch.
## Bevor Sie beginnen
**Zugriffspfad:** **Arbeitsbereich → Shop auswählen → Shop-Betrieb → Produkte**
Wenn **Digital** in der Liste **Produkttyp** fehlt, sind digitale Produkte für Ihr Konto noch nicht aktiviert. Wenden Sie sich an den [Runner-Support](/de/guides/help-and-reference/support-and-community), um Zugriff anzufragen. Wenn das Produktformular **Ihr Shop braucht ein Update, bevor er digitale Produkte verkaufen kann.** anzeigt, läuft Ihr Shop mit einer älteren Version; wenden Sie sich an den Support, um ihn zu aktualisieren.
Sie benötigen:
- einen veröffentlichten Shop, denn Käufer öffnen ihren Kauf in Ihrem Shop;
- die eingeschaltete Shop-E-Mail unter **Projekt → Apps → Shop betreiben → E-Mail**, solange die Liefer-E-Mail aktiv ist (siehe [Shop-E-Mail aktivieren](/de/guides/apps-and-integrations/resend-email)); und
- einen Zahlungsanbieter, damit Käufer bezahlen können. Siehe [Stripe-Zahlungen](/de/guides/apps-and-integrations/stripe-payments).
## 1. Digitales Produkt anlegen
1. Öffnen Sie **Shop-Betrieb → Produkte** und wählen Sie **Hinzufügen**.
2. Wählen Sie unter **Produkttyp** die Option **Digital**.
3. Geben Sie Name, Beschreibung, Bilder und Preis wie bei jedem anderen Produkt ein.
Ein digitales Produkt hat keinen Versandbereich, und sein Bestand wird nicht geführt: Die Produktliste zeigt **-** unter **Bestand**. Wer nur digitale Produkte kauft, durchläuft den Checkout ohne Versandschritt.
## 2. Leistungen hinzufügen
Der Bereich **Leistungen** listet, was Käufer erhalten. Käufer bekommen jede Leistung auf der Liste.
### Leistung erstellen
1. Wählen Sie **Leistung erstellen**.
2. Geben Sie einen **Name** ein, zum Beispiel „Dateien zum Leitfaden“. Käufer sehen ihn auf der Lieferseite und in der E-Mail.
3. Legen Sie Dateien auf **Dateien hier ablegen** ab oder wählen Sie **Dateien auswählen**. Eine Leistung fasst bis zu 20 Dateien mit je bis zu 5 GB. Die Dateien bleiben privat: Käufer laden sie nur über ihren Link herunter.
4. Wählen Sie unter **Zugriffsregeln**:
- **Downloads begrenzen** und die Anzahl **Downloads pro Artikel**. Ein fehlgeschlagener Download kann innerhalb von 15 Minuten wiederholt werden, ohne einen weiteren Download zu verbrauchen.
- **Link läuft ab** und wie lange der **Link gilt für**, in Stunden oder Tagen. Bei erneutem Senden erhält der Käufer einen neuen Link.
5. Wählen Sie **Erstellen**, um das Hochladen der Dateien zu starten. Lassen Sie das Dialogfenster geöffnet, bis die Uploads fertig sind und die Leistung in der Liste **Leistungen** des Produkts erscheint.
Um eine bereits erstellte Leistung wiederzuverwenden, wählen Sie **Vorhandene Leistung hinzufügen**. Ziehen Sie Leistungen oder verwenden Sie **Nach oben** und **Nach unten**, um die Reihenfolge festzulegen, die Käufer sehen. Ein digitales Produkt behält mindestens eine Leistung.
### Leistungstyp wählen
Wählen Sie beim Erstellen einer Leistung ihren **Typ**. Sie können ihn später nicht ändern.
| Typ | Was Käufer erhalten |
| --- | --- |
| **Datei-Downloads** | Private Dateien, die Käufer auf ihrer Lieferseite herunterladen. |
| **Einmalcodes oder -links** | Jeder Käufer erhält einen anderen Code oder Link aus einer Liste, die Sie einfügen. Das Produkt ist ausverkauft, sobald die Liste leer ist. |
| **Geteilter Einladungslink** | Ein Link, den alle Käufer öffnen, etwa eine Einladung in eine Community. |
| **Notiz** | Text, den Käufer nach dem Kauf sehen, oder eine verborgene Markierung für Bestellungen, die Sie selbst erfüllen. |
Zeigt **Typ** nur **Datei-Downloads**, läuft Ihr Shop mit einer älteren Version; wenden Sie sich an den [Runner-Support](/de/guides/help-and-reference/support-and-community), um ihn zu aktualisieren.
#### Einmalcodes oder -links
1. Fügen Sie unter **Codes oder Links hinzufügen** einen Code oder Link pro Zeile ein, bis zu 10.000 auf einmal. Doppelte Einträge werden übersprungen, und jeder Wert wird verschlüsselt gespeichert.
2. Die Leistung zeigt, wie viele Werte **Verkaufsbereit** und wie viele **Verkauft oder für Bestellungen reserviert** sind, und warnt Sie, wenn nur noch wenige übrig sind. Ist die Liste leer, wird das Produkt als ausverkauft angezeigt und der Checkout lehnt es ab.
3. Jede bezahlte Einheit erhält ihren eigenen Wert, den der Käufer auf seiner Lieferseite aufdeckt.
4. Um einen Wert zurückzunehmen, den noch niemand gekauft hat, entfernen Sie ihn unter **Ungenutzte Werte**.
In der Bestellung zeigt die Karte **Digitale Lieferung** das Ende jedes Werts und ob der Käufer ihn aufgedeckt hat. Wählen Sie **Anzeigen**, um den ganzen Wert zu sehen, oder **Kopieren**, um ihn zu kopieren.
#### Geteilter Einladungslink
Geben Sie den **Einladungslink** ein, beginnend mit https:// oder http://. Alle Käufer erhalten denselben Link. Legen Sie seinen Ablauf deshalb dort fest, wo der Link verwaltet wird, etwa in den Einstellungen Ihrer Community. Die Bestellkarte zeigt, ob der Käufer ihn geöffnet hat.
#### Notiz
Schreiben Sie die Notiz unter **Private Notiz** und wählen Sie ihre **Sichtbarkeit**:
- **Sichtbar**: Käufer sehen sie nach dem Kauf, auf der Bestellbestätigung und auf ihrer Lieferseite.
- **Verborgen**: wird beim Kauf gewährt, aber dem Käufer nie angezeigt, zum Beispiel um Bestellungen zu markieren, die Sie selbst erfüllen.
Ein veröffentlichtes Produkt behält mindestens eine Leistung, die Käufer sehen. Deshalb können Sie seine einzige sichtbare Notiz nicht verbergen. Eine Notiz, die die Liefer-E-Mail eines Produkts nennt, können Sie ebenfalls nicht verbergen: Entfernen Sie sie zuerst aus der E-Mail. Verborgene Notizen haben keine E-Mail-Variablen.
### Leistung pausieren
Schalten Sie den Schalter neben einer Leistung aus, um sie für alle Käufer aller Produkte zu pausieren, die sie verwenden. Käufer können sie erst wieder herunterladen, wenn Sie sie einschalten. Neue Käufe warten, und ihre E-Mail wird verschickt, sobald Sie die Leistung wieder einschalten.
### Dateien später ändern
Sie können einer Leistung jederzeit Dateien hinzufügen; bestehende Käufer sehen sie auf ihrer Lieferseite. Wenn Sie eine Datei entfernen, verschwindet sie für alle Käufer. Eine Leistung, die Produkte verkaufen, behält mindestens eine Datei: Fügen Sie zuerst eine weitere Datei hinzu oder entfernen Sie die Leistung aus diesen Produkten.
## 3. Liefer-E-Mail schreiben
Der Bereich **Liefer-E-Mail** steuert die Nachricht, die Käufer erhalten, sobald die Zahlung erfasst ist.
| Einstellung | Wirkung |
| --- | --- |
| **Liefer-E-Mail senden** | Schalten Sie sie aus, um nur auf der Bestellbestätigungsseite zu liefern. Käufer erreichen ihren Kauf dann 24 Stunden lang dort, und das erneute Anfordern durch Kunden ist ausgeschaltet. |
| **Absender** | Der Absendername, den Käufer sehen. Die E-Mail kommt von Runners Adresse, und Antworten gehen an die Kontakt-E-Mail Ihres Shops. |
| **Betreff** und **Nachricht** | Fügen Sie mit **Variable einfügen** Bestellnummer, Bestelldatum, Produktname, bezahlten Betrag, Name oder E-Mail des Käufers, Ihren Shopnamen und **Alle Leistungen** ein, das die Liste der Leistungen ausgibt. Link, Ablauf und Downloads gehören zu einer einzelnen Leistung und stehen daher unter jeder Leistung. |
| **Logo-URL** und **Akzentfarbe** | Jede Liefer-E-Mail hat dasselbe Design. Mit einer **Logo-URL** steht Ihr Logo oben in der E-Mail, und die Akzentfarbe hebt den Namen und die Schaltfläche jeder Leistung hervor. Lassen Sie **Logo-URL** leer, um die E-Mail ohne Logo zu senden. |
Wählen Sie **Vorschau**, um die E-Mail für eine Beispielbestellung zu sehen. Der Editor lehnt unbekannte Variablen ab.
Unter **Erweiterte Einstellungen**:
- **Kunden können die E-Mail erneut anfordern** erlaubt Käufern, sie auf ihrer Lieferseite bis zu 3-mal am Tag an die E-Mail-Adresse der Bestellung erneut anzufordern.
- **Bei einem vorübergehenden Bounce automatisch erneut senden** wiederholt den Versand einmal nach 30 Minuten mit demselben Link.
## 4. Veröffentlichen
Setzen Sie **Status** auf **Veröffentlicht** und speichern Sie. Wenn etwas fehlt, speichert Runner das Produkt als Entwurf und zeigt **Dieses Produkt kann noch nicht veröffentlicht werden** mit dem, was zu tun ist:
| Meldung | Was zu tun ist |
| --- | --- |
| **Fügen Sie mindestens eine Leistung hinzu.** | Fügen Sie im Bereich **Leistungen** eine Leistung hinzu. |
| **Füge** einer Leistung **eine Datei hinzu.** | Laden Sie mindestens eine Datei zu dieser Leistung hoch. |
| **Warte, bis** eine Leistung **fertig hochgeladen ist.** | Lassen Sie die Seite geöffnet, bis jede Datei **Bereit** anzeigt. |
| **Schalten Sie die App „E-Mail“ unter Apps ein oder die Liefer-E-Mail dieses Produkts aus.** | Schalten Sie **E-Mail** unter **Projekt → Apps → Shop betreiben** ein oder schalten Sie **Liefer-E-Mail senden** aus. |
| **Ihr Shop braucht ein Update, bevor er digitale Produkte verkaufen kann.** | Wenden Sie sich an den [Runner-Support](/de/guides/help-and-reference/support-and-community). |
## Was Käufer erhalten
1. Der Käufer schließt den Checkout ab. Ein Warenkorb mit ausschließlich digitalen Produkten hat keinen Versandschritt.
2. Sobald die Zahlung erfasst ist, schickt Runner dem Käufer per E-Mail einen Link zu seiner Lieferseite in Ihrem Shop. Auch die Bestellbestätigungsseite zeigt den Kauf 24 Stunden lang.
3. Auf der Lieferseite lädt der Käufer jede Datei herunter. Jeder Download zählt zum Limit, und der Link funktioniert nicht mehr, wenn er abläuft oder Sie einen neueren senden.
4. Wenn Sie es erlauben, kann der Käufer die E-Mail auf der Lieferseite erneut anfordern.
## Lieferungen in einer Bestellung verwalten
Unter **Shop-Betrieb → Bestellungen** zeigt die Spalte **Auftragsabwicklung** für jede digitale Bestellung ihren Lieferstatus, mit den Status aus der Tabelle unten. Hat eine Bestellung mehrere Leistungen, zeigt die Spalte den Status, der zuerst Ihre Aufmerksamkeit braucht: **Fehlgeschlagen**, dann einen noch nicht zugestellten Status (**Ausstehend**, **Wird gesendet** oder **Link bereit**), dann **Zugestellt**. **Downloads aufgebraucht**, **Abgelaufen** und **Entzogen** erscheinen nur, wenn jede Leistung beendet ist. Bis die Zahlung erfasst ist, zeigt eine Bestellung **Kein Versand**.
Öffnen Sie **Shop-Betrieb → Bestellungen** und wählen Sie eine Bestellung. Die Karte **Digitale Lieferung** zeigt jede Leistung mit ihrem Status, **Genutzte Downloads**, **Link läuft ab** und **Letzte Aktivität**.
| Status | Bedeutung |
| --- | --- |
| **Ausstehend** | Die Lieferung wartet, zum Beispiel solange die Leistung pausiert ist. |
| **Link bereit** | Der Link existiert. Die E-Mail steht in der Warteschlange, oder die Liefer-E-Mail ist ausgeschaltet. |
| **Wird gesendet** | Die E-Mail ist unterwegs. |
| **Zugestellt** | Die E-Mail hat den Käufer erreicht. |
| **Fehlgeschlagen** | Die Lieferung wurde angehalten. Die Karte nennt den Grund, zum Beispiel **Shop-E-Mail ist ausgeschaltet** oder **Der Shop ist nicht veröffentlicht**. |
| **Downloads aufgebraucht** | Der Käufer hat alle Downloads genutzt. Erneutes Senden stellt sie wieder her. |
| **Abgelaufen** | Der Link ist abgelaufen. Erneutes Senden liefert einen neuen Link. |
| **Entzogen** | Sie haben den Zugriff entzogen. |
Verwenden Sie die Aktionen auf der Karte:
- **Erneut senden** schickt einen neuen Link, auf Wunsch an eine korrigierte Adresse. Frühere Links funktionieren nicht mehr, und aufgebrauchte Downloads werden wiederhergestellt.
- **Entziehen** stoppt neue Downloads für eine Leistung oder die ganze Bestellung. Ein Download-Link, der in der letzten Minute ausgegeben wurde, kann noch abgeschlossen werden.
- **Wieder gewähren** stellt einen entzogenen Zugriff mit einem neuen Download-Kontingent wieder her und schickt einen neuen Link.
**Lieferverlauf** listet jede E-Mail mit ihrem Ergebnis, und **Verlauf** listet jedes Ereignis, zum Beispiel **E-Mail geöffnet**, **Lieferseite geöffnet** und **Heruntergeladen**. Wählen Sie **CSV exportieren**, um den Verlauf herunterzuladen.
Um Bestellungen zu finden, die Ihre Aufmerksamkeit brauchen, schalten Sie in der Bestellliste den Filter **Braucht Aufmerksamkeit** ein. Er zeigt fehlgeschlagene Lieferungen und Erstattungen ohne Zugriffsentscheidung.
### Erstattungen
Wenn Sie eine Bestellung mit digitalen Artikeln erstatten, wählen Sie im Erstattungsdialog **Zugriff des Käufers behalten** oder **Zugriff des Käufers entziehen**. Eine anderswo vorgenommene Erstattung, zum Beispiel im Dashboard Ihres Zahlungsanbieters, zeigt auf der Karte, dass der Betrag erstattet wurde und der Zugriff noch aktiv ist, mit **Zugriff behalten** und **Zugriff entziehen**, damit Sie später entscheiden können.
## Digitales Produkt im Chat anlegen
Sie können Runner auch im Chat beauftragen. Hängen Sie die Dateien an Ihre Nachricht an und beschreiben Sie das Produkt, zum Beispiel „Verkaufe dieses PDF als E-Book für 12 €“. Runner legt einen Produktentwurf mit einer Leistung für die Dateien an und entwirft die Liefer-E-Mail. Runner hält dort an, wo nur Sie handeln können, zum Beispiel wenn die Shop-E-Mail ausgeschaltet ist. Prüfen Sie den Entwurf unter **Produkte**, bevor Sie veröffentlichen.
Im Chat angehängte Dateien sind auf das begrenzt, was der Chat annimmt: Dokumente bis 10 MB und Bilder bis 32 MB. Laden Sie größere Dateien im Produktformular hoch.
## Fehlerbehebung
| Problem | Was zu tun ist |
| --- | --- |
| Die Karte zeigt **Fehlgeschlagen** mit **Shop-E-Mail ist ausgeschaltet** | Schalten Sie **E-Mail** unter **Projekt → Apps → Shop betreiben** ein und wählen Sie dann **Erneut senden**. |
| Die Karte zeigt **Fehlgeschlagen** mit **Der Shop ist nicht veröffentlicht** | Veröffentlichen Sie Ihren Shop und wählen Sie dann **Erneut senden**. |
| Die E-Mail ist **Unzustellbar** | Prüfen Sie die Adresse mit dem Käufer, wählen Sie dann **Erneut senden** und geben Sie die korrigierte Adresse ein. |
| **Beim Bezahlen der Bestellung war keine Datei bereit.** | Laden Sie eine Datei zur Leistung hoch und wählen Sie dann **Erneut senden**. |
| **Die Leistung ist pausiert.** | Schalten Sie die Leistung wieder ein. Die wartende E-Mail wird verschickt. |
---
# Dropshipping
Source: https://www.runnerai.com/docs/de/guides/store-operations/dropshipping
Mit Dropshipping verkaufen Sie Lieferantenprodukte, ohne selbst Ware auf Lager zu halten: Wenn ein Kunde kauft, sendet Runner die Bestellung an Ihren Lieferanten. Sie bestätigen und bezahlen sie in Ihrem Lieferantenkonto, damit der Lieferant sie an Ihren Kunden versendet.
**Zugriffspfad:** **Arbeitsbereich → Shop auswählen → Dropshipping**
In älteren Ansichten kann Dropshipping unter **Shop-Betrieb** liegen. Nutzen Sie den Eintrag, den Ihr Projekt anzeigt.
## So funktioniert Dropshipping
| Phase | Was Sie tun | Was Runner tut |
| --- | --- | --- |
| [1. Verbinden](#1-lieferanten-verbinden) | Verbinden Sie Ihr eigenes Konto bei CJ Dropshipping oder AliExpress. | Nutzt dieses Konto, um zu suchen, zu importieren und Lieferantenbestellungen aufzugeben. |
| [2. Durchsuchen und auswählen](#2-produkt-durchsuchen-und-auswählen) | Wählen Sie ein Lieferziel, finden Sie ein Produkt und vergleichen Sie Varianten, Bestand und Lieferschätzungen. | Lädt aktuelle Lieferantendaten für Ihr verbundenes Konto. |
| [3. Prüfen und veröffentlichen](#3-produkt-prüfen-und-veröffentlichen) | Wählen Sie einen Zielmarkt, legen Sie Preise fest, wählen Sie Varianten aus und fügen Sie das Produkt hinzu. | Erstellt das Produkt und veröffentlicht es in diesem Markt. |
| [4. Bestellungen abwickeln](#4-bestellungen-abwickeln) | **Bezahlen Sie jede Lieferantenbestellung in Ihrem Lieferantenkonto** und erfassen Sie danach den Versand in der Shop-Bestellung. | Erstellt die Lieferantenbestellung nach dem Checkout automatisch und zeigt Status und Sendungsverfolgung an. |
Wenn Sie einen Lieferanten nicht mehr nutzen oder das Lieferantenkonto wechseln möchten, lesen Sie [Lieferanten trennen](#lieferanten-trennen). Das ist eine eigene Aufgabe mit eigenen Prüfungen und gehört nicht zum täglichen Ablauf.
:::warning
Runner gibt Lieferantenbestellungen für Sie auf, **bezahlt den Lieferanten aber nicht**. Eine Lieferantenbestellung bleibt unbezahlt und wird nicht versendet, bis Sie sie in Ihrem CJ- oder AliExpress-Konto bestätigen und bezahlen.
:::
## Bevor Sie beginnen
- **Ihr eigenes Lieferantenkonto.** Verwenden Sie ein CJ-Dropshipping-Konto oder ein AliExpress-Käuferkonto, mit dem Sie Bestellungen bezahlen können. Sie bezahlen den Lieferanten für jede Bestellung getrennt von dem Betrag, den Ihr Kunde Ihnen zahlt.
- **Rolle als Inhaber oder Administrator.** Nur ein Inhaber oder Administrator des Arbeitsbereichs kann einen Lieferanten verbinden oder trennen. Andere Mitglieder sehen **Nur Inhaber oder Admins des Workspace können diesen Lieferanten verbinden. Bitte sie darum.**
- **Ein Shop-Markt.** Die Lieferziele für Dropshipping ergeben sich aus Ihren Shop-Märkten. Ohne Markt zeigt die Seite **Fügen Sie einen Markt hinzu, um ein Lieferziel auszuwählen und Produkte zu durchsuchen.**
- **Ein Zahlungsdienst.** Kunden können erst kaufen, wenn unter **Apps** ein Zahlungsdienst verbunden ist.
Lieferantenverbindungen gehören zu Ihrer Organisation. Daher nutzt jeder Shop im Arbeitsbereich dieselben Verbindungen zu CJ und AliExpress. CJ und AliExpress werden getrennt verbunden; eine neue Verbindung ersetzt nie die andere.
## 1. Lieferanten verbinden
Die Vorschauauswahl **Im Trend**, **Günstige Auswahl** und **Unter 5 $** können Sie ohne Verbindung durchsehen. Für die Suche, aktuelle Produktdaten und das Hinzufügen von Produkten brauchen Sie einen verbundenen Lieferanten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Die englischen Markierungen zeigen die Bedienelemente. Wählen Sie das Bild aus, um es zu vergrößern.
| Steuerelement | Wofür Sie es verwenden | Was bei der Auswahl passiert |
| --- | --- | --- |
| **Lieferant verbinden** | Ihre erste Lieferantenverbindung starten. | Öffnet **Lieferanten verbinden und verwalten** mit getrennten Bereichen für CJ Dropshipping und AliExpress. |
| **Lieferanten verwalten** | Eine bestehende Verbindung prüfen, erneuern oder trennen. | Ersetzt **Lieferant verbinden**, sobald ein Lieferant verbunden ist, und öffnet denselben Dialog. |
| **So funktioniert es** | Die beiden Verbindungsmethoden vergleichen. | Erklärt, dass CJ einen API-Schlüssel verwendet und AliExpress die Anmeldung bei AliExpress. |
| **CJ API-Schlüssel** | Ihr CJ-Konto verbinden. | Nimmt den Schlüssel auf, den Sie bei CJ kopiert haben. Der Wert bleibt verborgen. |
| **CJ-Anleitung ansehen** | Ihren API-Schlüssel bei CJ finden. | Öffnet die CJ-Anleitung zum API-Schlüssel in einem neuen Tab. |
| **CJ Dropshipping verbinden** | Den Schlüssel absenden. | Runner prüft den Schlüssel bei CJ. Bei Erfolg schließt sich der Dialog und CJ wird als verbunden angezeigt. |
| **AliExpress verbinden** | Ihr AliExpress-Käuferkonto verbinden. | Leitet Sie zur Anmeldung bei AliExpress weiter und bringt Sie danach zurück zu Dropshipping. |
| **AliExpress erneut verbinden** | Den AliExpress-Zugriff vor oder nach dem Ablauf erneuern. | Wiederholt die Anmeldung bei AliExpress für das verbundene Konto. |
### CJ Dropshipping verbinden
1. Öffnen Sie **Dropshipping** und wählen Sie **Lieferant verbinden** (oder **Lieferanten verwalten**).
2. Öffnen Sie in Ihrem CJ-Dropshipping-Konto **Apps → API** und wählen Sie den Tab **API**. Kopieren Sie den Schlüssel vom Typ **API Key** aus der Spalte **API Key & MCP Token**. Falls Sie noch keinen haben, erstellen Sie ihn mit **Add API**. Wählen Sie in Runner **CJ-Anleitung ansehen**, wenn Sie die Schritte von CJ selbst brauchen.
3. Fügen Sie den Schlüssel in **CJ API-Schlüssel** ein und wählen Sie **CJ Dropshipping verbinden**.
4. Warten Sie, bis sich der Dialog schließt und CJ Dropshipping als verbunden angezeigt wird.
5. Suchen Sie nach einem Produkt, um zu prüfen, ob Ihr CJ-Katalog lädt.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw6oh1NIkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
Öffnen Sie bei CJ **Apps** (1) und **API** (2), wählen Sie den Tab **API** (3) und kopieren Sie den Schlüssel aus **API Key & MCP Token** (4). Wählen Sie das Bild aus, um es zu vergrößern. Halten Sie Ihren Schlüssel geheim; in diesem Beispiel sind die Schlüsselwerte verborgen.
Wenn Sie **CJ konnte nicht verbunden werden – prüfen Sie den API-Schlüssel und versuchen Sie es erneut.** sehen, kopieren Sie den Schlüssel erneut bei CJ und versuchen Sie es noch einmal. Diese Meldung bedeutet, dass CJ den Schlüssel abgelehnt hat. Wenn Sie **CJ hat nicht geantwortet. Versuchen Sie es gleich noch einmal.** sehen, hatte CJ beim Prüfen des Schlüssels ein Problem; versuchen Sie es kurz darauf erneut. Wenn Sie **CJ begrenzt gerade die Anfragen für dieses Konto. Warten Sie einige Minuten und versuchen Sie es dann erneut.** sehen, kann der Schlüssel trotzdem gültig sein: CJ begrenzt die Aufrufe Ihres CJ-Kontos, zum Beispiel weil eine andere App denselben Schlüssel nutzt. Warten Sie einige Minuten und versuchen Sie es dann erneut.
### AliExpress verbinden
1. Öffnen Sie **Dropshipping** und wählen Sie **Lieferant verbinden** (oder **Lieferanten verwalten**).
2. Wählen Sie **AliExpress verbinden**. Ihr Browser verlässt Runner und öffnet die Anmeldung bei AliExpress.
3. Melden Sie sich mit dem AliExpress-**Käuferkonto** an, mit dem Sie Lieferantenbestellungen bezahlen, und erlauben Sie den Zugriff.
4. Wenn AliExpress Sie zu Runner zurückleitet, achten Sie auf **AliExpress ist verbunden**. Wenn Sie von einer Suche oder einem Produkt aus gestartet sind, bringt Runner Sie stattdessen dorthin zurück.
Wenn Sie **Die AliExpress-Anmeldung konnte nicht geöffnet werden. Versuchen Sie es erneut.** sehen, starten Sie die Verbindung erneut über dasselbe Runner-Konto.
**Der AliExpress-Zugriff läuft ab.** AliExpress legt fest, wie lange der Zugriff gilt. Runner zeigt **Ihre AliExpress-Autorisierung läuft bald ab** und benachrichtigt Inhaber und Administratoren des Arbeitsbereichs 7 Tage und 1 Tag vor dem Ablauf per E-Mail. Wählen Sie **AliExpress erneut verbinden** und melden Sie sich mit **demselben** AliExpress-Konto an. Wenn der Zugriff abläuft, sind Suche, Import und neue AliExpress-Bestellungen nicht mehr möglich, bis Sie die Verbindung erneuern.
Die Aufzeichnung zeigt bestehende Verbindungen zu CJ und AliExpress und kehrt anschließend zum Katalog zurück. Dabei wird nichts verbunden, getrennt, gekauft oder importiert.
## 2. Produkt durchsuchen und auswählen
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgL9CDE0P6BaUgYNS457p8WDbAxIJ2kfdz9Vju)
Die englischen Markierungen zeigen die Bedienelemente. Wählen Sie das Bild aus, um es zu vergrößern.
| Steuerelement | Wofür Sie es verwenden | Was bei der Auswahl passiert |
| --- | --- | --- |
| **Im Trend**, **Günstige Auswahl**, **Unter 5 $** | Ideen ansehen, ohne zu suchen. | Öffnet eine Vorschauauswahl. Diese Auswahl garantiert weder Beliebtheit noch Marge oder Lieferzeit. |
| **Produkte suchen...** | Artikel per Suchbegriff finden. Bei AliExpress können Sie auch eine Produkt-ID oder einen Link einfügen. | Lädt Ergebnisse von Ihrem verbundenen Lieferanten. Ohne Verbindung öffnet sich der Verbindungsdialog. |
| **Versand nach** | Das Land wählen, in das Sie verkaufen. | Lädt Produkte neu, die dorthin versendet werden können. Nur Länder aus Ihren Shop-Märkten sind auswählbar; bei anderen erscheint **Hinzufügen**, damit Sie einen Markt anlegen können. |
| Lieferantenauswahl | Ergebnisse auf einen Lieferanten beschränken. | Zeigt je nach Verbindung **Alle Anbieter**, **CJ Dropshipping** oder **AliExpress**. |
| **Kategorie**, **Versand aus**, **Preis** | Die Ergebnisse eingrenzen. | Filtert nach Kategorie, Land des Lieferantenlagers sowie Ihrem Mindest- und Höchstpreis. |
| Sortierung | Die Reihenfolge der Ergebnisse ändern. | CJ bietet Sortierungen nach Preis, Listungen und Neuheit. AliExpress bietet **Beste Übereinstimmung** und **Meiste Bestellungen (letzte 180 Tage)**; nach Preis lässt sich dort nicht zuverlässig sortieren. |
| Produktkarte | Einen Artikel prüfen. | Öffnet Bilder, Varianten, Bestand, Lieferantenpreis und Lieferschätzungen. |
1. Wählen Sie **Versand nach**. Voreingestellt sind die Vereinigten Staaten, wenn sie zu Ihren Märkten gehören, sonst Ihr Standardmarkt.
2. Sehen Sie eine Vorschauauswahl durch oder suchen Sie. Grenzen Sie die Ergebnisse mit der Lieferantenauswahl und den Filtern ein.
3. Öffnen Sie eine Produktkarte. Prüfen Sie die Bilder, die Varianten, die Sie verkaufen möchten, den Bestand (**auf Lager** oder **Nicht auf Lager**) und den Lieferantenpreis.
4. Prüfen Sie für jede Variante **Referenz-Versandart** und **Voraussichtliche Lieferzeit**. Das sind Schätzungen des Lieferanten, keine Liefergarantien.
5. Wählen Sie **Zurück**, um weitere Produkte zu vergleichen. Ihr Lieferziel bleibt ausgewählt.
## 3. Produkt prüfen und veröffentlichen
Die Produktseite bündelt Produkteinrichtung, Markt, Preise und Versand an einem Ort. Mit **Produkt zum Shop hinzufügen** wird das Produkt erstellt und im ausgewählten Markt veröffentlicht.
| Steuerelement | Wofür Sie es verwenden | Was bei der Auswahl passiert |
| --- | --- | --- |
| **Zielmarkt** | Festlegen, in welchem Markt dieses Produkt verkauft wird. | Legt die Währung für Ihre Preise fest. Voreingestellt ist Ihre Wahl unter **Versand nach**. Mit **Markt hinzufügen** legen Sie einen neuen Markt an. |
| **Versandkosten für Kunden** | Festlegen, was Kunden für die Lieferung zahlen. | **Versandtarife des Shops verwenden** berechnet im Checkout die Versandtarife Ihres Markts. |
| **Aufschlag festlegen** | Alle Varianten über einen einzigen Aufschlag bepreisen. | Schlägt für jede ausgewählte Variante einen Verkaufspreis vor, basierend auf Produktkosten und Referenz für die Lieferkosten des Lieferanten. |
| **Verkaufspreise** | Ihren Verkaufspreis pro Variante festlegen. | Aktualisiert den geschätzten Gewinn und die Marge dieser Variante. |
| Varianten-Kontrollkästchen | Die zu verkaufenden Varianten auswählen. | Fügt die Variante hinzu oder entfernt sie. Die Aktionsleiste zeigt, wie viele Varianten ausgewählt sind. |
| **Referenz-Versandart** | Ihre Versandkosten beim Lieferanten schätzen. | Aktualisiert die Kostenaufstellung: **Produktkosten**, **+ Referenz für Lieferkosten des Anbieters**, **+ Gewinn · Marge**. |
| **Produkt zum Shop hinzufügen** | Das Produkt erstellen und veröffentlichen. | Importiert die ausgewählten Varianten und veröffentlicht das Produkt im Zielmarkt. Zeigt **Lieferant verbinden**, wenn keine Verbindung besteht. |
### Produktdetails und Preise konfigurieren
1. Wählen Sie den **Zielmarkt**.
2. Wählen Sie nur die Varianten aus, die Sie verkaufen möchten. Lassen Sie Varianten mit **Nicht auf Lager** aus.
3. Wählen Sie für jede Variante eine **Referenz-Versandart** und prüfen Sie die **Voraussichtliche Lieferzeit**.
4. Geben Sie unter **Aufschlag festlegen** einen Aufschlag ein oder tragen Sie unter **Verkaufspreise** für jede Variante einen Preis ein.
5. Prüfen Sie die Kostenaufstellung und den Wert unter **Durchschnittlicher geschätzter Gewinn pro Stück**. Achten Sie darauf, dass jeder Preis die Produktkosten und die Versandkosten deckt, die Sie dem Lieferanten zahlen.
CJ gibt Lieferantenkosten in US-Dollar an. Wenn Ihr Markt eine andere Währung verwendet, zeigt Runner umgerechnete Beträge nur zur Orientierung.
### Zielmärkte auswählen
- Jeder Import veröffentlicht in genau einem Markt. Preise werden in der Währung dieses Markts gespeichert.
- Um dasselbe Produkt in einem weiteren Markt zu verkaufen, kehren Sie in Dropshipping zum Produkt zurück, wählen den anderen **Zielmarkt**, geben Preise in dieser Währung ein und wählen erneut **Produkt zum Shop hinzufügen**.
- Jede Variante des Produkts braucht einen Preis in der Währung des Markts, bevor sie dort veröffentlicht werden kann.
### Versand einrichten
- Kunden zahlen die **Versandtarife des Shops** für ihren Markt, nicht die Versandkosten des Lieferanten. Rechnen Sie die geschätzten Versandkosten des Lieferanten in Ihren Produktpreis oder Ihren Versandtarif ein.
- Die **Versandkosten** eines neuen Markts sind der Tarif, den Kunden zahlen. **Geben Sie 0 für kostenlosen Versand ein.** Die Lieferoptionen können Sie später unter [Versand](./shipping) ändern.
- Die Lieferantenkosten hängen von der Lieferadresse ab. Im Checkout prüft Runner Ihre Lieferantenverbindung, den Bestand, den Preis und den Versand für die Adresse des Kunden erneut. Kann der Lieferant den Artikel nicht mehr liefern, stoppt der Checkout, statt eine Bestellung anzunehmen, die Sie nicht erfüllen können.
### Veröffentlichen und Ergebnis prüfen
1. Wählen Sie **Produkt zum Shop hinzufügen**, sobald Varianten und Preise festgelegt sind.
2. Warten Sie auf **Veröffentlicht. Sie können das Produkt nun in einem weiteren Markt veröffentlichen.** Außerdem erscheint die Meldung **Änderungen gespeichert** mit **Shop ansehen**.
3. Öffnen Sie **Produkte** und prüfen Sie das Produkt, seine Varianten, Preise, Bilder und Beschreibung. Titel, Beschreibung und Bilder können Sie dort bearbeiten.
4. Sehen Sie sich den Shop in der Vorschau an und prüfen Sie, ob das Produkt im gewählten Markt erscheint.
Für Dropshipping-Produkte führt Runner keinen Bestand; der Bestand des Lieferanten wird im Checkout geprüft. Die Spalte **Bestand** unter Produkte zeigt für sie einen Strich.
Wenn Sie **Das Ergebnis ist unbestätigt. Wiederholen Sie dieselbe Anfrage, bevor Sie die Auswahl ändern.** sehen, wählen Sie dieselbe Aktion erneut, ohne Ihre Auswahl zu ändern, und prüfen Sie dann **Produkte**.
Ältere Shops können eine andere Produktseite mit **Versand aus**, **Versand nach**, einer Liste von Versandarten und **Zum Shop hinzufügen** zeigen. Es gelten dieselben Regeln: Wählen Sie eine Route und ein Angebot, legen Sie für jede ausgewählte Variante einen Preis fest und fügen Sie dann das Produkt hinzu.
## 4. Bestellungen abwickeln
Wenn ein Kunde ein Dropshipping-Produkt kauft, besteht die Abwicklung aus zwei Teilen. Runner gibt die Lieferantenbestellung für Sie auf. **Danach müssen Sie sie in Ihrem Lieferantenkonto bestätigen und bezahlen.** Erst dann versendet der Lieferant.
### Was Runner automatisch erledigt
- Nach dem Checkout erstellt Runner eine Lieferantenbestellung in Ihrem verbundenen CJ- oder AliExpress-Konto. Sie müssen dafür in Runner nichts anklicken.
- Eine Shop-Bestellung kann mehrere Lieferantenbestellungen erzeugen, je eine pro Lieferant, Lager oder Versandart.
- Jede Lieferantenbestellung erscheint im Bereich **Dropshipping-Abwicklung** der Shop-Bestellung mit Status, **Versandmethode**, **Lager**, **Artikel** und **Zuletzt aktualisiert**. Die Sendungsdaten erscheinen, sobald der Lieferant versendet.
- Wenn eine Lieferantenbestellung beim ersten Versuch nicht erstellt werden kann, versucht Runner es weiter und zeigt in der Zwischenzeit **Erstellung ausstehend**.
- Runner aktualisiert den Lieferantenstatus, wenn Sie die Bestellung öffnen, wenn Sie **Status aktualisieren** wählen und bei einer täglichen Prüfung im Hintergrund für Bestellungen der letzten 90 Tage. Wählen Sie bei älteren offenen Bestellungen **Status aktualisieren** oder wenden Sie sich an den Support.
Runner bezahlt den Lieferanten **nicht** und markiert die Shop-Bestellung **nicht** für Sie als versendet.
### Bestellung Schritt für Schritt abwickeln
1. Öffnen Sie **Shop-Betrieb → Bestellungen** und wählen Sie die Bestellung aus.
2. Suchen Sie **Dropshipping-Abwicklung**. Warten Sie, bis die Lieferantenbestellung **Erstellt** oder **Unbezahlt** zeigt. Steht dort noch **Erstellung ausstehend**, sehen Sie später wieder nach; Runner versucht es erneut.
3. **Bezahlen Sie die Lieferantenbestellung in Ihrem Lieferantenkonto:**
- **CJ Dropshipping:** Melden Sie sich bei CJ an, öffnen Sie Ihre Bestellungen und suchen Sie die Bestellung, deren Nummer Ihre Runner-Bestellnummer enthält (zum Beispiel `…-1042-0` für Bestellung 1042). Bestätigen Sie die Versanddaten und bezahlen Sie mit Ihrem CJ-Guthaben oder Ihrer Zahlungsmethode.
- **AliExpress:** Runner zeigt **Manuelle Zahlung erforderlich** und die **AliExpress-Lieferantenbestell-IDs**. Melden Sie sich beim verbundenen AliExpress-Käuferkonto an und bezahlen Sie jede aufgeführte Bestellung.
4. Kehren Sie in Runner zur Bestellung zurück und wählen Sie **Status aktualisieren**. Nach der Zahlung wechselt der Status zu **In Bearbeitung** und dann zu **Versendet**, sobald der Lieferant die Ware verschickt.
5. Sobald **jede** Lieferantenbestellung unter **Dropshipping-Abwicklung** **Versendet** zeigt, wählen Sie in der Shop-Bestellung **Als verpackt markieren** und dann **Als versendet markieren**. Geben Sie den **Versanddienstleister** und eine **Sendungsnummer** aus dem Bereich Dropshipping-Abwicklung ein. So wird der Versand in der Shop-Bestellung erfasst, die Ihr Kunde sieht.
6. Wenn jede Lieferantenbestellung **Zugestellt** zeigt, wählen Sie **Als zugestellt markieren**.
**Als verpackt markieren** und **Als versendet markieren** gelten für die gesamte Shop-Bestellung, einschließlich der Artikel, die Sie selbst versenden, und Sie können eine Bestellung nur einmal als versendet markieren. Wenn eine Bestellung mehrere Lieferantenbestellungen hat, warten Sie, bis alle versendet sind, und senden Sie die übrigen Sendungsnummern dann direkt an Ihren Kunden.
:::warning
Geben Sie dieselbe Bestellung nicht selbst noch einmal bei CJ oder AliExpress auf. Runner hat sie bereits erstellt. Eine zweite Bestellung bedeutet, dass der Lieferant doppelt versendet und Ihnen doppelt berechnet.
:::
### Status von Lieferantenbestellungen
| Status | Bedeutung | Was Sie tun |
| --- | --- | --- |
| **Erstellung ausstehend** | Runner erstellt die Lieferantenbestellung noch. | Warten Sie. Runner versucht es automatisch erneut. **Status aktualisieren** ist noch nicht verfügbar. |
| **Erstellt**, **Im Warenkorb**, **Unbezahlt** | Der Lieferant hat die Bestellung, sie ist aber nicht bezahlt. | Bezahlen Sie sie in Ihrem CJ- oder AliExpress-Konto. |
| **In Bearbeitung**, **Sonstige** | Bezahlt; der Lieferant bereitet sie vor. AliExpress-Bestellungen zeigen in dieser Phase **Sonstige**. | Warten Sie auf die Sendungsverfolgung. Wählen Sie **Status aktualisieren**, um nachzusehen. Bleibt eine AliExpress-Bestellung bei **Sonstige**, öffnen Sie sie in Ihrem AliExpress-Konto und prüfen Sie, ob noch etwas fehlt, zum Beispiel eine vollständige Adresse. |
| **Versendet** | Der Lieferant hat sie verschickt. | Wählen Sie **Sendung verfolgen**, um sie zu verfolgen. Sobald jede Lieferantenbestellung der Shop-Bestellung versendet ist, erfassen Sie den Versand mit **Als versendet markieren**. |
| **Zugestellt** | Der Lieferant meldet die Zustellung. | Wählen Sie in der Shop-Bestellung **Als zugestellt markieren**. |
| **Stornierung ausstehend** | Runner hat den Lieferanten um Stornierung gebeten. | Warten Sie und wählen Sie dann **Status aktualisieren**. |
| **Storniert** | Die Lieferantenbestellung wird nicht versendet. | Prüfen Sie, ob die Shop-Bestellung ebenfalls storniert oder erstattet ist. |
| **Fehlgeschlagen** | Runner konnte die Lieferantenbestellung nicht erstellen. | Prüfen Sie Ihr Lieferantenkonto auf die Bestellung. Ist sie dort nicht vorhanden, wenden Sie sich an den Support, bevor Sie sie manuell aufgeben. |
| **Manuelle Prüfung erforderlich** | Runner konnte nicht bestätigen, ob der Lieferant die Bestellung erhalten hat. | Senden Sie sie nicht erneut ab. Wählen Sie **Support kontaktieren**, damit die Bestellung sicher abgeglichen werden kann. |
### Dropshipping-Bestellung stornieren oder erstatten
Wenn Sie in einer Shop-Bestellung **Bestellung stornieren** wählen, bittet Runner den Lieferanten automatisch, die zugehörigen Lieferantenbestellungen zu stornieren. Einen separaten Schritt in Runner brauchen Sie nicht.
- **CJ Dropshipping:** Runner sendet die Stornierung an CJ, solange die Lieferantenbestellung noch nicht versendet ist. CJ entscheidet, ob sie noch storniert werden kann.
- **AliExpress:** Runner kann die Bestellung nur stoppen, bevor sie bei AliExpress erstellt wird; AliExpress nimmt keine Stornierungen von Runner an. Danach zeigt Runner **Manuelle Stornierung erforderlich** und **Nicht bezahlen. Storniere diese Lieferantenbestell-IDs im verbundenen AliExpress-Käuferkonto.** Stornieren Sie diese Bestellungen in Ihrem AliExpress-Konto.
Öffnen Sie nach der Stornierung die Bestellung und prüfen Sie **Dropshipping-Abwicklung**. **Stornierung ausstehend** bedeutet, dass Runner auf den Lieferanten wartet; **Storniert** bedeutet, dass die Stornierung abgeschlossen ist. Erreicht der Status nicht **Storniert**, stornieren Sie die Bestellung direkt in Ihrem CJ- oder AliExpress-Konto und bezahlen Sie sie nicht.
- **Eine Erstattung storniert die Lieferantenbestellung nicht.** Wenn Sie einem Kunden den Betrag erstatten, ohne die Bestellung zu stornieren, kann der Lieferant sie trotzdem versenden und Ihnen berechnen.
- **Runner erstattet keine Lieferantenkosten.** Wenn Sie den Lieferanten bereits bezahlt haben, fordern Sie die Erstattung bei CJ oder AliExpress an.
## Lieferanten trennen
Trennen Sie einen Lieferanten nur, wenn Sie ihn nicht mehr nutzen oder das Lieferantenkonto wechseln müssen. Beim Trennen werden Ihr CJ-API-Schlüssel oder Ihr AliExpress-Zugriff aus der Organisation entfernt. Das betrifft jeden Shop im Arbeitsbereich.
:::warning
**Wickeln Sie laufende Bestellungen vollständig ab, bevor Sie trennen.** Nach dem Trennen aktualisiert Runner diese Lieferantenbestellungen nicht mehr: Status, Sendungsverfolgung, **Status aktualisieren** und Stornierung funktionieren in Runner nicht mehr, und Sie müssen die Bestellungen direkt bei CJ oder AliExpress verwalten.
:::
### Vor dem Trennen
1. Öffnen Sie **Shop-Betrieb → Bestellungen** und prüfen Sie jede Bestellung mit einem Bereich **Dropshipping-Abwicklung** für diesen Lieferanten.
2. Bezahlen oder stornieren Sie jede Lieferantenbestellung mit **Erstellt**, **Im Warenkorb** oder **Unbezahlt**.
3. Warten Sie, bis Bestellungen mit **Erstellung ausstehend** und **In Bearbeitung** erstellt, versendet oder storniert sind.
4. Erfassen Sie den Versand in jeder Shop-Bestellung mit **Als versendet markieren**, sobald alle zugehörigen Lieferantenbestellungen versendet sind.
5. Setzen Sie die Produkte dieses Lieferanten unter **Produkte** auf **Entwurf** oder löschen Sie sie. Nach dem Trennen können Kunden sie nicht mehr kaufen.
### Trennen
1. Öffnen Sie **Dropshipping** und wählen Sie **Lieferanten verwalten**.
2. Wählen Sie **Trennen** bei CJ Dropshipping oder AliExpress.
3. Lesen Sie **CJ Dropshipping trennen?** oder **AliExpress trennen?**: **Sie können dann keine neuen Produkte mehr hinzufügen und erhalten keine Aktualisierungen von diesem Lieferanten. Produkte und Bestellungen, die bereits in Runner sind, bleiben erhalten.**
4. Wählen Sie **Trennen**, um zu bestätigen, oder **Abbrechen**, um die Verbindung zu behalten.
5. Prüfen Sie, dass der Lieferant nicht mehr als verbunden angezeigt wird.
Wenn Sie **CJ konnte nicht getrennt werden – die Verbindung besteht noch. Versuchen Sie es erneut.** oder **AliExpress ist noch verbunden. Das Trennen hat nicht geklappt. Versuchen Sie es erneut.** sehen, ist die Verbindung noch aktiv. Versuchen Sie es erneut und gehen Sie nicht davon aus, dass sie entfernt wurde.
### Was sich nach dem Trennen ändert
| Bereich | Ergebnis |
| --- | --- |
| Produkte | Bleiben unter **Produkte**, können aber nicht mehr gekauft werden, bis Sie die Verbindung erneuern und sie bei Bedarf erneut importieren. |
| Neue Bestellungen | Kunden können die Produkte dieses Lieferanten nicht kaufen, daher entstehen keine neuen Lieferantenbestellungen. |
| Bestehende Lieferantenbestellungen | Bleiben in der Bestellung, werden aber nicht mehr aktualisiert. Verwalten Sie sie bei CJ oder AliExpress. |
| Anderer Lieferant | Nicht betroffen. Das Trennen von CJ trennt AliExpress nicht und umgekehrt. |
## Fehlerbehebung
- **Suche oder Produkt zum Shop hinzufügen öffnet den Verbindungsdialog:** Verbinden Sie CJ oder AliExpress. Die Vorschauauswahl gilt nicht als Verbindung.
- **Keine Ergebnisse:** Leeren Sie Suche und Filter, prüfen Sie **Versand nach** oder wechseln Sie den Lieferanten.
- **Ein Land ist unter Versand nach nicht auswählbar:** Fügen Sie dafür einen Markt hinzu und wählen Sie das Land dann erneut.
- **Eine Bestellung bleibt bei Unbezahlt:** Runner bezahlt Lieferanten nie. Bezahlen Sie die Bestellung in Ihrem CJ- oder AliExpress-Konto.
- **Der Kunde hat keine Sendungsverfolgung erhalten:** Runner überträgt die Sendungsdaten des Lieferanten nicht in die Shop-Bestellung. Verwenden Sie **Als versendet markieren** mit der Sendungsnummer.
- **Status aktualisieren schlägt mit „Ein Fehler ist aufgetreten“ fehl:** Die Lieferantenverbindung hat sich möglicherweise geändert, seit die Bestellung aufgegeben wurde. Prüfen Sie **Lieferanten verwalten** und verwalten Sie die Bestellung dann in Ihrem Lieferantenkonto.
- **Der Checkout stoppt bei einem Dropshipping-Produkt:** Lieferantenverbindung, Bestand, Preis oder Versand haben sich geändert. Verbinden Sie den Lieferanten erneut oder importieren Sie das Produkt noch einmal.
- **Ein Produkt zeigt nach Produkt zum Shop hinzufügen ein falsches Ergebnis:** Prüfen Sie **Produkte**, bevor Sie es erneut versuchen. Ein Ladezustand beweist nicht, dass der Import abgeschlossen ist.
- Die genauen Fehlermeldungen finden Sie im [Fehler-Playbook für den Dropshipping-Katalog](/de/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products).
## Verwandte Leitfäden
- [Bestellungen](./orders)
- [Produkte](./products)
- [Versand](./shipping)
- [Bestand und Varianten](./inventory-and-variants)
- [CJ Dropshipping verbinden](/de/guides/apps-and-integrations/cj-dropshipping)
- [Shop-Betrieb-Übersicht](/de/guides/store-operations)
---
# Produkte importieren
Source: https://www.runnerai.com/docs/de/guides/store-operations/import-products
Importieren Sie Produkte aus einer vorbereiteten CSV, wenn die Eingabe derselben strukturierten Kataloginformationen einzeln ineffizient wäre.
## Warum und wann Import verwenden
Verwenden Sie Import, wenn Sie bereits Produktdaten in einer Tabellenkalkulation oder einem anderen System haben und diese Runners CSV-Vorlage zuordnen können. Verwenden Sie das manuelle [Produkte](./products)-Formular für einen kleinen Katalog oder wenn Sie die Felder zuerst kennenlernen müssen.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Öffnen Sie **Shop-Betrieb → Produkte** in einem bereiten Shop.
- Schließen Sie die Store-Veröffentlichungs-/Bereitschaftseinrichtung ab, die seinen Live-Storefront-Katalogkanal erstellt; die Importaufgabe kann ohne diesen Kanal nicht fortgesetzt werden.
- Die gefüllte Desktop-Produktliste zeigt **Importieren**. In einem leeren Katalog verwenden Sie zuerst **Erstes Produkt hinzufügen**; die mobile Ansicht betont die manuelle Erstellung.
- Import akzeptiert nur CSV-Dateien.
- Verwenden Sie Runners aktuelle Vorlage. Erforderliche Spalten sind `Product Handle` und `Product Title`; Variantenzeilen müssen die erforderliche `Variant SKU` und Optionswerte enthalten, die von der Vorlage angezeigt werden.
- Das Starten eines Imports ändert den Shop-Katalog. Überprüfen Sie die Datei vor dem Einreichen.
## Produkte importieren öffnen
**Eingabepfad:** **Arbeitsbereich → Store wählen → Shop-Betrieb → Produkte → Importieren**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRTPhrLOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Importieren** | Öffnen Sie den Massenimport-Workflow | Öffnet den Dialog Produkte importieren, ohne eine Aufgabe zu starten. |
| **Vorlage** | Beginnen Sie mit Runners erwarteten Spalten | Lädt die aktuelle `product-import-template.csv`-Datei herunter. |
| **Verlauf** | Überprüfen Sie frühere Importaufgaben | Wechselt zu einer Liste von Importdateien und ihren neuesten Zuständen. |
| Upload-Bereich | Wählen Sie die vorbereitete CSV | Liest die Datei lokal und zeigt sie als bereit an, wenn Inhalte verfügbar sind. |
| Datei-Entfernungssteuerelement | Korrigieren Sie eine falsche Auswahl | Löscht die ausgewählte Datei, damit Sie eine andere wählen können. |
| **Import starten** | Reichen Sie die ausgewählte CSV ein | Startet eine Importaufgabe und wechselt dann zum Verlauf, wenn Runner sie akzeptiert. |
| **Abbrechen** | Verlassen Sie ohne Einreichen | Schließt den Dialog und löscht die ausgewählte Datei. |
| **Aktualisieren** im Verlauf | Fordern Sie den neuesten Aufgabenzustand an | Lädt den sichtbaren Importverlauf neu. |
| **Zurück zum Import** | Bereiten Sie eine andere Datei vor | Kehrt vom Verlauf zur Upload-Ansicht zurück. |
| **Schließen** | Verlassen Sie den Verlauf | Schließt den Dialog, ohne die bereits eingereichte Aufgabe zu ändern. |
## CSV vorbereiten und einreichen
1. Wählen Sie **Importieren** und dann **Vorlage**.
2. Öffnen Sie die heruntergeladene CSV in einem Tabellenkalkulationsprogramm, das CSV-Formatierung beibehält.
3. Behalten Sie die Vorlagenkopfzeilen. Füllen Sie `Product Handle` und `Product Title` für Produkte sowie die angezeigten `Variant SKU` und Optionswerte für Varianten aus.
4. Überprüfen Sie Produkthandles, Titel, Preise, Varianten und alle wiederholten Zeilen vor dem Export als CSV.
5. Kehren Sie zum Dialog zurück und wählen Sie die CSV in den Upload-Bereich oder ziehen Sie sie dorthin.
6. Warten Sie, bis die Datei **Bereit zum Importieren** anzeigt.
7. Wählen Sie **Import starten** einmal.
8. Folgen Sie im **Verlauf** der eingereichten Datei, bis sie einen Endzustand erreicht, aktualisieren Sie dann die Produktliste und überprüfen Sie die resultierenden Zeilen.
Laden Sie **Vorlage** herunter, prüfen Sie die Spaltenüberschriften und öffnen Sie **Verlauf**, um den Ablauf ohne Katalogänderung kennenzulernen. Kehren Sie mit **Zurück zum Import** zurück und schließen Sie den Dialog. Die Dateiauswahl bereitet den Import vor; erst **Import starten** übermittelt eine Katalogänderung.
Die Aufzeichnung zeigt die Importanforderungen und den leeren Verlauf und kehrt anschließend zu Produktentwürfen zurück. Es wird keine CSV-Datei übermittelt oder importiert.
## Verlaufszustände verstehen
| Zustand | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Ausstehend** | Die Aufgabe wartet auf den Start | Lassen Sie sie an Ort und Stelle und überprüfen Sie später erneut; reichen Sie nicht sofort ein Duplikat ein. |
| **Verarbeitung** | Runner arbeitet die Datei durch | Halten Sie den Dialog offen oder kehren Sie später zum Verlauf zurück. |
| **Abgeschlossen** | Runner hat die Datei dem Katalogimporter übergeben | Die Produktverarbeitung kann nach diesem Zustand fortgesetzt werden. Aktualisieren Sie Produkte und überprüfen Sie Namen, Varianten, Preise, Status und Bestand. |
| **Fehlgeschlagen** | Runner konnte die Importaufgabe nicht abschließen | Die aktuelle Verlaufskarte zeichnet den fehlgeschlagenen Zustand auf, aber nicht die detaillierte Ursache. Überprüfen Sie die Voraussetzungen und die Quell-CSV, bevor Sie eine neue Datei einreichen. |
| **Abgebrochen** | Die Aufgabe wurde nicht fortgesetzt | Bestätigen Sie, ob Produkte erstellt wurden, bevor Sie entscheiden, was als nächstes eingereicht werden soll. |
Der Verlauf kann auch die Dateigröße, die Gesamtzahl der Zeilen und eine Transaktions-ID anzeigen, wenn Runner diese Werte hat. Diese Details identifizieren die Aufgabe; sie ersetzen nicht die Überprüfung der Produktdatensätze.
## Grenzen und Fehlerbehebung
- **Import starten ist deaktiviert:** Wählen Sie eine `.csv`-Datei und warten Sie, bis Runner das Lesen von nicht leeren Inhalten abgeschlossen hat.
- **Ungültiger Dateityp:** Exportieren Sie die Tabellenkalkulation als CSV; das Umbenennen eines anderen Dateiformats konvertiert es nicht.
- **Dateilesefehler:** Exportieren Sie die CSV erneut, bestätigen Sie, dass sie auf Ihrem Gerät normal geöffnet wird, und wählen Sie sie erneut.
- **Import fehlgeschlagen:** Bestätigen Sie, dass die Store-Veröffentlichungs-/Bereitschaftseinrichtung den Live-Storefront-Katalogkanal erstellt hat, verwenden Sie dann die bereitgestellte Vorlage, stellen Sie erforderliche Spalten wieder her und überprüfen Sie Varianten-`Variant SKU` und Optionswerte.
- **Die Aufgabe scheint stecken zu bleiben:** Öffnen Sie den Verlauf und wählen Sie **Aktualisieren**. Ausstehend und Verarbeitung sind kein Beweis für Abschluss.
- **Unerwartete Produktzeilen erscheinen:** Wiederholen Sie nicht blindlings denselben Import. Vergleichen Sie die CSV-Handles mit der Produktliste und korrigieren Sie Datensätze absichtlich.
## Verwandte Leitfäden
- [Produkte](./products)
- [Bestand und Varianten](./inventory-and-variants)
- [Onboarding und Allgemeine Einstellungen](./onboarding-and-general-settings)
- [Übersicht über den Shop-Betrieb](/de/guides/store-operations)
---
# Bestand und Varianten
Source: https://www.runnerai.com/docs/de/guides/store-operations/inventory-and-variants
Verwenden Sie Varianten und Bestand, um die Wahlmöglichkeiten darzustellen, die Kunden kaufen können, und die Menge, die der Shop verkaufen kann.
## Warum und wann Varianten und Bestand verwenden
Fügen Sie Varianten hinzu, wenn ein Produkt Kundenwahlmöglichkeiten wie Größe oder Farbe hat. Geben Sie Bestand ein, wenn Runner verfolgen soll, wie viele Einheiten am Lagerort des Shops verfügbar sind.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Speichern Sie einen Lagerort in **Shop-Betrieb → Allgemein**, bevor Sie verfolgten Bestand eingeben.
- Speichern Sie den entsprechenden Markt und die Währung, bevor Sie Preise festlegen.
- Öffnen Sie ein manuelles Produkt. Buchungs- und Dropshipping-Produkte können unterschiedliche Verfügbarkeitsregeln verwenden und zeigen einen Bindestrich in der Liste anstelle normaler Bestandssummen.
- Planen Sie Optionsnamen und -werte, bevor Sie ein Live-Produkt bearbeiten, da das Ändern dieser Werte die Menge der kaufbaren Varianten ändern kann.
## Varianten und Bestand öffnen
**Zugriffspfad:** **Arbeitsbereich → Shop auswählen → Shop-Betrieb → Produkte → Hinzufügen**, oder wählen Sie eine bestehende Produktzeile und suchen Sie **Variante** sowie die direkt bearbeitbaren Preis- und Bestandsfelder.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggCsEjzIC4NbwvYeKD2nM5xTZ76dBjp0auiyP)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie vor dem Speichern den Preis und Bestand jeder Variante. Für diese Aufnahme wurde keine Bestands- oder Preisänderung gespeichert.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| Option hinzufügen unter **Variante** | Die erste Auswahl für Kunden hinzufügen | Erstellt Felder für einen Optionsnamen und dessen Werte. |
| Wert hinzufügen | Eine weitere Auswahl innerhalb einer Option ergänzen | Fügt einen weiteren Wert hinzu, der mit anderen Werten zu Varianten kombiniert werden kann. |
| Weitere Option | Eine zweite Dimension wie Farbe hinzufügen | Erstellt eine weitere Optionsgruppe und erweitert die Variantenkombinationen. |
| **Entfernen** | Entfernen Sie eine Option oder einen Wert | Entfernt diese Wahlmöglichkeit aus dem Formular und kann die generierten Kombinationen ändern. |
| **Gruppieren nach** | Organisieren Sie eine lange Variantenliste | Auf dem Desktop ändert sich, wie die aktuellen Varianten zur Bearbeitung gruppiert werden. |
| Variantenpreis | Legen Sie den Verkaufspreis für eine Wahlmöglichkeit fest | Verknüpft den eingegebenen Betrag und die Währung mit dieser Variante. |
| **Verkaufspreis festlegen** | Fügen Sie einen niedrigeren Promotionspreis hinzu | Öffnet Verkaufspreis- und optionale Planungsfelder für das ausgewählte Element oder die Variante. |
| **Verfügbare** Menge | Verfolgten Bestand für eine Variante festlegen | Aktualisiert die ungespeicherte Bestandsmenge, die für diese Variante und den Lagerort angezeigt wird. |
| **Speichern** | Wenden Sie die vollständige Produktkonfiguration an | Speichert gültige Option-, Varianten-, Preis- und Bestandsänderungen zusammen. |
## Produktvarianten erstellen
1. Öffnen Sie Produkt hinzufügen oder das beabsichtigte vorhandene Produkt.
2. Wählen Sie unter **Variante** das Steuerelement zum Hinzufügen einer Option.
3. Geben Sie einen kundenfreundlichen Optionsnamen ein und fügen Sie dann jeden gültigen Optionswert hinzu.
4. Fügen Sie nur dann eine weitere Option hinzu, wenn das Produkt eine zweite unabhängige Auswahl hat.
5. Überprüfen Sie jede generierte Variante. Entfernen Sie versehentliche Werte, bevor Sie Preise oder Bestand eingeben.
6. Legen Sie den korrekten Preis und die verfügbare Menge für jede Variante fest.
7. Wählen Sie **Speichern** und öffnen Sie dann die Zeile erneut, um die Variantenanzahl zu bestätigen.
### Beispiel: zwei Kerzengrößen
Verwenden Sie eine Option namens `Size` mit den Werten `Small` und `Large`. Daraus entstehen zwei Varianten. Legen Sie Preis und verfügbaren Bestand jeder Variante fest, wählen Sie **Speichern** und öffnen Sie das Produkt erneut.
| Eingegebene Optionen | Zu prüfende Varianten |
| --- | --- |
| Size: Small, Large | Small; Large — 2 Varianten |
| Size: Small, Large plus Scent: Cedar, Citrus | Small/Cedar; Small/Citrus; Large/Cedar; Large/Citrus — 4 Varianten |
Fügen Sie die zweite Option nur hinzu, wenn Sie alle vier Kombinationen verkaufen. Prüfen Sie den Bestand je Variante, statt den Gesamtbestand in jede Zeile zu kopieren.
## Bestand eingeben
1. Bestätigen Sie, dass das Produkt ein manuell gelagerter Artikel ist und ein Lagerort gespeichert ist.
2. Öffnen Sie das Produkt und suchen Sie **Bestand**.
3. Geben Sie die verfügbare Menge für jede relevante Variante ein.
4. Überprüfen Sie den Wert **Gesamtbestand am Shop-Lagerort**.
5. Wählen Sie **Speichern**.
6. Kehren Sie zu Produkten zurück und bestätigen Sie, dass die Spalte Bestand die gespeicherte Summe widerspiegelt.
## Zustände und Grenzen
- Ohne einen gespeicherten Lagerort zeigt Runner **Bestand nicht gespeichert** an und hindert das Produkt daran, zu behaupten, dass Bestand gespeichert wurde.
- Optionswerte erstellen Kombinationen. Das Hinzufügen vieler Werte über mehrere Optionen kann eine große Variantenliste erzeugen, die einzeln überprüft werden muss.
- Ein Verkaufspreis muss niedriger als der reguläre Preis sein. Lieferantenprodukte können einen zusätzlichen Mindesteinzelhandelspreis erzwingen.
- Eine Produktwährung außerhalb der gespeicherten Regionen des Shops erzeugt eine Nichtübereinstimmungswarnung und verhindert, dass Preise auf der Storefront korrekt angezeigt werden.
- Das Entfernen einer Option oder eines Wertes ändert die Kundenwahlmöglichkeiten. Überprüfen Sie die resultierenden Varianten vor dem Speichern.
- Buchungs- und Lieferantenprodukte können die Verfügbarkeit außerhalb der normalen Bestandsfelder verwalten.
## Fehlerbehebung
- **Bestand nicht gespeichert:** Fügen Sie einen Lagerort in Allgemein hinzu und speichern Sie ihn, geben Sie dann die Produktmenge erneut ein.
- **Die Variantenanzahl ist unerwartet:** Überprüfen Sie auf doppelte oder leere Werte und überprüfen Sie jede Optionskombination.
- **Ein Verkaufspreis wird abgelehnt:** Geben Sie einen Wert unter dem regulären Preis und innerhalb eines Lieferanten-Minimums ein.
- **Preise werden Kunden nicht angezeigt:** Richten Sie die Produktwährung mit einem gespeicherten Markt aus und überprüfen Sie dann die Produkt- und Shop-Sichtbarkeit.
- **Bestand zeigt einen Bindestrich in Produkten:** Überprüfen Sie, ob der Artikel ein Buchungs- oder Dropshipping-Produkt ist; diese Typen verwenden nicht die standardmäßige Bestandssumme in dieser Liste.
## Verwandte Leitfäden
- [Produkte](./products)
- [Versand](./shipping)
- [Produkte importieren](./import-products)
- [Onboarding und Allgemeine Einstellungen](./onboarding-and-general-settings)
---
# Onboarding und allgemeine Einstellungen
Source: https://www.runnerai.com/docs/de/guides/store-operations/onboarding-and-general-settings
Schließen Sie die geführte Einrichtung ab, wenn sie angezeigt wird, und verwenden Sie dann "Allgemein", um die wichtigsten Betriebsdetails des Speichers genau zu halten.
## Warum und wann diese Seite verwenden
Verwenden Sie die Einrichtungskarten, wenn Runner erstmals nach Shopdaten, einem ersten Produkt und Versand fragt. Kehren Sie zu Allgemein zurück, sobald sich öffentliche Shopdaten, Verkaufsregionen, Währung, Lagerstandort, Versandkonfiguration oder die Verfügbarkeit von Bewertungen ändern.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie ein Runner-Projekt mit einem Shop-Backend.
- Wenn das Backend noch vorbereitet wird, zeigt Runner **Bitte warten, der Speicheradministrator wird bereitgestellt...**.
- Der Setup-Assistent wird nur für Speicher angezeigt, die ihn nicht abgeschlossen haben, und kann sich unterscheiden, wenn Runner das aktualisierte Onboarding einführt.
- Die Zahlungsanbindung ist eine separate Aufgabe unter **Apps**. Eine abgeschlossene Einrichtung aktiviert weder den Checkout noch veröffentlicht sie die Storefront.
## Allgemein öffnen
**Eingabepfad:** **Workspace → Shop auswählen → Shop-Betrieb → Allgemein**
Falls Runner zuerst Einrichtungskarten öffnet, ergänzen Sie die erforderlichen Shopdaten und klären Sie die übrigen Schritte. Danach ist die Allgemein-Seite der reguläre Einstiegspunkt.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Diese Detailansicht zeigt Beispiel- oder Standardfelder. Sie bestätigt keinen gespeicherten Markt, Lagerstandort und keine gespeicherte Versandkonfiguration.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Einrichten** | Den Schritt für Shopdaten öffnen | Öffnet das Formular für die erforderlichen Shopdaten. |
| **Produkt hinzufügen** | Mit dem ersten Produkt beginnen | Öffnet die Produkteinrichtung. |
| **Produkteinrichtung überspringen** / **Versandeinrichtung überspringen** | Einen optionalen Schritt verschieben | Erledigt die Einrichtungskarte, ohne die übersprungene Funktion einzurichten. |
| **Versand einrichten** | Den Versandschritt konfigurieren | Öffnet die Versandeinrichtung. |
| **Shop-Betrieb öffnen** | Die abgeschlossene Einrichtungsansicht verlassen | Öffnet die reguläre Shopverwaltung, nachdem alle Schritte geklärt sind. |
| **Für Kunden sichtbar** / **Shop verbergen – Besucher sehen „Demnächst“.** | Ändern Sie die Sichtbarkeit später in "Allgemein" | Die Schaltfläche **Speichern** auf Seitenebene speichert den ausgewählten sichtbaren oder verborgenen Status. |
| **Hinzufügen** in Märkten oder Lagerbeständen | Fügen Sie eine weitere bearbeitbare Zeile hinzu | Erstellt eine nicht gespeicherte Regions- oder Standortzeile, die Sie ausfüllen können. |
| **Produktbewertungen** Schalter | Ermöglichen Sie Bewertungsfunktionalität, wenn unterstützt | Speichert diese Einstellung sofort. Wenn die Anfrage fehlschlägt, kehrt der Schalter zu seinem früheren Wert zurück; die Schaltfläche **Speichern** auf Seitenebene wird für diesen Schalter nicht verwendet. |
| **Speichern** | Wenden Sie Änderungen auf "Allgemein" an | Wird nach Änderungen im Seitenbereich verfügbar, validiert sie bei Auswahl und speichert gültige Sichtbarkeits-, Identitäts-, Markt-, Standort- und Versandbearbeitungen. |
| **Konfigurieren** in einer Setup-Warnung | Beheben Sie eine fehlende Checkout-Voraussetzung | Wechselt zum relevanten Abschnitt "Allgemein" oder öffnet die Zahlungsintegrationssicht in **Apps**. |
Beginnen Sie mit den Shopdaten. **Speichern und fortfahren** übermittelt die Pflichtfelder; **Abbrechen** lässt diesen Schritt offen.
## Die drei Einrichtungsschritte abschließen
1. Öffnen Sie **Shop-Betrieb**. Ein neuer Shop zeigt **Shop-Daten einrichten**, **Erstes Produkt hinzufügen** und **Grundeinstellungen für den Versand** statt des regulären Verwaltungsmenüs.
2. Wählen Sie unter **Shop-Daten einrichten** die Aktion **Einrichten**. Ergänzen Sie die unter **Vervollständigen Sie Ihre Shop-Daten** angeforderten Namens-, Kontakt- und Adressfelder und wählen Sie **Speichern und fortfahren**. Dieser Pflichtschritt kann nicht übersprungen werden.
3. Wählen Sie unter **Erstes Produkt hinzufügen** die Aktion **Produkt hinzufügen** und schließen Sie die Produkteinrichtung ab. Wählen Sie **Produkteinrichtung überspringen** nur, wenn Sie den Katalog später ergänzen möchten.
4. Wählen Sie unter **Grundeinstellungen für den Versand** die Aktion **Versand einrichten** und ergänzen Sie die angeforderten Felder. Wählen Sie **Versandeinrichtung überspringen** nur, wenn Sie die Lieferung später einrichten möchten.
5. Warten Sie auf **Shop-Einrichtung abgeschlossen** und wählen Sie dann **Shop-Betrieb öffnen**.
6. Prüfen Sie, ob das reguläre Verwaltungsmenü verfügbar ist. Falls Sie Produkte oder Versand übersprungen haben, folgen Sie vor dem Verkauf der entsprechenden Anleitung.
Ein direkter Link zu Produkte umgeht keine unvollständige Einrichtung. Falls ein älterer Shop einen anderen Assistenten zeigt, folgen Sie dessen sichtbaren Pflichtfeldern und optionalen Überspringen-Aktionen. Suchen Sie im oben beschriebenen Ablauf mit drei Karten nicht nach Zahlungsanbindung oder Veröffentlichung.
Die Aufzeichnung öffnet das Shopdaten-Formular, schließt es wieder und kehrt zu den Einrichtungskarten zurück. Sie zeigt den Einstieg und die Pflichtfelder, nicht eine abgeschlossene Einrichtung, Veröffentlichung oder Zahlungsanbindung.
## Aktualisieren Sie die allgemeinen Einstellungen später
1. Öffnen Sie **Shop-Betrieb → Allgemein**.
2. Wählen Sie die beabsichtigte Speichersichtbarkeit.
3. Überprüfen Sie den Speichernamen, die Kontakt-E-Mail und die Geschäftsadresse.
4. Überprüfen Sie Märkte, einschließlich Verkaufsländer, Währung und Steuereinstellung.
5. Überprüfen Sie Lagerbestände, bevor Sie Versand oder Bestand konfigurieren.
6. Überprüfen Sie Versand, wählen Sie dann **Speichern** und warten Sie auf den gespeicherten Status für diese Seiteneinstellungen.
7. Schließen und öffnen Sie Allgemein erneut, um den gespeicherten Markt, Lagerstandort und die Shopdaten zu prüfen.
8. Ändern Sie bei Bedarf den Schalter **Produktbewertungen**, falls er verfügbar ist, separat und warten Sie, bis die sofortige Aktualisierung abgeschlossen ist.
## Zustände und Grenzen
- Der Speichername ist erforderlich und das Setup-Formular begrenzt ihn auf 30 Zeichen.
- Die Kontakt-E-Mail muss eine gültige E-Mail-Adresse sein.
- Marktwährung beeinflusst die Produktpreisanzeige. Ein Produkt mit einer Währung außerhalb der gespeicherten Regionen zeigt eine Warnung an und zeigt möglicherweise keine Preise auf der Storefront.
- **Für Kunden sichtbar** steuert die Speichersichtbarkeit. Das Veröffentlichen von Storefront-Code und das Verbinden einer Domäne sind separate Aufgaben.
- Das Aktivieren von Bewertungen fügt einem älteren Storefront keine fehlenden Bewertungskomponenten hinzu. Runner kann Anleitung anzeigen, um den Agent zu bitten, die Funktion hinzuzufügen und diese Storefront-Änderungen zu veröffentlichen.
- Die Schaltfläche **Speichern** auf Seitenebene deckt Sichtbarkeit, Shop-Daten, Märkte, Lagerbestände und Versand ab. Der **Produktbewertungen** Schalter speichert separat und sofort.
## Fehlerbehebung
- **Speichern ist deaktiviert:** Nehmen Sie eine Änderung im Seitenbereich vor; das Ändern nur von **Produktbewertungen** verwendet diese Schaltfläche nicht.
- **Speichern meldet einen Fehler:** Füllen Sie die Felder aus, die die Validierungsmeldung benennt, und versuchen Sie es erneut.
- **Eine Setup-Warnung bleibt bestehen:** Schließen Sie die benannte Voraussetzung ab, speichern Sie sie und aktualisieren Sie dann. Bestand, Versand und Zahlung werden separat überprüft.
- **Zahlung fehlt immer noch nach der Verbindung:** Kehren Sie von der Anbieter-Registerkarte zurück, warten Sie, bis Runner die Integration als aktiviert anzeigt, und aktualisieren Sie bei Bedarf.
- **Bewertungen werden nicht im Menü angezeigt:** Der Schalter, die Backend-Unterstützung oder die Storefront-Funktion ist möglicherweise nicht bereit. Lesen Sie das bedingte Bewertungshandbuch, bevor Sie eine direkte URL versuchen.
- **Die Seite warnt vor nicht gespeicherten Änderungen:** Bleiben Sie und speichern Sie, oder wählen Sie explizit, ohne zu speichern zu beenden. Die Browser-Navigation allein wendet die Bearbeitungen nicht an.
## Verwandte Handbücher
- [Versand](./shipping)
- [Produkte](./products)
- [Bewertungen](./reviews-and-advanced-admin)
- [Übersicht über den Shop-Betrieb](/de/guides/store-operations)
---
# Bestellungen
Source: https://www.runnerai.com/docs/de/guides/store-operations/orders
Verwenden Sie Bestellungen, um jeden Kauf von der Aufgabe bis zur Zahlung, Erfüllung, Versand, Lieferung, Rückerstattung oder Stornierung zu verfolgen.
## Warum und wann Bestellungen verwenden
Öffnen Sie eine Bestellung, wenn Sie bestätigen müssen, was der Kunde gekauft hat, Adressen und Summen überprüfen, Zahlungs- oder Erfüllungsfortschritt verstehen oder eine verfügbare nächste Aktion ausführen möchten. Die sichtbaren Steuerelemente hängen von der Bestellung, verbundenen Diensten und früheren Aktionen ab.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Bestellungen werden angezeigt, nachdem Kunden sie aufgegeben haben. **Noch keine Bestellungen** ist normal für einen neuen Speicher.
- Zahlungssteuerelemente erfordern einen kompatiblen Zahlungszustand und einen verbundenen Anbieter.
- Erfüllungssteuerelemente erfordern erfüllbare Artikel und können von Versand- oder Lieferantendiensten abhängen.
- Buchungsabschnitte werden nur bei Bestellungen angezeigt, die unterstützte Buchungselemente enthalten.
- Dropshipping-Status, Aktualisierung und Verfolgung werden nur angezeigt, wenn die Bestellung verknüpfte Lieferantenfulfillment-Datensätze hat.
## Öffnen Sie Bestellungen
**Eingabepfad:** **Workspace → Shop auswählen → Shop-Betrieb → Bestellungen**
Wählen Sie eine Bestellungszeile aus, um ihren vollständigen Datensatz zu öffnen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw69RBMGkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
„Noch keine Bestellungen“ ist ein normaler Anfangszustand. Die folgenden bedingt verfügbaren Aktionen erfordern eine echte Bestellung; dieses Beispiel zeigt weder Erstattung noch Auftragsabwicklung.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Bestellungen durchsuchen...** | Finden Sie eine bestimmte Bestellung | Filtert die Liste mit den eingegebenen Bestellungs- oder Kundeninformationen. |
| **Aktualisieren** in der Bestellungsliste | Aktuelle Bestellungsdaten anfordern | Lädt die Liste und verfügbare Buchungs- oder Dropshipping-Statusdaten neu. |
| Bestellungszeile | Überprüfen Sie einen Kauf | Öffnet Zusammenfassung, Kunde, Adresse, Artikel, Zahlung, Erfüllung, Aktivität und bedingte Abschnitte. |
| **Adresse kopieren** | Verwenden Sie eine angezeigte Adresse genau wieder | Kopiert diese Adresse in die Zwischenablage. |
| **Zahlung erfassen** | Erfassen Sie eine autorisierte Zahlung | Öffnet eine Bestätigung; das Bestätigen fordert den verbundenen Dienst auf, ihn zu erfassen. |
| **Zahlung erstatten** (Dialog: **Zahlungsrückerstattung**) | Geben Sie einen zulässigen Betrag zurück | Öffnet Rückerstattungsbetrag und optionale Notizfelder; der Erfolg aktualisiert den Zahlungszustand. |
| **Als erfüllt markieren** | Erfüllen Sie alle derzeit nicht erfüllten Artikel | Sendet die Erfüllung sofort ein und aktualisiert die Bestellung nach dem Erfolg. |
| **Als versendet markieren** | Versandfortschritt aufzeichnen | Fordert Spediteur und optionale Verfolgungsinformationen an und aktualisiert dann die Erfüllung nach dem Erfolg. |
| **Als geliefert markieren** | Lieferabschluss aufzeichnen | Bestätigt die zulässige Erfüllung als geliefert nach dem Erfolg. |
| **Erfüllung stornieren** | Beenden Sie eine zulässige Erfüllung | Öffnet eine Bestätigung und aktualisiert diese Erfüllung, wenn die Anfrage erfolgreich ist. |
| **Bestellung stornieren** | Stornieren Sie eine zulässige Bestellung dauerhaft | Auf dem Desktop öffnet sich eine irreversible Bestätigung; alle Erfüllungen müssen zuerst storniert werden. |
| **Status aktualisieren** | Überprüfen Sie eine verknüpfte Dropshipping-Bestellung | Fordert den neuesten Lieferantenstatus für diesen Datensatz an. |
| **Bestellung verfolgen** | Öffnen Sie verfügbare Lieferantenverfolgung | Öffnet die Verfolgung nur, wenn ein verwendbares Verfolgungsziel vorhanden ist. |
| Buchungsaktionen | Aktualisieren Sie eine unterstützte bestätigte Buchung | **Als abgeschlossen markieren** oder **Nicht angezeigt markieren** wird nur für einen zulässigen Buchungszustand angezeigt. |
## Überprüfen Sie eine Bestellung sicher
1. Suchen Sie nach der Bestellung oder wählen Sie sie aus der Liste aus.
2. Bestätigen Sie die Anzeige-ID, das Datum, den Kunden, die Artikel, die Summen, die Versandadresse und die Rechnungsadresse.
3. Lesen Sie Zahlung und Erfüllung als separate Zustände; einer kann ohne den anderen fortschreiten.
4. Überprüfen Sie die Aktivität auf frühere Änderungen.
5. Wenn ein Buchungs- oder Dropshipping-Abschnitt vorhanden ist, überprüfen Sie seinen separaten Status und Details.
6. Wenn eine andere Person oder ein externer Dienst die Bestellung möglicherweise geändert hat, kehren Sie zur Liste zurück, wählen Sie **Aktualisieren** und öffnen Sie den Datensatz erneut, bevor Sie handeln.
Leeren Sie bei einem neuen Shop mit **Noch keine Bestellungen** die Suche und wählen Sie **Aktualisieren**, um die leere Liste zu bestätigen. Sie können die Listennavigation ohne Kauf kennenlernen. Die folgenden Aktionen hängen von einer vorhandenen Bestellung sowie deren Zahlungs- und Abwicklungsstatus ab.
## Führen Sie eine zustandsändernde Aktion aus
1. Wählen Sie nur eine Aktion aus, die für den aktuellen Zustand angezeigt wird. **Als erfüllt markieren** wird sofort auf alle nicht erfüllten Artikel angewendet; andere Aktionen können eine Bestätigung oder erforderliche Felder öffnen.
2. Wenn ein Dialog angezeigt wird, überprüfen Sie die Bestellung, Artikelmengen, Betrag, Spediteur oder Verfolgungsinformationen, die angezeigt werden.
3. Senden Sie oder bestätigen Sie einmal.
4. Warten Sie auf die Erfolgsmeldung und den aktualisierten Zustand.
5. Aktualisieren Sie vor dem erneuten Versuch. Ein Timeout oder Ladeanzeiger ist kein Beweis dafür, dass die erste Anfrage fehlgeschlagen ist.
## Verstehen Sie häufige Zustände
| Bereich | Beispielzustände | Wie man sie liest |
| --- | --- | --- |
| Zahlung | Zahlung ausstehend, Autorisiert, Bezahlt, Teilweise bezahlt, Erstattet, Teilweise erstattet, Storniert, Erfordert Aktion | Beschreibt Geldbewegung, nicht Versandfortschritt. |
| Erfüllung | Nicht erfüllt, Teilweise erfüllt, Erfüllt, Versendet, Teilweise versendet, Geliefert, Teilweise geliefert, Storniert | Beschreibt Vorbereitung und Lieferung, nicht ob die Zahlung abgewickelt wurde. |
| Buchung | Bestätigt, Abgeschlossen, Nicht angezeigt, Storniert | Wird nur für unterstützte Buchungselemente angezeigt. |
| Dropshipping | Erstellung ausstehend, Erstellt, Verarbeitung, Versendet, Geliefert, Fehlgeschlagen, Storniert oder andere Lieferantenzustände | Stammt aus einem verknüpften Lieferantendatensatz und kann sich separat von der Shop-Bestellung aktualisieren. |
## Grenzen und Fehlerbehebung
- **Eine Aktion fehlt:** Der Bestellungszustand, Artikeltyp, Anbieter oder Ihr Zugriff lässt dies derzeit nicht zu. Verwenden Sie keine direkte URL, um das fehlende Steuerelement zu umgehen.
- **Bestellung stornieren ist nicht verfügbar:** Dieses Steuerelement ist nur auf dem Desktop verfügbar und erfordert, dass jede Erfüllung zuerst storniert wird.
- **Eine Artikelrückerstattung ist nicht verfügbar:** Verwenden Sie nur die Rückerstattungsmethode, die Runner für die aktuelle Bestellung verfügbar macht; nehmen Sie nicht an, dass jeder Artikel direkte Rückerstattung unterstützt.
- **Status hat sich nicht geändert:** Warten Sie auf die Bestätigung, kehren Sie zur Bestellungsliste zurück, wählen Sie **Aktualisieren**, öffnen Sie den Datensatz erneut und überprüfen Sie die Aktivität, bevor Sie erneut versuchen.
- **Dropshipping sagt Fehlgeschlagen oder hat keine Bestellung:** Überprüfen Sie die verknüpften Lieferantendetails und die Verbindung, bevor Sie die Shop-Bestellung ändern.
- **Bestellung nicht gefunden:** Löschen Sie die Suche, überprüfen Sie das Projekt und überprüfen Sie die Bestellungskennung.
## Verwandte Handbücher
- [Kunden](./customers)
- [Versand](./shipping)
- [Dropshipping](./dropshipping)
- [Übersicht über den Shop-Betrieb](/de/guides/store-operations)
---
# Print-on-Demand mit Printful
Source: https://www.runnerai.com/docs/de/guides/store-operations/print-on-demand
Mit Print-on-Demand verkaufen Sie individuelle Produkte wie T-Shirts, Hoodies, Tassen und Poster, ohne Lagerbestand zu halten. Sie gestalten in Runner ein Printful-Basisprodukt und veröffentlichen es in Ihrem Shop. Printful druckt und versendet jede Bestellung, nachdem Sie sie in Printful bestätigt haben.
## So funktioniert es
1. **Printful verbinden.** Autorisieren Sie Ihr eigenes Printful-Konto einmal für Ihre Organisation.
2. **Basisprodukt wählen und gestalten.** Wählen Sie Produkt, Farben, Größen und Drucktechnik und fügen Sie dann Ihr Motiv hinzu.
3. **Prüfen und veröffentlichen.** Wählen Sie Mockups, schreiben Sie den Produkttext, legen Sie Preise, Märkte und Versand fest und veröffentlichen Sie dann.
4. **Bestellungen abwickeln.** Jede bezahlte Bestellung erstellt einen Bestellentwurf in Printful. Sie bestätigen den Entwurf in Printful, um die Produktion zu starten.
Wenn Sie Printful später nicht mehr nutzen möchten, lesen Sie [Printful trennen](#printful-trennen).
## Bevor Sie beginnen
**Zugriffspfad:** **Arbeitsbereich → Shop auswählen → Print-on-Demand**
**Print-on-Demand** erscheint in der Projektnavigation in der Gruppe **Aufbauen**, neben **Shop-Betrieb** und **Dropshipping**. Wenn Sie den Eintrag nicht sehen, ist die Funktion für Ihr Konto noch nicht aktiviert. Wenden Sie sich an den [Runner-Support](/de/guides/help-and-reference/support-and-community), um Zugriff anzufragen.
Sie benötigen:
- ein Runner-Projekt mit einem Shop;
- ein [Printful](https://www.printful.com)-Konto mit eingerichteter Abrechnung, denn Printful belastet Ihr Printful-Konto für jede Bestellung, die Sie bestätigen;
- die Rolle **Administrator** oder **Eigentümer** in der Runner-Organisation, um Printful zu verbinden oder zu trennen;
- mindestens einen Shop-Markt und eine Währung unter **Shop-Betrieb → Allgemein**; und
- vor dem Veröffentlichen einen Lagerstandort und eine Versandeinrichtung. Siehe [Versand](/de/guides/store-operations/shipping).
## 1. Printful verbinden
Sie können den Katalog schon vor dem Verbinden durchsehen. Bis Printful verbunden ist, zeigt die Seite **Vorschaumodus**. Zum Gestalten, Speichern oder Veröffentlichen müssen Sie Printful verbinden.
1. Öffnen Sie **Print-on-Demand**.
2. Wählen Sie **Printful verbinden**. Sie können auch ein Basisprodukt öffnen und **Eigenes Printful-Konto verbinden** wählen.
3. Melden Sie sich bei Printful an, falls Sie dazu aufgefordert werden, und prüfen Sie die Berechtigungen, die Runner anfordert.
4. Wählen Sie in der Shop-Auswahl von Printful den Shop, den Runner nutzen soll. Voreingestellt ist **Create a new Printful store**; ändern Sie die Auswahl, wenn Sie einen bestehenden Shop verwenden möchten.
5. Genehmigen Sie den Zugriff. Printful leitet Sie zurück zu **Print-on-Demand**, und die Seite zeigt **Verbunden**.
Die Verbindung gehört zu Ihrer Runner-**Organisation**. Daher nutzt jeder Shop dieser Organisation denselben Printful-Shop. Eine Organisation kann eine Printful-Verbindung haben, und ein Printful-Shop kann nur mit einer Runner-Organisation verbunden sein.
Um zu prüfen, welcher Printful-Shop verbunden ist, öffnen Sie das Menü **Shop verwalten** und wählen Sie **Verbindung verwalten**. Der Dialog zeigt den Namen des verbundenen Shops und die Printful-Shop-ID.
### Printful erneut verbinden
Wenn Printful die Autorisierung von Runner nicht mehr akzeptiert, zeigt Runner **Verbinden Sie Printful erneut, damit Bestellungen weiterlaufen**. Meist wurde dann der Shop in Printful gelöscht oder die Runner-App dort deinstalliert. Wählen Sie **Printful erneut verbinden** und wählen Sie in der Shop-Auswahl von Printful **denselben Printful-Shop**. Runner lehnt eine erneute Verbindung mit einem anderen Shop ab, solange die Verbindung noch aktiv ist.
## 2. Basisprodukt wählen und mit dem Gestalten beginnen
### Basisprodukt auswählen
1. Durchsuchen Sie **Alle Basisprodukte**, filtern Sie nach **Produkttypen** oder suchen Sie nach Produkt, Marke, Druckverfahren oder SKU.
2. Öffnen Sie ein Produkt. Sie sehen Bilder, verfügbare Farben, Größen, Druckpositionen, Techniken, Basiskosten, geschätzte Versandkosten und die voraussichtliche Lieferzeit für Ihre Märkte.
3. Wählen Sie eine **Technik**: **Druck** oder **Stickerei**, wenn beides angeboten wird. Wählen Sie unter **Druck** die **Druckart**, die Printful für dieses Produkt anbietet, zum Beispiel DTG, DTF, Sublimation oder Rundumdruck.
4. Wählen Sie eine oder mehrere **Farben** und **Größen**. Sie können bis zu **20 Varianten** (Kombinationen aus Farbe und Größe) für ein Produkt auswählen.
5. Nutzen Sie den Schieberegler **Aufschlag**, um Verkaufspreis und Gewinn in der Vorschau zu sehen. Zu Beginn steht der Preisvorschlag: 35 % Marge über der Gewinnschwelle, also den Basiskosten von Printful plus dem geschätzten Versand. Der Gewinn ist der Preis abzüglich beider Beträge und erscheint, sobald die Versandschätzung vorliegt. Sie können die Preise bei der Prüfung erneut ändern.
6. Wählen Sie **Design starten**. Der Designer öffnet sich mit den gewählten Optionen.
Wenn Runner Ihre Auswahl ändert, zum Beispiel mit „Die Größe wurde an diese Farbe angepasst.“, bietet Printful genau diese Kombination nicht an. Prüfen Sie die angepassten Optionen, bevor Sie fortfahren.
### Motiv hinzufügen
Jede Druckposition, etwa Vorderseite, Rückseite oder Ärmel, hat im Designer einen eigenen Tab. Fügen Sie jeder Position, die bedruckt werden soll, ein Motiv hinzu.
| Motivquelle | Funktion |
| --- | --- |
| **Datei hochladen** | Laden Sie JPEG-, PNG-, WebP- oder SVG-Dateien bis 18 MB hoch. SVG-Dateien werden in PNG umgewandelt. Empfohlen sind 300 DPI. |
| **Aus der Mediengalerie** | Verwenden Sie Bilder erneut, die Sie bereits in Runner erstellt oder hochgeladen haben. |
| **Mit Runner AI gestalten** | Beschreiben Sie Ihre Idee. **Bild erstellen** erzeugt ein neues Motiv; **Aktuelles Motiv bearbeiten** ändert das Motiv, das bereits auf dem Produkt ist. |
| **Inspirationen → Text** | Wählen Sie einen Schriftstil, etwa Bold varsity, Classic serif oder Light script. Runner AI macht aus Ihren Worten ein druckfertiges Textmotiv. |
| **Inspirationen → Etiketten & Abzeichen** | Wählen Sie eine Form, etwa ein rundes Abzeichen, ein Wappen oder ein Ticket-Etikett. Runner AI erstellt das Abzeichen mit Ihrem Text. |
| **Inspirationen → Kunst** | Platzieren Sie ein kuratiertes, frei nutzbares (CC0) Kunstwerk des Art Institute of Chicago direkt auf Ihrem Produkt. |
Wählen Sie eine Motivebene aus, um sie im Inspektor zu bearbeiten:
- verschieben, skalieren, drehen und die Deckkraft ändern;
- mit **Zuschneiden** das Motiv beschneiden, ohne das Originalbild zu ändern;
- mit **Hintergrund entfernen** dafür sorgen, dass nur Ihr Design gedruckt wird;
- mit **Muster wiederholen** ein Block-, Ziegel- oder Halbversatz-Layout mit einstellbarem Abstand und Versatz anlegen;
- Ebenen mit **Duplizieren** kopieren, mit **Sperren** fixieren und neu anordnen; und
- Änderungen mit **Rückgängig** und **Wiederholen** zurücknehmen oder wiederherstellen.
### Druckqualität prüfen
Prüfen Sie vor dem Speichern die Qualitätsanzeigen jeder Ebene:
- **Druckqualität** vergleicht die Auflösung des Motivs in seiner aktuellen Größe mit der DPI, die Printful verlangt. Wenn angezeigt wird, dass das Motiv unscharf gedruckt wird, verkleinern Sie es oder laden Sie eine schärfere Datei hoch.
- Warnungen zum **Druckbereich** und **Sicherheitsbereich** bedeuten, dass ein Teil des Motivs abgeschnitten oder beschnitten werden kann. Verschieben oder skalieren Sie das Motiv, bis es in beiden Bereichen liegt.
### Design speichern
Der Designer speichert nicht automatisch. Wählen Sie **Design speichern**, wenn Sie fertig sind. Bis Sie speichern, zeigt der Status **Ungespeicherte Änderungen**. Wenn Sie die Seite mit ungespeicherten Änderungen verlassen, fragt Runner, ob Sie speichern oder verwerfen möchten.
Gespeicherte Designs erscheinen auf der Print-on-Demand-Seite unter **Gespeicherte Designs**. Öffnen Sie eines, um weiterzuarbeiten oder daraus ein Produkt zu machen. Wenn Sie ein gespeichertes Design löschen, bleiben die Bilder in Ihrer Mediathek erhalten.
## 3. Produkt prüfen und veröffentlichen
Wenn Ihr Design fertig ist, wählen Sie im Designer **Veröffentlichen**. Runner speichert das Design und öffnet **Produkt veröffentlichen**.
### Produkt einrichten
| Abschnitt | Was Sie tun |
| --- | --- |
| **Produkt-Mockups** | Wählen Sie **Mockups erstellen**, um Fotos Ihres Designs auf dem Produkt zu erzeugen. Wählen Sie mindestens ein und höchstens acht Mockups aus. Ziehen Sie sie in die gewünschte Reihenfolge; das erste Bild ist Ihr Produktbild. |
| **Details** | Prüfen Sie **Produkttitel** und **Produktbeschreibung**, die Runner entworfen hat. Nutzen Sie **Mit KI entwerfen** für eine neue Beschreibung und prüfen Sie dann jedes Wort. |
| **Märkte** | Wählen Sie **Märkte wählen**, um die Länder und Währungen festzulegen, in denen Sie dieses Produkt verkaufen. Es werden nur Märkte angezeigt, in die Printful liefern kann. Wählen Sie mindestens einen Markt. |
| **Preisgestaltung** | Jede Variante startet mit dem Preisvorschlag: 35 % Marge über ihrer Gewinnschwelle, also den Basiskosten von Printful plus dem Versand, den Sie zahlen. Legen Sie mit **Aufschlag** einen anderen Aufschlag auf die Gewinnschwelle fest, oder geben Sie für jede Variante einen Preis ein. Der Gewinn ist der Preis abzüglich der Basiskosten von Printful und des Versands, den Sie zahlen; ein Preis unter der Gewinnschwelle wird als Verlust angezeigt. Die Tabelle zeigt für jeden Markt Verkaufspreis, Versand, Steuern und den geschätzten Gewinn der Variante, die am wenigsten einbringt. |
| **Versandkosten für Kunden** | Wählen Sie **Versandtarife des Shops verwenden**, damit Käufer die Versandtarife Ihres Shops zahlen, oder **Printful-Versandtarife berechnen**, damit Käufer beim Checkout den von Printful für ihre Adresse angegebenen Tarif zahlen. |
Die Versandschätzung auf dieser Seite dient als Preisreferenz: der günstigste Standardtarif von Printful, kein Express- oder Prioritätsversand. Die tatsächlichen Versandkosten von Printful hängen von der Lieferadresse jedes Kunden ab. Mit **Versandtarife des Shops verwenden** zahlen Käufer die Versandtarife Ihres Shops, und Printful stellt Ihnen den Versand in Rechnung, daher fließt die Schätzung in Gewinnschwelle, Preisvorschlag und Gewinn ein. Mit **Printful-Versandtarife berechnen** zahlen Käufer beim Checkout den Tarif von Printful, daher zählen nur die Basiskosten von Printful.
Dieses Produkt wird von Printful abgewickelt, daher gilt die Rückgaberichtlinie von Printful. Sie finden sie über den Link auf der Prüfseite.
### Entwurf erstellen
1. Wählen Sie **Produkt erstellen**.
2. Warten Sie, während Runner die Produktionsdateien vorbereitet und das Produkt erstellt. Sie können den Status jederzeit prüfen.
3. Wenn **Ihr Produkt ist jetzt ein Entwurf in Ihrem Shop. Veröffentlichen Sie es, wenn Sie mit dem Verkauf beginnen möchten.** erscheint, wählen Sie **Produkt anzeigen**.
Das Produkt ist jetzt ein **Entwurf** unter **Produkte**. Käufer können es noch nicht sehen. Unter Produkte können Sie seine URL und seinen Suchmaschineneintrag bearbeiten.
### Veröffentlichen
1. Öffnen Sie den Produktentwurf unter **Produkte**.
2. Prüfen Sie **Versand beim Checkout** und stellen Sie sicher, dass ein Versandmodus ausgewählt ist.
3. Wählen Sie **Produkt veröffentlichen**.
4. Warten Sie auf **Mit Printful synchronisiert.** Das Produkt ist jetzt live in Ihrem Shop und mit Ihrem Printful-Shop synchronisiert.
Zum Veröffentlichen braucht der Shop eine aktive Printful-Verbindung, einen Lagerstandort, eine Versandoption und einen Versandmodus für das Produkt. Fehlt etwas davon, zeigt Runner, was Sie beheben müssen, bevor Sie es erneut versuchen.
Sobald aus einem Design ein Produkt geworden ist, ist das Design an dieses Produkt gebunden. Wenn Sie es erneut bearbeiten, erstellt Runner eine Kopie. Das Speichern der Kopie ändert das bestehende Produkt nicht.
## 4. Bestellungen abwickeln
Runner gibt Bestellungen **nicht** automatisch in Produktion. Jede bezahlte Bestellung erstellt einen **Bestellentwurf** in Ihrem Printful-Shop, und Sie bestätigen ihn in Printful, um die Produktion zu starten.
1. Ein Käufer bezahlt eine Bestellung mit einem Print-on-Demand-Produkt.
2. Runner erstellt einen passenden Bestellentwurf in Ihrem Printful-Shop. Das geschieht automatisch für Bestellungen mit erfasster Zahlung.
3. Öffnen Sie **Shop-Betrieb → Bestellungen** und wählen Sie die Bestellung. Der Abschnitt **Printful-Auftragsabwicklung** zeigt den Entwurfsstatus und, sobald Printful sie berechnet hat, die Produktionskosten von Printful.
4. Wenn der Status **Entwurf bereit** lautet, wählen Sie **Bestellung in Printful aufgeben**. Printful öffnet die Bestellung in einem neuen Tab.
5. Prüfen Sie die Bestellung in Printful und bestätigen Sie sie. Printful belastet Ihr Printful-Konto und startet die Produktion.
6. Kehren Sie in Runner zur Bestellung zurück und wählen Sie **Status aktualisieren**. Runner aktualisiert den Status auch automatisch, wenn Printful Updates sendet.
| Status | Bedeutung |
| --- | --- |
| **Entwurf wird vorbereitet** | Runner erstellt den Entwurf in Printful. |
| **Entwurf bereit** | Der Entwurf liegt in Printful und wartet dort auf Ihre Bestätigung. |
| **Übermittelt** / **In Produktion** | Sie haben die Bestellung bestätigt, und Printful produziert sie. |
| **Teilweise abgewickelt** / **Abgewickelt** | Printful hat einige oder alle Artikel versendet. |
| **Aktion erforderlich** | Printful benötigt eine Aktualisierung, bevor es weitergehen kann. Öffnen Sie die Bestellung in Printful. |
| **Aktion erforderlich** (Runner konnte den Status nicht bestätigen) | Runner konnte den Abwicklungsstatus nicht bestätigen. Aktualisieren Sie den Status oder wenden Sie sich an den Support. |
| **Storniert** / **Gelöscht** | Die Printful-Bestellung wurde storniert oder der Entwurf wurde gelöscht. |
Beachten Sie diese Regeln:
- **Bestätigen Sie nur Bestellungen, die Sie wirklich abwickeln möchten.** Die Bestätigung in Printful startet eine unwiderrufliche Produktion und belastet Ihr Printful-Konto.
- **Erstattungen und Stornierungen ändern den Printful-Entwurf nicht.** Wenn Sie eine Kundenbestellung erstatten oder stornieren, löschen oder stornieren Sie den Entwurf in Printful selbst und bestätigen Sie ihn nicht.
- **Das Löschen eines Printful-Entwurfs storniert oder erstattet die Kundenbestellung nicht.** Bearbeiten Sie die Kundenbestellung separat in Runner.
- Wenn Runner **Entwurf erneut versuchen** anzeigt, hat Printful den Entwurf nicht erstellt, und Sie können es gefahrlos erneut versuchen.
- Wenn Runner meldet, dass Printful die Bestellung erstellt hat, Runner sie aber nicht zurücklesen konnte, **senden Sie sie nicht erneut**. Runner gleicht sie automatisch ab. Sehen Sie später noch einmal nach.
## Printful trennen
Das Trennen beendet die Nutzung Ihres Printful-Shops durch Runner sofort. **Schließen Sie jede laufende Bestellung ab, bevor Sie die Verbindung trennen.** Nicht abgeschlossene Bestellungen werden in Runner offline genommen und nicht erneut versucht, auch wenn Sie später einen anderen Printful-Shop verbinden.
### Vor dem Trennen
1. Suchen Sie unter **Shop-Betrieb → Bestellungen** jede Bestellung mit einem Abschnitt **Printful-Auftragsabwicklung**, deren Status nicht **Abgewickelt**, **Storniert** oder **Gelöscht** ist.
2. Bestätigen Sie jede Bestellung mit **Entwurf bereit** entweder in Printful, oder stornieren und erstatten Sie die Kundenbestellung in Runner und löschen Sie den Printful-Entwurf.
3. Warten Sie, bis bestätigte Bestellungen **Abgewickelt** zeigen, oder verfolgen Sie sie direkt in Printful weiter.
4. Nehmen Sie Print-on-Demand-Produkte, die Käufer nicht mehr sehen sollen, aus der Veröffentlichung oder entfernen Sie sie.
### Verbindung trennen
1. Öffnen Sie **Print-on-Demand**.
2. Öffnen Sie das Menü **Shop verwalten** und wählen Sie **Verbindung verwalten**.
3. Wählen Sie **Verbindung trennen**.
4. Lesen Sie die Auswirkungen und wählen Sie dann **Printful trennen**.
Nach dem Trennen gilt:
- Ihre Print-on-Demand-Produkte und -Entwürfe bleiben unter **Produkte** sichtbar, aber Käufer können sie weder in den Warenkorb legen noch zur Kasse gehen;
- diese Produkte zeigen **Dieses POD-Produkt ist nicht verfügbar** und können nicht über Printful verkauft oder bearbeitet werden;
- laufende Printful-Abwicklungen werden in Runner offline genommen; und
- Ihr Printful-Shop und seine Bestellungen bleiben in Ihrem Printful-Konto erhalten.
**Eine erneute Verbindung stellt keine Produkte wieder her.** Wenn Sie Printful später erneut verbinden, bleiben Produkte aus der früheren Verbindung nicht verfügbar. Erstellen Sie neue Produkte aus Ihren gespeicherten Designs.
## Grenzen
| Element | Grenze |
| --- | --- |
| Varianten pro Produkt | 1–20 Kombinationen aus Farbe und Größe |
| Produktbilder pro Produkt | Bis zu 8 Mockups |
| Märkte pro Produkt | Bis zu 51 |
| Aufschlag | 0–500 % |
| Produkttitel | Bis zu 255 Zeichen |
| Größe hochgeladener Dateien | 18 MB (JPEG, PNG, WebP oder SVG) |
| Printful-Verbindungen | Eine pro Organisation |
Ihr Tarif kann außerdem begrenzen, wie viele Produkte Sie erstellen können. Wenn Sie das Limit erreichen, zeigt Runner **Sie haben das Limit für Print-on-Demand-Produkte Ihres Tarifs erreicht. Führen Sie ein Upgrade durch, um weitere hinzuzufügen.**
## Fehlerbehebung
- **Print-on-Demand fehlt in der Navigation:** Die Funktion ist für Ihr Konto nicht aktiviert. Wenden Sie sich an den Support.
- **Printful verbinden schlägt fehl oder Sie dürfen keine Verbindung herstellen:** Bitten Sie einen Administrator oder Eigentümer der Organisation, Printful zu verbinden.
- **Die Printful-Ereignisübermittlung wartet auf die Runner-Einrichtung:** Runner muss eine einmalige Konfiguration abschließen. Sie müssen in Ihrem Shop nichts ändern.
- **Ein Mockup, ein Preis oder eine Versandschätzung wird nicht geladen:** Versuchen Sie es auf derselben Seite erneut. Ihr gespeichertes Design ist davon nicht betroffen.
Genaue Fehlermeldungen und Lösungsschritte finden Sie hier:
- [Printful-Verbindung und Katalog](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog) (Englisch)
- [Printful-Designkonflikte und nicht verfügbare Motive](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork) (Englisch)
- [Printful-Produktprüfung, Mockups und Veröffentlichung](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication) (Englisch)
- [Fehler bei Bestellungen und Auftragsabwicklung](/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment) (Englisch)
## Verwandte Anleitungen
- [Shop-Betrieb](/de/guides/store-operations)
- [Produkte](/de/guides/store-operations/products)
- [Bestellungen](/de/guides/store-operations/orders)
- [Versand](/de/guides/store-operations/shipping)
- [Dropshipping](/de/guides/store-operations/dropshipping)
---
# Produkte
Source: https://www.runnerai.com/docs/de/guides/store-operations/products
Verwenden Sie Produkte, um einen Artikel in ein vollständiges Speicherlisting mit kundenorientierten Informationen, Preisen, Medien und Status umzuwandeln.
## Warum und wann Produkte verwenden
Erstellen Sie ein Produkt, wenn Sie einen Artikel direkt verkaufen möchten, und kehren Sie dann zurück, um seinen Namen, seine Beschreibung, seine Kategorie, Bilder, Preise, Varianten, Bestand, Suchlisting oder Draft/Published-Status anzupassen.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Öffnen Sie ein Runner-Projekt mit einem bereiten Shop-Backend.
- Speichern Sie mindestens einen Markt, damit die Produktwährung einer Verkaufsregion entsprechen kann.
- Speichern Sie einen Lagerbestand, bevor Sie erwarten, dass Bestandsänderungen gespeichert werden.
- **Importieren** wird in der gefüllten Desktop-Liste angezeigt; ein neuer leerer Katalog beginnt mit **Erstes Produkt hinzufügen**.
- Dropshipping-Produkte können unterschiedliches Kosten- und Bestandsverhalten von manuell verwalteten Produkten aufweisen.
## Öffnen Sie Produkte
**Eingabepfad:** **Workspace → Shop auswählen → Shop-Betrieb → Produkte**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Entwurfszeilen zeigen bearbeitbare Katalogdatensätze. Sie beweisen nicht, dass die Artikel veröffentlicht oder kaufbar sind.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Aktualisieren** | Aktuelle Katalogdaten neu laden | Ruft Produkte und Marktinformationen erneut ab; es erstellt oder veröffentlicht nichts. |
| **Hinzufügen** / **Erstes Produkt hinzufügen** | Erstellen Sie ein manuelles Produkt | Öffnet ein leeres Produktformular hinzufügen. |
| **Importieren** | Produkte aus einer unterstützten CSV hinzufügen | Öffnet den Importdialog mit Vorlage und Verlauf. |
| Produktzeile | Überprüfen oder ändern Sie einen Artikel | Öffnet Produkt bearbeiten für dieses Produkt. |
| Stiftsymbol | Bearbeiten Sie ein Produkt, ohne seine Zeile auszuwählen | Öffnet das gleiche Produktformular bearbeiten. |
| Löschsymbol | Entfernen Sie ein Produkt | Öffnet eine destruktive Bestätigung; das Bestätigen entfernt das Produkt und kann nicht als reversibel angenommen werden. |
| **Entwurf** | Halten Sie das Listing aus dem veröffentlichten Katalog | Speichert das Produkt mit dem Status "Entwurf". |
| **Veröffentlicht** | Machen Sie das Listing berechtigt, im Katalog zu erscheinen | Speichert den Status "Veröffentlicht"; die tatsächliche Storefront-Sichtbarkeit hängt immer noch vom Shop- und Onlineshop-Status ab. |
| **Speichern** | Speichern Sie gültige Produktänderungen | Speichert das Produkt und kehrt nach dem Erfolg zur aktualisierten Liste zurück. |
| **Abbrechen** oder Zurück-Steuerelement | Verlassen Sie das Formular | Kehrt zur Liste zurück; nicht gespeicherte Formularänderungen werden nicht angewendet. |
## Erstellen Sie ein Produkt
1. Wählen Sie **Hinzufügen** oder **Erstes Produkt hinzufügen**.
2. Wählen Sie eine Produktkategorie und geben Sie einen klaren Namen und eine Beschreibung ein.
3. Fügen Sie Bilder hinzu und wählen Sie die beabsichtigte Miniaturansicht.
4. Wählen Sie **Entwurf**, während Sie das Listing vorbereiten, oder **Veröffentlicht**, wenn es für den Katalog bereit ist.
5. Geben Sie den regulären Preis ein. Fügen Sie einen niedrigeren Verkaufspreis und gültige Start-/Enddaten nur hinzu, wenn Sie einen geplanten Verkauf möchten.
6. Konfigurieren Sie [Varianten und Bestand](./inventory-and-variants), wenn der Artikel Optionen oder verfolgten Bestand hat.
7. Überprüfen Sie den SEO-Seitentitel, die Meta-Beschreibung, das Handle und die angezeigte Speicher-URL.
8. Wählen Sie **Speichern** und warten Sie, bis die Produktliste mit der aktualisierten Zeile zurückkommt.
### Mit einem Entwurf üben
Geben Sie für eine manuell angelegte Kerze einen eindeutigen Namen wie `Cedar Candle` ein, ergänzen Sie die tatsächliche Produktbeschreibung und lassen Sie **Entwurf** ausgewählt. Verwenden Sie einen Preis in der Währung des gespeicherten Shopmarkts. Falls Runner zuerst nach einem Produkttyp fragt, wählen Sie die manuelle Produkterstellung, bevor Sie diese Angaben eingeben.
Öffnen Sie nach **Speichern** die Zeile erneut und vergleichen Sie Name, Preis und Entwurfsstatus mit Ihrer Eingabe. Damit prüfen Sie die Katalogspeicherung; Veröffentlichung und funktionierender Checkout müssen separat geprüft werden.
## Bearbeiten oder entfernen Sie ein Produkt
1. Wählen Sie die Produktzeile oder ihr Stiftsymbol. **Produkt bearbeiten** zeigt den bestehenden Produkttyp schreibgeschützt an.
2. Ändern Sie nur die Felder, die das Listing beeinflussen sollten.
3. Wählen Sie **Speichern** und bestätigen Sie, dass die Zeile den neuen Status oder die neuen Informationen widerspiegelt.
4. Um das Produkt zu entfernen, kehren Sie zur Liste zurück und wählen Sie sein Löschsymbol.
5. Lesen Sie den Produktnamen in der Bestätigung. Fahren Sie nur fort, wenn eine dauerhafte Entfernung beabsichtigt ist.
## Zustände und Grenzen
- **Entwurf** und **Live** Abzeichen in der Liste fassen den Produktstatus zusammen. Das Formular verwendet **Entwurf** und **Veröffentlicht**.
- Eine Währungsabweichungswarnung bedeutet, dass die Produktwährung außerhalb der gespeicherten Regionen liegt; ihre Preise werden auf der Storefront nicht angezeigt, bis dies korrigiert wird.
- Der Verkaufspreis muss niedriger als der reguläre Preis sein. Lieferantenelement können auch einen Mindestverkaufspreis erzwingen.
- Bilder akzeptieren nur die vom Formular angezeigten Formate und Größen. Fehlerhafte Komprimierung oder Upload lässt das Produktbild unverändert.
- Buchungs- und Dropshipping-Zeilen können statt normaler Bestands- oder Variantensummen einen Bindestrich anzeigen.
- Das Speichern des Status "Veröffentlicht" ist nicht dasselbe wie das Veröffentlichen oder Bereitstellen der Storefront.
## Fehlerbehebung
- **Bestand nicht gespeichert:** Fügen Sie einen Lagerbestand hinzu und speichern Sie ihn, öffnen Sie dann das Produkt erneut und geben Sie den Bestand erneut ein.
- **Preis wird nicht angezeigt:** Machen Sie die Produktwährung mit einer gespeicherten Marktregion übereinstimmend.
- **Speichern bleibt deaktiviert oder schlägt fehl:** Nehmen Sie eine Änderung vor, schließen Sie dann den erforderlichen Namen und Status ab und beheben Sie alle Inline-Fehler. Fügen Sie eine geeignete Kategorie und einen Preis hinzu, bevor Sie ein vollständiges kundenorientiertes Listing erwarten, aber sie sind keine Voraussetzungen für die Aktivierung von **Speichern**.
- **Bild-Upload schlägt fehl:** Verwenden Sie JPEG, PNG, GIF oder WebP innerhalb der in der Bildhilfe angezeigten Größe und versuchen Sie es erneut.
- **Produkt fehlt auf der Storefront:** Überprüfen Sie den Status "Veröffentlicht", die Speichersichtbarkeit, die Storefront-Veröffentlichung und den relevanten Markt. Eine gespeicherte Admin-Zeile allein ist kein Beweis für die Kundensichtbarkeit.
## Verwandte Handbücher
- [Produkte importieren](./import-products)
- [Bestand und Varianten](./inventory-and-variants)
- [Dropshipping](./dropshipping)
- [Onboarding und allgemeine Einstellungen](./onboarding-and-general-settings)
---
# Promotionen
Source: https://www.runnerai.com/docs/de/guides/store-operations/promotions
Verwenden Sie Promotionen, um einen Rabatt, sein Kundenerlebnis, seine Berechtigungsregeln und ob er aktiv oder noch ein Entwurf ist, zu definieren.
## Warum und wann Promotionen verwenden
Erstellen Sie eine Promotion für eine geplante Kampagne, einen Kundenanreiz, ein kostenloses Versandangebot oder ein Kauf-und-Erhalten-Angebot. Beginnen Sie mit "Entwurf", während Sie die Details überprüfen; verwenden Sie "Aktiv" nur, wenn der Rabatt beim Checkout berechtigt sein sollte.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Öffnen Sie ein Runner-Projekt mit einem bereiten Shop-Backend.
- Erstellen Sie die Produkte, auf die eine Regel "Kauf X Erhalten Y" verweist, bevor Sie diese Promotion erstellen.
- Bestätigen Sie die relevante Marktwährung und das Versandsetup, bevor Sie Rabatte auf Basis von Betrag oder kostenlosem Versand anbieten.
- Testen Sie das Checkout-Verhalten mit einer geeigneten Testbestellung, bevor Sie einen Code öffentlich freigeben.
## Öffnen Sie Promotionen
**Eingabepfad:** **Workspace → Shop auswählen → Shop-Betrieb → Promotionen**
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Erstellen** / **Erste Promotion hinzufügen** | Wählen Sie einen neuen Rabatttyp | Öffnet ein Menü für Betrag von Bestellung, Prozentsatz von Bestellung, Kauf X Erhalten Y oder Kostenloser Versand. Die leere Liste verwendet **Erste Promotion hinzufügen**. |
| **Betrag von Bestellung** | Rabattieren Sie die Bestellsumme um einen festen Betrag | Öffnet ein Formular mit Betrag, Methode, Status und Berechtigungseinstellungen. |
| **Prozentsatz von Bestellung** | Rabattieren Sie die Bestellsumme um einen Prozentsatz | Öffnet ein Formular mit einem Prozentwert und den gemeinsamen Einstellungen. |
| **Kauf X Erhalten Y** | Geben Sie ausgewählte Produkte nach einem qualifizierenden Kauf | Öffnet Mengen- und Produktwähler für das, was der Kunde kauft und erhält. |
| **Kostenloser Versand** | Entfernen Sie zulässige Versandgebühren | Öffnet eine Promotion, deren Rabatt für den Versand gilt. |
| **Automatischer Rabatt** | Wenden Sie die Promotion an, ohne den Kunden nach einem Code zu fragen | Der Checkout wertet die Regeln automatisch aus, aber das Formular erfordert immer noch einen Codewert, um die Promotion zu identifizieren. |
| **Aktionscode** | Erfordern Sie einen vom Kunden eingegebenen Code | Kunden müssen den erforderlichen Code beim Checkout eingeben. |
| **Aktiv** / **Entwurf** | Kontrollieren Sie, ob die Promotion verwendbar ist | Speichert den gewählten Betriebszustand mit der Promotion. |
| **Bedingung hinzufügen** | Begrenzen Sie, wer die Promotion verwenden kann | Fügt Kundenattribut-, Operator- und Wertfelder hinzu. |
| **Speichern** | Wenden Sie ein gültiges Erstell- oder Bearbeitungsformular an | Erstellt oder aktualisiert die Promotion und kehrt nach dem Erfolg zur Promotionsliste zurück. |
| Promotionszeile | Überprüfen Sie eine Promotion | Öffnet Typ, Methode, Status, Code, Verwendung und verfügbare Aktionen. |
| **Bearbeiten** | Ändern Sie die ausgewählte Promotion | Öffnet das Bearbeitungsformular für diesen vorhandenen Promotionstyp. |
| **Löschen** | Entfernen Sie die Promotion dauerhaft | Öffnet aus der Desktop-Liste eine irreversible Bestätigung, die den Promotionscode benennt. Die aktuelle mobile Ansicht zeigt diese Aktion nicht. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBOjWz1xmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Diese Detailansicht zeigt Entwurfsstatus, Aktionscode oder automatischen Rabatt, Wert und Berechtigung. Speichern und Aktivierung werden nicht gezeigt.
## Erstellen Sie eine Promotion
1. Wählen Sie **Erstellen** oder **Erste Promotion hinzufügen**, wenn die Liste leer ist.
2. Wählen Sie den Typ, der dem Angebot entspricht.
3. Wählen Sie **Automatischer Rabatt** oder **Aktionscode**.
4. Geben Sie den erforderlichen Codewert ein. Geben Sie für **Aktionscode** den genauen Code ein, den Kunden verwenden sollten; geben Sie für **Automatischer Rabatt** den Code ein, den Kunden nicht eingeben.
5. Wählen Sie **Entwurf**, während Sie vorbereiten, oder **Aktiv**, wenn es berechtigt sein sollte.
6. Geben Sie den Rabattwert ein, oder wählen Sie die Produkte "Kauf" und "Erhalten" und Mengen.
7. Lassen Sie die Berechtigung für alle Kunden oder wählen Sie **Bedingung hinzufügen** und füllen Sie jedes Bedingungsfeld aus.
8. Überprüfen Sie die Zusammenfassung, wählen Sie dann **Speichern**.
9. Kehren Sie zur Liste zurück und bestätigen Sie den Typ, die Methode, den Status, den Code und die verwendeten Werte.
### Beispiel: einen 10-%-Code vorbereiten
Wählen Sie **Prozentrabatt auf Bestellung**, **Aktionscode**, den Code `WELCOME10`, **Entwurf** und den Wert `10`. Prüfen Sie vor dem Speichern die Berechtigung. Wenn Sie das Formular nur kennenlernen, verlassen Sie es ohne Speichern; ein ungespeichertes Formular erstellt keine Aktion.
Öffnen Sie nach dem beabsichtigten Speichern eines Entwurfs dessen Zeile erneut und prüfen Sie Code, Methode und Entwurfsstatus. Behalten Sie den Entwurf bei, bis Sie das gewünschte Checkout-Verhalten separat geprüft haben. Ein automatischer Rabatt benötigt ebenfalls einen internen Code; Kunden geben diesen jedoch nicht ein.
## Bearbeiten oder entfernen Sie eine Promotion
1. Wählen Sie eine Promotionszeile.
2. Wählen Sie **Bearbeiten**, ändern Sie die beabsichtigten Felder und wählen Sie **Speichern**.
3. Testen Sie die aktualisierte Regel, bevor Sie sie mit Kunden teilen.
4. Um sie zu entfernen, kehren Sie zur Desktop-Liste zurück, wählen Sie **Löschen** und lesen Sie den Code in der Bestätigung.
5. Fahren Sie nur fort, wenn eine dauerhafte Entfernung beabsichtigt ist.
## Zustände und Grenzen
- **Entwurf** wird gespeichert, ist aber nicht beabsichtigt, beim Checkout verwendbar zu sein.
- **Aktiv** ist berechtigt, angewendet zu werden, wenn seine Methode und Bedingungen übereinstimmen.
- **Inaktiv** kann in der Liste angezeigt werden, wenn eine vorhandene Promotion derzeit nicht aktiv ist.
- Ein Prozentwert muss zwischen 1 und 100 liegen.
- Das Formular erfordert einen Codewert für beide Methoden. Kunden geben ihn nur ein, wenn **Aktionscode** ausgewählt ist.
- Kauf X Erhalten Y erfordert sowohl das qualifizierende Produkt als auch das kostenlose Produkt.
- Jede hinzugefügte Bedingung benötigt ein Attribut, einen Operator und einen Wert.
- Mit einem automatischen Rabatt entscheidet der Checkout, ob seine Regeln übereinstimmen; der Kunde gibt den Codewert des Formulars nicht ein.
## Fehlerbehebung
- **Speichern ist deaktiviert oder zeigt einen Fehler:** Füllen Sie die Wert-, Code-, Produkt-, Mengen- oder Bedingungsfelder aus, die das Formular benennt.
- **Ein Code funktioniert beim Checkout nicht:** Bestätigen Sie genaue Schreibweise, Status "Aktiv", Kundenberechtigung, Produktanforderungen, Markt und den aktuellen Checkout.
- **Ein automatischer Rabatt wird nicht angewendet:** Überprüfen Sie, dass die Bestellung jede Bedingung erfüllt und dass eine andere Promotion das erwartete Ergebnis nicht ändert.
- **Eine kostenlose Versandpromotion hat keine sichtbare Auswirkung:** Bestätigen Sie, dass die Bestellung eine zulässige gespeicherte Versandoption hat und dass die Promotion aktiv ist.
- **Promotionsliste kann nicht geladen werden:** Aktualisieren Sie die Seite und bestätigen Sie das richtige Projekt, bevor Sie versuchen, ein Duplikat zu erstellen.
## Verwandte Handbücher
- [Produkte](./products)
- [Kunden](./customers)
- [Versand](./shipping)
- [Bestellungen](./orders)
---
# Bewertungen
Source: https://www.runnerai.com/docs/de/guides/store-operations/reviews-and-advanced-admin
Nutzen Sie Bewertungen, um Kundenfeedback zu moderieren, wenn die Funktion aktiviert ist.
## Warum und wann Bewertungen nutzen
Aktivieren Sie Bewertungen, wenn Ihr Storefront bereit ist, Produktfeedback zu sammeln und jemand die Einreichungen moderiert.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
### Bewertungen
- Öffnen Sie **Shop-Betrieb → Allgemein** und suchen Sie nach **Produktbewertungen**.
- Der Eintrag Bewertungen und die verfügbaren Steuerelemente hängen von der Shop-Unterstützung und der aktuellen Ansicht ab. Falls der Eintrag fehlt oder blockiert ist, prüfen Sie Produktbewertungen unter Allgemein, statt einen direkten Pfad zu erzwingen.
- Ein älteres Storefront kann Bewertungskomponenten nicht haben, auch nachdem der Schalter aktiviert ist. Wenn Runner den Funktionshinweis anzeigt, bitten Sie den Agent, die Produktbewertungsfunktion hinzuzufügen und die resultierenden Storefront-Änderungen zu veröffentlichen.
- Bewertungen werden nur angezeigt, nachdem Kunden sie über ein unterstütztes Storefront eingereicht haben.
## Zugriffspfade
**Bewertungen-Zugriffspfad:** **Workspace → Store wählen → Shop-Betrieb → Allgemein → Produktbewertungen**, Schalter aktivieren, dann **Shop-Betrieb → Bewertungen** wählen, wenn dieser Menüpunkt angezeigt wird.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglTicdyefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Der annotierte Bildausschnitt hebt die Moderationsfilter hervor. Öffnen Sie Allgemein, um die Erfassungseinstellungen zu verwalten; in diesem Beispiel wurde keine Bewertung freigegeben.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Produktbewertungen**-Schalter | Bewertungserfassung für den Store anfordern | Speichert die Einstellung sofort. Wenn die Anfrage fehlschlägt, kehrt der Schalter zu seinem früheren Wert zurück; es ist kein **Speichern** auf Seitenebene erforderlich. |
| **Alle** | Alle geladenen Moderationszustände überprüfen | Löscht den Statusfilter. |
| **Genehmigt** | Akzeptierte Einreichungen überprüfen | Filtert die Liste auf Genehmigt. |
| **Abgelehnt** | Abgelehnte Einreichungen überprüfen | Filtert die Liste auf Abgelehnt. |
| **Ausstehend** | Bewertungen finden, die auf eine Entscheidung warten | Filtert die Liste auf Ausstehend. |
| Zeilen-Kontrollkästchen | Bewertungen für eine Massenentscheidung auswählen | Fügt diese Bewertung zur aktuellen Auswahl hinzu oder entfernt sie. |
| **Genehmigen** | Eine Bewertung akzeptieren | Aktualisiert ihren Status auf Genehmigt nach erfolgreicher Ausführung. |
| **Ablehnen** | Eine Bewertung ablehnen | Aktualisiert ihren Status auf Abgelehnt nach erfolgreicher Ausführung. |
| **Ausgewählte genehmigen** | Alle aktivierten Bewertungen akzeptieren | Wendet Genehmigt auf die aktuelle Auswahl nach erfolgreicher Ausführung an. |
| **Ausgewählte ablehnen** | Alle aktivierten Bewertungen ablehnen | Wendet Abgelehnt auf die aktuelle Auswahl nach erfolgreicher Ausführung an. |
## Bewertungen aktivieren und vorhandene Einsendungen moderieren
1. Öffnen Sie **Shop-Betrieb → Allgemein**.
2. Aktivieren Sie **Produktbewertungen**.
3. Warten Sie, bis die Einstellung gespeichert ist. Wenn der Schalter auf Aus zurückkehrt, ist die Anfrage fehlgeschlagen; versuchen Sie es erneut, nachdem Sie die Store-Bereitschaft überprüft haben.
4. Wenn Runner sagt, dass das Storefront Bewertungskomponenten fehlen, bitten Sie den Runner-Agent, die Produktbewertungsfunktion hinzuzufügen, überprüfen Sie die Storefront-Änderung und veröffentlichen Sie sie.
5. Kehren Sie zum Shop-Betrieb zurück und öffnen Sie **Bewertungen**, nachdem das Menü angezeigt wird.
6. Wählen Sie **Ausstehend**.
7. Lesen Sie das Produkt, den Rezensenten, die Bewertung, den Inhalt und das Datum für jede Einreichung.
8. Wählen Sie **Genehmigen** oder **Ablehnen**, oder aktivieren Sie mehrere Zeilen und verwenden Sie die entsprechende Aktion für ausgewählte Elemente.
9. Warten Sie auf die Erfolgsmeldung und überprüfen Sie die Statusspalte.
## Zustände und Limits
- **Ausstehend** benötigt eine Moderationsentscheidung; **Genehmigt** und **Abgelehnt** dokumentieren die aktuelle Entscheidung.
- **Noch keine Bewertungen** ist gültig, bis unterstützte Kundeneinreichungen vorhanden sind.
- Das Aktivieren der Einstellung erzeugt keine Bewertungen und beweist nicht, dass das Storefront ein Bewertungsformular enthält.
## Fehlerbehebung
- **Bewertungsmenü fehlt:** Bestätigen Sie den Schalter in Allgemein, die Backend-Bereitschaft und den Storefront-Funktionshinweis. Aktualisieren Sie nach Bestätigung der Einstellung.
- **Kunden können keine Bewertungen hinterlassen:** Überprüfen Sie, ob das Storefront die Bewertungskomponenten enthält und diese Storefront-Änderungen veröffentlicht wurden.
- **Eine Moderationsaktion schlägt fehl:** Behalten Sie die Bewertung ausgewählt, aktualisieren Sie einmal und versuchen Sie es erneut, nachdem Sie ihren aktuellen Status überprüft haben.
## Verwandte Leitfäden
- [Onboarding und allgemeine Einstellungen](./onboarding-and-general-settings)
- [Produkte](./products)
- [Bestellungen](./orders)
- [Übersicht über den Shop-Betrieb](/de/guides/store-operations)
---
# Versand
Source: https://www.runnerai.com/docs/de/guides/store-operations/shipping
Konfigurieren Sie, von wo aus Bestellungen versendet werden, wo Kunden sie erhalten können, und wie der Checkout die Versandgebühren berechnet.
## Warum und wann Versandeinstellungen nutzen
Richten Sie den Versand ein, bevor Sie den Checkout testen oder ein physisches Produkt für Kunden verfügbar machen. Kehren Sie zurück, wenn Sie einen Erfüllungsort hinzufügen, in ein neues Land verkaufen oder den Betrag ändern, den Kunden für die Lieferung zahlen.
## Verfügbarkeit und Voraussetzungen
Falls Einrichtungskarten statt des Verwaltungsmenüs erscheinen, [schließen Sie zuerst die Shopeinrichtung ab](/de/guides/store-operations/onboarding-and-general-settings) und wählen Sie dann **Shop-Betrieb öffnen**.
- Erstellen und speichern Sie zuerst einen Lagerort.
- Behalten Sie mindestens eine gespeicherte Marktregion. Wenn eine Standardregion vorhanden ist, kann Runner das neu ausgewählte Versandziel beim Speichern automatisch hinzufügen; ohne Standardregion schlägt das Speichern fehl.
- Die hier angezeigten Versandoptionen sind Store-Regeln. Carrier- oder App-spezifische Dienste können eine separate Verbindung in **Apps** erfordern.
- Digitale, Buchungs-, Lieferanten- oder andere spezielle Produktabläufe können unterschiedliche Erfüllungsregeln befolgen.
## Öffnen Sie Versand
**Zugriffspfad:** **Workspace → Store wählen → Shop-Betrieb → Allgemein → Versand**
Wenn Runner eine Versand-Setup-Warnung anzeigt, wählen Sie **Konfigurieren**. Dies bringt Sie zum Versand-Bereich in Allgemein. Versand ist kein permanenter Eintrag in der Seitenleiste des Shop-Betriebs.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Verwenden Sie den gespeicherten Markt und Lagerstandort, bevor Sie eine Versandoption hinzufügen. Diese Beispielansicht der Felder zeigt weder eine abgeschlossene Speicherung noch einen Checkout-Versandtarif.
## Hauptsteuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn es ausgewählt wird |
| --- | --- | --- |
| **Hinzufügen** | Eine Versandoption erstellen | Fügt eine nicht gespeicherte **Kostenloser Versand**-Zeile mit einem leeren **Versand nach**-Ziel und kostenlosen Versandkosten hinzu. |
| **Name** | Geben Sie Kunden eine erkennbare Lieferwahl | Legt das Label fest, das für die Versandoption verwendet wird. |
| **Versand nach** | Wählen Sie das Kundenzieland | Begrenzt die Option auf dieses Ziel. |
| **Versandkosten** | Definieren Sie, wie der Checkout die Gebühr berechnet | Öffnet den Versand-Dialog für **Pauschalgebühr** oder **Tarif nach Preis**. |
| **Pauschalgebühr** | Einen Betrag berechnen | Zeigt ein einzelnes Versandpreis-Feld. |
| **Tarif nach Preis** | Versand nach Warenkorbsumme variieren | Zeigt Mindest-, Höchst- und Versandpreis-Zeilen. |
| **Hinzufügen** im Tarif-Dialog | Ein weiteres Preisband hinzufügen | Fügt einen nicht gespeicherten Warenkorbsummen-Bereich hinzu. |
| **Speichern** im Tarif-Dialog | Den Tarif-Entwurf akzeptieren | Schließt den Dialog und gibt den konfigurierten Tarif zur Seite Allgemein zurück. |
| **Abbrechen** im Tarif-Dialog | Dialog-Änderungen verwerfen | Schließt den Dialog, ohne diese Tarif-Änderungen anzuwenden. |
| **Speichern** in Allgemein | Die Versandoption speichern | Speichert den abgeschlossenen Versand und zugehörige Allgemein-Änderungen im Store. |
## Fügen Sie eine Pauschal- oder kostenlose Option hinzu
1. Bestätigen Sie in Allgemein, dass eine Marktregion und ein Lagerort gespeichert sind.
2. Scrollen Sie zu Versand und wählen Sie **Hinzufügen**.
3. Geben Sie einen klaren Namen ein, z. B. die Liefergeschwindigkeit oder -methode, die Kunden erkennen.
4. Wählen Sie **Versand nach**. Versandoptionen verwenden den in Allgemein gespeicherten Lagerort; es gibt keinen separaten **Versand von**-Selektor in jeder Zeile.
5. Öffnen Sie **Versandkosten**.
6. Wählen Sie **Pauschalgebühr** und geben Sie einen Versandpreis ein. Geben Sie `0` ein, wenn die Lieferung als **Kostenlos** angezeigt werden soll.
7. Wählen Sie **Speichern** im Dialog.
8. Wählen Sie das **Speichern** auf Seitenebene und warten Sie auf den gespeicherten Zustand.
**Beispiel:** Nennen Sie eine Option `Standard shipping`, wählen Sie ein Ziel in Ihrem gespeicherten Markt und setzen Sie **Pauschale** für kostenlosen Versand auf `0`. Wählen Sie **Speichern** im Dialog und anschließend **Speichern** unter Allgemein. Öffnen Sie Allgemein erneut und prüfen Sie Lieferziel und gespeicherten Tarif. Das erste Speichern schließt nur den Tarifeditor; es speichert die Versandkonfiguration noch nicht dauerhaft. Versanddienst und der im Checkout angezeigte Betrag müssen separat geprüft werden.
## Fügen Sie preisbasierte Tarife hinzu
1. Öffnen Sie **Versandkosten** für die beabsichtigte Option.
2. Wählen Sie **Tarif nach Preis**.
3. Geben Sie eine Mindest- oder Höchstwarenkorbsumme und den Versandpreis für diesen Bereich ein.
4. Wählen Sie **Hinzufügen** für jeden zusätzlichen Bereich.
5. Stellen Sie sicher, dass sich die Bereiche nicht überlappen und jede Zeile einen Versandpreis hat.
6. Wählen Sie **Speichern** im Dialog, dann **Speichern** in Allgemein.
## Zustände und Limits
- Jeder Preisbereich benötigt mindestens eine Mindest- oder Höchstwarenkorbsumme.
- Überlappende Preisbereiche werden abgelehnt.
- Ein Versandpreis ist für Pauschal- und preisbasierte Methoden erforderlich.
- Ein Ziel ohne gespeicherte Region zeigt **Sie verkaufen noch nicht in dieses Land – fügen Sie es zuerst unter „Märkte“ hinzu.**.
- Wenn eine Standardmarktregion vorhanden ist, kann das Speichern das ausgewählte Zielland automatisch zu dieser Region hinzufügen.
- Dialog **Speichern** bereitet die Option auf der Seite vor; verwenden Sie das **Speichern** der Seite Allgemein, um die vollständige Einstellungsänderung zu speichern.
## Fehlerbehebung
- **Bitte fügen Sie zuerst einen Lagerort hinzu:** Fügen Sie einen in Allgemein hinzu und speichern Sie ihn, kehren Sie dann zu Versand zurück.
- **Keine Standardregion verfügbar:** Erstellen und speichern Sie eine Marktregion, versuchen Sie dann das **Speichern** der Seite Allgemein erneut.
- **Bitte speichern Sie den Lagerort zuerst:** Verwenden Sie das **Speichern** der Seite Allgemein, öffnen Sie dann die Versandzeile erneut.
- **Zwei Bereiche überschneiden sich, sodass ein Warenkorbwert in beide fiele.** Passen Sie die Mindest- und Höchstwerte an, damit jede Warenkorbsumme nur einer Zeile entspricht.
- **Versand fehlt beim Checkout:** Bestätigen Sie, dass das Ziel einer gespeicherten Markt entspricht, die Versandzeile gespeichert ist, das Produkt Versand erfordert und ein verbundener Dienst bereit ist.
## Verwandte Leitfäden
- [Onboarding und allgemeine Einstellungen](./onboarding-and-general-settings)
- [Bestand und Varianten](./inventory-and-variants)
- [Bestellungen](./orders)
- [Übersicht über den Shop-Betrieb](/de/guides/store-operations)
---
# Storefront und Veröffentlichung
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing
Verwenden Sie diesen Abschnitt, um eine Storefront von einer In-App-Vorschau zu einem verifizierten Live-Store zu verschieben. Jede Seite behandelt eine Aufgabe und erklärt, was jedes wichtige Steuerelement tut.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Prüfen Sie zuerst die aktuelle Vorschau und folgen Sie dann der Anleitung für die gewünschte Änderung oder den nächsten Veröffentlichungsschritt.
## Was dieser Leitfaden abdeckt
Wählen Sie den Leitfaden, der Ihrer aktuellen Storefront-Aufgabe entspricht, ohne eine bearbeitbare Vorschau mit einem Live-, kaufbaren Store zu verwechseln.
## Verstehen Sie die vier Storefront-Zustände
| Zustand | Was es bedeutet | Was es nicht beweist |
| --- | --- | --- |
| **Vorschau** | Runner zeigt eine Arbeitskopie in Ihrem Projekt an. Sie können Seiten und Layouts überprüfen. | Der Store ist nicht unbedingt öffentlich. |
| **Veröffentlichen** | Runner überprüft und sendet die aktuelle Version zum ersten Mal an eine öffentliche Store-URL. | Produkte, Bestand, Versand, Zahlungen und Checkout werden nicht automatisch überprüft. |
| **Änderungen veröffentlichen** | Ein Live-Store existiert bereits und Runner kann neuere Änderungen daran senden. | Nicht gespeicherte oder unvollendete Änderungen sind noch nicht live. |
| **Erneut veröffentlichen** | Runner kann nach einer fehlgeschlagenen Veröffentlichung oder einer abgeschlossenen Veröffentlichung, die keine verwendbare URL zurückgegeben hat, erneut versuchen. | Es ist nicht das normale Label für die Veröffentlichung neuer Änderungen an einem gesunden Live-Store. |
## Wählen Sie eine Aufgabe
| Was Sie tun möchten | Leitfaden | Ergebnis |
| --- | --- | --- |
| Überprüfen Sie die aktuelle Storefront | [Shop in der Vorschau prüfen](/de/guides/storefront-and-publishing/preview-your-store) | Überprüfen Sie Seiten, Routen, Aktualisierungsverhalten und responsive Layouts. |
| Nehmen Sie visuelle Änderungen vor | [Design-Modus verwenden](/de/guides/storefront-and-publishing/design-mode) | Wählen Sie ein Element aus und öffnen Sie die Bearbeitungssteuerelemente. |
| Ändern Sie Text, Abstände, Typ oder Bilder | [Inhalte, Seiten und Medien bearbeiten](/de/guides/storefront-and-publishing/edit-content-pages-and-media) | Aktualisieren Sie eine sichtbare Seite und speichern Sie das Ergebnis. |
| Überprüfen oder ändern Sie eine Storefront-Datei | [Storefront-Code überprüfen und bearbeiten](/de/guides/storefront-and-publishing/inspect-and-edit-code) | Öffnen Sie den bedingten Code-Editor, speichern Sie eine fokussierte Dateiänderung, und überprüfen Sie seinen Git-Status. |
| Vergleichen oder stellen Sie einen früheren Zustand wieder her | [Versionsverlauf verwenden](/de/guides/storefront-and-publishing/version-history) | Zeigen Sie eine Vorschau einer Version an oder stellen Sie sie als neue aktuelle Version wieder her. |
| Überprüfen Sie, ob der Store bereit ist | [Veröffentlichung vorbereiten](/de/guides/storefront-and-publishing/prepare-to-publish) | Lösen Sie die von Runner angezeigten Überprüfungen auf oder bestätigen Sie sie explizit. |
| Bringen Sie Änderungen online | [Veröffentlichen und erneut veröffentlichen](/de/guides/storefront-and-publishing/publish-and-republish) | Starten Sie den korrekten Veröffentlichungsfluss für den aktuellen Zustand. |
| Beweisen Sie, dass die Customer Journey funktioniert | [Live-Store und Checkout überprüfen](/de/guides/storefront-and-publishing/live-store-and-checkout) | Bestätigen Sie den öffentlichen Katalog, Warenkorb und Checkout separat. |
| Verwenden Sie Ihre eigene Webadresse | [Benutzerdefinierte Domain verbinden](/de/guides/storefront-and-publishing/custom-domains) | Fügen Sie eine berechtigte Domain hinzu, kaufen Sie, übertragen Sie, erneuern Sie oder diagnostizieren Sie sie. |
| Erholen Sie sich von einem blockierten Zustand | [Fehlerbehebung bei Vorschau und Veröffentlichung](/de/guides/storefront-and-publishing/troubleshoot-preview-and-publishing) | Ordnen Sie die Nachricht auf dem Bildschirm der sichersten nächsten Aktion zu. |
## Empfohlene Reihenfolge für einen ersten Start
1. Überprüfen Sie die neueste Version in der [Vorschau](/de/guides/storefront-and-publishing/preview-your-store).
2. Nehmen Sie alle visuellen Bearbeitungen im [Design-Modus](/de/guides/storefront-and-publishing/design-mode) vor und speichern Sie sie.
3. Überprüfen Sie die [Voraussetzungen für die Veröffentlichung](/de/guides/storefront-and-publishing/prepare-to-publish).
4. Wählen Sie **Veröffentlichen** und folgen Sie dem Bestätigungsfluss.
5. Öffnen Sie die öffentliche URL und [überprüfen Sie Katalog und Checkout](/de/guides/storefront-and-publishing/live-store-and-checkout).
6. Fügen Sie eine [benutzerdefinierte Domain](/de/guides/storefront-and-publishing/custom-domains) erst nach der ersten erfolgreichen Veröffentlichung hinzu.
## Verfügbarkeit und Sicherheit
- **Design-Modus** ist bedingt. Es ist für eine bereite neueste Version auf einem Desktop-Layout vorgesehen und kann nicht verfügbar sein, während Runner arbeitet.
- **Code-Editor öffnen** ist bedingt. Das Speichern, Committen, Pushen, Veröffentlichen und Überprüfen des Live-Stores sind separate Ergebnisse.
- Die Veröffentlichung kann durch Plan oder Store-Status begrenzt werden. Folgen Sie der in Ihrem Workspace angezeigten Nachricht, anstatt anzunehmen, dass jedes Konto denselben Zugriff hat.
- Eine Veröffentlichungsbestätigung kann Ihnen ermöglichen, unvollständiges Setup zu bestätigen. Diese Wahl kann einen durchsuchbaren Storefront online stellen, während der Checkout pausiert oder unvollständig bleibt.
## Verwandte Leitfäden
- [Willkommen bei Runner AI](/de/guides/product-guide)
- [Storefront-Code überprüfen und bearbeiten](/de/guides/storefront-and-publishing/inspect-and-edit-code)
- [Fehlerbehebung bei Vorschau und Veröffentlichung](/de/guides/storefront-and-publishing/troubleshoot-preview-and-publishing)
---
# Verbinden Sie eine benutzerdefinierte Domain
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/custom-domains
**Zugriffspfad:** **Einstellungen** in der Seitenleiste → **Store: _Shopname_** → **Domain**. Auf dem Desktop kann auch das Menü der veröffentlichten Website unter **Onlineshop** die Option **Domain-Einstellungen** anbieten.
## Was dieser Leitfaden abdeckt
Öffnen Sie Domain-Einstellungen für einen veröffentlichten Store, wählen Sie den richtigen Domain-Workflow und verstehen Sie, was jede Aktion mit hohem Einfluss ändert, bevor Sie fortfahren.
## Warum und wann eine benutzerdefinierte Domain nutzen
Eine benutzerdefinierte Domain gibt Kunden eine Markenadresse für den veröffentlichten Store. Verbinden Sie eine nach der ersten erfolgreichen Veröffentlichung und nachdem der Store unter seiner bestehenden öffentlichen URL funktioniert. Dies isoliert Domain-Probleme von Storefront-, Katalog- und Checkout-Problemen.
## Verfügbarkeit und Voraussetzungen
- Der Zugriff auf **Eigene Domain** ist planabhängig.
- Der Store muss eine erfolgreiche Veröffentlichung haben, bevor Domain-Steuerelemente verfügbar werden.
- Sie benötigen Zugriff auf die Projekteinstellungen.
- Das Hinzufügen einer Domain, die Sie bereits besitzen, erfordert die Berechtigung, ihre DNS-Einträge bei Ihrem DNS-Anbieter zu ändern.
- Das Kaufen oder Erneuern einer Domain startet einen externen Zahlungsfluss.
- Das Übertragen einer Domain zwischen Stores im selben Workspace ist auf Workspace-Besitzer und Administratoren beschränkt.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgj47Uwq6IQ3D84warl6z9RO5sLdoxCUgTn1v2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Ein unveröffentlichter Shop zeigt diese Voraussetzung. Veröffentlichen Sie ihn und prüfen Sie seine öffentliche URL, bevor Sie den folgenden DNS-Verbindungsschritten folgen.
## Öffnen Sie Domain-Einstellungen
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Öffnen Sie nach der Veröffentlichung das Dropdown neben **Änderungen veröffentlichen**: 1. Menü der veröffentlichten Website. 2. **Website ansehen** öffnet den Live-Store; **URL kopieren** kopiert seine Adresse. 3. **Domain-Einstellungen** öffnet die Adressverwaltung. Dieses Bild bestätigt keinen funktionierenden Checkout. Wählen Sie das Bild aus, um es zu vergrößern. Die Markierungen verwenden die englische Desktop-Oberfläche.
1. Prüfen Sie den aktuellen Shopnamen.
2. Öffnen Sie **Einstellungen** in der Seitenleiste.
3. Wählen Sie unter **Store: _Shopname_** die Option **Domain**.
4. Falls die Seite zuerst eine Veröffentlichung verlangt, schließen Sie die erste Veröffentlichung ab und prüfen Sie sie, bevor Sie eine Domain hinzufügen.
## Domain-Steuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn Sie es auswählen |
| --- | --- | --- |
| **Wie verbinde ich meine eigene Domain?** | Öffnen Sie die aktuelle Verbindungshilfe. | Die Hilfeseite öffnet sich in einem neuen Tab. |
| Domain eingeben + **Weiter** | Eine Domain hinzufügen, die Ihnen bereits gehört. | Runner prüft und verknüpft die Adresse und ermittelt anschließend den DNS-Anbieter. **Domain hinzugefügt – folgen Sie den DNS-Schritten unten, um sie live zu schalten.** bestätigt nur die Verknüpfung; DNS und Eigentum werden separat geprüft. Vor der ersten erfolgreichen Veröffentlichung ist diese Aktion nicht verfügbar. |
| **Weiter zu Cloudflare** | Lassen Sie Runner die erforderlichen Einträge für eine unterstützte, von Cloudflare verwaltete Domain hinzufügen. | Runner öffnet die Autorisierungsseite von Cloudflare. Wählen Sie das Konto mit der Domain aus und erlauben Sie Runner den DNS-Zugriff. Nach der Rückkehr schreibt Runner die exakt erforderlichen Einträge und startet eine neue Verbindungsprüfung. Diese Option wird nur angezeigt, wenn die automatische Einrichtung verfügbar ist. |
| **Manuelle Einträge verwenden** | Wechseln Sie von einem angebotenen automatischen Ablauf zur manuellen DNS-Einrichtung. | Wählen Sie die Option, um die genauen Einträge **Typ / Host / Wert** anzuzeigen. Ist die automatische Einrichtung nicht verfügbar, zeigt Runner diese Einträge direkt an. Fügen Sie jeden angezeigten Eintrag bei Ihrem DNS-Anbieter hinzu und kehren Sie anschließend zu Runner zurück. |
| **Ich habe die Einträge hinzugefügt** | Prüfen Sie DNS direkt nach dem Speichern der manuellen Einträge. | Runner prüft automatisch; mit dieser Schaltfläche überspringen Sie die anfängliche Wartezeit und prüfen die Routing-Einträge sowie eine mögliche Inhaberschaftsbestätigung sofort. Eine erfolgreiche Autorisierung beim Anbieter allein markiert die Domain nicht als verbunden. |
| Symbol löschen im Domain-Feld | Den eingegebenen Wert entfernen. | Die Eingabe wird gelöscht; keine Domain wird geändert. |
| **Domain kaufen** Suche + **Suchen** | Finden Sie zum Kauf angebotene Domains. | Runner listet verfügbare Ergebnisse auf oder erklärt, dass die angeforderte Domain nicht verfügbar ist. |
| **Kaufen** | Beginnen Sie mit dem Kauf einer ausgewählten verfügbaren Domain. | Runner öffnet **Kontaktinformationen** mit der angezeigten Domain und dem Preis. Es findet noch kein Kauf statt. |
| **Zur Zahlung fortfahren** | Setzen Sie einen Domain-Kauf oder eine Erneuerung fort. | Runner leitet zu einem externen Checkout um. Dies kann eine Gebühr verursachen, wenn Sie ihn abschließen. Überprüfen Sie zuerst die angezeigten Details. |
| **Domain übertragen** / **Wählen Sie eine zu übertragende Domain** | Verschieben Sie eine berechtigte Domain von einem anderen Store im selben Workspace. | Das Auswählen einer Domain öffnet eine Bestätigung, die die Quell- und Ziel-Stores benennt. Das Bestätigen startet die Übertragung; der Quell-Store verliert diese Domain. |
| Domain-Adresse unter **Ihre Domains** | Öffnen Sie die Website unter dieser Adresse. | Die Domain öffnet sich in einem neuen Browser-Tab. |
| Kopieren neben **Host** oder **Wert** | Verwenden Sie den genauen DNS-Eintrag, den Runner empfiehlt. | Der ausgewählte Host oder Wert wird zum Verwenden bei Ihrem DNS-Anbieter kopiert. Geben Sie den angezeigten **Typ** separat ein. |
| Domain entfernen | Trennen Sie eine benutzerdefinierte Domain. | Runner öffnet **Domain entfernen**. Das Auswählen von **Entfernen** bestätigt eine Änderung, die der Dialog als nicht rückgängig machbar beschreibt. |
| **Erneuern** | Verlängern Sie eine berechtigte gekaufte Domain, die sich dem Ablauf nähert. | Runner öffnet Erneuerungsoptionen und eine Summe vor **Zur Zahlung fortfahren**. |
| **Erneut versuchen** bei fehlgeschlagener Übertragung | Starten Sie einen weiteren Übertragungsversuch. | Runner startet einen neuen Versuch für die gleiche ausgewählte Domain. |
| **Schließen** bei fehlgeschlagener Übertragung | Verlassen Sie den Dialog für fehlgeschlagene Übertragung. | Der Dialog schließt sich, ohne den Wiederholungsversuch zu starten. |
| Schließen oder X während **Übertragung läuft** | Dialog für Fortschritt schließen | Die serverseitige Übertragung wird fortgesetzt; das Schließen des Dialogs bricht sie nicht ab. Kehren Sie später zurück, um den Status zu überprüfen und starten Sie keine weitere Übertragung. |
## Verbinden Sie eine Domain, die Sie bereits besitzen
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Dieses Beispiel zeigt einen veröffentlichten Store mit freigeschalteten Domain-Steuerelementen. 1. Geben Sie eine eigene Domain ein. 2. Wählen Sie **Weiter**. 3. Suchen Sie bei Bedarf unter **Domain kaufen**. 4. Öffnen Sie die veröffentlichte Adresse unter **Ihre Domains**. **Domain übertragen** ist eine separate Option. Die Adresse ist verdeckt; es wurde keine Domain hinzugefügt. Wählen Sie das Bild aus, um es zu vergrößern. Die Markierungen verwenden die englische Desktop-Oberfläche.
1. Prüfen Sie, ob der Shop unter seiner aktuell veröffentlichten URL funktioniert.
2. Öffnen Sie **Domain-Einstellungen**.
3. Geben Sie die vollständige Domain ein, die Sie kontrollieren, und wählen Sie **Weiter**.
4. **Domain hinzugefügt – folgen Sie den DNS-Schritten unten, um sie live zu schalten.** bedeutet, dass Runner die Adresse akzeptiert und verknüpft hat. Es bestätigt weder eine eingerichtete DNS-Konfiguration noch eine erreichbare Website.
5. Wählen Sie eine Einrichtungsmethode: - Erkennt Runner eine unterstützte Cloudflare-Einrichtung, wählen Sie **Weiter zu Cloudflare**, wählen Sie das Cloudflare-Konto mit der Domain und erlauben Sie Runner den DNS-Zugriff. Sobald Cloudflare Sie zu Runner zurückführt, schreibt Runner genau die in den Domain-Einstellungen angezeigten Einträge. - Wird ein automatischer Ablauf angeboten und Sie bevorzugen die manuelle Einrichtung, wählen Sie **Manuelle Einträge verwenden**. Ist die automatische Einrichtung nicht verfügbar, werden die Einträge bereits angezeigt. Ergänzen Sie jeden angezeigten Eintrag mit **Typ / Host / Wert** bei Ihrem DNS-Anbieter.
6. Wählen Sie nach dem Speichern der manuellen Einträge **Ich habe die Einträge hinzugefügt**, um die erste Wartezeit zu überspringen und sofort zu prüfen. Runner prüft auch automatisch bei einer ausstehenden Verbindung und nach der Rückkehr von Cloudflare.
7. Warten Sie auf den Status Verbunden. Sowohl die Routing-Einträge als auch die Domain-Eigentumsprüfung müssen erfolgreich sein; eine abgeschlossene Cloudflare-Autorisierung allein beweist keine Verbindung.
8. Öffnen Sie die Domain unter **Ihre Domains** und prüfen Sie die öffentliche Storefront, ein Produkt, den Warenkorb und den Checkout erneut unter der eigenen Adresse.
## Kaufen, übertragen, erneuern oder entfernen Sie mit Vorsicht
- **Kaufen:** Suchen, wählen Sie **Kaufen**, überprüfen Sie die Domain und den aktuellen Preis, geben Sie genaue Kontaktinformationen ein, fahren Sie dann zur Zahlung fort, nur wenn Sie sie kaufen möchten.
- **Übertragen:** Lesen Sie die benannten Quell- und Ziel-Stores. Die Bestätigung sagt, dass der Quell-Store die Domain verliert und dass sofortiges Rückgängigmachen nicht verfügbar ist. Bestätigen Sie nicht, während dieser Quell-Store die Adresse noch benötigt. Das Schließen des Fortschrittsdialogs bricht eine aktive Übertragung nicht ab.
- **Erneuern:** Überprüfen Sie den Erneuerungszeitraum und die Summe, bevor Sie zur Zahlung fortfahren.
- **Entfernen:** Stellen Sie sicher, dass eine andere funktionierende Domain vorhanden ist und notieren Sie die aktuelle Einrichtung, bevor Sie **Entfernen** wählen. Die Bestätigung warnt, dass das Entfernen nicht rückgängig gemacht werden kann.
## Zustände, Limits und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Bitte veröffentlichen Sie zuerst** | Das Projekt hat noch keine erfolgreiche Veröffentlichung. | Veröffentlichen und überprüfen Sie die bestehende öffentliche URL, bevor Sie eine benutzerdefinierte Domain hinzufügen. |
| **Keine Domains gefunden** | Derzeit ist keine Domain angehängt. | Fügen Sie eine eigene Domain hinzu oder suchen Sie eine zum Kauf. |
| **Das sieht nicht nach einer Domain aus. Versuchen Sie etwas wie yourbrand.com.** | Runner lehnte das Adressformat ab. | Korrigieren Sie die Adresse und versuchen Sie es erneut. |
| **Domain ist bereits an einen anderen Store angehängt** | Ein anderer Store in diesem Workspace verwendet sie. | Ein Besitzer oder Administrator kann **Stattdessen übertragen?** wählen; andere Mitglieder sollten einen Administrator kontaktieren. |
| **Domain hinzugefügt – folgen Sie den DNS-Schritten unten, um sie live zu schalten.** | Runner hat die Adresse akzeptiert und verknüpft. Die DNS-Konfiguration wird separat geprüft. | Lesen Sie den Domain-Eintrag, bevor Sie die Adresse als einsatzbereit betrachten. |
| **Weiter zu Cloudflare** wird nicht angezeigt | Die automatische Einrichtung ist für diese Domain derzeit nicht verfügbar oder der Cloudflare-Verbindungsdienst ist noch nicht bereit. | Verwenden Sie die in der Domain-Zeile angezeigten manuellen DNS-Einträge. Warten Sie nicht darauf, dass eine automatische Option erscheint. |
| Manuelle DNS-Einträge und **Ich habe die Einträge hinzugefügt** | Die eigene Domain ist verbunden, aber Routing oder Inhaberschaftsprüfung sind noch nicht erfolgreich. | Fügen Sie alle angezeigten Einträge exakt hinzu, warten Sie auf die DNS-Verteilung und wählen Sie anschließend **Ich habe die Einträge hinzugefügt**, um sofort zu prüfen. Runner prüft weiterhin automatisch. |
| Status „Prüfen“ oder „Verifizieren“ nach der Rückkehr von Cloudflare | Runner liest den tatsächlichen DNS- und Inhaberschaftsstatus. | Lassen Sie die Seite geöffnet oder kehren Sie später zurück. Wenn die Verbindung nicht hergestellt wird, verwenden Sie die manuellen Einträge und prüfen Sie erneut. |
| Blaues Häkchen und die DNS-Steuerelemente der Domain sind verschwunden | Sowohl die aktuelle DNS-Konfiguration als auch die Inhaberschaftsprüfung waren erfolgreich. | Öffnen Sie die Domain und überprüfen Sie die gesamte Customer Journey; das Häkchen allein beweist nicht, dass Storefront oder Checkout funktionieren. |
| Spinner mit **Domain wird eingerichtet — in wenigen Minuten erreichbar** | Eine über Runner gekaufte Domain wird noch eingerichtet. | Wenden Sie die manuellen DNS-Anweisungen für eigene Domains nicht auf diesen Zustand an. Kehren Sie später zurück; eine feste Abschlusszeit wird nicht garantiert. |
| **Übertragung läuft** | Ein Workspace-Domain-Umzug hat begonnen. | Vermeiden Sie, einen weiteren Umzug für die gleiche Domain zu starten. Das Schließen des Dialogs schließt ihn nur; die Übertragung wird auf dem Server fortgesetzt. Kehren Sie später zurück, um das Ergebnis zu überprüfen. |
| Übertragung fehlgeschlagen | Der Umzug wurde nicht abgeschlossen. | Lesen Sie den Fehler, wählen Sie dann **Erneut versuchen** oder **Schließen**. Bestätigen Sie, welcher Store die Domain noch hält, bevor Sie eine weitere Aktion durchführen. |
| Kauf oder Erneuerung fehlgeschlagen | Der externe Kauf wurde nicht abgeschlossen. | Folgen Sie dem von Runner angezeigten Status und bestätigen Sie einen Rückerstattungsstatus, bevor Sie eine weitere Zahlung versuchen. |
## Verwandte Leitfäden
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Überprüfen Sie den Live-Store und Checkout](./live-store-and-checkout)
- [Fehlerbehebung bei Vorschau und Veröffentlichung](./troubleshoot-preview-and-publishing)
---
# Verwenden Sie den Design-Modus
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/design-mode
**Zugriffspfad:** Workspace → Store wählen → **Onlineshop** → **Design-Modus**
## Was dieser Leitfaden abdeckt
Öffnen Sie den Design-Modus in der neuesten Storefront-Version, wählen Sie ein sichtbares Element aus, nehmen Sie eine kontrollierte Änderung vor und speichern Sie sie als Teil des aktuellen Projekts.
## Warum und wann Design-Modus nutzen
Nutzen Sie den Design-Modus für fokussierte visuelle Änderungen, die leichter zu zeigen als von Grund auf zu beschreiben sind: Überschrift umschreiben, Bild ersetzen, Abstände anpassen, Typografie ändern oder ein sichtbares Element entfernen.
Nutzen Sie Runner-Chat für umfassendere Arbeiten, die mehrere Seiten umfassen, das Store-Verhalten ändern oder neue Funktionalität erfordern.
## Verfügbarkeit und Voraussetzungen
Der Design-Modus ist bedingt. Er ist verfügbar, wenn:
- Sie ein Desktop-Layout verwenden;
- die neueste Storefront-Version bereit und ausgewählt ist;
- Sie keine ältere Version in der Vorschau anzeigen;
- Runner gerade keine andere Anfrage verarbeitet; und
- die Design-Modus-Funktion für den Workspace aktiviert ist.
Wenn die Vorschau noch vorbereitet wird, eine historische Version ausgewählt ist oder Runner arbeitet, kann die Schaltfläche verborgen oder deaktiviert sein.
## Öffnen Sie den Design-Modus
1. Öffnen Sie Ihr Projekt.
2. Wählen Sie **Onlineshop**.
3. Stellen Sie sicher, dass das Versionslabel **Aktuell** sagt und die Vorschau bereit ist.
4. Wählen Sie **Design-Modus** in der Storefront-Symbolleiste.
5. Wenn eine untere Bearbeitungsleiste mit einem weiteren **Design-Modus**-Steuerelement angezeigt wird, wählen Sie es, um die Elementauswahl zu aktivieren.
6. Bewegen Sie sich über das Storefront und wählen Sie das Element aus, das Sie ändern möchten.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Der Designmodus ist geöffnet, aber noch kein Element ausgewählt. Wählen Sie das zu ändernde Element, um seine verfügbaren Steuerelemente anzuzeigen. Der Screenshot zeigt weder eine Bearbeitung noch eine Speicherung.
## Design-Modus-Steuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn Sie es auswählen |
| --- | --- | --- |
| **Design-Modus** in der Storefront-Symbolleiste | Geben Sie die dedizierte Bearbeitungsansicht ein. | Runner öffnet das aktuelle Storefront im Design-Panel. |
| **Design-Modus** in der unteren Leiste | Schalten Sie die Elementprüfung ein oder aus. | Wenn aktiviert, werden wählbare Elemente hervorgehoben und das Auswählen eines öffnet seine Bearbeitungsleiste. Das Ausschalten löscht die aktuelle Bearbeitungssitzung. |
| **Fragen Sie Runner AI**-Feld und Sendepfeil | Beschreiben Sie eine Änderung für das ausgewählte Element. | Runner erhält die Anweisung mit dem ausgewählten Element. Wenn Runner startet, löscht es die Auswahl und setzt ungespeicherte direkte Änderungen und ihre Rückgängig-/Wiederherstellen-Verlauf zurück, speichern Sie also alle ausstehenden direkten Änderungen, bevor Sie senden. |
| **Abstände** | Ändern Sie den Raum innerhalb oder um das Element. | Ein Panel öffnet sich für horizontale und vertikale Ränder und Abstände. |
| **Bild** | Ersetzen Sie ein ausgewähltes Bild oder Hintergrundbild. | Ein Panel öffnet sich mit **Hochladen** und **KI-generiert** Optionen, wenn dieses Element die Medienbearbeitung unterstützt. |
| **Text** | Ändern Sie die Typografie-Einstellungen. | Ein Panel öffnet sich für Schriftgröße, Gewicht, Familie, Farbe, Deckkraft und Ausrichtung, wenn unterstützt. |
| **Element löschen** | Entfernen Sie das ausgewählte Element aus der aktuellen Bearbeitung. | Das Element verschwindet sofort im Editor. Verwenden Sie **Rückgängig**, wenn dies versehentlich war, und überprüfen Sie vor dem Speichern. |
| **Rückgängig** | Machen Sie die neueste ungespeicherte visuelle Änderung rückgängig. | Runner geht rückwärts durch die aktuelle Design-Modus-Bearbeitungsverlauf. |
| **Wiederherstellen** | Wenden Sie eine Änderung erneut an, die Sie gerade rückgängig gemacht haben. | Runner geht vorwärts durch die aktuelle Design-Modus-Bearbeitungsverlauf. |
| **Speichern** | Behalten Sie die aktuellen visuellen Änderungen. | Runner schreibt die ausstehenden Änderungen, zeichnet einen neuen Versions-Snapshot auf, wenn möglich, löscht diese Sitzungs-Rückgängig-/Wiederherstellen-Verlauf und lädt die Vorschau neu. Die Schaltfläche ist deaktiviert, wenn es nichts zu speichern gibt. |
| **Schließen** | Verlassen Sie das dedizierte Design-Panel. | Runner kehrt zur normalen Storefront-Vorschau zurück und löscht ungespeicherte Änderungen und Befehlsverlauf. Speichern Sie zuerst, wenn Sie die Änderungen behalten möchten. |
## Nehmen Sie eine sichere visuelle Änderung vor
1. Öffnen Sie die Zielseite in der normalen Vorschau, bevor Sie den Designmodus aktivieren.
2. Öffnen Sie den Designmodus und wählen Sie ein Element.
3. Wählen Sie einen Weg für diese Änderung: - Nutzen Sie für eine direkte Bearbeitung **Abstand**, **Bild**, **Text** oder **Element löschen**, prüfen Sie das Ergebnis mit **Rückgängig** oder **Wiederholen** und wählen Sie **Speichern**. - Speichern Sie für eine KI-Anfrage zunächst alle ausstehenden direkten Änderungen, wählen Sie bei Bedarf das Element erneut, geben Sie die Anweisung unter **Runner fragen** ein und senden Sie sie. Beim Start von Runner werden die Auswahl und der ungespeicherte Verlauf direkter Änderungen gelöscht.
4. Warten Sie, bis die gewählte Speicherung oder Runner-Anfrage abgeschlossen ist, und prüfen Sie die Seite in der normalen Vorschau.
5. Prüfen Sie die Seite erneut in den Ansichten **PC**, **Tablet** und **Telefon**. Bestätigen Sie nach dem Neuladen der Vorschau, dass gespeicherte Überschrift, Bild oder Abstand erhalten geblieben sind.
6. Veröffentlichen Sie erst, nachdem die gespeicherte Vorschau Ihre Prüfung bestanden hat.
## Zustände, Limits und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Design-Modus wird gestartet…** | Runner bereitet die bearbeitbare Vorschau vor. | Behalten Sie die neueste Version ausgewählt. |
| **Design-Modus ist nicht gestartet** | Die bearbeitbare Vorschau wurde nicht bereit. | Wählen Sie **Erneut versuchen**. Wenn es sich wiederholt, kehren Sie zur normalen Vorschau zurück und aktualisieren Sie. |
| **Iframe wird noch geladen** | Die Elementprüfung ist noch nicht bereit. | Warten Sie, bis die Storefront vollständig geladen ist. |
| **Sobald Runner fertig ist, können Sie wieder visuell bearbeiten.** | Runner bearbeitet eine andere Anfrage. | Warten Sie auf deren Abschluss und wählen Sie das Element erneut. |
| Runner startet nach einer **Fragen Sie Runner AI**-Anfrage | Der visuelle Editor wird für die neue Aufgabe zurückgesetzt. | Alle ungespeicherten direkten Änderungen und ihr Rückgängig-/Wiederherstellen-Verlauf werden verworfen. Speichern Sie direkte Änderungen, bevor Sie die Anfrage senden. |
| **KI-Bearbeitung nicht verfügbar für dynamischen Inhalt** | Der ausgewählte Inhalt kann durch dieses Steuerelement nicht geändert werden. | Beschreiben Sie die Seite und das gewünschte Ergebnis im regulären Runner-Chat. |
| **Nichts zum Rückgängigmachen / Wiederherstellen / Speichern** | Die aktuelle Design-Modus-Sitzung hat keine entsprechende Aktion. | Wählen Sie ein bearbeitbares Element aus und nehmen Sie zuerst eine Änderung vor. |
| **Änderungen an Quelldateien gespeichert** | Runner hat das Design-Modus-Speichern abgeschlossen. | Warten Sie, bis die Vorschau neu geladen wird, überprüfen Sie dann die geänderte Seite erneut. |
| **Ihre Designänderungen konnten nicht gespeichert werden** | Runner konnte eine oder mehrere Änderungen nicht in die Dateien Ihres Shops schreiben. Diese Änderungen bleiben im Editor, und **Speichern** bleibt verfügbar. Bereits gespeicherte Änderungen bleiben gespeichert. | Wählen Sie erneut **Speichern**. Wenn es weiterhin fehlschlägt, machen Sie diese Änderung rückgängig oder beschreiben Sie die Änderung im Runner-Chat. |
| Die Änderung wird gespeichert, aber nicht live | Das Speichern von Änderungen aktualisiert das Projekt, nicht das veröffentlichte Storefront. | Überprüfen Sie die aktuelle Version, wählen Sie dann **Änderungen veröffentlichen**. |
## Verwandte Leitfäden
- [Bearbeiten Sie Inhalte, Seiten und Medien](./edit-content-pages-and-media)
- [Vorschau Ihres Stores](./preview-your-store)
- [Verwenden Sie den Versionsverlauf](./version-history)
---
# Inhalte, Seiten und Medien bearbeiten
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/edit-content-pages-and-media
**Eingabepfad:** Workspace → Store auswählen → **Onlineshop** → Ziel-Storefront-Seite öffnen → **Design-Modus** → Element auswählen
## Was dieser Leitfaden abdeckt
Öffnen Sie die genaue Storefront-Seite, die Sie ändern möchten, bearbeiten Sie ein unterstütztes Text-, Layout- oder Medienelement, und überprüfen Sie das gespeicherte Ergebnis vor der Veröffentlichung.
## Warum und wann Sie diesen Workflow verwenden
Verwenden Sie diesen Workflow für Seiten-Feinschliff: Korrigieren Sie Text, ändern Sie Typografie, passen Sie Abstände an, ersetzen Sie ein Foto, generieren Sie ein alternatives Bild, oder entfernen Sie ein unnötiges Element. Dies hält die Zielseite und das ausgewählte Element klar.
Für Änderungen am Navigationsverhalten, Produktdaten, Checkout oder mehreren Seiten gleichzeitig senden Sie stattdessen eine reguläre Anfrage an Runner, anstatt sich nur auf die visuellen Steuerelemente zu verlassen.
## Verfügbarkeit und Voraussetzungen
- [Design-Modus verwenden](./design-mode) beschreibt, wie Sie den Editor öffnen, die Anforderung an das Desktop-Layout und wann das Steuerelement nicht verfügbar ist.
- Einige generierte oder dynamische Elemente können nicht inline bearbeitet werden. Runner zeigt weniger Steuerelemente für diese Elemente.
- Die KI-Bildgenerierung kann Credits verwenden. Runner zeigt den anwendbaren Hinweis im Bildbereich an, bevor Sie sie ausführen.
## Öffnen Sie die Seite und den Editor
1. Öffnen Sie Ihr Projekt und wählen Sie **Onlineshop**.
2. Wählen Sie in der normalen Vorschau Storefront-Links aus, um die gewünschte Seite zu erreichen.
3. Wenn Sie die Route kennen, wählen Sie das Pfadfeld, geben Sie einen Same-Site-Pfad wie `/about` ein, und drücken Sie **Enter**.
4. Bestätigen Sie, dass die richtige Seite sichtbar ist.
5. Wählen Sie **Design-Modus** und dann das Zielelement.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wählen Sie in dieser Ansicht zunächst das Zielelement. Bildspezifische Steuerelemente erscheinen erst nach der Auswahl unterstützter Medien; hier wird weder ein Austausch noch eine Speicherung gezeigt.
## Mediensteuerelemente
[Design-Modus verwenden](./design-mode) dokumentiert die gemeinsamen Steuerelemente **Fragen Sie Runner AI**, **Spacing**, **Text**, **Delete Element**, **Rückgängig**, **Wiederherstellen** und **Speichern**. Die folgenden Steuerelemente erscheinen nur, wenn das ausgewählte Element Medien unterstützt.
| Steuerelement | Was es ändert | Was passiert, wenn Sie es verwenden |
| --- | --- | --- |
| **Image → Upload** | Ein ausgewähltes Bild oder unterstütztes Hintergrundbild. | Wählen Sie **Bild hochladen**, wählen Sie eine Bilddatei, und Runner ersetzt das ausgewählte Medium nach erfolgreichem Upload. Das aktuelle Limit, das vom Produkt angezeigt wird, beträgt 5 MB pro Bild. |
| **Image → AI-generated** | Ein generiertes Ersatzbild. | Geben Sie eine Eingabeaufforderung ein und wählen Sie **Ausführen**. Nach dem ersten Ergebnis fordert **Erneut ausführen** ein weiteres Ergebnis an und **Verlauf** öffnet Ergebnisse aus dieser Bearbeitungssitzung. |
| **Verlauf** | Generierte Bilder aus der aktuellen Bildbearbeitungssitzung. | Wählen Sie ein Element aus, um es zu überprüfen. **Diese Version wiederherstellen** wendet dieses Bild und seine Eingabeaufforderung an; das Download-Symbol lädt ein einzelnes Ergebnis herunter. |
## Bearbeiten Sie eine Seite sicher
1. Notieren Sie den aktuellen Seitenpfad, damit Sie zu ihm zurückkehren können.
2. Wählen Sie das Element aus und überprüfen Sie, welche Steuerelemente angezeigt werden. Die Steuerelemente variieren je nach Element.
3. Nehmen Sie jeweils eine Änderung vor, und verwenden Sie dann **Rückgängig**, **Wiederherstellen** oder den Bild-**Verlauf**, um das Ergebnis zu vergleichen, bevor Sie **Speichern** wählen.
4. Warten Sie, bis die gewählte Speicherung oder Runner-Anfrage abgeschlossen ist.
5. Schließen Sie den Designmodus und öffnen Sie dieselbe Seite erneut. Prüfen Sie nach dem Neuladen, ob das neue Bild oder der Inhalt erhalten geblieben ist, und kontrollieren Sie anschließend **PC**, **Tablet** und **Telefon**.
6. Wiederholen Sie dies für die nächste Seite erst, nachdem die erste Seite korrekt ist.
## Zustände, Limits und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Ein ausgewähltes Element hat nur einige Steuerelemente | Runner zeigt Steuerelemente an, die von diesem Element unterstützt werden. | Verwenden Sie das verfügbare Steuerelement oder fragen Sie Runner im Chat nach einer umfassenderen Änderung. |
| Upload abgelehnt | Die Datei fehlt, ist kein Bild, überschreitet das angezeigte Limit, oder der Upload ist fehlgeschlagen. | Wählen Sie ein anderes Bild und versuchen Sie es erneut. |
| **Wird generiert…** | Runner erstellt das angeforderte Bild. | Halten Sie das Panel offen, bis es fertig ist oder einen Fehler meldet. |
| **Verlauf** fehlt | In dieser Bearbeitungssitzung existiert noch kein KI-generiertes Bild. | Generieren Sie das erste Bild, oder laden Sie stattdessen Ihr eigenes hoch. |
| Die Route wird nicht geöffnet | Der Pfad ist ungültig, extern oder nicht Teil der Vorschau. | Kehren Sie zu `/` zurück, verwenden Sie einen sichtbaren Storefront-Link, oder bitten Sie Runner, die Seite zu erstellen oder zu reparieren. |
| Die gespeicherte Seite unterscheidet sich auf Mobilgeräten | Die Bearbeitung hat ein responsives Layout beeinflusst. | Öffnen Sie den Design-Modus erneut oder bitten Sie Runner um eine gerätespezifische Korrektur vor der Veröffentlichung. |
## Verwandte Leitfäden
- [Design-Modus verwenden](./design-mode)
- [Shop in der Vorschau prüfen](./preview-your-store)
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
---
# Storefront-Code überprüfen und bearbeiten
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/inspect-and-edit-code
Der Code-Editor ermöglicht es Ihnen, die Storefront-Dateien hinter der aktuellen Vorschau zu überprüfen oder eine fokussierte Änderung vorzunehmen. Verwenden Sie ihn nur, wenn eine visuelle Bearbeitung oder Runner-Anfrage nicht die bessere Lösung ist.
## Was dieser Leitfaden abdeckt
Öffnen Sie den bedingten Code-Editor, speichern Sie eine fokussierte Dateiänderung, kehren Sie zur Vorschau zurück, um sie zu überprüfen, und halten Sie Commit, Push und Veröffentlichung als separate bewusste Aktionen.
## Eingabepfad
Öffnen Sie ein Store-Projekt → **Onlineshop** → **Code-Editor öffnen**.
## Bevor Sie beginnen
- Warten Sie, bis der Projekt-Workspace und die Storefront-Vorschau verbunden sind.
- Verwenden Sie den Code-Editor nur, wenn Sie die Datei verstehen, die Sie ändern möchten.
- Speichern Sie jede geänderte Datei, bevor Sie ihre Registerkarte oder das Dialogfeld schließen. Das Schließen einer nicht gespeicherten Datei zeigt keine Bestätigung.
- Eine gespeicherte Datei ändert den Projekt-Workspace, wird aber nicht automatisch committed, gepusht, veröffentlicht oder in der Vorschau als korrekt erwiesen.
- Verwenden Sie **Committen** und **Pushen** nur, wenn Sie berechtigt sind, das konfigurierte Git-Remote des Projekts zu ändern.
## Editor-Steuerelemente und Klickergebnisse
| Steuerelement oder Zustand | Was passiert, nachdem Sie es verwenden |
| --- | --- |
| **Code-Editor öffnen** | Öffnet das Dialogfeld **Code-Editor** in voller Höhe. Das Schließen des Dialogfelds gibt das Storefront-Panel zur Vorschau zurück. |
| Dateisymbol | Zeigt den durchsuchbaren Storefront-Dateibaum. Das Erweitern eines Ordners lädt seinen Inhalt; das Auswählen einer Datei öffnet sie in einer Registerkarte. |
| Datei-Registerkarte | Wechselt den Editor zu dieser offenen Datei. Ein orangefarbener Punkt bedeutet, dass die Registerkarte nicht gespeicherte Änderungen enthält. |
| Schließen-Symbol auf einer Datei-Registerkarte | Schließt diese Registerkarte. Runner fragt nicht nach nicht gespeicherten Änderungen, also speichern Sie zuerst. |
| Code-Editor | Ermöglicht es Ihnen, die aktive Datei zu ändern. Das Eingeben ändert die offene Registerkarte, speichert die Datei aber nicht automatisch. |
| **Command-S** auf macOS oder **Control-S** auf Windows/Linux | Speichert die aktive Datei im verbundenen Projekt-Workspace. Der orangefarbene nicht gespeicherte Indikator wird nach erfolgreicher Speicherung gelöscht. |
| Git-Branch-Symbol | Öffnet den aktuellen Branch, geänderte Dateilisten, Commit-Formular und Push-Steuerelemente. Das Auswählen einer geänderten Datei öffnet ihren Diff. |
| **Stage** / **Unstage** | Fügt eine Datei zum nächsten Commit hinzu oder entfernt sie. Es speichert keine nicht gespeicherte Editor-Registerkarte. |
| **Alle bereitstellen** / **Alle zurücknehmen** | Wendet die gleiche Staging-Auswahl auf jede Datei in der entsprechenden Liste an. Überprüfen Sie die Liste vor der Verwendung einer dieser Aktionen. |
| **Commit-Nachricht** | Zeichnet die Erklärung auf, die dem nächsten Commit beigefügt wird. |
| **Committen** | Erstellt einen Commit aus gestaffelten Dateien, wenn die Nachricht nicht leer ist. Nicht gestaffelte und nicht gespeicherte Änderungen bleiben außerhalb dieses Commits. |
| **Pushen** | Sendet sofort Commits, die dem konfigurierten Remote voraus sind. Es gibt keine zweite Bestätigung in diesem Panel. |
| **Aktualisieren** | Fordert den neuesten Git-Status für den verbundenen Projekt-Workspace an. |
## Nehmen Sie eine fokussierte Bearbeitung vor und überprüfen Sie sie
1. Bestätigen Sie den Projektnamen und die aktuelle Storefront in der Vorschau.
2. Wählen Sie **Code-Editor öffnen**.
3. Halten Sie die Dateiansicht offen, erweitern Sie den erforderlichen Ordner, und wählen Sie eine Datei aus.
4. Lesen Sie den vorhandenen Inhalt, bevor Sie ihn ändern.
5. Nehmen Sie die kleinste beabsichtigte Bearbeitung vor.
6. Drücken Sie **Command-S** oder **Control-S** und bestätigen Sie, dass der orangefarbene Punkt verschwindet.
7. Öffnen Sie die Datei erneut, um den gespeicherten Inhalt zu bestätigen. Schließen Sie dann den Codeeditor und prüfen Sie die betroffene Seite in der Vorschau.
8. Überprüfen Sie Desktop- und Mobile-Layouts, wenn die Änderung eines von beiden beeinflussen kann.
9. Wenn das Ergebnis falsch ist, kehren Sie zum Editor zurück und korrigieren Sie es, oder bitten Sie Runner, die spezifische Datei und das sichtbare Problem zu reparieren.
Das Speichern beweist nur, dass Runner die Datei geschrieben hat. Die Vorschau beweist nur, dass das aktuelle Projekt sie anzeigen kann. Die Veröffentlichung und die Live-Customer-Journey bleiben separate Überprüfungen.
## Committen und pushen Sie nur bei Bedarf
1. Speichern Sie jede Datei, die Sie einbeziehen möchten.
2. Öffnen Sie die Git-Branch-Ansicht.
3. Wählen Sie jede geänderte Datei aus und überprüfen Sie ihren Diff.
4. Verwenden Sie **Stage** für die beabsichtigten Dateien. Vermeiden Sie **Alle bereitstellen**, wenn nicht verwandte Änderungen vorhanden sind.
5. Geben Sie eine klare **Commit-Nachricht** ein.
6. Wählen Sie **Committen** und warten Sie, bis sich der Git-Status aktualisiert.
7. Verwenden Sie **Pushen** nur nach Bestätigung des Branch- und Remote-Workflows. Die Aktion startet sofort.
8. Kehren Sie zur Vorschau zurück und überprüfen Sie das sichtbare Ergebnis. Ein erfolgreicher Commit oder Push veröffentlicht den Storefront nicht.
## Fehlerbehebung
| Zustand | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Code-Editor öffnen** fehlt | Die Funktion ist für dieses Projekt nicht aktiviert. | Verwenden Sie den Design-Modus oder bitten Sie Runner, die Änderung vorzunehmen. Verlassen Sie sich nicht auf eine kopierte interne Route. |
| **Verbindung zur Sandbox...** | Der Projekt-Workspace ist noch nicht verbunden. | Halten Sie das Projekt offen und versuchen Sie es erneut, nachdem sich der Workspace erneut verbunden hat. |
| Dateibaum-Spinner | Runner lädt den aktuellen Ordner. | Warten Sie, bevor Sie einen anderen Ordner wiederholt auswählen. |
| Das Auswählen einer Datei hat keine Auswirkung | Die Datei konnte nicht gelesen werden oder der Workspace wurde getrennt. | Überprüfen Sie die Verbindung und wählen Sie die Datei erneut aus. |
| Orangefarbener Punkt bleibt nach dem Speichern | Die Datei wurde nicht erfolgreich gespeichert. | Halten Sie die Registerkarte offen, lesen Sie die Fehlermeldung, und versuchen Sie es erneut, nachdem Sie sich bei Bedarf erneut verbunden haben. |
| **Datei aus dem Baum öffnen** | Keine Datei ist aktiv. | Wählen Sie eine Datei in der Dateiansicht aus. |
| **Keine Änderungen** | Git meldet keine gespeicherten Dateiänderungen. | Speichern Sie die Editor-Registerkarte und wählen Sie dann **Aktualisieren**. |
| **Committen** ist deaktiviert | Keine gestaffelte Datei oder keine Commit-Nachricht vorhanden. | Stellen Sie die beabsichtigte gespeicherte Datei bereit und geben Sie eine Nachricht ein. |
| **Pushen** ist deaktiviert | Der Branch hat keinen lokalen Commit vor dem Remote, oder ein Push wird ausgeführt. | Committen Sie die beabsichtigte Änderung oder warten Sie auf den aktuellen Push. |
| **Git-Status konnte nicht geladen werden** | Runner konnte den Repository-Status nicht lesen. | Wählen Sie **Erneut versuchen**. Stellen Sie nicht bereit oder pushen Sie nicht, bis sich der Status lädt. |
| Der Pfeil-nach-unten-Zähler zeigt, dass der Branch hinter liegt | Das Remote enthält Commits, die nicht im Workspace vorhanden sind. | Stoppen Sie vor dem Pushen und fragen Sie den Projektbesitzer, wie Sie den Branch sicher aktualisieren. |
| Fehler beim Speichern, Stagen, Committen oder Pushen | Die Aktion wurde nicht abgeschlossen. | Behalten Sie den aktuellen Zustand bei, lesen Sie den Fehler, und versuchen Sie es erneut, nachdem Sie die Verbindung und Berechtigung überprüft haben. |
## Verwandte Leitfäden
- [Shop in der Vorschau prüfen](./preview-your-store)
- [Design-Modus verwenden](./design-mode)
- [Versionsverlauf verwenden](./version-history)
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Fehlerbehebung bei Vorschau und Veröffentlichung](./troubleshoot-preview-and-publishing)
---
# Überprüfen Sie den Live-Store und den Checkout
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/live-store-and-checkout
**Eingabepfad:** Nach einer erfolgreichen Veröffentlichung verwenden Sie die öffentliche URL oder **Shop ansehen**, wenn die Übergabe sie anbietet. Auf dem Desktop, wenn das Menü der veröffentlichten Website angezeigt wird, öffnen Sie **Onlineshop** → Menü der veröffentlichten Website → **Website ansehen**. Die aktuelle Mobile-Storefront-Symbolleiste verbirgt dieses Menü.
## Was dieser Leitfaden abdeckt
Beweisen Sie, dass ein Kunde den öffentlichen Store öffnen, ein echtes Produkt finden, eine verfügbare Option zum Warenkorb hinzufügen und einen verwendbaren Checkout erreichen kann – ohne eine erfolgreiche Veröffentlichungsmeldung als Beweis der gesamten Kundenreise zu behandeln.
## Warum und wann Sie die Live-Kundenreise überprüfen
Führen Sie diese Überprüfung nach der ersten Veröffentlichung und nach Änderungen an Produkten, Navigation, Preisgestaltung, Bestand, Versand, Zahlungen oder Checkout durch. Die vier Ergebnisse sind unabhängig:
1. der Storefront kann öffentlich sein;
2. der beabsichtigte Katalog kann fehlen oder veraltet sein;
3. der Warenkorb kann fehlschlagen, auch wenn eine Produktseite geladen wird; und
4. der Checkout kann pausiert sein, auch wenn der Storefront live ist.
## Verfügbarkeit und Voraussetzungen
- Eine abgeschlossene Veröffentlichung muss eine öffentliche URL bereitstellen.
- Mindestens ein beabsichtigtes Produkt sollte aktiv, sichtbar, bepreist und für die Region verfügbar sein, die Sie testen.
- Die Versand- oder Liefereinrichtung muss das Testziel abdecken, falls erforderlich.
- Für einen nativen Runner-Shop muss Stripe verbunden sein, wenn Kunden bezahlen sollen. Shopify-Shops verwenden den Shopify-Checkout und dessen Zahlungseinrichtung.
- Schließen Sie keinen echten Kauf ab, es sei denn, Sie möchten diese Bestellung absichtlich aufgeben und verstehen die Auswirkungen auf Gebühren und Erfüllung.
## Öffnen Sie den Live-Store
Verwenden Sie einen dieser Pfade:
1. Wählen Sie nach der Veröffentlichung **Shop ansehen** in der Übergabe; oder
2. Wählen Sie auf dem Desktop, wenn angezeigt, das Menü der veröffentlichten Website in **Onlineshop** und dann **Website ansehen**; oder
3. Öffnen Sie in der Seitenleiste **Einstellungen → Store: _Store-Name_ → Domain** und wählen Sie die veröffentlichte Adresse. Das funktioniert auch auf Mobilgeräten, wenn das Storefront-Menü ausgeblendet ist.
Das Desktop-Menü der veröffentlichten Website bietet auch **URL kopieren**, wenn angezeigt, damit Sie die gleiche Adresse in einer anderen Browser-Sitzung testen können.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Öffnen Sie nach der Veröffentlichung das Dropdown neben **Änderungen veröffentlichen**: 1. Menü der veröffentlichten Website. 2. **Website ansehen** öffnet den Live-Store; **URL kopieren** kopiert seine Adresse. 3. **Domain-Einstellungen** öffnet die Adressverwaltung. Dieses Bild bestätigt keinen funktionierenden Checkout. Wählen Sie das Bild aus, um es zu vergrößern. Die Markierungen verwenden die englische Desktop-Oberfläche.
## Live-Store-Steuerelemente und Ergebnisse
Die folgenden Stripe-Statusangaben gelten für native Runner-Shops. Prüfen Sie bei einem verbundenen Shopify-Shop den Shopify-Checkout separat.
| Steuerelement oder Status | Was passiert |
| --- | --- |
| Veröffentlichte URL | Öffnet den öffentlichen Storefront. Bestätigen Sie, dass die Adresse die ist, die Sie teilen möchten. |
| **Shop ansehen** / **Website ansehen** | Öffnet die öffentliche URL in einer neuen Registerkarte. Dies unterscheidet sich von **In neuem Tab öffnen** in der Vorschau. |
| **Kopieren** / **URL kopieren** | Kopiert die öffentliche URL zum Teilen oder einen unabhängigen Browser-Test. |
| **Onlineshop ist live** | Runner hat eine öffentliche Store-URL gefunden, die Kunden durchsuchen und teilen können. Es bestätigt nicht den Checkout. |
| **Checkout wird geprüft** | Runner überprüft, ob der Store Zahlungen akzeptieren kann. |
| **Checkout ist aktiv** | Runner hat eine aktivierte Stripe-Verbindung gefunden. Es testet nicht das ausgewählte Produkt, Versandziel, Checkout-Felder oder Zahlungsschritt; überprüfen Sie diese separat. |
| **Checkout pausiert** | Der öffentliche Storefront ist durchsuchbar, aber Zahlungen sind nicht verfügbar, bis Stripe verbunden ist. |
| **Checkout-Status nicht verfügbar** | Runner konnte den Zahlungsstatus nicht bestimmen. Wählen Sie **Checkout-Status erneut prüfen**, bevor Sie behaupten, dass der Checkout bereit ist. |
| **Stripe verbinden** | Öffnet den Zahlungsverbindungspfad. Nur ein berechtigter Workspace-Besitzer oder Admin kann ihn abschließen. |
| **Vorerst überspringen** | Schließt die Eingabeaufforderung, ohne Zahlungen zu aktivieren. |
## Testen Sie die Kundenreise
1. Öffnen Sie die öffentliche URL in einer neuen Registerkarte. Verwenden Sie für eine stärkere Überprüfung eine abgemeldete oder private Browsing-Sitzung.
2. Bestätigen Sie, dass die erwartete Startseite ohne Runner-Projektsteuerelemente geladen wird.
3. Folgen Sie der öffentlichen Navigation zu einer Kollektion oder Produktseite.
4. Bestätigen Sie, dass das beabsichtigte Produkt mit dem korrekten Titel, den Medien, dem Preis und den verfügbaren Optionen sichtbar ist.
5. Wählen Sie eine erforderliche Option, z. B. Größe oder Farbe.
6. Wählen Sie das Steuerelement zum Hinzufügen zum Warenkorb des Storefronts und bestätigen Sie, dass sich die Warenkorbanzahl oder der Warenkorbinhalt ändert.
7. Öffnen Sie den Warenkorb. Bestätigen Sie, dass Produkt, Option, Menge, Preis und Summen dem entsprechen, was Sie ausgewählt haben.
8. Starten Sie den Checkout und bestätigen Sie, dass die Checkout-Seite die erforderlichen Kunden- und Lieferinformationen akzeptiert.
9. Bestätigen Sie, dass der Zahlungsschritt verfügbar ist, wenn Runner **Checkout ist aktiv** meldet.
10. Stoppen Sie vor der endgültigen Kaufaktion, es sei denn, eine echte Testbestellung ist autorisiert.
11. Wiederholen Sie die wichtigsten Schritte zum Durchsuchen und für den Warenkorb auf einem telefongroßen Viewport oder echten mobilen Browser.
## Zeichnen Sie jedes Ergebnis separat auf
| Überprüfung | Bestandsbedingung |
| --- | --- |
| Öffentliche URL | Wird ohne Zugangstor oder fehlenden Seitenzustand geöffnet. |
| Navigation | Wichtige Links erreichen die beabsichtigten öffentlichen Seiten. |
| Katalog | Das beabsichtigte Live-Produkt und seine aktuellen Daten sind sichtbar. |
| Warenkorb | Das Hinzufügen einer verfügbaren Option erzeugt den korrekten Warenkorbzustand. |
| Versand | Das beabsichtigte Ziel hat einen erwarteten Lieferpfad, falls zutreffend. |
| Checkout | Der gewünschte Checkout erreicht den Zahlungsschritt. Der Zahlungsstatus des nativen Runner-Shops oder die Shopify-Einrichtung bestätigt außerdem einen aktivierten Anbieter. |
| Mobilgerät | Wichtige Inhalte und Kaufsteuerelemente bleiben auf einem kleinen Bildschirm verwendbar. |
## Zustände, Limits und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Vorschau funktioniert, aber öffentliche URL schlägt fehl | Vorschau und Veröffentlichung sind unterschiedliche Umgebungen oder Versionen. | Kehren Sie zu Runner zurück, überprüfen Sie den Veröffentlichungsstatus, und verwenden Sie **Erneut veröffentlichen** nur nach Behebung des genannten Problems. |
| Öffentliche Website lädt, aber Produkt fehlt | Der Storefront ist live, aber der beabsichtigte Katalog ist dort nicht sichtbar. | Überprüfen Sie Produktstatus, Markt, Bestand und ob die neuesten Änderungen veröffentlicht wurden. |
| Zum Warenkorb hinzufügen fehlt oder ist deaktiviert | Das ausgewählte Produkt oder die Option kann in diesem Kontext nicht verkauft werden. | Überprüfen Sie Verfügbarkeit, Optionen, Preis, Bestand und Markteinrichtung im Shop-Betrieb. |
| **Checkout pausiert** | Zahlungen sind nicht verbunden. | Wählen Sie **Stripe verbinden**; bewerben Sie den Store noch nicht als bereit für Bestellungen. |
| **Checkout-Status nicht verfügbar** | Runner kann den Zahlungsstatus nicht bestätigen. | Wählen Sie **Checkout-Status erneut prüfen** und öffnen Sie unabhängig den Checkout-Pfad. |
| Der Checkout wird geöffnet, kann aber nicht fortgesetzt werden | Produkt-, Versand-, Markt-, Kundenfeld- oder Zahlungseinrichtung kann unvollständig sein. | Zeichnen Sie den genauen Schritt und die Nachricht auf, beheben Sie diese Einrichtung, veröffentlichen Sie Änderungen bei Bedarf, und testen Sie erneut von der öffentlichen URL. |
## Verwandte Leitfäden
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Veröffentlichung vorbereiten](./prepare-to-publish)
- [Fehlerbehebung bei Vorschau und Veröffentlichung](./troubleshoot-preview-and-publishing)
---
# Veröffentlichung vorbereiten
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/prepare-to-publish
**Zugriffspfad:** Arbeitsbereich → Shop auswählen → **Onlineshop** → **Veröffentlichen**, **Änderungen veröffentlichen** oder **Erneut veröffentlichen** (je nach Veröffentlichungsstatus) → **Bereitstellung bestätigen**
Wenn bedingte Konversationsversionskarten aktiviert sind, öffnet **Veröffentlichen** auf einer unveröffentlichten **Aktuelle Version**-Arbeitskarte die gleichen Veröffentlichungsprüfungen. Historische Versionskarten werden nicht direkt veröffentlicht.
## Was dieser Leitfaden abdeckt
Erreichen Sie eine erfolgreiche Veröffentlichungsprüfung mit den Shop-Daten, mit denen Sie starten möchten, oder treffen Sie eine informierte Entscheidung über unvollständige Einrichtungen, die Runner Sie bestätigen möchte.
## Warum und wann vorbereiten
Verwenden Sie diese Checkliste vor der ersten **Veröffentlichung** und vor wichtigen **Änderungen veröffentlichen**. Dies verringert das Risiko, eine polierte Seite ohne verkäufliches Produkt, unvollständigen Versand, unterbrochene Zahlungen oder einen fehlgeschlagenen Build zu starten.
Runner kann Sie manchmal nach Bestätigung unvollständiger Einrichtung veröffentlichen lassen. Das ist eine absichtliche Ausnahme, kein Beweis dafür, dass der Speicher bereit ist, Bestellungen anzunehmen.
Die genauen Prüfungen und Übergaben hängen von der für den Workspace aktivierten Veröffentlichungserfahrung ab. Einige Workspaces zeigen vor der Veröffentlichung eine Zahlungswarnung und danach nur einen Erfolgs-Toast; andere zeigen vor der Veröffentlichung Prüfungen im Shop-Betrieb und danach den Checkout-Status. Folgen Sie den Beschriftungen, die in Ihrem Flow angezeigt werden.
## Verfügbarkeit und Voraussetzungen
- Sie benötigen ein Projekt mit einer bereiten Storefront-Vorschau.
- Die Veröffentlichung hängt von der Tarifberechtigung und dem Projektzugriff ab. Falls Runner einen anderen Tarif verlangt, vergleichen Sie die [öffentlichen Tarife](https://www.runnerai.com/pricing) und wählen Sie einen berechtigten Tarif, bevor Sie zu diesem Ablauf zurückkehren.
- Der Storefront-Workspace muss verbunden sein und Runner muss untätig sein.
- Die Speicherbereitschaft variiert je nach Geschäft. Runner kann Speichergrunddaten, Produkte, Versand- oder Lagerdetails, Zahlungsverbindung, erkannte Änderungen und ob der Storefront erstellt wird, überprüfen.
## Öffnen Sie den Bereitschaftsfluss
1. Öffnen Sie Ihr Projekt und wählen Sie **Onlineshop**.
2. Überprüfen Sie die neueste **Aktuelle** Version.
3. Wählen Sie **Veröffentlichen**, **Änderungen veröffentlichen** oder **Erneut veröffentlichen**, je nach angezeigter Beschriftung.
4. Runner prüft den Zugriff, aktualisiert erkannte Änderungen und Einrichtungsstatus und öffnet dann **Bereitstellung bestätigen**.
## Vorbereitungssteuerelemente
| Steuerelement | Wann es angezeigt wird | Was passiert, wenn Sie es auswählen |
| --- | --- | --- |
| **Shop-Betrieb öffnen** | Die Bestätigung besagt, dass die Shop-Einrichtung unvollständig ist. | Runner schließt die Bestätigung und öffnet den Shop-Betrieb. |
| **Einrichtungsstatus erneut versuchen** | Runner konnte den Shop-Betrieb nicht überprüfen. | Runner überprüft den Einrichtungsstatus erneut. |
| **Prüfung erneut versuchen** | Runner konnte den Storefront-Workspace nicht erreichen. | Runner führt die Veröffentlichungs-Build-Prüfung erneut aus. |
| **Mit KI beheben** | Die Storefront-Build-Prüfung schlägt fehl und Runner kann sie reparieren. | Runner schließt die Bestätigung und sendet den Build-Fehler zur Reparatur in die Konversation. Keine Veröffentlichung startet. |
| Warnungs-Kontrollkästchen | Je nach Veröffentlichungsablauf müssen unvollständige oder nicht verfügbare Shop-Betriebsdaten oder eine fehlende Zahlungsanbindung ausdrücklich bestätigt werden. Fehlende Änderungen bleiben blockierend und lassen sich nicht auf diese Weise übergehen. | Das Kontrollkästchen bestätigt, dass Sie das genannte Risiko verstehen; nach erfolgreicher Build-Prüfung kann dadurch **Bestätigen** aktiviert werden. |
| **Abbrechen** | Sie sind nicht bereit, fortzufahren. | Runner schließt die Bestätigung ohne Veröffentlichung. |
| **Bestätigen** | Die Build-Prüfung war erfolgreich und erforderliche Warnungen wurden gelöst oder bestätigt. | Runner startet die Veröffentlichung. Die Schaltfläche bleibt deaktiviert, während Prüfungen unvollständig sind oder Runner arbeitet. |
## Vervollständigen Sie die Startcheckliste
1. Überprüfen Sie in der Vorschau die Startseite, Navigation, Produktseite, Warenkorbeingang und Telefon-Layout.
2. Öffnen Sie den Shop-Betrieb und bestätigen Sie, dass die dort angezeigten Geschäfts- und Shop-Daten korrekt sind.
3. Bestätigen Sie, dass mindestens ein beabsichtigtes Produkt sichtbar, verkäuflich ist und den korrekten Preis, die Optionen und Medien verwendet.
4. Bestätigen Sie den Lagerort und die Versandeinrichtung, die für dieses Produkt erforderlich sind.
5. Entscheiden Sie, ob der Checkout beim Start Zahlungen annehmen muss. Verbinden Sie bei einem nativen Runner-Shop Stripe, falls Zahlungen möglich sein sollen. Bei Shopify-Shops bleibt der Checkout in Shopify; prüfen Sie dessen Zahlungseinrichtung. Manche Arbeitsbereiche zeigen die Warnung vor der Veröffentlichung, andere den Checkout-Status danach. Beides ersetzt keinen Checkout-Test.
6. Kehren Sie zu **Onlineshop** zurück und wählen Sie die Veröffentlichungsschaltfläche.
7. Warten Sie auf **Ihr Speicher ist bereit zur Veröffentlichung!**
8. Beheben Sie jede Warnung. Verwenden Sie eine Bestätigung nur, wenn Sie die genaue Kundenauswirkung akzeptieren.
9. Wenn Sie nur die Voraussetzungen prüfen wollten, wählen Sie **Abbrechen**. Wählen Sie **Bestätigen** nur, wenn Sie diese Version online stellen möchten.
10. Überprüfen Sie nach der Veröffentlichung den Live-Storefront, Katalog, Warenkorb und Checkout separat.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Der Build ist in diesem Beispiel erfolgreich, aber die Shopeinrichtung muss noch ergänzt werden. Eine Bestätigung erledigt diese Einrichtung nicht.
### Video: Prüfungen ansehen und abbrechen
Die Aufzeichnung zeigt das Build-Ergebnis und die Einrichtungswarnung und wählt anschließend **Abbrechen**. Der Beispielshop wird nicht veröffentlicht.
## Bereitschaftszustände und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Überprüfung, ob Ihr Speicher bereit zur Veröffentlichung ist…** | Runner überprüft den aktuellen Storefront-Build. | Warten Sie auf Erfolg oder einen benannten Fehler. |
| **Ihr Speicher ist bereit zur Veröffentlichung!** | Die Build-Prüfung war erfolgreich. | Beheben Sie Warnungen und wählen Sie dann **Bestätigen**. |
| **Ihr Shop lässt sich noch nicht erstellen und kann daher nicht live gehen. Lassen Sie Runner die Fehler beheben und veröffentlichen Sie dann.** | Die Storefront kann in ihrer aktuellen Form nicht veröffentlicht werden. | Wählen Sie **Mit KI beheben**, prüfen Sie die Korrektur und starten Sie die Prüfung der Voraussetzungen erneut. |
| **Wir konnten Ihren Workspace nicht erreichen. Wiederholen Sie die Prüfung, um fortzufahren.** | Die Prüfung konnte nicht auf den aktuellen Arbeitsbereich zugreifen. | Wählen Sie **Prüfung wiederholen**. Tritt das Problem erneut auf, verbinden Sie den Arbeitsbereich neu. |
| **Nehmen Sie vor dem Veröffentlichen eine sichtbare Änderung an Ihrem Onlineshop vor.** | Runner hat seit der letzten Veröffentlichung keine Änderung gefunden. | Brechen Sie ab und nehmen Sie die gewünschte Storefront-Änderung vor. **Bestätigen** bleibt deaktiviert, solange keine Änderungen zu veröffentlichen sind. |
| **Einige Betriebsdetails brauchen noch Ihre Aufmerksamkeit. Sie können jetzt live gehen und sie im Shop-Betrieb abschließen.** | Wichtige Betriebsdaten sind noch unvollständig. | Wählen Sie **Shop-Betrieb öffnen**. Veröffentlichen Sie mit ausdrücklicher Bestätigung nur, wenn Sie die Einschränkungen akzeptieren. |
| **Der Shop-Betrieb konnte nicht geprüft werden. Versuchen Sie es erneut oder bestätigen Sie dies und veröffentlichen Sie trotzdem.** | Der Einrichtungsstatus ist nicht verfügbar; daraus folgt nicht, dass die Einrichtung abgeschlossen ist. | Wählen Sie **Einrichtungsstatus erneut prüfen**, bevor Sie eine Bestätigung erwägen. |
| **Käufer können stöbern, aber noch nicht bezahlen – verbinden Sie Stripe in den Einstellungen, um Bestellungen anzunehmen.** | In Veröffentlichungsabläufen mit dieser Warnung vor dem Start hat Runner keine aktivierte Zahlungsanbindung gefunden. | Verbinden Sie Stripe oder bestätigen Sie nur, wenn ein Start ohne Kaufmöglichkeit beabsichtigt ist. Andere Abläufe zeigen den Checkout-Status stattdessen nach der Veröffentlichung. |
## Verwandte Leitfäden
- [Vorschau Ihres Shops](./preview-your-store)
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Live-Shop und Checkout überprüfen](./live-store-and-checkout)
---
# Shop in der Vorschau prüfen
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/preview-your-store
**Einstiegspfad:** Arbeitsbereich → Shop auswählen → **Onlineshop**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
## Was dieser Leitfaden abdeckt
Überprüfen Sie die aktuelle Storefront in Runner, bewegen Sie sich zwischen ihren Seiten und überprüfen Sie, wie sie auf Desktop-, Tablet- und Telefon-Layouts aussieht, ohne sie zu veröffentlichen.
## Warum und wann Sie die Vorschau verwenden
Verwenden Sie die Vorschau, nachdem Runner die Storefront erstellt oder geändert hat. Dort finden Sie fehlende Texte, fehlerhafte Routen, mangelhafte mobile Layouts oder unvollständige Abschnitte am sichersten, bevor Kunden sie sehen.
Die Vorschau ist vom Live-Shop getrennt. Eine Seite, die hier korrekt aussieht, beweist nicht, dass die öffentliche URL, Katalogdaten, Bestand, Zahlungsverbindung oder Checkout funktionieren.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie ein Projekt mit vorhandener Storefront-Aktivität oder einer vorschaubaren Version.
- Wenn die Seite **Gestalte deine Storefront.** anzeigt, bitten Sie Runner über das Eingabefeld auf dieser Seite, die erste Version zu erstellen.
- Wenn **Die erste Version Ihres Onlineshops wird erstellt…** oder **Vorschau wird vorbereitet …** angezeigt wird, ist die Vorschau noch nicht bereit.
- Einige Workspaces verwenden die neuere Checkpoint-basierte Storefront. Die genauen Versionsteuerelemente können mit gestaffelter Verfügbarkeit variieren.
Wenn bedingte Versionskarten für Unterhaltungen aktiviert sind, öffnet die Auswahl des Storefront-Bildes oder von **Vorschau** auf einer abgeschlossenen Arbeitskarte genau die fertige Version dieser Aufgabe. Dabei kann es sich um eine ältere statt der neuesten Version handeln. Bei einem älteren Projekt ohne gespeicherten Versionsverlauf öffnet **Vorschau** auf der neuesten Storefront-Arbeitskarte stattdessen die aktuelle Live-Vorschau. Prüfen Sie vor einer Bearbeitung oder Veröffentlichung die verfügbaren Beschriftungen **v…**, **Aktuelle Version** und **Veröffentlicht**.
Eine abgeschlossene Aufgabe oder ein erfolgreicher Quellcode-Build bedeutet für sich genommen noch nicht, dass die Vorschau aktualisiert wurde. Runner schaltet die fertige Storefront erst nach Abschluss der Aufgabe für die Vorschau frei. Wenn diese Aktivierung fehlschlägt, zeigt die Vorschau weiterhin die zuvor erfolgreiche Version – oder keine erstellte Vorschau, wenn noch keine vorhanden ist. Prüfen Sie deshalb die sichtbare Version und das Vorschauergebnis.
## Vorschau öffnen
1. Öffnen Sie Ihren Runner-Arbeitsbereich.
2. Wählen Sie den Shop aus, den Sie prüfen möchten.
3. Wählen Sie **Onlineshop** in der Projektnavigation.
4. Warten Sie, bis die aktuelle Version im Vorschaubereich angezeigt wird.
### Geräteauswahl ansehen
Diese stumme Aufzeichnung zeigt die ursprüngliche v1-Vorschau in der englischen Oberfläche. Wählen Sie **PC**, dann **Tablet** und dann **Telefon**, um den Vorschaurahmen zu ändern. Wählen Sie **Telefon** erneut, um zur Desktopansicht zurückzukehren. Die Storefront bleibt während des gesamten Beispiels unveröffentlicht.
Wenn das Projekt noch keine Storefront hat:
1. Beschreiben Sie im Eingabefeld für die Storefront das gewünschte Aussehen, Layout, die Produkte und Inhalte.
2. Wählen Sie den Sendepfeil (**Nachricht senden**) oder **Mit dem Aufbau beginnen**, falls diese Aktion in Ihrem Arbeitsbereich erscheint.
3. Runner erstellt ein Gespräch und sendet diese Beschreibung als erste Anfrage.
4. Wenn die Erstellung fehlschlägt, bleibt die Beschreibung im Feld, damit Sie es erneut versuchen können.
## Steuerelemente der Vorschau
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn Sie es auswählen |
| --- | --- | --- |
| **Zurück** | Kehren Sie zur vorherigen Seite zurück, die in der Vorschau besucht wurde. | Die Vorschau bewegt sich rückwärts in ihrem eigenen Seitenverlauf. Es verlässt nicht Ihr Runner-Projekt. |
| **Vorwärts** | Besuchen Sie eine Seite erneut, nachdem Sie zurückgegangen sind. | Die Vorschau bewegt sich vorwärts, wenn ein späterer Verlaufseintrag existiert. |
| **PC / Tablet / Telefon** | Prüfen Sie responsive Layouts. | Jede Auswahl wechselt den Vorschaurahmen zur nächsten Gerätegröße. Die Live-Storefront wird dadurch nicht geändert. |
| Pfadfeld, wie `/` | Öffnen Sie eine bekannte Storefront-Route. | Wählen Sie den Pfad, geben Sie einen anderen Pfad auf derselben Vorschau-Website ein und drücken Sie **Enter**. Ungültige oder externe Adressen werden ignoriert. |
| **Aktualisieren** | Laden Sie die aktuelle Vorschau nach einer Änderung oder einem festgefahrenen Rendering neu. | Runner lädt die sichtbare Seite neu und löscht die aktive Auswahl im Design-Modus sowie die Rückgängig-/Wiederholen-Sitzung. Speichern Sie ausstehende Designänderungen zuerst. |
| **In neuem Tab öffnen** | Überprüfen Sie die Vorschau mit mehr Platz. | Runner öffnet diese Vorschau-URL in einem anderen Browser-Tab. Dies ist immer noch eine Vorschau, kein Beweis eines veröffentlichten Stores. |
| Versionsbeschriftung, beispielsweise **v1 · Aktuell** | Erkennen Sie, welche Version Sie prüfen. | Die Beschriftung unterscheidet die neueste aktuelle Version von einer historischen Vorschau. |
| **Design-Modus** | Starten Sie die visuelle Bearbeitung. | Runner öffnet den Design-Arbeitsbereich, wenn die neueste Version dafür geeignet ist. |
| **Versionsverlauf** | Vergleichen Sie frühere Storefront-Versionen. | Runner öffnet die Versionsliste, ohne die aktuelle Storefront zu ändern. |
| **Code-Editor öffnen** | Inspizieren oder bearbeiten Sie den Storefront-Quellcode, wenn dieses erweiterte Steuerelement verfügbar ist. | Runner öffnet den **Code-Editor**-Dialog in voller Höhe. Das Schließen gibt das Storefront-Panel zur Vorschau zurück; überprüfen Sie das sichtbare Ergebnis dort. |
| Münze / **Einladen, Punkte holen** | Öffnen Sie das Empfehlungsangebot. | Runner öffnet den Empfehlungsdialog; durch das bloße Öffnen wird noch kein Credit verdient. |
| Credit-Anzahl / **Upgrade** | Überprüfen Sie Credit-, Plan- oder Nutzungsoptionen. | Runner öffnet ein Popover, dessen verfügbare Aktionen zu Workspace-Abrechnung oder -Nutzung führen können. |
| **Veröffentlichen**, **Änderungen veröffentlichen** oder **Erneut veröffentlichen** | Starten Sie den Veröffentlichungsfluss, der zum aktuellen Zustand passt. | Runner führt Zugriffs- und Bereitschaftsprüfungen durch, bevor eine Veröffentlichung beginnt. |
## Überprüfen Sie eine Storefront-Seite für Seite
1. Beginnen Sie bei `/` und scannen Sie die Kopfzeile, den Ankündigungsbereich, den Hero, die vorgestellten Produkte, Abschnitte und die Fußzeile.
2. Wählen Sie jeden sichtbaren Navigationslink. Bestätigen Sie, dass das Ziel angezeigt wird und der Vorschau-Pfad wie erwartet geändert wird.
3. Öffnen Sie eine Produktseite aus der Storefront. Bestätigen Sie, dass Titel, Medien, Preis, Optionen, Verfügbarkeit und Kaufsteuerelement sichtbar sind.
4. Verwenden Sie das Pfadfeld für wichtige Routen, die nicht von der aktuellen Seite verlinkt sind.
5. Wechseln Sie zwischen **PC**, **Tablet** und **Telefon**. Suchen Sie nach abgeschnittenen Inhalten, überlappenden Steuerelementen, unlesbarem Text und horizontalem Scrollen.
6. Wählen Sie **Aktualisieren** erst, nachdem Sie Änderungen im Design-Modus gespeichert haben.
7. Notieren Sie alle Probleme in Runner-Chat mit dem Seitenpfad, der Gerätegröße und dem erwarteten Ergebnis.
## Zustände, Grenzen und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Gestalte deine Storefront.** | Runner hat noch keine fertige Storefront zum Anzeigen. | Geben Sie eine Anfrage ein, um die erste Version zu erstellen. |
| **Erste Version wird erstellt…** | Die erste Version wird noch vorbereitet. | Folgen Sie dem Aufgabenfortschritt und warten Sie auf ein Endergebnis. |
| **Vorschau wird vorbereitet…** | Runner startet die ausgewählte Vorschau. | Halten Sie die Seite offen; verwenden Sie **Aktualisieren** nur, wenn der Zustand nicht voranschreitet. |
| **Vorschau für diese Version konnte nicht geladen werden** | Die ausgewählte Version konnte nicht angezeigt werden. | Kehren Sie zur aktuellen Version zurück, aktualisieren Sie oder melden Sie die Version und den Fehler an Runner. |
| **Vorschau wird erneut verbunden** | Runner verlor die Vorschau-Verbindung und versucht es erneut. | Halten Sie das Projekt offen und folgen Sie der Wiederholungsanzahl. Wenn es nicht wiederhergestellt werden kann, verbinden Sie den Workspace erneut. |
| Vorschau-Fehlerleiste mit **Beheben** | Die Vorschau meldete einen Fehler, den Runner inspizieren kann. | Wählen Sie **Beheben** oder **Fehler beheben**, um die angezeigte Diagnose an Runner zu senden. Verwenden Sie **Mehr anzeigen**, um Details zu erweitern und **Verwerfen**, um die Nachricht nur auszublenden. |
| Ein Steuerelement ist deaktiviert | Die Vorschau unterstützt diese Aktion derzeit nicht, der Arbeitsbereich ist getrennt oder Runner arbeitet noch. | Warten Sie auf Runner, verbinden Sie den Arbeitsbereich erneut, wenn Sie dazu aufgefordert werden, oder kehren Sie zur neuesten fertigen Version zurück. |
| Die Vorschau sieht korrekt aus, aber der Live-Shop nicht | Die Änderungen wurden nicht veröffentlicht oder Sie sehen verschiedene Versionen. | Prüfen Sie die Versionsbeschriftung und verwenden Sie dann [Änderungen veröffentlichen](./publish-and-republish). |
## Verwandte Anleitungen
- [Ihren ersten Store Schritt für Schritt erstellen](../start-here/first-store-quickstart)
- [Design-Modus verwenden](./design-mode)
- [Inhalte, Seiten und Medien bearbeiten](./edit-content-pages-and-media)
- [Storefront-Code prüfen und bearbeiten](./inspect-and-edit-code)
- [Versionsverlauf verwenden](./version-history)
- [Veröffentlichung vorbereiten](./prepare-to-publish)
---
# Veröffentlichen und erneut veröffentlichen
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/publish-and-republish
**Einstiegspfad:** Arbeitsbereich → Shop auswählen → **Onlineshop** → **Veröffentlichen**, **Änderungen veröffentlichen** oder **Erneut veröffentlichen** (die Beschriftung hängt vom Veröffentlichungsstatus ab)
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
## Was dieser Leitfaden abdeckt
Verwenden Sie die Veröffentlichungsaktion, die Runner für den aktuellen Shop-Status anzeigt. Folgen Sie dem Bestätigungsablauf bis zu einem Endergebnis und öffnen oder kopieren Sie die öffentliche URL, wenn eine verfügbar ist.
## Warum und wann veröffentlichen
Durch die Veröffentlichung wird die aktuelle Projektversion unter einer öffentlichen Shop-URL verfügbar. Verwenden Sie **Veröffentlichen** für die erste Veröffentlichung, **Änderungen veröffentlichen** für einen Shop mit einer funktionierenden öffentlichen URL und **Erneut veröffentlichen**, um eine fehlgeschlagene oder unvollständige Veröffentlichung zu wiederholen.
Das Speichern einer Bearbeitung im **Design-Modus**, das Wiederherstellen einer Version oder eine korrekte Vorschau aktualisiert den öffentlichen Shop nicht automatisch.
Der Ablauf rund um die Veröffentlichung variiert je nach Rollout des Arbeitsbereichs. Einige Arbeitsbereiche zeigen vor der Veröffentlichung eine Zahlungswarnung und danach nur eine Erfolgsmeldung. Andere zeigen vorher Prüfungen des Shop-Betriebs und öffnen nach dem Erfolg eine Checkout-Statusanzeige.
## Verfügbarkeit und Voraussetzungen
- Vervollständigen Sie die [Veröffentlichungs-Bereitschaftscheckliste](./prepare-to-publish).
- Verwenden Sie die neueste **Aktuelle** Storefront-Version.
- Warten Sie, bis Runner eine aktive Anfrage beendet.
- Verbinden Sie den Storefront-Arbeitsbereich erneut, wenn die Schaltfläche meldet, dass er nicht verfügbar ist.
- Die Veröffentlichung kann durch Ihren Plan oder die Projektberechtigung eingeschränkt werden.
- Wenn die Veröffentlichung einen höheren Plan erfordert, öffnet **Upgrade** die monatliche Plus-Bestätigung. Von dort können Sie vor dem Kauf zur vollständigen Planliste zurückkehren.
## Öffnen Sie den Veröffentlichungsfluss
1. Öffnen Sie Ihr Projekt.
2. Wählen Sie **Onlineshop**.
3. Wählen Sie die Veröffentlichungsschaltfläche auf der rechten Seite der Symbolleiste.
4. Lesen Sie **Bereitstellung bestätigen** und warten Sie auf die Build-Prüfung.
5. Beheben Sie die blockierenden Punkte. Bestätigen Sie eine Warnung nur, wenn der Dialog diese Option anbietet und Sie ihre Auswirkungen verstehen.
6. Wählen Sie **Bestätigen** nur, wenn die Schaltfläche aktiviert ist und Sie diese Version öffentlich machen möchten. Wählen Sie **Abbrechen**, um ohne Veröffentlichung zu schließen.
### Ansehen: Prüfungen ansehen, ohne zu veröffentlichen
Diese Aufnahme ohne Ton zeigt in der englischen Oberfläche das Build-Ergebnis und die verbleibende Warnung zur Einrichtung. **Abbrechen** führt zurück zur Vorschau. Eine bestandene Build-Prüfung schließt die Betriebseinrichtung des Stores nicht ab und aktiviert den Checkout nicht.
## Wählen Sie die richtige Aktion
| Beschriftung | Wann Runner sie anzeigt | Was die Auswahl bewirkt |
| --- | --- | --- |
| **Veröffentlichen** | Der Shop hat seine erste Veröffentlichung nicht abgeschlossen. | Öffnet Zugriffs-, Einrichtungs-, Änderungs- und Build-Prüfungen für die aktuelle Version. |
| **Änderungen veröffentlichen** | Eine abgeschlossene Veröffentlichung hat eine verwendbare öffentliche URL. | Öffnet dieselben Prüfungen, damit Sie die aktuelle Version im bestehenden Live-Shop veröffentlichen können. |
| **Erneut veröffentlichen** | Die letzte Veröffentlichung ist fehlgeschlagen oder wurde ohne verwendbare URL abgeschlossen. | Startet einen neuen überprüften Veröffentlichungsversuch. |
| **Wird gestartet… / Wird vorbereitet… / Build läuft… / Checkpoint wird gespeichert… / Wird veröffentlicht…** | Ein Veröffentlichungsschritt wird ausgeführt. | Die Schaltfläche ist deaktiviert und meldet den Fortschritt. Warten Sie auf Erfolg oder Fehler. |
## Veröffentlichungs- und Übergabe-Steuerelemente
| Steuerelement | Was passiert, wenn Sie es auswählen |
| --- | --- |
| **Abbrechen** in **Bereitstellung bestätigen** | Schließt den Dialog, ohne diese Version zu veröffentlichen. |
| **Mit KI beheben** | Sendet einen Build-Fehler an Runner zur Reparatur, ohne zu veröffentlichen. |
| **Prüfung wiederholen** | Führt die Build-Prüfung nach einem Zugriffsfehler des Arbeitsbereichs erneut aus. |
| **Bestätigen** | Startet die Veröffentlichung, nachdem die Build-Prüfung und erforderliche Bestätigungen abgeschlossen sind. |
| **Trotzdem veröffentlichen – ich schließe die Einrichtung später ab.**, falls angeboten | Bestätigt die aufgeführte unvollständige Einrichtung. Diese Aufgaben werden dadurch nicht erledigt und der Store wird erst veröffentlicht, wenn Sie zusätzlich Bestätigen wählen. |
| Veröffentlichte URL | Öffnet die öffentliche Storefront in einem neuen Tab. |
| **Kopieren** oder **URL kopieren** | Kopiert die öffentliche Shop-Adresse in die Zwischenablage. |
| **Shop ansehen** | Öffnet in der Checkout-Statusanzeige nach einer erfolgreichen Veröffentlichung die öffentliche Storefront. |
| **Stripe verbinden** | Startet in Abläufen mit Zahlungsstatus die Zahlungsverbindung, wenn der Checkout nicht bereit ist. Der Zugriff kann von Ihrer Rolle im Arbeitsbereich abhängen. |
| **Vorerst überspringen** | Schließt die Zahlungsaufforderung nach der Veröffentlichung, wenn sie angezeigt wird. Die Storefront kann weiterhin aufrufbar sein, während der Checkout pausiert bleibt. |
| **Checkout-Status erneut prüfen** | Prüft in der Anzeige nach der Veröffentlichung erneut, ob eine aktivierte Stripe-Verbindung vorhanden ist, wenn der Status zuvor nicht verfügbar war. |
| **Schließen** | Schließt die Checkout-Statusanzeige, wenn sie angezeigt wird und der Checkout bereits verbunden ist. |
| Menü der veröffentlichten Website | Öffnet auf dem Desktop, wenn es angezeigt wird, **Website ansehen**, **URL kopieren**, **Domain-Einstellungen** und Informationen zur letzten Veröffentlichung. |
## Veröffentlichen Sie zu einem Endergebnis
1. Bestätigen Sie, dass die Schaltflächenbeschriftung Ihrer Absicht entspricht.
2. Wählen Sie sie und warten Sie, bis die Build-Prüfung abgeschlossen ist.
3. Wenn **Mit KI beheben** angezeigt wird, verwenden Sie es, überprüfen Sie die resultierende Vorschau und starten Sie die Veröffentlichung erneut.
4. Wenn Warnungen angezeigt werden, beheben Sie die zugrunde liegende Einrichtung, sofern Checkout oder der normale Shopbetrieb wichtig sind.
5. Wählen Sie **Bestätigen**.
6. Halten Sie das Projekt offen, bis Runner Erfolg oder Fehler meldet.
7. Öffnen Sie bei Erfolg die öffentliche URL. Verwenden Sie **Shop ansehen**, wenn die Checkout-Statusanzeige erscheint. Ein anderer Rollout kann nur eine Erfolgsmeldung zeigen und danach zur Storefront zurückkehren.
8. Wenn die URL nicht verfügbar ist, schließen Sie die Anzeige und verwenden Sie **Erneut veröffentlichen**, sobald der Arbeitsbereich bereit ist.
9. Wenn die Veröffentlichung fehlschlägt, lesen Sie den Fehler, reparieren Sie ihn und wählen Sie **Erneut veröffentlichen**. Nehmen Sie nicht an, dass die versuchten Änderungen live sind.
## Veröffentlichungszustände und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Store veröffentlicht** / **Ihr Shop ist live** | Runner hat die Veröffentlichung abgeschlossen und eine öffentliche URL erhalten. | Öffnen Sie die URL und prüfen Sie den Ablauf aus Kundensicht. |
| **Veröffentlichung abgeschlossen** mit **Shop-Link nicht verfügbar** | Die Veröffentlichung wurde ohne verwendbaren Link in der Abschlussanzeige beendet. | Schließen Sie den Dialog, stellen Sie sicher, dass der Arbeitsbereich bereit ist, und verwenden Sie dann **Erneut veröffentlichen**. |
| **Veröffentlichung fehlgeschlagen – Ihr Shop ist noch nicht live** | Die Veröffentlichung wurde nicht abgeschlossen. | Prüfen Sie den Fehler oder bitten Sie Runner, ihn zu beheben, und verwenden Sie dann **Erneut veröffentlichen**. |
| **Ihr Shop konnte nicht erstellt werden, daher ist nichts live gegangen. Lassen Sie Runner das beheben.** | Das aktuelle Projekt ist vor der Veröffentlichung beim Build fehlgeschlagen. | Wählen Sie **Mit KI beheben** und wiederholen Sie nicht unverändert denselben Versuch. |
| Die Schaltfläche zeigt **Ihre Arbeitsumgebung ist offline – verbinden Sie sie erneut, um zu veröffentlichen.** | Runner kann den Storefront-Arbeitsbereich nicht erreichen. | Stellen Sie die Verbindung wieder her und führen Sie die Prüfungen erneut aus. |
| Die Schaltfläche zeigt **Warten Sie, bis Runner fertig ist** | Eine Anfrage ist noch aktiv. | Warten Sie auf ihr Endergebnis, bevor Sie veröffentlichen. |
| **Keine Änderungen** oder deaktiviertes **Bestätigen** | Es gibt keine neue gespeicherte Änderung, ein Build ist unvollständig, eine KI-Aufgabe ist aktiv oder eine erforderliche Prüfung ist noch offen. | Erledigen Sie den angezeigten Punkt. Keine Änderungen ist ein blockierender Zustand und keine Warnung, die Sie wegklicken können. |
| Der öffentliche Shop zeigt eine ältere Version | Die neuesten Projektänderungen wurden nicht erfolgreich veröffentlicht. | Prüfen Sie die aktuelle Version, verwenden Sie **Änderungen veröffentlichen** und kontrollieren Sie das Ergebnis erneut. |
## Verwandte Leitfäden
- [Ihren ersten Store Schritt für Schritt erstellen](../start-here/first-store-quickstart)
- [Veröffentlichung vorbereiten](./prepare-to-publish)
- [Live-Shop und Checkout prüfen](./live-store-and-checkout)
- [Verbinden Sie eine benutzerdefinierte Domain](./custom-domains)
---
# Fehlerbehebung bei Vorschau und Veröffentlichung
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/troubleshoot-preview-and-publishing
**Eingabepfad:** Workspace → Shop auswählen → **Onlineshop** → Reproduzieren Sie den auf dem Bildschirm angezeigten Vorschau- oder Veröffentlichungsstatus
## Was dieser Leitfaden abdeckt
Identifizieren Sie, welche Schicht fehlschlägt – Projektversion, Vorschau, Build-Prüfung, Veröffentlichung, öffentlicher Katalog, Checkout oder Domain – und ergreifen Sie die kleinste sichere Wiederherstellungsaktion.
## Warum diese Unterscheidung wichtig ist
Die Storefront-Reise hat mehrere unabhängige Schichten. Das Wiederholen von **Veröffentlichen** kann fehlende Produktdaten nicht beheben, und das Aktualisieren der Vorschau kann eine Zahlungsverbindung nicht reparieren. Beginnen Sie mit der genauen Nachricht und der Oberfläche, die fehlgeschlagen ist.
## Verfügbarkeit und Voraussetzungen
- Halten Sie das Projekt offen und notieren Sie die aktuelle Versionsbeschriftung.
- Notieren Sie die genaue Nachricht, den Seitenpfad und ob sie in der Vorschau oder auf der öffentlichen URL angezeigt wurde.
- Warten Sie, bis aktive Runner-Arbeit **Abgeschlossen**, **Fehlgeschlagen** oder **Gestoppt** erreicht, bevor Sie eine konfliktfreie Wiederherstellungsaktion starten.
- Entfernen Sie nicht Domains, stellen Sie Versionen nicht wieder her oder wiederholen Sie nicht bezahlte Aktionen, um eine Theorie zu testen.
## Finden Sie die fehlgeschlagene Schicht
1. Überprüfen Sie in **Onlineshop**, ob eine aktuelle Version vorhanden ist.
2. Bestätigen Sie, ob die normale Vorschau geöffnet wird.
3. Wenn Sie veröffentlichen, lesen Sie das Ergebnis der Build-Prüfung, bevor Sie eine andere Aktion auswählen.
4. Wenn die Veröffentlichung erfolgreich ist, öffnen Sie die öffentliche URL statt der Vorschau-URL.
5. Testen Sie im öffentlichen Speicher den Katalog und den Warenkorb.
6. Überprüfen Sie den Checkout-Status von Runner und den tatsächlichen Checkout-Pfad.
7. Wenn nur die benutzerdefinierte Adresse fehlschlägt, überprüfen Sie zuletzt die Domain-Einstellungen.
## Wichtige Wiederherstellungssteuerelemente
| Steuerelement | Was passiert, wenn es ausgewählt wird |
| --- | --- |
| **Aktualisieren** in der Vorschau | Lädt die aktuelle Vorschau neu und löscht die aktive Design Mode-Auswahl und die Rückgängig-/Wiederherstellen-Sitzung. Speichern Sie ausstehende direkte Änderungen zuerst. |
| **Beheben** / **Fehler beheben** | Sendet die angezeigte Vorschau-Diagnose an Runner als Reparaturanfrage. **Verwerfen** blendet nur die Nachricht aus. |
| **Mit KI beheben** | Schließt die Veröffentlichungsbestätigung und sendet seinen Build-Fehler an Runner zur Reparatur; die Veröffentlichung startet nicht. |
| **Prüfung erneut versuchen** | Führt die Storefront-Build-Prüfung erneut aus, nachdem Runner den Workspace nicht erreichen konnte. |
| **Shop-Betrieb öffnen** | Schließt die Veröffentlichungsbestätigung und öffnet den Shop-Betrieb, damit Sie die benannte Einrichtung abschließen können. |
| **Einrichtungsstatus erneut versuchen** | Überprüft die Bereitschaft des Shop-Betriebs erneut, nachdem ihr Status nicht verfügbar war. |
| **Erneut veröffentlichen** | Startet einen neuen überprüften Veröffentlichungsversuch nach einem fehlgeschlagenen oder linkfreien Ergebnis. Beheben Sie zuerst die benannte Ursache. |
| **Checkout-Status erneut versuchen** | Überprüft erneut auf eine aktivierte Zahlungsverbindung; es testet kein Produkt, Versand oder das Checkout-Formular. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Eine erfolgreiche Build-Prüfung kann neben einer Einrichtungswarnung erscheinen. Lesen Sie beides, bevor Sie entscheiden, ob der Shop bereit ist.
## Zustands-zu-Aktions-Referenz
| Nachricht oder Symptom | Schicht | Was es bedeutet | Sicherste nächste Aktion |
| --- | --- | --- | --- |
| Keine fertige Storefront-Version | Projektversion | Es gibt keine Version für die Vorschau. | Bitten Sie Runner, die erste Storefront zu erstellen. |
| **Erste Version wird erstellt…** | Projektversion | Runner erstellt es noch. | Folgen Sie dem Task-Fortschritt; veröffentlichen Sie noch nicht. |
| **Build fehlgeschlagen** auf einer Version | Projektversion | Diese Version ist nicht bereit. | Öffnen Sie die Task-Details und bitten Sie Runner, den Fehler zu beheben. |
| **Vorschau wird vorbereitet…** | Vorschau | Runner startet die ausgewählte Vorschau. | Halten Sie die neueste Version ausgewählt; aktualisieren Sie nur, wenn der Fortschritt stoppt. |
| **Fehler beim Laden der Vorschau für diese Version** | Vorschau | Die ausgewählte Version konnte nicht angezeigt werden. | Kehren Sie zur aktuellen zurück, aktualisieren Sie oder versuchen Sie eine andere bereite Version. |
| **Vorschau wird erneut verbunden** | Vorschau | Runner hat die Vorschauverbindung verloren und versucht es erneut. | Folgen Sie der Wiederholungsanzahl; verbinden Sie den Workspace erneut, wenn die Wiederherstellung fehlschlägt. |
| Vorschau-Fehlerleiste mit **Beheben** | Vorschau | Die laufende Seite hat eine Diagnose gemeldet, die Runner verwenden kann. | Wählen Sie **Mehr anzeigen**, um sie zu überprüfen, **Beheben** oder **Fehler beheben**, um sie an Runner zu senden, oder **Verwerfen** nur, um die Leiste auszublenden. |
| **Seite nicht gefunden** | Vorschau oder öffentliche Route | Der Pfad existiert in dieser Version nicht. | Kehren Sie zu `/` zurück, verwenden Sie sichtbare Navigation und bitten Sie Runner, die Route zu erstellen oder zu reparieren. |
| **Design-Modus ist nicht gestartet** | Design-Modus | Die bearbeitbare Vorschau wurde nicht bereit. | Wählen Sie **Erneut versuchen** oder kehren Sie zur aktuellen Vorschau zurück und aktualisieren Sie. |
| **Sobald Runner fertig ist, können Sie wieder visuell bearbeiten.** | Designmodus | Runner bearbeitet eine andere Anfrage. | Warten Sie, bis Runner fertig ist. |
| **Fehler beim Laden des Versionsverlaufs** | Versionsverlauf | Die Versionslisten-Anfrage ist fehlgeschlagen. | Wählen Sie **Erneut versuchen**. |
| Wiederherstellen ist blockiert | Versionsverlauf | Runner ist aktiv oder die Version ist nicht bereit. | Warten Sie auf Runner und wählen Sie dann eine bereite Version. |
| **Wir konnten Ihren Workspace nicht erreichen. Wiederholen Sie die Prüfung, um fortzufahren.** | Veröffentlichungsprüfung | Runner konnte die Build-Prüfung nicht ausführen. | Wählen Sie **Prüfung wiederholen** und verbinden Sie bei erneutem Auftreten den Arbeitsbereich neu. |
| **Ihr Shop lässt sich noch nicht erstellen und kann daher nicht live gehen. Lassen Sie Runner die Fehler beheben und veröffentlichen Sie dann.** | Veröffentlichungsprüfung | Die aktuelle Storefront besteht den Build nicht. | Wählen Sie **Mit KI beheben**, prüfen Sie die Korrektur und wiederholen Sie die Prüfungen. |
| **Einige Betriebsdetails brauchen noch Ihre Aufmerksamkeit. Sie können jetzt live gehen und sie im Shop-Betrieb abschließen.** | Einrichtung zur Veröffentlichung | Wichtige Shop-Betriebsdaten sind noch unvollständig. | Wählen Sie **Shop-Betrieb öffnen**. Bestätigen Sie nur, wenn die Einschränkung beabsichtigt ist. |
| **Der Shop-Betrieb konnte nicht geprüft werden. Versuchen Sie es erneut oder bestätigen Sie dies und veröffentlichen Sie trotzdem.** | Einrichtung zur Veröffentlichung | Der Einrichtungsstatus ist unbekannt. | Wählen Sie **Einrichtungsstatus erneut prüfen**, bevor Sie eine Bestätigung erwägen. |
| **Nehmen Sie vor dem Veröffentlichen eine sichtbare Änderung an Ihrem Onlineshop vor.** | Veröffentlichungsänderungen | Runner hat seit der letzten Veröffentlichung nichts Neues gefunden. | Brechen Sie ab und nehmen Sie zuerst die gewünschte Änderung vor. **Bestätigen** ist deaktiviert, solange keine Änderungen zu veröffentlichen sind. |
| **Käufer können stöbern, aber noch nicht bezahlen – verbinden Sie Stripe in den Einstellungen, um Bestellungen anzunehmen.** | Checkout-Einrichtung | Manche Veröffentlichungsabläufe zeigen dies vor dem Start, wenn keine aktivierte Zahlungsanbindung gefunden wird. | Verbinden Sie bei einem nativen Runner-Shop Stripe; bestätigen Sie die Warnung nur für einen beabsichtigten Start ohne Kaufmöglichkeit. Andere Abläufe zeigen den Checkout-Status nach der Veröffentlichung. |
| **Speicherveröffentlichung fehlgeschlagen** | Veröffentlichung | Der Versuch wurde nicht abgeschlossen. | Beheben Sie das benannte Problem und wählen Sie dann **Erneut veröffentlichen**. |
| **Speicherlink nicht verfügbar** | Veröffentlichungs-Handoff | Der Versuch wurde ohne verwendbaren öffentlichen URL-Link im Runner beendet. | Schließen Sie den Dialog, bestätigen Sie, dass der Workspace bereit ist, und wählen Sie dann **Erneut veröffentlichen**. |
| Der öffentliche Speicher zeigt alten Inhalt | Veröffentlichung oder Version | Die neuesten Projektänderungen sind nicht live. | Bestätigen Sie die neueste aktuelle Version, wählen Sie **Änderungen veröffentlichen** und öffnen Sie die öffentliche URL erneut. |
| Produkt fehlt im öffentlichen Speicher | Katalog | Die Veröffentlichung war erfolgreich, aber das beabsichtigte Produkt ist nicht sichtbar. | Überprüfen Sie Produktstatus, Markt, Preis und Bestand; veröffentlichen Sie Änderungen, falls erforderlich. |
| Warenkorbaktionen fehlen oder sind deaktiviert | Katalog oder Verfügbarkeit | Das ausgewählte Element kann derzeit nicht hinzugefügt werden. | Überprüfen Sie erforderliche Optionen, Verfügbarkeit, Bestand, Preis und Region. |
| **Checkout unterbrochen** | Zahlung | Der Post-Publish-Flow hat keine aktivierte Stripe-Verbindung gefunden. | Wählen Sie **Stripe verbinden** und testen Sie dann den tatsächlichen Checkout-Pfad erneut. |
| **Checkout-Status nicht verfügbar** | Zahlungsstatus | Runner kann die Zahlungsbereitschaft nicht bestätigen. | Wählen Sie **Checkout-Status erneut versuchen** und testen Sie den öffentlichen Checkout unabhängig. |
| Eigene benutzerdefinierte Domain zeigt eine rote Warnung und eine Tabelle **Typ / Host / Wert** | Domain | Die aktuelle Konfigurationsprüfung beim Anbieter war noch nicht erfolgreich. | Kopieren Sie die angezeigten Werte exakt zu Ihrem Anbieter. Runner prüft automatisch erneut, solange die Domain-Einstellungen geöffnet bleiben; es gibt keine manuelle Verifizierungsschaltfläche. |
| **Übertragung läuft** | Domain | Eine Domain wird zwischen Speichern verschoben. | Starten Sie keine weitere Übertragung; folgen Sie dem angezeigten Status. |
## Die Wiederherstellung bestätigen
Kehren Sie zur gleichen Seite, Version und Gerätegröße zurück, bei der das Problem auftrat. Wiederholen Sie den kleinsten fehlgeschlagenen Schritt einmal. Prüfen Sie das sichtbare Ergebnis: eine fertige Vorschau, eine erfolgreiche Veröffentlichung mit der erwarteten Seite unter der öffentlichen URL, einen korrekten Warenkorb oder eine funktionierende Domain. Halten Sie weiterhin fehlschlagende Schritte einzeln fest.
## Melden Sie ein Problem an Runner
Fügen Sie diese Details in einer Nachricht ein:
1. den genauen Seitenpfad oder die öffentliche URL;
2. ob es in der Vorschau oder im Live-Shop fehlgeschlagen ist;
3. die aktuelle Versionsbeschriftung;
4. den genauen Fehler- oder Statustext;
5. die letzte Schaltfläche, die Sie ausgewählt haben;
6. das erwartete Ergebnis; und
7. ob sich das Problem nach der dokumentierten Wiederholungsaktion wiederholt.
Für ein visuelles Problem fügen Sie das Geräte-Layout und einen Screenshot ein. Für Checkout, stoppen Sie vor einer echten Belastung und melden Sie den letzten erfolgreichen Schritt.
## Wiederherstellungsgrenzen
- Setzen Sie einen unveränderten fehlgeschlagenen Zustand nicht wiederholt fort oder veröffentlichen Sie ihn erneut. Beheben Sie zuerst die benannte Ursache.
- Stellen Sie eine ältere Version nicht wieder her, während Runner arbeitet.
- Entfernen Sie keine Domain, um ein Storefront- oder Checkout-Problem zu beheben.
- Behaupten Sie nicht, dass der Start erfolgreich ist, bis die öffentliche URL, der beabsichtigte Katalog, der Warenkorb und der erforderliche Checkout-Schritt jeweils überprüft wurden.
## Verwandte Leitfäden
- [Vorschau Ihres Shops](./preview-your-store)
- [Veröffentlichung vorbereiten](./prepare-to-publish)
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Live-Shop und Checkout überprüfen](./live-store-and-checkout)
- [Verbinden Sie eine benutzerdefinierte Domain](./custom-domains)
---
# Versionsverlauf verwenden
Source: https://www.runnerai.com/docs/de/guides/storefront-and-publishing/version-history
**Eingabepfad:** Workspace → Store auswählen → **Onlineshop** → **Versionsverlauf** (Uhrsymbol mit Pfeil)
## Was dieser Leitfaden abdeckt
Vergleichen Sie Storefront-Versionen, zeigen Sie eine frühere fertige Version in der Vorschau an und stellen Sie deren Inhalt bei Bedarf als neue aktuelle Version wieder her, während Sie die vorhandene Historie beibehalten.
## Warum und wann Sie den Versionsverlauf verwenden
Verwenden Sie den Versionsverlauf, wenn Sie verstehen müssen, was sich geändert hat, ein früheres Design überprüfen möchten oder Inhalte wiederherstellen müssen, die vor einer kürzlichen Anfrage besser waren. Die Vorschau ist schreibgeschützt. Das Wiederherstellen ändert das Projekt, daher überprüfen Sie zuerst die Bestätigung.
## Verfügbarkeit und Voraussetzungen
- Öffnen Sie ein Projekt mit mindestens einer Storefront-Version.
- Historische Vorschau und Wiederherstellung sind nur für Versionen verfügbar, die Runner erfolgreich laden kann.
- Warten Sie, bis Runner eine aktive Anfrage beendet, bevor Sie wiederherstellen.
- Der Versionsverlauf ist in Workspaces mit der Checkpoint-basierten Storefront-Erfahrung bedingt.
- Einige abgeschlossene Gesprächsarbeitskarten zeigen auch ein bedingtes Versionsetikett, eine genaue Versionsvorschau und eine **Veröffentlichen**-Aktion für eine unveröffentlichte aktuelle Version. Diese Karten sind ein schneller Einstieg; diese Seite bleibt die vollständige Vergleichs- und Wiederherstellungsansicht.
## Versionsverlauf öffnen
Öffnen Sie den Store, den Sie überprüfen möchten, und folgen Sie den nummerierten Markierungen unten.
1. **Wählen Sie Storefront in der linken Seitenleiste.** Dadurch öffnet sich Ihre Store-Vorschau. Wenn die Seitenleiste nur Symbole zeigt, klappen Sie sie mit der Schaltfläche oben links auf.
2. **Klicken Sie auf das Uhrsymbol mit Pfeil oberhalb der Vorschau, nahe der oberen rechten Ecke.** Dies ist **Versionsverlauf**. Bewegen Sie den Mauszeiger darüber, um den Namen zu sehen. Im Beispiel befindet es sich direkt links neben der Adresse der veröffentlichten Website und **Änderungen veröffentlichen**.
3. **Prüfen Sie, ob sich rechts der Bereich Versionsverlauf öffnet.** Die neueste Version erscheint unter **Aktuelle Version**. Scrollen Sie nach unten, um ältere Versionen anzusehen, sofern Ihr Store welche hat. Wählen Sie **Zurück** (den Linkspfeil neben dem Titel des Bereichs), um ihn zu schließen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsx1z1nuaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Wählen Sie das Bild aus, um es zu vergrößern. Die markierten Desktop-Ansichten zeigen, wo Sie klicken müssen. Das Öffnen des Verlaufs stellt nichts wieder her und veröffentlicht nichts. Bei einem Store mit nur einer aufgezeichneten Version wird nur **Aktuelle Version** angezeigt.
**Auf einem Smartphone:** Öffnen Sie **Onlineshop**, tippen Sie unten neben der Veröffentlichungsschaltfläche auf **Weitere Aktionen** (**…**) und dann auf **Versionsverlauf**.
Wenn Sie die Verlaufsschaltfläche nicht sehen, verlassen Sie zuerst den **Design-Modus** oder kehren Sie zur neuesten Vorschau zurück. Warten Sie, bis der erste Build abgeschlossen ist. Die Verfügbarkeit kann auch von der Storefront-Erfahrung Ihres Workspaces abhängen.
### Beispiel mit einer früheren Version
Vergleichen Sie die Beschriftungen, bevor Sie eine Version wählen. Dieses Beispiel öffnet nur den Verlauf; es stellt keine Version wieder her und veröffentlicht keine.
## Versionsverlauf-Steuerelemente
| Steuerelement | Warum Sie es verwenden | Was passiert, wenn Sie es auswählen |
| --- | --- | --- |
| **Zurück** | Verlassen Sie die Versionsliste. | Runner kehrt zur Storefront-Ansicht zurück. |
| Versions-Screenshot | Überprüfen Sie das erfasste Erscheinungsbild. | Der Screenshot wird in einem größeren Bildbetrachter geöffnet, wenn einer verfügbar ist. |
| **Vollständigen Diff anzeigen** | Sehen Sie einen detaillierten Datensatz darüber, was sich geändert hat. | Runner öffnet die Änderungsdetails für diese Version in einem neuen Tab. |
| **Vorschau** / **Vorschau dieser Version** | Überprüfen Sie eine frühere fertige Version, ohne sie wiederherzustellen. | Die Storefront wechselt zu einer temporären historischen Vorschau mit der Bezeichnung **Vorschau v…**. Die neueste Projektversion und der Live-Store ändern sich nicht. |
| **Zurück zur neuesten** / **Zur aktuellen Version zurückkehren** | Beenden Sie eine historische Vorschau. | Runner lädt die neueste aktuelle Storefront-Version neu. |
| **Wiederherstellen** | Verwenden Sie den Inhalt einer früheren Version erneut. | Runner öffnet **Auf v… wiederherstellen?**. Das Bestätigen erstellt eine neue neueste Version mit diesem Inhalt; die ausgewählte Version, neuere Versionen und die Historie bleiben erhalten. |
| **Weitere Aktionen** | Erreichen Sie Kartenaktion auf kompakten Layouts. | Ein Menü wird mit den für diese Version verfügbaren Aktionen geöffnet, z. B. Vorschau, Wiederherstellen oder Vollständigen Diff anzeigen. |
| **Veröffentlichen** in der aktuellen Version | Starten Sie die Veröffentlichung der neuesten Version. | Runner öffnet die Veröffentlichungsprüfungen. Es veröffentlicht eine historische Vorschau nicht direkt. |
## Lesen Sie die Versionskarten
| Etikett oder Status | Bedeutung |
| --- | --- |
| **Neueste** oder **Aktuelle Version** | Dies ist die neueste Projektversion. |
| **Veröffentlicht** | Diese Version ist mit einer abgeschlossenen Veröffentlichung verknüpft. Es beweist nicht, dass der Checkout jetzt funktioniert. |
| **Wird erstellt…** | Runner erstellt noch die Version. Vorschau und Wiederherstellung können nicht verfügbar sein. |
| **Build fehlgeschlagen** | Diese Version hat keinen fertigen Status erreicht. Verwenden Sie seinen Fehlerkontext, um Runner um eine Behebung zu bitten. |
| Dateiänderungszählungen | Eine Zusammenfassung der hinzugefügten, geänderten oder entfernten Dateien für diese Version. |
| Zeit | Wann die Version aufgezeichnet wurde. |
| Beschreibung | Die aufgezeichnete Zusammenfassung der Version, wenn eine verfügbar ist. |
## Sichere Vorschau und Wiederherstellung
1. Wählen Sie **Vorschau** in der Version aus, die Sie überprüfen möchten.
2. Bestätigen Sie, dass die Symbolleiste **Vorschau v…** anzeigt, damit Sie sie nicht mit der neuesten Version verwechseln.
3. Überprüfen Sie die relevanten Seiten- und Gerätelayouts.
4. Wählen Sie **Zurück zur neuesten**, wenn Sie nur vergleichen mussten.
5. Um den älteren Inhalt wiederherzustellen, wählen Sie **Wiederherstellen**.
6. Lesen Sie die Bestätigung: Runner fügt eine neue Version hinzu und behält die vorhandene Historie bei.
7. Bestätigen Sie die Wiederherstellung nur, wenn Runner untätig ist.
8. Prüfen Sie, ob eine neue **Aktuelle Version** erscheint. Prüfen Sie den wiederhergestellten Inhalt vor der Veröffentlichung in der Vorschau. Der ältere Verlauf sollte weiterhin verfügbar sein.
## Status, Limits und Fehlerbehebung
| Was Sie sehen | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Noch kein Versionsverlauf** | Nur der aktuelle Startzustand existiert, oder es ist keine Historie verfügbar. | Fahren Sie mit der Arbeit fort; kehren Sie zurück, nachdem Runner eine andere Version aufgezeichnet hat. |
| **Versionsverlauf wird geladen…** | Runner ruft die Karten ab. | Halten Sie das Panel offen, bis es fertig ist. |
| **Fehler beim Laden des Versionsverlaufs** | Die Listenanfrage ist fehlgeschlagen. | Wählen Sie **Erneut versuchen**. |
| **Fehler beim Laden der Vorschau für diese Version** | Diese historische Vorschau konnte nicht gestartet werden. | Kehren Sie zur aktuellen Version zurück und versuchen Sie eine andere fertige Version. |
| Wiederherstellen ist deaktiviert | Runner ist aktiv oder die Version kann nicht wiederhergestellt werden. | Warten Sie, bis Runner fertig ist, oder wählen Sie eine fertige Version. |
| **Kann nicht wiederherstellen, während der Agent arbeitet** | Das Wiederherstellen würde mit der aktiven Aufgabe in Konflikt geraten. | Lassen Sie die Aufgabe einen Endzustand erreichen, und versuchen Sie es dann erneut. |
| Wiederhergestellter Inhalt ist nicht live | Wiederherstellen hat eine Projektversion erstellt, keine Veröffentlichung. | Überprüfen Sie es, und wählen Sie dann **Änderungen veröffentlichen**. |
## Verwandte Leitfäden
- [Zeigen Sie Ihren Store in der Vorschau an](./preview-your-store)
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Fehlerbehebung bei Vorschau und Veröffentlichung](./troubleshoot-preview-and-publishing)
---
# Anwendungsfälle
Source: https://www.runnerai.com/docs/de/guides/use-cases
Neu bei Runner? Folgen Sie zuerst [Ihren ersten Store erstellen](/de/guides/start-here/first-store-quickstart) und wählen Sie danach unten Ihr nächstes Ziel.
## Nach Ziel erkunden
- [Storefront und Veröffentlichung](/de/guides/storefront-and-publishing)
Zeigen Sie eine Vorschau an, bearbeiten Sie, versionieren Sie, veröffentlichen Sie und überprüfen Sie Ihre Runner-Storefront.
- [Shop-Betrieb](/de/guides/store-operations)
Richten Sie den Katalog, die Bestellungen, Kunden, Promotionen, das Sourcing und die Bewertungen Ihres Shops ein und betreiben Sie diese.
- [Apps und Integrationen](/de/guides/apps-and-integrations)
Suchen, verbinden und verwalten Sie die Dienste, die Ihr Runner-Store und Agent verwenden können.
- [Analytics und SEO](/de/guides/analytics-and-seo)
Lesen Sie die Store-Leistung, diagnostizieren Sie die Konvertierung und verbessern Sie, wie Menschen und KI-Suchtools Ihre Storefront finden.
- [Automatisieren, testen und erstellen](/de/guides/automate-test-and-create)
Verwenden Sie Runners bedingte Tools für wiederkehrende Arbeiten, Käufer-Tests, Experimente, Mediengenerierung und Werbung.
- [Agent-Anpassung](/de/guides/agent)
Fügen Sie wiederverwendbare Skills und vertrauenswürdigen Speicher hinzu, damit Runner auf eine Weise funktioniert, die zu Ihrem Shop passt.
---
# Mit Runner arbeiten
Source: https://www.runnerai.com/docs/de/guides/work-with-runner
**Was dieser Leitfaden abdeckt:** Sie wissen, wo Sie eine Anfrage starten, wie Sie die Arbeit leiten und wo Sie das Ergebnis überprüfen.
Verwenden Sie diesen Abschnitt, nachdem Sie ein Shop-Projekt geöffnet haben. Runner bündelt Anfrage, Fortschritt, Vorschau und zugehörige Projektwerkzeuge, damit Sie von einer Idee zu einem überprüfbaren Ergebnis gelangen.
**Einstiegspfad:** Gewünschten Store im Store-Namensmenü öffnen → aktuelle Aufgabe öffnen oder **Neue Aufgabe** wählen.
## Der tägliche Ablauf
1. Öffnen Sie den Shop, den Sie ändern möchten.
2. Starten Sie eine **Neue Aufgabe**, wenn die Arbeit eine separate Konversation benötigt.
3. Beschreiben Sie ein klares Ergebnis im Nachrichtenfeld.
4. Fügen Sie ein Referenzbild hinzu, wählen Sie ein Profil oder ergänzen Sie einen Skill, wenn dies hilfreich ist.
5. Wählen Sie **Nachricht senden** und verfolgen Sie den Aufgabenstatus.
6. Beantworten Sie alle Fragen, die Runner stellt, damit es mit der richtigen Wahl fortfahren kann.
7. Öffnen Sie **Details**, die Vorschau oder eine andere Arbeits-Canvas-Registerkarte, um das Ergebnis zu überprüfen.
8. Senden Sie bei Bedarf eine gezielte Folgeanfrage. Prüfen Sie zum Abschluss, ob die gewünschte Kundenaktion auf der entstandenen Seite oder im Tool funktioniert.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Wenn eine Aufgabe Ihre Entscheidung benötigt, beantworten Sie die aktive Karte, bevor Sie weitere Arbeit erwarten. Die [Anleitung zu Fragen](/de/guides/work-with-runner/answer-runner-questions) enthält die passende Aufnahme.
## Leitfaden auswählen
| Was Sie tun möchten | Leitfaden |
| --- | --- |
| Starten Sie eine Anfrage und lernen Sie das Eingabefeld kennen | [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner) |
| Öffnen Sie eine Unterhaltung erneut, benennen Sie sie um oder entfernen Sie sie | [Chats und Verlauf](/de/guides/work-with-runner/chats-and-history) |
| Finden Sie ein Projektwerkzeug oder einen aktuellen Chat | [Projektnavigation und Suche](/de/guides/work-with-runner/project-navigation-and-search) |
| Geben Sie Runner klarere Richtung | [Schreiben Sie effektive Anfragen](/de/guides/work-with-runner/write-effective-requests) |
| Fügen Sie Kontext hinzu oder ändern Sie, wie Runner eine Aufgabe angeht | [Bilder, Modelle und Skills](/de/guides/work-with-runner/attachments-profiles-and-skills) |
| Antworten Sie, wenn Runner eine Entscheidung benötigt | [Wenn Runner eine Frage stellt](/de/guides/work-with-runner/answer-runner-questions) |
| Verstehen Sie den Fortschritt und überprüfen Sie abgeschlossene Arbeiten | [Aufgabenzustände und Details](/de/guides/work-with-runner/task-states-and-details) |
| Fügen Sie schnell einen Skill oder eine Erinnerung hinzu | [Agent-Befehlspalette](/de/guides/agent/command-palette) |
## Bevor Sie beginnen
- Sie müssen angemeldet sein und Zugriff auf ein Shop-Projekt haben.
- Ein neu erstellter Chat ist leer, bis Sie eine Nachricht senden.
- Einige Werkzeuge, Profile, Skills und Navigationsziele sind bedingt. Runner zeigt nur das an, was für das aktuelle Konto und Projekt verfügbar ist.
- Veröffentlichung, Abrechnung und destruktive Aktionen erfordern ihre eigenen Bestätigungspfade. Eine abgeschlossene Chat-Aufgabe bedeutet nicht von selbst, dass ein Store veröffentlicht oder eine externe Aktion durchgeführt wurde.
## Verwandte Leitfäden
- [Erstellen Sie Ihren ersten Store](/de/guides/start-here/first-store-quickstart)
- [Verwalten Sie Stores](/de/guides/workspace/manage-stores)
- [Verstehen Sie Store-Status](/de/guides/workspace/store-statuses)
---
# Wenn Runner eine Frage stellt
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/answer-runner-questions
**Was dieser Leitfaden abdeckt:** Sie beantworten oder überspringen absichtlich Runner-Fragen, ohne den Aufgabenkontext zu verlieren.
Runner stellt eine Frage, wenn Ihre Entscheidung das Ergebnis wesentlich ändern kann. Fragen können eine einzelne Auswahl, mehrere Auswahlmöglichkeiten oder eine freie Antwort verwenden.
**Eingabepfad:** Öffnen Sie ein Gespräch, dessen Aufgabenstatus auf Eingabe wartet → Fragenkarte.
## Bevor Sie beginnen
- Beantworten Sie die neueste aktive Frage; ältere Karten können schreibgeschützt sein.
- Überprüfen Sie die Auswirkung sorgfältig, wenn eine Auswahl Zugriff, Geld, Veröffentlichung, Kundendaten oder einen externen Service betrifft.
- Verwenden Sie **Überspringen** nur, wenn Runner sicher ohne Ihre Vorliebe wählen kann.
## Fragensteuerelement
| Steuerelement oder Status | Was passiert |
| --- | --- |
| Eine Einfachauswahl | Wählt die Antwort und kann sofort zur nächsten Frage wechseln. Die letzte Auswahl kann alle Antworten automatisch senden. |
| Mehrfachauswahloptionen | Ermöglicht Ihnen, mehr als eine zulässige Antwort auszuwählen. |
| **Sonstiges…** | Öffnet ein Feld für eine Antwort, die nicht aufgelistet ist. |
| Senden oder Fortfahren, falls angezeigt | Geht zur nächsten Karte oder sendet die vollständigen Antworten. |
| **Überspringen**, falls angeboten | Fordert Runner auf, nach bestem Ermessen fortzufahren. |
| Deaktivierte Karte | Die Aufgabe ist beschäftigt, abgelaufen, gestoppt oder die Frage kann keine Antwort mehr akzeptieren. |
## Beantworten Sie eine Frage
1. Lesen Sie die Frage und alle Erklärungen über den Auswahlmöglichkeiten.
2. Lesen Sie jede Option vor dem Auswählen: Eine Einfachauswahl kann sofort weiterführen und die letzte Antwort automatisch senden.
3. Wählen Sie die Auswahl oder Auswahlmöglichkeiten, die Ihrer Absicht entsprechen.
4. Wählen Sie **Sonstiges…** und geben Sie eine prägnante Antwort ein, wenn keine der aufgelisteten Auswahlmöglichkeiten passt.
5. Verwenden Sie Fortfahren oder Senden nur, wenn die Karte diese Aktion zeigt.
6. Warten Sie, während Runner die Antworten übermittelt.
7. Bestätigen Sie, dass Runner die Aufgabe fortsetzt und Ihre Antwort im Gespräch aufzeichnet.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Lesen Sie jede Option vor dem Auswählen; die letzte Antwort kann automatisch gesendet werden.
### Ansehen: Rückfragen beantworten
Das Beispiel wählt einen Kerzenpreis und einen Fotostil. **Beantwortet** bestätigt die Auswahl, danach setzt Runner die Aufgabe fort.
## Überspringen Sie, wenn Runner entscheiden kann
1. Lesen Sie, was Runner fragt.
2. Wählen Sie **Überspringen** nur, wenn die Karte diese Option bietet und Runner nach bestem Ermessen fortfahren soll.
3. Beobachten Sie, wie die Aufgabe fortgesetzt wird.
4. Überprüfen Sie das Ergebnis genau, da Sie die fehlende Vorliebe nicht angegeben haben.
Überspringen ist nützlich für risikoarme Präsentationswahlmöglichkeiten. Geben Sie eine explizite Antwort, wenn die Entscheidung Zugriff, Geld, Veröffentlichung, Kundendaten oder eine destruktive Aktion betrifft.
## Fehlerbehebung
| Status | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Wartet auf Eingabe | Runner kann ohne Antwort nicht sicher fortfahren. | Beantworten oder überspringen Sie absichtlich die aktive Frage. |
| Alte Frage ist schreibgeschützt | Eine neuere Nachricht oder ein Aufgabenstatus hat sie ersetzt. | Beantworten Sie stattdessen die neueste aktive Frage. |
| **Benutzer hat diese Frage unterbrochen** | Die Aufgabe wurde gestoppt, bevor die Frage abgeschlossen wurde. | Starten Sie eine neue Folgenachricht, wenn Sie möchten, dass Runner fortfährt. |
| Senden ist nicht verfügbar | Eine oder mehrere erforderliche Antworten sind unvollständig, oder die Karte ist nicht mehr aktiv. | Füllen Sie jede aktuelle Frage aus oder wechseln Sie zur neuesten Fragenkarte. |
| Antwortfehler | Runner konnte die Antwort nicht annehmen. | Die Karte kann wieder als unbeantwortet erscheinen. Lassen Sie die Konversation offen, prüfen Sie den aktuellen Aufgabenstatus und antworten Sie erst erneut, wenn die Karte Eingaben annimmt. |
## Verwandte Leitfäden
- [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner)
- [Schreiben Sie effektive Anfragen](/de/guides/work-with-runner/write-effective-requests)
- [Aufgabenstatus und Details](/de/guides/work-with-runner/task-states-and-details)
---
# Anhänge, Modelle und Skills
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/attachments-profiles-and-skills
**Was dieser Leitfaden abdeckt:** Sie geben Runner den richtigen Kontext und die richtigen Arbeitswerkzeuge, bevor Sie eine Anfrage senden.
Bilder zeigen Runner, was Sie meinen. Modelle und Skills bestimmen die Funktionen für die nächste Anfrage. Wenn **Anhängen** erscheint, können Sie auch unterstützte Dokumente als Kontext hinzufügen. Wählen Sie diese Hilfsmittel bewusst; eine klare Anfrage bleibt die wichtigste Eingabe.
**Einstiegspfad:** Shop-Projekt öffnen → Eingabefeld der Unterhaltung.
## Bevor Sie beginnen
- Verwenden Sie nur Bilder, die Sie mit dem aktuellen Workspace teilen dürfen.
- Entfernen Sie Geheimnisse, Zahlungsdaten und unnötige Kundeninformationen.
- Überprüfen Sie Plan- und Browser-Zugriff, wenn ein Modell, ein Skill oder eine Screenshot-Aktion fehlt.
## Steuerelemente des Eingabefelds
| Steuerelement | Was passiert, wenn Sie es auswählen |
| --- | --- |
| **Hinzufügen** | Öffnet auf Desktop **Bild hochladen** oder bei aktivierten Dokumentanhängen **Anhängen**, sowie **Screenshot aufnehmen**, falls unterstützt. |
| **Anhängen**, falls angeboten | Öffnet die Auswahl für unterstützte Dokumente und Bilder. |
| **Bild hochladen** | Öffnet die Bildauswahl für JPG/JPEG-, PNG-, GIF-, WebP-, BMP- oder TIFF-Dateien. |
| **Aus Mediathek**, falls angeboten | Öffnet vorhandene Projektmedien als Referenz für den Entwurf. |
| **Screenshot machen** | Startet die Bildschirmerfassung, wenn Browser und Konto dies unterstützen. Der Browser kann um Berechtigung fragen. |
| **Bild** auf Mobilgeräten | Öffnet die mobile Bildauswahl. Bei aktivierten Dokumentanhängen erscheint stattdessen **Anhängen**. |
| Modellwähler | Listet die Runner-Modelle auf, die für das Konto verfügbar sind. Ein gesperrtes Modell öffnet stattdessen den relevanten **Plan & Abrechnung**-Pfad. |
| **Schnellbefehle** oder **Skills** | Öffnet verfügbare Verknüpfungen, die zur Anfrage hinzugefügt werden können. |
| **Weitere Aktionen** | Zeigt Werkzeuge des Eingabefelds an, die nicht in das aktuelle Layout passen. |
In der reinen Bildauswahl ignoriert Runner Bilder mit demselben Namen und derselben Größe wie ein bereits angehängtes Bild und zeigt **Doppeltes Bild ignoriert**. Nicht unterstützte Dateien werden mit **Verwenden Sie ein JPG-, PNG-, GIF-, WebP-, BMP- oder TIFF-Bild** ignoriert. Bei einer gemischten Auswahl bleiben unterstützte Bilder verfügbar. Runner erlaubt bis zu 10 Anhänge pro Nachricht. Bilder dürfen jeweils bis zu 32 MB groß sein. Bei aktivierten Dokumentanhängen dürfen Dokumente jeweils bis zu 10 MB groß sein.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
In diesem Arbeitsbereich sind Dokumentanhänge aktiviert, daher zeigt das Menü **Anhängen**. Durch das Öffnen wird keine Datei hochgeladen und keine Anfrage gesendet.
## Bild hinzufügen
1. Verfassen Sie genug der Anfrage, um zu erklären, warum die Datei wichtig ist.
2. Wählen Sie auf dem Desktop **Hinzufügen** oder auf Mobilgeräten die Upload-Schaltfläche.
3. Wählen Sie **Bild hochladen**, **Bild** oder **Screenshot machen**, je nachdem, was angezeigt wird.
4. Wählen Sie das relevante Bild aus oder erfassen Sie es.
5. Prüfen Sie, ob das richtige Vorschaubild beim Entwurf erscheint und ein eventueller Upload abgeschlossen ist.
6. Entfernen Sie es vor dem Senden, wenn es die falsche Referenz ist.
7. Wählen Sie **Nachricht senden**.
Wenn die Bildschirmerfassung nicht verfügbar ist oder die Berechtigung verweigert wird, machen Sie einen Screenshot mit Ihrem Gerät und laden Sie das gespeicherte Bild stattdessen hoch.
## Ein Dokument anhängen, falls verfügbar
1. Öffnen Sie **Hinzufügen** und wählen Sie **Anhängen**. Wenn nur **Bild hochladen** oder **Bild** erscheint, unterstützt dieses Eingabefeld keine Dokumente.
2. Wählen Sie eine unterstützte Datei, etwa PDF, Word-Dokument, Präsentation, Tabelle oder CSV.
3. Prüfen Sie, ob der Anhang neben Ihrem Entwurf erscheint.
4. Erklären Sie Runner, was daraus verwendet werden soll, etwa: „Verwende die Produktnamen und Beschreibungen dieser CSV für Kategorietexte; ändere keine Preise.“
5. Wählen Sie **Nachricht senden** und warten Sie, bis die Dokumentvorbereitung abgeschlossen ist.
6. Prüfen Sie, ob Runners Antwort das gewünschte Dokument berücksichtigt, bevor Sie eine Store-Änderung anfordern.
Falls die Datei nicht gelesen werden kann, folgen Sie der Fehlermeldung. Passwortgeschützte, beschädigte, sehr komplexe oder leere Dokumente können fehlschlagen. Verwenden Sie einen kleineren Export ohne Passwort oder fügen Sie den relevanten Text ein. Behalten Sie den Entwurf, bis der Ersatz akzeptiert wird. Videos werden von dieser Anhangsfunktion nicht unterstützt.
## Modell auswählen
1. Wählen Sie das aktuelle Modell im Eingabefeld.
2. Prüfen Sie die verfügbaren Modelle. Die aufgezeichnete Oberfläche zeigt **Runner 2.0 Pro**. Orientieren Sie sich an Ihrer eigenen Auswahl, da verfügbare Profile wechseln können.
3. Wählen Sie das Modell, das zur Aufgabe passt.
4. Bestätigen Sie, dass das ausgewählte Modell vor dem Senden angezeigt wird.
Wenn ein Modell gesperrt ist, behalten Sie das aktuelle Modell bei oder folgen Sie den Plan-Informationen, die Runner öffnet. Eine gesperrte Auswahl wird nicht auf den Entwurf angewendet.
## Skill hinzufügen
1. Öffnen Sie **Schnellbefehle** oder **Skills** im Eingabefeld, falls angezeigt.
2. Suchen Sie nach dem benötigten Skill oder durchsuchen Sie die Liste.
3. Wählen Sie einen [verfügbaren Skill](/de/guides/agent/skills) für diese Anfrage. **Schnellbefehle** kann dessen Slash-Befehl, etwa `/store-seo`, in das Eingabefeld einsetzen. Die Auswahl führt den Befehl noch nicht aus.
4. Kehren Sie zum Eingabefeld zurück und prüfen Sie den gewünschten Skill oder Slash-Befehl. Ergänzen Sie vor dem Senden die aufgabenspezifischen Anweisungen.
5. Senden Sie die Anfrage.
Die separate [Agent-Befehlspalette](../agent/command-palette) verwaltet den Aktivierungszustand: Die Auswahl einer Zeile kann einen Skill installieren, aktivieren oder pausieren. Das unterscheidet sich von der Skill-Auswahl im Eingabefeld.
Wenn der aktuelle Tarif einen Skill nicht enthält, kann Runner stattdessen den **Agent**- oder Upgrade-Pfad öffnen. Speicheroptionen werden nur angezeigt, wenn der Speicher für das Konto aktiviert ist.
Die Befehlsauswahl bereitet den Entwurf vor. Ergänzen und prüfen Sie Ihre Anfrage vor dem Senden.
### Ansehen: Einen Schnellbefehl vorbereiten
Die Aufnahme fügt **store-seo** ins Eingabefeld ein und lässt den Entwurf ungesendet. Es beginnt keine SEO-Analyse.
## Fehlerbehebung
| Problem | Was zu tun ist |
| --- | --- |
| Das Bild wird nicht hinzugefügt | Verwenden Sie ein unterstütztes Bildformat, halten Sie es unter 32 MB und halten Sie die Nachricht auf 10 Bilder oder weniger. |
| **Doppeltes Bild ignoriert** | Das gleiche Bild mit gleichem Namen und Größe ist bereits im Entwurf vorhanden. Behalten Sie die vorhandene Kopie oder entfernen Sie sie, bevor Sie das Bild erneut auswählen. |
| Warnung zu nicht unterstützter Datei | Wählen Sie ein JPG/JPEG-, PNG-, GIF-, WebP-, BMP- oder TIFF-Bild. Wenn **Anhängen** verfügbar ist, können Sie stattdessen ein unterstütztes Dokument wählen. Verwenden Sie andernfalls ein Bild oder fügen Sie den relevanten Text ein. |
| **Screenshot machen** fehlt | Verwenden Sie ein gespeichertes Bild; Live-Erfassung ist bedingt. |
| Bildschirmerfassung stoppt | Geben Sie dem Browser die Berechtigung, wenn angemessen, oder fügen Sie einen normalen Screenshot an. |
| Ein Skill lässt sich nicht umschalten | Warten Sie, bis alle kollidierenden Aktionen im Eingabefeld beendet sind, und prüfen Sie, ob der Tarif den Skill enthält. |
| Ein gesperrtes Modell öffnet die Abrechnung | Schließen Sie den Plan-Bildschirm, um das aktuelle Modell beizubehalten, oder überprüfen Sie den Zugriff mit dem Workspace-Besitzer. |
## Verwandte Leitfäden
- [Schreiben Sie effektive Anfragen](/de/guides/work-with-runner/write-effective-requests)
- [Agent-Befehlspalette](../agent/command-palette)
- [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner)
- [Workspace-Einstellungen](/de/guides/workspace/settings)
---
# Chat mit Runner
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/chat-with-runner
**Was dieser Leitfaden abdeckt:** Sie senden eine fokussierte Anfrage im richtigen Store-Projekt und wissen, was jedes Chat-Steuerelement tut.
Chat ist der Hauptort, um Runner zu bitten, etwas über Ihren Store zu erstellen, zu ändern, zu überprüfen oder zu erklären. Halten Sie ein Hauptergebnis in jeder Anfrage, damit das Ergebnis leichter zu überprüfen ist.
**Einstiegspfad:** Öffnen Sie den gewünschten Store über das Store-Namensmenü → verwenden Sie die aktuelle Aufgabe oder wählen Sie **Neue Aufgabe** in der Seitenleiste.
## Bevor Sie beginnen
- Bestätigen Sie den Store und das Gespräch, bevor Sie eine Anfrage senden.
- Halten Sie ein Hauptergebnis im Entwurf und entfernen Sie Geheimnisse oder unnötige Kundeninformationen.
- Warten Sie auf den Abschluss einer konkurrierenden Eingabeaktion, bevor Sie **Nachricht senden** wählen.
## Chat-Steuerelemente
| Steuerelement | Warum es nützlich ist | Was passiert, wenn Sie es auswählen |
| --- | --- | --- |
| **Neue Aufgabe** | Trennt eine neue Aufgabe von der bisherigen Diskussion. | Runner erstellt und öffnet eine leere Konversation. Die Arbeit beginnt erst mit Ihrer Nachricht. |
| Nachrichtenfeld | Enthält die Anfrage und alle Folgeanweisungen. | Ihr Text bleibt als Entwurf, bis Sie ihn senden. |
| **Hinzufügen** | Gibt Runner visuellen Kontext. | Öffnet **Bild hochladen** oder bei aktivierten Dokumentanhängen **Anhängen**. **Screenshot aufnehmen** ist nur bedingt verfügbar. Auf Mobilgeräten heißt die reine Bildauswahl **Bild**. Formate und Grenzen stehen in der Anleitung zu Anhängen. |
| Profilwähler | Ändert das verfügbare Runner-Arbeitsprofil. | Das ausgewählte Profil wird für die nächste Anfrage verwendet; gesperrte Optionen öffnen den relevanten Plan-Pfad. |
| **Spracheingabe** | Wandelt Sprache in Entwurfstext um. | Fordert Mikrofon-Zugriff an, zeigt **Abhören…**, dann **Verarbeitung…** und fügt das Transkript an den aktuellen Entwurf an. Es sendet die Anfrage nicht. |
| **Weitere Aktionen** | Hält weniger häufig verwendete Tools auf kleineren Layouts verfügbar. | Öffnet Aktionen wie **Spracheingabe** oder **Anfrage verbessern**, wenn sie nicht in die Symbolleiste passen. |
| **Nachricht senden** | Startet die Anfrage. | Ihre Nachricht erscheint in der Konversation und die Aufgabe beginnt. |
| **Stopp** | Unterbricht eine laufende Aufgabe. | Runner stoppt den aktuellen Durchgang und bewahrt das Gespräch, damit Sie es später überprüfen oder fortsetzen können. |
| **Hilfreich** / **Nicht hilfreich** | Geben Sie Feedback zu einer Runner-Antwort. | Öffnet bearbeitbares Feedback. **Nicht hilfreich** erfordert einen Grund oder eine Beschreibung. Bis **Absenden** wird nichts gespeichert; das Teilen des Gesprächskontexts ist optional. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Verwenden Sie **Hinzufügen**, wenn die Anfrage eine Referenz benötigt. Das abgebildete Menü ist vor einem Upload oder dem Senden einer Nachricht geöffnet.
## Anfrage senden
1. Bestätigen Sie, dass der Projektname in der Seitenleiste oder Kopfzeile der Store ist, den Sie ändern möchten.
2. Wählen Sie **Neue Aufgabe**, wenn die Anfrage von der aktuellen Konversation getrennt ist.
3. Geben Sie das gewünschte Ergebnis in das Nachrichtenfeld ein.
4. Fügen Sie wichtigen Kontext, Einschränkungen und Referenzbilder hinzu.
5. Wählen Sie ein Profil oder einen Skill nur, wenn das dieser Aufgabe hilft.
6. Wählen Sie **Nachricht senden**.
7. Halten Sie das Gespräch offen, während Runner arbeitet, oder kehren Sie später über **[Aktuelle Chats](/de/guides/work-with-runner/chats-and-history)** dazu zurück.
8. Wenn Runner eine Frage stellt, beantworten Sie sie, um die Aufgabe fortzusetzen.
9. Öffnen Sie nach Aufgabenende die betroffene Seite oder das Tool und prüfen Sie das gewünschte Ergebnis. Eine Abschlussnachricht allein bestätigt es nicht.
## Mit Spracheingabe verfassen
1. Wählen Sie **Spracheingabe**. Wenn der Browser fragt, geben Sie Mikrofon-Zugriff nur auf einem vertrauenswürdigen Gerät frei.
2. Warten Sie auf **Abhören…**, dann sprechen Sie eine fokussierte Anweisung.
3. Wählen Sie **Spracheingabe stoppen**, wenn Sie fertig sind.
4. Lassen Sie das Eingabefeld geöffnet, während Runner **Verarbeitung…** anzeigt.
5. Überprüfen Sie den zum Entwurf hinzugefügten Text. Runner fügt ihn nach bereits vorhandenem Text an.
6. Korrigieren Sie Namen, Zahlen, URLs und Produktdetails, bevor Sie **Nachricht senden** wählen.
Die Spracheingabe bereitet nur Text vor. Erst **Nachricht senden** startet eine Anfrage.
## Während Runner arbeitet
- Eine laufende Aufgabe zeigt aktiven Fortschritt im Gespräch.
- **Details** öffnet den Schritt-für-Schritt-Aufgabendatensatz, wenn er verfügbar ist.
- **Stopp** ist während Arbeiten verfügbar, die unterbrochen werden können.
- Die Vorschau oder andere Canvas-Registerkarten können aktualisiert werden, während Runner Ergebnisse erzeugt.
- Eine Aufgabe, die auf Eingabe wartet, benötigt Ihre Antwort, bevor Runner sicher fortfahren kann.
## Fehlerbehebung
| Was Sie sehen | Was es bedeutet | Was zu tun ist |
| --- | --- | --- |
| **Nachricht senden** ist nicht verfügbar | Der Entwurf ist leer, eine erforderliche Eingabe fehlt oder eine andere Aktion wird noch vorbereitet. | Ergänzen Sie eine klare Anfrage und warten Sie auf den Abschluss der aktuellen Eingabeaktion. |
| Ein Profil ist gesperrt | Es ist nicht im aktuellen Plan oder Konto-Zugriff enthalten. | Behalten Sie das aktuelle Profil bei oder folgen Sie dem **Plan & Abrechnung**-Pfad, den Runner öffnet. |
| **Spracheingabe nicht verfügbar** | Der Browser oder das Gerät kann nicht über dieses Steuerelement aufzeichnen. | Geben Sie die Anfrage ein oder verwenden Sie einen unterstützten Browser und ein unterstütztes Gerät. |
| Mikrofon-Berechtigung verweigert | Der Browser hat die Aufzeichnung blockiert. | Geben Sie Zugriff nur bei Bedarf frei, starten Sie dann die Spracheingabe erneut; geben Sie andernfalls die Anfrage ein. |
| **Keine Sprache erkannt** oder Transkription fehlgeschlagen | Runner hat keinen verwendbaren Text zum Entwurf hinzugefügt. | Behalten Sie den vorhandenen Entwurf, überprüfen Sie das Mikrofon und versuchen Sie es erneut oder geben Sie den fehlenden Text ein. |
| Die Aufgabe wartet | Runner benötigt eine Entscheidung oder weitere Informationen. | Beantworten Sie die sichtbare Frage oder wählen Sie **Überspringen**, falls angeboten, damit Runner nach bestem Ermessen fortfährt. |
| Die Aufgabe ist fehlgeschlagen | Runner konnte den Durchgang nicht abschließen. | Lesen Sie den Fehler und **Details**, wählen Sie dann **Erneut versuchen**, wenn angeboten, oder senden Sie eine engere Folgeanfrage. |
| Sie haben den falschen Store geöffnet | Das Gespräch gehört zu einem anderen Projekt. | Kehren Sie zum Workspace zurück, öffnen Sie den beabsichtigten Store und starten Sie die Anfrage dort. |
## Verwandte Leitfäden
- [Schreiben Sie effektive Anfragen](/de/guides/work-with-runner/write-effective-requests)
- [Bilder, Modelle und Skills](/de/guides/work-with-runner/attachments-profiles-and-skills)
- [Wenn Runner eine Frage stellt](/de/guides/work-with-runner/answer-runner-questions)
- [Aufgabenzustände und Details](/de/guides/work-with-runner/task-states-and-details)
---
# Chats und Verlauf
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/chats-and-history
**Was dieser Leitfaden abdeckt:** Sie halten Projektgespräche organisiert und öffnen den richtigen Kontext, wenn Sie ihn benötigen.
Jeder Store hat seine eigene Gesprächshistorie. Verwenden Sie separate Chats für unterschiedliche Ergebnisse und halten Sie Folgeprojekte im selben Chat, wenn sie von früheren Entscheidungen abhängen.
**Einstiegspfad:** Store öffnen → Aufgabenverlauf in der Seitenleiste aufklappen. Je nach Arbeitsbereich heißt die Liste **Shop-Aufgaben** oder **Letzte Chats**. Die Suche verwendet weiterhin die Ergebnisüberschrift **Letzte Chats**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Durchsuchen Sie Ihren Store; 2. Starten Sie eine neue Aufgabe; 3. Öffnen Sie ein Arbeitsbereich-Tool; 4. Öffnen Sie eine gespeicherte Aufgabe erneut. Wählen Sie das Bild aus, um es zu vergrößern. Die nummerierten Markierungen beziehen sich auf die englische Desktop-Oberfläche.
## Bevor Sie beginnen
- Bestätigen Sie den aktuellen Store, da jedes Projekt seine eigene Gesprächshistorie hat.
- Lassen Sie eine aktive Umbenennungs- oder Aufgabenaktion beenden, bevor Sie Gespräche ändern.
- Behalten Sie einen Chat, wenn Sie unsicher sind; das Löschen entfernt den Kontext und erfordert eine Bestätigung.
## Gesprächssteuerelemente
| Steuerelement oder Status | Was passiert |
| --- | --- |
| **Neue Aufgabe** | Öffnet eine leere Konversation. Erst das Senden einer Nachricht startet eine Aufgabe. |
| Eine Zeile im Store-Aufgabenverlauf | Öffnet die Konversation und ihren gespeicherten Aufgabenverlauf. |
| Aktivitätsspinner | Zeigt an, dass das Gespräch derzeit laufende Arbeiten hat. |
| Untätiger Punkt | Zeigt an, dass das Gespräch derzeit nicht läuft. |
| Chat-Optionen → **Umbenennen** | Öffnet ein Dialogfeld, in dem Sie einen klareren Chat-Namen eingeben und speichern können. |
| Chat-Optionen → **Löschen** | Öffnet eine Bestätigung, bevor das Gespräch entfernt wird. |
## Starten oder öffnen Sie einen Chat erneut
1. Öffnen Sie das richtige Store-Projekt.
2. Klappen Sie die Seitenleiste auf und öffnen Sie die Store-Aufgabenliste, falls angezeigt.
3. Wählen Sie **Neue Aufgabe** für unabhängige Arbeit oder einen vorhandenen Chat, um dessen Kontext fortzusetzen.
4. Überprüfen Sie den Gesprächstitel und die neuesten Nachrichten, bevor Sie neue Anweisungen senden.
5. Prüfen Sie, ob die geöffneten Nachrichten zur gewünschten Aufgabe gehören. Geben Sie die nächste Anfrage ein und wählen Sie **Nachricht senden**.
## Benennen Sie einen Chat um
1. Suchen Sie die Konversation im Aufgabenverlauf des aktuellen Stores.
2. Öffnen Sie sein Optionsmenü.
3. Wählen Sie **Umbenennen**.
4. Geben Sie einen Namen ein, der das Ergebnis beschreibt, z. B. "Startseite der Sommerkollektion aktualisieren".
5. Speichern Sie die Änderung. Der neue Name wird in der Liste der aktuellen Chats angezeigt.
## Löschen Sie einen Chat sorgfältig
1. Öffnen Sie das Optionsmenü des Gesprächs.
2. Wählen Sie **Löschen**.
3. Lesen Sie die Bestätigung und überprüfen Sie den Chat-Namen.
4. Brechen Sie ab, wenn Sie seine Anweisungen oder Ergebnisse noch benötigen. Bestätigen Sie nur, wenn Sie es entfernen möchten.
## Fehlerbehebung
| Status | Was zu tun ist |
| --- | --- |
| Der Aufgabenverlauf ist leer oder fehlt | Senden Sie eine Anfrage in einem neuen Chat. Der Bereich erscheint, sobald das Projekt einen Konversationsverlauf hat. |
| Ein laufender Chat wird nicht sofort geöffnet | Warten Sie, bis die Navigation beendet ist; Runner kann unvollendete Arbeiten schützen, bevor Ansichten geändert werden. |
| Sie können einen Chat nicht durch Scannen der Liste finden | Öffnen Sie die Projektsuche mit `Command/Control + K` und suchen Sie **Aktuelle Chats**. |
| Ein umbenannter Titel wurde nicht aktualisiert | Öffnen Sie die Chat-Liste erneut und versuchen Sie das Umbenennen erneut, nachdem sich der aktuelle Aufgabenstatus stabilisiert hat. |
| Sie sind unsicher, ob Sie löschen sollen | Behalten Sie den Chat. Das Umbenennen ist die sicherere Möglichkeit, Verwirrung zu reduzieren. |
## Verwandte Leitfäden
- [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner)
- [Projektnavigation und Suche](/de/guides/work-with-runner/project-navigation-and-search)
- [Aufgabenstatus und Details](/de/guides/work-with-runner/task-states-and-details)
---
# Projektnavigation und Suche
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/project-navigation-and-search
Die Seitenleiste gruppiert Tools nach Ihrer Arbeit. Die Suche findet verfügbare Ziele oder Konversationen im aktuellen Store.
**Einstiegspfad:** Gewünschten Store öffnen → Seitenleiste aufklappen → **Aufbauen**, **Wachstum**, **Messen** oder **Suchen**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Durchsuchen Sie Ihren Store; 2. Starten Sie eine neue Aufgabe; 3. Öffnen Sie ein Arbeitsbereich-Tool; 4. Öffnen Sie eine gespeicherte Aufgabe erneut. Wählen Sie das Bild aus, um es zu vergrößern. Die nummerierten Markierungen beziehen sich auf die englische Desktop-Oberfläche.
## Bevor Sie beginnen
- Prüfen Sie den Store-Namen vor der Navigation oder dem Start einer Aufgabe.
- Sichern Sie einen ungesendeten Entwurf, bevor Sie seine Konversation verlassen.
- Verfügbare Tools hängen von Store-Typ, Tarif, Rolle und aktivierten Funktionen ab. Ein sichtbarer Eintrag kann weiterhin eine Voraussetzung oder Tarifseite öffnen.
## Ein Ziel finden
| Bereich | Mögliche Ziele | Zweck |
| --- | --- | --- |
| **Onlineshop** | Vorschau, Bearbeitung, Versionsverlauf, Veröffentlichung | Prüfen und ändern, was Kunden sehen. |
| **Aufbauen** | **Shop-Betrieb**, **Dropshipping**, **Print-on-Demand**, **Apps**, **Webhooks** | Store, Katalog und Verbindungen einrichten. |
| **Wachstum** | **Werbung**, **SEO**, **E-Mail**, **Automatisierungen**, **Studio**, **Medien** | Wachstumsmaßnahmen und wiederverwendbare Medien erstellen und verwalten. |
| **Messen** | **Analysen**, **Experimente**, **Simulation**, **Forschung** | Leistung prüfen oder einer Geschäftsfrage nachgehen. |
| **Agent** | **Skills**, **Speicher**, falls aktiviert | Wiederverwendbare Anweisungen und gespeicherte Fakten verwalten. |
| **Fly**, falls angezeigt | Geführte Geschäftsmissionen | Dem verfügbaren Missionsablauf folgen. |
1. Klappen Sie die Gruppe für Ihr Ziel auf.
2. Wählen Sie das Ziel.
3. Prüfen Sie Seitenüberschrift und aktuellen Store.
4. Folgen Sie Einrichtungs- oder Tarifhinweisen, bevor Sie die Funktion verwenden.
**Dropshipping** kann je nach Store beispielsweise eine eigene Beschaffungsansicht oder den zugehörigen Bereich im Shop-Betrieb öffnen. Folgen Sie der tatsächlich angezeigten Seite. Die gruppierte Navigation ersetzt das ältere Überlaufmenü **Mehr**.
## Ziele und Aufgaben suchen
**Tastenkürzel:** `Command + K` unter macOS oder `Control + K` unter Windows und Linux.
1. Wählen Sie **Suchen** oder verwenden Sie das Tastenkürzel.
2. Geben Sie einen Teil des Ziel- oder Aufgabentitels ein.
3. Überprüfen Sie die Ergebnisse unter **Kontrollzentrum** und **Letzte Chats**.
4. Wählen Sie ein Ergebnis unter **Kontrollzentrum**, um ein Tool zu öffnen, oder unter **Letzte Chats**, um eine Konversation erneut zu öffnen.
5. Prüfen Sie, ob die gewünschte Seite oder die richtigen Nachrichten sichtbar sind, bevor Sie fortfahren.
6. Drücken Sie `Escape`, um die Suche ohne Navigation zu schließen.
**Kontrollzentrum** ist eine Überschrift der Suchergebnisse, kein eigener Bereich, den Sie in der Seitenleiste suchen müssen.
## Zu einem anderen Store wechseln
1. Öffnen Sie das aktuelle Store-Namensmenü oben in der Seitenleiste.
2. Wählen Sie den gewünschten Store.
3. Prüfen Sie nach dem Wechsel den neuen Store-Namen.
Das Menü bietet auch **Geschäft erstellen** und **Workspace-Einstellungen**. Es zeigt keine Vorschau der Store-Liste eines anderen Arbeitsbereichs. Lesen Sie [Arbeitsbereichsnavigation](/de/guides/workspace/navigation-and-search) für Einstellungen und Kontonavigation.
Die Suche zeigt verfügbare Ziele unter **Kontrollzentrum**. Wählen Sie ein Ergebnis zum Navigieren oder drücken Sie Escape, um auf der aktuellen Seite zu bleiben.
### Ansehen: Navigationssuche filtern
Die Aufnahme gibt **Analysen** ein und prüft das passende Ziel. Sie endet vor dem Öffnen des Ergebnisses; wählen Sie selbst ein Ergebnis zum Navigieren.
## Fehlerbehebung
| Was Sie sehen | Was Sie tun können |
| --- | --- |
| Ergebnisse werden geladen | Warten Sie auf das Ende des Ladevorgangs, bevor Sie eine Zeile wählen. |
| **Keine Ergebnisse** | Kürzen Sie die Suche oder verwenden Sie den sichtbaren Tool-Namen. Leeren Sie die Suche, um verfügbare Ergebnisse zu sehen. |
| **Suche fehlgeschlagen** | Wählen Sie **Erneut versuchen**, falls angezeigt. |
| Ein Tool fehlt in seiner Gruppe | Prüfen Sie die Suche und die Voraussetzungen der Funktion. Die Verfügbarkeit kann je nach Store abweichen. |
| Die Navigation pausiert | Lassen Sie die Aufgabe geöffnet und folgen Sie Hinweisen zu unfertiger Arbeit. |
| Stattdessen öffnet sich eine Skill-Auswahl | Schließen Sie sie und verwenden Sie **Suchen** in der Seitenleiste. Die [Agent-Befehlspalette](/de/guides/agent/command-palette) verwaltet Skills, nicht die Navigation. |
## Verwandte Leitfäden
- [Chats und Verlauf](/de/guides/work-with-runner/chats-and-history)
- [Arbeitsbereichsnavigation und Suche](/de/guides/workspace/navigation-and-search)
- [Agent-Befehlspalette](/de/guides/agent/command-palette)
- [Mit Runner chatten](/de/guides/work-with-runner/chat-with-runner)
---
# Aufgabenzustände und Details
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/task-states-and-details
**Was dieser Leitfaden abdeckt:** Sie wissen, ob eine Aufgabe funktioniert, wartet, beendet, unterbrochen ist oder einen weiteren Versuch benötigt.
Aufgabenzustände zeigen Ihnen, was Runner als Nächstes benötigt. Die Detailansicht und die Projekt-Canvas helfen Ihnen, die Arbeit zu überprüfen, ohne nur aus der letzten Chat-Nachricht zu raten.
**Einstiegspfad:** Öffnen Sie ein Store-Projekt → wählen Sie ein Gespräch → überprüfen Sie die aktuelle Aufgabenkarte und wählen Sie **Details**, wenn verfügbar.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgDROEIVBmoeRbFHcSPrynU5Il76xY2q981Nj4)
1. Prüfen Sie den Aufgabenstatus. 2. Wählen Sie Details, um die Arbeit zu prüfen. Diese Beispielkarte zeigt eine abgeschlossene Aufgabe. Der Abschluss allein belegt nicht, dass der Store veröffentlicht ist oder der Checkout funktioniert. Wählen Sie das Bild aus, um es zu vergrößern.
## Bevor Sie beginnen
- Bestätigen Sie das aktuelle Gespräch und die neueste Aufgabe, bevor Sie auf einen Zustand reagieren.
- Halten Sie den sichtbaren Fehler oder die wartende Frage verfügbar, bis die Wiederherstellung erfolgreich ist.
- Behandeln Sie eine abgeschlossene Aufgabe nicht als Beweis dafür, dass Vorschau, Veröffentlichung oder ein externer Anbieter erfolgreich war.
## Aufgabenzustände
| Zustand | Bedeutung | Was als Nächstes zu tun ist |
| --- | --- | --- |
| Läuft | Runner arbeitet aktiv an der Anfrage. | Folgen Sie dem Fortschritt, öffnen Sie **Details** oder wählen Sie **Stopp**, wenn die Aufgabe nicht fortgesetzt werden sollte. |
| Warten auf Eingabe | Runner benötigt Ihre Auswahl oder fehlende Informationen. | Beantworten Sie die aktive Frage oder wählen Sie **Überspringen**, falls angeboten, damit Runner nach bestem Ermessen fortfährt. |
| Abgeschlossen | Runner hat den aktuellen Durchgang beendet. | Überprüfen Sie die Nachricht, Details, Vorschau und alle geänderten Projektbereiche. |
| Fehlgeschlagen | Runner konnte den Durchgang nicht abschließen. | Lesen Sie den Fehler und Details, wählen Sie dann **Erneut versuchen**, wenn angeboten, oder senden Sie eine engere Anfrage. |
| Gestoppt | Sie oder Runner haben den Durchgang unterbrochen. | Überprüfen Sie die Teilarbeit, senden Sie dann eine neue Anweisung, wenn die Aufgabe fortgesetzt werden sollte. |
Eine abgeschlossene Aufgabe bedeutet, dass der Gesprächsdurchgang erfolgreich beendet wurde. Es beweist nicht von selbst, dass ein Store veröffentlicht, eine Zahlung durchgeführt oder ein externer Service eine Änderung akzeptiert hat.
## Überprüfen Sie die Arbeit
1. Wählen Sie **Details** auf der Aufgabe.
2. Folgen Sie den Schritt-für-Schritt-Einträgen, um zu verstehen, was Runner versucht hat.
3. Öffnen Sie **Nutzung**, wenn angezeigt, um die angezeigten Credits, Tool-Aufrufe und Agent-Aktivität zu überprüfen.
4. Überprüfen Sie den Arbeitsplan, wenn die Aufgabe einen enthält.
5. Verwenden Sie **Vorschau** oder **Onlineshop**, um das kundenorientierte Ergebnis zu überprüfen.
6. Öffnen Sie andere relevante Canvas-Registerkarten, wie eine Datei oder ein Ergebnis, das Runner angezeigt hat.
7. Verwenden Sie **Registerkarte hinzufügen**, um eine andere verfügbare Ansicht zu öffnen, und **Registerkarte schließen**, um eine Ansicht aus der Canvas zu entfernen.
8. Überprüfen Sie **Versionsverlauf**, wenn Sie einen früheren Projektzustand vergleichen oder finden müssen.
9. Vergleichen Sie das tatsächliche Seiten- oder Tool-Ergebnis mit Ihrem gewünschten Ergebnis. Benennen Sie verbleibende Probleme in einer gezielten Folgeanfrage.
Öffnen Sie nur die Aufgabenansichten, die Runner tatsächlich anbietet. Verfügbare Detail- und Arbeitsflächenansichten hängen von der Anfrage ab.
## Überprüfen Sie eine Storefront-Version aus einer abgeschlossenen Arbeitskarte
> **Bedingt verfügbar:** Versionsbeschriftungen und historische Vorschauen benötigen gespeicherte Storefront-Versionen und Zugang zu Versionskarten. Ältere Projekte ohne gespeicherten Versionsverlauf können auf der neuesten Storefront-Arbeitskarte weiterhin **Vorschau** zeigen. Diese Aktion öffnet die aktuelle Live-Vorschau, keine genaue historische Version. Falls keine Kartenaktion erscheint, öffnen Sie [Vorschau](/de/guides/storefront-and-publishing/preview-your-store) direkt.
| Steuerelement oder Zustand | Was es bedeutet oder tut |
| --- | --- |
| **v…** | Identifiziert die auf der abgeschlossenen Arbeitskarte angezeigte Storefront-Version. |
| **Aktuelle Version** | Markiert die neueste Version des Projekts. |
| **Veröffentlicht** | Markiert eine Version, die mit einer abgeschlossenen Veröffentlichung verknüpft ist; es beweist nicht, dass der Checkout noch funktioniert. |
| **Wird erstellt…** | Die Version ist noch nicht vorschaubereit. |
| **Build fehlgeschlagen** | Die Version konnte keinen vorschaubereiten Zustand erreichen. Öffnen Sie **Details** und behalten Sie alle sichtbaren Fehler-Kontexte, bevor Sie Runner bitten, es zu beheben. |
| Storefront-Bild oder **Vorschau** | Öffnet genau die fertige Version, wenn Versionsdaten vorhanden sind. Auf der neuesten Karte eines älteren Projekts ohne Versionsverlauf öffnet die Aktion stattdessen die aktuelle Live-Vorschau der Storefront. Ältere, nicht zugehörige Karten zeigen keine **Vorschau**. |
| **Veröffentlichen** | Wird nur für eine unveröffentlichte aktuelle Version angezeigt und öffnet Veröffentlichungsprüfungen. Es wird nicht für eine historische oder bereits veröffentlichte Version angezeigt. |
| Versionsinformationen werden aktualisiert | Das Storefront-Bild, **Vorschau** und **Veröffentlichen** für die aktuelle Version bleiben sichtbar, sind aber vorübergehend deaktiviert. Wenn Sie sie auswählen, geschieht nichts, bis die Aktualisierung abgeschlossen ist. |
Prüfen Sie die Versionsbeschriftung, bevor Sie einen Screenshot beurteilen oder **Veröffentlichen** wählen. Eine fertige historische Vorschau bleibt schreibgeschützt, bis Sie bewusst über den verfügbaren Ablauf eine aktuelle Version wiederherstellen oder veröffentlichen.
Unterscheiden Sie anhand der Versionsbeschriftungen das aktuelle Ergebnis von früherer Arbeit. Dieses Bild zeigt den Versionsverlauf, nicht die Aufgaben-Detailansicht. Es wurde keine Version wiederhergestellt oder veröffentlicht.
## Gesprächs-Steuerelemente
| Steuerelement | Was passiert |
| --- | --- |
| **Details** / **Details ausblenden** (oder **Ausblenden** in einem schmalen Bereich) | Öffnet den Schritt-für-Schritt-Aufgabendatensatz in der Canvas oder gibt die Canvas zur **Onlineshop** zurück. Das Ausblenden entfernt den Aufgabendatensatz nicht. |
| **Erneut versuchen** | Startet einen weiteren Versuch für eine fehlgeschlagene Aufgabe, wenn die Aktion angeboten wird. |
| **Zur neuesten Nachricht springen** | Verschiebt das Gespräch zum neuesten Eintrag. |
| Transkript-Gliederung | Ermöglicht es Ihnen, zu einem sichtbaren Abschnitt eines längeren Aufgabendatensatzes zu wechseln. |
| **Vorschau** oder **Onlineshop** | Öffnet die kundenorientierte Arbeitsansicht des Projekts. |
| **Registerkarte hinzufügen** | Öffnet die Liste der für dieses Projekt und diese Aufgabe verfügbaren Canvas-Ansichten. |
| **Registerkarte schließen** | Entfernt die ausgewählte Ansicht aus der Canvas; es löscht nicht den zugrunde liegenden Projektinhalt. |
## Wenn der Fortschritt stecken zu bleiben scheint
- Überprüfen Sie, ob eine unbeantwortete Frage weiter unten im Gespräch wartet.
- Öffnen Sie **Details**, um den letzten abgeschlossenen Schritt zu identifizieren.
- Verwenden Sie **Zur neuesten Nachricht springen**, wenn das Gespräch vom aktiven Zustand entfernt ist.
- Wählen Sie nicht wiederholt **Erneut versuchen**, während bereits ein anderer Versuch läuft.
- Wenn Sie eine Aufgabe stoppen, überprüfen Sie Teilergebnisse, bevor Sie Runner bitten, fortzufahren.
## Verwandte Leitfäden
- [Wenn Runner eine Frage stellt](/de/guides/work-with-runner/answer-runner-questions)
- [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner)
- [Chats und Verlauf](/de/guides/work-with-runner/chats-and-history)
- [Verstehen Sie Store-Status](/de/guides/workspace/store-statuses)
- [Versionsverlauf](/de/guides/storefront-and-publishing/version-history)
---
# Schreiben Sie effektive Anfragen
Source: https://www.runnerai.com/docs/de/guides/work-with-runner/write-effective-requests
**Was dieser Leitfaden abdeckt:** Sie schreiben Anfragen, die für Runner leichter zu bearbeiten sind und für Sie leichter zu überprüfen sind.
Eine nützliche Anfrage beschreibt das Ergebnis, nicht nur das Thema. Geben Sie genug Kontext, um die nächste Entscheidung klar zu machen, verwenden Sie dann Folgeanfragen für fokussierte Verfeinerungen.
**Einstiegspfad:** Store öffnen → **Neue Aufgabe** oder aktuelle Aufgabe → Nachrichteneingabe.
## Bevor Sie beginnen
- Bestätigen Sie den Store und die Seite oder den Workflow, den Sie ändern möchten.
- Entscheiden Sie sich für ein sichtbares Ergebnis und alle Grenzen, die Runner bewahren muss.
- Entfernen Sie Passwörter, Geheimnisse, Zahlungsdetails und unnötige Kundeninformationen.
## Steuerelemente und Ergebnisse des Eingabefelds
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Weitere Aktionen** | Öffnet seltener verwendete Werkzeuge des Eingabefelds, wenn sie nicht in die Symbolleiste passen. |
| **Anfrage verbessern** | Generiert einen verfeinerten Entwurf; es sendet die Anfrage nicht oder ändert den Store. |
| **Akzeptieren** | Ersetzt den Entwurf im Eingabefeld durch die angezeigte Verfeinerung. |
| **Verwerfen** | Schließt die Verfeinerung und behält den vorhandenen Entwurf. |
| **Erneut generieren** | Fordert eine andere verfeinerte Version an. |
| **Auf Original zurücksetzen** | Stellt die frühere Formulierung nach einer akzeptierten Verfeinerung wieder her. |
| **Nachricht senden** | Fügt den fertigen Entwurf zur Konversation hinzu und startet die Aufgabe. |
## Eine einfache Anfrage-Struktur
Fügen Sie diese fünf Teile ein, wenn sie wichtig sind:
1. **Ziel:** Was sollte anders sein, wenn die Arbeit erledigt ist?
2. **Store-Kontext:** Was verkaufen Sie und wer ist der Kunde?
3. **Aktuelles Problem:** Was ist jetzt verwirrend, fehlend oder unterdurchschnittlich?
4. **Gewünschtes Ergebnis:** Was sollte ein Kunde sehen oder tun können?
5. **Grenzen:** Was muss unverändert bleiben und was sollte Runner überprüfen?
**Zum Beispiel:**
> Aktualisieren Sie den Homepage-Hero für unseren minimalistischen Reisegepäck-Store. Machen Sie die Handgepäck-Kollektion zum Hauptfokus, behalten Sie die vorhandene Navigation und Produktdaten, und machen Sie die primäre Aktion zu dieser Kollektion. Überprüfen Sie das Ergebnis auf Mobilgeräten und Desktop, bevor Sie fertig sind.
## Senden Sie eine gut abgegrenzte Anfrage
1. Beginnen Sie mit einem zusammenhängenden Ergebnis.
2. Benennen Sie die betroffene Seite, den Abschnitt, das Produkt oder den Ablauf.
3. Beschreiben Sie die Kundenaktion, die Sie verbessern möchten.
4. Fügen Sie ein Referenzbild hinzu, wenn Aussehen oder vorhandener Inhalt wichtig sind.
5. Nennen Sie alles, was Runner unverändert lassen muss.
6. Fordern Sie die gewünschten Prüfungen an, etwa mobiles Layout oder einen bestimmten Klickpfad.
7. Wählen Sie **Nachricht senden**.
8. Prüfen Sie das Ergebnis und senden Sie jeweils eine gezielte Korrektur.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Vergleichen Sie das Ergebnis mit Ihrer Anfrage: Das Beispiel fordert eine Überschrift über einen ruhigeren Morgen, während Layout und Produkte erhalten bleiben. Dieses Bild zeigt die entstandene Vorschau, nicht den Dialog **Prompt verbessern**.
## Verwenden Sie Anfrage verbessern, wenn verfügbar
1. Entwerfen Sie die Anfrage im Nachrichtenfeld.
2. Öffnen Sie **Weitere Aktionen**, falls **Prompt verbessern** nicht sichtbar ist.
3. Wählen Sie **Prompt verbessern**.
4. Warten Sie, während **Wird verbessert…** erscheint.
5. Prüfen Sie den **Verfeinerter Prompt**. Achten Sie auf die gewünschte Seite, Kundenaktion und alles, was unverändert bleiben soll.
6. Wählen Sie **Akzeptieren**, um ihn zu verwenden, **Schließen**, um Ihren Entwurf zu behalten, oder **Neu generieren** für eine weitere Version.
7. Mit **Auf Original zurücksetzen** können Sie nach dem Übernehmen die frühere Formulierung wiederherstellen.
8. Wählen Sie **Nachricht senden** erst, wenn die Anfrage weiterhin Ihrer Absicht entspricht.
## Vermeiden Sie mehrdeutige Anfragen
| Statt | Versuchen Sie |
| --- | --- |
| "Machen Sie es besser." | "Machen Sie die Sammlungskarten auf Mobilgeräten leichter zu scannen, während Sie ihre aktuellen Produktlinks behalten." |
| "Beheben Sie den Checkout." | "Verfolgen Sie den Pfad Zum Warenkorb hinzufügen → Warenkorb → Checkout und sagen Sie mir, wo er stoppt, bevor Sie etwas ändern." |
| "Kopieren Sie diese Website." | "Verwenden Sie dies als Referenz für Abstände und Ton, aber behalten Sie unser eigenes Branding, unsere Produkte und Navigation." |
| Eine lange Liste unzusammenhängender Änderungen | Starten Sie einen Chat für das Hauptergebnis, erstellen Sie dann einen anderen für separate Arbeiten. |
## Wiederherstellung, wenn das Ergebnis das Ziel verfehlt
- Zeigen Sie auf den genauen Teil, der falsch ist.
- Beschreiben Sie das erwartete Klick-Ergebnis oder den sichtbaren Zustand.
- Fügen Sie ein klareres Referenzbild hinzu, wenn das frühere unklar war.
- Beantworten Sie Runner-Fragen, anstatt die vollständige Anfrage zu wiederholen.
- Lesen Sie bei einer fehlgeschlagenen Aufgabe **Details**, bevor Sie **Erneut versuchen** auswählen.
## Verwandte Leitfäden
- [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner)
- [Bilder, Modelle und Skills](/de/guides/work-with-runner/attachments-profiles-and-skills)
- [Wenn Runner eine Frage stellt](/de/guides/work-with-runner/answer-runner-questions)
- [Aufgabenzustände und Details](/de/guides/work-with-runner/task-states-and-details)
---
# Arbeitsbereich
Source: https://www.runnerai.com/docs/de/guides/workspace
Ein Arbeitsbereich umfasst Stores und Teammitglieder. Nach der Anmeldung kann Runner direkt Ihren aktuellen Store öffnen. Prüfen Sie seinen Namen, bevor Sie Änderungen anfordern.
**Einstiegspfad:** Anmelden → aktueller Store → Store-Namensmenü oder **Workspace-Einstellungen**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Beginnen Sie mit dem Store-Namensmenü, um den aktuellen Arbeitskontext zu prüfen.
## Ihre nächste Aufgabe wählen
| Was Sie benötigen | Anleitung |
| --- | --- |
| Store wechseln, weiteren Store erstellen oder Löschung prüfen | [Stores verwalten](/de/guides/workspace/manage-stores) |
| **Live** und **Unveröffentlichter Entwurf** verstehen | [Store-Zustände](/de/guides/workspace/store-statuses) |
| Tool, Aufgabe oder Einstellungsbereich finden | [Navigation und Suche](/de/guides/workspace/navigation-and-search) |
| Teammitglied hinzufügen oder Zugriff ändern | [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations) |
| Empfehlung teilen, ohne Arbeitsbereichszugriff zu gewähren | [Freunde einladen](/de/guides/workspace/invite-friends) |
| Produkt- und Konto-Neuigkeiten lesen | [Posteingang und Benachrichtigungen](/de/guides/workspace/inbox-and-notifications) |
| Einstellungen für Arbeitsbereich, Shop oder Konto ändern | [Einstellungen des Arbeitsbereichs](/de/guides/workspace/settings) |
## Nach der Anmeldung orientieren
1. Lesen Sie den Store-Namen oben in der Seitenleiste.
2. Öffnen Sie dessen Menü, wenn Sie einen anderen Store oder **Workspace-Einstellungen** benötigen.
3. Klappen Sie **Aufbauen**, **Wachstum** oder **Messen** auf, um Tools für den aktuellen Store zu finden.
4. Finden Sie mit **Suchen** ein Tool oder eine aktuelle Konversation.
5. Öffnen Sie **Onlineshop**, um den aktuellen Vorschau- oder Live-Stand zu prüfen.
Wenn der Arbeitsbereich leer ist, folgen Sie zuerst der Aufforderung zum Erstellen eines Stores. Eine abgeschlossene Aufgabe, eine vorbereitete Vorschau und eine Veröffentlichung sind getrennte Ergebnisse.
## Zugriff und Einstellungen
- Ihre Rolle bestimmt, welche Mitglieder- und Arbeitsbereichsänderungen Sie vornehmen dürfen.
- Store- oder Mitgliederlimits können Erstellungs- oder Einladungsaktionen durch einen Tarifhinweis ersetzen.
- Arbeitsbereichseinstellungen betreffen das Team. **Einstellungen** in der Seitenleiste beginnt beim aktuellen Store; **Meine Einstellungen** gehört zu Ihrem Konto.
- **Freunde einladen** ist eine Empfehlung. Verwenden Sie **Mitglieder**, um Zugang zu diesem Arbeitsbereich zu gewähren.
## Verwandte Leitfäden
- [Ihren ersten Store erstellen](/de/guides/start-here/first-store-quickstart)
- [Mit Runner chatten](/de/guides/work-with-runner/chat-with-runner)
- [Willkommensführung und tägliche Credits](/de/guides/start-here/welcome-tour-and-daily-credits)
---
# Posteingang und Benachrichtigungen
Source: https://www.runnerai.com/docs/de/guides/workspace/inbox-and-notifications
**Was dieser Leitfaden abdeckt:** Sie finden ungelesene Updates und wissen, was passieren kann, wenn Sie eine Benachrichtigung auswählen.
Der **Posteingang** kombiniert Benachrichtigungen über alle Workspaces, auf die Sie zugreifen können. Er unterscheidet sich von optionalen Browser-Benachrichtigungen, die ankündigen, wenn eine Runner-Aufgabe abgeschlossen ist.
**Einstiegspfad:** Obere Desktop-Leiste → Glockensymbol. Öffnen Sie auf Mobilgeräten das Konto- oder Navigationsmenü und wählen Sie **Posteingang**, falls angezeigt.
Auf dem Desktop öffnet die Glocke ein Panel neben dem Workspace. Auf Mobilgeräten öffnet es eine untere Schublade. Ein blauer Punkt auf der Glocke zeigt an, dass ungelesene Benachrichtigungen vorhanden sind.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1IjV7HprvDHKGRP0BUIpjksTZQ9oN4rSwzeq)
Beginnen Sie in Inbox mit **All** oder wählen Sie eine Kategorie wie **Release**. Das Bild zeigt nur die Kategorieauswahl.
Wählen Sie das Bild aus, um es zu vergrößern. Die Anmerkungen sind auf Englisch.
## Bevor Sie beginnen
- Bestätigen Sie den [Workspace](/de/guides/workspace) und das betroffene Projekt, bevor Sie einer Benachrichtigung folgen.
- Speichern Sie einen ungesendeten Entwurf, da eine Benachrichtigung zu einer anderen Seite oder einem anderen Projekt navigieren kann.
- Vermeiden Sie Browser-Aufgabenbenachrichtigungen auf einem gemeinsamen Bildschirm, wenn deren Text Arbeitsdetails offenbaren könnte.
## Posteingangssteuerelemente
| Steuerelement oder Zustand | Was passiert |
| --- | --- |
| **Alle** | Zeigt jede verfügbare Benachrichtigungskategorie. |
| **Abonnement** | Filtert auf Plan- und Abrechnungsaktualisierungen. |
| **Veröffentlichung** | Filtert auf Produktveröffentlichungsaktualisierungen. |
| **Ereignis** | Filtert auf Ereignisbenachrichtigungen. |
| Benachrichtigungszeile | Führt die dieser Benachrichtigung zugewiesene Aktion aus, falls vorhanden. |
| Posteingang schließen oder Registerkarten wechseln | Markiert Benachrichtigungen, die ausreichend sichtbar waren, als gelesen. Es markiert nicht alle Elemente auf einmal. |
| Zum unteren Rand scrollen | Lädt mehr Benachrichtigungen, wenn mehr verfügbar sind. |
Der Posteingang hat kein Steuerelement **Alle als gelesen markieren** und keinen separaten Wiederholungsbildschirm für eine fehlgeschlagene Anfrage.
## Benachrichtigungen lesen
1. Wählen Sie das Glockensymbol.
2. Beginnen Sie mit **Alle** oder wählen Sie eine Kategorie.
3. Lesen Sie den Titel, die Nachricht, die relative Zeit und den ungelesenen Punkt.
4. Scrollen Sie, wenn Sie ältere Elemente laden möchten.
5. Wählen Sie eine Zeile nur aus, nachdem Sie gelesen haben, welche Aktion sie darstellt.
6. Schließen Sie zum Abschluss den Posteingang oder wechseln Sie die Registerkarte. Sichtbare ungelesene Einträge werden dann als gelesen markiert. Öffnen Sie dieselbe Kategorie erneut und prüfen Sie, ob die Punkte für ungelesene Einträge verschwunden sind.
## Was ein Benachrichtigungsklick tun kann
Das Klickverhalten hängt von der Benachrichtigung ab:
- Öffnen Sie eine verwandte Seite in Runner.
- Öffnen Sie ein externes Element, wie eine Rechnung, in einer neuen Browser-Registerkarte.
- Kopieren Sie einen Build- oder Vor-Check-Fehler, damit Sie ihn in eine Support-Anfrage oder einen Runner-Chat einfügen können.
- Öffnen Sie einen Abrechnungsverwaltungspfad für ein Zahlungsproblem.
- Tun Sie nichts, wenn die Benachrichtigung informativ ist und keine Aktion hat.
Lesen Sie die Benachrichtigung, bevor Sie sie auswählen. Eine Zeile hat nicht ein universelles Ziel.
## Leere und Ladezustände
| Zustand | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Platzhalter werden geladen | Runner ruft Benachrichtigungen ab. | Halten Sie den Posteingang offen, bis sich die Liste stabilisiert. |
| **Noch keine Benachrichtigungen** | Die ausgewählte Kategorie hat keine Elemente. | Kommen Sie später zurück oder versuchen Sie **Alle**. |
| **Wir werden Sie benachrichtigen, wenn etwas passiert.** | Es gibt keine aktuelle Aktualisierung, auf die Sie reagieren können. | Schließen Sie den Posteingang und arbeiten Sie weiter. |
| Mehr wird geladen | Ältere Elemente werden nach dem Scrollen abgerufen. | Warten Sie, bevor Sie erneut scrollen. |
## Browser-Aufgabenvollendungsbenachrichtigungen
Einige Desktop-Browser zeigen eine separate Karte in der erweiterten Agent-Seitenleiste:
1. Wählen Sie **Einschalten**, um den Browser zu bitten, Benachrichtigungsberechtigung anzufordern.
2. Erlauben Sie die Berechtigung nur, wenn Sie Systembenachrichtigungen für abgeschlossene Aufgaben möchten.
3. Wählen Sie **Nicht jetzt**, um die Aufforderung zu verschieben.
4. Wenn Sie eine Systembenachrichtigung auswählen, wird Runner fokussiert und zum zugehörigen Gespräch zurückgekehrt.
Diese Funktion hängt von der Desktop-Browser-Unterstützung ab. Erwarten Sie nicht das gleiche Verhalten auf Mobilgeräten oder in jedem installierten App-Setup. Meldungen über abgeschlossene Workspace-Workflows und bereite Stores können auch als temporäre Bildschirmhinweise angezeigt werden; **Shop ansehen** auf einer Benachrichtigung über einen bereiten Store öffnet dessen Vorschau.
## Verwandte Leitfäden
- [Navigation und Suche](/de/guides/workspace/navigation-and-search)
- [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations)
- [Aufgabenstatus und Details](/de/guides/work-with-runner/task-states-and-details)
---
# Freunde einladen
Source: https://www.runnerai.com/docs/de/guides/workspace/invite-friends
**Invite Friends** erstellt einen persönlichen Referral-Link, den Sie kopieren oder teilen können. Er unterscheidet sich vom Einladen eines Teamkollegen zu einem Workspace.
## Was dieser Leitfaden abdeckt
Sie werden den korrekten Referral-Link teilen, verstehen, was der Empfänger sieht, und vermeiden, einen Referral mit Workspace-Zugriff zu verwechseln.
## Verfügbarkeit und Voraussetzungen
- Sie müssen bei einem Workspace angemeldet sein.
- Warten Sie, bis Runner den Referral-Link generiert hat, bevor Sie eine Freigabeaktion auswählen.
- Die Referral-Berechtigung und alle Belohnungen werden durch die zum Zeitpunkt der Freigabe angezeigten Bedingungen geregelt. Verlassen Sie sich nicht auf einen älteren Betrag oder Screenshot.
- Ein Referral-Link fügt seinen Empfänger nicht zu Ihrem Workspace, Ihren Stores oder Ihren Projekten hinzu.
## Einstiegspfad
Öffnen Sie **Credits verdienen** und wählen Sie die Empfehlungsaktion. Falls Ihre Seitenleiste noch **Freunde einladen** zeigt, öffnet dies denselben Ablauf. Runner öffnet ein Desktop-Panel oder eine mobile Schublade mit Empfehlungslink und aktuellen Bedingungen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRvFfxwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Öffnen Sie **Credits verdienen**, scrollen Sie zu **Weitere Verdienstmöglichkeiten** und wählen Sie **Freunde einladen**. Im Bild: 1. Finden Sie Ihren Einladungslink. 2. Wählen Sie **Link kopieren** (**Kopieren** in älteren Ansichten). 3. Nutzen Sie bei Bedarf eine soziale Freigabeoption. Der persönliche Link ist verdeckt; es wurde keine Einladung gesendet. Wählen Sie das Bild aus, um es zu vergrößern. Die Markierungen verwenden die englische Desktop-Oberfläche.
## Freigabesteuerelemente
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Link kopieren** / **Kopieren** | Kopiert den Referral-Link in die Zwischenablage. Das Label zeigt kurz **Kopiert** und kehrt dann zum ursprünglichen Text zurück. |
| **X** | Öffnet Xs Freigabeflow mit dem vorbereiteten Referral-Link. |
| **Facebook** | Öffnet Facebooks Freigabeflow mit dem vorbereiteten Referral-Link. |
| **LinkedIn** | Öffnet LinkedIns Freigabeflow mit dem vorbereiteten Referral-Link. |
| Schließen | Schließt das Panel, ohne den Referral-Link zu ändern oder ungültig zu machen. |
Soziale Schaltflächen öffnen das Freigabefenster oder die Registerkarte des Anbieters. Überprüfen Sie dort die Zielgruppe und die Nachricht, bevor Sie posten; das Öffnen eines Freigabeflows veröffentlicht nicht von selbst.
## Teilen Sie einen Referral
1. Öffnen Sie **Credits verdienen**, scrollen Sie zu **Weitere Verdienstmöglichkeiten** und wählen Sie **Freunde einladen**.
2. Lesen Sie die aktuellen Berechtigung- und Belohnungsbedingungen.
3. Warten Sie, bis der Referral-Link und die Freigabeschaltflächen bereit sind.
4. Wählen Sie **Link kopieren**, um den Link privat zu senden, oder wählen Sie einen sozialen Anbieter.
5. Wenn Sie ihn kopiert haben, fügen Sie den gesamten Link in die beabsichtigte Nachricht ein und überprüfen Sie, dass sein Einladungscode vorhanden bleibt.
6. Teilen Sie dem Empfänger mit, dass der Link zum Anmelden bei Runner bestimmt ist, nicht zum Beitreten zu Ihrem vorhandenen Workspace.
Wenn ein Empfänger den Link öffnet, zeichnet Runner den Referral-Kontext auf und sendet ihn zum Anmelden oder zum Erstellen eines Kontos. Der Referral-Kontext wird durch diesen Anmeldeschritt beibehalten. Alle resultierenden Berechtigungen oder Credits folgen immer noch den von Runner angezeigten Bedingungen; das einfache Öffnen des Links garantiert keine Belohnung.
## Laden Sie stattdessen einen Teamkollegen ein
Um Zugang zum aktuellen Arbeitsbereich zu gewähren, öffnen Sie Store-Namensmenü → **Workspace-Einstellungen** → **Mitglieder** → **Personen einladen**. Eine Mitgliedereinladung hat eigene Zustände für ausstehend, abgebrochen und angenommen. Ersetzen Sie diesen Zugangsablauf nicht durch einen Empfehlungslink.
## Fehlerbehebung
| Zustand | Bedeutung und nächster Schritt |
| --- | --- |
| Freigabeaktionen sind nicht verfügbar | Runner generiert immer noch den Link. Warten Sie, bis es fertig ist. |
| **Kopiert** | Der Link ist in der Zwischenablage. Fügen Sie ihn einmal ein und überprüfen Sie die vollständige URL. |
| Soziales Fenster öffnet sich nicht | Der Browser hat möglicherweise ein Pop-up blockiert. Erlauben Sie das Freigabefenster für Runner oder verwenden Sie stattdessen **Kopieren**. |
| Link wird nicht geladen | Öffnen Sie **Invite Friends** erneut und kopieren Sie den aktuellen Link. Wenn es immer noch fehlschlägt, fügen Sie den sichtbaren Fehler in einen Support-Bericht ein. |
| Empfänger erreicht Anmeldung | Dies ist erwartet. Runner behält den Referral-Kontext bei, während sich der Empfänger anmeldet oder ein Konto erstellt. |
## Verwandte Leitfäden
- [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations)
- [Guthaben und Nutzung](/de/guides/plans-and-billing/credits-and-usage)
- [Support und Community](/de/guides/help-and-reference/support-and-community)
---
# Stores verwalten
Source: https://www.runnerai.com/docs/de/guides/workspace/manage-stores
Wählen Sie im Store-Namensmenü, an welchem Store Runner arbeiten soll. Jeder Store hat eigene Aufgaben, eine Storefront und Einstellungen.
**Einstiegspfad:** Aktueller Store-Name oben in der Seitenleiste → Store-Menü.
## Bevor Sie beginnen
- Prüfen Sie den aktuellen Arbeitsbereich und Store, bevor Sie etwas erstellen oder entfernen.
- Sichern Sie ungesendete Anfragen vor einem Store-Wechsel.
- Der Tarif Ihres Arbeitsbereichs bestimmt die Anzahl erstellbarer Stores.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Öffnen Sie dieses Menü, um einen Store zu wählen oder **Geschäft erstellen** zu starten. Prüfen Sie nach dem Wechsel erneut den Namen.
## Store-Steuerelemente
| Steuerelement | Was geschieht |
| --- | --- |
| Aktueller Store-Name | Öffnet das Store-Menü. |
| Name eines anderen Stores | Öffnet diesen Store und seine Aufgaben. |
| **Geschäft erstellen** | Öffnet den Erstellungsdialog. Bei erreichtem Store-Limit kann ein Tarifhinweis erscheinen. |
| **Workspace-Einstellungen** | Öffnet Einstellungen des Arbeitsbereichs statt des Stores. |
| **Einstellungen** in der Seitenleiste | Öffnet die Einstellungen des aktuellen Stores. |
| Store **Allgemein** → **Geschäft löschen** | Öffnet die Löschbestätigung. Prüfen Sie den genannten Store vor dem Fortfahren. |
## Öffnen Sie einen vorhandenen Store
1. Wählen Sie den aktuellen Store-Namen oben in der Seitenleiste.
2. Suchen Sie den Store, an dem Sie arbeiten möchten.
3. Wählen Sie seinen Namen und warten Sie auf den Abschluss der Navigation.
4. Prüfen Sie den neuen Store-Namen in der Seitenleiste.
5. Öffnen Sie seine aktuelle Aufgabe oder **Onlineshop**, um vor dem Senden von Anweisungen das richtige Projekt zu bestätigen.
Wenn Ihr Konto stattdessen einen leeren Arbeitsbereich öffnet, folgen Sie der Erstellungsaufforderung. Ohne Stores gibt es noch kein Ziel für einen Store-Wechsel.
## Erstellen Sie einen weiteren Store
1. Öffnen Sie das Store-Namensmenü und wählen Sie **Geschäft erstellen**.
2. Wählen Sie den verfügbaren Store-Typ. Verwenden Sie für einen neuen Store den Runner-Erstellungsweg oder für einen bestehenden Shopify-Shop **Shopify verbinden**, falls angeboten.
3. Geben Sie den erforderlichen **Geschäftsname** ein und schließen Sie den gewählten Ablauf ab.
4. Warten Sie, bis Runner das Projekt öffnet.
5. Prüfen Sie, ob der neue Name im Store-Menü erscheint. Das Erstellen veröffentlicht den Store nicht.
Die vollständigen Anleitungen finden Sie unter [Einen Runner-Store erstellen](/de/guides/start-here/create-runner-store) oder [Shopify verbinden](/de/guides/start-here/connect-shopify).
## Eine Store-Löschung prüfen
1. Wechseln Sie zum Store, den Sie entfernen möchten.
2. Öffnen Sie **Einstellungen** in der Seitenleiste und den Bereich **Allgemein** des Stores.
3. Suchen Sie **Geschäft löschen** und lesen Sie die Bestätigung.
4. Prüfen Sie den Store-Namen und die aufgeführten Folgen.
5. Brechen Sie ab, wenn Sie den Store behalten möchten. Geben Sie den verlangten Store-Namen nur ein und bestätigen Sie nur, wenn Sie ihn löschen möchten.
6. Prüfen Sie nach einer bestätigten Löschung, ob der Store aus der aktiven Store-Liste verschwunden ist.
Eine Löschung entfernt Daten. Wählen Sie einen anderen Store im Menü, wenn Sie lediglich das Projekt wechseln möchten.
## Fehlerbehebung
| Was Sie sehen | Was Sie tun können |
| --- | --- |
| Store-Liste wird geladen | Warten Sie, bevor Sie einen anderen Store auswählen oder erstellen. |
| Ein Store fehlt | Prüfen Sie Ihre Mitgliedschaft und den geöffneten Arbeitsbereich. Erstellen Sie kein Duplikat, nur weil die Liste noch nicht geladen ist. |
| Die Erstellung öffnet ein Upgrade | Prüfen Sie die aktuellen [öffentlichen Tarife](https://www.runnerai.com/pricing) oder fragen Sie den Arbeitsbereichseigentümer nach freien Kapazitäten. |
| Die Erstellung meldet einen Fehler | Prüfen Sie vor einem weiteren Versuch, ob bereits ein neuer Store erscheint. |
| Store-Einstellungen sind nicht verfügbar | Prüfen Sie Store-Auswahl und Rolle. Bitten Sie einen Eigentümer oder Administrator um Zugriff. |
| Verlängerungsseite | Reaktivieren Sie den Arbeitsbereich, wenn Sie dazu berechtigt sind, oder verwenden Sie einen anderen zugänglichen Arbeitsbereich. |
## Verwandte Leitfäden
- [Store-Status](/de/guides/workspace/store-statuses)
- [Navigation und Suche](/de/guides/workspace/navigation-and-search)
- [Workspace-Einstellungen](/de/guides/workspace/settings)
- [Chat mit Runner](/de/guides/work-with-runner/chat-with-runner)
---
# Mitglieder und Einladungen
Source: https://www.runnerai.com/docs/de/guides/workspace/members-and-invitations
**Was dieser Leitfaden abdeckt:** Sie laden die richtige Person ein und verstehen, welche Mitgliederaktionen Ihre Rolle erlaubt.
**Mitglieder** zeigt aktive Mitglieder und ausstehende Einladungen des gewählten Arbeitsbereichs. Teameinladungen unterscheiden sich vom Empfehlungslink **Freunde einladen** unter **Kostenloses Guthaben verdienen**.
**Einstiegspfad:** Store-Namensmenü → **Workspace-Einstellungen** → **Mitglieder**.
## Bevor Sie beginnen
- Bestätigen Sie den Workspace und die beabsichtigte E-Mail-Adresse.
- Überprüfen Sie die Sitzungskapazität und suchen Sie zuerst nach einem vorhandenen Mitglied oder einer ausstehenden Einladung.
- Für die Mitgliederverwaltung benötigen Sie Eigentümer- oder Administratorrechte. Die Einladungsverwaltung benötigt außerdem einen Tarif mit Team-Plätzen: **Max** oder AppSumo License Tier 2, 3 oder 4. AppSumo License Tier 1 ist ein Tarif mit nur einem Platz. Folgen Sie angezeigten Tarifhinweisen.
## Steuerelemente der Mitgliedsseite
| Steuerelement oder Wert | Was es bedeutet oder tut |
| --- | --- |
| **Mitglieder durchsuchen** | Filtert sichtbare Zeilen nach dem Namen oder der E-Mail eines Mitglieds. |
| Verwendete Sitzungen | Zeigt aktuelle Mitglieder gegen Workspace-Kapazität an. Ausstehende Einladungen beeinflussen auch, ob eine weitere Einladung zulässig ist. |
| **Personen einladen** | Öffnet das Einladungsformular für berechtigte Eigentümer und Administratoren des Arbeitsbereichs. |
| E-Mail-Feld | Akzeptiert die E-Mail-Adresse des Teamkollegen. Es gibt keine Rollenauswahl im Einladungsformular. |
| **Einladung senden** | Sendet die Einladung, nachdem die E-Mail gültig ist und ein Sitz verfügbar ist. |
| **Aktiv** | Die Person hat dem Workspace beigetreten. |
| **Ausstehend** / **Noch nicht beigetreten** | Die Einladung wurde nicht akzeptiert. |
| **Abbrechen** | Bricht eine ausstehende Einladung sofort ohne weitere Bestätigung ab. |
| **Entfernen** | Öffnet eine Bestätigung, bevor ein berechtigter Eigentümer oder Administrator ein anderes Mitglied entfernt. |
| **Verlassen** | Öffnet eine Bestätigung, bevor Sie den Workspace verlassen. |
## Laden Sie einen Teamkollegen ein
1. Bestätigen Sie den Workspace-Namen in den Einstellungen.
2. Öffnen Sie **Mitglieder**.
3. Überprüfen Sie die verwendeten Sitzungen und suchen Sie nach der E-Mail, um eine doppelte Einladung zu vermeiden.
4. Wählen Sie **Personen einladen**, wenn Rolle und Tarif es erlauben.
5. Geben Sie eine gültige E-Mail-Adresse ein.
6. Wählen Sie **Einladung senden**.
7. Suchen Sie nach **Einladung gesendet** oder **Einladung erneut gesendet**.
8. Bestätigen Sie, dass die Person als **Ausstehend** angezeigt wird.
Die Einladung fügt die Person nicht hinzu, bis sie den Link mit dem richtigen Konto öffnet und **Beitreten** wählt. Einladungslinks können bereits akzeptiert, abgebrochen, abgelaufen, falsches Konto, Sitz voll oder andere Fehlerstatus anzeigen. Runner verspricht hier keine feste Einladungsdauer.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgXczT28QoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Geben Sie die E-Mail-Adresse Ihres Teammitglieds in dieses Formular ein. Der Screenshot zeigt ein leeres Formular; es wurde keine Einladung gesendet.
## Akzeptieren Sie eine Einladung
1. Öffnen Sie den Einladungslink aus der E-Mail, die an Sie adressiert ist.
2. Melden Sie sich mit derselben E-Mail-Adresse an, die die Einladung erhalten hat.
3. Bestätigen Sie den Einladenden und den Workspace-Namen, die auf der Seite angezeigt werden.
4. Wählen Sie **Beitreten _Workspace-Name_**.
5. Warten Sie auf **Beigetreten _Workspace-Name_** und bestätigen Sie, dass Runner diesen Workspace öffnet.
Das Auswählen von **Beitreten** fügt Ihr Konto zum Workspace hinzu; es erstellt keinen separaten Store und ändert nicht die Rolle eines anderen Mitglieds. Wenn Runner **Falsches Konto** anzeigt, wählen Sie **Als … anmelden** mit der eingeladenen Adresse und schließen Sie die Anmeldung mit dieser Adresse ab. Wenn es **Workspace ist voll** anzeigt, wählen Sie **Verstanden** und bitten Sie den Einladenden, einen Sitz freizugeben oder den Plan zu aktualisieren, bevor Sie denselben Link erneut verwenden.
## Die Rolle eines Mitglieds ändern
1. Suchen Sie unter **Mitglieder** die gewünschte Person.
2. Öffnen Sie das Menü **Rolle** der Zeile, wenn Ihre Berechtigungen es erlauben.
3. Wählen Sie die gewünschte Rolle und warten Sie auf die Aktualisierung.
4. Prüfen Sie, ob die Zeile die neue Rolle anzeigt.
Eigentümer können Eigentümer-, Administrator- und Mitgliedsrollen vergeben. Administratoren können Administratoren und Mitglieder verwalten, aber keine Eigentümer ändern oder Eigentumsrechte vergeben. Das Einladungsformular hat keine Rollenauswahl; prüfen Sie die Rolle nach dem Beitritt.
## Verwalten Sie den Zugriff mit Bedacht
### Brechen Sie eine ausstehende Einladung ab
1. Suchen Sie nach der ausstehenden E-Mail.
2. Wählen Sie **Abbrechen** nur, wenn Sie diese Einladung ungültig machen möchten.
3. Überprüfen Sie, dass die ausstehende Zeile nicht mehr angezeigt wird.
**Abbrechen** macht die ausstehende Einladung ohne zweite Bestätigung ungültig.
### Entfernen Sie ein Mitglied oder verlassen Sie
1. Suchen Sie die richtige Mitgliedszeile.
2. Wählen Sie **Entfernen**, oder wählen Sie **Verlassen** in Ihrer eigenen Zeile.
3. Lesen Sie die Bestätigung, einschließlich des Verlusts des Zugriffs auf Workspace-Projekte.
4. Brechen Sie ab, wenn der Zugriff erhalten bleiben soll.
5. Bestätigen Sie nur, wenn der Workspace und die Person korrekt sind.
Ein Besitzer kann nicht aus der Besitzerzeile in der Oberfläche entfernt werden. Mitgliedsverwaltungsvorgänge folgen auch der Rollenhierarchie, daher kann eine sichtbare oder versuchte Aktion immer noch abgelehnt werden, wenn Ihre Rolle dies nicht zulässt.
## Fehlerbehebung
| Status | Was zu tun ist |
| --- | --- |
| **Personen einladen** fehlt | Prüfen Sie, ob der Arbeitsbereich Max oder AppSumo License Tier 2-4 nutzt, und bitten Sie einen Eigentümer oder Administrator um die Einladung. |
| Sitzungskapazität ist erreicht | Lösen Sie eine ungenutzte ausstehende Einladung auf oder bitten Sie den Besitzer, den Workspace-Plan zu überprüfen. |
| E-Mail wird abgelehnt | Überprüfen Sie die vollständige Adresse und korrigieren Sie alle Formatierungsfehler. |
| Einladung gehört zu einem anderen Konto | Melden Sie sich mit der eingeladenen E-Mail an, bevor Sie **Beitreten** wählen. |
| Einladung ist abgelaufen oder abgebrochen | Bitten Sie einen Eigentümer oder Administrator um eine neue Einladung. |
| **Workspace ist voll** | Bitten Sie den Einladenden, einen Sitz freizugeben oder den Workspace-Plan zu aktualisieren, und versuchen Sie dann den Link erneut. |
| **Einladung bereits akzeptiert** | Wählen Sie **Zu Runner AI gehen** und öffnen Sie den Workspace aus Ihrem Workspace-Umschalter. |
| Suche zeigt kein Ergebnis | Löschen oder verkürzen Sie die Suche und überprüfen Sie dann den ausgewählten Workspace. |
## Verwandte Leitfäden
- [Workspace-Einstellungen](/de/guides/workspace/settings)
- [Navigation und Suche](/de/guides/workspace/navigation-and-search)
- [Posteingang und Benachrichtigungen](/de/guides/workspace/inbox-and-notifications)
---
# Navigation und Suche
Source: https://www.runnerai.com/docs/de/guides/workspace/navigation-and-search
Prüfen Sie zuerst den Store-Namen. Die Tools der Seitenleiste wirken auf diesen Store; Arbeitsbereichs- und persönliche Einstellungen haben eigene Einstiege.
**Einstiegspfad:** Store öffnen → Seitenleiste aufklappen oder auf Mobilgeräten das Navigationsmenü öffnen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Durchsuchen Sie Ihren Store; 2. Starten Sie eine neue Aufgabe; 3. Öffnen Sie ein Arbeitsbereich-Tool; 4. Öffnen Sie eine gespeicherte Aufgabe erneut. Wählen Sie das Bild aus, um es zu vergrößern. Die nummerierten Markierungen beziehen sich auf die englische Desktop-Oberfläche.
## Bevor Sie beginnen
- Sichern Sie ungesendete Anfragen, bevor Sie Store oder Aufgabe wechseln.
- Verfügbare Ziele hängen von Store-Typ, Rolle, Tarif und aktivierten Funktionen ab.
## Den richtigen Geltungsbereich finden
| Wo Sie suchen | Was Sie tun können |
| --- | --- |
| Store-Name oben in der Seitenleiste | Stores wechseln, **Geschäft erstellen** oder **Workspace-Einstellungen** öffnen. |
| **Onlineshop** | Seiten und Veröffentlichungszustand des aktuellen Stores prüfen. |
| **Aufbauen**, **Wachstum** und **Messen** | Gruppierte Tools für Store-Betrieb, Wachstum und Berichte aufklappen. |
| **Agent** | Verfügbare Skills und Erinnerungen des Stores verwalten. |
| **Einstellungen** in der Seitenleiste | Einstellungen im Kontext des aktuellen Stores öffnen. |
| Glocke oben rechts | Auf Desktop den **Posteingang** öffnen. Auf Mobilgeräten den angebotenen Menüeintrag **Posteingang** verwenden. |
| Avatar oben rechts → **Meine Einstellungen** | Persönliche Kontoeinstellungen öffnen. |
| **Kostenloses Guthaben verdienen** | Verfügbare Belohnungs- und Empfehlungsaktionen ansehen. |
## Stores wechseln
1. Wählen Sie den Store-Namen oben in der Seitenleiste.
2. Wählen Sie den gewünschten Store aus der Liste.
3. Warten Sie, bis seine Seite geöffnet ist.
4. Prüfen Sie den neuen Store-Namen vor **Neue Aufgabe** oder Einstellungsänderungen.
Das Store-Menü listet Stores seines Arbeitsbereichs. Die aktuelle Einstellungsseitenleiste zeigt keine **Workspaces**. Verwenden Sie einen Arbeitsbereichswechsel nur, wenn Runner ihn anbietet. Öffnen Sie danach **Einstellungen → Workspace Allgemein** und prüfen Sie den Namen. [Einstellungen](/de/guides/workspace/settings) erläutert die Geltungsbereiche.
## Ein Tool oder eine Aufgabe finden
1. Wählen Sie **Suche** in der Projekt-Seitenleiste oder drücken Sie `Command/Control + K`.
2. Geben Sie einen sichtbaren Zielnamen wie `Onlineshop` oder einen Teil des Aufgabentitels ein.
3. Wählen Sie unter **Kontrollzentrum** ein Tool oder unter **Letzte Chats** eine Konversation.
4. Prüfen Sie, ob die gewählte Seite oder Aufgabe im gewünschten Store geöffnet wird.
5. Drücken Sie `Escape`, um die Suche ohne Navigation zu schließen.
[Projektnavigation und Suche](/de/guides/work-with-runner/project-navigation-and-search) beschreibt Tool-Gruppen und Fehlerzustände der Suche. Die Suche navigiert; sie startet keine Arbeit mit dem gewählten Tool.
Die Suche zeigt verfügbare Ziele unter **Kontrollzentrum**. Wählen Sie ein Ergebnis zum Navigieren oder drücken Sie Escape, um auf der aktuellen Seite zu bleiben.
### Ansehen: Navigationssuche filtern
Die Aufnahme gibt **Analysen** ein und prüft das passende Ziel. Sie endet vor dem Öffnen des Ergebnisses; wählen Sie selbst ein Ergebnis zum Navigieren.
## Fehlerbehebung
| Problem | Was zu tun ist |
| --- | --- |
| Seitenleistenbeschriftungen sind verborgen | Klappen Sie die Seitenleiste auf oder öffnen Sie das mobile Navigationsmenü. |
| Ein Ziel fehlt | Klappen Sie die passende Gruppe auf, versuchen Sie die Suche und prüfen Sie die Voraussetzungen. |
| Ein Store fehlt | Prüfen Sie Arbeitsbereich und Mitgliedschaft, bevor Sie einen weiteren Store erstellen. |
| Die Suche findet nichts | Leeren Sie die Suche und verwenden Sie die aktuell sichtbare Tool-Beschriftung. |
| Ein Link öffnet einen weiteren Browser-Tab | Kehren Sie nach dem Lesen zu Runner zurück. Das Öffnen einer Ressource wechselt keine Stores. |
## Verwandte Leitfäden
- [Stores verwalten](/de/guides/workspace/manage-stores)
- [Projektnavigation und Suche](/de/guides/work-with-runner/project-navigation-and-search)
- [Posteingang und Benachrichtigungen](/de/guides/workspace/inbox-and-notifications)
- [Workspace-Einstellungen](/de/guides/workspace/settings)
---
# Arbeitsbereich-Einstellungen
Source: https://www.runnerai.com/docs/de/guides/workspace/settings
**Was dieser Leitfaden abdeckt:** Sie öffnen den richtigen Einstellungsbereich und wissen, welche Änderungen einen Arbeitsbereich, Speicher oder nur Ihr Konto beeinflussen.
Einstellungen sind nach Umfang gruppiert. Bestätigen Sie die Namen des Arbeitsbereichs und des Speichers, bevor Sie Zugriff, Abrechnung, Domains, Skripte oder Löschsteuerelemente ändern.
**Eingabepfade:**
- Store-Namensmenü → **Workspace-Einstellungen** öffnet die Arbeitsbereichseinstellungen.
- Avatar oben rechts → **Meine Einstellungen** öffnet persönliche Einstellungen.
- Seitenleiste → **Einstellungen** öffnet Einstellungen im Kontext des aktuellen Stores.
## Bevor Sie beginnen
- Prüfen Sie den Arbeitsbereich und bei Store-Einstellungen die Gruppe **Store: _Store-Name_**.
- Warten Sie auf einen **Speichern**-Status, bevor Sie die Seite verlassen.
- Lesen Sie die abschließende Bestätigung vor Zugriffs-, Abrechnungs-, Domain-, Skript- oder Löschänderungen.
## Wichtige Steuerelemente und Ergebnisse
| Steuerelement | Was passiert, nachdem Sie es auswählen |
| --- | --- |
| **Name** oder **Beschreibung** | Speichert eine gültige Arbeitsbereich-Änderung automatisch nach dem Bearbeiten. |
| **Workspace allgemein** | Öffnet Details des in der Einstellungsseitenleiste genannten Arbeitsbereichs. |
| **Arbeitsbereich löschen** | Öffnet eine destruktive Bestätigung, die den vollständigen Arbeitsbereich-Namen erfordert. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Arbeitsbereichs- und **Store**-Gruppe haben getrennte Einstellungen. Prüfen Sie vor Änderungen den genannten Geltungsbereich.
## Einstellungsabschnitte
| Umfang | Derzeit angezeigte Abschnitte | Hinweise |
| --- | --- | --- |
| Arbeitsbereich | **Workspace allgemein**, **Mitglieder**, **Plan & Abrechnung**, **Nutzung & Credits** | Mitgliedsrollen bestimmen die erlaubten Änderungen. |
| Store-Projekt | **Store Allgemein**, **Domain**, **Benutzerdefinierte Skripte**, **Agent** | **Experimente** erscheint nur bei Aktivierung. Projektbereiche benötigen einen Store im aktuellen Kontext. |
| Persönlich | **Meine Einstellungen** und bei Aktivierung **API-Schlüssel** | Persönliche Änderungen und API-Schlüssel gehören zu Ihrem Konto. |
## Arbeitsbereich-Details aktualisieren
1. Öffnen Sie **Einstellungen → Workspace Allgemein**.
2. Bestätigen Sie den Arbeitsbereich-Namen oben im Einstellungsbereich.
3. Bearbeiten Sie **Name** oder **Beschreibung**.
4. Beobachten Sie, wie sich der Speicherstatus von **Speichern** zu **Gespeichert** ändert.
5. Halten Sie den Bereich offen, bis das Speichern abgeschlossen ist.
Diese Felder werden automatisch gespeichert. Ein leerer oder ungültiger Name wird nicht gespeichert. Wenn das Speichern fehlschlägt, kann Runner den letzten Serverwert wiederherstellen und einen Fehler anzeigen. Die Arbeitsbereich-Beschreibung akzeptiert bis zur vom Feld angezeigten Grenze, derzeit 500 Zeichen.
Das Aktualisieren von Arbeitsbereich-Details erfordert ausreichende Arbeitsbereich-Berechtigung. Das Löschen eines Arbeitsbereichs ist eine Eigentümeraktion, auch wenn eine andere Rolle einen Teil der Einstellungsschnittstelle sehen kann.
## Einstellungskontext wechseln
1. Öffnen Sie **Einstellungen** und lesen Sie die Arbeitsbereichs- und Store-Namen in der Seitenleiste.
2. Wählen Sie **Workspace allgemein** für Arbeitsbereichsdetails oder **Store Allgemein** für den aktuellen Store.
3. Wählen Sie **Meine Einstellungen** für persönliche Präferenzen.
Die aktuelle Seitenleiste zeigt keine Liste **Workspaces**. Verwenden Sie Arbeitsbereichswechsel oder -erstellung nur, wenn Runner diese anbietet; suchen Sie nicht unter **Meine Einstellungen** danach. Zum Verlassen folgen Sie [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations).
## Löschen Sie einen Arbeitsbereich sorgfältig
1. Öffnen Sie **Einstellungen → Workspace Allgemein**.
2. Suchen Sie **Arbeitsbereich löschen**.
3. Lesen Sie die Bestätigung und den betroffenen Arbeitsbereich-Namen.
4. Geben Sie den vollständigen Arbeitsbereich-Namen nur ein, wenn es das beabsichtigte Ziel ist.
5. Brechen Sie ab, wenn Speicher-, Konversations-, Mitgliederzugriff oder Arbeitsbereich-Daten verfügbar bleiben sollen.
Der einzige Arbeitsbereich kann nicht über die Oberfläche gelöscht werden.
## Zugriffsstatus und Fehlerbehebung
| Status | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| **Speichern** | Runner speichert eine automatische Änderung. | Halten Sie den Einstellungsbereich offen. |
| **Gespeichert** | Die neueste gültige Feldänderung wurde akzeptiert. | Fahren Sie fort oder schließen Sie Einstellungen. |
| Speicherfehler und alter Wert wird zurückgegeben | Die Änderung wurde nicht akzeptiert. | Korrigieren Sie den Wert, bestätigen Sie Ihre Berechtigung und versuchen Sie es erneut. |
| **Erstellen Sie Ihren ersten Arbeitsbereich** | Ihr Konto hat keinen verfügbaren Arbeitsbereich. | Verwenden Sie die Erstellungsaktion, um fortzufahren. |
| **Arbeitsbereich-Zugriff verweigert** | Ihr Konto kann diesen Arbeitsbereich nicht öffnen. | Wählen Sie **Gehen Sie zu Ihrem Arbeitsbereich**. |
| Erneuerungsbildschirm | Der Arbeitsbereich ist nicht aktiv. | Wählen Sie **Plan erneuern**, wenn autorisiert, oder wechseln Sie Arbeitsbereiche. |
| Ein Abschnitt fehlt | Er ist für die aktuelle Rolle, den Projektkontext, den Plan oder den Funktionszugriff nicht verfügbar. | Bestätigen Sie den Kontext und fragen Sie den Arbeitsbereich-Eigentümer bei Bedarf. |
## Verwandte Leitfäden
- [Mitglieder und Einladungen](/de/guides/workspace/members-and-invitations)
- [Speicher verwalten](/de/guides/workspace/manage-stores)
- [Navigation und Suche](/de/guides/workspace/navigation-and-search)
- [Bilder, Modelle und Skills](/de/guides/work-with-runner/attachments-profiles-and-skills)
---
# Store-Zustände
Source: https://www.runnerai.com/docs/de/guides/workspace/store-statuses
Die Store-Zusammenfassung zeigt, ob eine öffentliche Version existiert. Öffnen Sie **Onlineshop**, um zu prüfen, ob Ihre letzte Änderung darin enthalten ist.
**Einstiegspfad:** Aktueller Store-Name und Zusammenfassung → **Onlineshop**.
## Die Zusammenfassung lesen
| Beschriftung | Bedeutung | Nächste Prüfung |
| --- | --- | --- |
| **Unveröffentlichter Entwurf** | Der Store hat noch keine veröffentlichte Version als Live-Storefront. | Prüfen Sie die aktuelle Vorschau und bereiten Sie die [erste Veröffentlichung](/de/guides/storefront-and-publishing) vor. |
| **Live** | Eine öffentliche Storefront existiert. | Öffnen Sie die öffentliche URL und prüfen Sie die gewünschten Änderungen. |
| **Aktuelle Version** in der Storefront | Dies ist die neueste Projektversion. | Vergleichen Sie sie mit der veröffentlichten Version, bevor Sie sie als live betrachten. |
| **Veröffentlicht** an einer Version | Diese Version gehört zu einer abgeschlossenen Veröffentlichung. | Prüfen Sie öffentliche Seite und Checkout getrennt. |
Ältere Store-Karten können **Entwurf**, **Wird bereitgestellt** und **Veröffentlicht** verwenden. **Wird bereitgestellt** bezeichnet einen laufenden Vorgang; warten Sie auf dessen Ergebnis. Nach einem späteren Fehlschlag kann Live oder Veröffentlicht weiterhin eine ältere erfolgreiche Version meinen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.
Dies ist die aktuelle Projektvorschau. Vergleichen Sie sie über Versions- und Veröffentlichungsfunktionen mit dem Live-Store. Eine sichtbare Vorschau allein ist noch nicht öffentlich.
## Überprüfen Sie eine aktuelle Änderung
1. Prüfen Sie den aktuellen Shopnamen.
2. Öffnen Sie die Aufgabe, die die Änderung angefordert hat, und prüfen Sie den aktuellen Status und **Details**.
3. Öffnen Sie **Onlineshop** und prüfen Sie die erwartete Änderung in der aktuellen fertigen Vorschau.
4. Prüfen Sie, ob diese Version veröffentlicht wurde.
5. Falls ja, öffnen Sie die öffentliche URL und wiederholen Sie die relevante Kundenaktion.
Die Änderung ist erst geprüft, wenn beabsichtigte Version und sichtbares Ergebnis übereinstimmen. Eine abgeschlossene Aufgabe beweist keine erfolgreiche Vorschau, Veröffentlichung, Zahlung oder Anbieteraktion.
## Wenn die Zusammenfassung falsch erscheint
- Warten Sie auf das Ende laufender Veröffentlichungen, bevor Sie einen weiteren Versuch starten.
- Aktualisieren Sie die aktuelle Ansicht einmal und lesen Sie das neueste Veröffentlichungsergebnis.
- Vergleichen Sie aktuelle und veröffentlichte Version im [Versionsverlauf](/de/guides/storefront-and-publishing/version-history).
- Falls der öffentliche Store ältere Inhalte zeigt, prüfen Sie vor **Änderungen veröffentlichen** die neuere Vorschau.
- Folgen Sie bei fehlgeschlagener Veröffentlichung dem genannten Fehler, statt dieselbe Aktion zu wiederholen.
## Verwandte Leitfäden
- [Stores verwalten](/de/guides/workspace/manage-stores)
- [Aufgabenstatus und Details](/de/guides/work-with-runner/task-states-and-details)
- [Veröffentlichen und erneut veröffentlichen](/de/guides/storefront-and-publishing/publish-and-republish)
- [Live-Store und Checkout prüfen](/de/guides/storefront-and-publishing/live-store-and-checkout)
---
# Richtlinie zur akzeptablen Nutzung
Source: https://www.runnerai.com/docs/de/legal/aup
## Runner AI Richtlinie zur akzeptablen Nutzung
Diese Richtlinie zur akzeptablen Nutzung ("AUP") wird von Adaptive Machines, Inc. ("Runner AI", "wir", "uns") herausgegeben und regelt Ihre Nutzung der Runner AI Dienste.
**Die Hauptregel für die Nutzung von Runner AI lautet: Sie sind dafür verantwortlich, das Gesetz, die Regeln Ihrer Partner und Ihre Vereinbarungen mit uns einzuhalten.**
Dies sind die Prinzipien hinter unseren Erwartungen im Detail:
## Sie dürfen Runner AI nicht für illegale Aktivitäten nutzen
Wir verstehen, dass Gesetze und regulatorische Rahmenbedingungen komplex sein können, aber bei der Wahl eines Marktes und der zu verkaufenden Produkte verpflichten Sie sich als Händler, diesen Markt ernst zu nehmen, und wir vertrauen darauf und erwarten, dass Sie die geltenden Grenzen verstehen. Sie müssen ebenfalls respektieren, dass bestimmte Geschäftsaktivitäten von unserer Plattform nicht unterstützt werden, wie z.B. das Hochladen von geschützten Gesundheitsinformationen, die HIPAA unterliegen.
## Sie sollten die Plattformintegrität und -sicherheit wahren
Wir sind der Aufrechterhaltung eines sicheren und vertrauenswürdigen Handelsumfelds verpflichtet. Aktivitäten, die die Integrität unserer Plattform oder die Sicherheit unserer Nutzer beeinträchtigen, sind strikt untersagt. Dies umfasst, ist aber nicht beschränkt auf:
### Illegale und regulierte Waren
Verkauf von gefälschten Waren, illegalen Drogen, Waffen oder anderen Produkten, die in Ihrer Gerichtsbarkeit oder der Ihrer Kunden illegal sind.
### Verletzung von geistigem Eigentum
Verletzung der geistigen Eigentumsrechte anderer, einschließlich Urheberrechten und Markenrechten.
### Hass, Gewalt und schädliche Inhalte
Verkauf von Produkten oder Veröffentlichung von Inhalten, die Hass, Diskriminierung, Gewalt fördern oder vorsätzliche Selbstverletzung erleichtern.
### Betrug und Täuschung
Beteiligung an irreführendem Marketing, Finanzbetrug oder anderen betrügerischen Aktivitäten.
### Plattformmissbrauch
Versenden von Spam, Verbreitung von Malware oder Versuche, unsere Dienste zu stören.
## Spezifische Regeln bezüglich KI-Funktionen
Ihre Nutzung künstlicher Intelligenzfunktionen innerhalb von Runner AI ("KI-Funktionen") unterliegt den folgenden zusätzlichen Bedingungen:
### a. Verantwortung für Eingaben
Sie sind allein verantwortlich für alle Texte, Daten und Informationen, die Sie den KI-Funktionen zur Verfügung stellen ("Eingabe"). Sie verpflichten sich, keine Eingaben bereitzustellen, die illegal sind, Rechte Dritter verletzen oder sensible persönliche Informationen enthalten.
### b. Genauigkeit und Verantwortung für Ausgaben
Die von den KI-Funktionen generierten Inhalte ("Ausgabe") können Fehler enthalten. Sie müssen alle Ausgaben unabhängig überprüfen und verifizieren, bevor Sie diese veröffentlichen oder sich darauf verlassen. Runner AI haftet nicht für Schäden, die aus Ihrer Nutzung der Ausgabe resultieren.
### c. Verbotene Verwendungen von KI-Funktionen
Sie dürfen die KI-Funktionen nicht verwenden, um täuschende Inhalte zu generieren, hasserfüllte oder belästigende Inhalte zu erstellen oder Spam zu produzieren.
## Sie müssen unsere Vereinbarungen mit Ihnen einhalten
Obwohl wir Sie nicht mit viel Papierkram belasten möchten, sind unsere Nutzungsbedingungen wichtig für unseren Betrieb. Unsere Vereinbarungen binden Sie als Händler und erklären die Plattformregeln, die Sie befolgen müssen.
Runner AI bietet eine Reihe von Produkten und Dienstleistungen an, die Partnerschaften mit anderen Organisationen nutzen. Wenn Sie eines dieser Produkte verwenden, interagieren Sie mit einer gesamten Lieferkette von Unternehmen. Runner AI umfasst ein Ökosystem von zusammenarbeitenden Prozessoren. Wenn Sie diese Dienste nutzen, müssen Sie respektieren, wie die Lieferkette funktioniert und welche Bedingungen an Sie gestellt werden.
## Die häufigsten Produkteignungsstreitigkeiten stammen von außerhalb von Runner AI
Wir sind eine Handelsplattform: Die meisten Produkteignungs- oder Entfernungsstreitigkeiten, auf die Unternehmer stoßen können, stammen von außerhalb von Runner AI, einschließlich von Regulierungsbehörden und Drittinhabern von geistigen Eigentumsrechten. In diesen Fällen werden wir Ihnen Benachrichtigungen und Werkzeuge zur Selbstverwaltung Ihrer Risiken und Streitigkeiten zur Verfügung stellen, wenn dies angemessen ist.
## Wir erwarten von Ihnen, dass Sie in gutem Glauben handeln. Wenn Sie dies nicht tun, können Maßnahmen auf Kontoebene angemessen sein
Wir mögen es nicht, wenn Menschen versuchen, Systeme zu "manipulieren", um Beschränkungen zu umgehen, mit denen sie nicht einverstanden sind. Wir dulden auch nicht, dass jemand Runner AI, andere Händler oder Käufer betrügt, unsere Plattform zum Versenden von Spam verwendet oder andere böswillige Praktiken ausübt. In diesen Fällen sind Maßnahmen auf Kontoebene oft angemessener, auch wenn wir versuchen, die Auswirkungen auf das Geschäft als erstes Prinzip zu minimieren.
Wenn Sie auf Runner AI unter Berücksichtigung dieser Prinzipien aufbauen, werden wir Ihnen Benachrichtigungen geben, Ihnen Möglichkeiten zur Selbstbehebung von Konflikten gewähren, standardmäßig auf Produktebene durchsetzen und Maßnahmen auf Kontoebene als letztes Mittel ergreifen, wenn dies angemessen ist. Schließlich erwarten wir, wie bei allen großartigen Produkten, diese Prinzipien von Zeit zu Zeit zu überarbeiten und zu aktualisieren.
Wenn Sie glauben, dass ein Runner AI Nutzer gegen diese Richtlinie zur akzeptablen Nutzung verstößt, können Sie den Runner AI Support per E-Mail unter support@adaptivemachines.ai kontaktieren.
---
# Cookie-Richtlinie
Source: https://www.runnerai.com/docs/de/legal/cookies
## Runner AI Cookie-Richtlinie
Diese Cookie-Richtlinie erklärt, wie Adaptive Machines, Inc. ("Runner AI", "wir", "uns" oder "unser") Cookies und ähnliche Technologien auf unserer Website (runner.ai) und den Diensten, die wir unseren Händlern anbieten (zusammen die "Dienste"), verwendet. Sie erklärt, was diese Technologien sind und warum wir sie verwenden, sowie Ihre Rechte, unsere Verwendung zu kontrollieren. Diese Richtlinie sollte in Verbindung mit unserer [Datenschutzrichtlinie](/de/legal/policies) gelesen werden.
## Was sind Cookies?
Ein Cookie ist eine kleine Menge an Informationen, die auf Ihren Computer oder Ihr Gerät heruntergeladen wird, wenn Sie bestimmte Websites besuchen. Wir verwenden eine Reihe verschiedener Cookies auf der Runner AI Website, einschließlich unbedingt erforderlicher, Leistungs-, Werbe- und Social-Media- oder Inhalts-Cookies. Cookies verbessern Ihr Browsing-Erlebnis, indem sie der Website ermöglichen, sich an Ihre Aktionen und Präferenzen zu erinnern (wie Anmeldung und Regionsauswahl). Das bedeutet, dass Sie diese Informationen nicht jedes Mal erneut eingeben müssen, wenn Sie zur Seite zurückkehren oder von einer Seite zur anderen navigieren. Cookies liefern auch Informationen darüber, wie Menschen die Website nutzen, z.B. ob es ihr erster Besuch ist oder ob sie ein häufiger Besucher sind. Lesen Sie mehr über Cookies (und andere ähnliche Tracking-Technologien) und wie wir die durch diese Technologien gesammelten Daten verwenden, in unserer [Datenschutzrichtlinie](/de/legal/policies).
## Cookies in Händler-Shops
Dieser Abschnitt ist wichtig sowohl für Händler, die unsere Plattform nutzen, als auch für Besucher ihrer Shops.
**Für Besucher von Händler-Shops:** Wenn Sie den von Runner AI betriebenen Shop eines Händlers besuchen, ist dieser Händler der Datenverantwortliche für Ihre Informationen. Das bedeutet, dass der Händler entscheidet, welche Cookies in seinem Shop verwendet werden, insbesondere für Analysen und Werbung (z.B. Google Analytics, Facebook Pixel). Runner AI agiert als Datenverarbeiter und platziert Cookies, die für die Kernfunktionalität des Shops unbedingt erforderlich sind (z.B. Warenkorb, Checkout). Alle Fragen zu den Datenschutzpraktiken eines Händlers sollten direkt an den Händler gerichtet werden.
**Für Händler:** Als Händler, der Runner AI nutzt, sind Sie der Datenverantwortliche für die Daten Ihrer Kunden. Sie sind dafür verantwortlich, alle geltenden Datenschutzgesetze einzuhalten, einschließlich der Information Ihrer Kunden über die von Ihnen verwendeten Cookies (einschließlich derer von Drittanbieter-Apps, die Sie installieren) und der Einholung einer gültigen Einwilligung, wo dies erforderlich ist. Während Runner AI die Plattform bereitstellt, sind Sie für die spezifische Konfiguration der Datenschutzeinstellungen und -richtlinien Ihres Shops verantwortlich.
## Welche Cookies verwenden wir und warum?
### Erforderliche Cookies
Einige Cookies sind notwendig, damit Sie unsere Website durchsuchen, ihre Funktionen nutzen und auf sichere Bereiche zugreifen können. Die Verwendung dieser Cookies ist für das Funktionieren der Website unerlässlich. Beispielsweise verwenden wir Benutzereingabe-Cookies für die Dauer einer Sitzung, um ihre Eingaben beim Ausfüllen von Formularen zu verfolgen, die sich über mehrere Seiten erstrecken.
### Funktionale Cookies
Wir verwenden auch funktionale Cookies, um sich an von Ihnen getroffene Entscheidungen oder bereitgestellte Informationen zu erinnern, wie Ihren Benutzernamen, Ihre Sprache oder die Region, in der Sie sich befinden. Dies ermöglicht es uns, Ihr Website-Erlebnis speziell auf Ihre Präferenzen zuzuschneiden. Beispielsweise sind Authentifizierungs-Cookies funktionale Cookies, die für die Dauer einer Sitzung (oder persistent, wenn Sie der "Angemeldet bleiben"-Funktion zustimmen) verwendet werden, um Benutzern zu ermöglichen, sich bei nachfolgenden Besuchen zu authentifizieren oder Zugang zu autorisierten Inhalten über Seiten hinweg zu erhalten. Die von uns verwendeten funktionalen Cookies umfassen:
- **Benutzerzentrierte Sicherheits-Cookies:** Um Authentifizierungsmissbräuche für eine begrenzte persistente Dauer zu erkennen, wie wiederholte fehlgeschlagene Anmeldeversuche.
- **Multimedia-Inhaltsplayer-Sitzungs-Cookies (Flash-Cookies):** Werden für die Dauer einer Sitzung verwendet, um technische Daten zu speichern, die für die Wiedergabe von Video- oder Audioinhalten erforderlich sind.
- **Load-Balancing-Sitzungs-Cookies:** Werden für die Dauer der Sitzung verwendet, um denselben Server im Pool zu identifizieren, damit der Load Balancer Anfragen entsprechend weiterleiten kann.
- **Benutzeroberflächen-Anpassungs-Persistent-Cookies:** Werden verwendet, um die Präferenz eines Benutzers bezüglich eines Dienstes über Webseiten hinweg zu speichern.
### Leistungs-Cookies
Runner AI ist der Optimierung der Benutzererfahrung verpflichtet und wir verwenden viele Tools, um uns bei der Verbesserung unserer Website und unserer Handelsplattform zu helfen. Zu diesem Zweck verwenden wir Berichts- und Analyse-Cookies, um Informationen darüber zu sammeln, wie Sie unsere Website oder die Schaufenster unserer Händler nutzen und wie oft. Die von uns verwendeten Leistungs-Cookies umfassen:
- **First-Party-Analyse-Cookies:** Wir verwenden diese Cookies, um die Anzahl der eindeutigen Besucher zu schätzen, unsere Websites und die Websites unserer Händler zu verbessern und die am häufigsten gesuchten Wörter in Suchmaschinen zu erkennen, die zu einer Webseite führen.
- **Third-Party-Analyse-Cookies:** Wir verwenden auch Google Analytics und andere unten aufgeführte Drittanbieter-Analysedienste, um zu messen, wie Benutzer mit unseren Website-Inhalten interagieren.
### Werbe-Cookies
Werbe-Cookies werden auf unserer Website verwendet, um Marketing auf Sie und Ihre Interessen zuzuschneiden und Ihnen in Zukunft einen personalisierteren Service zu bieten. Diese Cookies merken sich, dass Sie unsere Website besucht haben, und wir können diese Informationen mit Dritten, wie Werbetreibenden, teilen. Ohne diese Cookies können die Anzeigen, die Sie sehen, weniger relevant und interessant für Sie sein.
### Social-Media- und Inhalts-Cookies
Social-Media- und Inhalts-Cookies werden von vielen Social-Media-Plugins platziert (z.B. der Facebook "Gefällt mir"-Button) und anderen Tools, die dazu dienen, Inhalte auf einer Website bereitzustellen oder zu verbessern (z.B. Dienste, die das Abspielen von Videodateien ermöglichen oder Kommentarbereiche erstellen). Wir integrieren diese Module in unsere Plattform, um das Erlebnis des Browsens und der Interaktion mit unseren Websites zu verbessern.
## Händler-Schaufenster
Wenn Händler unsere Plattform nutzen, um ihre Online-Shops zu betreiben, platzieren wir die folgenden Cookies für Besucher ihrer Shops.
### Cookies, die für das Funktionieren des Shops erforderlich sind
| Name | Beschreibung | Dauer |
|------|--------------|-------|
| \_medusa\_jwt | Besucher-Anmeldedaten | 7d |
## Third-Party-Cookies
Zusätzlich verwenden wir Pixel und Tags von den folgenden Drittanbietern, die wiederum Cookies platzieren können.
### Cookies, die für das Funktionieren der Websites erforderlich sind
| Drittanbieter | Beschreibung | Datenschutzrichtlinie |
|---------------|--------------|------------------------|
| Vercel | Wir verwenden Vercel für Edge-Routing. | [https://vercel.com/legal/privacy-policy](https://vercel.com/legal/privacy-policy) |
| Intercom | Wir verwenden Intercom für den Kundenservice. | [https://www.intercom.com/legal/privacy](https://www.intercom.com/legal/privacy) |
| Chatwoot | Wir verwenden Chatwoot, das wir selbst unter support.runnerai.com betreiben, für den Kundenservice. Chatwoot setzt `cw_conversation`, damit Ihre Chat-Unterhaltung über Seiten und Besuche hinweg erhalten bleibt, `cw_user_`, um sich zu merken, zu welchem Chat-Kontakt Ihr Browser gehört, wenn Sie angemeldet sind, und `cw_snooze_campaigns_till`, um Chat-Kampagnennachrichten eine Stunde lang zurückzuhalten, nachdem Sie eine gelesen haben. `cw_conversation` und `cw_user_` bleiben ein Jahr lang gespeichert. | [Datenschutzrichtlinie](/de/legal/policies) |
### Berichterstattung & Analysen
| Drittanbieter | Beschreibung | Datenschutzrichtlinie |
|---------------|--------------|------------------------|
| Google Analytics | Wir verwenden Google Analytics, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Google Tag Manager | Wir verwenden Google Tag Manager, um Analyse-Anbieter zu verwalten. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| PostHog | Wir verwenden PostHog für Datenanalysen. | [https://posthog.com/privacy](https://posthog.com/privacy) |
### Werbung
| Drittanbieter | Beschreibung | Datenschutzrichtlinie |
|---------------|--------------|------------------------|
| Facebook Pixel | Wir verwenden Facebook Pixel, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://www.facebook.com/privacy/explanation](https://www.facebook.com/privacy/explanation) |
| Google Ads | Wir verwenden Google Ads, um gezielte Werbung an Personen zu liefern, die unsere Websites besuchen. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Instagram | Wir verwenden Instagram, um gezielte Werbung an Personen zu liefern, die unsere Websites besuchen. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| TikTok | Wir verwenden TikTok, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Twitter | Wir verwenden Twitter, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube | Wir verwenden YouTube, um gezielte Werbung an Personen zu liefern, die unsere Websites besuchen. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Reddit | Wir verwenden Reddit, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Pinterest | Wir verwenden Pinterest, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Whatsapp | Wir verwenden Whatsapp, um zu messen, wie Benutzer mit unseren Websites interagieren. | [https://www.whatsapp.com/legal/privacy-policy](https://www.whatsapp.com/legal/privacy-policy) |
### Social Media & Inhalte
| Drittanbieter | Beschreibung | Datenschutzrichtlinie |
|---------------|--------------|------------------------|
| Facebook Connect | Wir verwenden Facebook Connect, um Besuchern unserer Website die Interaktion und das Teilen von Inhalten über die Social-Media-Plattform von Facebook zu ermöglichen. | [https://www.facebook.com/policy.php](https://www.facebook.com/policy.php) |
| Instagram CDN | Wir verwenden Instagram CDN, um Benutzern Inhalte bereitzustellen. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| Twitter CDN | Wir verwenden Twitter, um Besuchern unserer Website die Interaktion und das Teilen von Inhalten über die Social-Media-Plattform von Twitter zu ermöglichen. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube CDN | Wir verwenden YouTube CDN, um Benutzern Inhalte bereitzustellen. | [https://policies.google.com/privacy?hl=en](https://policies.google.com/privacy?hl=en) |
| Tiktok CDN | Wir verwenden Tiktok CDN, um Benutzern Inhalte bereitzustellen. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Reddit CDN | Wir verwenden Reddit CDN, um Benutzern Inhalte bereitzustellen. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Linkedin CDN | Wir verwenden Linkedin CDN, um Benutzern Inhalte bereitzustellen. | [https://www.linkedin.com/legal/privacy-policy](https://www.linkedin.com/legal/privacy-policy) |
| Pinterest CDN | Wir verwenden Pinterest CDN, um Benutzern Inhalte bereitzustellen. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Rednote CDN | Wir verwenden Rednote CDN, um Benutzern Inhalte bereitzustellen. | [https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1](https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1) |
## Wie lange bleiben Cookies auf meinem Computer oder mobilen Gerät?
Die Zeitdauer, die ein Cookie auf Ihrem Computer oder mobilen Gerät verbleibt, hängt davon ab, ob es sich um ein "persistentes" oder "Sitzungs"-Cookie handelt. Sitzungs-Cookies dauern an, bis Sie das Browsen beenden, und persistente Cookies dauern an, bis sie ablaufen oder gelöscht werden. Die meisten von uns verwendeten Cookies sind persistent und laufen zwischen 30 Minuten und zwei Jahren ab dem Datum ab, an dem sie auf Ihr Gerät heruntergeladen wurden. Siehe den Abschnitt unten zur Kontrolle von Cookies für weitere Informationen zum Entfernen vor Ablauf.
## Wie kontrolliere ich Cookies?
Sie können Cookies auf verschiedene Weise kontrollieren und verwalten. Bitte beachten Sie, dass das Entfernen oder Blockieren von Cookies Ihre Benutzererfahrung negativ beeinflussen kann und Teile unserer Website möglicherweise nicht mehr vollständig zugänglich sind.
Die meisten Browser akzeptieren Cookies automatisch, aber Sie können über Ihre Browser-Steuerungen wählen, ob Sie Cookies akzeptieren möchten oder nicht. Diese finden Sie oft im "Extras"- oder "Einstellungen"-Menü Ihres Browsers. Weitere Informationen zur Änderung Ihrer Browser-Einstellungen oder zum Blockieren, Verwalten oder Filtern von Cookies finden Sie in der Hilfedatei Ihres Browsers oder auf Websites wie: [www.allaboutcookies.org](https://www.allaboutcookies.org).
Viele der oben aufgeführten Drittanbieter-Werbe- und anderen Tracking-Dienste bieten Ihnen die Möglichkeit, ihre Tracking-Systeme abzulehnen. Sie können mehr über die von ihnen gesammelten Informationen und wie Sie sich über die oben aufgeführten Datenschutzrichtlinien-Links abmelden können, erfahren.
---
# Datenverarbeitungsvertrag
Source: https://www.runnerai.com/docs/de/legal/dpa
## Runner AI Datenverarbeitungsvertrag
### I. ZWECK
Dieser Runner AI Datenverarbeitungsvertrag ("DPA") ergänzt die Runner AI Nutzungsbedingungen und wird durch Verweis in diese aufgenommen, zusammen mit allen Bedingungen, die für zusätzliche Runner AI Dienste gelten, die Sie nutzen möchten (die "Bedingungen"), zwischen Ihnen (oder "Händler") und Adaptive Machines, Inc. ("Runner AI", "wir", "uns", "unser"), die die spezifischen Geschäftszwecke und Dienstleistungen im Zusammenhang mit diesem DPA darlegen. Im Falle eines Konflikts zwischen den Bedingungen und diesem DPA hat der DPA in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten, wie unten definiert, Vorrang.
Sie und Runner AI (jeweils eine "Partei", zusammen die "Parteien") vereinbaren, dass dieser DPA die Verpflichtungen der Parteien in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten festlegt. Sie handeln als Datenverantwortlicher und Runner AI handelt als Datenverarbeiter in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten im Zusammenhang mit Ihrer Nutzung unserer Dienste, die auf unserer Verarbeitung Ihrer Kundenpersonenbezogenen Daten beruhen, mit Ausnahme der in Anhang E beschriebenen Dienste.
Wenn die Verarbeitung personenbezogener Daten gemäß diesem DPA den Datenschutzanforderungen im Europäischen Wirtschaftsraum (dem "EWR"), im Vereinigten Königreich (dem "UK") oder in der Schweiz unterliegt und Runner AI als Datenverarbeiter handelt, ergänzt Anhang C diesen DPA. Im Falle eines Konflikts zwischen Anhang C und anderen Abschnitten dieses DPA hat Anhang C in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten, die den Datenschutzanforderungen des EWR, des UK und der Schweiz unterliegen, Vorrang. Zur Klarstellung gilt Anhang C nicht für die in Anhang E beschriebenen Verarbeitungsaktivitäten.
Wenn die Verarbeitung personenbezogener Daten gemäß diesem DPA den US-Datenschutzgesetzen unterliegt und Runner AI als Datenverarbeiter oder Dienstleister handelt, ergänzt Anhang D diesen DPA. Im Falle eines Konflikts zwischen Anhang D und anderen Abschnitten dieses DPA hat Anhang D in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten, die den US-Datenschutzgesetzen unterliegen, Vorrang. Zur Klarstellung gilt Anhang D nicht für die in Anhang E beschriebenen Verarbeitungsaktivitäten.
Wenn Sie Enhanced Services von Runner AI erhalten (wie in Abschnitt 9 der Nutzungsbedingungen definiert), verarbeitet Runner AI Ihre Kundenpersonenbezogenen Daten als Datenverantwortlicher oder Business, wie in Anhang E dargelegt. Im Falle eines Konflikts zwischen Anhang E und anderen Abschnitten dieses DPA hat Anhang E in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten durch Runner AI als Datenverantwortlicher oder Business Vorrang.
### II. DEFINITIONEN
In diesem DPA verwendete, aber nicht definierte groß geschriebene Begriffe haben dieselbe Bedeutung wie in den Bedingungen:
**A. Anwendbare Datenschutzgesetze:** Alle Datenschutz- oder Privatsphärengesetze, die für die Verarbeitung personenbezogener Daten durch Runner AI gemäß den Bedingungen gelten, ihre Durchführungsverordnungen und Sekundärgesetzgebung, jeweils in der von Zeit zu Zeit geänderten, aktualisierten oder ersetzten Fassung, einschließlich solcher Gesetze, die aufgrund des Standorts oder Wohnsitzes des Händlers und/oder Ihrer Kunden gelten.
**B. Kunde:** Eine natürliche oder juristische Person, die Ihre(n) Shop(s) besucht, mit ihm/ihnen interagiert und/oder ein Produkt, eine Ware oder eine Dienstleistung von Ihrem/Ihren Shop(s) kauft.
**C. Datenschutzanfrage:** Eine gültige und rechtmäßige Anfrage einer natürlichen Person zur Ausübung verfügbarer Rechte in Bezug auf personenbezogene Daten gemäß einem anwendbaren Datenschutzgesetz.
**D. Datenverantwortlicher oder Business:** Die Partei, die die Zwecke und Mittel der Verarbeitung personenbezogener Daten bestimmt, oder wie anderweitig unter einem anwendbaren Datenschutzgesetz definiert.
**E. Datenverarbeiter oder Dienstleister:** Die Partei oder andere Entität oder Unternehmen, die Dienstleistungen im Auftrag erbringt und personenbezogene Daten nach Weisung und im Auftrag des Datenverantwortlichen verarbeitet, oder wie unter anwendbaren Datenschutzgesetzen definiert.
**F. Personenbezogene Daten:** Informationen oder Daten, die als "personenbezogene Daten", "persönliche Informationen" oder "personenidentifizierbare Informationen" (oder ein analoger Begriff) unter anwendbaren Datenschutzgesetzen definiert sind.
**G. Datenschutzverletzung:** In Bezug auf Ihre Kundenpersonenbezogenen Daten ist dies in Übereinstimmung mit den anwendbaren Datenschutzgesetzen auszulegen.
**H. "Verarbeiten", "verarbeitet" oder "Verarbeitung":** (a) Jeder Vorgang oder jede Reihe von Vorgängen, die an personenbezogenen Daten oder an Sätzen personenbezogener Daten durchgeführt werden, ob mit oder ohne automatisierte Mittel, wie Erhebung, Aufzeichnung, Organisation, Strukturierung, Speicherung, Anpassung oder Änderung, Abruf, Abfrage, Nutzung, Offenlegung durch Übermittlung, Verbreitung oder anderweitiges Zur-Verfügung-Stellen, Abgleich oder Kombination, Einschränkung, Löschung oder Vernichtung; oder (b) die Definition, die diesem/diesen Begriff(en) unter den anwendbaren Datenschutzgesetzen gegeben wird.
**I. "Auftragsverarbeiter":** Verbundene Unternehmen oder Drittanbieter-Datenverarbeiter oder Dienstleister, die personenbezogene Daten nach Weisung von Runner AI zum Zweck der Bereitstellung der Dienste verarbeiten können.
**J. "Sie", "Ihr" oder "Händler":** Bezeichnet jedes Unternehmen, das Sie betreiben und das die Dienste, die Enhanced Services oder andere zusätzliche Dienste nutzt oder davon profitiert und Partei der Bedingungen mit Runner AI ist.
**K. "Ihre Kundenpersonenbezogenen Daten":** Personenbezogene Daten von oder über Ihre Kunden, ausgenommen personenbezogene Daten über Kunden, die Runner AI als Ergebnis der Beziehung des Kunden mit Runner AI erhält, die durch die Consumer Privacy Policy von Runner AI und nicht durch diesen DPA geregelt werden.
### III. ART DER VERARBEITUNG UND ROLLEN DER PARTEIEN
**Runner AI als Datenverarbeiter oder Dienstleister.** Runner AI erhält und verarbeitet Ihre Kundenpersonenbezogenen Daten, um Ihnen die Dienste bereitzustellen und wie anderweitig unten dargelegt. Je nachdem, welche der Dienste Sie anfordern oder nutzen, verarbeitet Runner AI die in Anhang A aufgeführten Kategorien personenbezogener Daten in der Art und Weise und auf den darin enthaltenen Grundlagen.
Runner AI verarbeitet Ihre Kundenpersonenbezogenen Daten als Datenverarbeiter oder Dienstleister nur zur Bereitstellung der in den Bedingungen und ergänzenden Bedingungen angewiesenen Dienste und soweit erforderlich, um seine Dienste bereitzustellen, zu entwickeln und zu verbessern und andere von den anwendbaren Datenschutzgesetzen erlaubte Zwecke wahrzunehmen.
**Runner AI als Datenverantwortlicher oder Business.** Runner AI verarbeitet Ihre Kundenpersonenbezogenen Daten als Datenverantwortlicher oder Business (a) unter den in Anhang E dargelegten Umständen und in der dort beschriebenen Weise und (b) für alle zusätzlichen Zwecke, die mit den Anweisungen des Kunden und den anwendbaren Datenschutzgesetzen vereinbar sind.
### IV. PFLICHTEN DER PARTEIEN
Der folgende Abschnitt beschreibt die jeweiligen Verpflichtungen der Parteien in Bezug auf die Verarbeitung personenbezogener Daten, die von diesem DPA abgedeckt werden.
#### A. Allgemeine Compliance
1. Die Parteien werden ihre jeweiligen Verpflichtungen gemäß den anwendbaren Datenschutzgesetzen einhalten.
2. Runner AI hat keine Verpflichtung, Sie über Ihre Verpflichtungen gemäß den anwendbaren Datenschutzgesetzen zu beraten oder zu informieren, einschließlich in Bezug auf die Verarbeitung personenbezogener Daten, die von diesem DPA abgedeckt werden. Sie sind allein verantwortlich für die Bestimmung Ihrer rechtlichen und regulatorischen Verpflichtungen, einschließlich der Bewertung, ob die technischen und organisatorischen Maßnahmen der Dienste mit Ihren unabhängigen rechtlichen und regulatorischen Verpflichtungen übereinstimmen.
#### B. Verpflichtungen von Runner AI
##### 1. Datensicherheit
Runner AI wird angemessene technische und organisatorische Maßnahmen implementieren und aufrechterhalten, die darauf ausgelegt sind, Ihre Kundenpersonenbezogenen Daten vor unbefugter oder rechtswidriger Verarbeitung und vor versehentlichem Verlust, Zerstörung, Beschädigung, Diebstahl, Änderung oder Offenlegung zu schützen, wie in Anhang B dargelegt.
##### 2. Benachrichtigung und Untersuchung von Datenschutzverletzungen
a) Wie von den anwendbaren Datenschutzgesetzen gefordert, wird Runner AI Sie benachrichtigen, sobald Runner AI eine Datenschutzverletzung bestätigt.
b) Diese Benachrichtigung muss die gemäß den anwendbaren Datenschutzgesetzen erforderlichen Informationen enthalten, soweit diese Informationen für Runner AI vernünftigerweise verfügbar sind. Die Reaktion von Runner AI auf oder Benachrichtigung über eine Datenschutzverletzung stellt keine Anerkennung eines Verschuldens oder einer Haftung durch Runner AI dar.
c) Runner AI verpflichtet sich, jede Datenschutzverletzung zu untersuchen und wirtschaftlich angemessene Anstrengungen zu unternehmen, um die Auswirkungen zu identifizieren, zu verhindern, abzumildern und zu beheben.
#### C. Ihre Verpflichtungen in Bezug auf personenbezogene Daten
##### 1. Datenschutzhinweise und Transparenz
Sie versichern und garantieren, dass Sie alle Verpflichtungen gemäß den anwendbaren Datenschutzgesetzen erfüllen, um Hinweise und Transparenz bezüglich Ihrer Verarbeitung Ihrer Kundenpersonenbezogenen Daten gemäß den Bedingungen und im Zusammenhang mit Ihrer Nutzung der Dienste bereitzustellen. In Übereinstimmung mit den anwendbaren Datenschutzgesetzen teilen Sie den betreffenden Personen alle Offenlegungen mit, die erforderlich sind, damit Runner AI Ihre Kundenpersonenbezogenen Daten im Zusammenhang mit diesem DPA rechtmäßig und fair verarbeiten kann, einschließlich wenn Sie Enhanced Services oder andere zusätzliche Dienste erhalten, indem Sie einen Link zur Consumer Privacy Policy von Runner AI und zu Ihrer Datenschutzrichtlinie bereitstellen und andere in Abschnitt 9 der Bedingungen dargelegte Offenlegungen vornehmen.
##### 2. Kundenrechte und -genehmigungen
Sie versichern und garantieren, dass Sie alle erforderlichen Rechte, Genehmigungen und Einwilligungen haben, um Ihre Kundenpersonenbezogenen Daten Runner AI zur Verfügung zu stellen, und damit Runner AI Ihre Kundenpersonenbezogenen Daten verarbeiten kann, damit Sie die Dienste erhalten können, einschließlich Enhanced Services oder anderer zusätzlicher Dienste, die Sie erhalten, in Übereinstimmung mit den Bedingungen, diesem DPA und den anwendbaren Datenschutzgesetzen.
##### 3. Datenschutzanfragen
Sie versichern und garantieren, dass Sie die Möglichkeit bieten, dass Ihre Kunden Datenschutzanfragen ausüben können, wie es gemäß den anwendbaren Datenschutzgesetzen erforderlich ist, in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten durch Runner AI, für die Sie der Datenverantwortliche sind.
##### 4. Behördliche Anfragen
Sofern nicht durch geltendes Recht verboten, werden Sie uns unverzüglich gemäß der Benachrichtigungsbestimmung in den Bedingungen über jede behördliche, regulatorische oder andere Drittanfrage oder Beschwerde bezüglich Ihrer Nutzung der Dienste informieren.
### V. VERSCHIEDENES
#### A. Globale Datenübermittlungen
Sie erkennen an, dass Ihre Kundenpersonenbezogenen Daten in jedem Land übermittelt und verarbeitet werden können, in dem Runner AI, seine verbundenen Unternehmen oder Drittanbieter-Dienstleister tätig sind. Jede Übermittlung Ihrer Kundenpersonenbezogenen Daten an diese Empfänger erfolgt in Übereinstimmung mit den anwendbaren Datenschutzgesetzen. Für weitere Informationen zu internationalen Datenübermittlungen, wenn Runner AI den Datenschutzanforderungen im EWR, im UK oder in der Schweiz unterliegt, siehe Abschnitt II(B)(8) von Anhang C.
#### B. Reaktion auf rechtliche Anfragen
1. Sie erkennen an, dass Runner AI im Rahmen der Bereitstellung der Dienste für Sie Ihre Kundenpersonenbezogenen Daten teilen kann (i) um rechtlichen Anforderungen nachzukommen oder auf Gerichtsbeschlüsse oder andere ähnliche behördliche oder regulatorische Anforderungen zu reagieren; oder (ii) um mutmaßlichen Betrug, Bedrohungen der physischen Sicherheit, illegale Aktivitäten oder Verstöße gegen einen Vertrag (wie die Nutzungsbedingungen) oder unsere Richtlinien (wie unsere Richtlinie zur akzeptablen Nutzung) zu verhindern oder zu untersuchen.
2. Runner AI wird vor der Herausgabe Ihrer Kundenpersonenbezogenen Daten angemessene Anstrengungen unternehmen, um sicherzustellen, dass eine solche Offenlegung gemäß den anwendbaren Datenschutzgesetzen zulässig ist und als vertrauliche Information im Rahmen des anwendbaren rechtlichen Rahmens behandelt wird.
#### C. Offenlegung bei Unternehmenstransaktionen
Sie erkennen an, dass Runner AI im Rahmen der Bereitstellung der Dienste für Sie möglicherweise verpflichtet ist, Ihre Kundenpersonenbezogenen Daten mit potenziellen Gegenparteien einer Unternehmens- oder Umstrukturierungstransaktion zu teilen.
#### D. Nutzung von Dienstleistern durch Runner AI
1. Sie erkennen an und stimmen zu, dass Runner AI im Rahmen der Bereitstellung der Dienste für Sie Dienstleister zur Verarbeitung Ihrer Kundenpersonenbezogenen Daten nutzen kann. Runner AI führt eine aktualisierte Liste aller verwendeten Dienstleister. Wenn Ihnen die anwendbaren Datenschutzgesetze solche Rechte gewähren, können Sie der Nutzung eines Dienstleisters durch Runner AI widersprechen, und wenn Runner AI nicht in der Lage oder nicht bereit ist, solchen Anfragen nachzukommen, können Sie Ihre Nutzung der betroffenen Dienste gemäß den in den Bedingungen dargelegten Gesetzen innerhalb von 30 Tagen nach einer solchen Benachrichtigung beenden.
2. Die Nutzung von Dienstleistern durch Runner AI zur Verarbeitung Ihrer Kundenpersonenbezogenen Daten, die Sie bereitstellen, erfolgt in Übereinstimmung mit den anwendbaren Datenschutzgesetzen. Wenn Runner AI einen Dienstleister beauftragt, schließt Runner AI eine schriftliche Vereinbarung mit dem Dienstleister ab, die vertragliche Verpflichtungen auferlegt, die im Wesentlichen denjenigen entsprechen, die in diesem DPA dargelegt sind.
#### E. DPA-Änderung
Sie erkennen an und stimmen zu, dass Runner AI diesen DPA von Zeit zu Zeit ändern kann, indem der entsprechende geänderte und neu gefasste DPA auf der Website von Runner AI unter https://www.runnerai.com/docs/de/legal/dpa veröffentlicht wird, und solche Änderungen am DPA sind ab dem Datum der Veröffentlichung wirksam. Ihre fortgesetzte Nutzung der Dienste nach Veröffentlichung des geänderten DPA auf der Website von Runner AI stellt Ihre Zustimmung zu und Akzeptanz des geänderten DPA dar. Wenn Sie den Änderungen am DPA nicht zustimmen, nutzen Sie die Dienste nicht weiter.
### VI. ANHÄNGE
1. [Anhang A - Kategorien personenbezogener Daten](#anhang-a-kategorien-personenbezogener-daten)
2. [Anhang B - Datensicherheit](#anhang-b-datensicherheit)
3. [Anhang C - DSGVO, UK DSGVO und Schweizer Datenverarbeitungsanhang](#anhang-c-dsgvo-uk-dsgvo-und-schweizer-datenverarbeitungsanhang)
4. [Anhang D - US-Datenschutzgesetze](#anhang-d-us-datenschutzgesetze)
5. [Anhang E - Runner AI als Datenverantwortlicher oder Business für Enhanced Services](#anhang-e-runner-ai-als-datenverantwortlicher-oder-business-für-enhanced-services)
---
## ANHANG A: KATEGORIEN PERSONENBEZOGENER DATEN
Im Rahmen Ihrer Nutzung der Dienste und abhängig davon, welche Dienste Sie nutzen, können wir die folgenden Kategorien personenbezogener Daten erhalten und verarbeiten, um die Dienste bereitzustellen:
- Identifikatoren, einschließlich Name, E-Mail-Adresse, Postanschrift, Telefonnummer
- Personenbezogene Informationskategorien, die im kalifornischen Customer Records-Statut aufgeführt sind, einschließlich Name, Post- und Rechnungsadresse, Telefonnummer, Kredit- oder Debitkarteninformationen
- Kommerzielle Informationen, einschließlich Produkte, die Sie kaufen, in Ihren Warenkorb legen, favorisieren oder bewerten (wenn Sie ein Kunde sind) und Informationen, die Sie uns über sich und Ihr Unternehmen zur Verfügung stellen (wenn Sie ein Händler sind)
- Fotos und Videos, die Gesichtsbilder enthalten können, wenn Sie sich dafür entscheiden, diese bereitzustellen
- Internet- oder andere elektronische Netzwerkaktivitätsinformationen, einschließlich Informationen über das von Ihnen verwendete Gerät und den Browser, die Netzwerkverbindung, die IP-Adresse und wie Sie durch unsere Websites navigieren
- Geolokalisierungsdaten, einschließlich Ihrer Post- und Rechnungsadresse
- Schlussfolgerungen oder aus anderen persönlichen Informationen über Sie abgeleitete Informationen, die Ihre Präferenzen, Interessen und andere zur Personalisierung Ihrer Erfahrung verwendete Informationen umfassen könnten
- Sensible persönliche Informationen, die Folgendes umfassen können:
- Von der Regierung ausgestellte Identifikatoren, einschließlich Sozialversicherungsnummer, Führerschein, staatlichem Personalausweis oder Reisepassnummer
- Ihre Kontozugangsdaten (wie Kontoanmeldung, Finanzkonto, Debit- oder Kreditkartennummer in Kombination mit einem erforderlichen Sicherheitszugangscode, Passwort oder Zugangsdaten, die den Zugriff auf ein Konto ermöglichen)
---
## ANHANG B: DATENSICHERHEIT
Runner AI wird ein Informationssicherheitsprogramm aufrechterhalten, das darauf ausgelegt ist, (a) Ihnen zu ermöglichen, Ihre Kundenpersonenbezogenen Daten vor unbefugter oder rechtswidriger Verarbeitung und vor versehentlichem Verlust, Zerstörung, Beschädigung, Diebstahl, Änderung oder Offenlegung zu sichern; (b) vernünftigerweise vorhersehbare Risiken für die Sicherheit und Verfügbarkeit der von Ihnen erhaltenen Dienste zu identifizieren; und (c) Sicherheitsrisiken für die Dienste zu minimieren.
### I. Das Informationssicherheitsprogramm von Runner AI umfasst die folgenden Schutzmaßnahmen:
#### A. Logische Sicherheit
##### 1. Zugriffskontrollen
Runner AI macht seine Systeme nur autorisiertem Personal zugänglich und nur soweit erforderlich, um die Dienste zu warten und bereitzustellen. Runner AI wird Zugriffskontrollen und -richtlinien aufrechterhalten, die darauf ausgelegt sind, Autorisierungen für den Zugriff auf seine Systeme zu verwalten, einschließlich durch die Verwendung von Firewalls und/oder anderen Technologien und Authentifizierungskontrollen.
##### 2. Eingeschränkter Benutzerzugriff
Runner AI wird (i) den Zugriff auf seine Systeme gemäß den Prinzipien der geringsten Privilegien basierend auf den Arbeitsfunktionen des Personals bereitstellen und einschränken und (ii) eine Zwei-Faktor-Authentifizierung (2FA) für den Zugriff auf seine Systeme erfordern.
##### 3. Schwachstellenbewertungen
Runner AI wird ein Programm zur Schwachstellenbewertung und Penetrationstests aufrechterhalten, das für die Untersuchung und Verfolgung identifizierter Probleme mit den Diensten bis zur Lösung, wo erforderlich, verantwortlich ist.
##### 4. Anwendungssicherheit
Runner AI unterhält ein Anwendungssicherheitsprogramm, das für den Schutz der Dienste vor Bedrohungen der Anwendungssicherheit verantwortlich ist.
##### 5. Änderungsmanagement
Runner AI wird Kontrollen aufrechterhalten, die darauf ausgelegt sind, Änderungen an bestehenden Dienst-Ressourcen zu protokollieren, zu autorisieren, zu testen, zu genehmigen und zu dokumentieren, und wird Änderungsdetails in seinen Änderungsmanagement- oder Bereitstellungstools dokumentieren. Runner AI wird Änderungen gemäß seinen Änderungsmanagementstandards vor der Migration in die Produktion testen.
##### 6. Datenintegrität
Runner AI wird, soweit angemessen, Kontrollen aufrechterhalten, die darauf ausgelegt sind, die Datenintegrität während der Übertragung, Speicherung und Verarbeitung innerhalb der Dienste bereitzustellen.
##### 7. Verfügbarkeit
Runner AI wird (i) wo angemessen Redundanz für die Dienste implementieren, um die Auswirkungen einer Fehlfunktion auf die Dienste zu minimieren, (ii) die Dienste so gestalten, dass sie Fehler antizipieren und tolerieren, und (iii) geeignete Prozesse implementieren, die darauf ausgelegt sind, den Verkehr personenbezogener Daten von den betroffenen Bereichen weg zu bewegen, wenn dies erforderlich ist, um sich von Fehlern zu erholen.
##### 8. Geschäftskontinuität und Notfallwiederherstellung
Runner AI wird ein Risikomanagementprogramm aufrechterhalten, das darauf ausgelegt ist, die Kontinuität seiner kritischen Geschäftsfunktionen zu unterstützen, einschließlich Prozessen und Verfahren zur Identifizierung, Reaktion auf und Wiederherstellung von Ereignissen, die die Bereitstellung der von Ihnen erhaltenen Dienste durch Runner AI verhindern oder wesentlich beeinträchtigen könnten.
##### 9. Vorfallmanagement
Runner AI stellt Dokumentation zur Verfügung, mit der Sie Sicherheits- oder Verfügbarkeitsvorfälle melden, Sicherheits- oder Verfügbarkeitsfragen stellen und Informationen über potenzielle Sicherheits- oder Verfügbarkeitsprobleme übermitteln können. Runner AI wird Korrekturmaßnahmenpläne und Vorfallreaktionspläne aufrechterhalten, die darauf ausgelegt sind, potenzielle Sicherheitsbedrohungen für die Dienste zu erkennen, abzumildern, zu untersuchen und darauf zu reagieren.
#### B. Physische Sicherheit
Soweit zum Schutz der Dienste erforderlich, wird Runner AI (i) angemessene Maßnahmen implementieren, die darauf ausgelegt sind, unbefugten physischen Zugriff, Beschädigung oder Beeinträchtigung der Dienste zu verhindern, (ii) geeignete Kontrollgeräte verwenden, die darauf ausgelegt sind, den physischen Zugriff auf die Dienste nur auf autorisiertes Personal zu beschränken, das einen legitimen geschäftlichen Bedarf für einen solchen Zugriff hat, und (iii) regelmäßige Überprüfungen durchführen, um die Einhaltung dieser Standards zu validieren.
#### C. Mitarbeiter von Runner AI
Mitarbeiter von Runner AI, die berechtigt sind, auf Ihre Kundenpersonenbezogenen Daten zuzugreifen, sind im Rahmen ihrer Beschäftigungsbedingungen an Vertraulichkeitspflichten gebunden. Runner AI wird Schulungsprogramme zur Mitarbeitersicherheit in Bezug auf die Informationssicherheitsanforderungen von Runner AI implementieren und aufrechterhalten. Die Sensibilisierungsprogramme für die Sicherheit werden regelmäßig überprüft und aktualisiert.
### II. Änderungen an diesem Anhang
Runner AI überprüft seine Sicherheitsmaßnahmen von Zeit zu Zeit und kann diesen Anhang nach eigenem Ermessen aktualisieren. Alle solchen Updates ersetzen frühere Versionen dieses Anhangs ab dem Datum, an dem Runner AI die aktualisierte Version veröffentlicht.
---
## ANHANG C: DSGVO, UK DSGVO UND SCHWEIZER DATENVERARBEITUNGSANHANG
Wenn die Verarbeitung Ihrer Kundenpersonenbezogenen Daten gemäß dem DPA den Datenschutzanforderungen im Europäischen Wirtschaftsraum (dem "EWR"), im Vereinigten Königreich (dem "UK") oder in der Schweiz (zusammen "Europäische Datenschutzgesetze") unterliegt und Runner AI als Datenverarbeiter handelt, ergänzt Anhang C diesen DPA.
### I. Art der Verarbeitung und Rolle der Parteien
#### A. Personenbezogene Daten
Gemäß diesem Anhang handeln Sie als Datenverantwortlicher und Runner AI handelt als Datenverarbeiter in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten, wie in Anlage 1 beschrieben, soweit erforderlich, um die in den Bedingungen dargelegten Geschäftszwecke zu erfüllen und Ihnen die von Ihnen gewählten Dienste bereitzustellen.
### II. Pflichten der Parteien
#### A. Ihre Verpflichtungen
Sie werden Folgendes einhalten:
- Europäische Datenschutzgesetze, die Sie in Bezug auf Ihre Nutzung der Dienste binden; und
- Ihre in dem DPA dargelegten Verpflichtungen, einschließlich Ihrer in diesem Anhang dargelegten Verpflichtungen.
Sie versichern und garantieren, dass Sie eine gültige Rechtsgrundlage für die Verarbeitung Ihrer Kundenpersonenbezogenen Daten haben (einschließlich der Bereitstellung solcher Daten an Runner AI) und alle erforderlichen Einwilligungen, Rechte und Autorisierungen eingeholt haben und alle erforderlichen Hinweise an Personen gegeben haben, um die Verarbeitung Ihrer Kundenpersonenbezogenen Daten durch Runner AI zur Bereitstellung der Dienste zu ermöglichen, wie es die Europäischen Datenschutzgesetze erfordern.
#### B. Verpflichtungen von Runner AI
##### 1. Anweisungen des Verantwortlichen und Verstoß gegen Europäische Datenschutzgesetze
a) Die Parteien vereinbaren, dass die Bedingungen zusammen mit diesem DPA Ihre dokumentierten Anweisungen bezüglich der Verarbeitung Ihrer Kundenpersonenbezogenen Daten durch Runner AI darstellen ("Dokumentierte Anweisungen").
b) Runner AI wird Ihre Kundenpersonenbezogenen Daten als Datenverarbeiter verarbeiten: (i) in Übereinstimmung mit Ihren dokumentierten Anweisungen oder (ii) um den Verpflichtungen von Runner AI gemäß geltenden Gesetzen nachzukommen, vorbehaltlich etwaiger Benachrichtigungsanforderungen gemäß EWR-, EWR-Mitgliedstaat-, UK- oder Schweizer Recht, dem Runner AI unterliegt.
c) Runner AI wird Sie benachrichtigen, wenn es eine Anweisung erhält, von der es vernünftigerweise feststellt, dass sie gegen Europäische Datenschutzgesetze verstößt (Runner AI hat jedoch keine Verpflichtung, Ihre Einhaltung der Europäischen Datenschutzgesetze aktiv zu überwachen).
##### 2. Vertraulichkeitsverpflichtung
Runner AI wird sicherstellen, dass Personen, die es zur Verarbeitung Ihrer Kundenpersonenbezogenen Daten autorisiert, entweder schriftliche Vertraulichkeitsvereinbarungen abschließen oder gesetzlichen Vertraulichkeitspflichten unterliegen.
##### 3. Sicherheitsmaßnahmen
a) Runner AI wird angemessene technische und organisatorische Maßnahmen implementieren und aufrechterhalten, die darauf ausgelegt sind, Ihre Kundenpersonenbezogenen Daten vor unbefugter oder rechtswidriger Verarbeitung und vor versehentlichem Verlust, Zerstörung, Beschädigung, Diebstahl, unbefugtem Zugriff, Änderung oder Offenlegung zu schützen, wie in Anlage 2 dargelegt.
b) Unter Berücksichtigung der Art Ihrer Kundenpersonenbezogenen Daten und der zugehörigen Verarbeitung wird Runner AI angemessene Unterstützung leisten, die Sie vernünftigerweise anfordern können, um Sie bei der Erfüllung Ihrer Sicherheitsverpflichtungen gemäß den Europäischen Datenschutzgesetzen zu unterstützen.
c) Runner AI wird Sie unverzüglich benachrichtigen, sobald es von einer Sicherheitsverletzung Kenntnis erlangt, die zur versehentlichen oder rechtswidrigen Zerstörung, zum Verlust, zur Änderung, zur unbefugten Offenlegung von oder zum unbefugten Zugriff auf Ihre Kundenpersonenbezogenen Daten führt, die übermittelt, gespeichert oder anderweitig verarbeitet wurden.
d) Runner AI verpflichtet sich, jede solche Sicherheitsverletzung zu untersuchen und wirtschaftlich angemessene Anstrengungen zu unternehmen, um die Auswirkungen abzumildern.
##### 4. Auftragsverarbeiter
a) Sie autorisieren Runner AI allgemein, Auftragsverarbeiter zur Verarbeitung Ihrer Kundenpersonenbezogenen Daten zu beauftragen. Sie stimmen ferner zu, dass Runner AI seine verbundenen Unternehmen als Auftragsverarbeiter beauftragen kann.
b) Die Nutzung von Auftragsverarbeitern durch Runner AI zur Verarbeitung Ihrer Kundenpersonenbezogenen Daten erfolgt in Übereinstimmung mit den Europäischen Datenschutzgesetzen.
c) Runner AI führt eine aktualisierte Liste aller Auftragsverarbeiter, wie in Anlage 3 dargelegt. Runner AI wird die Liste der Auftragsverarbeiter entsprechend aktualisieren und Ihnen einen Mechanismus zur Verfügung stellen, um eine Benachrichtigung über die Hinzufügung oder den Ersatz eines Auftragsverarbeiters zu erhalten. Sie können der Nutzung eines neuen Auftragsverarbeiters durch Runner AI widersprechen.
d) Soweit Sie der Nutzung eines Auftragsverarbeiters durch Runner AI widersprechen und Runner AI nicht in der Lage oder nicht bereit ist, solchen Anfragen nachzukommen, können Sie Ihre Nutzung der betroffenen Dienste innerhalb von 30 Tagen nach einer solchen Benachrichtigung gemäß den Bedingungen beenden.
e) Wenn Runner AI einen neuen Auftragsverarbeiter beauftragt, schließt Runner AI eine schriftliche Vereinbarung mit dem Auftragsverarbeiter ab, und Runner AI wird dem Auftragsverarbeiter vertragliche Verpflichtungen auferlegen, die im Wesentlichen denjenigen entsprechen, die in diesem DPA dargelegt sind. Runner AI haftet vollständig für die Handlungen und Unterlassungen seiner Auftragsverarbeiter in demselben Umfang, wie Runner AI haften würde, wenn es die Dienstleistungen jedes Auftragsverarbeiters direkt gemäß den Bedingungen dieses DPA erbringen würde. Die Haftung von Runner AI unterliegt jedoch den in den Bedingungen dargelegten Bedingungen und Haftungsbeschränkungen.
##### 5. Unterstützung des Verantwortlichen
Unter Berücksichtigung der Art Ihrer Kundenpersonenbezogenen Daten und der zugehörigen Verarbeitung wird Runner AI angemessene Unterstützung leisten, die Sie vernünftigerweise anfordern können, um Sie bei der Erfüllung Ihrer Verpflichtungen zu unterstützen:
- auf Datenschutzanfragen gemäß den Europäischen Datenschutzgesetzen in Bezug auf alle Verarbeitungen Ihrer Kundenpersonenbezogenen Daten durch Runner AI zu reagieren;
- relevante Behörden und/oder betroffene Personen über eine Datenschutzverletzung zu benachrichtigen;
- Datenschutz-Folgenabschätzungen und vorherige Konsultationen durchzuführen;
- die Sicherheit der Verarbeitung gemäß Abschnitt 3 zu gewährleisten.
##### 6. Bewertung der Compliance
a) Runner AI kann Ihr Prüfungsrecht gemäß den Europäischen Datenschutzgesetzen in Bezug auf die Verarbeitung Ihrer Kundenpersonenbezogenen Daten erfüllen, indem es Ihnen - auf Ihre schriftliche Anfrage und vorbehaltlich der Vertraulichkeit - Folgendes zur Verfügung stellt:
(i) Die neuesten Prüfberichtsergebnisse von Runner AI, entweder aus den Selbstprüfungen von Runner AI oder erstellt von einem unabhängigen Drittprüfer;
(ii) zusätzliche Informationen in der Kontrolle von Runner AI, wenn eine Datenschutz- oder Regierungsbehörde dies anfordert.
b) Vorausgesetzt, dass und nur in dem Umfang, in dem Ihnen die Europäischen Datenschutzgesetze dieses Recht gewähren, können Sie Ihr Prüfungsrecht ausüben: (i) in dem Umfang, in dem ein unabhängiger international anerkannter Prüfer bescheinigt, dass die Bereitstellung eines Prüfberichts durch Runner AI nicht ausreichende Informationen für Sie zur Überprüfung der Einhaltung dieses DPA und der Europäischen Datenschutzgesetze durch Runner AI liefert, oder (ii) soweit erforderlich, damit Sie auf eine Prüfung durch eine Regierungsbehörde reagieren können. Jede Prüfung muss den folgenden Parametern entsprechen: (i) von einem unabhängigen Dritten durchgeführt werden, der eine Vertraulichkeitsvereinbarung mit Runner AI abschließt; (ii) im Umfang auf Angelegenheiten beschränkt sein, die vernünftigerweise erforderlich sind und auf die sich die Parteien geeinigt haben, damit Sie die Einhaltung dieses DPA und der Europäischen Datenschutzgesetze durch Runner AI und die Parteien bewerten können; (iii) zu einem gegenseitig vereinbarten Datum und zu einer gegenseitig vereinbarten Uhrzeit und nur während der regulären Geschäftszeiten von Runner AI stattfinden; (iv) nicht mehr als einmal jährlich stattfinden (es sei denn, dies ist gemäß den Europäischen Datenschutzgesetzen erforderlich); (v) nur von Runner AI kontrollierte Einrichtungen abdecken; (vi) Ergebnisse nur auf Ihre Kundenpersonenbezogenen Daten beschränken; und (vii) alle Ergebnisse als vertrauliche Informationen im größtmöglichen Umfang behandeln, den die Europäischen Datenschutzgesetze erlauben. Zur Klarstellung wird Runner AI allen Ihren Rechten gemäß diesem Abschnitt 6 in Übereinstimmung mit seinen Vertraulichkeitsverpflichtungen gegenüber Dritten nachkommen.
##### 7. Ende der Verarbeitung
a) Während Ihrer Nutzung der Dienste können Sie Kontotools nutzen, um auf Ihre Kundenpersonenbezogenen Daten zuzugreifen, sie an sich selbst zurückzugeben oder sie zu löschen.
b) Nach Beendigung wird Runner AI nach Ihrer Wahl Ihre Kundenpersonenbezogenen Daten löschen oder zurückgeben. Ungeachtet des Vorstehenden kann Runner AI Ihre Kundenpersonenbezogenen Daten aufbewahren: (i) wie gesetzlich vorgeschrieben, einschließlich der Europäischen Datenschutzgesetze; und (ii) in Übereinstimmung mit seinen standardmäßigen Sicherungs- oder Aufbewahrungsrichtlinien, vorausgesetzt, dass Runner AI in beiden Fällen die Vertraulichkeit aufbewahrt und anderweitig die anwendbaren Bestimmungen dieses DPA in Bezug auf aufbewahrte Kundenpersonenbezogene Daten einhält und aufbewahrte Kundenpersonenbezogene Daten nicht weiter verarbeitet, außer für solche Zwecke und Dauer, die gemäß den anwendbaren Gesetzen zulässig sind.
##### 8. Internationale Übermittlungen
a) Sie erkennen an, dass Adaptive Machines, Inc., ein in den Vereinigten Staaten ansässiges Unternehmen, im Rahmen der Bereitstellung der Dienste Ihre Kundenpersonenbezogenen Daten auf Servern in den Vereinigten Staaten verarbeiten wird.
b) Wenn Runner AI eine internationale Übermittlung vornimmt (d.h. eine Übermittlung Ihrer Kundenpersonenbezogenen Daten aus dem Europäischen Wirtschaftsraum (EWR), dem Vereinigten Königreich (UK) oder der Schweiz in ein Land außerhalb dieser Regionen, das nicht als ein angemessenes Datenschutzniveau bereitstellend anerkannt ist), erfolgt dies in Übereinstimmung mit den Europäischen Datenschutzgesetzen.
c) Soweit Runner AI der Empfänger Ihrer Kundenpersonenbezogenen Daten in einem Land ist, das kein angemessenes Datenschutzniveau gewährleistet, vereinbaren die Parteien, dass solche Übermittlungen angemessenen Garantien unterliegen, insbesondere den folgenden Übermittlungsmechanismen: (i) Die Standardvertragsklauseln für die Übermittlung personenbezogener Daten in Drittländer gemäß der Verordnung (EU) 2016/679 des Europäischen Parlaments und des Rates, wie sie durch den Durchführungsbeschluss (EU) 2021/914 der Europäischen Kommission vom 4. Juni 2021 genehmigt wurden (die "EU-SVK"); und/oder (ii) Für Übermittlungen aus dem Vereinigten Königreich das International Data Transfer Addendum zu den Standardvertragsklauseln der Europäischen Kommission, herausgegeben vom UK Information Commissioner's Office gemäß S119A(1) des UK Data Protection Act 2018 (das "UK Addendum"); und/oder (iii) Für Übermittlungen aus der Schweiz die EU-SVK in der geänderten Fassung, um die Anforderungen des Schweizerischen Bundesgesetzes über den Datenschutz zu erfüllen.
d) Durch Zustimmung zu diesem DPA gelten Sie als Unterzeichner der anwendbaren Übermittlungsmechanismen, die durch Verweis aufgenommen werden und einen integralen Bestandteil dieses DPA bilden.
### ANLAGE 1 - PERSONENBEZOGENE DATEN
#### BESCHREIBUNG DER VERARBEITUNG PERSONENBEZOGENER DATEN
**I. Gegenstand der Verarbeitung**
Bereitstellung von Runner AI Diensten für den Händler.
**II. Kategorien betroffener Personen**
Kunden des Händlers.
**III. Kategorien der verarbeiteten personenbezogenen Daten**
Siehe Anhang A oben.
**IV. Häufigkeit der Übermittlung**
Kontinuierlich.
**V. Art der Verarbeitung**
Erhebung, Aufzeichnung, Hosting, Zugriff, Nutzung, Übermittlung und Löschung personenbezogener Daten, wie in den Bedingungen beschrieben.
**VI. Zwecke, für die die personenbezogenen Daten im Auftrag des Verantwortlichen verarbeitet werden**
Für die Erfüllung und Verbesserung der Dienste, wie in den Bedingungen beschrieben.
**VII. Dauer der Verarbeitung**
Dauer der Dienste gemäß den Bedingungen oder der geltenden Vereinbarung, zuzüglich des Zeitraums nach Ablauf bis zur Anonymisierung, Rückgabe oder Löschung von Daten.
**VIII. Zuständige Aufsichtsbehörde**
Die zuständige Aufsichtsbehörde wird in Übereinstimmung mit der DSGVO bestimmt.
### ANLAGE 2 - SICHERHEITSMASSNAHMEN
Informationen zu Sicherheitsmaßnahmen sind in Anhang B des DPA enthalten.
### ANLAGE 3 - LISTE DER AUFTRAGSVERARBEITER
Die von Runner AI für die Erbringung der Dienste gemäß den Bedingungen verwendeten Auftragsverarbeiter sind hier aufgeführt.
Die Auftragsverarbeiter werden die oben beschriebenen Kategorien personenbezogener Daten im Zusammenhang mit den Diensten für die Dauer ihrer Vereinbarung mit Runner AI verarbeiten.
---
## ANHANG D: US-DATENSCHUTZGESETZE
Dieser Abschnitt gilt nur in dem Umfang, in dem: (i) US-Datenschutzgesetze auf Sie und/oder Ihre Kundenpersonenbezogenen Daten im Zusammenhang mit Ihrer Nutzung der Dienste Anwendung finden; (ii) die folgenden Bestimmungen von den US-Datenschutzgesetzen gefordert werden; und (iii) Runner AI als Datenverarbeiter oder Dienstleister handelt. Zur Klarstellung gilt dieser Anhang D nicht für die in Anhang E beschriebenen Verarbeitungsaktivitäten.
Die Parteien vereinbaren, dass die Bedingungen zusammen mit diesem DPA Ihre dokumentierten Anweisungen bezüglich der Verarbeitung Ihrer Kundenpersonenbezogenen Daten durch Runner AI darstellen ("Dokumentierte Anweisungen").
Mit Ausnahme der in Anhang E dargelegten Fälle, wenn Sie bestimmte Enhanced Services erhalten, wird Runner AI nicht: (i) Ihre Kundenpersonenbezogenen Daten außerhalb seiner direkten Geschäftsbeziehung mit Ihnen oder für andere Zwecke als die in diesem DPA und/oder den Bedingungen identifizierten begrenzten und spezifischen Zwecke, einschließlich zur Bereitstellung, Entwicklung und Verbesserung der Dienste oder wie anderweitig von den anwendbaren US-Datenschutzgesetzen erlaubt, aufbewahren, verwenden oder offenlegen, oder (ii) Ihre Kundenpersonenbezogenen Daten "verkaufen" oder "teilen" oder "gezielte Werbung" mit Ihren Kundenpersonenbezogenen Daten im Sinne des CCPA oder anderer US-Datenschutzgesetze betreiben; oder (iii) Ihre Kundenpersonenbezogenen Daten mit personenbezogenen Daten kombinieren, die es aus anderen Quellen erhält, in jedem Fall außer wie von den US-Datenschutzgesetzen erlaubt.
Runner AI wird: (i) das gleiche Niveau an Datenschutz bieten, das von Businesses oder Datenverantwortlichen durch US-Datenschutzgesetze gefordert wird, und Sie informieren, wenn es feststellt, dass es diesen Verpflichtungen nicht mehr nachkommen kann, in welchem Fall Sie angemessene und geeignete Schritte unternehmen können, um jede unbefugte Verarbeitung Ihrer Kundenpersonenbezogenen Daten zu stoppen oder zu beheben, (ii) sicherstellen, dass Personal, das es zur Verarbeitung Ihrer Kundenpersonenbezogenen Daten autorisiert, entweder schriftliche Vertraulichkeitsvereinbarungen abschließt oder gesetzlichen Vertraulichkeitspflichten unterliegt, (iii) auf vernünftige schriftliche Anfrage und als Teil der Befähigung, dass Sie angemessene und geeignete Schritte unternehmen können, um sicherzustellen, dass Runner AI Ihre Kundenpersonenbezogenen Daten in einer mit den US-Datenschutzgesetzen übereinstimmenden Weise verwendet, den SOC2-Bericht bereitstellen, der eine angemessene Bewertung des Informationssicherheitsprogramms von Runner AI zeigt; und (iv) nach Beendigung seiner Dienste für Sie seinen Löschprozess einleiten, um Ihre Kundenpersonenbezogenen Daten, die Runner AI ausschließlich als Datenverarbeiter oder Dienstleister zur Verarbeitung bereitgestellt wurden, zu löschen, zurückzugeben oder zu de-identifizieren.
Sie versichern und garantieren, dass Sie Runner AI keine personenbezogenen Daten einer Person zur Verfügung stellen werden, die ein Widerspruchsrecht ausgeübt hat, das Sie sich verpflichtet haben zu respektieren, oder sensible personenbezogene Daten einer Person, die nicht in die Verarbeitung solcher sensiblen Daten gemäß den Anforderungen der anwendbaren Datenschutzgesetze eingewilligt hat.
---
## ANHANG E: RUNNER AI ALS DATENVERANTWORTLICHER ODER BUSINESS FÜR ENHANCED SERVICES
Runner AI handelt als Datenverantwortlicher oder Business, wenn Sie die Enhanced Services erhalten, wie in Abschnitt 9 der Nutzungsbedingungen definiert. Runner AI kann die Dienste und Produkte, für die es als Datenverantwortlicher oder Business handelt, von Zeit zu Zeit aktualisieren.
Als Teil der Bereitstellung der Enhanced Services durch Runner AI stimmen Sie zu, dass Runner AI Ihre Kundenpersonenbezogenen Daten als Datenverantwortlicher oder Business gemäß den anwendbaren Datenschutzgesetzen verarbeitet, um Analysen, Produktanpassungen, Werbung und andere Dienstleistungen für Sie und andere Händler bereitzustellen, zu entwickeln und zu verbessern, die die Interaktionen und Transaktionen Ihrer Kunden mit Ihrem Shop, mit anderen Händlern und mit Runner AI einbeziehen. Wenn Runner AI Ihre Kundenpersonenbezogenen Daten auf diese Weise verarbeitet, gelten die Consumer Privacy Policy von Runner AI und dieser Anhang E des DPA. Sie können die Verwendung Ihrer Kundenpersonenbezogenen Daten durch Runner AI auf diese Weise deaktivieren, indem Sie Runner AI Network Intelligence hier deaktivieren.
### 1. Datenschutzhinweise, Transparenz und Rechte
In Übereinstimmung mit den anwendbaren Datenschutzgesetzen teilen Sie den betreffenden Personen alle Offenlegungen mit, die erforderlich sind, damit Runner AI Ihre Kundenpersonenbezogenen Daten rechtmäßig und fair verarbeiten kann, um Ihnen Enhanced Services im Zusammenhang mit diesem Anhang E des DPA bereitzustellen, einschließlich durch Bereitstellung eines Links zur Consumer Privacy Policy von Runner AI in Ihrer Datenschutzrichtlinie und Bereitstellung der in Abschnitt 9.2.5 der Nutzungsbedingungen dargelegten Offenlegungen.
### 2. Europäische Anforderungen
Wenn Sie im EWR, im Vereinigten Königreich oder in der Schweiz ansässig sind oder wenn Ihre Kunden im EWR, im Vereinigten Königreich oder in der Schweiz sind, stimmen Sie zu, versichern und garantieren, dass Sie die Einwilligung von Kunden eingeholt haben und Kunden die Möglichkeit bieten, das Recht auszuüben, die Einwilligung zu widerrufen, gegen bestimmte Verarbeitungen Widerspruch einzulegen und bestimmten Verarbeitungen zu widersprechen, wo dies von den anwendbaren Datenschutzgesetzen gefordert wird. Zur Klarstellung müssen Sie die Einwilligung für gezielte Werbung als Teil der Enhanced Services und die Verwendung von Cookies oder anderen lokalen Speichertechnologien in dem von den anwendbaren Datenschutzgesetzen geforderten Umfang einholen.
### 3. Verantwortlichkeiten des Verantwortlichen
Sie sind ein Datenverantwortlicher Ihrer Kundenpersonenbezogenen Daten und bestimmen individuell die Zwecke und Mittel Ihrer Verarbeitung Ihrer Kundenpersonenbezogenen Daten und wie Sie Ihre Kundenpersonenbezogenen Daten verwenden und verarbeiten, einschließlich der Bestimmung der Rechtsgrundlage für Ihre Verarbeitung gemäß dem anwendbaren Datenschutzgesetz. Runner AI ist ein Datenverantwortlicher Ihrer Kundenpersonenbezogenen Daten, die es in Übereinstimmung mit diesem Anhang E verarbeitet, und bestimmt individuell die Zwecke und Mittel seiner Verarbeitung solcher personenbezogener Daten und wie es solche personenbezogenen Daten verwendet und verarbeitet, einschließlich der Bestimmung der Rechtsgrundlage für seine Verarbeitung gemäß dem anwendbaren Datenschutzgesetz.
Jede Partei ist individuell verantwortlich für die Beantwortung von Datenschutzanfragen, die sie in Bezug auf ihre Verarbeitung Ihrer Kundenpersonenbezogenen Daten als Datenverantwortlicher erhält.
### 4. Keine Auswirkung auf den Rest des DPA
Dieser Anhang E berührt anderweitig keine Bedingungen, einschließlich des Rests dieses DPA, die eine Datenverantwortlicher-Datenverarbeiter-Beziehung zwischen Händlern und Runner AI widerspiegeln.
---
# Datenschutzrichtlinie für alle
Source: https://www.runnerai.com/docs/de/legal/policies
## Inhaltsverzeichnis
1. [Einleitung](#einleitung)
2. [Unsere Werte](#unsere-werte)
3. [Warum wir Ihre Informationen verarbeiten](#warum-wir-ihre-informationen-verarbeiten)
4. [Ihre Rechte in Bezug auf Ihre Informationen](#ihre-rechte-in-bezug-auf-ihre-informationen)
5. [Wohin wir Ihre Informationen senden](#wohin-wir-ihre-informationen-senden)
6. [Google user data and Google integrations](#google-user-data-and-google-integrations)
7. [Wie lange wir Ihre Informationen aufbewahren](#wie-lange-wir-ihre-informationen-aufbewahren)
8. [Unsere Nutzung von maschinellem Lernen](#unsere-nutzung-von-maschinellem-lernen)
9. [Wie wir Ihre Informationen schützen](#wie-wir-ihre-informationen-schützen)
10. [Wie wir "Cookies" und andere Tracking-Technologien verwenden](#wie-wir-cookies-und-andere-tracking-technologien-verwenden)
11. [Wie Sie uns erreichen können](#wie-sie-uns-erreichen-können)
12. [Datenschutzhinweis für die Vereinigten Staaten](#datenschutzhinweis-für-die-vereinigten-staaten)
13. [Zusätzliche Informationen für Nutzer in bestimmten Regionen](#zusätzliche-informationen-für-nutzer-in-bestimmten-regionen)
## Einleitung
Diese Datenschutzrichtlinie beschreibt, wie Adaptive Machines, Inc. ("Runner AI", "wir", "uns" oder "unser") personenbezogene Daten erfasst, verwendet und offenlegt, wenn Sie unsere Website und Dienste nutzen.
Im Rahmen unserer Mission, den Handel für alle bei Runner AI zu verbessern, erfassen und verwenden wir Informationen über Sie, unsere:
- Händler, die Runner AI für ihr Geschäft nutzen
- Kunden, die bei einem Runner AI-betriebenen Geschäft einkaufen
- Besucher der Websites von Runner AI oder Personen, die den Runner AI Support kontaktieren
Wenn wir unsere Datenschutzpraktiken ändern, können wir diese Datenschutzrichtlinie aktualisieren. Wenn Änderungen wesentlich sind, werden wir Sie darüber informieren (zum Beispiel über den Runner AI Admin oder per E-Mail).
## Unsere Werte
Vertrauen ist das Fundament der Runner AI Plattform und umfasst auch das Vertrauen darauf, dass wir das Richtige mit Ihren Informationen tun. Drei Hauptwerte leiten uns bei der Entwicklung unserer Produkte und Dienstleistungen. Diese Werte sollten Ihnen helfen, besser zu verstehen, wie wir über Ihre Informationen und Privatsphäre denken.
### Ihre Informationen gehören Ihnen
Wir analysieren sorgfältig, welche Arten von Informationen wir benötigen, um unsere Dienste bereitzustellen, und versuchen, die Informationen, die wir erfassen, auf das wirklich Notwendige zu beschränken. Wo möglich, löschen oder anonymisieren wir diese Informationen, wenn wir sie nicht mehr benötigen. Beim Aufbau und der Verbesserung unserer Produkte arbeiten unsere Ingenieure eng mit unseren Datenschutz- und Sicherheitsteams zusammen, um datenschutzfreundlich zu entwickeln. Bei all dieser Arbeit ist unser Leitprinzip, dass Ihre Informationen Ihnen gehören, und wir streben danach, Ihre Informationen nur zu Ihrem Vorteil zu verwenden.
### Wir schützen Ihre Informationen vor anderen
Wenn ein Dritter Ihre personenbezogenen Daten anfordert, werden wir die Weitergabe verweigern, es sei denn, Sie geben uns die Erlaubnis oder wir sind gesetzlich dazu verpflichtet. Wenn wir gesetzlich verpflichtet sind, Ihre personenbezogenen Daten weiterzugeben, werden wir Sie im Voraus informieren, es sei denn, dies ist uns gesetzlich untersagt.
### Wir helfen Händlern, ihre Datenschutzverpflichtungen zu erfüllen
Viele der Händler, die Runner AI nutzen, verfügen nicht über ein eigenes Datenschutzteam, und es ist uns wichtig, ihnen zu helfen, ihre Datenschutzverpflichtungen zu erfüllen. Dazu versuchen wir, unsere Produkte und Dienstleistungen so zu entwickeln, dass sie leicht datenschutzfreundlich genutzt werden können. Wir stellen auch detaillierte FAQs und Dokumentationen zu den wichtigsten Datenschutzthemen bereit und beantworten datenschutzbezogene Fragen, die wir erhalten.
## Warum wir Ihre Informationen verarbeiten
Wir verarbeiten Ihre Informationen im Allgemeinen, wenn wir dies zur Erfüllung einer vertraglichen Verpflichtung tun müssen (zum Beispiel zur Abwicklung Ihrer Abonnementzahlungen für die Nutzung der Runner AI Plattform) oder wenn wir oder jemand, mit dem wir zusammenarbeiten, Ihre personenbezogenen Daten aus einem geschäftsbezogenen Grund verwenden müssen (zum Beispiel um Ihnen eine Dienstleistung zu erbringen). Gesetze im Europäischen Wirtschaftsraum ("EWR") und im Vereinigten Königreich ("UK") nennen diese Gründe "berechtigte Interessen". Diese "berechtigten Interessen" umfassen:
- Verhinderung von Risiken und Betrug
- Beantwortung von Fragen oder Bereitstellung anderer Arten von Support
- Bereitstellung und Verbesserung unserer Produkte und Dienstleistungen
- Bereitstellung von Berichten und Analysen
- Testen von Funktionen oder zusätzlichen Diensten
- Unterstützung bei Marketing, Werbung oder anderen Kommunikationen
Wir verarbeiten personenbezogene Daten für diese "berechtigten Interessen" nur, nachdem wir die potenziellen Risiken für Ihre Privatsphäre berücksichtigt und Risiken mit bestimmten Maßnahmen abgewogen haben – zum Beispiel durch klare Transparenz unserer Datenschutzpraktiken, indem wir Ihnen Kontrolle über Ihre personenbezogenen Daten bieten, wo dies angemessen ist, durch Begrenzung der Informationen, die wir aufbewahren, durch Einschränkung dessen, was wir mit Ihren Informationen tun, an wen wir Ihre Informationen senden, wie lange wir Ihre Informationen aufbewahren oder durch die technischen Maßnahmen, die wir zum Schutz Ihrer Informationen einsetzen.
Wir können Ihre personenbezogenen Daten auch verarbeiten, wenn Sie Ihre Einwilligung erteilt haben. Insbesondere, wenn wir uns nicht auf eine alternative Rechtsgrundlage für die Verarbeitung stützen können, wenn Sie uns anweisen, Informationen an einen Dritten zu übertragen, wenn wir Ihre Daten von einem Dritten erhalten, der bereits über eine Einwilligung verfügt, oder wenn wir gesetzlich verpflichtet sind, Ihre Einwilligung einzuholen (einschließlich im Zusammenhang mit einigen unserer Vertriebs- und Marketingaktivitäten). Sie haben jederzeit das Recht, Ihre Einwilligung zu widerrufen, indem Sie Ihre Kommunikationspräferenzen ändern, sich von unseren Kommunikationen abmelden oder uns kontaktieren.
Je nachdem, ob Sie Händler, Kunde oder Besucher sind, beachten Sie bitte unsere ergänzenden Datenschutzrichtlinien, um unsere Verarbeitungszwecke, Kategorien von Empfängern und Rechtsgrundlagen für die Verarbeitung für jede Art personenbezogener Daten zu verstehen.
## Ihre Rechte in Bezug auf Ihre Informationen
Wir glauben, dass Sie in der Lage sein sollten, auf Ihre personenbezogenen Daten zuzugreifen und diese zu kontrollieren, unabhängig davon, wo Sie leben. Je nachdem, wie Sie Runner AI nutzen, haben Sie möglicherweise das Recht, Zugang zu Ihren personenbezogenen Daten zu beantragen, diese zu korrigieren, zu ändern, zu löschen, an einen anderen Dienstanbieter zu übertragen, einzuschränken oder bestimmten Verwendungen Ihrer personenbezogenen Daten zu widersprechen. Wir werden Ihnen nicht mehr berechnen oder Ihnen ein anderes Serviceniveau bieten, wenn Sie eines dieser Rechte ausüben. Bitte beachten Sie, dass eine Reihe dieser Rechte nur unter bestimmten Umständen gelten und alle diese Rechte gesetzlich eingeschränkt sein können.
Wenn Sie etwas bei einem Runner AI-betriebenen Shop kaufen oder diesem auf andere Weise Ihre Informationen zur Verfügung stellen und diese Rechte in Bezug auf Informationen über Ihren Kauf oder Ihre Interaktion ausüben möchten, müssen Sie sich direkt an den Händler wenden, mit dem Sie interagiert haben. Wir sind ein Auftragsverarbeiter und verarbeiten Informationen in ihrem Auftrag. Wir werden unseren Händlern natürlich helfen, diese Anfragen im gesetzlich erforderlichen Umfang zu erfüllen, indem wir ihnen die entsprechenden Tools zur Verfügung stellen und ihre Fragen beantworten.
Wenn Sie Händler, Runner AI Mitarbeiter, Website-Besucher oder eine andere Person sind, mit der Runner AI eine direkte Beziehung hat, reichen Sie bitte eine verifizierbare Anfrage per E-Mail an support@adaptivemachines.ai ein. Bitte beachten Sie, dass wir, wenn Sie uns eine Anfrage bezüglich Ihrer personenbezogenen Daten senden, sicherstellen müssen, dass Sie es sind, bevor wir antworten können. Dazu können wir einen Dritten beauftragen, Ausweisdokumente zu erfassen und zu verifizieren. Weitere Informationen über die Rechte, die US-Einwohnern zur Verfügung stehen, finden Sie unten unter der Überschrift "Datenschutzhinweis für die Vereinigten Staaten".
Schließlich gibt es kein gemeinsames Verständnis darüber, was ein "Do Not Track"-Signal bedeuten soll, weshalb wir nicht auf besondere Weise auf diese Signale reagieren.
## Wohin wir Ihre Informationen senden
Wir sind ein amerikanisches Unternehmen, arbeiten aber mit Personen auf der ganzen Welt zusammen und verarbeiten Daten über diese. Um unser Geschäft zu betreiben, können wir Ihre personenbezogenen Daten außerhalb Ihres Bundesstaates, Ihrer Provinz oder Ihres Landes senden. Diese Daten können den Gesetzen der Länder unterliegen, in die wir sie senden. Wir ergreifen Maßnahmen, um Ihre Informationen zu schützen, wenn wir sie über Grenzen hinweg senden.
Je nachdem, ob Sie Händler, Kunde, Nutzer oder Besucher sind, beachten Sie bitte unsere ergänzenden Datenschutzrichtlinien.
Schließlich können wir gesetzlich verpflichtet sein, Ihre personenbezogenen Daten offenzulegen (zum Beispiel wenn wir einen gültigen Gerichtsbeschluss erhalten), auch wenn wir alles tun, um Ihre Informationen zu schützen.
Wenn wir personenbezogene Daten aus dem Europäischen Wirtschaftsraum (EWR), dem Vereinigten Königreich oder der Schweiz in Länder übermitteln, für die kein angemessenes Datenschutzniveau festgestellt wurde, stützen wir uns auf rechtliche Mechanismen wie die von der Europäischen Kommission genehmigten Standardvertragsklauseln, um die Übermittlung abzusichern.
## Google user data and Google integrations
This section applies when you use Google Sign-In or connect Google Ads, Google Merchant Center, or another Google service to Runner AI.
### What Google user data we access and store
For Google Sign-In, we access the Google account information you authorize, such as your name, email address, profile image, and Google account identifier, to create or log in to your Runner AI account.
For Google Ads and Google Merchant Center integrations, we request the Google OAuth scopes needed to provide the ads features you choose, including `https://www.googleapis.com/auth/adwords` and `https://www.googleapis.com/auth/content`. Depending on the features you use, we may store OAuth access tokens, refresh tokens, granted scopes, token expiration data, accessible Google Ads customer account identifiers, account names, manager-account status, and selected account bindings. We may also access and process Google Ads campaign, ad group, ad, creative, asset, budget, bidding, targeting, performance metric, conversion value, ROAS, and change-history data, including the user email associated with a Google Ads account change, as well as Google Merchant Center account identifiers and account names.
### How we use Google user data
We use Google user data only to provide or improve user-facing Runner AI features that you request, including signing you in, connecting and refreshing your Google integrations, listing selectable Google Ads and Merchant Center accounts, showing ads dashboards and reports, generating requested AI ads analysis or campaign drafts, publishing or updating campaigns you approve, syncing account access, and troubleshooting or securing those features.
We do not sell Google user data. We do not use Google user data for retargeting, personalized advertising unrelated to your requested Runner AI ads features, credit-worthiness, lending, or transfer to data brokers or information resellers.
### With whom we share, transfer, or disclose Google user data
We share, transfer, or disclose Google user data only in the following circumstances:
- **Google LLC.** We send authorization codes, OAuth tokens, developer-token-authenticated requests, campaign settings, Merchant Center identifiers, and related API request data to Google APIs so that we can authenticate your account, read the Google Ads or Merchant Center data you authorized, and perform the Google Ads or Merchant Center actions you request.
- **Your authorized Runner AI organization users.** Google Ads account metadata, reports, metrics, creatives, change history, Merchant Center account metadata, and campaign drafts may be visible to users in your Runner AI organization according to their workspace permissions.
- **Service providers and subprocessors.** We may share Google user data with service providers that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI, subject to confidentiality and data-processing obligations. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- **Legal, safety, and business-transfer recipients.** We may disclose Google user data when required by law, to protect rights, safety, and security, to investigate abuse, or in connection with a merger, acquisition, financing, reorganization, bankruptcy, or sale of assets, as described elsewhere in this Privacy Policy.
Except as described above or with your explicit direction, we do not share, transfer, or disclose Google user data to third-party advertising platforms, data brokers, information resellers, or other third parties.
### Retention and user control
We retain connected Google integration tokens and account metadata while the integration remains enabled or as needed to provide the Services, comply with law, resolve disputes, enforce agreements, maintain security, or keep backups. Disconnecting Google Ads in Runner AI deletes the active Google Ads integration record, including stored OAuth tokens and account metadata. You can also revoke Runner AI's Google access from your Google account settings.
Runner AI's use and transfer of information received from Google APIs will adhere to the [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy), including the Limited Use requirements.
## Wie lange wir Ihre Informationen aufbewahren
Wir bewahren Ihre personenbezogenen Daten nur so lange auf, wie es zur Erfüllung der Zwecke, für die wir sie erfasst haben, erforderlich ist. Um die angemessene Aufbewahrungsdauer zu bestimmen, berücksichtigen wir die Menge, Art und Sensibilität Ihrer personenbezogenen Daten, das potenzielle Risiko eines Schadens durch unbefugte Nutzung oder Offenlegung Ihrer personenbezogenen Daten, die Zwecke, für die wir Ihre personenbezogenen Daten verarbeiten, und ob wir diese Zwecke auf andere Weise erreichen können, sowie die geltenden rechtlichen Anforderungen. Wir werden Ihre personenbezogenen Daten auch in dem Umfang aufbewahren und verwenden, der notwendig ist, um unseren rechtlichen Verpflichtungen nachzukommen, Streitigkeiten beizulegen und unsere Richtlinien durchzusetzen. Wenn Sie die Nutzung unserer Dienste einstellen oder Ihr Konto bei uns löschen, werden wir Ihre Informationen löschen oder in einem aggregierten und anonymisierten Format speichern.
Je nachdem, ob Sie Händler, Kunde, Nutzer oder Besucher sind, beachten Sie bitte unsere ergänzenden Datenschutzrichtlinien für weitere Details zur Aufbewahrung Ihrer personenbezogenen Daten.
## Unsere Nutzung von maschinellem Lernen
Um unsere erweiterten KI-gestützten Funktionen für automatisierte Abläufe und Wachstum bereitzustellen, nutzt unsere Plattform maschinelles Lernen. Wir verwenden diese Technologien, um Dienste wie prädiktive Analysen, Marketingkampagnenvorschläge und Empfehlungen zur Konversionsoptimierung bereitzustellen.
Unsere KI-Funktionen sind als Entscheidungsunterstützungstools konzipiert. Sie generieren datengesteuerte Vorschläge zu Ihrer Überlegung. Dies sind keine automatisierten Entscheidungen. Sie, der Händler, behalten die volle Kontrolle und sind allein verantwortlich für die Überprüfung, Genehmigung und Umsetzung aller von unserer KI bereitgestellten Vorschläge. Der Dienst wird nur Aktionen auf Ihre ausdrückliche Genehmigung hin oder basierend auf von Ihnen vorkonfigurierten Einstellungen ausführen. Unsere Rechtsgrundlage für die Verwendung Ihrer Daten zu diesen Zwecken ist in unseren Nutzungsbedingungen unter der Klausel "Datennutzung zur KI-Verbesserung" weiter detailliert.
## Wie wir Ihre Informationen schützen
Unsere Teams arbeiten unermüdlich daran, Ihre Informationen zu schützen und die Sicherheit und Integrität unserer Plattform zu gewährleisten. Wir lassen auch unabhängige Prüfer die Sicherheit unserer Datenspeicherung und Systeme, die Finanzinformationen verarbeiten, bewerten. Wir wissen jedoch alle, dass keine Übertragungsmethode über das Internet und keine elektronische Speichermethode zu 100 % sicher sein kann. Dies bedeutet, dass wir die absolute Sicherheit Ihrer personenbezogenen Daten nicht garantieren können.
## Wie wir "Cookies" und andere Tracking-Technologien verwenden
Wir verwenden Cookies und ähnliche Tracking-Technologien auf unserer Website und bei der Bereitstellung unserer Dienste. Weitere Informationen darüber, wie wir diese Technologien verwenden, einschließlich einer Liste anderer Unternehmen, die Cookies auf unseren Websites platzieren, einer Liste von Cookies, die wir platzieren, wenn wir den Shop eines Händlers betreiben, und einer Erklärung, wie Sie bestimmte Arten von Cookies ablehnen können, finden Sie in unserer Cookie-Richtlinie.
## Wie Sie uns erreichen können
Wenn Sie Fragen stellen, eine Anfrage stellen oder sich über die Verarbeitung Ihrer personenbezogenen Daten beschweren möchten, kontaktieren Sie bitte den Runner AI Support per E-Mail unter support@adaptivemachines.ai oder per Post an die unten stehende Adresse:
Adaptive Machines, Inc.
2911 Noyce Place, 189, Santa Clara, CA 95051, USA
Wenn Sie etwas bei einem Runner AI-betriebenen Shop kaufen oder diesem auf andere Weise Ihre Informationen zur Verfügung stellen, ist der Händler Ihr Datenverantwortlicher und wir handeln als Auftragsverarbeiter in seinem Auftrag.
Wenn Sie Fragen dazu haben, wie ein Händler oder Shop Ihre personenbezogenen Daten verarbeitet, sollten Sie den Händler kontaktieren oder dessen Datenschutzrichtlinie einsehen.
## Datenschutzhinweis für die Vereinigten Staaten
Dieser Datenschutzhinweis für die Vereinigten Staaten ("US-Hinweis") ergänzt unsere Datenschutzrichtlinie und alle ergänzenden Datenschutzrichtlinien auf /de/legal/policies (zusammen die "Runner AI Datenschutzrichtlinien").
Dieser US-Hinweis richtet sich an Personen, die in bestimmten US-Bundesstaaten wohnen, und soll Ihnen helfen, besser zu verstehen, wie wir Ihre personenbezogenen Daten erfassen, verwenden und offenlegen, und je nachdem, wie Sie Runner AI nutzen und wo Sie wohnen, wie Sie verfügbare Rechte gemäß verschiedenen geltenden Datenschutzgesetzen in den USA ausüben können, insbesondere dem California Consumer Privacy Act, dem Colorado Privacy Act, dem Connecticut Act Concerning Personal Data Privacy and Online Monitoring, dem Utah Consumer Privacy Act und dem Virginia Consumer Data Protection Act (zusammen die "US-Datenschutzgesetze").
### 11.1 Welche Informationen wir über Sie erfassen und weitergeben
Um Ihnen unsere Dienste bereitzustellen, müssen wir Informationen über Sie verarbeiten, einschließlich personenbezogener Daten.
Wir "verkaufen" Ihre personenbezogenen Daten nicht im Sinne der US-Datenschutzgesetze.
Hier ist eine Zusammenfassung der Kategorien personenbezogener Daten, die wir in Zukunft über Sie erfassen können, und an wen wir diese Informationen möglicherweise weitergegeben haben, je nachdem, wie Sie Runner AI nutzen.
| Kategorien erfasster personenbezogener Daten | Empfänger personenbezogener Daten |
|----------------------------------------------|-----------------------------------|
| Identifikatoren, einschließlich Name, E-Mail-Adresse, Postanschrift, Telefonnummer; | Unternehmen, die uns bei der Bereitstellung unserer Dienste helfen, einschließlich Cloud-Speicheranbieter, Zahlungsabwickler, Fulfillment-Partner, Sicherheitsanbieter, E-Mail-Anbieter, Marktplätze und Datenanalyse-Anbieter; |
| Kategorien personenbezogener Daten, die im kalifornischen Gesetz über Kundendatensätze aufgeführt sind, einschließlich Name, Post- und Rechnungsadresse, Telefonnummer, Kredit- oder Debitkartendaten; | Werbetreibende und Marketing-Anbieter; |
| Geschäftsinformationen, einschließlich der Produkte, die Sie kaufen, in Ihren Warenkorb legen, favorisieren oder bewerten (wenn Sie Kunde sind) und Informationen, die Sie uns über sich und Ihr Unternehmen zur Verfügung stellen (wenn Sie Händler sind); | Händler, deren Shops Sie besuchen oder bei denen Sie Einkäufe tätigen; |
| Fotos und Videos, die Gesichtsbilder enthalten können, wenn Sie diese bereitstellen möchten. | Partner, die Ihnen bei der Nutzung unserer Dienste helfen, wie z. B. Zahlungs- oder Logistikanbieter, die Sie für die Integration mit Ihrem Shop wählen. |
| Internet- oder andere elektronische Netzwerkaktivitätsinformationen, einschließlich Informationen über das von Ihnen verwendete Gerät und den Browser, Netzwerkverbindung, IP-Adresse und wie Sie durch unsere Websites navigieren; | Strafverfolgungsbehörden oder andere Dritte im Zusammenhang mit rechtlichen Anfragen, zur Einhaltung geltender Gesetze oder zur Verhinderung von Schäden. |
| Geolokalisierungsdaten, einschließlich Ihrer Post- und Rechnungsadresse; | |
| Schlussfolgerungen oder Informationen, die aus anderen personenbezogenen Daten über Sie abgeleitet wurden, die Ihre Präferenzen, Interessen und andere Informationen umfassen können, die zur Personalisierung Ihrer Erfahrung verwendet werden; | |
| Andere von Ihnen bereitgestellte Informationen; und | |
| Sensible personenbezogene Daten, die Folgendes umfassen können: Von der Regierung ausgestellte Identifikatoren, einschließlich Sozialversicherungsnummer, Führerschein, staatlicher Personalausweis oder Reisepassnummer; Ihre Kontozugangsdaten (wie Kontoanmeldung, Finanzkonto, Debit- oder Kreditkartennummer in Kombination mit erforderlichen Sicherheitszugangscodes, Passwörtern oder Zugangsdaten für den Zugriff auf ein Konto); | |
### 11.2 Warum wir Ihre personenbezogenen Daten erfassen und weitergeben
Wir verwenden und geben Ihre personenbezogenen Daten für die in den Runner AI Datenschutzrichtlinien dargelegten Zwecke weiter. Für Kategorien sensibler personenbezogener Daten, die wir erfassen, verwenden oder geben wir solche Informationen nur mit Ihrer ausdrücklichen Einwilligung, wenn erforderlich, oder wie anderweitig gesetzlich zulässig weiter.
### 11.3 Quellen personenbezogener Daten
Um den Handel für alle bei Runner AI zu verbessern, erfassen und verwenden wir personenbezogene Daten, die bereitgestellt werden von:
**Ihnen:** Wir erfassen die Informationen, die Sie bereitstellen, wenn Sie unsere Plattform nutzen, einschließlich wenn Sie sich als Händler für Runner AI anmelden, einen Runner AI-betriebenen Shop besuchen, Bestellinformationen ausfüllen, eine der Websites von Runner AI besuchen oder den Runner AI Support kontaktieren. Wir erfassen Konto- und Zahlungsinformationen, die Sie uns zur Verfügung stellen (einschließlich Informationen über Ihr Unternehmen, wenn Sie Händler sind), Runner AI Shops oder Artikel, die Sie als Favoriten speichern, Käufe, die Sie tätigen, Bewertungen, die Sie veröffentlichen, und wie Sie anderweitig mit Shops oder anderen Nutzern unserer Dienste interagieren oder kommunizieren. Wir erfassen auch Informationen darüber, wie Sie durch unsere Websites navigieren, einschließlich Suchbegriffen, die Sie möglicherweise eingeben.
**Ihren Geräten:** Wir erfassen Informationen von und über die Geräte, die Sie verwenden, einschließlich Computer, Telefone und anderen webverbundenen Geräten, die Sie für den Zugriff auf unsere Dienste verwenden, und wir kombinieren diese Informationen über verschiedene Geräte hinweg, die Sie verwenden.
**Dritten:** Wir erhalten Informationen von Partnern, die uns helfen, Ihnen unsere Dienste bereitzustellen, einschließlich der folgenden:
- **Dienstanbieter.** Wir erhalten Informationen von unseren Dienstanbietern, die uns helfen, Dienstleistungen für unsere Händler zu erbringen, wie z. B. die Überprüfung von Konten auf Betrug oder andere Bedenken.
- **Unterauftragsverarbeiter.** Wir arbeiten mit Drittanbietern als Unterauftragsverarbeiter für Cloud-Hosting, Content Delivery, Datenanalyse, internes Logging, Fulfillment-Services und E-Mail-Übermittlung zusammen, um Ihnen unsere Dienste bereitzustellen. Weitere Informationen finden Sie bei den Unterauftragsverarbeitern von Runner AI.
- **Analyse- und Cookie-Anbieter.** Wir erhalten Informationen durch unsere Verwendung von Cookies, Social Plugins (wie der Facebook "Like"-Button), Pixeln und Tags für geschäftliche Zwecke, wie z. B. die Bereitstellung von Informationen, um zu messen, wie Nutzer mit unseren Website-Inhalten interagieren. Weitere Informationen über die Verwendung dieser Technologien finden Sie in unserer Cookie-Richtlinie.
### 11.4 Wie lange wir Ihre Informationen aufbewahren
Da wir Ihre personenbezogenen Daten benötigen, um Runner AI Dienste bereitzustellen, bewahren wir Ihre personenbezogenen Daten, einschließlich sensibler personenbezogener Daten, im Allgemeinen auf, solange Sie Runner AI Produkte oder Dienste nutzen oder bis Sie uns auffordern, Ihre Informationen zu löschen. Wir können personenbezogene Daten auch aufbewahren, um rechtlichen Verpflichtungen nachzukommen oder unsere oder die Interessen anderer zu schützen.
Wenn Sie ein Händler sind, der einen Runner AI-betriebenen Shop betreibt, und Sie den Shop schließen, die Zahlung Ihrer Abonnementgebühren einstellen oder wir Ihr Konto kündigen, bewahren wir Shop-Informationen zwei Jahre lang auf, bevor wir mit dem Löschprozess beginnen.
Wenn Sie einen Runner AI-betriebenen Shop eines Händlers besuchen oder dort einen Kauf tätigen, handeln wir als Dienstanbieter oder Auftragsverarbeiter für den Händler, und der Händler, nicht Runner AI, entscheidet, wie lange Ihre Informationen aufbewahrt werden.
### 11.5 Ihre Rechte in Bezug auf Ihre Informationen
Je nachdem, wo Sie leben, wie Sie Runner AI nutzen und vorbehaltlich bestimmter Ausnahmen, können Sie einige oder alle der folgenden Rechte haben:
- **Recht auf Kenntnis:** Das Recht zu verlangen, dass wir Ihnen die personenbezogenen Daten offenlegen, die wir über Sie erfassen, verwenden oder offenlegen, Quellen, aus denen wir Ihre personenbezogenen Daten erfassen, und Informationen über unsere Datenpraktiken.
- **Recht auf Berichtigung:** Das Recht zu verlangen, dass wir ungenaue personenbezogene Daten korrigieren, die wir über Sie führen.
- **Recht auf Löschung:** Das Recht zu verlangen, dass wir alle personenbezogenen Daten löschen, die wir über Sie erfasst haben.
Um Ihre Rechte auszuüben, einschließlich des "Rechts auf Kenntnis" und des "Rechts auf Löschung", reichen Sie bitte eine Anfrage über support@adaptivemachines.ai ein.
Wenn Sie einen Runner AI-betriebenen Shop eines Händlers besucht oder dort einen Kauf getätigt haben, kontaktieren Sie bitte direkt den jeweiligen Händler. Wenn Sie eine Anfrage an uns stellen, werden wir Ihre Anfrage an den relevanten Händler weiterleiten.
Bitte beachten Sie, dass wir zum Schutz Ihrer Informationen und der Integrität unserer Produkte und Dienstleistungen möglicherweise Ihre Identität überprüfen müssen, bevor wir Ihre Anfrage bearbeiten. In einigen Fällen müssen wir möglicherweise zusätzliche Informationen erfassen, um Ihre Identität zu überprüfen, wie z. B. Ihre E-Mail-Adresse oder einen von der Regierung ausgestellten Ausweis.
Gemäß den US-Datenschutzgesetzen können Sie auch einen bevollmächtigten Vertreter benennen, der diese Anfragen in Ihrem Namen stellt. Wenn Sie einen bevollmächtigten Vertreter verwenden, um eine Anfrage einzureichen, müssen wir möglicherweise zusätzliche Informationen erfassen, wie z. B. einen von der Regierung ausgestellten Ausweis, um Ihre Identität zu überprüfen, bevor wir Ihre Anfrage bearbeiten, um Ihre Informationen zu schützen.
In bestimmten Bundesstaaten haben Sie möglicherweise das Recht, gegen unsere Entscheidung bezüglich einer Anfrage in Bezug auf diese Rechte Berufung einzulegen. Wenn Sie gegen eine Entscheidung Berufung einlegen möchten, kontaktieren Sie bitte den Runner AI Support.
Wir werden Sie nicht diskriminieren, wenn Sie eines dieser Rechte ausüben.
## Zusätzliche Informationen für Nutzer in bestimmten Regionen
### Für Nutzer im Europäischen Wirtschaftsraum (EWR), UK und der Schweiz:
Wenn Sie sich im EWR, UK oder in der Schweiz befinden, verarbeiten wir Ihre personenbezogenen Daten nur, wenn wir eine gültige Rechtsgrundlage haben. Für Informationen, bei denen wir der Datenverantwortliche sind (z. B. für unsere Händler und Website-Besucher), umfassen unsere Rechtsgrundlagen:
- **Vertragserfüllung:** Um Ihnen unsere Dienste gemäß unseren Nutzungsbedingungen bereitzustellen.
- **Berechtigtes Interesse:** Für Zwecke wie Sicherheit, Plattformverbesserung und Marketing, bei denen unsere Interessen nicht durch Ihre Datenschutzrechte überwiegen.
- **Einwilligung:** Für bestimmte Verwendungen, wie das Versenden von Marketing-E-Mails oder das Platzieren nicht wesentlicher Cookies, bei denen wir um Ihre Einwilligung bitten.
- **Rechtliche Verpflichtung:** Zur Einhaltung unserer rechtlichen Verpflichtungen.
### Für Nutzer in Kalifornien:
Wenn Sie in Kalifornien wohnen, haben Sie Rechte gemäß CCPA/CPRA, einschließlich des Rechts auf Kenntnis, Löschung, Berichtigung und des Rechts auf Widerspruch gegen den Verkauf oder die Weitergabe Ihrer personenbezogenen Daten für Zwecke kontextübergreifender verhaltensbezogener Werbung. Sie können dieses Recht jederzeit ausüben, indem Sie auf den Link "Meine personenbezogenen Daten nicht verkaufen oder weitergeben" in der Fußzeile unserer Website klicken oder Ihre Cookie-Einstellungen verwalten.
---
# Datenschutzrichtlinie für Verbraucher
Source: https://www.runnerai.com/docs/de/legal/policies/consumers
## Inhaltsverzeichnis
1. [Einleitung](#einleitung)
2. [Welche personenbezogenen Daten wir erhalten](#welche-personenbezogenen-daten-wir-erhalten)
3. [Wie wir Ihre personenbezogenen Daten verwenden](#wie-wir-ihre-personenbezogenen-daten-verwenden)
4. [Wie wir Ihre personenbezogenen Daten im Auftrag von Runner AI Händlern verarbeiten](#wie-wir-ihre-personenbezogenen-daten-im-auftrag-von-runner-ai-händlern-verarbeiten)
5. [Dritte, die personenbezogene Daten erhalten können](#dritte-die-personenbezogene-daten-erhalten-können)
6. [Drittanbieter-Partner und Integrationen](#drittanbieter-partner-und-integrationen)
7. [Ihre Datenschutzrechte und Wahlmöglichkeiten](#ihre-datenschutzrechte-und-wahlmöglichkeiten)
8. [Aufbewahrung](#aufbewahrung)
9. [Wie Sie uns kontaktieren](#wie-sie-uns-kontaktieren)
10. [Änderungen dieser Datenschutzrichtlinie](#änderungen-dieser-datenschutzrichtlinie)
## Einleitung
Diese Datenschutzrichtlinie beschreibt die personenbezogenen Daten, die Runner AI erhält und/oder verarbeitet (was das Erfassen, Organisieren, Strukturieren, Speichern, Verwenden oder Offenlegen umfassen kann), wenn Sie mit Runner AI interagieren oder Runner AI Verbraucherdienste nutzen, wie in den Verbraucher-Nutzungsbedingungen definiert, einschließlich beim Einkaufen bei einem Händler, der die Plattform von Runner AI nutzt oder von dieser betrieben wird ("Runner AI Händler" oder "Händler"). Bitte lesen Sie zusätzlich unsere [allgemeine Datenschutzrichtlinie](/de/legal/policies), die für alle gilt, deren Informationen wir verarbeiten. Sollten Bestimmungen in dieser Richtlinie mit Bestimmungen der allgemeinen Datenschutzrichtlinie in Konflikt stehen, gelten die Bestimmungen dieser Richtlinie.
## Welche personenbezogenen Daten wir erhalten
Personenbezogene Daten sind alle Informationen von oder über eine identifizierte oder identifizierbare Person, umfassen jedoch keine aggregierten oder anonymisierten Informationen. Wir erhalten personenbezogene Daten, wenn Sie Runner AI oder Runner AI Dienste nutzen oder mit ihnen interagieren, was folgende Kategorien umfassen kann:
### 1. Profil- und Kontaktinformationen
Wir erhalten Kontakt- oder andere Profilinformationen, wenn Sie sich für Runner AI Verbraucherdienste anmelden oder mit ihnen interagieren, was Telefonnummer, E-Mail-Adresse oder andere Informationen umfassen kann, die Sie uns zur Verfügung stellen. Wir können diese Informationen mit den verschiedenen Geräten oder Konten verknüpfen, die Sie verwenden, wenn Sie mit Runner AI interagieren oder die Runner AI Verbraucherdienste nutzen.
### 2. Geräteinformationen
Wir erhalten Informationen über die Computer, Telefone und anderen Geräte, die Sie verwenden oder mit denen Sie mit Runner AI oder Runner AI Verbraucherdiensten interagieren, einschließlich IP-Adresse (die zur Bestimmung des allgemeinen Standorts verwendet werden kann), Geräteidentifikatoren, Cookie-IDs, den von Ihnen verwendeten Browser, Ihre Netzwerkverbindung oder andere eindeutige Identifikatoren oder Geräteinformationen.
### 3. Zahlungsinformationen
Wir erhalten Zahlungsinformationen, wenn Sie einen Kauf über Runner AI oder Runner AI Händler tätigen, wie z. B. Ihre Zahlungskartennummer und das Ablaufdatum.
### 4. Nutzung der Runner AI Verbraucherdienste
Wir erhalten Informationen über Ihre Nutzung von oder Interaktionen mit Runner AI Verbraucherdiensten, unabhängig davon, ob Sie bei Runner AI angemeldet sind, wie z. B. Ihre Interaktionen mit Runner AI Händlern, die Shop(s), die Sie besuchen, die Produkte, die Sie ansehen und besuchen, die Produktbewertungen und -bewertungen, die Sie veröffentlichen und teilen, Ihren Bestellverlauf, andere Marketingaktivitäten im Zusammenhang mit den Runner AI Verbraucherdiensten und favorisierte Shops.
### 5. Einstellungen und Datenschutzpräferenzen
Wir erhalten Informationen über Ihre Einstellungen und Präferenzen bei Runner AI und unseren Händlern sowie Informationen über Ihre Browser- und Gerätedatenschutzeinstellungen.
### 6. Kommunikation mit Runner AI
Wir erhalten Informationen, einschließlich Nachrichten- und E-Mail-Inhalten, wenn Sie mit Runner AI kommunizieren (z. B. bei Kundendienstanfragen, Teilnahme an Umfragen, Werbeaktionen oder Forschungen).
### 7. Social-Network-Konten
Wenn Sie sich entscheiden, Runner AI Verbraucherdienste über einen Online-Dienst eines Drittanbieters zu verknüpfen, zu verbinden oder sich anzumelden, weisen Sie den Dienst an, uns bestimmte Informationen über Sie zu senden, die von diesem Dienst kontrolliert werden, wie z. B. Profilinformationen. Diese Weitergabe unterliegt den geltenden Datenschutzhinweisen und Ihren Datenschutzeinstellungen dieses Dienstes.
## Wie wir Ihre personenbezogenen Daten verwenden
Runner AI verwendet personenbezogene Daten für die folgenden Zwecke, je nachdem, wie Sie mit uns interagieren oder welche Runner AI Dienste Sie nutzen, und basierend auf Ihrer Aktivität auf allen Geräten, auf denen Sie sich bei Runner AI oder Runner AI Diensten anmelden oder mit ihnen interagieren:
### 1. Bereitstellung, Verbesserung und Anpassung von Runner AI Diensten
Um Ihnen individuell angepasste Runner AI Dienste bereitzustellen, einschließlich der Anzeige Ihres Kaufverlaufs und Bestellstatus an einem Ort, der Bereitstellung einfacher Zahlungsoptionen beim Einkaufen, der Empfehlung von Produkten, Händlern und Shop(s) sowie der Anpassung der für Sie ausgewählten Produkte, und um Runner AI Dienste zu verbessern, einschließlich basierend auf Ihrer Nutzung von Runner AI Verbraucherdiensten und Ihrer Aktivität mit unseren Händlern.
### 2. Nachverfolgen und Umsetzen Ihrer Datenschutzpräferenzen und Einstellungen
Um Ihre Einstellungen und Datenschutzpräferenzen mit Runner AI und unseren Händlern nachzuverfolgen und umzusetzen.
### 3. Durchführung von Produktforschung und -entwicklung
Um Runner AI Dienste zu entwickeln, zu testen und zu verbessern, einschließlich der Fehlerbehebung bei unseren Produkten und Diensten, der Entwicklung neuer oder verbesserter Runner AI Dienste und der Analyse Ihrer Nutzung von und Interaktionen mit Runner AI Diensten.
### 4. Werbung, Marketing und Förderung von Runner AI
Um Runner AI Dienste auf und außerhalb von Runner AI zu vermarkten, zu bewerben und zu fördern, einschließlich personalisierter Kommunikationen oder Werbung in Bezug auf die Runner AI Dienste auf Drittanbieterdiensten.
### 5. Bereitstellung individuell angepasster Werbung für unsere Händler
Um unseren Händlern Werbedienste bereitzustellen, die personalisierte Werbung umfassen können.
### 6. Kommunikation mit Ihnen
Um mit Ihnen über Runner AI Dienste zu kommunizieren, einschließlich Produktaktualisierungen, Ihrem Konto und Änderungen an unseren Richtlinien und Bedingungen. Wir verwenden Ihre Informationen auch, um Ihnen zu antworten, wenn Sie uns kontaktieren.
### 7. Authentifizierung, Integrität, Sicherheit und Schutz
Um Ihr Konto zu authentifizieren, ein sicheres Zahlungs- und Einkaufserlebnis zu bieten und bösartiges Verhalten, betrügerische Aktivitäten oder unsichere Erfahrungen zu erkennen, zu untersuchen und zu verhindern, Sicherheitsbedrohungen anzugehen, die öffentliche Sicherheit zu schützen und Runner AI Dienste für Sie und unsere Händler zu sichern.
### 8. Rechtliche Gründe
Um geltendem Recht nachzukommen oder auf gültige rechtliche Verfahren zu reagieren, einschließlich Anfragen von Strafverfolgungsbehörden oder Regierungsbehörden, um an zivilrechtlichen Ermittlungsverfahren, Rechtsstreitigkeiten oder anderen kontradiktorischen rechtlichen Verfahren zu untersuchen oder teilzunehmen und potenzielle Verstöße gegen unsere Bedingungen oder Richtlinien durchzusetzen oder zu untersuchen.
Runner AI kann auch alle über die Runner AI Dienste erfassten Informationen aggregieren, de-identifizieren und/oder anonymisieren, sodass wir Informationen nicht mehr in angemessener Weise mit Ihnen oder Ihrem Gerät verknüpfen können. Wir können solche aggregierten, de-identifizierten oder anonymen Informationen für jeden Zweck verwenden, einschließlich beispielsweise zur Verbesserung des Runner AI Dienstes.
## Wie wir Ihre personenbezogenen Daten im Auftrag von Runner AI Händlern verarbeiten
Runner AI verarbeitet auch Ihre personenbezogenen Daten von Händlern, mit denen Sie interagieren oder bei denen Sie einkaufen, um Händlern zu helfen, ihre Shop(s) zu betreiben und unseren Händlern Geschäftsdienstleistungen bereitzustellen. Wenn Runner AI personenbezogene Daten auf diese Weise verarbeitet, handeln wir auf Anweisung des Händlers, und die Nutzungsbedingungen und Datenschutzrichtlinie des Händlers gelten – nicht die von Runner AI. Weitere Informationen darüber, wie Händler personenbezogene Daten erfassen und verwenden, wenn Sie ihre Shop(s) besuchen und dort Einkäufe tätigen, finden Sie in den Bedingungen und der Datenschutzrichtlinie des Händlers.
Darüber hinaus können einige Händler uns anweisen, personenbezogene Daten, die sie mit uns teilen, für gezielte Werbung für diese und andere Händler zu verwenden, die diese Dienste auf Websites Dritter nutzen. Möglicherweise haben Sie die Möglichkeit, der Weitergabe Ihrer Informationen durch einen Händler an uns für diese Zwecke direkt auf der Website dieses Händlers zu widersprechen.
## Dritte, die personenbezogene Daten erhalten können
Je nachdem, welche Runner AI Dienste Sie nutzen oder mit denen Sie interagieren, kann Runner AI personenbezogene Daten den folgenden Kategorien von Dritten zur Verfügung stellen:
### 1. Anbieter
Runner AI arbeitet mit Drittanbieter-Dienstleistern zusammen, um Runner AI Dienste und technische Infrastruktur bereitzustellen, zu unterstützen und zu verbessern, für Geschäftsdienste wie Zahlungsabwicklung, einschließlich im Zusammenhang mit Käufen, die Sie bei Nutzung von Runner AI Diensten tätigen, und für Marketing- und Geschäftsanalysen.
### 2. Marketing-, Werbe- und Analysepartner
Wir können Drittanbieter-Marketing-, Werbe- und Geschäftsanalysepartner verwenden, um personalisierte Werbung bereitzustellen und um uns zu helfen zu verstehen, wie Menschen Runner AI Dienste und unsere Händler nutzen oder mit ihnen interagieren. Diese Partner können Informationen über Ihre Nutzung von oder Interaktionen mit Runner AI Diensten erhalten, einschließlich durch Cookies oder andere Technologien von Drittanbietern.
### 3. Kontrollwechsel
Wir können personenbezogene Daten mit tatsächlichen oder potenziellen Erwerbern, ihren Vertretern und anderen relevanten Teilnehmern an oder während Verhandlungen über einen Verkauf, eine Fusion, eine Übernahme, eine Umstrukturierung oder einen Kontrollwechsel, der das gesamte oder einen Teil des Geschäfts oder der Vermögenswerte von Runner AI betrifft, einschließlich im Zusammenhang mit Insolvenz oder ähnlichen Verfahren, teilen.
### 4. Rechtliche Gründe
Wir können personenbezogene Daten nach Bedarf weitergeben, um: (1) potenzielle Verstöße gegen unsere Nutzungsbedingungen oder Richtlinien durchzusetzen oder zu untersuchen; (2) geltendem Recht nachzukommen oder auf gültige rechtliche Verfahren und Prozesse zu reagieren, zu untersuchen oder daran teilzunehmen, einschließlich von Strafverfolgungsbehörden oder Regierungsbehörden; (3) unsere sowie die Rechte und das Eigentum unserer Händler und Nutzer zu schützen; (4) unsere Unternehmens- und gesellschaftlichen Verantwortungsverpflichtungen zu erfüllen; (5) potenziellen Betrug, Missbrauch oder Sicherheits- und Schutzbedenken zu erkennen, zu verhindern oder zu untersuchen, einschließlich Bedrohungen der Öffentlichkeit; und (6) Streitigkeiten beizulegen und Vereinbarungen durchzusetzen.
### 5. Weitergabe nach Ihrem Ermessen
Wenn Sie eine Einwilligung erteilen, geben wir Ihre Informationen wie zum Zeitpunkt der Einwilligung beschrieben weiter, z. B. beim Verbinden mit einer Drittanbieter-Anwendung oder -Website.
## Drittanbieter-Partner und Integrationen
Teile der Runner AI Dienste können auf Drittanbieterdienste verlinken. Runner AI besitzt oder kontrolliert diese Drittanbieter nicht. Wenn Sie mit diesen Drittanbietern interagieren und sich entscheiden, deren Dienste zu nutzen, unterliegt Ihre Nutzung den Datenschutzrichtlinien dieser Anbieter.
## Ihre Datenschutzrechte und Wahlmöglichkeiten
Je nachdem, wo Sie leben, haben Sie möglicherweise bestimmte Rechte zur Verwaltung Ihrer personenbezogenen Daten. Je nach Ihrer Gerichtsbarkeit können die folgenden Rechte vorbehaltlich bestimmter Ausnahmen gelten:
### 1. Zugang und Portabilität
Recht auf Anforderung des Zugangs zu Ihren personenbezogenen Daten.
### 2. Berichtigung / Korrektur
Recht auf Korrektur ungenauer oder unvollständiger personenbezogener Daten unter bestimmten Umständen.
### 3. Löschung / Tilgung
Recht auf Löschung personenbezogener Daten über Sie.
### 4. Recht auf Widerspruch gegen "Weitergabe" für kontextübergreifende verhaltensbezogene Werbung oder gezielte Werbung
Recht auf Widerspruch gegen die "Weitergabe" Ihrer personenbezogenen Daten für kontextübergreifende verhaltensbezogene Werbung oder gezielte Werbung (wie im Abschnitt "Dritte, die personenbezogene Daten erhalten können" weiter beschrieben).
Sie können Ihre Kontoinformationen auch in Ihren In-App-Einstellungen aktualisieren. Um Ihr Konto zu deaktivieren oder zu löschen, senden Sie eine E-Mail an support@adaptivemachines.ai. Möglicherweise stehen Ihnen zusätzliche Rechte zur Verfügung. Die Anfrage kann per E-Mail an support@adaptivemachines.ai eingereicht werden. Bitte lesen Sie zusätzlich unsere [allgemeine Datenschutzrichtlinie](/de/legal/policies) für weitere Informationen.
## Aufbewahrung
Wir bewahren personenbezogene Daten so lange auf, wie wir einen laufenden geschäftlichen Bedarf dafür haben (z. B. um die Runner AI Dienste bereitzustellen, um geltende rechtliche, steuerliche oder buchhalterische Anforderungen zu erfüllen, zur Sicherheit und Betrugserkennung oder -prävention oder im Zusammenhang mit Backup- oder Notfallwiederherstellungsprozessen), es sei denn, eine andere Aufbewahrungsfrist ist gesetzlich zulässig oder erforderlich.
Die Kriterien zur Bestimmung unserer Aufbewahrungsfristen umfassen Folgendes:
1. Die Dauer, während der wir eine laufende Beziehung mit Ihnen haben und Ihnen Runner AI Dienste bereitstellen (z. B. solange Sie ein Konto bei uns haben oder unsere Dienste weiterhin nutzen);
2. Ob Sie Ihre Informationen über Ihre Konten ändern oder löschen;
3. Ob Runner AI eine rechtliche Verpflichtung hat, die Daten aufzubewahren (z. B. verlangen bestimmte Gesetze von Runner AI, Aufzeichnungen über Ihre Transaktionen für einen bestimmten Zeitraum aufzubewahren); oder
4. Ob die Aufbewahrung im Hinblick auf unsere Rechtsposition ratsam ist (z. B. in Bezug auf die Durchsetzung unserer Vereinbarungen, die Beilegung von Streitigkeiten, die geltenden Verjährungsfristen, Rechtsstreitigkeiten oder behördliche Untersuchungen).
## Wie Sie uns kontaktieren
Wenn Sie Ihre Rechte ausüben möchten oder Fragen oder Bedenken zu dieser Datenschutzrichtlinie haben, können Sie uns über support@adaptivemachines.ai kontaktieren.
## Änderungen dieser Datenschutzrichtlinie
Wir können diese Datenschutzrichtlinie regelmäßig aktualisieren, um Änderungen in unserer Erfassung und/oder Verarbeitung personenbezogener Daten zu berücksichtigen, und wir werden die aktualisierte Datenschutzrichtlinie auf unserer Website veröffentlichen, mit einem Datum "Zuletzt aktualisiert" oben.
---
# Datenschutzrichtlinie für Händler
Source: https://www.runnerai.com/docs/de/legal/policies/merchants
## Inhaltsverzeichnis
1. [Einleitung](#einleitung)
2. [Welche Informationen wir über Sie erfassen und warum](#welche-informationen-wir-über-sie-erfassen-und-warum)
3. [Wann und warum wir Ihre Informationen mit anderen teilen](#wann-und-warum-wir-ihre-informationen-mit-anderen-teilen)
4. [Google Ads and Google Merchant Center integrations](#google-ads-and-google-merchant-center-integrations)
5. [Ihre Rechte bezüglich Ihrer Informationen](#ihre-rechte-bezüglich-ihrer-informationen)
6. [Wie lange wir Ihre Informationen aufbewahren](#wie-lange-wir-ihre-informationen-aufbewahren)
7. [Ihre Kundeninformationen](#ihre-kundeninformationen)
## Einleitung
Wenn Sie ein Händler sind, der Runner AI zur Unterstützung Ihres Geschäfts nutzt, erfassen und verwenden wir Ihre personenbezogenen Daten, um Ihnen Zugang zu unserer Plattform und ihren Diensten zu gewähren und Ihnen allgemein zu helfen, Ihr Geschäft und Ihre Beziehungen zu Kunden besser zu verwalten.
Wenn wir personenbezogene Daten Ihrer Kunden ("Endnutzer") verarbeiten, tun wir dies als Auftragsverarbeiter in Ihrem Auftrag, unserem Händler. Sie, der Händler, sind der Datenverantwortliche für die Informationen Ihrer Endnutzer. Dies bedeutet, dass Sie für die Einhaltung der geltenden Datenschutzgesetze verantwortlich sind, einschließlich der Bereitstellung Ihrer eigenen Datenschutzrichtlinie und der Einholung aller erforderlichen Einwilligungen von Ihren Endnutzern.
Bitte lesen Sie zusätzlich unsere [allgemeine Datenschutzrichtlinie](/de/legal/policies), die für alle gilt, deren Informationen wir verarbeiten.
## Welche Informationen wir über Sie erfassen und warum
Wir erfassen personenbezogene Daten, wenn Sie sich für Runner AI anmelden, wenn Sie unsere Plattform nutzen oder wenn Sie uns anderweitig Informationen zur Verfügung stellen. Wir können auch Drittanbieter-Dienstleister einsetzen, um uns bei der Überprüfung von Konten auf Betrug oder andere Probleme zu helfen. Im Allgemeinen benötigen wir Informationen über Sie, um Ihnen die Nutzung unserer Plattform zu ermöglichen. Wir verarbeiten Ihre personenbezogenen Daten, um unseren Vertrag mit Ihnen zu erfüllen, oder weil die Aufrechterhaltung unserer Geschäftsbeziehung, die Verhinderung von Risiken und Betrug, die Bereitstellung effizienter Dienste, die Verbesserung unserer Produkte und Dienste sowie die Beantwortung Ihrer Serviceanfragen unseren berechtigten Interessen entsprechen. In einigen Fällen verarbeiten wir Ihre personenbezogenen Daten nur mit Ihrer Einwilligung.
| Was wir erfassen | Wie wir es verwenden |
|------------------|----------------------|
| Informationen, die Sie uns über sich und Ihr Unternehmen zur Verfügung stellen, wie z. B. Ihren Namen, die Namen Ihrer Mitarbeiter oder anderer Personen, die mit Ihrem Unternehmen verbunden sind, Firmennamen, Adresse, E-Mail-Adresse und Telefonnummer. | Um Ihnen die Nutzung unserer Plattform und anderer damit verbundener Dienste zu ermöglichen (z. B. um Ihre Identität zu bestätigen, um Sie über Probleme mit der Plattform zu kontaktieren, um Ihnen Rechnungen zu stellen) Um Produkte oder Funktionen zu bewerben und zu vermarkten Um rechtliche Anforderungen zu erfüllen Um betrügerische Nutzung unserer Dienste zu verhindern |
| Zahlungsinformationen, die Sie uns zur Verfügung stellen, wie z. B. Ihre Kredit- oder Debitkartennummer oder Ihre Bankkontonummer. | Um Ihnen die Nutzung unserer Plattform und anderer damit verbundener Dienste zu ermöglichen Um Gebühren für unsere Dienste zu erheben |
| Informationen darüber, wie Sie auf Runner AI Websites, Ihr Konto und unsere Plattform zugreifen, einschließlich Informationen über das von Ihnen verwendete Gerät und den Browser, Ihre Netzwerkverbindung, Ihre IP-Adresse und Details darüber, wie Sie durch unsere Websites und Plattform navigieren. Wir erfassen einige dieser Informationen durch die Verwendung von "Cookies" oder anderen ähnlichen Technologien direkt von Ihrem Gerät. Weitere Informationen über die Verwendung dieser Technologien finden Sie in unserer Cookie-Richtlinie. | Um Ihnen die Nutzung unserer Plattform und anderer damit verbundener Dienste zu ermöglichen und diese zu verbessern (z. B. Identifizierung von Möglichkeiten, unsere Plattform einfacher zu nutzen oder zu navigieren) Um Produkte oder Funktionen zu bewerben und zu vermarkten Um betrügerische Nutzung unserer Dienste zu verhindern |
| Kopien von staatlich ausgestellten Ausweisen und/oder ein Foto von Ihnen mit Ihrem Ausweis, das Sie uns zur Verfügung stellen | Wenn wir Ihre Identität überprüfen müssen (z. B. um Sie vor Identitätsdiebstahl oder Betrug zu schützen) Um zu überprüfen, dass wir mit Ihnen sprechen, wenn Sie uns kontaktieren Um uns bei der Feststellung oder Überprüfung des Kontoinhabers zu helfen Um rechtliche Anforderungen zu erfüllen |
| Google account, Google Ads, and Google Merchant Center information you authorize Runner AI to access, such as Google sign-in profile information, OAuth tokens and granted scopes, accessible Google Ads customer accounts, account names, manager-account status, selected account bindings, campaign and creative data, performance metrics, change history, and Merchant Center account identifiers and names. | To sign you in, connect and refresh your Google integrations, list selectable ad and Merchant Center accounts, show ads dashboards and reports, generate requested AI ads analysis or campaign drafts, publish or update campaigns you approve, sync account access, troubleshoot issues, and secure the integration. |
Wir arbeiten auch mit Unternehmen zusammen, die uns Informationen über Händler oder potenzielle Händler zur Verfügung stellen (z. B. zum Schutz vor Betrug oder wenn wir eine Veranstaltung sponsern).
## Wann und warum wir Ihre Informationen mit anderen teilen
Die Führung eines Unternehmens ist schwierig, und wir arbeiten mit mehreren Unternehmen zusammen, um Ihnen eine Reihe von Diensten zur Unterstützung Ihres Unternehmens bereitzustellen. Wir teilen manchmal Ihre personenbezogenen Daten mit diesen Unternehmen, um Ihnen Runner AI Dienste bereitzustellen.
Wir teilen Ihre personenbezogenen Daten auch mit anderen:
- Um vermuteten Betrug, Bedrohungen der körperlichen Sicherheit, illegale Aktivitäten oder Verstöße gegen Verträge oder unsere anderen Website-Vereinbarungen zu verhindern oder zu untersuchen.
- Um uns bei Marketing und Werbung zu helfen.
- Um rechtliche Anforderungen zu erfüllen oder auf Gerichtsbeschlüsse oder ähnliche behördliche Anfragen zu reagieren.
- Bei Vermögensverkäufen oder -käufen, Aktienverkäufen, -käufen oder Fusionen, Insolvenz oder anderen Geschäftstransaktionen oder Umstrukturierungen werden wir Ihre personenbezogenen Daten mit potenziellen Käufern, Verkäufern, neuen Eigentümern oder anderen relevanten Dritten nach Bedarf während Verhandlungen oder im Zusammenhang mit einem Kontrollwechsel des Unternehmens (wie einer Umstrukturierung, Fusion oder dem Verkauf unserer Vermögenswerte) teilen.
Darüber hinaus nutzt fast jeder Händler, der die Runner AI Plattform verwendet, auch Nicht-Runner-AI-Dienste zur Unterstützung seines Geschäfts (Vertriebskanäle, Zahlungs-Gateways oder Versandanbieter).
Runner AI hat keine Kontrolle darüber, wie diese Dienste Ihre personenbezogenen Daten verwenden, und Sie sollten alle anderen Dienste, die Sie nutzen, überprüfen, um sicherzustellen, dass sie Ihren Datenschutzerwartungen entsprechen.
## Google Ads and Google Merchant Center integrations
If you connect Google Ads or Google Merchant Center to Runner AI, we use the Google user data you authorize only to provide the connected ads features you request. We share, transfer, or disclose that Google user data only with:
- Google LLC, to exchange OAuth codes and tokens, call Google Ads and Merchant Center APIs, read the data you authorized, and perform the Google Ads or Merchant Center actions you request.
- Authorized users in your Runner AI organization, according to their workspace permissions.
- Service providers and subprocessors that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- Legal, safety, and business-transfer recipients when required by law or as described in our overall Privacy Policy.
We do not sell Google user data, and we do not share it with third-party advertising platforms, data brokers, or information resellers except as described above or with your explicit direction. For more detail, see [Google user data and Google integrations](/de/legal/policies#google-user-data-and-google-integrations) in our overall Privacy Policy.
## Ihre Rechte bezüglich Ihrer Informationen
Sie können direkt über Ihren Runner AI Admin auf einen Großteil Ihrer personenbezogenen Daten zugreifen und diese korrigieren. Für Informationen, auf die Sie nicht direkt in Ihrem Runner AI Admin zugreifen oder die Sie dort nicht korrigieren können, reichen Sie bitte eine Betroffenenanfrage über support@adaptivemachines.ai ein. Weitere Informationen finden Sie in unserer [allgemeinen Datenschutzrichtlinie](/de/legal/policies). Bitte beachten Sie, dass bestimmte Betroffenenrechte nur unter bestimmten Umständen gelten und alle diese Rechte gesetzlich eingeschränkt sein können.
## Wie lange wir Ihre Informationen aufbewahren
Da wir Ihre personenbezogenen Daten benötigen, um Runner AI Dienste bereitzustellen, bewahren wir Ihre personenbezogenen Daten im Allgemeinen auf, solange Sie Runner AI Produkte oder Dienste nutzen. Wenn Sie Ihren Shop schließen, die Zahlung von Abonnementgebühren einstellen oder wir Ihr Konto kündigen, bewahren wir Shop-Informationen zwei Jahre lang auf, bevor wir mit dem Löschen oder Anonymisieren personenbezogener Daten beginnen. Dies geschieht nicht sofort, wenn Sie Ihr Konto reaktivieren oder wenn es rechtliche Beschwerden oder Prüfungen im Zusammenhang mit Ihrem Unternehmen gibt. Wenn Sie uns kontaktieren, um die Löschung der Informationen Ihres Shops zu beantragen, beginnen wir nach 90 Tagen mit dem Prozess des Löschens oder Anonymisierens personenbezogener Daten, es sei denn, wir sind gesetzlich verpflichtet, bestimmte Informationen aufzubewahren. Wenn Sie Fragen zu diesem Prozess haben, kontaktieren Sie bitte unser Support-Team unter support@adaptivemachines.ai. Bitte bedenken Sie, dass wir nach der Anonymisierung Ihrer personenbezogenen Daten weiterhin nicht identifizierende Informationen zur Verbesserung unserer Dienste verwenden können.
## Ihre Kundeninformationen
Um Ihr Geschäft zu unterstützen, erfassen und verwenden wir personenbezogene Daten über Ihre Kunden. Typischerweise erfassen und verwenden wir diese personenbezogenen Daten nach Ihren Anweisungen. Rechtlich gesehen sind wir ein "Auftragsverarbeiter" und "Dienstanbieter", wie diese Begriffe in bestimmten geltenden Datenschutzgesetzen verwendet werden, einschließlich derer in den Vereinigten Staaten, Kanada, Europa und dem Vereinigten Königreich.
Da Sie entscheiden, wie Sie die personenbezogenen Daten Ihrer Kunden verwenden, müssen Sie sicherstellen, dass Ihre Kunden verstehen, wie Sie (und wie wir in Ihrem Auftrag) ihre personenbezogenen Daten erfassen und verarbeiten. Dazu sollten Sie mindestens eine Datenschutzrichtlinie in Ihrem Shop veröffentlichen, die beschreibt, welche Informationen Sie erfassen, wie Sie sie verwenden und mit wem Sie sie teilen.
Wenn Sie "sensible" personenbezogene Daten von Kunden erfassen (z. B. Informationen über die Sozialversicherungsnummer, den Führerschein, den staatlichen Personalausweis oder die Reisepassnummer eines Verbrauchers; Kontoanmeldeinformationen, Finanzkontoinformationen, Debit- oder Kreditkartennummern und erforderliche Sicherheitscodes oder Passwörter; präzise Geolokalisierungsinformationen; Gesundheits- oder genetische Daten, rassische oder ethnische Herkunft, religiöse oder philosophische Überzeugungen oder Gewerkschaftszugehörigkeit; den Inhalt der Post, E-Mails oder Textnachrichten eines Verbrauchers; oder Daten zu Straftaten), sollten Sie die ausdrückliche Einwilligung des Kunden zur Verwendung und Verarbeitung dieser Informationen einholen.
---
# Datenschutzrichtlinie für Besucher
Source: https://www.runnerai.com/docs/de/legal/policies/visitors
## Inhaltsverzeichnis
1. [Einleitung](#einleitung)
2. [Welche Informationen wir über Sie erfassen und warum](#welche-informationen-wir-über-sie-erfassen-und-warum)
3. [Wann und warum wir Ihre Informationen mit anderen teilen](#wann-und-warum-wir-ihre-informationen-mit-anderen-teilen)
4. [Ihre Rechte bezüglich Ihrer Informationen](#ihre-rechte-bezüglich-ihrer-informationen)
## Einleitung
Wenn Sie eine Runner AI Website besuchen oder den Runner AI Kundensupport kontaktieren, verwenden wir Ihre personenbezogenen Daten typischerweise, um Ihnen den spezifischen Dienst bereitzustellen, den Sie nutzen. Bitte lesen Sie zusätzlich unsere [übergreifende Datenschutzrichtlinie](/de/legal/policies), die für alle gilt, deren Informationen wir verarbeiten.
## Welche Informationen wir über Sie erfassen und warum
Wenn Sie unsere Websites besuchen oder den Runner AI Support kontaktieren, erfassen wir die folgenden personenbezogenen Daten über Sie. Wir verarbeiten Ihre personenbezogenen Daten, um unsere vertraglichen Verpflichtungen Ihnen gegenüber zu erfüllen, um unsere Geschäftsbeziehung aufrechtzuerhalten, Risiken und Betrug zu verhindern, effiziente Dienste bereitzustellen, unsere Produkte und Dienste zu verbessern und auf Ihre Anfragen gemäß unseren berechtigten Interessen zu reagieren. In einigen Fällen verarbeiten wir Ihre personenbezogenen Daten nur mit Ihrer Einwilligung.
| Was wir erfassen | Wie wir es verwenden |
|------------------|----------------------|
| Informationen über Sie, die Sie uns über sich selbst zur Verfügung stellen, wie z. B. Ihren Namen, Ihre Adresse, E-Mail-Adresse und Telefonnummer. | Um Ihnen die Nutzung und Verbesserung der App oder des Dienstes zu ermöglichen, den Sie verwenden möchten (z. B. um Ihre Identität zu bestätigen, um Sie über Probleme mit der Plattform zu kontaktieren, um Ihnen Rechnungen zu stellen) Um zu überprüfen, dass wir mit Ihnen sprechen Um Produkte oder Funktionen zu bewerben und zu vermarkten Um rechtliche Anforderungen zu erfüllen |
| Zahlungsinformationen, die Sie uns zur Verfügung stellen, wie z. B. Ihre Zahlungskartennummer oder Bankkontonummer. | Um Ihnen die Möglichkeit zur Zahlung zu geben |
| Informationen darüber, wie Sie auf Runner AI Websites und andere Dienste zugreifen und diese nutzen, einschließlich Informationen über das von Ihnen verwendete Gerät und den Browser, Ihre Netzwerkverbindung, Ihre IP-Adresse und Details darüber, wie Sie durch unsere Websites navigieren, einschließlich Suchbegriffen, die Sie möglicherweise eingeben. Wir erfassen einige dieser Informationen durch die Verwendung von "Cookies" oder anderen ähnlichen Technologien direkt von Ihrem Gerät. Weitere Informationen über die Verwendung dieser Technologien finden Sie in unserer Cookie-Richtlinie. | Um Ihnen die Nutzung unserer Websites und zugehöriger Dienste zu ermöglichen und diese zu verbessern (z. B. Identifizierung von Möglichkeiten, unsere Plattform einfacher zu nutzen oder zu navigieren) Um Ihr Erlebnis bei der Nutzung unserer Websites zu personalisieren (z. B. durch Änderung des Layouts unserer Webseiten) Um Produkte oder Funktionen zu bewerben und zu vermarkten |
## Wann und warum wir Ihre Informationen mit anderen teilen
Wir teilen Ihre personenbezogenen Daten mit Unternehmen, die uns bei der Bereitstellung von Diensten für Sie helfen. Wir können Ihre Informationen auch weitergeben:
- Um Betrug, Bedrohungen der Sicherheit, illegale Aktivitäten oder Verstöße gegen Verträge (z. B. unsere Nutzungsbedingungen) zu verhindern oder zu untersuchen.
- Zur Unterstützung von Marketing- und Werbemaßnahmen.
- Um rechtlichen Verpflichtungen nachzukommen oder auf Gerichtsbeschlüsse, behördliche Anfragen zu reagieren.
- Bei Geschäftstransaktionen (z. B. Fusionen, Übernahmen, Vermögensverkäufen, Insolvenz) teilen wir Daten mit potenziellen Käufern, Verkäufern oder relevanten Dritten, die an Verhandlungen oder Umstrukturierungen beteiligt sind.
## Ihre Rechte bezüglich Ihrer Informationen
Bitte reichen Sie eine Betroffenenanfrage über support@adaptivemachines.ai ein, wenn Sie auf Ihre personenbezogenen Daten zugreifen oder die Löschung Ihrer personenbezogenen Daten beantragen möchten. Bitte beachten Sie, dass wir nach der Anonymisierung Ihrer Informationen weiterhin nicht identifizierbare Informationen zur Verbesserung unserer Dienste verwenden werden. Bitte beachten Sie, dass einige Betroffenenrechte nur unter bestimmten Umständen gelten und alle diese Rechte gesetzlich eingeschränkt sein können.
---
# Liste der Auftragsverarbeiter
Source: https://www.runnerai.com/docs/de/legal/subprocessors
## Liste der Auftragsverarbeiter
Zur Unterstützung der Bereitstellung unserer Dienste nutzt Adaptive Machines, Inc. ("Runner AI", "wir" oder "uns") Drittanbieter-Dienstleister als Auftragsverarbeiter zur Verarbeitung personenbezogener Daten. Verbundene Unternehmen von Runner AI und Drittanbieter-Auftragsverarbeiter helfen Runner AI bei der Verarbeitung personenbezogener Daten für Händler gemäß unserem [Datenverarbeitungsvertrag](/de/legal/dpa).
Die von Runner AI für die Erbringung der Dienste gemäß den Bedingungen verwendeten Auftragsverarbeiter sind unten aufgeführt.
## Drittanbieter-Auftragsverarbeiter
| Auftragsverarbeiter | Bereitgestellter Dienst | Hauptsitz | Daten, die verarbeitet werden können |
|---------------------|-------------------------|-----------|--------------------------------------|
| Vercel Inc. | Hosting- und Bereitstellungsdienste | USA | Plattformdaten, die für das Hosten und Bereitstellen der Anwendung erforderlich sind |
| Google LLC | Cloud-Hosting und Datenverarbeitung | USA | Alle Plattformdaten |
| Google DeepMind | Konversationelle künstliche Intelligenzdienste | USA | Personenbezogene Daten, wenn in der Runner AI Chatbox eingegeben |
| OpenRouter, Inc. | Konversationelle künstliche Intelligenzdienste | USA | Personenbezogene Daten, wenn in der Runner AI Chatbox eingegeben |
| Klaviyo, Inc. | E-Mail-Übertragung | USA | Personenbezogene Daten, soweit zur Bereitstellung von Runner AI E-Mail erforderlich |
---
# Nutzungsbedingungen
Source: https://www.runnerai.com/docs/de/legal/tos
## Nutzungsbedingungen
### Inhaltsverzeichnis
1. [Kontobedingungen](#1-kontobedingungen)
2. [Kontoaktivierung](#2-kontoaktivierung)
3. [Rechte von Runner AI](#3-rechte-von-runner-ai)
4. [Ihre Verantwortlichkeiten](#4-ihre-verantwortlichkeiten)
5. [Zahlung von Gebühren und Steuern](#5-zahlung-von-gebühren-und-steuern)
6. [Vertraulichkeit](#6-vertraulichkeit)
7. [Haftungsbeschränkung und Schadloshaltung](#7-haftungsbeschränkung-und-schadloshaltung)
8. [Geistiges Eigentum und Ihre Materialien](#8-geistiges-eigentum-und-ihre-materialien)
9. [Zusätzliche Dienste](#9-zusätzliche-dienste)
10. [Feedback und Bewertungen](#10-feedback-und-bewertungen)
11. [DMCA-Mitteilung und Entfernungsverfahren](#11-dmca-mitteilung-und-entfernungsverfahren)
12. [Datenschutz und Datensicherheit](#12-datenschutz-und-datensicherheit)
13. [Runner AI Vertragspartei](#13-runner-ai-vertragspartei)
14. [Laufzeit und Kündigung](#14-laufzeit-und-kündigung)
15. [Änderungen](#15-änderungen)
16. [Allgemeine Bedingungen](#16-allgemeine-bedingungen)
**Zuletzt aktualisiert am: 15. Oktober 2025**
Willkommen bei Runner AI! Durch die Registrierung für ein Runner AI-Konto (wie in Abschnitt 1 definiert) oder durch die Nutzung von Runner AI-Diensten (wie unten definiert) erklären Sie sich damit einverstanden, an die folgenden Allgemeinen Geschäftsbedingungen (die "Nutzungsbedingungen") gebunden zu sein.
Wie in diesen Nutzungsbedingungen verwendet, beziehen sich "Unternehmen", "wir", "uns" und "unser" auf Adaptive Machines, Inc. (wie in Abschnitt 13 definiert). "Sie" bedeutet der Runner AI-Benutzer (bei Registrierung oder Nutzung eines Runner AI-Dienstes als Einzelperson) oder das Unternehmen, das den Runner AI-Benutzer beschäftigt (bei Registrierung oder Nutzung eines Runner AI-Dienstes als Unternehmen), und alle seine verbundenen Unternehmen.
Runner AI bietet eine vollständige Commerce-Plattform, die es Händlern ermöglicht, ihre Handelsaktivitäten zu vereinheitlichen. Diese Plattform umfasst unter anderem eine Reihe von Tools für Händler zum Erstellen und Anpassen von Online-Shops, zum Verkauf an mehreren Orten (einschließlich Web, Mobilgeräte, soziale Medien, Online-Marktplätze und andere Online-Standorte ("Online-Dienste"), zur Verwaltung von Produkten, Bestand, Zahlungen, Auftragsabwicklung, Versand, Geschäftsabläufen, Marketing und Werbung sowie zur Interaktion mit bestehenden und potenziellen Kunden. Jeder solche Dienst oder Dienste, die von Runner AI angeboten werden, werden in diesen Nutzungsbedingungen als "Dienst(e)" bezeichnet. Alle neuen Funktionen oder Tools, die zu den aktuellen Diensten hinzugefügt werden, unterliegen ebenfalls den Nutzungsbedingungen. Sie können die aktuelle Version der Nutzungsbedingungen jederzeit unter https://www.runnerai.com/docs/de/legal/tos einsehen.
Sie müssen alle Bedingungen und Konditionen, die in diesen Nutzungsbedingungen enthalten sind oder ausdrücklich darauf verwiesen wird, einschließlich der [Richtlinie zur akzeptablen Nutzung](/de/legal/aup) ("AUP") von Runner AI, der [Datenschutzrichtlinie](/de/legal/policies) und des [Datenverarbeitungsvertrags](/de/legal/dpa) ("DPA"), lesen, ihnen zustimmen und sie akzeptieren, bevor Sie sich für ein Runner AI-Konto registrieren oder einen Runner AI-Dienst nutzen dürfen.
Bitte lesen Sie die Nutzungsbedingungen, einschließlich aller in diesen Nutzungsbedingungen genannten Dokumente, um ein vollständiges Bild Ihrer rechtlichen Anforderungen zu erhalten. Durch die Nutzung von Runner AI oder eines Runner AI-Dienstes stimmen Sie diesen Bedingungen zu. Schauen Sie gelegentlich auf Aktualisierungen nach.
## 1. Kontobedingungen
### Was das bedeutet
Sie sind verantwortlich für Ihr Konto, die Materialien, die Sie in den Runner AI-Dienst hochladen, und den Betrieb Ihres Runner AI-Shops. Wenn Sie gegen die Nutzungsbedingungen von Runner AI verstoßen, können wir Ihren Dienstzugang kündigen. Wenn wir Sie erreichen müssen, kommunizieren wir über die primäre E-Mail-Adresse.
(1) Um auf die Dienste zuzugreifen und sie zu nutzen, müssen Sie sich für ein Runner AI-Konto registrieren ("Konto"). Um Ihre Kontoregistrierung abzuschließen, müssen Sie uns Ihren vollständigen rechtlichen Namen, Ihre Geschäftsadresse, Telefonnummer, eine gültige E-Mail-Adresse und alle anderen als erforderlich angegebenen Informationen zur Verfügung stellen. Runner AI kann Ihren Antrag auf ein Konto ablehnen oder ein bestehendes Konto aus beliebigem Grund nach unserem alleinigen Ermessen kündigen.
(2) Sie müssen mindestens: (i) 18 Jahre alt sein oder (ii) mindestens das Volljährigkeitsalter in der Gerichtsbarkeit erreicht haben, in der Sie ansässig sind und von der aus Sie die Dienste nutzen, um ein Konto zu eröffnen.
(3) Sie bestätigen, dass Sie alle von Runner AI bereitgestellten Dienste zum Zwecke der Ausübung einer geschäftlichen Tätigkeit und nicht für persönliche, häusliche oder familiäre Zwecke erhalten.
(4) Sie nehmen zur Kenntnis, dass Runner AI die E-Mail-Adresse, die Sie bei der Kontoeröffnung angeben oder die Sie von Zeit zu Zeit aktualisieren, als primäre Kommunikationsmethode mit Ihnen verwenden wird ("Primäre E-Mail-Adresse"). Sie müssen die primäre E-Mail-Adresse, die Sie Runner AI zur Verfügung stellen, überwachen, und Ihre primäre E-Mail-Adresse muss in der Lage sein, sowohl Nachrichten zu senden als auch zu empfangen. Ihre E-Mail-Kommunikation mit Runner AI kann nur authentifiziert werden, wenn sie von Ihrer primären E-Mail-Adresse stammt.
(5) Sie sind dafür verantwortlich, Ihr Passwort sicher zu verwahren. Runner AI kann und wird nicht für Verluste oder Schäden haftbar gemacht werden, die daraus resultieren, dass Sie die Sicherheit Ihres Kontos und Passworts nicht aufrechterhalten. Wir können jederzeit zusätzliche Sicherheitsmaßnahmen anfordern und behalten uns das Recht vor, diese Anforderungen nach unserem Ermessen anzupassen.
(6) Technischer Support in Bezug auf die Dienste wird nur Runner AI-Benutzern zur Verfügung gestellt. Fragen zu den Nutzungsbedingungen sollten an den Runner AI-Support gesendet werden.
(7) Sie verpflichten sich, keinen Teil des Dienstes, die Nutzung der Dienste oder den Zugang zu den Diensten ohne die ausdrückliche schriftliche Genehmigung von Runner AI zu reproduzieren, zu duplizieren, zu kopieren, zu verkaufen, weiterzuverkaufen oder auszunutzen.
(8) Sie verpflichten sich, keine der technischen Einschränkungen der Dienste zu umgehen, zu umgehen oder zu umgehen, kein Werkzeug zu verwenden, um Funktionen oder Funktionalitäten zu aktivieren, die in den Diensten ansonsten deaktiviert sind, oder die Dienste zu dekompilieren, zu demontieren oder anderweitig zurückzuentwickeln.
(9) Sie verpflichten sich, nicht auf die Dienste zuzugreifen oder Materialien oder Informationen von den Diensten mit einem Roboter, Spider, Scraper oder anderen automatisierten Mitteln zu überwachen.
(10) Sie verstehen, dass Ihre Materialien möglicherweise unverschlüsselt übertragen werden und (a) Übertragungen über verschiedene Netzwerke und (b) Änderungen zur Anpassung an technische Anforderungen von Verbindungsnetzwerken oder Geräten beinhalten. "Materialien" bedeutet Ihre Marken, urheberrechtlich geschützte Inhalte, alle Produkte oder Dienstleistungen, die Sie über die Dienste verkaufen (einschließlich Beschreibung und Preis), sowie alle Fotos, Bilder, Videos, Grafiken, schriftliche Inhalte, Audiodateien, Code, Informationen oder andere Daten, die von Ihnen oder Ihren verbundenen Unternehmen für Runner AI oder seine verbundenen Unternehmen bereitgestellt oder zur Verfügung gestellt werden.
## 2. Kontoaktivierung
### Was das bedeutet
Nur eine Person kann "Store-Inhaber" sein, normalerweise die Person, die sich für den Runner AI-Dienst anmeldet. Der Store-Inhaber ist für das Konto verantwortlich, ist an diese Nutzungsbedingungen gebunden und ist für die Handlungen anderer Personen verantwortlich, die auf das Konto zugreifen. Wenn Sie sich im Namen Ihres Arbeitgebers anmelden, ist Ihr Arbeitgeber der Store-Inhaber, der für Ihr Konto verantwortlich ist.
### 2.1 Store-Inhaber
(1) Vorbehaltlich von Abschnitt 2.1.2 ist die Person, die sich für den Dienst durch Eröffnung eines Kontos anmeldet, die Vertragspartei ("Store-Inhaber") für die Zwecke unserer Nutzungsbedingungen und die Person, die berechtigt ist, jedes entsprechende Konto zu verwenden, das wir dem Store-Inhaber im Zusammenhang mit dem Dienst zur Verfügung stellen können. Sie sind dafür verantwortlich sicherzustellen, dass der Name des Store-Inhabers (einschließlich des rechtlichen Namens des Unternehmens, das den Store besitzt, falls zutreffend) auf der Website des Stores deutlich sichtbar ist.
(2) Wenn Sie sich im Namen Ihres Arbeitgebers für die Dienste anmelden, ist Ihr Arbeitgeber der Store-Inhaber. Wenn Sie sich im Namen Ihres Arbeitgebers für die Dienste anmelden, müssen Sie eine von Ihrem Arbeitgeber ausgestellte E-Mail-Adresse verwenden, und Sie erklären und gewährleisten, dass Sie die Befugnis haben, Ihren Arbeitgeber an unsere Nutzungsbedingungen zu binden.
(3) Ihr Runner AI-Store kann nur einem Store-Inhaber zugeordnet sein. Ein Store-Inhaber kann mehrere Runner AI-Stores haben. "Store" bedeutet den Online-Shop (ob von Runner AI gehostet oder auf einer Website eines Drittanbieters) oder physische(n) Einzelhandelsstandort(e), die mit dem Konto verbunden sind.
### 2.2 Mitarbeiterkonten
(1) Basierend auf Ihrem Runner AI-Preisplan können Sie ein oder mehrere Mitarbeiterkonten ("Mitarbeiterkonten") erstellen, die es anderen Personen ermöglichen, auf das Konto zuzugreifen. Jedes Mitarbeiterkonto muss einen vollständigen rechtlichen Namen und ein gültiges E-Mail-Konto enthalten. Mit Mitarbeiterkonten kann der Store-Inhaber Berechtigungen festlegen und andere Personen in ihrem Konto arbeiten lassen, während der Zugriff von Mitarbeiterkonten auf bestimmte Geschäftsinformationen bestimmt wird (Sie können beispielsweise den Zugriff von Mitarbeiterkonten auf Verkaufsinformationen auf der Berichtsseite beschränken oder verhindern, dass Mitarbeiterkonten allgemeine Store-Einstellungen ändern).
(2) Der Store-Inhaber ist verantwortlich für: (a) die Sicherstellung, dass seine Mitarbeiter, Vertreter und Subunternehmer, einschließlich über Mitarbeiterkonten, diese Nutzungsbedingungen einhalten; und (b) jeden Verstoß gegen diese Nutzungsbedingungen durch die Mitarbeiter, Vertreter oder Subunternehmer des Store-Inhabers. Der Store-Inhaber erkennt an und stimmt zu, dass der Store-Inhaber für die Erfüllung aller seiner Verpflichtungen gemäß der Vereinbarung verantwortlich ist, unabhängig davon, ob er solche Verpflichtungen an Dritte unterlizenziert oder untervergibt, einschließlich, aber nicht beschränkt auf verbundene Unternehmen oder Tochtergesellschaften des Store-Inhabers.
(3) Der Store-Inhaber und die Benutzer unter Mitarbeiterkonten werden jeweils als "Runner AI-Benutzer" bezeichnet.
### 2.3 Zahlungsanbieter von Drittanbietern
Unsere Dienste integrieren sich mit verschiedenen Zahlungsanbietern von Drittanbietern, damit Sie Zahlungen für Ihre Transaktionen verarbeiten können. Ihre Beziehung zu solchen Zahlungsanbietern unterliegt deren jeweiligen Geschäftsbedingungen. Sie sind allein verantwortlich für die Erstellung und Pflege Ihrer Konten bei diesen Anbietern und für alle Aktivitäten im Zusammenhang mit Ihrer Zahlungsabwicklung.
## 3. Rechte von Runner AI
### Was das bedeutet
Runner AI hat das Recht zu kontrollieren, wem wir unsere Dienste zur Verfügung stellen, und wir können sie jederzeit ändern. Wir haben auch das Recht, Materialien von jedem Teil der Dienste, einschließlich Ihres Stores, abzulehnen oder zu entfernen. Wir können unsere Dienste Ihren Konkurrenten anbieten, werden aber niemals Ihre vertraulichen Informationen mit ihnen teilen. Im Falle eines Eigentumsstreits über ein Runner AI-Konto können wir ein Runner AI-Konto einfrieren oder es an den rechtmäßigen Eigentümer übertragen, wie von uns festgelegt.
(1) Die Dienste verfügen über eine Reihe von Funktionen und Funktionalitäten. Nicht alle Dienste oder Funktionen stehen allen Händlern jederzeit zur Verfügung, und wir sind nicht verpflichtet, Dienste oder Funktionen in einer Gerichtsbarkeit zur Verfügung zu stellen. Sofern nicht in diesen Nutzungsbedingungen oder durch geltendes Recht verboten, behalten wir uns das Recht vor, die Dienste oder einen Teil davon aus beliebigem Grund zu ändern.
(2) Runner AI prüft Materialien nicht im Voraus, und es liegt in unserem alleinigen Ermessen, Materialien von jedem Teil der Dienste abzulehnen oder zu entfernen, auch wenn wir nach unserem alleinigen Ermessen feststellen, dass die Waren oder Dienstleistungen, die Sie über die Dienste anbieten, oder die auf die Dienste hochgeladenen oder veröffentlichten Materialien gegen diese Nutzungsbedingungen verstoßen.
(3) Verbaler oder schriftlicher Missbrauch jeglicher Art (einschließlich Drohungen von Missbrauch oder Vergeltung) gegenüber einem Runner AI-Mitarbeiter, Mitglied oder Beauftragten führt zur sofortigen Kontokündigung.
(4) Wir behalten uns das Recht vor, unsere Dienste Ihren Konkurrenten anzubieten, und versprechen keine Exklusivität. Sie erkennen ferner an und stimmen zu, dass Runner AI-Mitarbeiter und Auftragnehmer auch Runner AI-Kunden oder Händler sein können und dass sie mit Ihnen konkurrieren können, obwohl sie Ihre vertraulichen Informationen (wie in Abschnitt 6 definiert) dabei nicht verwenden dürfen.
(5) Im Falle eines Streits über die Kontoinhaberschaft behalten wir uns das Recht vor, Unterlagen anzufordern, um die Kontoinhaberschaft zu bestimmen oder zu bestätigen. Die Dokumentation kann unter anderem eine gescannte Kopie Ihrer Geschäftslizenz, einen von der Regierung ausgestellten Lichtbildausweis, die letzten vier Ziffern der hinterlegten Kreditkarte oder die Bestätigung Ihres Status als Mitarbeiter einer Einrichtung umfassen.
(6) Runner AI behält sich das Recht vor, nach unserem alleinigen Ermessen die rechtmäßige Kontoinhaberschaft zu bestimmen und ein Konto an den rechtmäßigen Store-Inhaber zu übertragen. Wenn wir den rechtmäßigen Store-Inhaber nicht vernünftigerweise bestimmen können, behält sich Runner AI unbeschadet unserer anderen Rechte und Rechtsmittel das Recht vor, ein Konto vorübergehend auszusetzen oder zu deaktivieren, bis eine Lösung zwischen den streitenden Parteien gefunden wurde.
## 4. Ihre Verantwortlichkeiten
### Was das bedeutet
Sie sind verantwortlich für Ihren Runner AI-Store, die Waren oder Dienstleistungen, die Sie verkaufen, und Ihre Beziehung zu Ihren Kunden, nicht wir.
(1) Sie erkennen an und stimmen zu, öffentlich zugängliche Kontaktinformationen, eine Rückerstattungsrichtlinie und Zeitpläne für die Auftragsabwicklung in Ihrem Runner AI-Store bereitzustellen.
(2) Sie erkennen an und stimmen zu, dass die Dienste kein Marktplatz sind und dass jeder Kaufvertrag, der über die Dienste abgeschlossen wird, direkt zwischen Ihnen und dem Kunden besteht. Sie sind der Verkäufer aller Artikel, die Sie über die Dienste verkaufen. Sie sind verantwortlich für die Erstellung und den Betrieb Ihres Runner AI-Stores, Ihre Materialien, die Waren und Dienstleistungen, die Sie über die Dienste verkaufen können, und alle Aspekte der Transaktionen zwischen Ihnen und Ihren Kunden. Dies umfasst unter anderem die Autorisierung der Belastung des Kunden in Bezug auf den Kauf des Kunden, Rückerstattungen, Rücksendungen, die Erfüllung von Verkäufen oder Kundendienst, betrügerische Transaktionen, erforderliche rechtliche Offenlegungen, die Einhaltung von Vorschriften, angebliche oder tatsächliche Verletzung geltender Gesetze (einschließlich, aber nicht beschränkt auf Verbraucherschutzgesetze in jeder Gerichtsbarkeit, in der Sie Produkte oder Dienstleistungen zum Verkauf anbieten) oder Ihren Verstoß gegen diese Nutzungsbedingungen. Sie erklären und gewährleisten, dass Ihr Store, Ihre Materialien und die Waren und Dienstleistungen, die Sie über die Dienste verkaufen, wahrheitsgemäß, genau und vollständig sind und keine geltenden Gesetze, Vorschriften oder Rechte Dritter verletzen. Zur Vermeidung von Zweifeln wird Runner AI nicht der Verkäufer oder Händler sein und keine Verantwortung für Ihren Store oder Artikel übernehmen, die über die Dienste an Kunden verkauft werden.
(3) Sie sind allein verantwortlich für die Waren oder Dienstleistungen, die Sie über die Dienste verkaufen können (einschließlich Beschreibung, Preis, Gebühren, Steuern, die Sie berechnen, Mängel, erforderliche rechtliche Offenlegungen, Einhaltung von Vorschriften, Angebote oder Werbeinhalte), einschließlich der Einhaltung aller geltenden Gesetze oder Vorschriften.
(4) Sie dürfen die Runner AI-Dienste nicht für illegale oder unbefugte Zwecke verwenden, noch dürfen Sie bei der Nutzung des Dienstes gegen Gesetze in Ihrer Gerichtsbarkeit (einschließlich, aber nicht beschränkt auf Urheberrechtsgesetze), die für Sie in der Gerichtsbarkeit Ihres Kunden geltenden Gesetze oder die Gesetze des Staates Delaware verstoßen. Sie werden alle geltenden Gesetze, Regeln und Vorschriften (einschließlich, aber nicht beschränkt auf die Erlangung und Einhaltung der Anforderungen jeder Lizenz oder Genehmigung, die für den Betrieb Ihres Stores erforderlich sein kann oder die von Ihnen gehalten werden kann) bei Ihrer Nutzung des Dienstes und Ihrer Erfüllung von Verpflichtungen gemäß den Nutzungsbedingungen einhalten.
## 5. Zahlung von Gebühren und Steuern
### Was das bedeutet
Eine gültige Zahlungsmethode (z. B. eine Kreditkarte) muss hinterlegt sein, um alle Dienstgebühren zu bezahlen, einschließlich der Abonnement-, Transaktions- und zusätzlichen Gebühren, die für alle Stores erforderlich sind. Sie werden alle 30 Tage für Ihre Abonnementgebühren in Rechnung gestellt. Alle Transaktionsgebühren oder zusätzlichen Gebühren werden Ihrer Zahlungsmethode belastet. Wenn wir die Zahlung von Gebühren mit Ihrer Zahlungsmethode nicht verarbeiten können, können wir nachfolgende Versuche unternehmen, die Zahlung von Gebühren mit Ihrer Zahlungsmethode zu verarbeiten. Wenn die Zahlung von Gebühren innerhalb von 30 Tagen nach unserem ersten Versuch, die Zahlung zu verarbeiten, erfolglos ist, kann Runner AI Ihren Store einfrieren. Sie sind verantwortlich für alle Steuern im Zusammenhang mit Ihrem Store oder der Nutzung der Dienste. Sie müssen möglicherweise Steuern an Runner AI abführen oder selbst an Ihre lokale Steuerbehörde abführen. Keine Rückerstattungen.
(1) Sie zahlen die für Ihr Abonnement des Online-Dienstes geltenden Gebühren ("Abonnementgebühren") und alle anderen anfallenden Gebühren, einschließlich, aber nicht beschränkt auf anfallende Gebühren im Zusammenhang mit dem Wert der über Ihren Store getätigten Verkäufe, wenn Sie einen Zahlungsanbieter eines Drittanbieters zur Verarbeitung von Kundenzahlungen verwenden ("Transaktionsgebühren"), und alle Gebühren im Zusammenhang mit Ihrem Kauf oder Ihrer Nutzung von Produkten oder Dienstleistungen wie Versand, Credit Boost Pack oder Drittanbieterdiensten ("Zusätzliche Gebühren"). Zusammen werden die Abonnementgebühren, Transaktionsgebühren und die zusätzlichen Gebühren als "Gebühren" bezeichnet.
(2) Sie müssen eine gültige Zahlungsmethode bei uns hinterlegen, um alle anfallenden und wiederkehrenden Gebühren zu bezahlen. Runner AI wird anfallende Gebühren jeder gültigen Zahlungsmethode belasten, die Sie autorisieren ("Autorisierte Zahlungsmethode"), und Runner AI wird die autorisierte Zahlungsmethode weiterhin für anfallende Gebühren belasten, bis die Dienste beendet werden und alle ausstehenden Gebühren vollständig bezahlt wurden. Sofern nicht anders angegeben, sind alle Gebühren und anderen Belastungen in US-Dollar, und alle Zahlungen erfolgen in US-Währung.
(3) Abonnementgebühren werden im Voraus bezahlt und alle 30 Tage in Rechnung gestellt (jeweils ein "Abrechnungsdatum"). Transaktionsgebühren und zusätzliche Gebühren werden von Zeit zu Zeit nach Ermessen von Runner AI berechnet. Sie werden an jedem Abrechnungsdatum für alle ausstehenden Gebühren belastet, die zuvor nicht berechnet wurden. Die Gebühren erscheinen auf einer Rechnung, die per E-Mail über die angegebene primäre E-Mail-Adresse an den Store-Inhaber gesendet wird. Außerdem wird eine Rechnung auf der Kontoseite der Verwaltungskonsole Ihres Stores angezeigt. Benutzer haben ungefähr zwei Wochen Zeit, um Probleme mit der Abrechnung von Abonnementgebühren anzusprechen und zu klären.
(4) Wenn wir die Zahlung von Gebühren nicht mit einer autorisierten Zahlungsmethode verarbeiten können, können wir nachfolgende Versuche unternehmen, die Zahlung mit einer autorisierten Zahlungsmethode zu verarbeiten. Wenn wir die Zahlung von Gebühren nicht erfolgreich mit einer autorisierten Zahlungsmethode innerhalb von 30 Tagen nach unserem ersten Versuch verarbeiten können, können wir den Zugang zu Ihrem Konto und den Diensten aussetzen und widerrufen. Ihr Konto wird nach Ihrer Zahlung aller ausstehenden Gebühren zuzüglich der für Ihren nächsten Abrechnungszyklus anfallenden Gebühren reaktiviert. Möglicherweise können Sie während einer Aussetzung nicht auf Ihr Konto oder Ihre Storefront zugreifen.
(5) Alle Gebühren verstehen sich exklusive anwendbarer Bundes-, Landes-, lokaler oder anderer staatlicher Umsatz-, Waren- und Dienstleistungs-, harmonisierter oder anderer Steuern, Gebühren oder Abgaben, die jetzt in Kraft sind oder in Zukunft erlassen werden ("Steuern").
(6) Sie sind verantwortlich für alle anwendbaren Steuern, die sich aus oder als Folge Ihres Abonnements oder Kaufs von Produkten und Dienstleistungen von Runner AI ergeben. Soweit Runner AI diese Steuern berechnet, werden sie unter Verwendung der Steuersätze berechnet, die basierend auf der von Ihnen angegebenen Rechnungsadresse gelten. Solche Beträge kommen zu den Gebühren für solche Produkte und Dienstleistungen hinzu und werden Ihrer autorisierten Zahlungsmethode in Rechnung gestellt. Wenn Sie von der Zahlung solcher Steuern befreit sind, müssen Sie uns Nachweise Ihrer Befreiung vorlegen, die in einigen Gerichtsbarkeiten ein Originalzertifikat umfassen, das die geltenden gesetzlichen Anforderungen erfüllt und den steuerbefreiten Status bescheinigt. Die Steuerbefreiung gilt nur ab dem Datum, an dem wir zufriedenstellende Nachweise Ihrer Befreiung von Runner AI erhalten. Wenn Ihnen von Runner AI keine Steuern in Rechnung gestellt werden, sind Sie dafür verantwortlich zu bestimmen, ob Steuern zu zahlen sind, und wenn ja, die Steuern selbst an die zuständigen Steuerbehörden in Ihrer Gerichtsbarkeit abzuführen.
(7) Zur Vermeidung von Zweifeln werden alle von Ihnen an Runner AI gemäß diesen Nutzungsbedingungen zu zahlenden Beträge frei und ohne Abzüge oder Einbehaltungen gezahlt. Abgesehen von Steuern, die Runner AI Ihnen in Rechnung stellt und in Ihrem Namen an die zuständigen Steuerbehörden abführt, werden alle gesetzlich vorgeschriebenen Abzüge oder Einbehaltungen von Ihnen getragen und separat an die zuständige Steuerbehörde gezahlt. Runner AI ist berechtigt, den vollen Betrag der in diesen Nutzungsbedingungen festgelegten Gebühren Ihrer autorisierten Zahlungsmethode zu belasten, ohne Rücksicht auf Abzüge oder Einbehaltungen, die möglicherweise erforderlich sind.
(8) Sie sind allein verantwortlich für die Bestimmung, Erhebung, Einbehaltung, Meldung und Abführung anwendbarer Steuern, Zölle, Gebühren, Zuschläge und zusätzlicher Gebühren, die sich aus oder als Folge eines Verkaufs in Ihrem Runner AI-Store oder Ihrer Nutzung der Dienste ergeben. Die Dienste sind kein Marktplatz. Jeder Kaufvertrag, der über die Dienste abgeschlossen wird, besteht direkt zwischen Ihnen und dem Kunden.
(9) Sie müssen einen genauen Standort in der Verwaltungskonsole Ihres Runner AI-Stores pflegen. Wenn Sie die Gerichtsbarkeit wechseln, müssen Sie Ihren Standort in der Verwaltungskonsole umgehend aktualisieren.
(10) Runner AI bietet keine Rückerstattungen an.
## 6. Vertraulichkeit
### Was das bedeutet
Sowohl Sie als auch Runner AI verpflichten sich, die vertraulichen Informationen des anderen nur zur Erfüllung der Verpflichtungen in diesen Nutzungsbedingungen zu verwenden. Vertrauliche Informationen müssen geschützt und respektiert werden.
(1) "Vertrauliche Informationen" umfassen unter anderem alle Informationen, die mit dem Geschäft einer Partei verbunden sind und nicht öffentlich bekannt sind, einschließlich spezifischer Geschäftsinformationen, technischer Prozesse und Formeln, Software, Kundenlisten, potenzielle Kundenlisten, Namen, Adressen und andere Informationen über Kunden und potenzielle Kunden, Produktdesigns, Verkäufe, Kosten (einschließlich relevanter Bearbeitungsgebühren), Preislisten und andere unveröffentlichte Finanzinformationen, Geschäftspläne und Marketingdaten sowie alle anderen vertraulichen und geschützten Informationen, unabhängig davon, ob sie als vertraulich oder geschützt gekennzeichnet sind oder nicht. Die vertraulichen Informationen von Runner AI umfassen alle Informationen, die Sie über uns oder über die Dienste erhalten, die der breiten Öffentlichkeit nicht bekannt sind, einschließlich Informationen über unser Sicherheitsprogramm und unsere Praktiken.
(2) Jede Partei verpflichtet sich, die vertraulichen Informationen der anderen Partei nur wie notwendig zur Erfüllung ihrer Verpflichtungen gemäß diesen Nutzungsbedingungen und in Übereinstimmung mit allen anderen Verpflichtungen in diesen Nutzungsbedingungen, einschließlich dieses Abschnitts 6, zu verwenden. Jede Partei verpflichtet sich, alle angemessenen Schritte zu unternehmen, die mindestens im Wesentlichen den Schritten entsprechen, die sie zum Schutz ihrer eigenen geschützten Informationen unternimmt, um die Vervielfältigung, Offenlegung oder Verwendung solcher vertraulichen Informationen zu verhindern, außer (i) durch oder an ihre Mitarbeiter, Vertreter und Subunternehmer, die Zugang zu solchen vertraulichen Informationen haben müssen, um die Verpflichtungen dieser Partei hierin zu erfüllen, die jeweils solche vertraulichen Informationen wie hierin vorgesehen behandeln und die jeweils Vertraulichkeitsverpflichtungen gegenüber dieser Partei unterliegen, die mindestens so streng sind wie die hierin enthaltenen; oder (ii) wie von einem Gesetz, einer Vorschrift oder einem Beschluss eines Gerichts mit ordnungsgemäßer Zuständigkeit über die Parteien und den in diesen Nutzungsbedingungen enthaltenen Gegenstand verlangt, vorausgesetzt, dass die empfangende Partei der offenlegenden Partei, sofern gesetzlich zulässig, unverzüglich schriftlich Mitteilung macht und wirtschaftlich angemessene Anstrengungen unternimmt, um sicherzustellen, dass solche Offenlegungen vertraulich behandelt werden. Vertrauliche Informationen umfassen keine Informationen, die die empfangende Partei nachweisen kann: (A) bereits öffentlich zugänglich waren oder der empfangenden Partei zum Zeitpunkt der Offenlegung solcher Informationen bereits bekannt waren oder sich in ihrem Besitz befanden; (B) von der empfangenden Partei unabhängig entwickelt wurden, ohne die vertraulichen Informationen der anderen Partei zu verwenden oder darauf Bezug zu nehmen, und ohne gegen Bestimmungen dieser Nutzungsbedingungen zu verstoßen; oder (C) danach rechtmäßig von der empfangenden Partei von einer anderen Quelle als der offenlegenden Partei erhalten wurden, ohne gegen eine Bestimmung dieser Nutzungsbedingungen zu verstoßen.
## 7. Haftungsbeschränkung und Schadloshaltung
### Was das bedeutet
Wir sind nicht verantwortlich für Schäden oder Klagen, die entstehen, wenn Sie gegen das Gesetz verstoßen, diese Vereinbarung verletzen oder gegen die Rechte Dritter verstoßen. Der Dienst wird auf "wie besehen" und "wie verfügbar" Basis bereitgestellt. Wir geben keine Garantien ab, und unsere Haftung ist im Falle von Fehlern oder Unterbrechungen begrenzt.
(1) Sie verstehen und stimmen ausdrücklich zu, dass Runner AI und seine Lieferanten im gesetzlich zulässigen Umfang nicht für direkte, indirekte, zufällige, besondere, Folge- oder exemplarische Schäden haftbar sind, einschließlich, aber nicht beschränkt auf Schäden für Gewinnverluste, Geschäftswert, Nutzung, Daten oder andere immaterielle Verluste, die sich aus oder im Zusammenhang mit der Nutzung oder Unfähigkeit zur Nutzung des Dienstes oder dieser Nutzungsbedingungen ergeben (unabhängig davon, wie sie entstehen, einschließlich Fahrlässigkeit).
IM GESETZLICH MAXIMAL ZULÄSSIGEN UMFANG IST UNSERE HAFTUNG IHNEN GEGENÜBER FÜR SCHÄDEN, DIE SICH AUS ODER IM ZUSAMMENHANG MIT DIESEN BEDINGUNGEN ERGEBEN (AUS WELCHEM GRUND AUCH IMMER UND UNABHÄNGIG VON DER FORM DER KLAGE), JEDERZEIT AUF DEN BETRAG DER GEBÜHREN BESCHRÄNKT, DIE SIE UNS IN DEN VORANGEGANGENEN SECHS (6) MONATEN GEZAHLT HABEN (ODER, FALLS KEINE GEBÜHREN GEZAHLT WURDEN, AUF MAXIMAL FÜNFZIG US-DOLLAR ($50)). DAS VORHANDENSEIN VON MEHR ALS EINEM ANSPRUCH ERWEITERT DIESE GRENZE NICHT.
(2) Sie verpflichten sich, uns und (soweit zutreffend) unsere Muttergesellschaft, Tochtergesellschaften, verbundenen Unternehmen, Runner AI-Partner, leitenden Angestellten, Direktoren, Vertreter, Mitarbeiter und Lieferanten von allen Ansprüchen oder Forderungen, einschließlich angemessener Anwaltsgebühren, die von Dritten aufgrund von oder aufgrund von (a) Ihrem Verstoß gegen diese Nutzungsbedingungen oder die darin durch Verweis enthaltenen Dokumente (einschließlich der AUP) geltend gemacht werden, schadlos zu halten; (b) oder Ihrer Verletzung eines Gesetzes oder der Rechte Dritter; oder (c) eines Aspekts der Transaktion zwischen Ihnen und Ihrem Kunden, einschließlich, aber nicht beschränkt auf Rückerstattungen, betrügerische Transaktionen, angebliche oder tatsächliche Verletzung anwendbarer Gesetze (einschließlich, aber nicht beschränkt auf Bundes- und Landesverbraucherschutzgesetze) oder Ihren Verstoß gegen die Nutzungsbedingungen.
(3) Sie sind für jeden Verstoß gegen die Nutzungsbedingungen durch Ihre verbundenen Unternehmen, Vertreter oder Subunternehmer verantwortlich und haften, als wäre es Ihr eigener Verstoß.
(4) Ihre Nutzung der Dienste erfolgt auf Ihr alleiniges Risiko. Die Dienste werden auf "wie besehen" und "wie verfügbar" Basis ohne jegliche ausdrückliche, stillschweigende oder gesetzliche Garantie oder Bedingung bereitgestellt.
(5) Runner AI garantiert nicht, dass die Dienste ununterbrochen, rechtzeitig, sicher oder fehlerfrei sein werden.
(6) Runner AI garantiert nicht, dass die Ergebnisse, die aus der Nutzung der Dienste erzielt werden können, genau oder zuverlässig sind.
Insbesondere erkennen Sie an, dass die Dienste künstliche Intelligenz und maschinelle Lernalgorithmen verwenden, um Funktionen wie automatisierte Vorgänge und Wachstumsvorschläge bereitzustellen. Sie verstehen, dass dies probabilistische Systeme sind, und Runner AI gibt keine Garantie hinsichtlich der Rentabilität, des Erfolgs oder spezifischer Ergebnisse von Maßnahmen, die auf den Ausgaben oder Vorschlägen dieser KI-Systeme basieren.
(7) Runner AI ist nicht verantwortlich für Ihre Steuerpflichten oder Verbindlichkeiten im Zusammenhang mit der Nutzung der Dienste von Runner AI.
(8) Runner AI garantiert nicht, dass die Qualität von Produkten, Dienstleistungen, Informationen oder anderen Materialien, die von Ihnen über die Dienste gekauft oder erworben wurden, Ihren Erwartungen entspricht oder dass Fehler in den Diensten korrigiert werden.
(9) In keinem Fall haftet Runner AI für Umsatzeinbußen, Datenverluste oder den Verlust von Kundenvertrauen, die sich aus der Nutzung von Experimente oder der Durchführung von KI-generierten Experimenten ergeben.
## 8. Geistiges Eigentum und Ihre Materialien
### Was das bedeutet
Alles, was Sie hochladen, bleibt Ihres (wenn es Ihres war) und liegt in Ihrer Verantwortung, aber Runner AI kann die hochgeladenen Dinge nutzen und veröffentlichen. Alles, was auf Runner AI hochgeladen wird, bleibt Eigentum und Verantwortung seines ursprünglichen Eigentümers. Runner AI erhält jedoch eine Lizenz für über unsere Plattform veröffentlichte Materialien, die wir zum Betrieb und zur Werbung für unsere Dienste verwenden können.
### 8.1 Ihre Materialien
(1) Wir beanspruchen kein Eigentum an den Materialien, die Sie Runner AI zur Verfügung stellen; wir benötigen jedoch eine Lizenz für diese Materialien. Sie gewähren dem Unternehmen ein nicht ausschließliches, übertragbares, unterlizenzierbares, lizenzgebührenfreies, weltweites Recht und eine Lizenz zum Hosten, Verwenden, Verteilen, Offenlegen, Ändern, Ausführen, Kopieren, Speichern, öffentlichen Aufführen, öffentlichen Mitteilen (einschließlich durch Telekommunikation), Übertragen, Reproduzieren, Verfügbarmachen, Anzeigen und Übersetzen sowie zum Erstellen abgeleiteter Werke von allen Materialien, die Sie im Zusammenhang mit den Diensten bereitstellen. Wir können unsere Rechte aus dieser Lizenz nutzen, um die Dienste zu betreiben, bereitzustellen und zu bewerben sowie unsere Verpflichtungen zu erfüllen und unsere Rechte gemäß den Nutzungsbedingungen auszuüben. Sie erklären, gewährleisten und stimmen zu, dass Sie alle erforderlichen Rechte an den Materialien haben, um diese Lizenz zu gewähren. Sie verzichten unwiderruflich auf alle Urheberpersönlichkeitsrechte, die Sie möglicherweise an den Materialien haben, zugunsten von Runner AI und stimmen zu, dass auf diesen Verzicht von jedem verwiesen werden kann, der Rechte an den Materialien über Runner AI erhält, einschließlich Personen, an die Runner AI Rechte an den Materialien übertragen oder gewähren kann (einschließlich durch Lizenz oder Unterlizenz).
(2) Wenn Sie die Materialien besaßen, bevor Sie sie Runner AI zur Verfügung stellten, bleiben sie trotz des Hochladens in Ihren Runner AI-Store Ihres, vorbehaltlich aller in den Nutzungsbedingungen oder anderswo gewährten Rechte oder Lizenzen. Sie können Ihren Runner AI-Store jederzeit durch Löschen Ihres Kontos entfernen. Das Entfernen Ihres Runner AI-Stores beendet keine Rechte oder Lizenzen, die Runner AI an den Materialien gewährt wurden und die Runner AI benötigt, um Rechte auszuüben oder Verpflichtungen zu erfüllen, die während der Laufzeit entstanden sind.
(3) Sie stimmen zu, dass Runner AI jederzeit alle oder einen Teil der an die Dienste übermittelten Materialien überprüfen und löschen kann, obwohl Runner AI nicht dazu verpflichtet ist.
(4) Sie gewähren Runner AI ein nicht ausschließliches, übertragbares, unterlizenzierbares, lizenzgebührenfreies, weltweites Recht und eine Lizenz zur Verwendung der Namen, Marken, Dienstleistungsmarken und Logos, die mit Ihrem Store verbunden sind ("Ihre Marken"), um die Dienste zu betreiben, bereitzustellen und zu bewerben sowie unsere Verpflichtungen zu erfüllen und unsere Rechte gemäß den Nutzungsbedingungen auszuüben. Diese Lizenz überlebt jede Beendigung der Nutzungsbedingungen nur insoweit, als Runner AI die Lizenz benötigt, um Rechte auszuüben oder Verpflichtungen zu erfüllen, die während der Laufzeit entstanden sind.
### 8.2 Geistiges Eigentum von Runner AI
(1) Sie stimmen zu, dass Sie keine Marken, Logos oder Dienstleistungsmarken von Runner AI verwenden dürfen, ob eingetragen oder nicht eingetragen, einschließlich, aber nicht beschränkt auf die Wortmarke Runner AI und die grafische Marke Runner AI ("Runner AI-Marken"), es sei denn, Sie sind von Runner AI schriftlich dazu autorisiert. Sie verpflichten sich, keine Marken zu verwenden oder anzunehmen, die mit den Runner AI-Marken verwechselt werden könnten. Sie stimmen zu, dass alle Variationen oder Rechtschreibfehler der Runner AI-Marken als mit den Runner AI-Marken verwechselbar angesehen würden.
(2) Sie verpflichten sich, keine Suchmaschinen- oder andere Pay-per-Click-Schlüsselwörter (wie Google Ads), Marken, E-Mail-Adressen, Social-Media-Namen oder Domain-Namen (einschließlich, ohne Einschränkung, Top-Level-Domains, Subdomains und Seiten-URLs) zu kaufen, zu registrieren oder zu verwenden, die Runner AI oder Runner AI-Marken verwenden oder enthalten oder die Begriffe verwenden oder enthalten, die mit den Runner AI-Marken verwechselt werden könnten.
(3) Sie erkennen an und stimmen zu, dass Ihnen die Nutzungsbedingungen kein Recht zur Implementierung von Runner AI-Patenten geben.
### 8.3 Datennutzung zur KI-Verbesserung
Um unsere Dienste zu überwachen, zu verbessern und zu schützen und unsere Algorithmen und Modelle für künstliche Intelligenz zu optimieren, gewähren Sie uns ein unbefristetes, unwiderrufliches, weltweites, lizenzgebührenfreies Recht, Ihre "Materialien" und zugehörige Betriebsdaten in anonymisierter und aggregierter Form zu verwenden. Wir verpflichten uns, dass eine solche Verwendung keine bestimmte Einzelperson, keinen Händler oder deren Kunden identifiziert und ausschließlich zum Zweck der Verbesserung der allgemeinen Servicequalität und der technischen Fähigkeiten unserer Plattform verwendet wird.
## 9. Zusätzliche Dienste
### 9.1 Versandintegrationen von Drittanbietern
Unsere Dienste können mit verschiedenen Versandunternehmen und Diensten von Drittanbietern integriert werden, um Ihre Auftragsabwicklung zu verwalten. Ihre Nutzung solcher Drittanbieterdienste unterliegt deren jeweiligen Geschäftsbedingungen, und Sie sind allein verantwortlich für Ihre Beziehung zu ihnen.
### 9.2 Beta-Dienste
#### Was das bedeutet
Beta-Dienste können von Zeit zu Zeit angeboten werden. Sie sind nicht Teil der regulären Dienste und können Fehler aufweisen oder sich jederzeit ändern. Sie nutzen Beta-Dienste auf eigenes Risiko, und wir sind nicht verantwortlich für Verluste oder Schäden, die durch die Nutzung eines Beta-Dienstes entstehen können. Möglicherweise müssen Sie Ihre Teilnahme an den Beta-Diensten vertraulich behandeln.
Von Zeit zu Zeit kann Runner AI nach eigenem Ermessen Sie einladen, auf Versuchsbasis Vorabversions- oder Beta-Funktionen zu verwenden, die sich in der Entwicklung befinden und noch nicht allen Händlern zur Verfügung stehen ("Beta-Dienste"). Beta-Dienste sind nicht Teil der Dienste, und Beta-Dienste können zusätzlichen Bedingungen unterliegen, die Runner AI Ihnen vor Ihrer Nutzung der Beta-Dienste zur Verfügung stellt. Solche Beta-Dienste und alle damit verbundenen Gespräche und Materialien werden als vertrauliche Informationen von Runner AI betrachtet und unterliegen den Vertraulichkeitsbestimmungen in dieser Vereinbarung. Ohne die Allgemeingültigkeit des Vorstehenden einzuschränken, stimmen Sie zu, dass Sie ohne vorherige schriftliche Zustimmung von Runner AI keine öffentlichen Erklärungen abgeben oder Ihre Teilnahme an den Beta-Diensten anderweitig offenlegen werden. Runner AI gibt keine Zusicherungen oder Garantien ab, dass die Beta-Dienste funktionieren werden. Runner AI kann die Beta-Dienste jederzeit nach eigenem Ermessen einstellen. Runner AI haftet nicht für Schäden, die sich aus oder im Zusammenhang mit einem Beta-Dienst ergeben. Die Beta-Dienste funktionieren möglicherweise nicht wie eine endgültige Version. Runner AI kann nach eigenem Ermessen eine endgültige oder kommerzielle Version eines Beta-Dienstes ändern oder nicht veröffentlichen.
### 9.3 Runner AI Pixel Manager
#### Was das bedeutet
Der Runner AI Pixel Manager ermöglicht es Ihnen oder einem Dritten, Kundenereignisse zu verfolgen, indem Sie Pixel zu Ihrem Runner AI-Store hinzufügen. Wenn Sie den Runner AI Pixel Manager verwenden, sind Sie dafür verantwortlich, alle erforderlichen Einwilligungen von Store-Besuchern und Kunden einzuholen, deren Ereignisse Sie verfolgen.
Runner AI ermöglicht es Ihnen, Pixel zu Ihrem Runner AI-Store hinzuzufügen, damit Sie oder ein Dritter Kundenereignisse verfolgen können (der "Runner AI Pixel Manager"). Sie können Ihre Pixel über die Benutzeroberfläche in der Verwaltungskonsole Ihres Runner AI-Stores verwalten.
(1) Zusätzlich zu den Bedingungen, die für Ihre Nutzung der Dienste im Allgemeinen gelten (einschließlich dieser Nutzungsbedingungen, der Richtlinie zur akzeptablen Nutzung von Runner AI und der Datenschutzrichtlinie), gelten die folgenden Bedingungen für Ihren Zugriff auf und Ihre Nutzung des Runner AI Pixel Managers:
- a. Sie werden alle geltenden Gesetze einhalten und alle erforderlichen Einwilligungen von jedem Website-Besucher und Kunden einholen, dessen Ereignisse Sie verfolgen;
- b. Wenn Sie Runner AI Daten zur Verfügung stellen, die mit Pixeln gesammelt wurden, einschließlich Namen, E-Mail-Adressen, Telefonnummern oder anderen Daten, die eine Person persönlich identifizieren, erhalten Sie alle erforderlichen Rechte und Einwilligungen, bevor Sie Runner AI die vorstehenden Informationen zur Verfügung stellen;
- c. Sie stimmen zu, dass Runner AI alle Pixel deaktivieren kann, die Runner AI nach alleinigem Ermessen von Runner AI als bösartig identifiziert; und
- d. Sie werden nicht und werden Dritten nicht erlauben, Pixel zu verwenden:
- i. um sich an illegalen, rechtsverletzenden, diffamierenden oder anderweitig schädlichen Aktivitäten zu beteiligen oder diese zu fördern; oder
- ii. um einen Aspekt der Dienste zu deaktivieren, zu stören oder zu umgehen.
(2) Runner AI kann Informationen im Zusammenhang mit dem Runner AI Pixel Manager sammeln, z. B. wie Pixel verwendet werden und wie und welche Skripte hinzugefügt werden. Runner AI kann diese Daten verwenden, um den Runner AI Pixel Manager zu verbessern, zu warten, zu schützen und zu entwickeln.
### 9.4 Experimente (Beta) und automatisierte Experimente
#### Was das bedeutet
Experimente ist eine experimentelle Funktion, die KI verwendet, um verschiedene Versionen Ihres Shops zu testen. Durch die Aktivierung erlauben Sie uns, einigen Ihrer Besucher KI-generierte Variationen Ihres Shops anzuzeigen, einschließlich, aber nicht beschränkt auf Layouts, Preise und Versandregeln.
Nur der Administrator Ihres Shops kann diese Funktion aktivieren und entscheiden, wie viel Traffic getestet werden soll (standardmäßig beginnend bei 10%). Da dies eine Beta-Funktion ist, gibt es keine Garantie, dass sie Ihre Verkäufe steigert oder jedes Mal einwandfrei funktioniert. Sie nutzen sie auf eigenes Risiko.
(1) **Autorisierung für experimentellen Traffic**: Durch die aktive Aktivierung von Experimente innerhalb der Dienste autorisieren Sie Runner AI ausdrücklich, automatisierte Experimente in Ihrem Shop durchzuführen. Sie erkennen an und stimmen zu, dass:
- **Traffic-Zuweisung**: Nach der Aktivierung weist das System automatisch zehn Prozent (10%) oder das vereinbarte Traffic-Verhältnis des Web-Traffics Ihres Shops einer experimentellen Gruppe (der "Experimentgruppe") zu.
- **Benutzerkontrolle**: Sie behalten das Recht, diese Traffic-Zuweisung jederzeit über das administrative Dashboard manuell zu erhöhen, zu verringern oder zu deaktivieren.
- **Experimentelle Variationen**: Besucher in der Experimentgruppe können Variationen sehen, einschließlich, aber nicht beschränkt auf Shop-Layouts, Produktpreise, Versandkosten und andere Shop-Inhalte oder -Logik, die sich von Ihrer primären Shop-Version unterscheiden. Sie sind für die Einhaltung lokaler Gesetze bezüglich dynamischer Preisgestaltung und Verbraucheraufklärung verantwortlich.
(2) **Administrative Kontrolle**: Der Zugriff auf Experimente-Einstellungen ist auf Benutzer mit "Admin"-Berechtigungen beschränkt. Nur ein autorisierter Administrator hat die Befugnis:
- Die Experimente-Funktion zu aktivieren oder zu deaktivieren;
- Experimentelle Einstellungen anzupassen, einschließlich Traffic-Zuweisungsprozentsätze.
Runner AI haftet nicht für Einstellungen, die von Personen geändert werden, denen Sie administrativen Zugriff gewährt haben.
(3) **Beta-Haftungsausschluss und Haftungsbeschränkung**: Experimente wird als "Beta"-Funktion bereitgestellt und ist nicht Teil der Standard-Dienste. Ungeachtet gegenteiliger Bestimmungen in diesen Nutzungsbedingungen:
- **Weiterentwicklung des Dienstes**: Die Funktionalität, Leistung und UI-Layouts von Experimente können sich jederzeit ohne Vorankündigung ändern, ausgesetzt oder eingestellt werden.
- **Keine Ergebnisgarantie**: Runner AI macht keine Zusicherungen oder Garantien hinsichtlich des Ergebnisses von Experimenten. Wir garantieren keine spezifischen Konversionsraten, Umsatzsteigerungen, Suchmaschinen-Rankings oder andere Geschäftsergebnisse.
- **Risikoübernahme**: Sie erkennen an, dass experimentelle KI-generierte Inhalte Fehler enthalten können. Ihre Nutzung von Experimente erfolgt auf eigenes Risiko, und Runner AI ist nicht verantwortlich für negative Auswirkungen auf die Leistung Ihres Shops, einschließlich, aber nicht beschränkt auf Umsatzeinbußen, Preisfehler oder Kundenstreitigkeiten, die sich aus solchen Experimenten ergeben.
## 10. Feedback und Bewertungen
### Was das bedeutet
Wir begrüßen Kundenfeedback, sind aber nicht verpflichtet sicherzustellen, dass Ideen und Vorschläge zu unseren Diensten oder den Diensten Dritter vertraulich bleiben, und wir können das Feedback auf jede gewünschte Weise verwenden.
Runner AI begrüßt alle Ideen und/oder Vorschläge zur Verbesserung oder Erweiterung der Dienste. Unter keinen Umständen unterliegt eine Offenlegung von Ideen, Vorschlägen oder damit verbundenem Material oder eine Bewertung der Dienste, Drittanbieterdienste oder eines Drittanbieters (zusammen "Feedback") an Runner AI einer Vertraulichkeitsverpflichtung oder Erwartung einer Vergütung. Durch die Übermittlung von Feedback an Runner AI (ob direkt an Runner AI übermittelt oder in einem von Runner AI gehosteten Forum oder einer Seite veröffentlicht) verzichten Sie auf alle Rechte am Feedback, und Runner AI kann das Feedback, wie von Ihnen bereitgestellt oder von Runner AI geändert, nach Belieben implementieren und verwenden, ohne von Ihnen oder einem Dritten eine Genehmigung oder Lizenz zu erhalten. Alle Bewertungen eines Drittanbieterdienstes oder Drittanbieters, die Sie an Runner AI übermitteln, müssen nach bestem Wissen genau sein und dürfen nicht illegal, obszön, bedrohlich, diffamierend, in die Privatsphäre eingreifend, Rechte an geistigem Eigentum verletzend oder auf andere Weise für Dritte schädlich oder anstößig sein. Runner AI behält sich das Recht vor (aber nicht die Verpflichtung), Feedback von Drittanbieterdiensten oder Drittanbietern zu entfernen oder zu bearbeiten, überprüft jedoch veröffentlichtes Feedback nicht regelmäßig.
## 11. DMCA-Mitteilung und Entfernungsverfahren
### Was das bedeutet
Runner AI respektiert Rechte an geistigem Eigentum, und Sie sollten dies auch tun. Wenn wir eine DMCA-Mitteilung erhalten, können wir den Zugriff deaktivieren oder die angeblich rechtsverletzenden Inhalte aus Ihrem Store entfernen. Wenn Sie der Meinung sind, dass der Anspruch nicht gültig ist, können Sie eine Gegenmitteilung senden. Wenn Sie glauben, dass einer unserer Händler Ihre Rechte an geistigem Eigentum verletzt, können Sie Runner AI eine DMCA-Mitteilung senden. Wir werden den Zugriff umgehend deaktivieren oder den Inhalt entfernen und den Händler benachrichtigen.
Runner AI unterstützt den Schutz geistigen Eigentums und bittet Runner AI-Händler, dasselbe zu tun. Es ist unsere Richtlinie, auf alle Mitteilungen über angebliche Urheberrechtsverletzungen zu reagieren. Wenn jemand glaubt, dass einer unserer Händler ihre Rechte an geistigem Eigentum verletzt, kann er eine DMCA-Mitteilung an den designierten Vertreter von Runner AI unter support@adaptivemachines.ai senden. Nach Erhalt einer DMCA-Mitteilung können wir den Zugriff auf die Materialien, die als Urheberrechtsverletzung beansprucht werden, entfernen oder deaktivieren. Sobald eine Mitteilung zur Entfernung vorgelegt wurde, kann der Händler mit einer Gegenmitteilung per E-Mail antworten, wenn er der Beschwerde widerspricht. Der ursprüngliche Beschwerdeführer hat 14 Werktage nach Erhalt einer Gegenmitteilung Zeit, um eine gerichtliche Anordnung zu beantragen, die den Händler daran hindert, die rechtsverletzende Aktivität auszuüben, andernfalls stellen wir das Material wieder her.
## 12. Datenschutz und Datensicherheit
### Was das bedeutet
Die Nutzung und Erhebung personenbezogener Daten durch Runner AI unterliegt unserer Datenschutzrichtlinie. Die Nutzung und Erhebung personenbezogener Kundendaten durch Runner AI unterliegt außerdem unserem Datenverarbeitungsvertrag.
Runner AI setzt sich entschieden für den Schutz der Privatsphäre Ihrer personenbezogenen Daten und der personenbezogenen Daten Ihrer Kunden ein. Durch die Nutzung des Dienstes erkennen Sie an und stimmen zu, dass die Erhebung, Nutzung und Offenlegung dieser personenbezogenen Daten durch Runner AI unserer [Datenschutzrichtlinie](/de/legal/policies) unterliegt.
Soweit Runner AI personenbezogene Daten Ihrer Kunden als "Datenverarbeiter" oder "Dienstleister" gemäß bestimmten Datenschutz- oder Datenschutzgesetzen verarbeitet, einschließlich der EU- oder UK-Datenschutz-Grundverordnung und des California Consumer Privacy Act, unterliegt die Erhebung und Nutzung personenbezogener Daten durch Runner AI auch unserem [Datenverarbeitungsvertrag](/de/legal/dpa).
## 13. Runner AI Vertragspartei
"Vertragspartei" bedeutet Adaptive Machines, Inc., eine Gesellschaft nach dem Recht von Delaware, mit Hauptgeschäftssitz in 131 Continental Dr Suite 305 Newark, DE, 19713 US
Die Parteien unterwerfen sich unwiderruflich und bedingungslos der ausschließlichen Zuständigkeit der staatlichen und bundesstaatlichen Gerichte im Bundesstaat Delaware in Bezug auf Streitigkeiten oder Ansprüche, die sich aus oder im Zusammenhang mit den Nutzungsbedingungen ergeben. Das Übereinkommen der Vereinten Nationen über Verträge über den internationalen Warenkauf findet auf diese Nutzungsbedingungen keine Anwendung und ist hiermit ausdrücklich ausgeschlossen.
## 14. Laufzeit und Kündigung
### Was das bedeutet
Sie können Ihr Abonnement jederzeit in Ihren Kontoeinstellungen kündigen. Wir können Ihr Konto jederzeit kündigen. Für Stores mit einem kostenlosen Tarif behält sich Runner AI das Recht vor, den Store und alle zugehörigen Daten dauerhaft zu löschen, wenn der Store für einen Zeitraum von vierzehn (14) aufeinanderfolgenden Tagen inaktiv bleibt.
(1) Die Laufzeit dieser Nutzungsbedingungen beginnt am Datum Ihrer abgeschlossenen Registrierung für die Nutzung eines Dienstes und läuft weiter, bis sie von uns oder von Ihnen gekündigt wird, wie unten angegeben (die "Laufzeit").
(2) Sie können Ihr Konto kündigen und die Nutzungsbedingungen jederzeit beenden, indem Sie auf Ihre Kontoeinstellungen zugreifen.
(3) Unbeschadet anderer Rechtsbehelfe können wir Ihr Konto oder die Nutzungsbedingungen aus beliebigem Grund ohne Vorankündigung und jederzeit aussetzen oder kündigen (sofern gesetzlich nicht anders vorgeschrieben), auch wenn wir vermuten, dass Sie (durch Verurteilung, Vergleich, Versicherungs- oder Treuhanduntersuchung oder auf andere Weise) betrügerische Aktivitäten im Zusammenhang mit der Nutzung der Dienste unternommen haben. Die Beendigung der Nutzungsbedingungen erfolgt unbeschadet aller Rechte oder Verpflichtungen, die vor dem Datum der Beendigung entstanden sind.
(4) Bei Beendigung der Dienste durch eine der Parteien aus beliebigem Grund:
- Runner AI wird die Bereitstellung der Dienste für Sie einstellen, und Sie können nicht mehr auf Ihr Konto zugreifen;
- sofern in den Nutzungsbedingungen nicht anders vorgesehen, haben Sie keinen Anspruch auf Rückerstattung von Gebühren, anteilig oder auf andere Weise;
- alle ausstehenden Beträge, die Sie Runner AI zum wirksamen Datum der Kündigung für Ihre Nutzung der Dienste schulden, werden sofort in voller Höhe fällig und zahlbar; und
- Ihr Runner AI-Store wird offline genommen.
(5) Wenn am Datum der Beendigung des Dienstes ausstehende Gebühren von Ihnen geschuldet werden, erhalten Sie eine letzte Rechnung per E-Mail. Sobald diese Rechnung vollständig bezahlt wurde, werden Ihnen keine weiteren Gebühren berechnet.
(6) Inaktive kostenlose Konten: Für Stores mit einem kostenlosen Abonnementtarif (ausgenommen temporäre "kostenlose Testversionen" eines kostenpflichtigen Tarifs) behält sich Runner AI das Recht vor, den Store und alle zugehörigen Daten dauerhaft zu löschen, wenn der Store für einen Zeitraum von vierzehn (14) aufeinanderfolgenden Tagen inaktiv bleibt. Runner AI wird vor einer solchen Löschung eine Benachrichtigung an die primäre E-Mail-Adresse senden. Sie erkennen an, dass Runner AI für keinen Datenverlust haftet, der aus der Löschung eines inaktiven Stores gemäß diesem Abschnitt resultiert.
## 15. Änderungen
### Was das bedeutet
Wenn wir eine wesentliche Änderung an den Nutzungsbedingungen vornehmen, die sich nachteilig auf Ihre Rechte gemäß den Nutzungsbedingungen oder Ihre Nutzung unserer Dienste in wesentlicher Weise auswirkt, werden wir Sie im Voraus benachrichtigen (es sei denn, die Änderung bezieht sich auf gesetzliche Anforderungen oder die Verhinderung von Missbrauch unserer Dienste, unter anderem).
(1) Wir behalten uns das Recht vor, nach unserem alleinigen und absoluten Ermessen jederzeit jeden Teil der Nutzungsbedingungen zu aktualisieren oder zu ändern. Wir werden Ihnen eine angemessene Vorankündigung über Änderungen der Nutzungsbedingungen geben, die sich wesentlich nachteilig auf Ihre Nutzung der Dienste oder Ihre Rechte gemäß den Nutzungsbedingungen auswirken, indem wir eine E-Mail an die primäre E-Mail-Adresse senden, eine Mitteilung über die Verwaltungskonsole von Runner AI bereitstellen oder auf ähnliche Weise. Runner AI kann jedoch Änderungen vornehmen, die sich wesentlich nachteilig auf Ihre Nutzung der Dienste oder Ihre Rechte gemäß den Nutzungsbedingungen auswirken, jederzeit und mit sofortiger Wirkung (i) aus rechtlichen, regulatorischen, Betrugs- und Missbrauchspräventions- oder Sicherheitsgründen; oder (ii) um Produkte oder Aktivitäten einzuschränken, die wir als unsicher, unangemessen oder anstößig erachten. Sofern wir in unserer Mitteilung nichts anderes angeben (falls zutreffend), werden alle Änderungen an den Nutzungsbedingungen sofort nach Veröffentlichung der aktualisierten Bedingungen an diesem Ort wirksam. Ihr fortgesetzter Zugriff auf oder Ihre Nutzung der Dienste nach unserer Mitteilung, falls zutreffend, oder nach unserer Veröffentlichung der aktualisierten Bedingungen stellt Ihre Annahme der Änderungen und Ihre Zustimmung dar, an die geänderten Nutzungsbedingungen gebunden zu sein. Wenn Sie den geänderten Nutzungsbedingungen nicht zustimmen, müssen Sie den Zugriff auf und die Nutzung der Dienste einstellen.
(2) Runner AI kann die Gebühren für die Dienste von Zeit zu Zeit ändern. Wir werden Ihnen 30 Tage im Voraus über alle Änderungen der Gebühren informieren, indem wir eine E-Mail an das primäre E-Mail-Konto senden, eine Mitteilung über die Verwaltungskonsole von Runner AI bereitstellen oder auf ähnliche Weise. Runner AI haftet Ihnen oder Dritten gegenüber nicht für Änderungen, Preisänderungen, Aussetzungen oder Einstellungen der Dienste (oder eines Teils davon).
## 16. Allgemeine Bedingungen
(1) Die Nutzungsbedingungen, einschließlich der darin durch Verweis enthaltenen Dokumente, stellen die vollständige Vereinbarung zwischen Ihnen und Runner AI dar und regeln Ihre Nutzung der Dienste und Ihres Kontos und ersetzen alle früheren Vereinbarungen zwischen Ihnen und dem Unternehmen (einschließlich, aber nicht beschränkt auf frühere Versionen der Nutzungsbedingungen).
(2) Das Versäumnis von Runner AI, ein Recht oder eine Bestimmung der Nutzungsbedingungen auszuüben oder durchzusetzen, stellt keinen Verzicht auf ein solches Recht oder eine solche Bestimmung dar. Wenn eine Bestimmung der Nutzungsbedingungen, einschließlich aller darin durch Verweis enthaltenen Bedingungen und anderen Dokumente, von einem zuständigen Gericht für rechtswidrig befunden wird, wird diese Bestimmung so geändert und ausgelegt, dass die Ziele der ursprünglichen Bestimmung im gesetzlich maximal zulässigen Umfang am besten erreicht werden, und die übrigen Bestimmungen der Nutzungsbedingungen bleiben in vollem Umfang in Kraft und wirksam.
(3) Mit Ausnahme von Runner AI und seinen verbundenen Unternehmen, Ihnen oder jedem, der gemäß diesen Nutzungsbedingungen auf Runner AI-Dienste zugreift, hat keine Person oder Einrichtung, die nicht Partei dieser Nutzungsbedingungen ist, sofern in diesen Nutzungsbedingungen nicht anders vorgesehen, das Recht, eine Bestimmung dieser Nutzungsbedingungen durchzusetzen, unabhängig davon, ob diese Person oder Einrichtung namentlich, als Mitglied einer Klasse oder als einer bestimmten Beschreibung entsprechend identifiziert wurde. Zur Vermeidung von Zweifeln berührt dies nicht die Rechte eines zulässigen Abtretungsempfängers oder Übertragungsempfängers dieser Bedingungen.
(4) Diese Nutzungsbedingungen und alle Streitigkeiten oder Ansprüche, die sich aus oder im Zusammenhang mit ihnen ergeben, unterliegen den Gesetzen des Staates Delaware und werden in Übereinstimmung mit diesen ausgelegt, ohne Rücksicht auf dessen Grundsätze des Kollisionsrechts.
(5) Die Nutzungsbedingungen können in anderen Sprachen als Englisch verfügbar sein. Im Falle von Unstimmigkeiten oder Konflikten zwischen diesen englischen Nutzungsbedingungen und den in einer anderen Sprache verfügbaren Nutzungsbedingungen von Runner AI hat die aktuellste englische Version der Nutzungsbedingungen Vorrang. Alle Streitigkeiten, die sich aus diesen Nutzungsbedingungen ergeben, werden in englischer Sprache beigelegt, es sei denn, Runner AI bestimmt anderweitig (nach alleinigem Ermessen) oder es ist gesetzlich vorgeschrieben.
(6) Alle Bedingungen und Bestimmungen der Nutzungsbedingungen sind für die Parteien der Nutzungsbedingungen und ihre jeweiligen Erben, Rechtsnachfolger, zulässigen Abtretungsempfänger und gesetzlichen Vertreter bindend und kommen ihnen zugute. Das Unternehmen ist berechtigt, diese Nutzungsbedingungen ohne Mitteilung an Sie oder Zustimmung von Ihnen abzutreten. Sie haben kein Recht, die Nutzungsbedingungen oder Ihre Rechte oder Verpflichtungen hierunter an Dritte ohne vorherige schriftliche Zustimmung von Runner AI abzutreten oder anderweitig zu übertragen, die nach alleinigem Ermessen von Runner AI erteilt oder verweigert wird.
(7) Wenn eine Bestimmung oder ein Teil der Bestimmung in diesen Nutzungsbedingungen aus irgendeinem Grund für ungültig, rechtswidrig oder nicht durchsetzbar in irgendeiner Hinsicht befunden wird, berührt diese Ungültigkeit, Rechtswidrigkeit oder Nicht-Durchsetzbarkeit keine andere Bestimmung (oder den nicht betroffenen Teil der Bestimmung) der Nutzungsbedingungen, und die Nutzungsbedingungen werden so ausgelegt, als ob diese ungültige, rechtswidrige oder nicht durchsetzbare Bestimmung oder ein Teil der Bestimmung niemals in den Nutzungsbedingungen enthalten gewesen wäre.
(8) Bei Beendigung enden alle damit verbundenen Rechte und Verpflichtungen gemäß den Nutzungsbedingungen sofort, mit der Ausnahme, dass (a) Sie weiterhin für die Erfüllung aller Ihrer Verpflichtungen im Zusammenhang mit vor der Beendigung eingegangenen Transaktionen und für alle Verbindlichkeiten verantwortlich bleiben, die vor oder als Folge der Beendigung entstanden sind; und die Abschnitte 1 (Kontobedingungen), 5 (Zahlung von Gebühren), 6 (Vertraulichkeit), 7 (Haftungsbeschränkung und Schadloshaltung), 8.1 (Geistiges Eigentum und Ihre Materialien), 10 (Feedback und Bewertungen), 12 (Datenschutz und Datensicherheit), 13 (Runner AI Vertragspartei), 14 (Kündigung und Beendigung), 15 (Änderungen) und 16 (Allgemeine Bedingungen) die Beendigung oder das Ablaufen dieser Nutzungsbedingungen überleben.
---
Adaptive Machines, Inc.
131 Continental Dr Suite 305 Newark, DE, 19713 US
---
# Account and Settings
Source: https://www.runnerai.com/docs/en/guides/account-and-settings
Runner groups settings by who or what they affect: the workspace, the current store, or you. This keeps shared billing and members separate from store-specific domains and your personal profile.
## What this covers
You will know where each settings group lives and which pages require a role, plan, published store, or staged feature.
## Availability and prerequisites
- You must be signed in.
- Open **Settings** from the workspace or project menu.
- Store settings appear only when you open Settings from inside a project.
- Match the workspace or store name in the settings sidebar before editing. Personal controls appear under your account name.
- To end sessions on other devices or delete your account, contact Runner support. See [Security and sessions](/en/guides/account-and-settings/security-and-sessions).
- Some controls require workspace-owner or admin permission.
- Domain, API Key, and Experiments pages can be hidden or gated by plan, publication state, or staged availability.
## Open Settings
1. In the intended workspace or project, open its menu.
2. Select **Settings**.
3. Confirm the **Workspace: _workspace name_** selector, then choose a page under that group, **Store: _store name_**, or your account name. Opening Settings inside a store can start on Store General.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
Match the workspace and store headings before choosing a page. The account controls sit below these groups.
## Settings map
| Group and page | Why it is useful | What happens next |
| --- | --- | --- |
| Workspace → **General** | Rename or describe the workspace. | Valid changes save automatically. The danger zone also contains Delete Workspace. |
| Workspace → **Members** | Invite people and manage active or pending access. | Owners can invite, cancel invitations, or remove members; eligible members can leave. |
| Workspace → **Plan & Billing** | Review the current plan and available billing actions. | Plan cards, confirmation, checkout, billing management, and extra-credit options appear according to account state. |
| Workspace → **Usage & Credits** | Understand balance, sources, and spending. | One date-range control updates the summary, chart, category cards, and activity feed. |
| Store → **General** | Manage the current store's identity and search appearance. | Name, Page Title, Description, favicon, watermark, and Delete Store controls appear. |
| Store → **Domain** | Connect, buy, renew, or transfer a domain. | Availability depends on plan, publication, permission, and domain state. |
| Store → **Custom Scripts** | Add JavaScript to the storefront. | Changes remain unsaved until you select **Save Changes**. |
| Store → **Agent** | Choose Skills available in this project. | You can add or disable configurable Skills for this store. |
| Store → **Experiments** | Configure automated experiment goals and traffic. | This Beta page appears only when enabled and requires a published store. |
| Your account name → **My Settings** | Choose language, weekly performance emails, and interface sounds. | Preferences save; language changes reload the current localized page. |
| Your account name → **API Keys** | Create credentials for programmatic access. | The full secret appears once; revoke is destructive. This page is conditional. |
## Choose the right scope
1. Use **Workspace** for members, shared Credits, plan, and billing.
2. Use **Store** for the current storefront, domain, scripts, and project Agent settings.
3. Use **Personal** for your own profile, language, and API keys.
4. Before a sensitive action, confirm the workspace and store names shown in the dialog.
## Common states and limits
- **Saving…** followed by **Saved** confirms an auto-save field finished.
- A disabled control can indicate missing permission, a plan gate, a store prerequisite, or an operation already in progress.
- Billing and domain pages show the current terms and amount. Do not rely on an old screenshot or copied price.
- Destructive actions require confirmation, but the exact confirmation differs by action.
- Hidden pages should not be opened through copied links unless the current interface exposes them for your account.
## Troubleshooting
- If the Store group is missing, close Settings, enter the intended project, and open Settings again.
- If a page shows an upgrade or publish-first state, complete that prerequisite only if it fits your intended workflow.
- If an auto-save fails, the previous value remains or returns; correct the field and retry.
- If you are unsure which workspace is being changed, close the dialog and reopen Settings from that workspace.
- If you need account-security help but no approved entry is visible, contact Runner support instead of guessing a direct route.
## Related guides
- [Workspace General](/en/guides/account-and-settings/workspace-general)
- [Members and invitations](/en/guides/workspace/members-and-invitations)
- [Subscription plans](/en/guides/plans-and-billing/subscription-plans)
- [Store General](/en/guides/account-and-settings/store-general)
- [Security and sessions](/en/guides/account-and-settings/security-and-sessions)
---
# Experiments Settings
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/ai-lab
Experiments Settings configures automated storefront experiments for an eligible published store. Use it when you intentionally want Runner to optimize one selected business goal with part of your live traffic.
## What this covers
You will know how to enable the Beta setting, choose a goal and traffic allocation, save it, and recognize starting or stopping states.
## Availability and prerequisites
- **Experiments** is a conditional Beta page and is hidden unless enabled for the account.
- The store must be published. A draft shows a publish-first unavailable state.
- Enabling Experiments requires agreement to the linked **Experiments Terms**.
- Changing live experiment settings can affect storefront visitors. Review the selected goal and traffic before saving.
## Entry path
Inside an eligible project, select **Settings → Store: _store name_ → Experiments**.
## Controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Enable Experiments** switch | Reveal or stop the store's Experiments configuration. | Turning on reveals goal and traffic controls; Save submits the enabled configuration. Turning off an active configuration starts stopping it. |
| **Experiments Terms** | Review the terms attached to enabling the Beta. | The legal section opens in a new tab. |
| **Define Your Goal** | Tell Runner which metric the experiment should improve. | Selecting a goal marks that card as active. |
| **Traffic** slider/input | Choose the share of storefront traffic allocated to experiments. | The value stays within the displayed minimum and 100%. |
| Quick percentage buttons | Choose a common traffic value. | The slider and numeric value update together. |
| **Save** | Apply the enabled goal and traffic settings. | Runner starts the configuration operation and disables controls until it finishes. |
Available goals include Conversion Rate, Add-to-Cart Rate, Checkout Initiated Rate, Banner Engagement Rate, Button Click-through Rate, and Average Order Value.
The configuration steps below apply only after the publish-first gate clears. If a model selector is shown, review the available model before saving; the choices depend on your account. See [publishing](/en/guides/storefront-and-publishing) if the store is still a draft.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
English callouts highlight the controls. Select the image to enlarge it.
The unpublished store shows a prerequisite instead of experiment controls. No experiment was launched or measured.
## Configure Experiments
1. Publish the store, then open **Store → Experiments**.
2. Read the Beta description and **Experiments Terms**.
3. Turn on **Enable Experiments**.
4. Select one goal.
5. Choose a traffic allocation at or above the displayed minimum.
6. Review the selected goal and percentage.
7. Select **Save**.
8. Wait for the starting status to finish and confirm the saved state before leaving.
## Stop Experiments
1. Return to the same store's Experiments settings.
2. Turn off **Enable Experiments**.
3. Wait through **Stopping experiment, please wait…**.
4. Confirm the disabled state after the operation ends.
Do not repeat the toggle while an operation is in progress.
## States and limits
- An unpublished store shows that the feature is not currently available and asks you to publish first.
- **Starting experiment, please wait…** blocks concurrent changes.
- **Stopping experiment, please wait…** blocks concurrent changes.
- Goal is required before Save.
- Traffic is constrained to the displayed minimum through 100%.
- The whole settings entry can be absent for accounts without the feature.
## Troubleshooting
- If Experiments is missing, do not rely on a copied direct link; the feature is not enabled for the account.
- If the page asks you to publish, complete publishing before configuring a live experiment.
- If Save reports that a goal is required, select one goal card and retry.
- If controls are disabled, wait for the current starting or stopping operation to finish.
- If the saved state is unclear, reopen the page before toggling again.
## Related guides
- [Store General](./store-general)
- [Subscription plans](../plans-and-billing/subscription-plans)
- [Account and Settings overview](/en/guides/account-and-settings)
---
# API Keys
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/api-keys
API keys are personal secrets for programmatic Runner access. Create one only for an application you trust, store it securely, and revoke it when it is no longer needed.
## What this covers
You will know how to create and save the one-time secret, identify existing keys without exposing them, and revoke a key with confirmation.
## Availability and prerequisites
- **API Keys** is conditional and appears only when enabled for your account.
- The page states **Each key acts as you**. Keys belong to your personal account, not one store.
- Do not confuse these keys with read-only **Analytics API keys** in [Workspace General](/en/guides/account-and-settings/workspace-general).
- Never put a full key in chat, Agent Memory, a Skill, a screenshot, source control, or product documentation.
## Entry path
Select **Settings → your account name → API Keys**. If the entry is absent, the feature is not available for the current account.
## Controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Generate New Key** | Create a new credential. | A dialog opens with an optional Name field. |
| **Name** | Identify the application later without exposing the secret. | The name appears in the key table; blank creates an untitled key. |
| **Create Key** | Generate the credential. | Runner opens **API Key Generated** and displays the full secret once. |
| Eye icon | Check the full newly generated value before storing it. | The one-time value is shown or masked in the success dialog. |
| Copy icon | Copy the new key accurately. | Runner copies it to the clipboard and shows confirmation. |
| **I have saved it** | Close the one-time secret view. | The full value is cleared from the dialog and cannot be shown again there. |
| Existing key table | Identify keys safely. | Runner shows Name, Prefix, Created, and Last Used, not the full secret. |
| Delete icon | Revoke an existing key. | A confirmation explains that revocation cannot be undone. |
| **Revoke** | Disable the selected key. | After success, the key is removed from the list and can no longer authenticate. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg0z7QP9dmUDVzwn9xNJv4t2isec7IFkOaWAro)
English callouts highlight the controls. Select the image to enlarge it.
The empty list is the starting state. No secret was generated or displayed in this example.
## Inspect the dialog before creating a credential
1. Select **Generate New Key**.
2. Find the optional **Name** field; a label such as `Reporting integration` helps identify the application later.
3. Select **Cancel** if you are only exploring. No key is created until you select **Create Key**.
The workflow below applies when API Keys is available and you are ready to store a new secret.
## Generate and store a key
1. Open **your account name → API Keys**.
2. Select **Generate New Key**.
3. Enter a descriptive Name, such as the application or environment. Do not put a secret in the name.
4. Select **Create Key**.
5. In **API Key Generated**, reveal the key only if needed and select Copy.
6. Store it in a trusted secret manager.
7. Confirm the stored value before selecting **I have saved it**.
8. Use the table Prefix to identify the key later without exposing the full value.
Runner warns that the full key will not be shown again. If you close the dialog without saving it, revoke that key and create a replacement rather than trying to recover the secret.
## Revoke a key
1. Match the intended key by Name and Prefix.
2. Select its delete icon.
3. Review the **Revoke** confirmation.
4. Select **Revoke** only when the dependent application is ready to stop using it.
5. Confirm **API key revoked** and remove the old secret from the application.
Revocation is destructive and cannot be undone. Create a new key if access is needed again.
## States and limits
- **No API keys yet** is the normal empty state.
- A new key's full value appears only in its success dialog.
- Existing rows show a prefix and usage dates, not a recoverable key.
- **Never** under Last Used means Runner has not recorded a request for that key.
- Create and Revoke buttons show progress and should not be submitted repeatedly.
## Troubleshooting
- If API Keys is missing, do not use a copied direct link; the feature is disabled for this account.
- If clipboard copy fails, reveal the new value and copy it manually into a secure secret manager, then hide it again.
- If you lost a full key, revoke its row and generate a replacement.
- If an application stops working after revocation, update it with a newly created key; the old key cannot be restored.
- If the wrong key was selected, Cancel the confirmation and compare Name and Prefix again.
## Related guides
- [Security and sessions](./security-and-sessions)
- [Personal settings and workspaces](./personal-settings-and-workspaces)
- [Memory safety](../agent/memory)
---
# Custom Scripts and Store Agent
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/custom-scripts-and-store-agent
Custom Scripts changes storefront behavior, while Store Agent changes which Skills Runner can use for the current project. Both are store-specific settings and should be reviewed with extra care.
## What this covers
You will be able to add and save a script, pause it without deleting it, and add or disable a Skill for only the current project.
## Availability and prerequisites
- Open Settings from inside the intended project.
- Custom JavaScript can change storefront behavior. Add only code you understand and trust.
- Skill actions depend on available workspace Skills and whether a System Skill is configurable.
- The full Agent page and plan gate still control broader Skill availability.
## Entry paths
- Scripts: **Settings → Store: _store name_ → Custom Scripts**
- Project Skills: **Settings → Store: _store name_ → Agent**
## Custom Scripts controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Add Script** | Create a storefront script entry. | A new enabled Script row opens with empty JavaScript Code. |
| Script row | Expand or collapse its editor. | **Script Name** and **JavaScript Code** become visible. |
| Eye / hidden-eye icon | Enable or disable one script. | The local row changes state; select Save Changes to apply it. |
| Delete icon | Remove a script from the pending list. | The row disappears without a second dialog; Save Changes applies the removal. |
| **Save Changes** | Apply every pending script edit. | Runner saves the full script list and shows a success or error message. |
Runner allows up to ten script entries. The Save Changes button remains disabled when nothing has changed.
The blank editor lets you review the script fields before installation. No tracking script was saved in this example.
## Add or change a script
1. Open **Store → Custom Scripts**.
2. Select **Add Script**.
3. Enter a clear **Script Name** and trusted **JavaScript Code**.
4. Leave the script enabled only if it should run on the storefront.
5. Review all other rows because **Save Changes** applies the whole list.
6. Select **Save Changes** and wait for **Saved**.
7. Check the storefront safely after saving.
Runner tries to prevent one script error from crashing the page, but that does not make unknown code safe. A script can still affect privacy, performance, tracking, and customer experience.
### Inspect a script draft first
For a first look, select **Add Script**, name it `Store analytics`, and turn its eye control off. Leave the code empty and do not select **Save Changes**. This lets you identify the editor and disabled state before adding code from a trusted provider. When you do save a real script, reopen the list and check both its code and enabled state.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
For project Skills, choose **Agent** under the store heading. This image shows its entry; it does not show a Skill being added or disabled.
## Store Agent controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| Active Skill row | See which Skill is available in this project. | The row shows name, description, and System or Custom type. |
| **Disable** | Remove a configurable Skill from this project only. | The Skill leaves this project's active list; it is not globally deleted. |
| **Add Skill** | Add an available workspace Skill to this project. | Selecting a listed Skill enables it for the current project. |
| **Create custom skill…** | Create a new custom capability. | The Skill editor opens, then the project list refreshes after success. |
## Configure project Skills
1. Open **Store → Agent**.
2. Review the currently active Skills.
3. Select **Add Skill**, then choose an available Skill or **Create custom skill…**.
4. Wait for the success message and confirm the Skill appears.
5. Use **Disable** when a configurable Skill should stop applying to this project.
6. Open **Agent** in the project navigation for full Skill details, pause, edit, import, or delete actions.
## States and limits
- Script changes remain local until **Save Changes** succeeds.
- Removing a script row has no separate confirmation before Save Changes.
- Reaching ten scripts disables **Add Script**.
- Store Agent can show loading, an error, **No skills enabled**, or the active list.
- Fixed System Skills do not show **Disable**.
- Disabling in Store Agent changes this project's scope; it does not delete or globally pause the Skill.
## Troubleshooting
- If a script still runs, confirm its disabled state was followed by **Save Changes**.
- If Save fails, the previously saved list stays unchanged; correct the code or retry after the error.
- If **Add Skill** has no expected entry, check the full Agent page and the current plan.
- If **Disable** is absent, the System Skill is not configurable for this project.
- If a new Skill appears globally but not here, add it to the project from Store Agent.
## Related guides
- [Store General](./store-general)
- [Agent Skills](../agent/skills)
- [Create, import, and manage Skills](../agent/create-import-manage-skills)
- [API key safety](./api-keys)
---
# Delete, Recover, and Leave
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/delete-recover-and-leave
Runner uses different confirmation flows for deleting a store, deleting a workspace, leaving a workspace, and requesting account deletion. Review the exact scope before any destructive action.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Check the workspace or store scope in **Settings** before opening a removal action. This image shows navigation only; no deletion or recovery has been performed.
The annotations are in English. Select the image to enlarge it.
## What this covers
You will know what each action removes, what confirmation it requires, and when conditional store recovery may appear.
## Availability and prerequisites
- You need permission for the item you are changing.
- The last workspace cannot be deleted.
- Store recovery is a conditional legacy feature. Use it only if Runner exposes **Recently deleted** and lists the store there. The current store navigation does not promise this destination.
- Do not treat conditional recovery as a guarantee when approving deletion.
- The current global avatar and Settings menus do not expose the protected account-security page. Use account deletion only when Runner or Runner support gives you an approved entry.
## Entry paths and action map
| Action and entry path | Confirmation | What happens after success |
| --- | --- | --- |
| Settings → Store: _store name_ → **General → Delete** | Type the exact store name, then select **Delete**. | The store is removed. If you delete the current store, Runner opens another available store or the new-store entry. |
| Conditional multi-select → **Delete selected** | Type `DELETE`, then select **Delete All**. | The selected stores leave the active grid after the operation succeeds. |
| Conditional legacy store list → **Recently deleted → Recover project** | No destructive confirmation; select Recover project. | The store returns to the active project list and its workspace resources begin preparing again. |
| Settings → Workspace → General → **Delete Workspace** | The Owner types the exact workspace name, then selects **Delete**. | Runner removes the workspace and switches to another available workspace. |
| Settings → Workspace → Members → your row → **Leave** | Review the named workspace dialog, then select **Leave**. | You lose access to its projects and Runner redirects to another available workspace or chooser. |
| Account deletion → email support@adaptivemachines.ai | Send the request from the email address of your Runner account. | Runner support replies with the next step. |
## Delete one store
1. In the intended store, open **Settings → Store: _store name_ → General** and confirm the workspace and store names.
2. Select **Delete**.
3. Read the warning about store data.
4. Type the exact store name.
5. Select the destructive **Delete** button.
6. Wait for the deletion result. Confirm Runner has opened another store or the new-store entry, then verify that the deleted store is no longer available.
The confirmation warns that the action cannot be reversed. Although some accounts show a separate recovery feature, it can be absent or unavailable; never delete on the assumption that Recover will appear.
## Recover a store from a legacy view when available
1. Continue only if your workspace exposes the legacy store list and its **Recently deleted** entry.
2. Open **Recently deleted**; do not look for it in the current store navigation or guess a direct link.
3. Match the store by name and deletion date.
4. Select **Recover project** once.
5. Wait for **Project recovered** and confirm the store returns to the active list.
6. Open it only after its required workspace resources become available.
If **Recently deleted** is absent, no recovery path is exposed in that view. Contact support if you need help; this guide does not promise availability or a recovery window.
## Delete a workspace
1. As the workspace Owner, open **Settings → Workspace → General** for the exact workspace.
2. Select **Delete Workspace**.
3. Read the permanent-removal warning.
4. Type the exact workspace name.
5. Select **Delete**.
6. Confirm Runner switches to another workspace.
The only workspace cannot be deleted. Deleting a workspace is presented as permanent and not recoverable.
## Leave a workspace
1. Open **Settings → Workspace → Members**.
2. Find your row marked **(you)**.
3. Select **Leave** if available.
4. Confirm the workspace name and select **Leave** in the dialog.
5. Confirm you are redirected away and no longer have its project access.
Leaving does not delete the workspace for its remaining members. The Owner row does not offer this Leave action on the Members page.
## Request account deletion
1. Email support@adaptivemachines.ai from the email address of your Runner account.
2. Ask for the account to be deleted.
3. Follow the instructions in the reply from Runner support.
This request is broader than deleting one store or workspace. Review [Security and sessions](./security-and-sessions) before continuing.
## Troubleshooting
- A disabled final button means the confirmation text does not match exactly or the action is still running.
- A deletion error does not prove that nothing changed. Refresh the active list and check the item before retrying.
- **Recovering…** locks other Recover buttons until the current request finishes.
- If recovery reports an error, check the active and recently deleted lists before retrying.
- If Leave reports an error, verify your current access and workspace before retrying.
- If you have no reply about account deletion, do not send many requests. Reply in the same email thread instead.
## Related guides
- [Store General](./store-general)
- [Workspace General](./workspace-general)
- [Members and invitations](../workspace/members-and-invitations)
- [Security and sessions](./security-and-sessions)
---
# Personal Settings and Workspaces
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/personal-settings-and-workspaces
My Settings changes your Runner preferences across projects. Use the workspace switcher separately when you want to work in another team.
## What this covers
Choose the interface language, weekly performance emails, and interface sounds without changing workspace settings.
## Availability and prerequisites
- You must be signed in.
- The checked **My Settings** view shows Language, Weekly performance emails, and Interface sounds. Profile controls can differ by account or surface.
- Workspace creation and membership actions can be limited by account permission or current workspace state.
## Entry paths
- Preferences: **Settings → your account name → My Settings**
- Workspace switching: follow [workspace navigation](/en/guides/workspace).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBH6DLmxmaXn1xqodiYlA9g46Lh3VyHFBkOze)
English callouts highlight the controls. Select the image to enlarge it.
Select **My Settings** for interface preferences. **API Keys** opens the separate personal-credential page.
## My Settings controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Language** | Change Runner's interface language. | Runner saves the choice and reloads the current page in that locale. |
| **Weekly performance emails** | Receive your store's performance report in your inbox once a week. | The switch saves whether Runner sends the report; it is enabled by default. |
| **Interface sounds** | Hear a soft click for taps, toggles, and alerts. | The switch saves the preference; turn it off for silence. |
## Change language or report emails
1. Open **My Settings** under your account name.
2. Choose **Language** when you are ready for the page to reload.
3. Confirm the interface uses the selected language after reload.
4. Change **Weekly performance emails** only when you want to change delivery of your store reports.
5. Wait for the preference to save, then reopen the page to check it.
## Check a preference without changing your profile
1. Open **My Settings** and find **Interface sounds**.
2. Choose whether clicks and alerts should make a sound.
3. Wait for the setting to save, then close and reopen **My Settings**.
4. Confirm the switch still matches your choice.
For switching or creating workspaces, use the [workspace guide](/en/guides/workspace). There is no public **Workspaces** destination in the current Settings sidebar. To leave a workspace, follow [Members and invitations](/en/guides/workspace/members-and-invitations).
## States and limits
- A language update keeps the control busy until persistence and navigation finish.
- My Settings does not expose session, account-deletion, or API-key controls. See [Security and sessions](./security-and-sessions) and [API Keys](./api-keys).
## Troubleshooting
- If language does not change, wait for the current update to finish, then select it again once.
- If you opened the wrong workspace's settings, close the dialog, switch workspace, then reopen Settings.
- If you need to leave, open that workspace's Members page instead of looking for Leave here.
## Related guides
- [Members and invitations](../workspace/members-and-invitations)
- [Workspace General](./workspace-general)
- [Security and sessions](./security-and-sessions)
- [Delete, recover, and leave](./delete-recover-and-leave)
---
# Security and Sessions
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/security-and-sessions
Runner has no in-app page that lists your sessions or deletes your account. You sign out from the avatar menu. Runner support handles requests to end sessions on other devices and to delete your account.
## What this covers
You will know how to sign out on the device you are using, and how to ask Runner support to end other sessions or delete your account.
## Availability and prerequisites
- You must be signed in to sign out.
- Send support requests from the email address of your Runner account, so support can confirm that the account is yours.
- Account deletion is permanent. It removes all data that belongs to the account.
## Sign out on this device
1. Select your avatar in the top navigation.
2. Select **Logout**.
3. Confirm that Runner shows the signed-out homepage.
## End sessions on other devices
1. Sign out on each device that you still have access to.
2. If you cannot reach a device, or you do not recognize a sign-in, email support@adaptivemachines.ai.
3. Say which account is affected and what you saw.
## Request account deletion
1. Email support@adaptivemachines.ai from the email address of your Runner account.
2. Ask for the account to be deleted.
3. Follow the instructions in the reply from Runner support.
Deleting a store or a workspace does not delete your account. See [Delete, recover, and leave](./delete-recover-and-leave) for those actions.
## Troubleshooting
- If Runner still shows you as signed in after **Logout**, reload the page.
- If support cannot match your request to an account, send it again from the email address that you use to sign in.
## Related guides
- [API Keys](./api-keys)
- [Personal settings and workspaces](./personal-settings-and-workspaces)
- [Delete, recover, and leave](./delete-recover-and-leave)
---
# Store General
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/store-general
Store General controls the current storefront rather than the whole workspace. Use it to rename the store, update its browser and search appearance, or review its deletion boundary.
## What this covers
You will be able to update store identity fields, save a favicon, understand plan-gated watermark control, and avoid deleting the wrong store.
## Availability and prerequisites
- Open Settings from inside the intended project; otherwise the Store group is not shown.
- Search fields require the store backend settings to load.
- Removing the Runner watermark requires the plan shown beside that control.
- Delete Store is destructive and requires the exact store name.
## Entry path
Inside the intended project, select **Settings → Store: _store name_ → General**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
Select **General** under the store heading, not the workspace heading. This navigation detail does not show edited or saved store fields.
## Controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| Associated Workspace, Creator, Creation Time | Confirm which store and ownership context you are viewing. | These details are read-only. |
| **Name** | Rename the store inside Runner. | A valid change saves automatically. |
| **Page Title** | Set the title shown in browser tabs and search results. | A valid change saves automatically and updates the preview. |
| **Description** | Set the store's short search description. | A valid change saves automatically. |
| Favicon button | Change the browser-tab icon. | A popover opens with **Upload** and **AI-generated** choices. |
| **Upload Image** | Use your own favicon file. | Runner validates the file and shows a preview before **Save**. |
| **Run it** | Generate a favicon from the prompt. | Runner shows a generated preview; it is not applied until **Save**. |
| Remove Watermark switch | Control the Runner storefront watermark. | The change is available only on the plan shown beside the control. |
| **Shopper chat** | Let shoppers get instant answers in the storefront. | The switch saves the store preference and refreshes an open preview. It is enabled by default. |
| **Delete** | Remove the current store. | **Delete Store** opens and requires the exact store name. |
## Update store identity
1. Open **Store → General** and confirm the Associated Workspace and store Name.
2. Edit **Name**, **Page Title**, or **Description**.
3. Wait for **Saved** after each auto-save field.
4. Check the browser-style preview beside the favicon section.
Page Title and Description enforce the current character limits shown by their fields. If a field stops accepting more text, shorten it rather than pasting around the limit.
### Example: separate the store name from the search title
For a candle shop, the Runner **Name** might be `Candle Studio`, while **Page Title** is `Candle Studio | Hand-poured candles`. Write a short **Description** of the products you actually sell. After each **Saved** message, reopen General and check the value. Search engines can take time to update and may choose different search-result text.
## Change the favicon
1. Select the current favicon button.
2. Choose **Upload** or **AI-generated**.
3. For Upload, select an ICO, PNG, or SVG file under the displayed file-size limit.
4. For AI-generated, enter an optional prompt and select **Run it**.
5. Review the preview.
6. Select **Save** to apply it. Closing the popover discards an unsaved preview.
## States and limits
- Auto-save fields show saving, success, or error feedback.
- Favicon Upload rejects unsupported formats and oversized files.
- **Generating…** and **Uploading…** are progress states; wait for a preview.
- The watermark control can show a plan badge and block the change.
- Delete Store stays unavailable until the project and its name are loaded.
## Danger zone
Selecting **Delete** opens a confirmation that warns all store data will be lost. The final button remains disabled until you type the exact store name. Some accounts separately expose conditional recovery, but you must not rely on recovery when deciding to delete.
## Troubleshooting
- If the Store group is absent, reopen Settings from inside the project.
- If a title or description reverts, correct its validation issue and wait for Saved.
- If favicon upload fails, check type and size, then choose the file again.
- If generated favicon creation fails, revise the prompt and retry only after the previous attempt ends.
- If Remove Watermark is blocked, use the plan badge to review availability.
## Related guides
- [Connect a custom domain](../storefront-and-publishing/custom-domains)
- [Custom Scripts and Store Agent](./custom-scripts-and-store-agent)
- [Delete, recover, and leave](./delete-recover-and-leave)
---
# Workspace General
Source: https://www.runnerai.com/docs/en/guides/account-and-settings/workspace-general
Workspace General controls the shared identity of a Runner workspace. Use it when the team name or description changes, or when you need to review the workspace danger zone.
## What this covers
You will be able to update workspace details and recognize when a change has saved successfully.
## Availability and prerequisites
- A workspace admin or owner is required to change the shared Name or Description.
- Only the workspace Owner can complete workspace deletion.
- Runner does not allow the last remaining workspace to be deleted.
## Entry path
Open **Settings**, confirm **Workspace: _workspace name_** in the sidebar, then select that group’s **General** page.
## Controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Name** | Set the full workspace name visible to other members. | A valid change saves automatically after editing. |
| **Description** | Explain what the workspace or team is for. | A valid change saves automatically. |
| **Delete Workspace** | Remove a workspace you no longer need. | A name-confirmation popover opens. The button is disabled for the last workspace. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTBoRI6D7lIPXqUA4xQWKLGpygc8jMtzfNJri)
English callouts highlight the controls. Select the image to enlarge it.
This example workspace has no analytics keys listed. Changing the workspace identity and creating an analytics credential are separate actions.
## Update workspace details
1. Open **Settings → Workspace → General**.
2. Edit **Name** or **Description**.
3. Leave the field and watch the status.
4. Wait for **Saved** before closing Settings or switching workspace.
5. Reopen the page if you need to verify the persisted value.
**Checkpoint:** close Settings, reopen General for the same workspace, and confirm the saved Name or Description. A changed field still showing **Saving…** is not this checkpoint.
## States and limits
- Name cannot be empty and must stay within the displayed validation limits.
- Description accepts a short workspace summary and has a displayed character limit.
- **Saving…** means the change is still in progress.
- **Saved** confirms the current value was accepted.
- A save error restores or retains the previous saved value.
- **Delete Workspace** is disabled when this is your last workspace.
## Analytics API keys are a separate scope
Workspace General can include **Analytics API keys** for external reporting tools with read-only analytics access. These are different from [personal API Keys](/en/guides/account-and-settings/api-keys), which act as your signed-in account. Check the scope before creating or sharing any credential. An empty analytics-key list means no key is listed here; it is not the personal-key list.
## Delete boundary
Selecting **Delete Workspace** does not delete immediately. Runner asks an Owner to type the exact workspace name, then enables the destructive **Delete** button. The deletion cannot be restored from this screen and removes the workspace's data and settings.
## Troubleshooting
- If an empty Name returns to its earlier value, enter a valid non-empty name.
- If **Saved** never appears, keep the dialog open, check the error, and retry.
- If Delete Workspace is disabled, this is likely the last workspace or the workspace has not loaded.
- If you opened the wrong workspace's settings, close the dialog and reopen it from the intended workspace.
## Related guides
- [Members and invitations](../workspace/members-and-invitations)
- [Personal settings and workspaces](./personal-settings-and-workspaces)
- [Delete, recover, and leave](./delete-recover-and-leave)
---
# Advanced features
Source: https://www.runnerai.com/docs/en/guides/advanced
Runner includes advanced ways to research customers, plan work, build reusable workflows, and receive events. These pages are intentionally separated from the core store journey because availability and entry points can differ by workspace.
> **Availability:** **Research** can appear under **Measure**, **Fly** in the main navigation, and **Webhooks** under **Sell**. **Workflow** remains conditional: use it only when Runner shows an entry for your workspace or Runner support provides one. Do not guess or edit a URL to reach a hidden page. If an expected entry is missing, see [Feature availability](/en/guides/advanced/feature-availability).
| Feature | Use it for | Guide |
| --- | --- | --- |
| Research | Turn a business question into a structured study and report. | [Research](/en/guides/advanced/research) |
| Fly | Set a mission and follow a guided business-planning workspace. | [Fly](/en/guides/advanced/fly) |
| Workflow | View and run reusable multi-step flows when Runner provides an entry. | [Workflow](/en/guides/advanced/workflows) |
| Webhooks | Configure supported event deliveries when Runner provides an entry. | [Webhooks](/en/guides/advanced/webhooks) |
For tools grouped under **Grow** and **Measure**, see [Automate, test, and create](/en/guides/automate-test-and-create).
---
# Feature availability
Source: https://www.runnerai.com/docs/en/guides/advanced/feature-availability
Runner can show different features according to workspace, role, plan, store type, publication state, connected services, data, and staged release access.
**Entry path:** Runner documentation → **Advanced features** → **Feature availability**.
## Common availability gates
| What you see | Likely requirement | What to do |
| --- | --- | --- |
| Entry is missing | The feature is staged, disabled, or not available to this workspace. | Check the workspace and ask an owner or support. Do not use a guessed URL. |
| Upgrade message | The current plan does not include the action or its limit was reached. | Open **Plan & Billing** and review the current on-screen offer. |
| Publish requirement | The tool needs a live store or published site data. | Complete the publication checklist, then return after a successful publication. |
| Connect button | A provider or account must be connected first. | Open the named app and complete its official connection flow. |
| Empty dashboard | The feature is available but does not have data for the selected store, filter, or period. | Confirm store, date range, publication, and event collection. |
| Permission message | Your workspace role cannot perform the action. | Ask an owner to complete it or change access. |
| Page not found | The route is unavailable, retired, or not valid for this context. | Return through visible navigation and contact support if the entry itself is broken. |
## Check in order
1. Confirm the selected workspace and store.
2. Expand **Sell**, **Grow**, and **Measure** in project navigation before deciding an entry is missing. On mobile, open the project menu first.
3. Check whether the page names a prerequisite.
4. Check your role and the current plan from workspace settings.
5. Confirm required publication, data, or app connection.
6. Reload once after a recent access or connection change.
7. Contact support with the exact page, visible state, workspace, and store name.
### What not to assume
- A hidden entry does not prove the feature was removed from every account.
- An empty page does not prove collection is broken.
- A source route does not prove your workspace can use the feature.
- A successful connection does not prove downstream checkout, fulfillment, or reporting without an end-to-end result.
## When the page is only a preview
A feature preview can show sample cards while an upgrade notice blocks real actions. Read that notice before interpreting the cards as your store data. For the full status dictionary, see [States and availability](../help-and-reference/states-and-availability).
## Related guides
- [States and availability](../help-and-reference/states-and-availability)
- [Subscription plans](../plans-and-billing/subscription-plans)
- [Troubleshoot publishing, checkout, and apps](../help-and-reference/troubleshoot-publishing-checkout-apps)
- [Support and community](../help-and-reference/support-and-community)
---
# Fly
Source: https://www.runnerai.com/docs/en/guides/advanced/fly
Fly is a guided workspace for turning a store goal into a mission, reviewing proposed work, and following progress from one dashboard.
## Entry path
Open a store project and select **Fly** when it is available. If the entry is missing, see [Feature availability](./feature-availability).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOvxtCXuJCcW62zHrU8smjSnqvixd1twlAf4u)
English callouts highlight the controls. Select the image to enlarge it.
Review the first mission and its launch stages before choosing Start this mission. This view is setup, not an active mission.
## Before you start
- Fly must be enabled for the current project.
- Review the store, mission, and affected proposal tasks before approving work.
- Proposal, abort, and next-mission actions can change real project work; use the confirmation text as the final authority.
## Start the first mission
Projects without a mission open onboarding automatically.
1. Open **Fly** and read the proposed store goal.
2. If a dashboard already shows a mission, review that mission instead of starting another.
3. Review the suggested mission and its stages. The **Get your first paid order** introduction presents five stages and a **Start this mission** action. Select it only when you intend to start that mission; otherwise close onboarding.
4. Confirm the dashboard shows the intended mission before reviewing proposals.
**Checkpoint:** Opening onboarding only shows the proposal for a mission. The mission exists after you confirm it and the dashboard displays it.
| Control | What happens after you select it |
| --- | --- |
| **Start your first mission** | Reopens onboarding when the project still has no mission. |
| **Start this mission** | Starts the mission described by the introduction. Review its target and stages before confirming. |
| **Set this mission**, when shown in mission setup | Creates the proposed mission for the current project and opens the Fly dashboard. Review the store and goal before confirming. |
Closing onboarding without confirming the mission leaves the project without a new mission. You can return with **Start your first mission**.
After onboarding, **Get your first proposal** can open a read-only launch checklist. The card stays with active dashboard work while any launch-readiness step is incomplete or unavailable. Once every current step is complete, the card moves to **Past Work**; if a step later becomes incomplete, it returns to active work. When **View detail** appears on **Build storefront**, it opens the project's first Runner conversation. The button is absent when no first conversation is recorded.
## Read the dashboard
The dashboard brings the current mission and store activity together. On smaller screens, the same sections are stacked vertically.
| Section | What it shows |
| --- | --- |
| Mission progress | The active goal and progress toward it. |
| Orders, Revenue, and Sessions | Today's headline store signals. These are read-only summaries. |
| **Feeds** | Recent signals and Fly's current observations. Select a story to open its viewer. |
| **Ongoing work** | Approved proposals that are running or waiting for your action. Select a card to open its proposal details. |
| **Past Work** | Completed or failed proposals, plus the completed First Proposal example when applicable. Select a card to review it; **Show more** loads older real proposal entries. |
| **Your todos** | Tasks that need your attention. **Previous** and **Next** move through more than one page of items. |
| Store preview | Shows the current publish state when available. Select it to open **Store**. |
| **Open chat** | Opens the Fly chat so you can ask about the mission or visible work. **Close chat** dismisses it. |
| **All caught up** | Appears when no to-dos or proposals need a decision. It confirms that Fly is still monitoring the store; it does not mean every running task is finished. |
| **Explore Runner** | When the queue is clear, offers **Open Creative Studio** when enabled, **Browse Skills**, and **Explore Automations**. Each button opens that project tool without starting work by itself. |
An empty **Ongoing work** or **Past Work** section may be hidden. That means there is nothing in that state, not that project history was erased.
In Fly chat, **New conversation** starts a fresh thread, while history reopens an earlier one. The first message creates the conversation. If sending fails, the draft stays in the composer so you can retry without rewriting it.
### Read a Fly story
The story viewer shows **current item of total** in its header. Use the previous and next arrows to move between items, or close the viewer to return to the dashboard. When a story includes a linked source chip, selecting it opens that exact source in a new browser tab. If the story cannot load, select **Retry** without leaving Fly. Market-news cards can disappear after they are no longer recent.
## Review a proposal
Open a proposal from the dashboard before allowing work to begin. A proposal can contain several tasks; selecting a task can also include prerequisites it depends on.
| Control or state | What happens next |
| --- | --- |
| Task selection | Chooses which tasks to approve. Required prerequisite tasks are included so the selected work can run in order. |
| **Approve & Execute** | Approves the selected tasks and starts execution. It is unavailable when no task is selected. Connected actions can have real effects. |
| **Reject** | Opens a confirmation. Confirming closes the proposal and runs none of its tasks; this cannot be undone. |
| **Abort** | Opens **Abort this proposal?** while work is running. **Confirm abort** stops unfinished tasks; completed work is kept. **Keep running** closes the confirmation. |
| **Preview** | Opens the completed workflow result when a preview is available. |
| **View detail** | On a supported first-proposal task, opens the related Runner conversation so you can review the work context. |
| Waiting for your action | Execution is paused until you complete the requested manual action and select **Resolve**. |
| **Helpful** / **Not helpful** | **Helpful** saves immediately. **Not helpful** opens editable reasons and details; closing it keeps the existing feedback, and changes save only after **Submit**. |
Some review-stage proposal pages also show a proposal chat panel. Use it to ask about that proposal; it does not replace **Approve & Execute**, **Reject**, **Abort**, or **Resolve** when the applicable action is shown.
The **Outcomes** section stays hidden while a proposal is under review, executing, or being verified. It can appear after completion or failure only when outcome data is ready. A missing Outcomes section during active work is not evidence that the proposal failed.
For document and media outcomes, **Download** saves the available deliverable, **Restore media** retries unavailable media, and **Continue in Chat** opens editable follow-up instructions. These actions do not change the proposal's acceptance or review status.
When a proposal includes Fly video generation, the current task produces one 6-second 720p video with audio. Asking for another duration in the task prompt does not change that output length.
## Resolve a user-owned task
When a task marked **Your task** pauses for an action that only you can complete, read its instructions, complete the action outside the card, then select **Resolve**.
**Resolve** is your confirmation that you completed the requested action; Runner does not independently verify that outside result. While Runner checks the state, the card shows **Loading task action**. While it submits, the button shows **Resolving…**. **This task is no longer waiting for your action.** means it cannot be resolved from the current card. If you see **Couldn't resolve this task. Please try again.**, check the connection and try once more. Do not mark a task resolved before the requested action is actually complete.
## Resolve todos
Select **Resolve** only on an eligible one-click task. Runner then records your confirmation from the dashboard. More detailed tasks, including tasks with file outputs, stay read-only in the todo list; open the related proposal to review their instructions and current state.
If resolving fails, keep the task open and try once more after checking the connection. Do not assume the task completed until its status changes.
## Follow ongoing and past work
1. Open a card in **Ongoing work** to see its current proposal and task states.
2. If it says **Waiting for your action**, complete the requested manual action and select **Resolve** instead of approving the proposal again.
3. Use Abort only when unfinished work should stop. Already completed work is not rolled back.
4. Open **Past Work** to review outcomes and failed proposals.
5. For a failure, keep the proposal title and visible task error before asking for help.
## Complete a mission and choose the next one
When Runner recognizes that a mission is achieved, **Mission complete** opens a guided flow. If you close it before choosing another goal, **Choose your next mission** can reopen the flow.
1. Select **Review the journey** to see the mission recap, important moments, and work Fly completed alongside you.
2. Select **See what's next** to review the suggested next mission.
3. Adjust the target with the available preset or increase/decrease controls, then select **Continue**.
4. Read the rollout summary carefully.
5. Select **Begin Mission** only when the new target is correct.
6. When the next mission is live, select **Go to Mission Control** to return to the dashboard.
**Begin Mission** has real project effects: already-running tasks continue, proposal generation resumes against the new goal, and proposals you have not acted on are closed so Fly can regenerate them for the new target. Current progress carries over.
## Troubleshooting
| State | Next step |
| --- | --- |
| Onboarding opens automatically | Set the mission or close onboarding and return later. |
| Dashboard appears | A mission exists; use the dashboard rather than creating a duplicate. |
| **Waiting for your action** | Open the proposal, complete the specific manual action, then select **Resolve**. |
| Abort conflict or status changed elsewhere | Refresh the proposal and use its current state. |
| Completed preview fails to load | Select **Retry** in the Workflow Preview, or reopen the completed proposal for the latest result. |
| Proposal failed | Open it from **Past Work** and keep the visible task error. |
| Final verification cannot recover | The proposal settles as failed instead of remaining in ongoing work. Open it from **Past Work** and keep the visible error before retrying. |
| Next mission cannot start | Try once more. If another session already started it, the dashboard refreshes to the live mission. |
| Entry missing or page not found | Fly is not available in this context. See [Feature availability](./feature-availability). |
## Related guides
- [Feature availability](./feature-availability)
- [Task states and details](../work-with-runner/task-states-and-details)
- [Troubleshoot Runner tasks](../help-and-reference/troubleshoot-runner-tasks)
---
# Research
Source: https://www.runnerai.com/docs/en/guides/advanced/research
Research gives a project-scoped place to investigate buyer needs, concepts, positioning, and other business decisions.
## Entry path
Open a store project and expand **Measure** and select **Research** when the feature is available. On mobile, open the project menu first. If **Research** is absent, that workspace does not currently expose the feature; see [Feature availability](./feature-availability).
## Before you start
- Research must be enabled for the current project.
- Prepare one business question with at least five characters and remove unnecessary customer data.
- Live scouting, panels, and reports can use external data or credits; review each available action before starting it.
## Start or reopen a study
The Research home has two modes: **New study** and **Saved panels**.
| Control | What happens after you select it |
| --- | --- |
| **New study** | Opens the question form and the project's recent studies. |
| Question field | Accepts the business decision you want to investigate. **Start study** stays unavailable until the question is valid. |
| Scenario card | Places a suggested research direction into the question field so you can edit it. |
| **Start study** | Creates a live study from the current question and opens its guided workspace. |
| **See a finished example first** | Opens a read-only example preview. It does not create a live study, and actions that require a live study may be unavailable. |
| Recent study card | Reopens that project's existing study. |
| **Saved panels** | Opens panels saved for reuse. |
| **Launch study** | Selects that saved panel and returns to **New study**. Enter a new research question, then select **Start study** to create the study. |
| **Load more** | Loads additional studies or saved panels. |
| **Retry** | Requests the current library or failed stage again. |
Use one focused decision as the question. A question such as “Which product claim should we lead with for first-time buyers?” gives the study a clearer job than a broad topic such as “marketing.”
## Move through the guided stages
The left side of a study asks questions and offers choices. Select the relevant choices, add a custom answer when needed, then use the primary action for the current stage.
| Action | What Runner starts |
| --- | --- |
| **Build research plan** | Turns your question and answers into a study plan. |
| **Modify inputs** | Reopens the planning inputs before scouting begins. |
| **Rebuild research plan** | Replaces the current plan with a new plan based on the modified inputs. |
| **Start scouting [source]** (for example, **Start scouting X**) | Starts scouting on the source named by the approved plan. |
| **Build the validation panel** | Builds the audience panel used to challenge and validate the findings. |
| **Start panel discussion** | Begins the panel conversation. |
| **Generate summary, minutes & report** | Produces the final written artifacts from the completed discussion. |
| **Retry** followed by a stage name | Repeats the failed stage. Review the failure first so you do not repeat the same input blindly. |
The exact primary action changes as each stage becomes ready. Do not select a later-stage action until you are satisfied with the current plan, findings, or panel.
## Review study artifacts
On desktop, guided chat and the artifact canvas sit side by side and can be resized. On mobile, use **Study chat** and **Artifacts** to switch between them.
| Artifact tab | What it contains |
| --- | --- |
| **Overview** | The study timeline and which stages are ready or pending. Selecting a ready item opens its artifact. |
| **Plan** | The approved research approach. It remains empty until planning finishes. |
| **[Source] Scout** (for example, **X Scout**) | The scouting progress and sources for the study's current source. |
| **Findings** | Themes and evidence produced after scouting. |
| **Panel** | The validation audience built from the findings. |
| **Discussion** | The panel conversation and follow-up responses. |
| **Report** | The final report workspace after the discussion is complete. |
A pending tab is not an error: its empty state explains which earlier stage must finish first. The Overview timeline also marks unavailable stages as pending.
## Save a useful panel
Open **Panel** and select **Save panel** when its audience is useful for later studies. Enter the panel name and optional description in the save form, then confirm. Runner reports **Panel saved for future studies**, and the panel appears under **Saved panels**.
Saving preserves the panel for reuse; it does not start another study. In an example preview, saving is unavailable because the example is not live project data.
## Read and share the report
The final report workspace separates three views:
- **Report** presents the full research result.
- **Summary** gives the shorter decision-focused version.
- **Minutes** records the panel discussion.
Select **Share** to share the current study link with the device's sharing panel when supported. If native sharing is unavailable, Runner copies the link and shows **Study link copied**. Sharing sends a link, not a downloaded static report; the recipient still needs appropriate access.
## Continue the panel discussion
During the Discussion stage, use the follow-up composer to ask for a clearer answer or test a different angle.
| Control | Result |
| --- | --- |
| **Challenge a finding** | Fills the composer with a challenge prompt that you can edit. |
| **Ask the panel** | Fills the composer with a direct panel question. |
| **Change the audience** | Fills the composer with a request to consider a different audience. |
| **Send follow-up** | Sends the current message into the live panel discussion. |
Suggestion chips prepare text; they do not send anything until you select **Send follow-up**. If the composer is over its limit or the study is not ready, the send action stays unavailable.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Example | A completed demonstration, not live project research. Return to **New study** to create your own. |
| Pending artifact | An earlier stage has not finished. Return to Overview or Study chat and continue the available stage. |
| Stage is running | Runner is preparing the next artifact. You can return through recent studies later. |
| Retryable failure | Read the visible error, then use the stage-specific **Retry** once. |
| Recovery is blocked | Select **Refresh study** to load the current server state before continuing. |
| Follow-up fails | Keep the message, use Retry when offered, or refresh the study before resending. |
| Study or panel library fails | Select **Retry**. Preserve the question and visible error if it repeats. |
| Empty study history | This project has no study yet. Start with one focused question. |
## Recommended path
1. Open **New study** and enter one decision-focused question.
2. Select **Start study** and answer the guided choices.
3. Review the Plan; use **Modify inputs** before scouting if the scope is wrong.
4. Move through Scout, Findings, Panel, and Discussion, reviewing each ready artifact.
5. Save the panel only when its audience will be useful again.
6. Generate and read the Report, Summary, and Minutes.
7. Share the study link only with people who should have access.
8. Use follow-ups for specific gaps instead of starting a duplicate study.
## Try the example before a live study
1. Open **Measure** → **Research** → **New study**.
2. Select **See a finished example first**.
3. Read the example plan and report using the available artifact tabs.
4. Return to **New study** and write one decision you want to investigate.
5. Select **Start study** only when you are ready to create a live study.
**Checkpoint:** The example lets you inspect the output format without creating a study. For your own study, confirm your question appears in its workspace; later scouting and report actions have their own progress and results.
## Related guides
- [Feature availability](./feature-availability)
- [Experiments](../automate-test-and-create/experiments)
- [Analytics overview](../analytics-and-seo/analytics-overview)
- [Support and community](../help-and-reference/support-and-community)
---
# Webhooks
Source: https://www.runnerai.com/docs/en/guides/advanced/webhooks
Webhooks let another service receive selected events from a Runner project. This is an advanced, security-sensitive feature: use it only when you know which service should receive the events and how that service verifies them.
## Entry path
Open **Sell** → **Webhooks** when Runner makes the entry available to your workspace. If there is no entry, do not guess a URL; see [Feature availability](./feature-availability) or ask support whether the feature is enabled.
## Before you start
- Use Webhooks only when Runner or support exposes an approved entry.
- Know the intended receiving service and how it verifies events.
- Treat endpoint addresses, signing secrets, and delivered data as sensitive.
## What Runner shows
Your workspace may show Runner’s webhook workbench or an embedded provider portal. Follow the section that matches your screen.
### Inspect the Runner workbench
**Conditional:** When the first-party workbench is enabled, use these tabs:
| Tab | What to review |
| --- | --- |
| **Endpoints** | Configured receiving destinations and their status. |
| **Catalog** | Available event types before choosing what a destination receives. |
| **Logs** | Recorded deliveries and their returned status. |
| **Activity** | Recent webhook activity. |
1. Open **Endpoints** and identify the destination you intend to inspect.
2. Read **Catalog** to check the relevant event type.
3. Open **Logs** and inspect an available delivery for that destination.
4. Compare its status with the receiving service’s own record before calling delivery successful.
**Checkpoint:** A saved endpoint confirms configuration; a successful delivery record and matching receiver record confirm that particular event. An empty log does not prove delivery is working. Test, resend, and replay actions send events; use them only for an intended test.
### Embedded provider portal
Runner prepares the webhook service before it displays the embedded management portal.
| Page state or control | What it means or does |
| --- | --- |
| **Loading…** | Runner is checking whether the webhook service is ready. |
| **Webhook platform is initializing** | Setup is still in progress. Wait and keep the page open, or return later. |
| **Initialization is taking longer than expected** | Setup has not completed after the normal wait. **Retry** asks Runner to provision the service again. |
| **Retrying…** | The retry is in progress; the button remains unavailable until the request finishes. |
| Error message | Runner could not prepare the service. Keep the visible message for support. |
| Embedded webhook portal | The service is ready. The exact labels and controls inside this provider-managed portal can change, so follow the instructions shown there rather than relying on fixed button names in this guide. |
| **Reconnect Shopify** | Opens the Shopify integration page when an older Shopify connection needs new webhook permissions. Reconnect before expecting Shopify events to arrive. |
## Recover from a long initialization
1. Wait for the initialization message to finish.
2. If **Initialization is taking longer than expected** appears, select **Retry** once.
3. Wait for the embedded portal to replace the initialization screen.
4. If an error appears again, save the project name and exact message, then contact support instead of repeatedly retrying.
## Reconnect Shopify when asked
1. Read the **Reconnect your Shopify store** notice.
2. Select **Reconnect Shopify**.
3. Complete the connection flow on the Shopify integration page.
4. Return to Webhooks and confirm the reconnect notice is gone before relying on event delivery.
Reconnecting changes the store's integration authorization. Only a person who is allowed to manage that store connection should continue.
## Security notes
- Treat endpoint addresses, signing secrets, and event contents as sensitive.
- Add or change a destination only when its owner has supplied the correct secure address.
- Review every confirmation shown inside the embedded portal; its actions can affect future deliveries.
- If a signing value is exposed, replace it in both Runner's webhook service and the receiving system before sending more events.
## Troubleshooting
| Problem | Next step |
| --- | --- |
| No Webhooks entry | The feature is not exposed in this workspace. Check [Feature availability](./feature-availability). |
| Initialization does not finish | Use **Retry** once, then report the exact state if it repeats. |
| Error message appears | Keep the full message and project name for support. |
| Shopify reconnect notice remains | Finish reconnecting from the integration page, then reload Webhooks once. |
| Embedded portal is blank or behaves differently | Reload once. If it persists, capture what is visible; the embedded provider interface may differ by account or release. |
## Related guides
- [Feature availability](./feature-availability)
- [Security and sessions](../account-and-settings/security-and-sessions)
- [Apps troubleshooting](../apps-and-integrations/troubleshooting)
- [Support and community](../help-and-reference/support-and-community)
---
# Workflow
Source: https://www.runnerai.com/docs/en/guides/advanced/workflows
Workflow turns a repeatable process into connected steps that Runner can run with the same inputs and rules again.
> **Conditional:** The Workflow interface exists, but the current standard project navigation does not expose a Workflow entry. Use it only when Runner displays an approved Workflow entry for your workspace or Runner support provides an approved path. Do not guess or edit a URL to reach it. If your plan allows only a preview, Runner can show the page while keeping its controls blocked.
## Entry path
Open the **Workflow** entry only when Runner presents it in your workspace. The page lists workflows for the current project. If no entry is present, use [Feature availability](./feature-availability) or contact support instead of trying a direct URL.
## Before you start
- Workflow access depends on the current feature rollout and plan.
- Confirm the project and connected services before testing or deploying a workflow.
- A preview or saved draft is not active; deployment and activation are separate consequential actions.
## Workflow list
When there are no workflows, select **Create workflow**. When the list already has items, use **New workflow**.
| Control | What happens after you select it |
| --- | --- |
| **Create workflow** or **New workflow** | Opens **Create a workflow**. |
| **Blank workflow** | Creates an **Untitled Workflow** and opens its builder. |
| Template card | Creates a workflow from that template and opens its builder. If templates fail to load, **Retry** requests them again. |
| Workflow name | Opens that workflow in the builder. |
| **Rename** | Makes the name editable. Enter or clicking away saves it; Escape cancels the edit. |
| **Pin to top** / **Unpin** | Moves the workflow into or out of the pinned group. It does not run the workflow. |
| **Duplicate** | Creates a copy and opens the copy in the builder. |
| **Export** | Downloads the workflow as a JSON file. It does not deploy or run anything. |
| **Delete** | Opens a confirmation. Confirming permanently removes that workflow and cannot be undone. |
Use each row's More menu to find **Rename**, **Pin to top** or **Unpin**, **Duplicate**, **Export**, and **Delete**.
Row labels can also show whether a version is **Live**, has a **Draft ahead**, exposes an Endpoint, or is bound to a Schedule or Event. A paused or plan-blocked label means automatic triggering is not currently active.
### Work with several workflows
Select the checkbox beside one or more rows. The selection bar shows how many are selected and offers:
- **Export** to download the selected workflows.
- **Delete** to open a bulk confirmation. Confirming permanently removes every selected workflow.
- **Clear** to remove the selection without changing any workflows.
**Select all** selects the workflows shown in the current list. Always recheck the count before bulk deletion.
## Build and save
The builder canvas is where you add steps, connect them, and configure what each step receives and does. **Add component** opens the searchable component library. Canvas controls zoom in, zoom out, fit the workflow on screen, and automatically arrange connected steps.
Changes save automatically; there is no separate Save button. The Back arrow finishes a pending save before returning to the workflow list.
| Save state | What to do |
| --- | --- |
| **Saving…** | Wait before closing the page or deploying. |
| **Saved** | The latest canvas change is stored. |
| **Save failed** | Select **Retry** after checking the connection. |
| **Conflict — your changes were not saved** | Another saved version is newer. **Reload** discards the conflicting local edits and loads the saved version. |
The lower panel contains **Playground** and **Runs**. In Playground, complete the required text, product, or media inputs before running. The run control stays unavailable while required inputs are missing. Results appear in the output area.
The builder's More menu also provides **Export JSON** and **Import JSON…**. Export downloads the current canvas. Import immediately replaces the current canvas and triggers autosave without a confirmation, so export a backup and check the selected file before importing.
## Choose the right test
Testing can have very different consequences.
| Control | What happens after you select it |
| --- | --- |
| **Simulate** | Opens a simulation dialog. Use generated sample data or paste JSON, then select **Run simulation**. Write-side actions such as emails, Slack posts, and store changes are stubbed. |
| **Live test** | Opens a live-test dialog. Use generated data, pasted JSON, or a recent event when available. **Run live test** makes real API calls and can send messages or change connected services. The run is marked as a test in history. |
| **Skip waits** | During a live test, skips configured wait periods so the test can continue sooner. It does not remove other real effects. |
| **Run workflow** | Starts the configured workflow immediately and opens Runs. Its steps may have real effects; review every step and input first. |
| **Stop** | Requests that the current run stop. Work already completed is not reversed. |
| **Cache** | On a rerun, skips eligible nodes whose inputs have not changed so you can focus on changed downstream work. |
Use Simulation to check branching and data flow. Use Live Test only when real side effects are acceptable in the connected accounts.
Both tests use the trigger you chose, even before you deploy. For a **Schedule** or **One-time** trigger, the test starts the run as if the trigger fired at that moment, so you can test a one-time workflow before its scheduled date.
## Review run history
Open **Runs** in the lower panel to see previous runs. Filter the list with **Live**, **Test**, or **All runs**, then select a run to inspect its node results, output, timing, and errors. Statuses include Completed, Failed, Running, and Cancelled.
If the list says **No runs yet**, the current workflow has no recorded execution. Starting another run is not a fix for a failed one; open the failed run first and read its error.
Some eligible failed nodes offer **Retry from “node”**. This starts a new attempt immediately, without another confirmation. Downstream actions can run again, so check for messages or store changes already produced by the failed run first.
## Deploy and activate
Select **Deploy** to open **Deploy workflow**. Review the change summary, API-contract compatibility, validation results, and optional changelog before continuing.
You can optionally bind the deployed workflow to an event, a recurring schedule, or a one-time run. Only one of those trigger types can be selected at a time. A one-time run needs a date and time in the future, entered in your own time zone.
- **Deploy workflow** publishes a version with the selected settings.
- **Activate and deploy** appears when a new event, schedule, or one-time binding would make the automation active. Confirming it publishes the version and allows future triggers to run automatically with real effects.
A save error, unresolved conflict, or validation problem can block deployment. Resolve it instead of repeatedly selecting Deploy.
The production status shows **Not deployed**, **Draft ahead**, or **Live**, plus the trigger. Before the first deploy, the trigger is the one you chose (**Event**, **Schedule**, **One-time**, or **Manual**) or **No trigger**. After a deploy, it is **Manual** when no trigger is bound, otherwise the binding state, such as **Active**, **Scheduled**, **Completed**, or **Paused**. Opening an existing binding offers consequential controls:
- **Pause** stops automatic triggers but keeps the workflow and binding.
- **Resume trigger** allows the retained binding to trigger again.
- **Remove trigger** permanently deletes the binding but does not delete the workflow.
Each action opens a confirmation and can include a reason. Removing the check from an existing binding during deployment pauses that binding rather than permanently removing it.
## Version history and rollback
Select **Version history** to open the **Version history** panel.
| Action | Result |
| --- | --- |
| **Review rollback** | Opens **Rollback to this version?**. **Confirm rollback** makes the selected deployed version supersede the current deployed version. This can change what future runs do, but it does not replace the current draft canvas. |
| **Restore** in Draft History | Replaces the current canvas with the selected saved draft after confirmation. Unsaved or newer canvas changes can be lost. |
Add an optional rollback reason so other workspace members understand the change. Review the restored canvas and deployment state before starting another run.
## Safe operating checklist
1. Confirm you are in the correct project and workflow.
2. Wait for **Saved** before testing or deploying.
3. Complete and review every required input.
4. Start with **Run simulation** when possible.
5. Use Live Test or Run workflow only when their connected-service effects are acceptable.
6. Inspect **Runs** and outputs before deploying.
7. Treat **Activate and deploy**, rollback, restore, and deletion as consequential actions that require a final review.
## Troubleshooting
| Problem | Next step |
| --- | --- |
| No **Workflow** entry is visible | This is expected in the standard navigation. Do not guess a URL; see [Feature availability](./feature-availability) or ask Runner support whether your workspace has an approved entry. |
| Controls are blocked by a plan preview | Follow the plan message on screen or ask a workspace owner about access. |
| Template list fails | Select **Retry**, or create a **Blank workflow**. |
| Run button is unavailable | Complete every required input and fix any invalid value. |
| Save conflict appears | Decide whether the saved version should win before selecting **Reload**, because local conflicting edits are discarded. |
| Run fails | Open it in **Runs**, keep the visible error and inputs, and avoid starting identical runs repeatedly. |
| Deploy is blocked | Resolve save, conflict, contract, or validation messages shown in the deploy dialog. |
## Check the result before the next stage
After saving, reopen the same workflow and confirm its steps and inputs are present. A saved workflow is ready for review, but has not necessarily run. When your workspace exposes testing or deployment controls, inspect the resulting run status and output before moving to deployment. A failed run needs its input or failing step corrected before another attempt.
## Related guides
- [Automations](../automate-test-and-create/automations)
- [Task states and details](../work-with-runner/task-states-and-details)
- [Troubleshoot Runner tasks](../help-and-reference/troubleshoot-runner-tasks)
- [Feature availability](./feature-availability)
---
# Agent Customization
Source: https://www.runnerai.com/docs/en/guides/agent
The **Agent** page, headed **Teach Runner how you work**, brings Skills and Memory into one searchable place. Use it when you want Runner to repeat a useful method, remember a stable fact, or stop using a capability you no longer need.
## What this covers
You will know how to open Agent Customization, find an existing capability, and choose whether a Skill or Memory is the right tool.
## Availability and prerequisites
- You need access to a store project.
- Skills can depend on your current plan. If your plan does not include Skills, Runner shows the available upgrade path instead of enabling the action.
- Memory appears only when the unified Memory feature is enabled for your account.
- Older **Skills**, **Memory**, and **Customize** links redirect to this Agent page.
## Open Agent Customization
From a project, select **Agent** in the sidebar. Use the **All**, **Skills**, and **Memory** filters to narrow the page. **Recommended for you**, **Added**, and **Discover** are sections within that page, not separate navigation tabs.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
Use the page filters to focus on Skills or Memory. Existing active Skills appear in **Added**; browsing a recommendation does not install it.
## Main controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Search skills and memory** | Find a capability without scanning every section. | The page filters matching Skills and Memory. The clear button restores the full list. |
| **All** | Review everything available to the Agent page. | Runner shows the Skills area and, when enabled, Memory. |
| **Skills** | Focus on reusable instructions and abilities. | Runner shows recommended, added, paused, and discoverable Skills. |
| **Memory** | Focus on facts Runner should retain. | Runner shows memories grouped by scope. This tab is hidden when Memory is unavailable. |
| **Add** | Install or reactivate a Skill. | The Skill moves into **Added** after Runner completes the action. |
| **Added** | See that a Skill is active. | For configurable Skills, selecting it pauses that Skill. |
| **Import** | Bring in a compatible Skill from a URL. | Runner checks the source, then opens an editable import or a multi-Skill chooser. |
| **Create Skill** | Write a custom reusable instruction. | The Skill editor opens. Required fields must be complete before it can be saved. |
| **Add a memory** | Save a stable fact or preference. | The **New memory** dialog opens. |
## Choose between a Skill and Memory
1. Use a **Skill** when Runner should follow a repeatable process, format, or set of instructions.
2. Use **Memory** when Runner should retain a concise fact, preference, correction, convention, or decision.
3. Keep secrets out of both. Never store passwords, API keys, payment details, or private credentials.
4. Return to **All** and search for a term to confirm that the new item appears.
## States and limits
- **Recommended for you** shows a small set of trending Skills.
- **Added** contains active Skills; **Paused** contains inactive Skills.
- **Discover** can show loading rows, search results, or a no-results message.
- A System Skill can be view-only or fixed. A Custom Skill can offer edit and delete actions.
- An empty Memory area offers **Add a memory**. A search with no match offers **Clear search** without deleting anything.
- Loading, plan, and unavailable states do not mean a capability was added.
## Troubleshooting
- If **Memory** is missing, the feature is not enabled for the current account. Continue using Skills or check again from visible navigation later.
- If **Add** opens an upgrade screen, compare plans before making a billing decision.
- If search finds nothing, clear the query and check **All**, **Skills**, and **Memory** separately.
- If a change fails, keep the dialog open, correct the displayed problem, and retry. Do not assume a toast or loading state means the change completed.
## Related guides
- [Use and pause Skills](/en/guides/agent/skills)
- [Create, import, and manage Skills](/en/guides/agent/create-import-manage-skills)
- [Add and edit Memory](/en/guides/agent/memory)
- [Use the Agent command palette](/en/guides/agent/command-palette)
---
# Agent Command Palette
Source: https://www.runnerai.com/docs/en/guides/agent/command-palette
The Agent command palette is a keyboard-first shortcut for Agent capabilities. It is useful when you know what you need and do not want to browse the full Agent page.
## What this covers
You will be able to open the palette, search its three capability groups, use the keyboard, and understand what selecting each result does.
## Availability and prerequisites
- You must be inside a project.
- Skills remain subject to plan access and each Skill's configurable state.
- Memory results appear only when unified Memory is enabled.
- This palette is different from project navigation search: **Command/Ctrl + K** searches destinations and conversations, while **Command/Ctrl + Shift + K** opens Agent capabilities.
## Entry path
In a project where the palette is available, press **Command + Shift + K** on macOS or **Ctrl + Shift + K** on Windows and Linux. Check that the dialog shows **Skills** and **Memory** filters before selecting a result. If it opens navigation Search instead, close it and use sidebar **Agent**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
If the keyboard shortcut does not open the capability palette, use this **Agent** page to find the same Skills. This image shows the fallback page, not the command palette.
## Controls
| Entry or key | Why it is useful | What happens next |
| --- | --- | --- |
| Search field | Find Skills by name, description, category, or type, and Memories by content, tags, type, or scope. | Results update under Added, Discover, and Memory. |
| **All** | Search every available capability type. | Skills and, when available, Memory appear together. |
| **Skills** | Limit results to installed and discoverable Skills. | Memory rows are hidden. |
| **Memory** | Limit results to saved memories. | This tab is hidden when Memory is unavailable. |
| Up/Down arrows | Move through results without a mouse. | The highlighted row changes. |
| Enter | Select the highlighted row. | The result performs its type-specific action. |
| Escape | Leave without changing anything. | The palette closes. |
## What selection does
| Result type | What happens when selected |
| --- | --- |
| Added configurable Skill | Runner toggles the Skill's active state when your plan allows it. |
| Fixed System Skill | The row remains unchanged if that Skill cannot be toggled. |
| Discover Skill | Runner starts adding the Skill; the row can show **Adding…**. |
| Memory | The palette closes and opens **Agent → Memory** with a search based on that memory. |
| Skill without plan access | Runner opens **Agent → Skills**, where the plan gate explains the available next step. |
## Use the palette
1. Press **Command/Ctrl + Shift + K**.
2. Type a distinctive word from the Skill name, source, or memory content.
3. If needed, select **Skills** or **Memory** to narrow the list.
4. Use the arrow keys to highlight a row.
5. Review the action text on the right, such as **Add** or **Open**.
6. Press Enter only when that is the action you want.
7. Confirm the result on the Agent page or in the updated palette state.
## States and limits
- **Nothing to show** means the current tab and query returned no rows.
- **Adding…** is a progress state, not confirmation that installation finished.
- The palette is optimized for quick selection; create, edit, delete, Memory scope, and detailed Skill settings remain on the full Agent page.
- Selecting an active Skill can pause it. Read the row state before pressing Enter.
## Troubleshooting
- If the shortcut opens project Search or more than one dialog, press Escape to close it and use sidebar **Agent** to manage the same capabilities.
- If Memory is absent, the account does not currently have the unified Memory surface.
- If Enter opens the Agent page instead of toggling a Skill, follow the displayed plan gate.
- If there are no results, clear the search or select **All**.
- If a Skill remains unchanged, it may be a fixed System Skill.
## Related guides
- [Agent Customization overview](/en/guides/agent)
- [Skills](./skills)
- [Memory](./memory)
- [Subscription plans](../plans-and-billing/subscription-plans)
---
# Create, Import, and Manage Skills
Source: https://www.runnerai.com/docs/en/guides/agent/create-import-manage-skills
Custom Skills let you package your own instructions for repeated use. Import is useful when a compatible Skill already exists and you want to review it before adding it to Runner.
## What this covers
You will know how to create or import a Skill, understand each editor control, and distinguish reversible pause from permanent deletion.
## Availability and prerequisites
- Open a project with access to **Agent → Skills**.
- Skills require plan access.
- Import requires a compatible source URL that Runner can read.
- Do not import instructions you do not trust. Review the name, description, content, settings, and included files before saving.
## Entry paths
- Create: Sidebar **Agent** → **Skills** filter → **Create Skill** in the **Discover** section.
- Import: Sidebar **Agent** → **Skills** filter → **Import** in **Discover**.
- Edit or delete: Sidebar **Agent** → **Skills** filter → a row in **Added** → **More actions**.
## Skill editor controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Name** | Gives the Skill its identity in lists and commands. | Runner validates that a name is present before saving. |
| **Description** | Explains when the Skill should be used. | The description appears in Skill lists and selectors. |
| **Content** | Stores the reusable instructions. | Write in **Edit** and use **Preview** to check the formatted instructions. |
| **Advanced Config** | Reveals optional invocation and organization settings. | Expand it only when you need to change those settings. |
| **Switch to Markdown** / **Switch to Form** | Changes how you edit the Skill. | Opens the Markdown or field-based editor; switching views does not save the Skill. |
| **Category** | Groups related Skills. | This optional label affects how Skills are organized. |
| **Shortcut Label** | Gives the Skill a clearer command label. | The optional label appears with command-oriented controls. |
| **Enabled** | Chooses whether the new or edited Skill starts active. | It starts on for a new Skill. Turn it off before creating the Skill if it should start paused. |
| **Disable AI Auto-Invocation** | Prevents Runner from choosing the Skill automatically. | The Skill remains available for manual use. |
| **User Invocable** | Allows manual slash-command use. | Turning it off removes manual invocation while keeping other allowed use. |
| **Argument Hint** | Shows the expected input after a command. | The hint can display examples such as a URL or issue number. |
| Files area | Add supporting text or assets needed by the Skill. | Runner validates individual and total file limits before saving. |
| **Cancel** | Leave without applying the current edit. | The dialog closes; unsaved changes are discarded. |
| **Create** / **Save** | Persist a valid Skill. | Runner closes the editor after success and refreshes the Skill list. |
## Create a custom Skill
1. Open sidebar **Agent** and select the **Skills** filter.
2. In **Discover**, select **Create Skill**.
3. Enter a lowercase, hyphenated **Name**, such as `homepage-copy-review`, a concise **Description**, and the Skill **Content**. These fields are required.
4. Select **Preview** in Content to check the instructions. Expand **Advanced Config** for optional settings only when you need them.
5. Review **Enabled** and any advanced invocation settings you changed. These controls determine how Runner can use the Skill.
6. Select **Create**.
7. Confirm the Skill appears under **Added** or **Paused**, depending on the Enabled setting.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4coukNWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
English callouts highlight the controls. Select the image to enlarge it.
This example previews instructions before **Create**. The draft has not been saved.
### Watch: review a Skill draft
The recording switches the example between Markdown and form Preview, then cancels. To keep your own Skill, select **Create** and confirm it appears in the list.
## Import a Skill
1. Open **Agent**, select the **Skills** filter, and find **Import** in **Discover**.
2. Paste the compatible source URL.
3. Select **Import**.
4. For one discovered Skill, Runner opens the editor with imported fields filled in. For a source containing several Skills, Runner opens a chooser.
5. Review every imported field and any excluded-file or size warning.
6. Make necessary changes, then select **Create**.
7. Confirm the Skill appears in the Agent page before closing your workflow.
Import does not make unreviewed content trustworthy. Treat imported instructions like any other content that can influence Runner's work.
## Edit, pause, or delete
1. Select a Custom Skill row or open **More actions → Edit**.
2. Change the fields you need and select **Save**. Reopen the Skill to confirm the updated instructions.
3. To stop using it without losing it, select **Added** to move it to **Paused**.
4. To remove it, open **More actions → Delete**.
5. Review the named confirmation dialog and select **Delete** only when you intend to remove the Skill.
**Delete is destructive.** It is not the same as pausing, and the page does not present it as an undoable action. System Skills do not offer delete.
## States and limits
- Missing Name, Description, or Content blocks saving and shows a validation message.
- A duplicate imported Skill name can be rejected or marked as already present.
- Files that exceed accepted limits can be skipped; a total-size warning can block saving until content is reduced.
- While save, import, or delete is running, wait for the success or error message before taking another action.
- View-only System Skills can show details but do not expose Custom Skill editing controls.
## Troubleshooting
- If **Import** stays unavailable, wait for the existing-Skill check to finish and confirm the URL field is not empty.
- If import opens a batch chooser, select only the Skills you recognize and need.
- If save is blocked, check the required fields and any file warning at the top of the editor.
- If a Skill disappeared after selecting **Added**, check **Paused** before recreating it.
- If deletion fails, the Skill remains; close the error and retry after checking your permissions.
## Related guides
- [Skills](./skills)
- [Agent Customization overview](/en/guides/agent)
- [Use the Agent command palette](./command-palette)
- [Store Agent settings](../account-and-settings/custom-scripts-and-store-agent)
---
# Memory
Source: https://www.runnerai.com/docs/en/guides/agent/memory
Memory is for concise facts Runner should retain, such as a writing preference, a corrected business rule, or an approved decision. It reduces repeated explanation across tasks.
## What this covers
You will be able to add, find, edit, and safely delete a memory.
## Availability and prerequisites
- You need a store project.
- The **Memory** tab appears only when unified Memory is enabled for your account.
- Memory is separate from the Skills plan gate.
- Never save passwords, API keys, payment details, private credentials, or other secrets in Memory.
## Entry path
Select **Agent** in the sidebar, then the **Memory** filter.
## Memory controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Add a memory** | Save a new fact for Runner. | The **New memory** dialog opens. |
| **Content** | State the fact Runner should retain. | This text becomes the visible memory. |
| **Scope** | Choose where the fact should apply. | Select **This store**, **Personal**, or **Organization**. |
| **Type** | Explain what kind of fact it is. | Select Preference, Correction, Convention, Knowledge, or Decision. |
| **Tags** | Make the memory easier to find and group. | Enter one or more comma-separated tags. At least one tag is required to save. |
| **Importance** | Tell Runner how strongly to weigh the fact. | Select Low, Medium, or High. |
| **Add memory** | Save a valid new memory. | The dialog closes after success and the memory appears in its scope group. |
| Edit icon | Correct or refine a memory. | **Edit memory** opens with the current values. |
| **Save** | Apply an edit. | The row refreshes after the update succeeds. |
| Delete icon or **Delete** | Remove a memory. | Runner opens a destructive confirmation dialog. |
## Add a memory
1. Open sidebar **Agent**, then select the **Memory** filter.
2. Select **Add a memory**.
3. Write one clear fact in **Content**, such as “Use sentence case for headings in this store.”
4. Choose the narrowest correct **Scope**.
5. Choose the closest **Type**.
6. Add useful comma-separated **Tags**, such as `copy, headings`.
7. Set **Importance**. Use High sparingly for facts Runner should prioritize when information competes.
8. Select **Add memory**.
9. Confirm the new row appears under the intended scope.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
English callouts highlight the controls. Select the image to enlarge it.
The example is an unsaved preference. Choose the narrowest scope before selecting **Add memory**.
### Watch: choose a memory scope
The recording inspects the scope choices for an example preference, then cancels. It does not save a memory. Follow the steps above and check the new row to confirm your own save.
## Edit or delete a memory
1. Find the memory by browsing its scope group or using search.
2. Select the edit icon, update the fields, and select **Save**. Reopen the row to check the new content and scope.
3. To remove it, select the delete icon or **Delete** inside the edit dialog.
4. Review **Delete memory** and select **Delete** to confirm.
Deleting a memory cannot be undone from this dialog. Cancel closes the confirmation without removing it.
## States and limits
- A new account can show **No memories yet** with an **Add a memory** action.
- A search with no match says how many memories are hidden and offers **Clear search**.
- Content and at least one tag are required before the save button becomes available.
- Memories are grouped by scope and show their type, scope, use count, and recent-use time.
- Memory makes a fact available to Runner; it is not a guarantee that the fact will override every instruction or safety boundary.
## Troubleshooting
- If the **Memory** tab is absent, use visible navigation rather than an old direct link. The feature is not enabled for the current account.
- If **Add memory** is disabled, add Content and at least one comma-separated tag.
- If the list seems empty after search, select **Clear search**.
- If an edit fails, the previous memory remains. Correct the displayed issue and retry.
- If a memory is being applied too broadly, edit it and choose a narrower scope.
## Related guides
- [Memory types and scopes](./memory-types-and-scopes)
- [Agent Customization overview](/en/guides/agent)
- [Use the Agent command palette](./command-palette)
- [API key safety](../account-and-settings/api-keys)
---
# Memory Types and Scopes
Source: https://www.runnerai.com/docs/en/guides/agent/memory-types-and-scopes
Scope prevents a fact from reaching the wrong work, while Type and Importance help Runner interpret it. Use this page when a memory should apply to more than one task but not necessarily every store or person.
**Entry path:** **sidebar → Agent → Memory → Add a memory**, or open an existing memory to edit it.
## What this covers
You will be able to choose the narrowest correct scope, classify a memory, and use tags and importance without storing sensitive data.
## Availability and prerequisites
- Unified Memory must be enabled for the account.
- Open **sidebar → Agent → Memory → Add a memory**, or edit an existing memory.
- Do not use any scope for passwords, API keys, card data, authentication codes, or other secrets.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
English callouts highlight the controls. Select the image to enlarge it.
Use **Scope** for where the fact applies and **Type** for what it represents. This is an unsaved example; [Add and edit Memory](/en/guides/agent/memory) includes the full walkthrough and recording.
### Video: The memory and skills page on a new store
The recording opens the page on a store that has been taught nothing, points at **Add a memory**, and then at the **Skills** tab beside it. It shows where memories are created and how they sit next to skills; it does not create a memory or set a scope, type, importance, or tag.
## Scope choices
| Scope | Use it when | What happens next |
| --- | --- | --- |
| **This store** | The fact is specific to the current storefront, catalog, brand, or workflow. | Runner groups the memory under the store scope and can apply it to work for this store. A new memory defaults to this scope, **Preference** type, and **Medium** importance. |
| **Personal** | The fact describes your own working preference. | Runner groups it as Personal rather than sharing it as a workspace-wide rule. |
| **Organization** | The fact is an approved rule or convention shared across the workspace. | Runner groups it under Organization so it can inform work beyond one store. |
Choose the narrowest scope that is still useful. A store-specific shipping rule, for example, should not be an Organization memory unless it truly applies everywhere.
## Type choices
| Type | Good use | Example |
| --- | --- | --- |
| **Preference** | A desired style or working choice | “Use concise, editorial product descriptions.” |
| **Correction** | A fact Runner previously got wrong | “The returns window is stated in the approved policy document.” |
| **Convention** | A repeatable naming or formatting rule | “Use sentence case for collection headings.” |
| **Knowledge** | A stable business or product fact | “The flagship collection is called Studio Essentials.” |
| **Decision** | An approved choice that future work should respect | “Keep guest checkout enabled.” |
Do not include a secret in an example or memory. Refer to the location of a protected credential instead of storing its value.
## Importance and tags
| Control | Why it is useful | What happens next |
| --- | --- | --- |
| **Low** | Keep a helpful but optional fact available. | Runner gives it less weight when information competes. |
| **Medium** | Use the normal priority for stable working facts. | Runner gives it the default middle weight. |
| **High** | Mark an important approved rule or decision. | Runner gives it more weight when choosing between relevant memories. |
| **Tags** | Make search and grouping easier. | Comma-separated tags are saved with the memory; at least one is required. |
Importance is a priority hint, not an instruction to ignore the current request, account permissions, or safety restrictions.
## Classify a memory
1. Write the fact as one clear sentence.
2. Ask where it should apply: only this store, only to you, or across the organization.
3. Select the closest Type based on why the fact exists.
4. Add a small set of specific tags.
5. Start with Medium importance unless there is a clear reason to choose Low or High.
6. Save and confirm the row appears under the expected scope heading.
## States and limits
- The list displays Type, Scope, how many times the memory was used, and a relative recent-use time.
- Editing Scope moves the memory to a different group after the save succeeds.
- Memory selection depends on relevance and priority; a High memory is not guaranteed to appear in every response.
## Troubleshooting
- If a memory influences the wrong store, change its Scope to **This store** in the correct project.
- If two memories conflict, edit or delete the outdated one instead of raising both to High.
- If search misses a memory, try words from its Content or Tags, then clear the filter.
- If a shared convention is not visible to collaborators, confirm it was saved as **Organization**, not Personal.
## Related guides
- [Add and edit Memory](./memory)
- [Agent Customization overview](/en/guides/agent)
- [Security and sessions](../account-and-settings/security-and-sessions)
---
# Skills
Source: https://www.runnerai.com/docs/en/guides/agent/skills
Skills give Runner a repeatable set of instructions for a type of work. They are useful when you want a reliable process to be available across future conversations instead of rewriting the same prompt each time.
## What this covers
You will be able to add a Skill, tell whether it is active, pause it, and understand which actions are available for System and Custom Skills.
## Availability and prerequisites
- Open a store project where you have permission to manage Agent capabilities.
- Skill use is plan-gated. Runner shows an upgrade path when the current plan does not include it.
- Some System Skills cannot be paused, edited, or deleted.
## Entry path
Select **Agent** in the sidebar, then the **Skills** filter. Scroll to **Recommended for you**, **Added**, or **Discover** within the same page.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
Read the Skill source and current state before selecting **Add** or **Added**. The screenshot shows existing Skills, not the result of installing a new one.
## Skill sections and controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **Recommended for you** | Quickly review a small set of trending Skills. | Selecting **Add** starts installation. |
| **Added** | See which Skills are active. | Each row shows the Skill name, description, type, and available actions. |
| **Paused** | Find Skills that are currently off. | Selecting **Add** reactivates a configurable Skill. |
| **Discover** | Browse or search additional Skills. | A Skill name can open its source in a new tab; **Add** installs it into your workspace. |
| Skill row | Read the Skill details. | A Custom Skill opens in edit mode. A System Skill opens in view mode. |
| **Added** button | Pause an active configurable Skill. | The Skill moves to **Paused** after the update succeeds. |
| **Add** button | Install or reactivate a Skill. | The button shows progress, then the Skill appears under **Added**. |
| More actions | Find edit, view, or delete actions. | Available actions depend on whether the Skill is System or Custom. |
## Add a discovered Skill
1. Select **Agent** in the sidebar, then the **Skills** filter. Scroll to **Recommended for you**, **Added**, or **Discover** within the same page.
2. Search for the task or format you need.
3. Review the Skill name, source, and description.
4. Select **Add**.
5. Wait for the progress state to finish.
6. Confirm that the Skill appears under **Added** before relying on it in chat.
## Pause or reactivate a Skill
1. Find the Skill under **Added**.
2. Select its **Added** button.
3. Confirm that it moves to **Paused**.
4. To reactivate it, select **Add** in the Paused section.
Pausing is reversible. It stops the Skill from being active without deleting its definition.
## System and Custom Skills
| Skill type | Typical actions | Important limit |
| --- | --- | --- |
| **System** | View details; pause only when the Skill allows it | Fixed System Skills do not offer delete and may not offer pause. |
| **Custom** | Edit, pause, reactivate, or delete | Delete requires confirmation and removes the Skill rather than merely pausing it. |
## States and limits
- **Adding…** means installation is still running. Wait for **Added**.
- Search results can come from the public Skills directory as well as Skills already in your workspace.
- A plan gate blocks activation; it does not remove existing Skill definitions.
- Imported content can omit files that exceed accepted limits. Review any warning before saving.
- **No skills.sh results for this search** means no compatible discovery result was returned; it does not affect added Skills.
## Troubleshooting
- If **Add** does not complete, retry once after checking the displayed error. Avoid clicking repeatedly while the button is busy.
- If a Skill cannot be paused, it is likely a fixed System Skill. Open its details to confirm.
- If the expected Skill is absent, clear search and check both **Added** and **Paused**.
- If a newly added Skill is not available in one project, check **Settings → Store → Agent** for that project's Skill selection.
## Related guides
- [Create, import, and manage Skills](./create-import-manage-skills)
- [Agent Customization overview](/en/guides/agent)
- [Use the Agent command palette](./command-palette)
- [Store Agent settings](../account-and-settings/custom-scripts-and-store-agent)
---
# Analytics and SEO
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo
Start in **Measure** → **Analytics** for recorded store behavior, or **Grow** → **SEO** for the **SEO & GEO** overview. Choose a guide below for the question you need to answer.
> **Availability:** **Analytics** depends on your plan and recorded store data. **SEO** needs a paid plan: **Plus** or higher, or AppSumo License Tier 2, 3, or 4. It can also depend on a published storefront, provider access, and enough public data to analyze.
| Goal | Start here |
| --- | --- |
| Understand the whole performance page | [Analytics overview](/en/guides/analytics-and-seo/analytics-overview) |
| Change the reporting window | [Metrics and filters](/en/guides/analytics-and-seo/metrics-filters) |
| Find funnel or cart friction | [Traffic and conversion](/en/guides/analytics-and-seo/traffic-and-conversion) |
| Start a storefront visibility review | [SEO overview](/en/guides/analytics-and-seo/seo-overview) |
| Read organic search estimates | [Search performance](/en/guides/analytics-and-seo/search-performance) |
| Inspect links and technical issues | [Backlinks and site audit](/en/guides/analytics-and-seo/backlinks-and-site-audit) |
| Understand visibility in AI answers | [AI visibility](/en/guides/analytics-and-seo/ai-visibility) |
| Test prompts and inspect sources | [Prompts, keywords, and citations](/en/guides/analytics-and-seo/prompts-keywords-citations) |
| Recover from empty or blocked pages | [Troubleshoot data and publication](/en/guides/analytics-and-seo/troubleshoot-data-and-publication) |
These views report or analyze available data. Opening a report does not change the storefront, and a setup screen is not proof that traffic, rankings, or AI mentions improved.
---
# AI visibility
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/ai-visibility
AI visibility helps you inspect whether available AI-search data mentions your brand, competitors, or public sources.
> **Conditional:** AI visibility can depend on workspace access, plan, provider availability, a public storefront, and sufficient data. Completing setup does not create mentions or improve visibility by itself.
## Entry path
Open a store project → **Grow** → **SEO** → **AI visibility** → **Open**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
A new store must complete the SEO publication prerequisite before using reports. The sample-data preview is illustrative; no analysis result is shown here.
## Before you start
If SEO shows the first-store setup checklist, complete its publication requirement before expecting report data. Values labeled **Preview · sample data** are examples, not your store’s results. The steps below are conditional on the corresponding report becoming available.
- Publish the storefront and complete the main SEO eligibility step.
- Verify that Runner detects the public storefront domain you intend to track; setup does not provide a separate editable brand field.
- Add only relevant competitors so share-of-voice comparisons remain useful.
- Connect Google Search Console only if the optional entry is available and you want to authorize it.
## Controls and click results
| Control | What happens after you select it |
| --- | --- |
| Detected storefront | Shows the public store that setup will use as its starting target. |
| Competitor fields in setup | Adds comparison brands to the setup choices; entering a name does not run a lookup. |
| Starter prompt preview | Shows example prompt ideas for setup. Previewing them does not run or save prompt results. |
| Google Search Console → **Connect** | Opens **Apps** for the optional Google Search Console connection. |
| **Continue** | Advances to the next setup step when the current input is valid. |
| **Skip for now** | Closes setup without starting Brand Lookup or creating a snapshot. |
| **Run Brand Lookup** | Opens the three-step AI Visibility setup for the detected storefront. |
| **Finish setup** | Submits the detected storefront and competitor choices, closes setup, and starts Brand Lookup. Results remain pending until the lookup completes. |
| **Ask Runner to fix this** | Opens a new Runner conversation with the saved AI-visibility evidence and its recommended improvement. It does not edit or publish the store by itself. |
| **See citation gaps** | Opens an evidence-grounded Runner conversation focused on missing citation opportunities; review its suggestions before making changes. |
## Complete setup
1. Open **Grow** → **SEO**, then open the **AI visibility** card.
2. Select **Run Brand Lookup** to open setup.
3. Confirm the detected public storefront is the store you intend to review.
4. Add a small set of relevant competitors, then select **Continue**.
5. Review the starter prompt preview without treating it as a completed test, then continue.
6. Connect Search Console only if the option is useful and you are authorized to connect the account.
7. Select **Finish setup** to submit and start Brand Lookup.
8. Wait for a completed state; do not start a duplicate lookup while it is pending.
9. Read mentions, estimated AI-search volume, share of voice, queries, and cited sources together.
## Read the dashboard
- **Mentions** counts available responses or records that reference the tracked brand.
- **Share of voice** compares tracked brands within the available dataset; it is not the entire internet.
- **Queries** show questions associated with the collected results.
- **Cited sources** show pages referenced in available answers and can include sites you do not control.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Pending | The lookup was accepted but is not finished. Wait before starting it again. |
| Completed with no mentions | The result contains no brand mentions. Review the queries and sources rather than assuming setup failed. |
| Failed | Open the visible error, confirm the public target, and retry later. |
| Provider unavailable or access missing | The requested model or data source cannot be used now. Use completed sections and try again later. |
| Not enough data | The provider could not produce a reliable view for the target. Keep the site public and revisit after it has more discoverable content. |
## Check before starting the lookup
Opening setup lets you review the detected storefront and competitors. **Finish setup** starts the lookup and can use paid capacity. To review the form without a run, use **Skip for now**. After a completed lookup, confirm the target and returned evidence before interpreting the dashboard.
## Related guides
- [Prompts, keywords, and citations](./prompts-keywords-citations)
- [SEO overview](./seo-overview)
- [Search performance](./search-performance)
---
# Analytics overview
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/analytics-overview
Analytics helps you connect recorded visits, shopping activity, and sales for the selected store.
## Entry path
Open a store project → **Measure** → **Analytics**.
## Before you start
- Your plan must include the reporting surface. A plan preview does not show your measured store results.
- A published store and recorded shopper activity are needed for meaningful traffic and sales reports.
- Select the same store, period, and filters when comparing reports.
## Choose the layout you see
If your screen shows **Net Sales**, **GMV**, **Sessions**, and **Conversion Rate** above a single scrolling page, follow [the earlier dashboard instructions](#if-you-see-the-earlier-dashboard) below. If it shows grouped report navigation, use the workbench instructions that follow. If it shows **This week's report** and **More reports** above the chart, follow [the instructions for that layout](#if-you-see-the-sections-layout). The layouts have different controls.
## Choose a report
**Conditional:** If your screen shows **Storefront analytics**, use the grouped workbench below. Some workspaces still show the earlier single-page dashboard described later.
| Control | What it opens |
| --- | --- |
| **Overview** | A summary of the selected store's activity. Use an available **See details** link to inspect the underlying report. |
| **Commerce** | Commerce, funnel, product, acquisition, and goal reports. |
| **Behavior** | Page, event, journey, and other supported browsing reports. |
| **Audience** | Visitor, user, segment, and trait reports. |
| **Live page** | The available live activity view. |
| **Configure** | Tracking and other analytics configuration tools. Opening it does not create events. |
| Date selector | Refreshes the selected report for the chosen period. |
| **Compare**, when shown | Adds the supported comparison period. |
## Review your first report
1. Open **Overview** and confirm the selected store.
2. Choose a period that contains known store activity, such as **7d** or **30d**.
3. Read the visible summary, then open **Commerce** to inspect sales and funnel data.
4. Open the relevant subreport for the question you need to answer. For example, compare funnel stages before inspecting a suspected checkout problem.
5. Open **Behavior** to inspect an affected page or journey when those reports have data.
6. Return to **Overview** to compare the detail with the summary.
**Checkpoint:** You can identify the report, active period, and events behind a result. An empty report confirms neither working event collection nor a broken store.
## If you see More reports [#if-you-see-the-sections-layout]
The overview shows **Visitors**, **Revenue**, **Orders**, **Visitors who bought**, **Revenue per visitor**, and **Online now**, then the trend chart and lists of channels, products, and places. The date range, **Daily** / **Weekly**, and **Filter** sit above it.
Select **More reports** to open **All reports**, which groups every report:
| Group | Reports |
| --- | --- |
| **Sales** | **Revenue**, **Products**, **Funnels**, **Channels**, and **Goals**. |
| **Shoppers** | **Visitors**, **People**, **Segments**, **Live**, and **Map** when it is available. |
| **Store health** | **Pages**, **Events**, **Speed & errors**, **Sessions**, **Replays**, and **Tracking health**. |
| **Setup** | **Tracking**, **Feature flags**, **Custom dashboards**, **API**, **Usage**, and **Settings**. Opening them does not create events. |
Search the list by report name, such as **Funnels** or **Map**. Inside a report, tabs switch to the other reports in its group, and the back arrow returns to the overview.
1. Check the date range above the chart.
2. Read the numbers at the top together. A buy rate means little without the visitor count beside it.
3. Select **This week's report** for the last full week: revenue by device, visits and days before buying, the hours people buy, and the top countries.
4. Select **More reports** and open the report for your question, such as **Channels** for where buyers came from.
A new store shows **New store** and a count of visits until enough people have visited to draw charts. A **Sample data · not your store** badge means the numbers are an example, not your results. A panel that says **Coming soon** has no data source yet; it is not a problem with your store.
## If you see the earlier dashboard [#if-you-see-the-earlier-dashboard]
Use its time-range selector, then read **Net Sales**, **GMV**, **Sessions**, and **Conversion Rate** together. Scroll to product, source, funnel, abandonment, and refund sections.
## Troubleshooting
| State | Next step |
| --- | --- |
| Dash, zero, or empty chart | Clear optional filters, try a longer period, and confirm actual visits or orders exist. |
| Upgrade notice or plan preview | Review access in Plan & Billing before diagnosing collection. |
| Report is loading | Wait for its request to finish before changing filters again. |
| One report has data and another does not | Check the event each report needs. Visits can exist before orders. |
| Report cannot load | Reload once and preserve the report name, period, and error if it fails again. |
| **This panel did not load.** | Select **Try again** when it is shown, or reload the page. Other panels still show your data. |
| Navigation entry missing | Expand **Measure** and confirm the selected workspace. See [Feature availability](../advanced/feature-availability). |
## Related guides
- [Metrics and filters](./metrics-filters)
- [Traffic and conversion](./traffic-and-conversion)
- [Troubleshoot data and publication](./troubleshoot-data-and-publication)
---
# Backlinks and site audit
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/backlinks-and-site-audit
Backlinks and Site audit help you inspect off-site references and on-site technical problems from the same SEO workspace.
> **Conditional:** Both sections require an eligible analyzed target. Link and crawl data can be incomplete, and optional Lighthouse results depend on a successful page check.
## Entry path
Open a store project → **Grow** → **SEO** → **Backlinks** or **Site health** card → **Open**. The technical report may use **Site audit** within the opened view.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
A new store must complete the SEO publication prerequisite before using reports. The sample-data preview is illustrative; no analysis result is shown here.
## Before you start
If SEO shows the first-store setup checklist, complete its publication requirement before expecting report data. Values labeled **Preview · sample data** are examples, not your store’s results. The steps below are conditional on the corresponding report becoming available.
- Publish and open the target storefront successfully.
- Complete the initial SEO analysis.
- Decide whether you need link context, a technical crawl, or both.
- Do not remove or redirect pages solely from an automated issue label; inspect the affected page first.
## Backlink controls and results
| Control or section | What it shows or does |
| --- | --- |
| **Backlinks** | Opens total links, referring domains, top domains, and top linked pages. |
| Follow / Nofollow view | Separates link types when the provider includes that information. |
| New / Lost history | Shows link changes recorded by the provider. |
| Broken backlinks | Lists links that appear to lead to an unavailable destination. |
| Spam score | Provides a provider signal for review; it is not proof that a domain is harmful. |
| **Ask Runner to audit these** | Opens a new Runner conversation with the saved backlink evidence and an audit request. It does not remove links or change the store. |
## Site-audit controls and results
| Control or section | What it shows or does |
| --- | --- |
| **Start New Audit** | Opens the crawl setup. It does not change the storefront. |
| Maximum-pages control | Limits how much of the public site the audit attempts to crawl. |
| **Include Lighthouse** | Adds supported performance, accessibility, best-practice, and SEO checks. |
| **Run audit** | Starts the configured crawl. |
| **Issues** | Lists grouped findings so you can open the explanation, recommendation, and affected pages. |
| **Pages** | Shows each crawled URL with status, title, H1, word count, image count, and response time. |
| **Fix all with Runner** | Opens a new Runner conversation with the saved audit evidence and a broad fix request. It does not edit or publish the store by itself. |
| Issue row | Opens why the issue matters, the recommendation, and affected pages. |
| **Fix with Runner** | Opens a new Runner conversation with the selected issue, affected URLs, and a fix request. It does not edit or publish the store by itself. |
## Run a focused audit
1. Open **Site audit**.
2. Select **Start New Audit**.
3. Choose a page limit appropriate for the public store.
4. Enable Lighthouse only when you need the extra page-quality checks.
5. Select **Run audit** and wait for completion.
6. Use **Issues** to start with high-impact findings, then use **Pages** to inspect the affected URLs and page-level data.
7. Open an issue and verify its affected pages manually.
8. Use **Fix with Runner** for one appropriate finding, or **Fix all with Runner** for a broad review request; both open a Runner conversation and require you to review any proposed work before accepting or publishing changes.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| No backlinks | The provider found no link data for the target; this is not proof that no links exist. |
| Lost link | The provider no longer sees a prior link. Open the source and destination before acting. |
| Crawl failed | Confirm the public URL is reachable and not blocked, then run a smaller audit. |
| Lighthouse unavailable | Use the crawl results that completed and retry the optional check later. |
| Issue count is zero | No matching issues were returned by this audit; continue normal storefront review. |
## Review existing findings before another crawl
1. Open **Backlinks** to inspect the available links and referring domains.
2. Return to the SEO overview and open **Site health**.
3. If an audit exists, select an issue and read its recommendation and affected URLs.
4. Open an affected public page and confirm the issue applies.
5. If a fix queue is shown, review the selected fix before handing it to Runner.
**Checkpoint:** You have one affected URL, supporting evidence, and a proposed correction. Selecting a finding or opening a Runner conversation does not mean the correction was applied or published.
## Related guides
- [SEO overview](./seo-overview)
- [Search performance](./search-performance)
- [Troubleshoot data and publication](./troubleshoot-data-and-publication)
---
# Metrics and filters
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/metrics-filters
Use the same period and filters to make a meaningful comparison between traffic, orders, and sales.
## Entry path
Open a store project → **Measure** → **Analytics** → report controls.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEkGsXzhdR6T0uwqnz73letZimQpFvYfSrhLM)
English callouts highlight the controls. Select the image to enlarge it.
Choose Last 24 hours, Last 7 days, or Last 30 days in the single-page Analytics date menu.
## Before you start
- Decide which question the period should answer: current activity, a recent week, or a broader trend.
- A partial current day is not directly comparable with a complete past day.
- Filter controls vary by report and by the Analytics layout available to your workspace.
## Controls and click results
First check your visible layout. The single-page dashboard offers **Last 24 hours**, **Last 7 days**, and **Last 30 days**. If your workspace instead shows the **Storefront analytics** workbench, use the controls below:
| Control | Result |
| --- | --- |
| **Today** / **Yesterday** | Selects the current or previous day. |
| **7d** / **30d** | Selects a recent weekly or monthly window. |
| Custom dates | Lets you choose the report's start and end dates. |
| **Compare**, when shown | Adds or removes a comparison period. |
| **Segment**, when shown | Narrows the report to the selected audience. |
| Additional filters | Restricts matching events or records. Use only the conditions needed for your question and respect the limit shown by the form. |
If your workspace shows the earlier dashboard, its selector offers **Last 24 hours**, **Last 7 days**, and **Last 30 days** instead.
### Controls next to More reports
If your Analytics page shows **This week's report** and **More reports** above the chart, use these controls:
| Control | Result |
| --- | --- |
| Date range | Choose **Today**, **Yesterday**, **Last 7 days**, **Last 30 days**, **Last 90 days**, **This month**, or **Custom…**. The arrows move to the previous or next period. |
| Compare option in the date range | Shows each number next to the same length of time just before it. The option reads **Compare to the 30 days before** for a 30-day range. |
| **Filter** | Narrows reports by **Source**, **Country**, **Device**, or **Product viewed**. The button at the bottom shows how many visitors match, such as **Show 136 visitors**; select it to apply the filter. |
| Filter chips | Each active filter appears above the report, next to a count such as **Showing 40 of 136 visitors**. Remove one from its chip, or select **Clear all**. |
| **Daily** / **Weekly** | Changes how the trend chart groups the days. |
**Product viewed** keeps visitors who looked at that product, so every report then describes those shoppers. Some reports, such as **Products** and **Live**, ignore the date range or filters; their controls are hidden there.
## Compare one period
1. Open the report and choose **Last 7 days** or **Last 30 days** in the single-page dashboard. In the workbench, choose **7d**, **30d**, or custom dates.
2. Wait for the report to refresh and confirm the date label matches your choice.
3. Enable **Compare** if available and check which period it uses.
4. Apply one segment or filter only when the question concerns that audience or event.
5. Confirm the selected condition remains visible before interpreting the figures.
6. Remove the condition and turn comparison off to return to the broader view.
**Checkpoint:** You can state which dates and conditions produced the displayed figures. Clearing filters should restore the broader query, even if both queries are empty.
## Read metrics with their counts
- Check recorded sessions and purchases before interpreting conversion percentages.
- Read GMV and net sales separately: they describe different sales measures.
- A sharp percentage change with a small sample needs more evidence.
- Match period lengths, filters, and metric definitions before comparing another service.
## Troubleshooting
| State | Next step |
| --- | --- |
| New period is still empty | Clear filters and confirm the store had relevant activity in that period. |
| A filter is unavailable | Use the controls supported by that report; do not assume every view has the same fields. |
| Filter limit reached | Remove an unnecessary condition before adding another. |
| Values change unexpectedly | Recheck custom dates, active segment, comparison period, and unusual orders or refunds. |
| Report fails to refresh | Reload once and keep the selected period and visible error for support. |
## Related guides
- [Analytics overview](./analytics-overview)
- [Traffic and conversion](./traffic-and-conversion)
- [Troubleshoot data and publication](./troubleshoot-data-and-publication)
---
# Prompts, keywords, and citations
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/prompts-keywords-citations
The AI visibility detail sections help you learn which questions surface your brand and which sources support the available answers.
> **Conditional:** Prompt Explorer and its models can be plan- or provider-gated. Running a prompt requests new model output and may use paid capacity; review the current workspace notice before running it.
## Entry path
Open a store project → **Grow** → **SEO** → **AI visibility** → **Open** → **Prompts**, **Keywords**, or **Citations**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
A new store must complete the SEO publication prerequisite before using reports. The sample-data preview is illustrative; no analysis result is shown here.
## Before you start
If SEO shows the first-store setup checklist, complete its publication requirement before expecting report data. Values labeled **Preview · sample data** are examples, not your store’s results. The steps below are conditional on the corresponding report becoming available.
- Complete AI-visibility setup.
- Write one focused shopper question.
- Select at least one available model.
- Use web search only when you want the model to consult current public sources.
## Controls and click results
| Control | What happens after you select it |
| --- | --- |
| Prompt field | Accepts the question to test and warns when the input is too long. |
| Model selector | Chooses which available model responses to request. |
| **Allow web search** | Lets supported models consult public web sources for this run. |
| Brand highlight | Tells the result view which brand mention to call out. It does not force the model to mention the brand. |
| **Run Prompt Explorer** | Starts the selected model requests. It does not edit the store or save a visibility improvement. |
| **Prompts** | Shows tracked or explored questions and their available results. |
| **Keywords** | Shows terms associated with the AI-visibility dataset. |
| **Citations** | Shows sources cited in available model answers. |
| **Mentions** | Shows responses or records where the tracked brand was detected. |
## Explore one shopper question
1. Open **Prompts**.
2. Enter one natural-language question a shopper might ask.
3. Select the available model or models you need.
4. Decide whether to enable **Allow web search**.
5. Optionally choose the tracked brand for highlighting.
6. Select **Run Prompt Explorer** once.
7. Wait for each requested model to finish or fail.
8. Compare the response, **Brand mentioned** or **Brand not mentioned** state, citations, and related queries.
9. Open **Keywords** and **Citations** to find recurring topics and sources.
## Interpret results safely
- One answer is a sample, not a stable ranking.
- “Brand not mentioned” describes that response, not every possible answer.
- A citation means the model referenced a source; it does not mean Runner endorses the source.
- Web-search-off and web-search-on results answer different questions and should not be treated as identical tests.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Run button disabled | Enter a valid prompt and select at least one model. |
| One model fails | Use the completed model results and retry the failed provider later. |
| No citations | The answer may not have used or returned public sources. Retry with web search only if that matches your goal. |
| Unrelated results | Make the prompt more specific about the product, audience, or buying need. |
| Provider access error | Choose an available model or ask a workspace owner about access. |
## Inspect saved evidence first
1. Open **AI visibility** from the SEO overview and choose **Citations**.
2. Inspect an available source and its associated answer. Follow the source link when one is provided.
3. Return to Runner and compare the source with the related prompt or keyword.
4. Start a new **Prompt Explorer** run only if the saved lookup does not answer your question.
**Checkpoint:** You can identify the answer and cited page behind a finding. A saved Brand Lookup and a new Prompt Explorer run are separate samples; opening saved evidence does not run another prompt.
## Related guides
- [AI visibility](./ai-visibility)
- [Search performance](./search-performance)
- [Troubleshoot data and publication](./troubleshoot-data-and-publication)
---
# Search performance
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/search-performance
Search performance helps you identify which queries and pages appear most important in the data available to Runner.
> **Conditional:** These estimates appear only after an eligible SEO analysis returns provider data. A new or low-traffic domain may have little or no data.
## Entry path
Open a store project → **Grow** → **SEO** → **Search performance** card → **Open**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
A new store must complete the SEO publication prerequisite before using reports. The sample-data preview is illustrative; no analysis result is shown here.
## Before you start
If SEO shows the first-store setup checklist, complete its publication requirement before expecting report data. Values labeled **Preview · sample data** are examples, not your store’s results. The steps below are conditional on the corresponding report becoming available.
- Complete a successful SEO analysis for the public target.
- Use the analyzed domain shown by Runner, especially when the project has more than one domain.
- Read provider estimates as directional signals; they may not match first-party analytics exactly.
## Main sections
| Section | What it means |
| --- | --- |
| Estimated organic traffic | A provider estimate of visits from unpaid search. |
| Organic keywords | Search terms for which the domain has available visibility data. |
| Domain rank | A comparative authority or visibility measure from the available provider. |
| Top 3 keywords | Keywords estimated to rank near the top of search results. |
| **Top keywords** | Queries with their available position or traffic information. |
| **Top pages** | Public pages receiving the strongest estimated organic visibility. |
| **Ask Runner** | Creates a new Runner conversation with the saved report evidence and a suggested improvement request. It does not edit or publish the store by itself. |
| **See 5 quick wins** | Creates the same evidence-grounded Runner handoff so you can ask for prioritized opportunities in chat. Review any proposed work before applying or publishing it. |
| **Analyze again** | Requests a new snapshot; it does not change content or ranking. |
## Review search opportunities
1. Open **Search Performance** after analysis completes.
2. Confirm the analyzed domain is the public storefront you intended.
3. Read the summary metrics as a baseline, not a promise.
4. Scan **Top keywords** for terms that match the products and audience.
5. Open or note the corresponding **Top pages**.
6. Compare the page content with the shopper question behind each useful keyword.
7. Make storefront changes through Runner or the store editor, then publish them separately.
8. Return later and select **Analyze again** when enough time has passed for public sources to change.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| No organic data | The provider may not have enough information for the domain. Confirm publication and try again later. |
| Keyword but no matching page | Open the page list and public site; the provider may attribute the query to a different URL. |
| Estimate differs from Analytics | Analytics records store events; SEO uses external search estimates. Align the question before comparing them. |
| Newly published content is absent | Search discovery is not immediate. Confirm the page is public and wait before refreshing. |
## Choose one reviewable improvement
Use **Keywords** and **Pages** in the opened report to connect a useful query to a public page. If **Open fix queue** is shown, inspect the proposed fix and its affected page before starting work with Runner.
**Checkpoint:** You can name the query, page, and change to review. External search figures are estimates. An optional Google Search Console connection can supply first-party clicks when available; it is not connected automatically and should not be confused with the estimates.
## Related guides
- [SEO overview](./seo-overview)
- [Backlinks and site audit](./backlinks-and-site-audit)
- [Traffic and conversion](./traffic-and-conversion)
---
# SEO overview
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/seo-overview
SEO helps you inspect how a public storefront can be discovered in search results and AI-generated answers.
## Entry path
Open a store project → **Grow** → **SEO**. The **SEO & GEO** overview links to individual reports.
## If this is your first SEO visit
The introductory tour explains the workspace; **Skip tour** opens the overview. For a new store, **Let’s get your store found** shows three setup stages: publish the storefront, automatic AI checks, and automatic keyword tracking. Start with the publication requirement.
Metrics labeled **Preview · sample data** illustrate the report format. They are not measurements from your store. The report instructions below apply after the required setup is complete and real results are available.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
A new store must complete the SEO publication prerequisite before using reports. The sample-data preview is illustrative; no analysis result is shown here.
## Before you start
- Publish the storefront unless Runner offers an eligible custom target in your workspace.
- Confirm the public page loads before starting analysis.
- Allow time for search and AI providers to have data about a newly published site.
- Treat analysis as a snapshot of available sources, not a guarantee of ranking or mentions.
## Main controls and click results
| Control | What happens after you select it |
| --- | --- |
| Overview report cards → **Open** | Opens **Search performance**, **AI visibility**, **Backlinks**, or **Site health**. |
| Fix queue or review drawer, when shown | Lets you inspect a proposed correction and its affected pages before starting work. |
| **Search Performance** | Opens organic traffic, keyword, rank, top-keyword, and top-page estimates. |
| **Backlinks** | Opens links, referring domains, link history, and link-quality views. |
| **Site audit** | Opens technical crawl and issue results. |
| AI visibility sections | Opens the dashboard, prompts, keywords, citations, or mentions when available. |
| **Analyze** | Starts analysis for the eligible target. It does not edit or publish the storefront. |
| **Analyze again** | Requests a refreshed analysis and replaces stale results when the refresh completes. |
| **Publish** | Starts the separate publication-readiness path when the store is still a draft. |
| Google Search Console → **Connect** | Opens **Apps** filtered for Google Search Console when that connection is available. |
## Start an SEO review
1. Open **Grow** → **SEO** and confirm the target on the overview.
2. If you see the publication gate, use the publication path and return only after the live URL works.
3. Read existing reports first. Select **Analyze** only when a new analysis is needed, after reviewing its current usage notice.
4. Wait for the analysis state to finish; do not repeatedly start the same analysis.
5. Open the **Search performance**, **Backlinks**, and **Site health** cards to inspect available reports.
6. Return to the overview, open **AI visibility**, and inspect its available detail sections.
7. Re-run with **Analyze again** after meaningful public changes or when Runner marks the result stale.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Publish gate | The current storefront is not eligible for public analysis. Publish and verify the live URL first. |
| Analyzing | Runner is collecting available data. Wait for completion. |
| Updated | The displayed snapshot completed successfully. |
| Stale | Public data may have changed; use **Analyze again** when a refresh is useful. |
| Partial result | Some providers returned data and others did not. Use the available sections and retry later. |
| Target unreachable | Open the public URL directly, fix access or publication, then analyze again. |
## Related guides
- [Search performance](./search-performance)
- [Backlinks and site audit](./backlinks-and-site-audit)
- [AI visibility](./ai-visibility)
- [Troubleshoot data and publication](./troubleshoot-data-and-publication)
---
# Traffic and conversion
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/traffic-and-conversion
Traffic and conversion views help you see where shoppers arrive, how far they progress, and where a journey may need attention.
## Entry path
Open a store project → **Measure** → **Analytics** → **Overview**, **Commerce**, or **Behavior** in the workbench. In the earlier dashboard, scroll below the summary cards.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvR648EFhEHcK82Y0dyL6sSr9NUGjnQeMWZJk)
English callouts highlight the controls. Select the image to enlarge it.
The single-page Analytics layout in a tutorial store with no recorded activity. The Alpha diagnostics illustration is not evidence of a store issue.
## Before you start
- Select one time range and keep it active while comparing sections.
- The store needs recorded sessions for traffic analysis and orders for sales or refund analysis.
- Use the funnel as evidence of where to inspect, not as proof of why shoppers left.
## Open the report for your question
On the single-page dashboard, keep the same period selected and scroll to **Traffic Sessions**, sources, sales over time, the funnel, abandonment, and refunds. The grouped destinations below apply only when your workspace shows the analytics workbench.
| Question | Workbench destination |
| --- | --- |
| Where did shopping stop? | **Commerce** → funnel report |
| Which products or sources contributed? | **Commerce** → product or acquisition report |
| Which page or journey needs inspection? | **Behavior** → page or journey report |
Use **See details** from the overview when it links to the relevant report. Availability and data vary by store.
If your Analytics page shows **This week's report** and **More reports** above the chart, open these reports from **More reports** instead:
| Question | Report |
| --- | --- |
| Where did shopping stop? | **Funnels** |
| Which channels and campaigns brought buyers? | **Channels**. Switch between **Last click** and **First visit** to compare which visit gets the credit. |
| Which products sell, and from where? | **Products**, then select a product for its sources, places, and products bought with it. |
| Which sources and landing pages turn visits into orders? | **Visitors**. Read each source's buy rate next to its visit count. |
| Where do buyers live? | **Map** |
| Which page do people leave from? | **Pages** → **Exit pages** |
## Sections and click results
| Section or control | What it shows or does |
| --- | --- |
| **Traffic Sessions** | Shows the visit trend in the selected period. |
| Sales-source view | Breaks down recorded sales by source when source data is available. |
| Product net-sales view | Compares product contribution to net sales. |
| **Conversion Rate** funnel | Shows progress through **Traffic**, **Add to Cart**, **Checkout**, and **Purchase**. |
| **Shopping Cart Abandonment Rate** | Summarizes carts that did not reach a completed purchase. |
| **Refund Rate** | Shows refunded activity for the reporting window. |
| Time-range selector | Recalculates every section for the new period. |
## Diagnose a drop in conversion
1. Scroll to the funnel in the single-page dashboard, or open the relevant **Commerce** report in the workbench. Select a period with enough sessions to be useful. If there is no data, check collection and the period before diagnosing conversion.
2. Check whether traffic rose, fell, or stayed steady.
3. Compare traffic sources to see whether the mix changed.
4. Find the largest drop between adjacent funnel stages.
5. If **Traffic → Add to Cart** drops, inspect product information, pricing, trust, and product-page clarity.
6. If **Add to Cart → Checkout** drops, inspect cart costs, shipping clarity, and the route to checkout.
7. If **Checkout → Purchase** drops, test the payment and checkout path without placing an unnecessary real order.
8. Review refunds separately so post-purchase problems are not hidden inside top-line sales.
**Checkpoint:** Name the stage, page, period, and supporting count before proposing a change. Open the affected storefront page to test your explanation; the funnel identifies where to inspect, not the cause of the drop.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Funnel stage is zero | No matching event reached that stage in the selected range. Confirm tracking with a safe storefront walkthrough. |
| Traffic exists but sales do not | The store received visits without a recorded purchase. Inspect the first large funnel drop. |
| Sales exist but source is blank | Source attribution was not available for those sales; do not assign a source by guesswork. |
| Refund rate changes sharply | Check the underlying order period and number of orders before drawing a conclusion. |
| Charts disagree with another service | Align date ranges, time zones, event definitions, and filters before comparing totals. |
## Related guides
- [Metrics and filters](./metrics-filters)
- [Analytics overview](./analytics-overview)
- [Search performance](./search-performance)
---
# Troubleshoot data and publication
Source: https://www.runnerai.com/docs/en/guides/analytics-and-seo/troubleshoot-data-and-publication
Use this page to identify whether a missing result comes from store state, date range, plan access, feature access, or an external data source.
## Entry paths
- Store project → **Measure** → **Analytics** for store-event data.
- Store project → **Grow** → **SEO** for public search and AI-visibility data.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
This publication requirement explains why a new store has no SEO report. Sample data is not a completed analysis.
## Before you start
- Note the exact page, store, selected period, and visible message.
- Check whether the issue affects one section or the whole page.
- For SEO, open the public storefront directly before starting another analysis.
- For Analytics, confirm the selected period could contain the event you expect.
## Controls and click results
| Control | What happens after you select it |
| --- | --- |
| Analytics time range | Refreshes the report for the selected period; it does not create missing traffic or order events. |
| **Analyze** | Starts the available SEO or AI-visibility analysis for the current public target. |
| **Analyze again** | Requests a new snapshot after a meaningful public-site change. |
| **Retry** | Repeats the failed section or request when offered; it does not fix publication, access, or provider prerequisites. |
## Troubleshooting
| What you see | Likely meaning | Next step |
| --- | --- | --- |
| Upgrade or plan screen | The current plan does not include the page. | Review plan access; repeated reloads will not unlock it. |
| Navigation entry is missing | The feature is not enabled for this workspace. | Treat it as conditional and ask a workspace owner or support. |
| **Publish your storefront to start analyzing** | SEO has no eligible public target. | Complete publication, open the live URL, then return to SEO. |
| Analytics dash, zero, or empty chart | No matching events exist for the selected period. | Try a longer window and verify the store has visits or orders. |
| **New store** with a visit count | Charts start once enough people have visited for the numbers to mean something. | Share the store link; the count shows how many visits are left. |
| **Sample data · not your store** | The page shows example numbers, not your results. | If you selected **View sample data**, select **Back to project data**. If the page offers **Upgrade to Pro**, your plan does not include these reports, so the samples stay until you upgrade. |
| **Coming soon** on a panel | That panel has no data source yet. | Use the other panels; this is not a store or tracking problem. |
| **This panel did not load.** | One request failed. | Select **Try again** when it is shown, or reload the page. The other panels still show your data. |
| Target unreachable | The analyzer could not load the public page. | Open the exact URL directly and resolve publication, domain, or access problems. |
| Not enough data | The provider cannot return a useful estimate yet. | Keep the site public and retry after more public activity or discovery. |
| Partial sections | Some providers completed and others failed. | Use completed results; retry only the missing section later. |
| Stale label | The saved snapshot may no longer reflect the public site. | Select **Analyze again** after meaningful changes. |
## Check Analytics data
1. Open **Analytics** and note the selected period.
2. Choose **30d** (or **Last 30 days** in the earlier layout), then clear optional filters to rule out a narrow query.
3. Confirm the live store has received real sessions.
4. Confirm orders or refunds exist before expecting sales or refund metrics.
5. Compare funnel stages to see which events are present.
6. Reload once. If the whole page still fails, record the store and time range for support.
## Check SEO publication and analysis
1. Open the public storefront in a separate tab.
2. Confirm it loads without a private preview or sign-in requirement.
3. Return to **SEO** and confirm the intended domain or target.
4. Select **Analyze** or **Analyze again** once.
5. Wait for a terminal result instead of starting repeated jobs.
6. If one section fails, preserve the successful sections and retry later.
## What a successful setup does not prove
- Publication does not guarantee search indexing.
- Search indexing does not guarantee traffic or a top position.
- AI-visibility setup does not guarantee a mention.
- A successful prompt run does not predict every future model answer.
- An Analytics event does not explain why a shopper acted.
## Separate report access from collection
Expand **Measure** or **Grow** before treating an entry as missing. A plan preview is not a live report. In the analytics workbench, **Configure** contains tracking and settings tools; opening it does not create shopper events. Confirm the store, period, filters, and actual activity before changing collection settings.
**Checkpoint:** Identify whether access is blocked, the query is empty, or a named request failed. An empty report alone cannot distinguish no activity from missing collection.
## Related guides
- [Analytics overview](./analytics-overview)
- [SEO overview](./seo-overview)
- [AI visibility](./ai-visibility)
- [Runner documentation](../product-guide)
---
# Apps and integrations
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations
Apps brings your store services and optional Agent Apps into one place. Use it when you
want Runner to accept payments, send store emails, work with shipping or fulfillment
providers, connect Shopify, or let the Agent use another service.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
English callouts highlight the controls. Select the image to enlarge it.
The hub shows existing connection states and available controls. Opening this page does not create a connection.
## Open Apps
From an open store, select **Apps** in the project navigation.
**Entry path:** **Project → Apps**
The page can show two sections:
- **Run your store** contains the services used by the storefront and store operations.
- **Connect your tools** contains services the Runner Agent can use while working for you.
Agent Apps and Shopify are conditional. They may be hidden or unavailable for some
workspaces. Provider requirements can also prevent a visible card from being connected.
## Page controls
| Control or state | Why it is useful | What happens next |
| --- | --- | --- |
| **Search tools** | Finds a service without scanning every card. | Runner filters the tool catalog. Clearing the field restores the list. |
| **Connect** | Starts a new connection. | Runner opens the provider-specific credentials dialog or authorization flow. The connection is not complete until the card changes state. |
| **Connecting...** | Shows that Runner is processing the request. | The action stays unavailable until the request succeeds, fails, or is cancelled outside Runner. |
| **Connected** or a connected action | Confirms that Runner recognizes the connection. | Provider-specific cards can expose a dashboard link, disconnect control, switch, or management dialog. |
| **Manage** | Opens an existing Agent App connection. | You can review its tools or disconnect it. |
| **Reconnect** | Repairs a connection that needs authorization again. | Runner restarts the provider's connection flow. |
| **Pending review** | Shows that Stripe is still reviewing the account. | Wait for the status to change or follow any action request shown on the card. |
| Delete or **Disconnect** | Removes a connection after confirmation. | The provider-specific warning explains which projects and future actions will be affected. |
### Video: The Apps page and its groups
The recording opens Apps on a store with one connection, shows the **Run your store** group for payments, shipping and email, and ends on **Request an app**. The Stripe card in it shows an incomplete setup, which is the state of the recorded store and not a fault in the page. It does not connect, reconnect, or disconnect anything.
## Find an existing connection or request a tool
Use the **Connected** strip to open an already connected app and review its management controls. To find a new Agent App, scroll to **Connect your tools** and use **Search tools**. Clear the search before deciding an app is absent.
**Request an app** opens a request form. Sending a request does not connect a provider or make it immediately available. CJ supplier connections start in [Dropshipping](/en/guides/apps-and-integrations/cj-dropshipping), not an Apps card.
## Connect an app safely
1. Open **Project → Apps**.
2. Search for the service or find it under **Run your store** or **Connect your tools**.
3. Select **Connect**.
4. Read the dialog before entering a domain, API key, secret, or provider credentials.
5. Complete any authorization step on the provider's site.
6. Return to Apps and check the card. Treat only a confirmed connected state, such as a connected badge or connected controls, as a completed connection.
7. If Runner shows **Reconnect**, **Pending review**, or an action notice, follow that state instead of repeating the initial setup blindly.
:::warning
Never paste API keys or secrets into a Runner chat. Enter them only in the integration
dialog that asks for them.
:::
## Choose a guide
- [Connect, manage, reconnect, or disconnect an app](/en/guides/apps-and-integrations/connect-manage-reconnect)
- [Connect Stripe for payments](/en/guides/apps-and-integrations/stripe-payments)
- [Enable store email](/en/guides/apps-and-integrations/resend-email)
- [Connect Shippo for shipping](/en/guides/apps-and-integrations/shippo-shipping)
- [Connect Shopify](/en/guides/apps-and-integrations/shopify)
- [Connect CJ from Dropshipping](/en/guides/apps-and-integrations/cj-dropshipping)
- [Connect 4PX fulfillment](/en/guides/apps-and-integrations/4px-fulfillment)
- [Connect and control Agent Apps](/en/guides/apps-and-integrations/agent-apps)
- [Troubleshoot an app connection](/en/guides/apps-and-integrations/troubleshooting)
---
# Connect 4PX fulfillment
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/4px-fulfillment
Connect 4PX when you want Runner to use your 4PX account for cross-border shipping and
fulfillment. This connection requires both an API key and an API secret.
## Before you start
**Entry path:** **Project → Apps → Run your store → 4PX**
You need:
- a 4PX account with a current API key and API secret;
- authority to use those credentials for this Runner store; and
- awareness that disconnecting removes both credentials and disables 4PX for this store only. Other stores keep their own 4PX connection.
Treat both fields as secrets. Do not paste them into Runner chat.
On mobile, select the **4PX** provider row first to open its details, then use the controls in that dialog. A visible setup form only shows where to begin; the connection and provider-operation steps below apply after you authorize the service.
## 4PX controls and results
| Control | Why it is useful | What happens next |
| --- | --- | --- |
| **Connect** | Opens 4PX setup. | Runner asks for **4PX API Key** and **4PX API Secret**. |
| API key and secret fields | Identify and authorize the 4PX account. | Runner only submits after both fields contain a value. |
| Eye icons | Help check a typing mistake in either field. | Each icon independently toggles that field between hidden and visible text. |
| Dialog **Connect** | Submits both credentials. | On success, Runner clears both fields, closes the dialog, and marks 4PX connected. |
| **Cancel** or close | Stops before submission. | Runner clears both fields from the dialog. |
| Delete or **Disconnect** | Starts removal. | Runner opens **Disconnect 4PX?**. |
| Confirmation **Disconnect** | Removes this store's credentials. | Runner disables 4PX for this store. Other stores are not affected. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGp76tmTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
English callouts highlight the controls. Select the image to enlarge it.
Review the two credential fields before connecting. This example stops before submission; it does not verify fulfillment or a shipment.
## Connect 4PX
1. Open **Project → Apps**.
2. Find **4PX** and select **Connect**.
3. Copy the API key and API secret from the 4PX account you intend to use.
4. Paste them into **4PX API Key** and **4PX API Secret**.
5. Check that the two values are in the correct fields.
6. Select **Connect**.
7. Wait for **4PX connected successfully** and confirm the card shows its connected
disconnect control.
8. Verify a safe cross-border shipping or fulfillment scenario before using it for a live
customer order.
## Disconnect or replace credentials
Select the disconnect control and read **Disconnect 4PX?**. Confirm only when disabling 4PX for this store is acceptable. Other stores in the workspace keep their own connection.
To rotate credentials, disconnect the current connection, confirm the card is no longer
connected, then reconnect with the replacement key and secret.
## If 4PX does not connect
- Confirm that the key and secret came from the same 4PX account.
- Re-copy both values instead of editing either secret by guesswork.
- **Failed to connect 4PX** means Runner did not finish the provider connection. Verify the
credentials in 4PX and retry.
- If the card connects but fulfillment fails, check account access, destination support,
and the order data required by 4PX.
- If disconnecting fails, assume the current credentials remain active.
## Related guides
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Connect Shippo for shipping](./shippo-shipping)
- [Troubleshoot an app connection](./troubleshooting)
---
# Connect and control Agent Apps
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/agent-apps
Agent Apps let the Runner Agent use an external service while working on your project. You
can inspect the app's tools and turn off tools you do not want the Agent to use.
## Before you start
**Entry path:** **Project → Apps → Connect your tools**
Agent Apps are conditional. The section can be hidden, an individual app can be
unavailable, or the catalog can fail to load. Availability can vary by workspace, project,
provider, and staged product access.
You need:
- access to the project;
- an account or credential accepted by the selected provider; and
- permission to let Runner use the tools you leave enabled.
Review every tool before connecting. Tool access applies to the current project and can
allow the Agent to read or change data in the external service.
The external account connection belongs to your signed-in Runner account, while tool switches
are saved for the current project. Disconnecting can therefore remove the connection used by
other projects even though their tool choices are separate.
Start under **Connect your tools**. Open an app, read its tool list, then close the details if you are only comparing capabilities. Authorization is a separate decision; reviewing tools does not connect the external account.
## Find and inspect an app
| Control or state | Why it is useful | What happens next |
| --- | --- | --- |
| **Search tools** | Filters the tools catalog. | The catalog shows matching names and descriptions. |
| Category selector | Narrows the Agent Apps catalog. | Choose **All** to remove the category filter. |
| **Previous** and **Next** | Moves through a long catalog. | Runner shows the preceding or following page of matching apps. |
| App card | Shows the app name, description, and connection state. | Selecting it opens **App details**. |
| **No apps found** | Shows that current filters have no match. | **Clear search** resets the search and category. |
| Loading placeholders | Shows that Runner is fetching the catalog. | Wait for cards before choosing an app. |
## App details controls
| Control or state | Why it is useful | What happens next |
| --- | --- | --- |
| App description and category | Helps confirm you opened the intended service. | No external access is granted by viewing details. |
| Tool switch | Limits what Runner can ask the connected app to do. | Before connecting, Runner saves your choices with the connection. After connecting, a change is saved immediately. |
| **Previous** and **Next** in the tool list | Reviews apps with many tools. | Moves through tools without closing the dialog. |
| Required credential fields | Supports apps that do not use browser authorization. | **Connect** remains unavailable until required fields are filled. Secret-like fields are masked. |
| **Connect** | Submits provider credentials when that strategy is required. | Runner attempts the connection with your chosen tool access. |
| **Connect & Authorize** | Starts provider authorization. | Runner opens an authorization window. |
| **Connecting...** | Shows that authorization is in progress. | The action remains unavailable until Runner receives a result. |
| **Connected** | Confirms Runner recognizes the account. | Close the dialog or manage tool access. |
| **Manage** | Reopens a connected app. | Review and change its enabled tools or disconnect it. |
| **Disconnect** | Starts removal. | Runner asks **Are you sure you want to disconnect?** |
| **Cancel** or **Confirm** | Resolves the disconnect warning. | Cancel keeps access; Confirm removes the account-level Agent App connection from Runner. Project tool settings are separate. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgkttueHjXIfFwWx7Qu1lJBZMSPHcazYdR0voC)
English callouts highlight the controls. Select the image to enlarge it.
Review tools one page at a time with **Next**. Opening this list does not authorize Notion; **Connect & Authorize** starts that separate step.
## Connect an Agent App
1. Open **Project → Apps** and scroll to **Connect your tools**.
2. Search for the app or choose a category.
3. Select the app card to open **App details**.
4. Read its description and inspect every available tool.
5. Turn off any tool Runner should not use in this project.
6. Enter required provider credentials or select **Connect & Authorize**.
7. Complete the provider step. If your browser blocks the authorization window, allow the
popup for Runner and start again.
8. Return to the dialog and confirm it says **Connected**.
9. Select **Manage** later to review tool access or disconnect the app.
The connection dialog states that provider credentials are sent through the connection
service and are not stored by Runner. You should still treat every credential as a secret
and enter it only in the app's credential fields.
## Change tool access
1. Select **Manage** on the connected app.
2. Find the tool you want to change.
3. Turn its switch on or off.
4. Wait for **Tool enabled** or **Tool disabled**.
5. If Runner shows **Failed to update tool**, leave the dialog open, check the current
switch after it refreshes, and retry only if the saved state is clear.
Disabling a tool limits Runner's use of that tool. It does not delete data previously
created in the external service.
## Repair or disconnect a connection
If the catalog no longer shows a usable connection, open the app and start **Connect** or
**Connect & Authorize** again, then confirm **Connected**.
To remove access, select **Manage → Disconnect**, review the confirmation, and select
**Confirm**. This removes the signed-in account's Agent App connection, not only the current
project's tool access. If disconnecting fails, Runner keeps the connected state; do not assume
the external account was removed.
## If Agent Apps are missing
- The feature may not be enabled for the workspace.
- Clear search and set the category to **All**.
- Refresh Apps if the catalog never leaves its loading state.
- An individual app can report that it is not available to connect yet.
- If the tools list fails, select **Retry** inside **App details**.
- No specific catalog entry should be promised until it appears in the current workspace.
## Related guides
- [Apps and integrations overview](../apps-and-integrations)
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Troubleshoot an app connection](./troubleshooting)
---
# Connect CJ Dropshipping
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/cj-dropshipping
Connect CJ Dropshipping when you want to search, import, and operate CJ supplier products with your own CJ account.
## Before you start
**Entry path:** **Project → Dropshipping → Connect supplier**
If your project uses the older navigation, open **Store Operations → Dropshipping** instead. The current Apps page does not list CJ; use the supplier entry.
You need:
- a CJ Dropshipping account and its current API key;
- authority to connect it to the organization; and
- a safe sample product for checking the connection before relying on it.
Keep the API key private and enter it only in Runner's CJ connection dialog. Disconnecting removes supplier authorization from merchant-owned CJ imports until you reconnect.
## CJ controls and results
| Control | Why it is useful | What happens next |
| --- | --- | --- |
| **Connect supplier** | Opens the provider choices from Dropshipping. | Choose CJ Dropshipping to open API-key setup. |
| **CJ Dropshipping** provider choice | Opens CJ setup from Dropshipping. | Runner asks for **CJ API Key**. |
| **CJ API Key** | Connects your own supplier account. | The dialog accepts a non-empty key for submission. |
| Eye icon | Helps check a typing mistake. | Toggles key visibility. Hide it before sharing your screen. |
| Dialog **Connect** | Submits the key. | On success, Runner clears the field, closes the dialog, and marks CJ connected. |
| **Cancel** or close | Leaves without connecting. | Runner clears the key from the dialog. |
| Delete or **Disconnect** | Starts removal. | Runner opens a confirmation before removing the connection. |
| Confirmation **Disconnect** | Removes your key. | Future merchant-authorized CJ search, import, checkout, and supplier operations are blocked until a valid connection is restored. |
To inspect setup without authorizing CJ, open the provider choice and its empty key form, then select **Cancel**. Connecting and importing below require your own valid supplier account; a catalog preview does not verify either action.
## Connect your CJ account
1. Open **Project → Dropshipping** (or the older Store Operations entry when shown).
2. Select **Connect supplier**, then choose **CJ Dropshipping**.
3. Copy the API key from the CJ account you intend Runner to use.
4. Paste it into **CJ API Key**.
5. Select **Connect** in the dialog.
6. Wait for Runner to confirm the connection.
7. Submit a safe search or open a sample CJ product in Dropshipping to verify that the connection can access the intended catalog.
Supplier connections are shared by the organization. In **Manage suppliers**, check CJ and AliExpress separately; connecting one does not connect the other.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
English callouts highlight the controls. Select the image to enlarge it.
This example shows existing connected suppliers. It demonstrates where to inspect each connection; no connection, import, or disconnection was performed for this guide.
## Disconnect or replace the key
Read the disconnect confirmation carefully. Disconnecting removes your CJ API key. It does not transparently transfer merchant-owned imports to another CJ account.
After a disconnect, future CJ search and import require a connection. Checkout and order completion for affected merchant-owned imports fail closed when Runner cannot verify the live connection, product, variant, inventory, price, or freight. Reconnect the same CJ account and recheck the item. If its supplier identity or live data no longer matches, remove the affected product and import it again.
To replace the key, disconnect the current one, confirm that Runner no longer shows it as connected, then connect the replacement. Recheck existing CJ products before accepting new orders; changing accounts can make an existing import unavailable.
## If CJ does not connect
- Copy the API key again from the intended CJ account; do not edit it by guesswork.
- **Failed to connect CJ Dropshipping** means Runner did not accept the provider connection. Check the key in CJ and retry.
- If the dialog closes without a connected state, refresh the current page before submitting again.
- If search or import fails after connecting, confirm that this CJ account can access that catalog operation.
- If disconnecting fails, assume the existing key and account context remain active until Runner confirms removal.
- If checkout stops after reconnecting, verify that the product and variants belong to the connected CJ account; re-import the item when they do not.
## Related guides
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Connect 4PX fulfillment](./4px-fulfillment)
- [Troubleshoot an app connection](./troubleshooting)
---
# Connect, manage, and reconnect an app
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/connect-manage-reconnect
Use this guide to take one app through its connection lifecycle: start the connection,
confirm its real state, repair authorization when needed, and disconnect it safely.
**Entry path:** **Project → Apps**
## Before you start
Use it when:
- an app says **Connect**, **Connecting...**, **Reconnect**, or **Pending review**;
- you need to check whether a previous provider flow really finished;
- an Agent App needs different tool access; or
- you intend to remove a connection and need to understand the warning first.
You need access to the project and any account, credentials, or approval requested by the
external provider. Some apps are conditional and may not appear in every workspace.
On mobile, tap the provider row to open its detail dialog before choosing **Connect**. Agent Apps live under **Connect your tools**; store providers live under **Run your store**. For CJ, use the [supplier connection guide](/en/guides/apps-and-integrations/cj-dropshipping).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
English callouts highlight the controls. Select the image to enlarge it.
Identify the provider and its current state before opening setup. Existing connected controls are not evidence of a new authorization.
## Read the card before acting
| Card state or control | Meaning | What to do |
| --- | --- | --- |
| Loading indicator | Runner is checking the saved connection. | Wait before selecting another action. |
| **Connect** | Runner has no usable connection for this app. | Open the setup dialog or provider authorization flow. |
| **Connecting...** | A connection request is in progress. | Finish the provider flow or wait for Runner to return a result. |
| **Connected** | Runner recognizes a usable connection. | Use its management or disconnect control if you need a change. |
| **Manage** | The connected Agent App has configurable tools. | Open the app details and review tool access. |
| **Reconnect** | Authorization is missing, expired, or otherwise needs attention. | Start authorization again. Do not assume the old connection still works. |
| **Pending review** | Stripe has the account but has not made it ready. | Follow the status or action notice; the label is not a Connect button. |
| **Continue Onboarding** | Stripe still needs information. | Continue the existing setup instead of creating another account. |
| Delete or **Disconnect** | A connection can be removed. | Read and confirm the provider-specific impact. |
## Connect or repair a connection
1. Open **Apps** and find the app.
2. Select **Connect**.
3. Supply only the fields shown in the dialog. Depending on the app, this can be a shop
domain, an API key, a key and secret, provider credentials, or external authorization.
4. Complete the provider step, then return to Apps.
5. Confirm that the card now shows a connected badge or the provider's connected controls.
A closed dialog or provider window is not proof of success.
6. If the card shows **Reconnect** or **Continue Onboarding**, select that action and
continue the existing connection.
## Disconnect only when you want to remove access
1. To remove the app, select its disconnect control, read the confirmation, and choose
**Disconnect** or **Confirm** only when the stated workspace-wide impact is acceptable.
2. Re-open Apps and confirm the card returned to its disconnected state.
The recording opens the blank Shippo, 4PX, and Shopify forms, then closes them. No credentials are entered and no provider is connected.
## Store providers and Agent Apps differ
The providers under **Run your store** use provider-specific controls:
- **Email** uses an on/off switch.
- **Stripe** can show onboarding, review, action-required, dashboard, and disconnect
controls.
- **Shippo**, **4PX**, and **Shopify** ask for provider-specific setup
data and show a destructive disconnect confirmation.
## Connection safety
- Treat provider keys and secrets like passwords.
- Read whether a connection belongs to the workspace or only the current project.
- A provider window completing does not guarantee Runner has received a usable result.
- Do not disconnect a shipping, payment, email, or fulfillment provider during active
store operations without checking the warning and your current orders.
- If a disconnect reports an error, refresh and inspect the current state before retrying. Do not assume the provider was removed.
## Related guides
- [Apps and integrations overview](../apps-and-integrations)
- [Connect and control Agent Apps](./agent-apps)
- [Troubleshoot an app connection](./troubleshooting)
---
# Enable store email
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/resend-email
The **Email** Store App enables transactional messages from your store when email service
is available for the workspace. Use it for store events that need an automated customer
message rather than a manual campaign.
## Before you start
**Entry path:** **Project → Apps → Run your store → Email**
The card is labelled **Email** in Runner. You do not enter a Resend API key in this flow.
Availability can vary with workspace configuration, store readiness, and email support.
Before enabling it:
- confirm that you are working in the intended workspace;
- review the store's customer-facing email content where that editor is available; and
- plan to verify the complete email journey with an address you control.
On mobile, select the **Email** provider row first to open its details, then use the controls in that dialog. A visible setup form only shows where to begin; the connection and provider-operation steps below apply after you authorize the service.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
English callouts highlight the controls. Select the image to enlarge it.
Locate **Email** under **Run your store**. This overview shows the entry; no email setting was changed and no customer message was sent.
## Email controls and results
| Control or state | Why it is useful | What happens next |
| --- | --- | --- |
| Loading indicator | Prevents changes before Runner knows the saved state. | The switch appears after the current setting loads. |
| Email switch off | Shows that store email notifications are disabled. | Turning it on creates or enables the workspace email connection. |
| Email switch on | Shows that Runner has enabled the email integration. | Turning it off disconnects the integration. |
| Switch loading state | Shows that the change is being saved. | Further changes wait until Runner succeeds or fails. |
| Success message | Confirms Runner accepted the setting change. | The switch stays in the new state. |
| Error message | Shows that Runner could not enable or disable email. | The switch returns to the saved state so you can retry. |
## Enable email
1. Open **Project → Apps**.
2. Find **Email** under **Run your store**.
3. Turn the switch on.
4. Wait for **Email notifications enabled** and confirm the switch remains on.
5. If Runner tells you a new publication is required elsewhere in the product, publish
the latest store version before testing the live result.
6. Trigger an appropriate store event with safe test data and confirm the message arrives.
## Turn email off
Turn the switch off only after checking whether other stores in the workspace rely on the
same connection. Runner shows **Email notifications disabled** after the change succeeds.
If saving fails, Runner shows an error and restores the previous state.
Disabling the integration does not describe what happens to already-sent messages. It
only changes whether Runner can use the current email connection for future store events.
## If email does not work
- If the card keeps loading, refresh Apps before changing the switch again.
- If enabling fails, verify that email is available for the workspace and retry once.
- If the switch is on but no message arrives, verify the store event, recipient address,
message configuration, and latest published version.
- Check spam or filtering using an address you control; do not test with a real customer's
order.
- If disabling fails, assume the previous state is still active.
## Related guides
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Troubleshoot an app connection](./troubleshooting)
- [Apps and integrations overview](../apps-and-integrations)
---
# Connect Shippo for shipping
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/shippo-shipping
Connect Shippo when you want Runner to use your Shippo account for shipping and
fulfillment. The connection uses an API key supplied by Shippo.
## Before you start
**Entry path:** **Project → Apps → Run your store → Shippo**
You need:
- a Shippo account and a current Shippo API key;
- authority to connect that account to this Runner store; and
- awareness that disconnecting Shippo removes its key and disables it for this store only. Other stores keep their own Shippo connection.
Do not paste the API key into chat or documentation.
On mobile, select the **Shippo** provider row first to open its details, then use the controls in that dialog. A visible setup form only shows where to begin; the connection and provider-operation steps below apply after you authorize the service.
## Shippo controls and results
| Control | Why it is useful | What happens next |
| --- | --- | --- |
| **Connect** | Opens Shippo setup. | Runner asks for **Shippo API Key**. |
| **Shippo API Key** | Identifies your Shippo account. | Runner checks the key format and shows an error while the value is invalid. |
| Eye icon | Lets you inspect the value for typing mistakes. | Toggles the field between hidden and visible text. Hide it again before sharing your screen. |
| Dialog **Connect** | Submits the key. | On success, Runner closes the dialog, clears the field, and changes the card to connected. |
| **Cancel** or close | Leaves setup without submitting. | Runner clears the entered key from the dialog. |
| Delete or **Disconnect** | Starts removal. | Runner opens **Disconnect Shippo?** for this store. |
| Confirmation **Disconnect** | Removes this store's connection. | Runner removes the API key from this store and disables Shippo for it. Other stores are not affected. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg2lkPdDEah7FSPqAV903v8Lem6fdQJcxZEiXo)
English callouts highlight the controls. Select the image to enlarge it.
The empty form shows where a Shippo key belongs. Select **Cancel** to leave without submitting credentials; shipping operations need a separate check after connection.
## Connect Shippo
1. Open **Project → Apps**.
2. Find **Shippo** and select **Connect**.
3. Copy the API key from the Shippo account you intend to use.
4. Paste it into **Shippo API Key**.
5. If Runner reports an invalid key, return to Shippo and copy it again rather than editing
the secret by guesswork.
6. Select **Connect** in the dialog.
7. Wait for the success message and confirm the card shows its connected disconnect
control.
8. Use safe test data to verify the shipping workflow before relying on it for customer
orders.
## Disconnect or replace the key
Select the card's disconnect control and read **Disconnect Shippo?**. Confirm only when it is acceptable to remove the key and disable Shippo for this store. Other stores in the workspace keep their own connection.
To use a different key, disconnect the current integration, confirm the card is no longer
connected, then complete the connection workflow with the replacement key.
## If Shippo does not connect
- **Invalid API key** means the value does not match the accepted Shippo key format.
- **Failed to connect Shippo** means Runner did not finish the provider connection. Keep
the key private, confirm it is current in Shippo, and retry from the card.
- If the dialog closes but the card does not connect, refresh Apps before submitting again.
- If disconnecting fails, assume the existing key is still active.
- A connected card does not prove that rates, labels, carriers, or a specific shipment
work. Verify those operations separately with safe test data.
## Related guides
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Connect 4PX fulfillment](./4px-fulfillment)
- [Troubleshoot an app connection](./troubleshooting)
---
# Connect Shopify
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/shopify
Connect Shopify when your storefront or Runner workflow needs access to an existing
Shopify store. Runner starts authorization from the store's `myshopify.com` domain and
Shopify asks you to install and authorize the Runner app.
## Before you start
**Entry path:** **Project → Apps → Run your store → Shopify**
You can also choose **Connect Shopify** when creating a store from the workspace. This
guide focuses on the connection card under Apps.
You need:
- Shopify integration availability in the workspace;
- a Shopify store domain in the form `your-store.myshopify.com`;
- permission to install and authorize the Runner app in that Shopify store; and
- authority to connect the store to the Runner workspace.
A workspace that already has a connected Shopify store can require you to disconnect it
before connecting another one.
On mobile, select the **Shopify** provider row first to open its details, then use the controls in that dialog. A visible setup form only shows where to begin; the connection and provider-operation steps below apply after you authorize the service.
## Shopify controls and results
| Control | Why it is useful | What happens next |
| --- | --- | --- |
| **Connect** | Opens Shopify setup. | Runner asks for **Shop domain**. |
| **Shop domain** | Identifies the exact Shopify store. | Runner accepts the `your-store.myshopify.com` format and shows an error for an invalid domain. |
| **Continue to Shopify** | Starts provider authorization. | Runner redirects to Shopify to install the Runner app and authorize access. |
| **Cancel** or close | Stops before authorization. | Runner closes the dialog and clears the entered domain. |
| **Connecting...** | Shows that the authorization redirect is starting. | The action remains unavailable while Runner leaves for Shopify. |
| Delete or **Disconnect** | Starts removal. | Runner opens **Disconnect Shopify?**. |
| Confirmation **Disconnect** | Removes Runner's Shopify connection. | Runner removes the Shopify storefront token from all workspace projects. The Shopify store and its orders are not deleted. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgzy8MJHxvQbMAZ2hlg7w6ye8S5vnLIHkGPOqr)
English callouts highlight the controls. Select the image to enlarge it.
Enter the permanent Shopify domain when you are ready to authorize access. This example stops before **Continue to Shopify**.
## Connect Shopify
1. Open **Project → Apps** and find **Shopify**.
2. Select **Connect**.
3. Enter the store's exact `myshopify.com` domain in **Shop domain**.
4. Correct any invalid-domain message before continuing.
5. Select **Continue to Shopify**.
6. On Shopify, verify the store name and requested access before authorizing the Runner
app.
7. Return to Runner and confirm the Shopify card shows its connected disconnect control.
8. Verify the intended store data and checkout path before making live changes.
## Disconnect or change stores
Select the disconnect control and read **Disconnect Shopify?**. Confirming removes the
Shopify storefront token from all projects in the workspace. It does not delete the
Shopify store or existing Shopify orders.
To connect a different Shopify store, disconnect the existing workspace connection first,
confirm the card is no longer connected, then repeat setup with the other store's domain.
## If Shopify does not connect
- Use the permanent `myshopify.com` domain, not a custom storefront domain.
- If Runner says the workspace already has a connected store, review that connection
before removing it.
- If Shopify rejects authorization, start again from the Shopify card.
- If the returned store does not match the domain you entered, stop and verify which
Shopify account and store are open.
- If the connection link expired, start over from **Connect** rather than reusing the old
provider page.
- If Runner reports that required access is missing, review the app permissions in Shopify.
- If disconnecting fails, assume the existing connection is still active.
## Related guides
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Troubleshoot an app connection](./troubleshooting)
- [Apps and integrations overview](../apps-and-integrations)
---
# Connect Stripe for payments
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/stripe-payments
Connect Stripe when you want a published Runner store to accept customer payments. Runner
shows the connection state, while Stripe collects and reviews the business information
needed for payment and payout access.
## Before you start
**Entry path:** **Project → Apps → Run your store → Stripe**
After publishing, Runner can also show **Connect Stripe** in the store handoff. That button
opens the same payment setup journey.
You need:
- permission to manage the workspace connection;
- the business and identity information Stripe requests; and
- a browser that allows the Stripe setup window to open.
The storefront can be published while checkout is still paused or being checked. A live
store URL is not proof that payments are available.
On mobile, select the **Stripe** provider row first to open its details, then use the controls in that dialog. A visible setup form only shows where to begin; the connection and provider-operation steps below apply after you authorize the service.
## Stripe controls and results
| Control or state | Why it is useful | What happens next |
| --- | --- | --- |
| **Connect** | Starts payment onboarding. | Runner opens a Stripe-hosted setup flow in a new window. |
| **Connecting...** | Shows that Runner is preparing the Stripe account or setup link. | The action remains unavailable until Runner returns a result. |
| **Reconnect** | Resumes an account that exists but is not ready. | Runner opens a fresh onboarding link for the existing account. |
| **Pending review** | Shows that Stripe is reviewing submitted details. | The label is informational; follow any separate action notice. |
| **Stripe actions required** | Lists information or verification that needs attention. | Review **Due now**, **Due later**, **In review**, **Payments paused**, or **Payouts paused** details. |
| **Continue Onboarding** | Completes outstanding Stripe requirements. | Runner opens Stripe for the existing account. |
| Open Stripe Dashboard icon | Lets you manage an enabled account at Stripe. | Opens the connected Stripe dashboard in a new tab. |
| Delete icon | Starts disconnection. | Opens **Disconnect Stripe?** instead of removing it immediately. |
| **Disconnect** | Confirms removal from Runner. | Runner disconnects Stripe from the workspace. Existing orders are not affected. |
## Connect Stripe
1. Open **Project → Apps**.
2. Find **Stripe** under **Run your store**.
3. Select **Connect**. Runner opens Stripe in a new window.
4. Complete only the steps shown by Stripe.
5. Return to Runner and re-open Apps.
6. Confirm the card shows its connected controls and that Runner reports payment setup as
ready before expecting checkout to accept payments.
7. If you see **Reconnect**, **Continue Onboarding**, **Pending review**, or **Stripe
actions required**, follow that state instead of starting over.
8. Test the live checkout only after Runner reports that payment setup is ready.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgdRbFueMh3McYFndyrWQxNbi4IRHOVuEC8JtX)
English callouts highlight the controls. Select the image to enlarge it.
An existing connection can show these management controls. This screenshot does not verify checkout, payments, or payouts; it shows where to inspect the connection.
## Understand the result
| State | What it means for you |
| --- | --- |
| Not connected | Checkout still needs a payment provider. |
| Reconnect required | A Stripe account exists, but its authorization or onboarding is incomplete. |
| Pending review | Stripe has received details but has not made the account ready. |
| Actions required | Stripe needs specific information, or payments or payouts may be paused. |
| Connected | Runner recognizes the Stripe connection. Verify the live checkout before announcing that payments are available. |
## Disconnect or reconnect
To disconnect, select the delete icon, read **Disconnect Stripe?**, then choose
**Disconnect**. The confirmation states that existing orders remain. New checkout payments
can remain unavailable until a usable payment connection is restored.
To reconnect, select **Reconnect** or **Continue Onboarding**. Runner reuses the existing
account when possible; do not create a second setup simply because the first provider
window was closed.
## If Stripe does not connect
- If the setup window closes early, return to Apps and use **Reconnect**.
- If Runner shows **Stripe actions required**, complete the listed provider requirements.
- If the account remains **Pending review**, do not repeatedly create new onboarding
attempts.
- If Runner shows a connection or link error, retry from the Stripe card after confirming
your browser allows the new window.
- Never send identity documents, account IDs, or payment details in Runner chat.
## Related guides
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Troubleshoot an app connection](./troubleshooting)
- [Apps and integrations overview](../apps-and-integrations)
---
# Troubleshoot app connections
Source: https://www.runnerai.com/docs/en/guides/apps-and-integrations/troubleshooting
Use this guide when an app does not load, connect, reconnect, save its tool access, or
disconnect as expected. Start from the state Runner actually shows rather than repeating a
provider flow blindly.
**Entry path:** **Project → Apps**
## Before you start
1. Confirm that you opened Apps for the intended project and workspace.
2. Clear **Search tools** and any Agent Apps category filter.
3. Refresh the page once and wait for connection states to load.
4. Read the exact card state: **Connect**, **Connecting...**, **Connected**, **Reconnect**,
**Pending review**, or an action-required notice.
5. Open only the recovery action that matches that state.
6. Never include an API key, secret, identity document, payment detail, or full provider
callback URL in a support message or screenshot.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgJFpud5MziL9zFEdkGCVveD1jTZUlSay3IctK)
English callouts highlight the controls. Select the image to enlarge it.
Search narrows the tool catalog. If your tool is missing, clear the search and filters before requesting an app; a search result is not an authorized connection.
## Important controls and results
| Control | What happens after you select it |
| --- | --- |
| **Clear search** | Removes the current Agent Apps search so the available catalog can appear again. |
| **Connect** / **Connect & Authorize** | Opens the setup or external authorization flow for that app. |
| **Reconnect**, when shown | Restarts authorization for an existing provider connection. |
| **Retry** | Repeats the failed catalog, tool-list, or connection request shown by the current panel. |
| **Continue Onboarding** | Returns to the existing Stripe onboarding flow when action is required. |
| **Disconnect** | Opens a confirmation or starts the documented removal flow; verify the saved state before changing provider-side credentials. |
## Symptom and recovery table
| What you see | Likely meaning | Safe next action |
| --- | --- | --- |
| App is missing | Search, a category, workspace access, or a conditional feature is hiding it. | Clear search, choose **All**, then confirm the feature is available for this workspace. |
| Card keeps loading | Runner has not resolved the saved connection. | Refresh Apps once. Avoid submitting another connection while the state is unknown. |
| **No apps found** | No Agent App matches the current filters. | Select **Clear search**. |
| **Connect** does nothing | A required field is empty or invalid, or the provider flow could not start. | Read field errors, re-copy the required value, and allow provider popups when applicable. |
| **Connecting...** does not finish | The external authorization was closed, blocked, or never returned a result. | Return to Apps, refresh the state, then use **Reconnect** if Runner offers it. |
| Provider says success but Runner does not | Runner has not confirmed a usable connection. | Re-open Apps. Treat only **Connected** as success; use **Reconnect** instead of creating duplicates. |
| **Reconnect** | Existing authorization needs attention. | Select it and complete the provider flow again. |
| **Pending review** | Stripe is reviewing submitted details. | Follow action notices; do not start another account merely to remove the label. |
| **Stripe actions required** | Stripe needs information or has paused a capability. | Review **Due now**, **Due later**, **In review**, payment, and payout notices, then use **Continue Onboarding** when shown. |
| API key or secret rejected | The value is wrong, expired, from the wrong account, or not accepted for this integration. | Re-copy it from the provider. Do not edit secrets by guesswork. |
| Shopify domain invalid | The value is not the permanent Shopify store domain. | Use `your-store.myshopify.com`, not a custom storefront domain. |
| Agent App authorization window is blocked | The browser prevented the external flow. | Allow popups for Runner and start **Connect & Authorize** again. |
| Agent App tools fail to load | Runner could not retrieve that app's tool list. | Select **Retry** in **App details**. |
| Tool switch reports failure | The new tool setting was not saved. | Wait for the switch to refresh, confirm its current state, then retry once. |
| Disconnect reports failure | Runner did not confirm removal. | Assume the existing connection is still active and re-open Apps before trying again. |
## Provider-specific checks
### Stripe
- Continue an existing onboarding attempt with **Reconnect** or **Continue Onboarding**.
- Read action requirements instead of relying only on the card color.
- A published storefront can still have payments paused or unavailable.
- Use the Stripe dashboard action only after Runner has an associated account.
### Email
- A failed switch change returns to the saved state.
- An enabled switch does not prove that a particular email was delivered.
- Verify the store event, recipient, email configuration, and currently published version
with safe test data.
### Shippo
- Re-copy the Shippo API key from the intended account.
- A connected card does not verify rates, carriers, labels, or shipment creation.
### Shopify
- Use the permanent `myshopify.com` domain.
- If a workspace already has a store connected, review it before disconnecting.
- Restart authorization when the connection link expires or the returned store does not
match the domain you entered.
### CJ Dropshipping
- Confirm the API key belongs to the CJ account you intend to use.
- After disconnecting, future merchant-authorized CJ search, import, checkout, and supplier
operations are blocked until you restore a valid connection.
- Reconnect the same CJ account and recheck existing imports. If an item's supplier identity
or live data no longer matches, remove it and import it again.
### 4PX
- Confirm the API key and secret belong to the same account and are in the correct fields.
- A connected card does not prove that a destination or order is eligible for fulfillment.
### Agent Apps
- The entire section or an individual app can be conditionally unavailable.
- Clear filters before treating an app as absent.
- Review tool switches before reconnecting; do not grant more access merely to make setup
easier.
## Disconnect failed or produced an uncertain result
1. Keep the provider account and current store operations unchanged.
2. Re-open **Project → Apps** and check the card state.
3. If it still shows connected, treat the connection as active.
4. Do not delete provider-side credentials until you understand whether active checkout,
email, shipping, supplier, or fulfillment work still depends on them.
5. Retry the Runner disconnect only after the state is clear.
## Ask for help safely
Provide:
- the app name;
- the exact visible state and error text;
- whether the issue occurs while connecting, returning, managing tools, or disconnecting;
- the project URL without secret query values; and
- a privacy-safe screenshot if it materially shows the problem.
Do not provide the actual API key, secret, provider password, identity document, payment
details, customer data, or hidden authorization parameters.
If the desired tool is still absent after clearing search and filters, use **Request an app** (or **Request this app** in the empty result). The form requests support for a provider; it does not connect it. For CJ connection problems, open [Dropshipping supplier setup](/en/guides/apps-and-integrations/cj-dropshipping).
## Related guides
- [Apps and integrations overview](../apps-and-integrations)
- [Connect, manage, and reconnect an app](./connect-manage-reconnect)
- [Connect and control Agent Apps](./agent-apps)
---
# Automate, test, and create
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create
Open **Grow** for Automations, Creative Studio, Media Library, and Ads. Open **Measure** for Simulation and Experiments. These guides take you from setup to reviewing the resulting work.
> **Availability:** Every feature in this section can depend on a plan, workspace access, role, store state, credits, data, or provider connection. A missing entry is an availability state, not proof that the project is broken.
| Goal | Start here |
| --- | --- |
| Find and understand recurring work | [Automations](/en/guides/automate-test-and-create/automations) |
| Turn an automation on or customize its email | [Create and manage automations](/en/guides/automate-test-and-create/create-and-manage-automations) |
| Configure a shopper test or, when available, a campaign prediction | [Simulations](/en/guides/automate-test-and-create/simulations) |
| Read journeys, funnel, outcomes, and recommendations | [Simulation runs and results](/en/guides/automate-test-and-create/simulation-runs-and-results) |
| Start a controlled store experiment | [Experiments](/en/guides/automate-test-and-create/experiments) |
| Read performance and decide what to apply | [Experiment measurement](/en/guides/automate-test-and-create/experiment-measurement) |
| Generate or edit images and videos | [Creative Studio](/en/guides/automate-test-and-create/creative-studio) |
| Find and reuse generated media | [Media Library](/en/guides/automate-test-and-create/media-library) |
| Connect ad accounts and understand campaigns | [Runner Ads](/en/guides/automate-test-and-create/runner-ads) |
| Review creative performance and save inspiration | [Ad creatives and trending](/en/guides/automate-test-and-create/ad-creatives-and-trending) |
---
# Ad creatives and trending
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/ad-creatives-and-trending
Creatives helps you compare media from connected campaigns, while Trending helps you discover and organize public ad inspiration.
> **Conditional:** Both pages sit behind Runner Ads availability and plan access. Creative performance needs a supported connected account and returned campaign data. **Trending ads** can search the public Meta or TikTok library without connecting your ad account; its results depend on the external discovery source.
## Entry paths
- Store project → **Grow** → **Ads** → **Ad creatives**.
- Store project → **Grow** → **Ads** → **Trending ads**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEooJlJchdR6T0uwqnz73letZimQpFvYfSrhL)
English callouts highlight the controls. Select the image to enlarge it.
Trending opens a public-library search. Search results and connected campaign performance are different datasets.
## Before you start
- Confirm the workspace and plan can open Runner Ads.
- Connect an authorized Google or Meta account before expecting creative-performance data.
- Choose one performance question or inspiration theme so filters remain useful.
- Treat external trending data as reference material, not as your store’s measured result.
## Creatives controls and click results
| Control | What happens after you select it |
| --- | --- |
| Time range | Refreshes creative metrics for the past week, month, or broader recent period. |
| Account picker | Filters creative data when multiple supported accounts are connected. |
| Sort | Orders cards by spend, return on ad spend, clicks, impressions, revenue, click score, or convert score. |
| Metric chips | Adds, removes, or reorders the metrics shown on creative cards. |
| Creative card | Opens the creative preview and available performance details. |
## Review connected creatives
1. Open **Ads** → **Ad creatives**.
2. If the connection prompt appears, connect the authorized Google or Meta account first.
3. Select the reporting window and account.
4. Choose the sort that matches your question.
5. Keep a small set of metric chips visible so comparisons remain readable.
6. Open a creative card to inspect the asset and its available metrics.
7. Compare several creatives before deciding that one image or video caused the result.
## Trending controls and click results
| Control | What happens after you select it |
| --- | --- |
| **Meta** / **TikTok** | Switches the external ad library being browsed. |
| Keyword **Search** | Requests ads matching the submitted keyword. |
| Country, media, status, or time filters | Narrows the current library when supported by that source. |
| Sort | Reorders results using the available recency, impression, publication, or reach signal. |
| **Clear** | Removes active filters and returns to the default library query. |
| Ad card | Opens a larger preview with the details returned by the source. |
| **Impressions Index** in a Meta detail | Shows the non-negative index supplied for that external snapshot when one is available. It is not your store's measured campaign performance. |
| Star / **Save to collection** | Opens existing collections for the ad snapshot. |
| **New collection** | Creates a named collection and saves the selected ad to it after success. |
| **Collections** | Opens saved inspiration; selecting a collection shows its saved ad snapshots. |
| **Back to Trending** | Returns from collections to the discovery view. |
## Save ad inspiration
1. Open **Ads** → **Trending ads**.
2. Choose **Meta** or **TikTok**.
3. Search for a product, audience, or message theme.
4. Narrow results with only the filters needed for the question.
5. Open an ad to inspect it.
6. Select the star to open **Save to collection**.
7. Choose an existing collection or create a clearly named new one.
8. Open **Collections** to confirm the snapshot was saved.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Connection prompt in Creatives | No supported performance account is connected. Complete connection first. |
| Empty creative grid | The selected account, period, or provider returned no creatives. Broaden the filter and confirm campaigns exist. |
| Empty trending results | Clear filters or use a broader keyword; the source may have no matching data. |
| Meta detail has no **Impressions Index** | The current external snapshot has no usable value. Missing does not mean zero. |
| Empty collection | No saved snapshot is in that collection. Return to Trending and save an ad. |
| Save failed | The snapshot or collection was not confirmed. Retry after reloading the source card. |
| Strong trending ad | It is inspiration, not proof that the same creative will work for your store. Create and measure your own campaign separately. |
## Check what the card represents
In **Ad creatives**, confirm the selected account and period before comparing a card’s metrics. In **Trending ads**, confirm the external library and filters before treating an ad as relevant inspiration.
**Checkpoint:** A saved inspiration item appears in the selected collection after a successful save. It is a reference snapshot, not a campaign you have published or a measured result for your store.
## Related guides
- [Runner Ads](./runner-ads)
- [Creative Studio](./creative-studio)
- [Media Library](./media-library)
---
# Automations
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/automations
Automations help you find recurring work that Runner can perform when a listed trigger occurs.
## Entry path
Open a store project → **Grow** → **Automations**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgUokxtnwmWbL01zqS4swQkOHahZevAM9fnVpR)
English callouts highlight the controls. Select the image to enlarge it.
Automation cards show their configured status. A Live badge alone does not confirm a run or an email delivery.
## Before you start
- **Order Confirmation**, **Welcome Email**, and **Account Closed Email** work on every plan. Other automations need a plan that includes Automations; without one, turning them on opens an upgrade prompt.
- Each automation card has its own availability and status.
- Turning an automation on does not run it immediately; it waits for the trigger described by that automation.
## Library controls and click results
| Control | What happens after you select it |
| --- | --- |
| **Search** | Filters cards by words in the automation name or description. |
| **All** or a category | Shows every automation or only cards from categories such as **Customer Management**, **Store Operations**, or **Reports & Analytics**. Available categories depend on the library shown. |
| State filter | Shows **All States**, **Live**, **Paused**, **Blocked by plan**, or **Coming soon** cards. |
| Card switch | Requests **Live** when turned on and **Paused** when turned off, if the automation is available. |
| Info button | Opens **Automation details** with description, status, category, and last run. |
| Edit button | Opens **Compose email** for automations that support an email template. |
| **Retry** | Reloads the library after a load failure. |
> **Screen size:** The Info and email edit buttons are shown on wider desktop layouts. If you do not see them on a phone-sized screen, reopen Automations in a wider window.
## Find the right automation
1. Open **Automations**.
2. Search for the outcome you need, such as a customer message or report.
3. Narrow the list with a category when the result is broad.
4. Use the state filter to find live or blocked items.
5. Select the info button on a card.
6. Read the description, status, category, and last run before changing the switch.
7. If an email edit button appears, review the template before enabling the automation.
## Status meanings
| Status | Meaning and next step |
| --- | --- |
| **Live** | The automation is enabled and waits for its trigger. This does not mean it has already run. |
| **Paused** | The automation is available but will not start new triggered work until enabled. |
| **Blocked by plan** | The current plan prevents the automation from running. Review access before relying on it. |
| **Coming soon** | The card is visible for discovery but cannot be enabled. |
| **Never run** or **Last run —** | No completed run time is available for this project. |
## Troubleshooting
- If no cards match, clear **Search**, choose **All**, and choose **All States**.
- If a switch is disabled, read the card status and availability reason.
- If a switch returns to its earlier state, read the error message and reload the library before retrying.
- If the library fails to load, select **Retry** once and contact support if it repeats.
## Checkpoint before enabling
The details panel should explain the selected automation’s trigger and current status. Close it to return to the same card. A **Live** badge authorizes future triggers; use the last-run information and actual resulting message or report to check execution.
### Watch: inspect a paused automation
The recording filters to Paused, opens Review Request details, then closes them. It does not enable the automation, edit its email, or send a message.
## Related guides
- [Create and manage automations](./create-and-manage-automations)
- [Runner Ads](./runner-ads)
- [Analytics overview](../analytics-and-seo/analytics-overview)
---
# Create and manage automations
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/create-and-manage-automations
Use automation controls to decide which available workflows may run and what supported customer emails should contain.
> **Conditional:** The current page manages Runner-provided automation cards; it does not present a blank workflow builder for creating any arbitrary automation. Email editing appears only on supported cards.
## Entry path
Open a store project → **Grow** → **Automations** → choose a card.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgu7RtXsbqHvBxClMcD3zm6P2XTVQw91N0sga5)
English callouts highlight the controls. Select the image to enlarge it.
Review Request is Paused and shows no last-run time. Inspect these details before enabling the automation.
## Before you start
- Read the automation description and trigger before enabling it.
- Confirm the current plan allows the automation.
- For customer email, verify sender, subject, variables, links, and brand details before saving.
- Saving a template changes its stored configuration; it does not send a test or customer email by itself.
## Card controls and click results
| Control | What happens after you select it |
| --- | --- |
| Switch on | Changes the requested status to **Live**. Future matching triggers can start the automation. |
| Switch off | Changes the requested status to **Paused**. New matching triggers should not start it. |
| Info button | Opens the automation description, status, category, availability reason, and last-run time. |
| Email edit button | Opens **Compose email** when the card has a customizable template. |
> **Screen size:** The Info and email edit buttons are shown on wider desktop layouts. If they are absent on a phone-sized screen, use a wider window before following the steps below.
## Email controls and click results
| Control | What happens after you select it |
| --- | --- |
| **From** | Changes the stored sender value for this template. |
| **Subject** | Edits the email subject. |
| **Body** | Edits the email content. |
| **Insert variable** | Opens the supported placeholders and inserts the selected one at the current position. |
| **Preview** | Renders a preview of the current draft; it does not send the email. |
| Logo URL and accent color | Updates the branding inputs used by the template. |
| **Save** | Stores the current email settings and changes **Unsaved** to **Saved** after success. |
| Preview **Retry** | Tries to render the current draft again after a preview failure. |
## Enable and customize safely
1. Select the info button and confirm when the automation runs.
2. If an email edit button is available, open **Compose email**.
3. Edit the subject and body in plain customer-facing language.
4. Insert only variables offered by the menu.
5. Select **Preview** and check the rendered content.
6. Return to **Edit** if anything is missing or unclear.
7. Select **Save** and wait for **Saved**.
8. Close the composer, then turn on the card switch only when the trigger and message are ready.
9. Return later to check the **Last run** value; a **Live** badge alone does not prove execution.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| **Unsaved** | The draft differs from the stored template. Save or close without relying on the draft. |
| **Saved** | The current template settings were stored. No email was sent by the save action. |
| Preview failed | Select **Retry**. If it repeats, check variable syntax and preserve your draft before reloading. |
| Email template not found | This card has no retrievable customization. Close the dialog and reload the library. |
| Toggle blocked | Check **Blocked by plan**, **Coming soon**, or the availability reason on the card. |
## Review the email before saving
In **Preview**, check the subject, branding, links, and variable rendering. Return to **Edit** to correct the draft. Closing without saving leaves the stored template in place.
**Checkpoint:** **Saved** confirms the template configuration. Delivery needs a matching trigger and a completed run; the preview and save actions do not send a customer email.
### Watch: inspect a paused automation
The recording filters to Paused, opens Review Request details, then closes them. It does not enable the automation, edit its email, or send a message.
## Related guides
- [Automations](./automations)
- [Media Library](./media-library)
- [Troubleshoot data and publication](../analytics-and-seo/troubleshoot-data-and-publication)
---
# Creative Studio
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/creative-studio
Creative Studio gives you a visual canvas for creating campaign and product media from a prompt, selected images, or both.
## Entry path
Open a store project → **Grow** → **Creative Studio**. The destination opens the **Creative Studio** canvas.
When the feature is enabled, a generated-image detail view in Runner chat can also offer **Open generated image in Creative Studio**, which opens the canvas with that output selected.
The image-to-image model picker shows model requirements and funding before Run. Opening the picker does not start generation.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggKevjc4IC4NbwvYeKD2nM5xTZ76dBjp0auiy)
English callouts highlight the controls. Select the image to enlarge it.
An existing example image is selected on the canvas, with prompt, model, and Run controls. Review these inputs before starting generation.
## Before you start
- Decide whether you need a new image, an image edit, a new video, or animation from an image.
- Check the selected model’s input, output, quality, limits, and funding label. The picker can show **Runner credits** or your own Fal key as the funding source; choose the source you intend to use.
- For an edit, add the source image to the canvas and select it first.
- Keep the original asset available until you approve the result.
## Generation controls and click results
| Control | What happens after you select it |
| --- | --- |
| Prompt | Describes the image, edit, motion, or video you want. |
| Model button | Opens **Choose a model**, with four modality tabs: text-to-image, image-to-image, text-to-video, and image-to-video. |
| Model search and filters | Narrows models by name, generation type, or use case. |
| Star on a model | Adds or removes that model from **Favorites**. |
| Upload images | Opens the file picker and adds supported images for canvas use. |
| **Run** | Starts a job with the current prompt, selected model, and selected canvas inputs. |
| **Generations** | Opens the background queue with running, completed, failed, and interrupted jobs. |
| **Clear completed** | Removes completed queue entries from the queue view; it does not delete saved media. |
## Canvas and asset controls
| Control | What happens after you select it |
| --- | --- |
| Asset tray | Opens generated assets from the current conversation or all project assets. |
| Asset search | Filters the asset tray. |
| **Add to canvas** | Places the selected available asset on the canvas. |
| **Focus on canvas** | Moves the viewport to that asset when it is already present. |
| **Media Library** | Opens the full saved-media page. |
| Undo / Redo | Reverses or reapplies supported canvas changes. |
| Zoom controls and minimap | Changes the viewport without changing the media itself. |
| Select item(s), then right-click | Opens the canvas context menu. Available actions change with the number and type of selected items. |
| **Product tools** | For supported image selections, opens Product Photography, Product Scene, Product Placement, Product Holding, Virtual Try-On, Remove or Replace Background, Relight, Material Concept, and Upscale workflows. One-image and two-image tools remain disabled until the required number is selected. |
| **Set as product thumbnail** | With one image selected, opens the product picker. Choosing **Use as thumbnail** uploads the image and updates that product's thumbnail and image list. |
| **Extend video** / **Remove video background** | With one video selected, opens the corresponding video workflow when it is available. |
| **Export GIF** | Converts the selected video to a downloadable GIF; a conversion error leaves the original video unchanged. |
| Duplicate / Crop / Combine images / Layer order / Download | Applies the selected canvas operation when its image count and media type requirements are met. |
| **Delete** | Removes only the selected item from the canvas. It does not delete the saved asset from Media Library. |
## Create media
1. Open **Creative Studio**.
2. Choose a model and read its input requirements.
3. For text-to-image or text-to-video, leave the canvas selection empty and write a specific prompt.
4. For image editing, use **Add to canvas** on the source image, select it, then choose an **Image-to-Image** model. For example, **Nano Banana 2 Edit** appears when available; inspect its requirements rather than assuming every model takes the same inputs.
5. For image-to-video, select the single image the model will animate.
6. Review the model funding label and current credit notice.
7. Select **Run** once.
8. Open **Generations** to follow progress while continuing other canvas work.
9. Inspect the completed output on the canvas. Generated media saves to the media library after successful generation.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Nothing queued | No current background generation is listed. |
| Pending or running | The job is still processing. Keep working and wait for completion. |
| Succeeded | The generated output is available on the canvas and in saved media. Review it before reuse. |
| Failed | The job did not produce the expected output. Read the message, correct inputs, and retry deliberately. |
| Interrupted | Processing ended before success. Confirm funding and provider access before retrying. |
| Run unavailable | Check prompt, selected images, exact input count, model access, and credits. |
| Asset unavailable | Retry loading the tray or choose another saved asset; do not rely on a broken preview. |
## Review the setup without starting a job
1. Open **Choose a model** and compare its supported input type with your task.
2. Close the picker after selecting an appropriate model.
3. Check the prompt and selected images on the canvas.
4. Read the funding notice before **Run**.
**Checkpoint:** The model, prompt, and source selection describe the intended job. Generation begins only after **Run**; the queue then provides the status, and a completed output still needs your visual review.
### Watch: review an image-edit model
The recording inspects image-to-image requirements and returns to an existing example image on the canvas. It does not start a generation.
## Related guides
- [Media Library](./media-library)
- [Ad creatives and trending](./ad-creatives-and-trending)
- [Runner Ads](./runner-ads)
---
# Experiment measurement
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/experiment-measurement
Experiment measurement helps you compare the control with the active variation before making a live-store decision.
## Entry path
Open a store project → **Measure** → **Experiments** → select an experiment → **Performance**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
English callouts highlight the controls. Select the image to enlarge it.
The publication prerequisite must be resolved before a real experiment can collect data. No experiment measurements are shown here.
## Before you start
- Confirm the experiment goal and current traffic allocation.
- Wait for a useful sample before interpreting small percentage changes.
- Review variation changes in the **Experiments** tab before considering **Apply Changes**.
- Ask a workspace owner before an action that deploys changes or stops live testing.
## Performance controls and results
| Control or section | What happens or appears |
| --- | --- |
| **Experiments** | Opens cycle messages, plans, preview, changes, and pending requests. |
| **Performance** | Opens runtime, sample size, traffic split, chart, and metric table. |
| Metric selector | Changes the chart to a supported measure such as conversion, add to cart, checkout, purchase, order value, revenue per visitor, banner clicks, cart abandonment, or error rate. |
| Control / Variation chart | Compares the recorded series for the original and experiment version. |
| Traffic control → **Update** | Saves a new experiment allocation within the allowed range. |
| **AI Insight** → **Allow** | Approves the displayed traffic suggestion. |
| **AI Insight** → **Cancel** | Dismisses that suggestion without approving it. |
| **Ask Runner AI** | Sends a message inside the experiment workspace. |
| **View Plan** | Opens the current cycle plan and to-do list. |
## Review measurement
1. Open **Performance**.
2. Confirm runtime, sample size, and traffic split before reading the trend.
3. Select the metric that matches the experiment goal.
4. Compare control and variation over the same period.
5. Check supporting metrics for error, abandonment, or revenue tradeoffs.
6. Return to **Experiments** and review the exact changes that produced the variation.
7. Read any **AI Insight** request before allowing a traffic change.
8. Choose to keep measuring, adjust traffic, stop, or prepare to apply only after reviewing both behavior and implementation.
## High-impact actions
| Action | What the first click does | What confirmation means |
| --- | --- | --- |
| **Apply Changes** | Opens **Apply Experiment Changes**. | Confirming applies the experiment changes to the main store path and starts production deployment. Review the named experiment first. |
| **Stop** | Opens **Stop Experiment** with warnings. | Confirming ends the current experiment. If experiment authorization remains enabled, Runner may start another; use project settings when you intend to disable experiments completely. |
| Traffic **Update** | Submits the new allocation. | Future eligible traffic uses the updated split after success. |
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| No cycle data | Measurement has not produced a cycle result yet. Keep the experiment running or inspect its status. |
| Unable to load metrics | Reload **Performance** and retry later; do not apply changes from missing data. |
| Flat or mixed result | The available evidence does not show a clear improvement. Continue measuring or stop without applying. |
| Traffic update failed | The current value was not stored. Reload before trying a valid allocation again. |
| Apply failed | No successful production application was confirmed. Preserve the error and verify the live store before retrying. |
## Checkpoint before changing traffic
You should be able to name the goal, sample size, active split, and exact variation before choosing an action. If either arm has no useful data, keep the result inconclusive. Opening **Performance** or a confirmation dialog does not stop the experiment or apply changes; those changes require the corresponding action to succeed.
## Related guides
- [Experiments](./experiments)
- [Simulation runs and results](./simulation-runs-and-results)
- [Metrics and filters](../analytics-and-seo/metrics-filters)
---
# Experiments
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/experiments
Experiments let Runner test controlled storefront variations against a selected business goal.
## Entry path
Open a store project → **Measure** → **Experiments**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
English callouts highlight the controls. Select the image to enlarge it.
Publish the storefront before starting an experiment. This prerequisite screen does not show a launched experiment.
## Before you start
- Publish the store and confirm it can receive real traffic.
- Choose one primary goal that matches the store’s current priority.
- Choose a traffic allocation you are comfortable assigning to experiment variations.
- Understand that launch starts an experiment process; it does not guarantee a performance gain.
## Launch controls and click results
| Control | What happens after you select it |
| --- | --- |
| Goal card | Selects the metric Runner should optimize, such as conversion, add to cart, checkout initiated, banner engagement, button click-through, or average order value. |
| Traffic slider or preset | Sets the share of eligible traffic assigned to the experiment within the allowed range. |
| **Launch Experiments** | Authorizes and starts the experiment for the selected store, goal, and traffic value. |
| Experiment title or **View Experiment** | Opens the experiment detail workspace. |
| **All Experiments**, **Running**, or **Stopped** | Filters the experiment list by status. |
## Start an experiment
1. Open **Experiments**.
2. If the publication wall appears, publish and verify the store first.
3. Read every goal and select the one tied to the decision you need.
4. Set the traffic allocation.
5. Review the store, goal, and traffic one more time.
6. Select **Launch Experiments** once.
7. Wait for the experiment card to appear.
8. Open the experiment to follow planning, changes, cycles, and measurements.
## Experiment-card controls
| Control or section | What it shows or does |
| --- | --- |
| Status badge | Shows **Pending**, **Running**, **Completed**, **Failed**, or **Cancelled**. The **Stopped** list filter groups completed, failed, and cancelled experiments. |
| Cycle and Traffic | Shows the current cycle count and allocation. |
| Preview | Shows the experiment variation when a preview is available. |
| **Changes** | Lists storefront changes associated with the latest cycle. |
| **AI Insight** | Opens a pending suggestion such as a traffic adjustment. |
| **Allow** | Approves the displayed suggestion with its current value. |
| **Cancel** | Dismisses that pending suggestion. |
| More-actions menu | Opens **Stop** and **Apply Changes** when those actions are available. |
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Publish wall | The store has no successful live deployment. Publish before enabling Experiments. |
| Waitlist or upgrade screen | The feature or plan is not available to this workspace. |
| Preparing or planning | Runner is setting up the next cycle. Wait for a plan or visible request. |
| Waiting for approval | Runner needs a decision before it can continue that suggestion. Read it before choosing **Allow**. |
| No changes yet | The current experiment has not produced a visible variation change. |
| Failed | Open the experiment and preserve the visible error for support before starting a replacement. |
## Check access before preparing a launch
If Runner shows a plan preview, sample cards illustrate the feature; they are not an experiment running on your store. Resolve the displayed access requirement before the launch steps. A publication gate is separate and requires a working live store.
**Checkpoint:** After an eligible launch, the real experiment card should identify the intended goal and allocation. Wait for recorded traffic before interpreting performance; a created card alone proves neither measurement nor improvement.
## Related guides
- [Experiment measurement](./experiment-measurement)
- [Simulations](./simulations)
- [Traffic and conversion](../analytics-and-seo/traffic-and-conversion)
---
# Media Library
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/media-library
Media Library gives you a filterable visual record of generated project images and videos that can be reused later.
## Entry path
Open a store project → **Grow** → **Media Library**. The destination opens the **Media Library** page.
You can also open it from the asset tray in [Creative Studio](./creative-studio).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgPzvLcwpojWS3a1ps2R0mnEqK6T9PkBh7u5zQ)
English callouts highlight the controls. Select the image to enlarge it.
An example image library. Choose an image to inspect its saved details; opening the library does not generate new media.
An example image detail view shows its prompt, model, and reuse controls. No product thumbnail has been changed.
### Video: The media library before anything is generated
The recording opens the library on a store that has generated no media, so it shows the empty state and the note that anything Runner makes arrives here on its own. It does not generate, rename, or apply an image.
## Before you start
- Generate or save media in a supported Runner flow.
- Know whether you are looking for an image or a video.
- For product thumbnails, confirm which product should change before completing the selection dialog.
## Library controls and click results
| Control | What happens after you select it |
| --- | --- |
| **All** | Shows every available saved image and video. |
| **Images** | Filters the grid to images. |
| **Videos** | Filters the grid to videos. |
| Media card | Opens **Image details** or **Video details**. |
| **Load more** | Fetches additional media when more items are available. |
## Detail controls and click results
| Control or field | What happens or appears |
| --- | --- |
| Type, Source, and Created | Explains what the item is, where it came from, and when it was saved. |
| Prompt and Model | Shows the generation context when it is available. |
| Title | Lets you enter a clearer reusable name. |
| **Save** | Stores a changed title; it is unavailable when nothing changed. |
| **Close** | Closes details without saving an unsaved title. |
| **Set as product thumbnail** | Opens the product selection and confirmation flow for an image. It does not apply to videos. |
| **Delete** | Opens an irreversible confirmation; only the second **Delete** removes the item. |
| Delete **Cancel** | Returns to details without deleting the item. |
## Find and inspect media
1. Open **Media Library**.
2. Choose **Images** or **Videos** when the grid is large.
3. Select a card to open details.
4. Review source, date, prompt, and model to confirm it is the intended asset.
5. Close details to return to the filtered grid.
**Checkpoint:** The detail view shows the asset you intended, with its available generation context. If the grid is empty, return to **All** before assuming media is missing.
## Rename or apply an image
1. Reopen the intended asset, enter a useful title, and select **Save**.
2. For an image that should become a product thumbnail, select **Set as product thumbnail**.
3. Choose the intended product and review the confirmation before applying the change.
4. Open the product afterward and confirm the correct image appears.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| **No media yet** | No supported media is available. Create an image or video in Creative Studio first. |
| Empty filtered view | The library has no item of that type. Return to **All**. |
| No changes to save | The title matches the stored value. Close the dialog or edit it. |
| Save failed | The new title was not confirmed. Preserve it, reload, and retry. |
| Thumbnail action absent | Only images can use the product-thumbnail flow. |
| Delete confirmation | The action cannot be undone. Choose **Cancel** unless permanent removal is intended and authorized. |
## Related guides
- [Creative Studio](./creative-studio)
- [Runner Ads](./runner-ads)
- [Automations](./automations)
---
# Runner Ads
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/runner-ads
Runner Ads brings supported ad-account reporting and campaign controls into the store project.
## Entry path
Open a store project → **Grow** → **Ads** → **Overview**. The Ads submenu also opens **Ad creatives** and **Trending ads**; these are separate views.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglh1549efCuYB97EiQHRN3LVKtUonPdvTgIM4)
English callouts highlight the controls. Select the image to enlarge it.
The unconnected Ads overview offers Google, Meta, and TikTok authorization. Selecting a provider begins connection; this screen does not confirm a connected account.
## Before you start
- Confirm the workspace has Ads access and an eligible plan.
- Use an account that is authorized to connect the ad provider.
- Know which provider and ad account belong to this business.
- Connecting starts the provider's authorization flow; it is not complete until Runner shows the connected account.
## Connection controls and click results
| Control | What happens after you select it |
| --- | --- |
| **Connect Google Ads** | Opens the secure Google authorization flow. |
| **Connect Facebook & Instagram** | Opens the Meta authorization flow. |
| **Connect TikTok Ads** | Opens TikTok authorization when that channel is enabled. |
| **Cancel connection** | Cancels a provider authorization attempt that is still pending. |
| Connection settings | Opens connected-channel status plus the controls supported by that provider, such as connect, sync, reauthorize, or disconnect. |
| Sync | Requests a fresh account list for that connection. It does not create a campaign. |
| **Reauthorize** | For TikTok, starts authorization again when this control appears and the connection requires it. |
| Disconnect | Opens a confirmation before removing Runner’s provider connection. |
## Connect an account
1. Open **Ads** → **Overview**.
2. Select the correct provider button.
3. Complete authorization in the provider window.
4. Return to Runner and wait for account synchronization.
5. Confirm the provider and account name appear in connection settings or the account picker.
6. If the connection remains pending, wait for sync or use the visible retry path.
7. Do not treat the initial button click as a completed connection.
## Dashboard controls and results
| Control or section | What happens or appears |
| --- | --- |
| Time range | Refreshes reporting for the past week, month, or broader recent period. |
| Account picker | Filters results when more than one connected account is available. |
| KPI cards | Summarize available ad metrics for the selected accounts and period. |
| Campaign table | Lists campaign metrics and supported status controls. |
| Campaign **Pause** / **Enable** | For supported Google Ads or TikTok campaigns, requests the corresponding external status change. Meta campaigns do not show this control. Use it only when authorized and confirm the returned state. |
| Trend chart | Compares selected campaign and account performance over time. |
| Activity feed | Shows available recent ad-account activity. |
| **Create Campaign** | Opens a provider choice or campaign destination only when a supported creation channel is connected. |
## Campaign creation paths
- With Google Ads connected, **Create Campaign** opens Runner’s four-step flow: **Channel & Goal**, **Plan**, **Edit Campaigns**, and **Review & Publish**.
- With TikTok Ads connected, creation opens TikTok Ads Manager in a new tab rather than an in-app TikTok wizard.
- With both available, the button opens a provider choice.
- A Meta-only connection can provide reporting but does not show a campaign-creation destination in the current flow.
- In the Google flow, **Next** advances after required fields are valid, **Back** returns to a completed step, and **Publish Campaign** sends the reviewed campaign to the provider.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Waitlist | Ads is disabled for the workspace. Joining or viewing the waitlist does not unlock it immediately. |
| Upgrade screen | The current plan cannot open the Ads workspace. |
| Authorization pending | The provider window has not completed or returned. Finish it or cancel the attempt. |
| Reauthorization required | For TikTok, open connection settings and select **Reauthorize** when shown before expecting fresh data. |
| Data temporarily delayed | Keep available partial data and retry later; avoid repeated provider requests. |
| Reporting unavailable for a channel | That connection cannot supply the requested report. Use supported channels or provider reporting. |
| Create button absent | No currently connected channel supports a creation destination. |
## Identify the screen before connecting
A waitlist means Ads is unavailable in this workspace. A plan preview can show sample reporting while real actions remain gated. A connection screen asks for the provider account needed to use reporting. Follow the connection steps only when the page offers the usable connection flow.
**Checkpoint:** After authorization, verify the exact provider and account selected in Runner. An empty campaign table may simply mean that account has no matching campaigns or data for the chosen period.
## Related guides
- [Ad creatives and trending](./ad-creatives-and-trending)
- [Creative Studio](./creative-studio)
- [Traffic and conversion](../analytics-and-seo/traffic-and-conversion)
---
# Simulation runs and results
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/simulation-runs-and-results
The run page turns generated shopper activity into evidence you can inspect before deciding whether the store should change.
> **Conditional:** A run page exists only after an eligible simulation has been launched. Results can be partial, unavailable, or failed, and generated recommendations are not applied automatically.
## Entry path
Open a store project → **Measure** → **Simulation** → select a recent simulation.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
English callouts highlight the controls. Select the image to enlarge it.
Shopper and page simulations require publication before a run. This setup screen does not contain completed journeys or results.
## Before you start
- Wait for the run to reach a completed or failed state before treating its totals as final.
- Keep the target page and selected mode in mind while interpreting results.
- Do not treat generated persona behavior as observed behavior from real shoppers.
## Run controls and click results
| Control or section | What happens or appears |
| --- | --- |
| Back link | Returns to the Simulation landing page and recent runs. |
| **Journeys** | Opens individual persona paths, decisions, steps, and available screenshots. |
| **Funnel board** | Groups shopper sessions by the furthest journey stage reached. |
| **Outcomes** | Summarizes terminal sessions, explicit exits, turn limits, and technical failures. |
| Persona or session card | Opens that generated shopper journey. |
| **View step details** | Opens the selected action, page, intention, rationale, and screenshot when available. |
| **Send to Runner** | Creates a Runner chat handoff containing the recommendation context. It does not apply the change. |
| **Validate shoppers** | Starts a same-shopper comparison run for an eligible recommendation. |
## Read a shopper-behavior run
1. Confirm the status is **Completed** or note which parts are still running.
2. Read the session totals and checkout-reach summary.
3. Open **Funnel board** to find the earliest common drop.
4. Open **Journeys** and inspect representative sessions at that point.
5. Use **View step details** to review the attempted operation and visible page state.
6. Open **Outcomes** to separate shopper exits from technical failures or turn limits.
7. Read each optimization recommendation with its evidence, affected area, risk, and validation plan.
8. Use **Send to Runner** only when you want a reviewable chat task; inspect the task before accepting changes.
## Read a page-stimulus audit
1. Wait for the aggregate report.
2. Read the intent score and the number of shopper perspectives together.
3. Review segment differences and score distribution.
4. Read friction themes and supporting comments.
5. Use the result to form a testable hypothesis, not a guaranteed conversion prediction.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Results pending | Sessions have not finished. Wait for more terminal sessions. |
| No report available | The run finished without the expected aggregate report. Preserve the run ID and contact support. |
| Replay unavailable | A replay or signed screenshot could not be loaded. Reload the run to request fresh access. |
| Technical failure | The automation could not complete that journey; exclude it from behavioral conclusions. |
| Validation queued or running | The comparison is not ready. Wait before judging the recommendation. |
| Improved, regressed, or inconclusive | The same-shopper comparison favors, harms, or cannot distinguish the suggested change within that generated test. |
## Match the result to its mode
The journey and funnel instructions above apply to shopper runs. A **Campaign prediction** run, when available, instead exposes **Society**, **Chat**, and **Report**. Read its audience assumptions and campaign inputs before the report.
**Checkpoint:** Identify whether a finding came from a generated journey, a page reaction, or a campaign prediction. None is a recorded purchase by a real customer. Keep technical failures separate from audience reactions.
## Related guides
- [Simulations](./simulations)
- [Experiments](./experiments)
- [Traffic and conversion](../analytics-and-seo/traffic-and-conversion)
---
# Simulations
Source: https://www.runnerai.com/docs/en/guides/automate-test-and-create/simulations
Simulation lets you send generated shopper personas through a live store journey or ask them to evaluate one public page.
## Entry path
Open a store project → **Measure** → **Simulation**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
English callouts highlight the controls. Select the image to enlarge it.
Shopper and page simulations require publication before a run. This setup screen does not contain completed journeys or results.
## Before you start
- For **Shopper behavior** and **Page stimulus audit**, publish the store and confirm its public pages load.
- **Campaign prediction**, when available, uses campaign inputs and does not require a published storefront.
- Review the current plan or usage notice before launching paid work.
- Choose a real storefront question and one target page.
- Treat generated shoppers as directional testing, not real customer demand.
## Modes
| Mode | When to use it | What Runner does after launch |
| --- | --- | --- |
| **Shopper behavior** | You want to observe navigation, decisions, and journey friction. | Starts multiple shopper journeys on the selected live page and prepares funnel, journey, outcome, and recommendation views. |
| **Page stimulus audit** | You want focused reactions to one page. | Collects generated shopper evaluations for purchase intent, segments, and friction on that page. |
## Controls and click results
| Control | What happens after you select it |
| --- | --- |
| Mode selector | Chooses **Shopper behavior**, **Page stimulus audit**, or **Campaign prediction** when that mode is enabled. |
| Persona guidance | Adds optional audience direction, such as price sensitivity or shipping concerns. |
| **Target page** | Opens discovered public storefront pages such as Home, Collection, Product, Cart, Checkout, or a custom page. |
| Device viewport | Chooses mobile only, desktop only, or a weighted mix for shopper behavior. |
| Panel size | Changes how many generated shopper journeys the run requests within the allowed range. |
| **Launch simulation** | Starts the configured run and opens its run page. It is disabled until a target page is selected. |
| Recent simulation card | Opens an earlier run and its current status or results. |
| **View all** | Expands the recent-run list when more runs exist. |
| **Retry** | Reloads target pages or runs after a visible failure. |
## Launch a focused simulation
1. Open **Simulation**.
2. Select **Shopper behavior** or **Page stimulus audit**.
3. Add concise persona guidance only when a specific audience matters.
4. Select **Target page** and choose a discovered live page.
5. For shopper behavior, choose the device mix and panel size.
6. Review the current usage notice.
7. Select **Launch simulation** once.
8. Follow the run page until it completes or fails.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Publish wall | No successful live deployment is available. Publish and verify the store first. |
| No target pages | Runner could not discover public pages. Open the live store and retry page loading. |
| No simulations yet | Configure the panel and target to create the first run. |
| Queued or pending | The run was accepted but has not started all work. Wait rather than launching a duplicate. |
| Running | Shopper work is still in progress; results can remain incomplete. |
| Failed | Open the error shown on the run and start a new run only after correcting the target or temporary failure. |
## Campaign prediction, when available
This mode asks generated audience members to evaluate a campaign rather than navigate a published store.
1. Open **Measure** → **Simulation** and choose **Campaign prediction** if shown.
2. Review the campaign inputs requested by the form.
3. Add the campaign you want evaluated and read the current usage notice.
4. Start the prediction only when the inputs and requested spend are correct.
5. Open the resulting workspace and inspect the available **Society**, **Chat**, and **Report** views.
**Checkpoint:** A completed report is a generated prediction for the supplied campaign. It does not launch an advertisement or measure real campaign performance. If the mode is absent, use an available mode or check [Feature availability](../advanced/feature-availability).
## Related guides
- [Simulation runs and results](./simulation-runs-and-results)
- [Experiments](./experiments)
- [Analytics overview](../analytics-and-seo/analytics-overview)
---
# Help and reference
Source: https://www.runnerai.com/docs/en/guides/help-and-reference
Start here when you know the outcome you want but the current screen does not match it.
| Situation | Guide |
| --- | --- |
| You have an error message and need the next safe step | [Error playbook](/en/guides/help-and-reference/error-playbook) |
| A button is disabled, a page is empty, an entry is missing, or Runner asks you to load the latest version | [States and availability](/en/guides/help-and-reference/states-and-availability) |
| A Runner chat task is waiting, stopped, or failed | [Troubleshoot Runner tasks](/en/guides/help-and-reference/troubleshoot-runner-tasks) |
| The storefront build or preview is wrong | [Troubleshoot storefront builds](/en/guides/help-and-reference/troubleshoot-storefront-builds) |
| Publishing, checkout, or an app is not working | [Troubleshoot publishing, checkout, and apps](/en/guides/help-and-reference/troubleshoot-publishing-checkout-apps) |
| You need a person or want to report a problem | [Support and community](/en/guides/help-and-reference/support-and-community) |
| You want to review Runner product updates | [Changelog](/en/guides/help-and-reference/changelog) |
| You have a short product question | [FAQ](/en/guides/help-and-reference/faq) |
| A Runner term is unfamiliar | [Glossary](/en/guides/help-and-reference/glossary) |
## Choose the shortest route
Use a troubleshooting guide when something failed, **Support and community** when you need help with a private account or project issue, and the FAQ, glossary, or states reference when you need a definition. For the initial setup walkthrough, start with [Build your first store](/en/guides/start-here/first-store-quickstart).
---
# Changelog
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/changelog
**What's new** keeps product releases in one place so you can see what changed without leaving Runner. The public Changelog is a separate page that needs no sign-in.
## Read the public Changelog
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRzXySfwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXk)
On the [public Changelog](https://www.runnerai.com/changelog), read the month beside **Monthly Update** and the **What’s New** section, then scroll for older updates. No sign-in is required. The month is a date label, not a filter.
Select the image to enlarge it. Annotations are in English.
The sections below describe **What's new** in the workspace, when available. Its filters, unread indicator, and return controls belong to the workspace version; they are not shown in the public timeline above.
## What this covers
You will open recent updates, filter them by type, understand the unread marker, and return to the correct store or workspace.
## Availability and prerequisites
- Sign-in is required for **What's new** in a workspace or project only; the public Changelog is available without an account.
- The unread dot appears only when Runner has an update you have not opened.
- A filter changes only the releases shown on this page; it does not change any product feature.
## Entry paths
| Entry | What happens after you select it |
| --- | --- |
| Workspace sidebar → **What's new** | Opens all available product updates inside the current workspace. |
| Desktop project avatar → **What's new** | Opens the same page while keeping the current project as the return destination. |
| Mobile project avatar → **What's new** | Opens the page from the **Profile & Settings** sheet. |
| Collapsed workspace sidebar → **What's new** icon preview → **View all** | Opens the full page after previewing the latest release. |
Opening the full page clears the unread dot. This marks the updates as seen; it does not run or enable the features described in a release.
## Filter releases
| Control | What happens after you select it |
| --- | --- |
| **All** | Shows every available release. |
| **Feature** | Shows releases categorized as new features. |
| **Improvement** | Shows releases categorized as improvements. |
| **Fix** | Shows releases categorized as fixes. |
| Release card | Shows that release's title, date, type, description, and available media. |
| **Back to Store** | Returns to the current project when **What's new** was opened there; otherwise it returns to the workspace store list. |
On mobile inside a project, the project shell provides the back control, so the page-level **Back to Store** action can be hidden.
## Review an update
1. Open **What's new** from the workspace sidebar or avatar menu.
2. Start with **All** to see releases in date order.
3. Select **Feature**, **Improvement**, or **Fix** when you need one kind of change.
4. Read the release title, date, description, and any included media.
5. Use the back control to return to the store or workspace you came from.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Red unread dot | A newer update has not been opened. Open **What's new** to clear it. |
| **Today** | The release date matches the current day. |
| No item under a filter | No available release has that category. Return to **All**. |
| Latest-release preview | Pausing over the collapsed desktop icon can show the newest update. Select **View all** for the full history. |
| Back returns to a different scope | Reopen the intended workspace or project, then open **What's new** from there so Runner has the correct return context. |
## Use a release note to find the next step
1. Open **What's new** and choose **Feature**, **Improvement**, **Fix**, or **All**.
2. Read the dated entry that matches the behavior you want to learn.
3. Return with **Back to Store** and open the relevant tool through project navigation.
**Checkpoint:** The filtered list shows the selected update category. Release notes describe changes; your workspace’s current plan and feature access determine whether you can use them.
## Related guides
- [Support and community](/en/guides/help-and-reference/support-and-community)
- [Workspace navigation and search](/en/guides/workspace/navigation-and-search)
- [Feature availability](/en/guides/advanced/feature-availability)
---
# Error playbook
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook
Copy the error you see in Runner and search for it here to find the next safe step. You can also paste the message into Runner chat and name the screen and action that produced it.
## Find your error
**Entry path:** Documentation → Help and reference → Error playbook, or use documentation search with the error text.
| Where you saw the error | Messages and recovery steps |
| --- | --- |
| Versions, preview, Design Mode, publishing, or domains | [Build, preview, and publishing errors](/en/guides/help-and-reference/error-playbook-build) |
| Creative Studio, design files, image generation, or Media Library | [Creative and media errors](/en/guides/help-and-reference/error-playbook-creative) |
| Sign-in, workspace, account, billing, chat, tasks, or attachments | [Account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat) |
| Products, imports, orders, connected apps, analytics, SEO, or automations | [Store and app errors](/en/guides/help-and-reference/error-playbook-store-and-apps) |
Search the exact wording first. If a name, number, file, or provider detail changes within the message, search the fixed part and the feature name. For a translated error without a match, ask Runner to search the English equivalent. A message such as “Something went wrong” needs the screen and attempted action to identify the right instructions.
## Before you retry
1. Keep any unsent text or unsaved edits, and note the error and the action that came before it.
2. Check whether the original action is still running or already completed. For payments, imports, publishing, invitations, and other actions outside the current screen, inspect the resulting record or destination before repeating it.
3. Follow the matching guide's recovery steps. Correct missing input, access, or connection requirements before trying again.
4. Confirm the expected result in the affected screen. A dismissed toast, a loaded preview, or a successful connection does not confirm that a separate store operation completed.
5. If the same error returns after the documented recovery, stop repeating the action and contact [Support](/en/guides/help-and-reference/support-and-community).
## Example: a version will not display
> Couldn't show this version — try again or pick another.
Runner could not load the selected historical preview. Open the [version preview recovery steps](/en/guides/help-and-reference/error-playbook-build/couldnt-show-this-version) to retry the preview or choose another version. **Restore** changes your working version; it is not a preview troubleshooting step.
## Ask Runner for help
> I see “[paste exact error]” in [screen] after [action]. Find this error in the documentation, explain what I can do next, and tell me how to check that it worked. The original action is [still running / completed / failed / unknown].
Do not include passwords, one-time codes, API keys, payment credentials, or customer information. If you need support, include the project or conversation link, the time, the screen, the exact error, and which recovery step failed. Remove private information from screenshots.
## When the message is not listed
Some errors include text returned by a connected service, so their wording varies. A generic message does not identify the cause. Use the relevant feature guide, check the service's visible connection or operation status, and contact support if the outcome is unclear. Do not disconnect a working app, delete a store, restore a version, or repeat a payment merely to clear an error.
The steps in this reference describe the conditions supported by Runner's current interface. Some errors occur only with a particular provider, account role, store type, or failed operation; their presence here does not mean your store has that problem.
## Related guides
- [States and availability](/en/guides/help-and-reference/states-and-availability)
- [Troubleshoot Runner tasks](/en/guides/help-and-reference/troubleshoot-runner-tasks)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Accounts, billing, and chat
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat
Match the message below to the action you were taking. Names, counts, and provider names in braces stand for the value shown in your error. Some server or provider errors include additional text: keep that text when asking for help.
If the same error returns after one appropriate retry, use [Support and community](/en/guides/help-and-reference/support-and-community). Include the page or conversation URL, workspace/store, exact error, approximate time, action, and what you checked. Remove passwords, sign-in codes, tokens, full payment details, and customer information. A support report is not sent until its submission succeeds.
## Find the recovery guide
- [Email sign-in](/en/guides/help-and-reference/error-playbook-account-and-chat/email-sign-in)
- [Account settings and connected sign-in accounts](/en/guides/help-and-reference/error-playbook-account-and-chat/account-settings-and-connected-sign-in-accounts)
- [Avatar upload and generation](/en/guides/help-and-reference/error-playbook-account-and-chat/avatar-upload-and-generation)
- [Workspace access and invitations](/en/guides/help-and-reference/error-playbook-account-and-chat/workspace-access-and-invitations)
- [Creating, opening, and managing stores](/en/guides/help-and-reference/error-playbook-account-and-chat/creating-opening-and-managing-stores)
- [Credits and subscription requirements](/en/guides/help-and-reference/error-playbook-account-and-chat/credits-and-subscription-requirements)
- [Checkout, billing portal, and failed payments](/en/guides/help-and-reference/error-playbook-account-and-chat/checkout-billing-portal-and-failed-payments)
- [Opening, sending, and managing chats](/en/guides/help-and-reference/error-playbook-account-and-chat/opening-sending-and-managing-chats)
- [Runner stopped or its reply is missing](/en/guides/help-and-reference/error-playbook-account-and-chat/runner-stopped-or-its-reply-is-missing)
- [Stopping work](/en/guides/help-and-reference/error-playbook-account-and-chat/stopping-work)
- [Task actions and approvals](/en/guides/help-and-reference/error-playbook-account-and-chat/task-actions-and-approvals)
- [Attachments and document processing](/en/guides/help-and-reference/error-playbook-account-and-chat/attachments-and-document-processing)
- [Screenshots, canvas images, and prompt refinement](/en/guides/help-and-reference/error-playbook-account-and-chat/screenshots-canvas-images-and-prompt-refinement)
- [Voice input](/en/guides/help-and-reference/error-playbook-account-and-chat/voice-input)
- [Feedback, clipboard, and notifications](/en/guides/help-and-reference/error-playbook-account-and-chat/feedback-clipboard-and-notifications)
- [Skill drafts and files](/en/guides/help-and-reference/error-playbook-account-and-chat/skill-drafts-and-files)
- [Research saved panels and sharing](/en/guides/help-and-reference/error-playbook-account-and-chat/research-saved-panels-and-sharing)
- [API key creation, copying, and revocation](/en/guides/help-and-reference/error-playbook-account-and-chat/api-key-creation-copying-and-revocation)
- [Recovering a deleted store](/en/guides/help-and-reference/error-playbook-account-and-chat/recovering-a-deleted-store)
- [AppSumo activation](/en/guides/help-and-reference/error-playbook-account-and-chat/appsumo-activation)
## Related guidance
- [Troubleshoot Runner tasks](/en/guides/help-and-reference/troubleshoot-runner-tasks)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# We couldn't sign that device out — it's still signed in. Please try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/account-settings-and-connected-sign-in-accounts
## Account settings and connected sign-in accounts
**Messages you may see**
- `We couldn't save your language choice — the site still works, try again in a moment.`
- `Your language didn't change. Try again.`
- `Your name didn't save. Try again.`
- `We couldn't start account deletion — your account is unchanged. Please try again.`
- `We couldn't sign that device out — it's still signed in. Please try again.`
- `Failed to load accounts`
- `We couldn't link {provider} — please try again.`
- `We couldn't unlink {provider} — it's still connected. Please try again.`
- `We couldn't save your name — please try again.`
- `We couldn't change your email — your current address still works. Please try again.`
- `We couldn't save that picture — please try another image.`
Runner could not confirm the requested account change. A failed device sign-out means that device may still have access.
1. Reopen the relevant account setting and check its current value or session list. Save any unsaved text before refreshing.
2. Retry the same intended change once. For connected sign-in accounts, complete the provider sign-in prompt and return to Runner.
3. If session revocation or account deletion still fails, contact support; do not assume access was removed.
**Check:** The saved value survives reopening settings, the provider connection matches your intent, or the targeted session disappears from the session list.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# The key is still active. Revoking didn't go through. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/api-key-creation-copying-and-revocation
## API key creation, copying, and revocation
**Messages you may see**
- `We couldn't create the key. Try again.`
- `The key is still active. Revoking didn't go through. Try again.`
The create-key error can also appear when copying a newly created key fails. A failed copy does not mean the key was never created. A failed revocation means you must treat the key as active.
1. Check whether the new-key dialog already displays a key. If it does, copy it manually into your secure destination rather than creating another key. Never include it in a support report.
2. If creation failed before a key appeared, refresh the key list before retrying creation.
3. If revocation failed, retry revoking the same key and verify the refreshed list. Contact support if it remains active.
**Check:** The intended key is listed and securely saved, or the revoked key no longer appears in the active key list.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# We couldn't activate that code. Check it and try again; you haven't been charged.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/appsumo-activation
## AppSumo activation
**Messages you may see**
- `We couldn't activate that code. Check it and try again; you haven't been charged.`
The activation form could not activate the submitted code. This fallback message says you have not been charged; preserve any more specific error shown.
1. Check the code against your purchase record and enter it again without a typo.
2. Check the intended account and workspace before retrying activation.
3. If activation still fails, contact support with the purchase reference and exact error. Do not post the full redemption code publicly.
**Check:** Runner shows the activation confirmation and the expected lifetime plan in your workspace.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# This attachment could not be uploaded. Try attaching it again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/attachments-and-document-processing
## Attachments and document processing
**Messages you may see**
- `This document could not be processed. Export it again and reattach it.`
- `This document took too long to process. Try a smaller or simpler copy.`
- `This workspace doesn't support document attachments yet. Paste your text into the message instead.`
- `This document could not be downloaded. Attach it again.`
- `This document is invalid or damaged. Export a fresh copy and attach it again.`
- `No readable content was found in this document. Try an exported text-based copy.`
- `This document is password-protected. Remove the password and attach it again.`
- `This document is too complex to process safely. Try a smaller or simpler copy.`
- `The documents in this message exceed 30 MB in total. Attach fewer files.`
- `These documents contain too much text for one message. Attach fewer files.`
- `Duplicate attachment ignored.`
- `Documents must be 10 MB or smaller; images must be 32 MB or smaller.`
- `Attach up to 10 files per message.`
- `Use a supported document or a JPG, PNG, GIF, WebP, BMP, or TIFF image.`
- `This attachment could not be uploaded. Try attaching it again.`
Attaching a file includes upload and document processing. An attachment shown with an error is not ready for Runner to read.
1. Follow the specific validation message: remove unsupported files or duplicates, reduce file size or file count, and keep combined documents within the displayed limit.
2. For a damaged document or conversion failure, export a fresh copy and reattach it. For a password-protected document, attach an unlocked copy only if you are allowed to share it.
3. For a timeout, excessive complexity, or too much text, use fewer files or a smaller, simpler document. If no readable content was found, provide a version with readable text or paste the relevant text.
4. For download or upload failures, remove the failed attachment and attach it again. If document support is unavailable, follow the alternative stated in the message.
5. Send only after the attachment finishes processing.
**Check:** The error clears and the attachment is ready before you send the message.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Your new avatar didn't save. The old one stays. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/avatar-upload-and-generation
## Avatar upload and generation
**Messages you may see**
- `Image must be 5 MB or smaller.`
- `We couldn't create that avatar. Your current one is unchanged. Try again or tweak the description.`
- `Choose an image file (PNG, JPG, GIF, or WebP).`
- `You've used all 3 avatar generations for today. Try again tomorrow.`
- `Your new avatar didn't save. The old one stays. Try again.`
- `The image didn't upload. Nothing changed. Try again.`
- `Enter a description to generate an avatar.`
- `Keep your description to {max} characters or fewer.`
Avatar validation, upload, generation, and saving are separate steps. Generating an image does not prove that it was saved as your avatar.
1. For an upload, choose a PNG, JPG, GIF, or WebP image no larger than 5 MB.
2. For generation, enter a description. If the daily quota is exhausted, wait until tomorrow or upload your own image.
3. For a transient generation failure, retry or revise the description. For a save failure, retry saving the selected avatar.
**Check:** Reopen your profile and confirm the intended avatar is displayed.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# We couldn't activate your plan
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/checkout-billing-portal-and-failed-payments
## Checkout, billing portal, and failed payments
**Messages you may see**
- `Your payment didn't go through. Check your card and try again; no credits were added.`
- `We couldn't add the credits, so we refunded your payment. Try again whenever you're ready.`
- `Your latest payment failed`
- `We couldn't open your billing portal. Try again; your plan is still active for now.`
- `We couldn't open your billing portal. Try again; nothing on your plan has changed.`
- `We couldn't activate your plan`
- `Try again. If you were charged, contact support and we'll sort it out.`
- `Failed to create billing portal session`
- `Payment method could not be verified`
- `We couldn't verify your payment method. Please update it to avoid payment issues.`
- `Payment failed`
- `Payment failed. Please update your billing info.`
- `Auto top-up payment failed`
- `{name}, update your payment method in billing, then enable auto top-up again.`
- `Auto top-up cycle limit reached`
- `{name}, auto top-up has reached this credit cycle’s spending limit. Manage the limit in billing.`
- `Price ID not found for the selected plan`
- `No checkout URL returned`
Opening checkout or the billing portal can fail before a payment happens. An activation failure after payment requires checking billing, not paying repeatedly.
1. Reopen billing and check the current plan, credit balance, and payment status.
2. If only opening the portal failed, retry opening it once.
3. For a failed or unverified payment method, update it in billing. For auto top-up payment failure, enable auto top-up again after updating the method; for a cycle limit, review the spending limit in billing.
4. If you were charged but the plan did not activate, contact support with the workspace, payment time, and receipt reference. Do not send full card details or start duplicate purchases.
5. If checkout reports a missing price or URL again after reopening billing, report the plan and billing interval to support.
**Check:** The portal opens, or Runner billing shows the expected activated plan, payment status, or credit balance.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Your store was created, but we couldn't open it. Find it in your store list, or try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/creating-opening-and-managing-stores
## Creating, opening, and managing stores
**Messages you may see**
- `We couldn't save your changes — nothing was lost, try again.`
- `Image generation failed`
- `We couldn't set up your copy of this store — nothing was created, so just try again.`
- `We couldn't create your store. Nothing was saved — try once more.`
- `Your store was created, but we couldn't open it. Find it in your store list, or try again.`
- `We couldn't load your stores. They're safe — refresh to try again.`
- `Answer three quick questions first, so Runner builds the right store for you.`
- `You're at your {limit}-store limit. Delete a store you no longer need to make room for a new one.`
- `We couldn't delete this store — it's unchanged. Try again.`
- `We couldn't delete those stores — they're unchanged. Try again.`
- `Failed to update store name`
- `We couldn't save your answers. Nothing was lost — try once more.`
- `Your project limit has been reached`
- `We couldn't prepare this store`
- `The store wasn't completed. Return to the template when you're ready to try again or contact support if this keeps happening.`
- `We couldn't refresh this store`
- `Your progress is saved. Check your connection and try loading the latest status again.`
- `We couldn’t open your store. Try again.`
- `We couldn't save that change. Try again.`
Creating a store and navigating to it can fail independently. A store that was created but did not open should be opened from the store list.
1. Refresh the store list before creating another store. Open an existing newly created store from that list.
2. If Runner asks for three questions, complete the onboarding form and retry creating the store.
3. At a store limit, review your existing stores. Delete one only if you deliberately want to remove it; do not delete a store just to diagnose an error.
4. For a failed template setup, return to the template and retry once, or contact support if it repeats. For a status refresh failure, load the latest status instead of starting another setup.
5. For rename or deletion failures, inspect the list before retrying the intended operation. For general store settings, keep a copy of your intended values, reopen settings, and retry the value that did not save.
6. If favicon image generation fails, retry generation once or upload your own image. Select and save the image after it is prepared; an image preview alone does not confirm it was saved.
**Check:** The intended store appears once in the list and opens, the intended rename or deletion is reflected there, or the store setting and favicon remain correct after reopening settings.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# You're out of credits
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/credits-and-subscription-requirements
## Credits and subscription requirements
**Messages you may see**
- `You're out of credits`
- `Runner can't take this step yet. Add credits or upgrade to keep building.`
- `Pick a plan to keep building, and to publish when you're ready.`
- `Please sign in to purchase credits`
- `Boost packs are for subscribers. Pick a plan first, then top up any time.`
- `Boost packs are for subscribers. Pick a plan first, then top up anytime.`
- `You already have an active subscription. Please manage it through your billing page.`
The requested action needs credits or an eligible subscription in the current workspace.
1. Confirm the workspace is the one you intended to use and that you are signed in.
2. Review its credits and plan in billing. Subscribers can use the offered top-up; users without an eligible subscription must choose a plan before buying a boost pack.
3. If an active subscription already exists, manage it from billing rather than buying another subscription.
4. After the balance or plan updates, return to the original task and continue it.
**Check:** Billing shows the intended plan or available credits and the original task can proceed.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# That code didn't match. Use the newest email, or resend a fresh code.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/email-sign-in
## Email sign-in
**Messages you may see**
- `Enter your email, and we'll send you a sign-in code.`
- `That doesn't look like an email address — check for a typo.`
- `That code didn't match. Use the newest email, or resend a fresh code.`
- `We couldn't send your code. Check the address and try again.`
The email field or sign-in code was rejected. A rejected code does not establish that your account is missing.
1. Check the email address for a typo.
2. Open the newest sign-in email and enter that code.
3. If it still fails, use the resend control when it becomes available and use only the new code.
4. If sending repeatedly fails, report the displayed error and time to support. Never send anyone the code.
**Check:** Runner opens your signed-in workspace.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Couldn't send your feedback — try again
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/feedback-clipboard-and-notifications
## Feedback, clipboard, and notifications
**Messages you may see**
- `Failed to copy code to clipboard`
- `No content to copy`
- `We could not prepare a draft. You can still enter feedback.`
- `Couldn't send your feedback — try again`
- `Couldn't send your feedback — nothing was lost, try again.`
- `Couldn't attach the screenshot — try again or send without it`
- `Couldn't copy. Please select the text and copy it manually.`
- `Notifications are blocked. Reset permission in your browser's site settings to turn them on.`
- `Couldn't copy the prompt. Please try again.`
A failed feedback submission has not been confirmed as received. Clipboard or notification permission failures do not prevent writing a message.
1. If drafting feedback fails, type it yourself. Keep a copy of the text before retrying submission.
2. If only the screenshot failed, retry attaching it or send the report without it.
3. If copying fails, select and copy the visible text manually. If the file tool has no content to copy, wait for readable file content; an empty result cannot be copied.
4. To enable notifications, change notification permission in the browser’s site settings and try turning them on again.
**Check:** Feedback shows its success confirmation, copied text pastes correctly, or the browser permits notifications.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Message not sent. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/opening-sending-and-managing-chats
## Opening, sending, and managing chats
**Messages you may see**
- `Couldn't start the conversation. Your message is kept — try again.`
- `We couldn't delete that conversation — it's still here, try again.`
- `We couldn't open a new conversation — your current one is untouched, try again.`
- `Message not sent. Try again.`
- `Please sign in to send messages. Try refreshing the page.`
- `Couldn't open this chat. Your messages are safe — try again.`
- `Couldn't load your chats — try again.`
- `Failed to delete chat`
- `Couldn't rename this chat — the old name stays. Try again.`
- `Couldn’t open a new chat. Try again.`
- `Queue action failed. Try again.`
- `Your answer didn't reach the agent. Try again.`
- `Failed to send message. Please try again.`
A failed send or queue action needs checking the original conversation before resubmitting. A failed question answer can leave Runner waiting for your input.
1. Keep a copy of your unsent message or answer. Reopen the original chat and check the latest messages and queued items.
2. If asked to sign in, refresh and sign in again before sending.
3. If the message or answer did not arrive, use its retry or submit control once. If it is already present, do not send a duplicate.
4. For queue, rename, or delete failures, reload the chat list or queue and retry only the change that is still missing. For new-conversation failures, keep the retained input, check the chat list, and retry opening a new chat once if none was created.
**Check:** Your message or answer is visible, the task moves out of its waiting state, or the intended queue/list change is visible.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# We couldn't bring this store back — it's still in Recently deleted. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/recovering-a-deleted-store
## Recovering a deleted store
**Messages you may see**
- `We couldn't bring this store back — it's still in Recently deleted. Try again.`
Runner could not confirm recovery; the store remains in Recently deleted according to this message.
1. Reopen Recently deleted and check whether the store is still there.
2. Select recovery again only for the intended store.
3. After recovery succeeds, allow the fresh workspace a few minutes to come online. If recovery keeps failing, contact support with the store URL and deletion/recovery time.
**Check:** The store leaves Recently deleted and opens; restored chat history and workspace availability can be checked.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Runner could not restore that saved panel. Choose it again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/research-saved-panels-and-sharing
## Research saved panels and sharing
**Messages you may see**
- `We couldn't load that panel. Please pick it again.`
- `Runner could not restore that saved panel. Choose it again.`
- `We couldn't create a share link. Please try again.`
A saved-panel selection could not be resolved, or the browser did not finish sharing the current study link.
1. For a panel error, select the intended saved panel again before starting the study. Confirm it belongs to the current project.
2. For sharing, retry the share action. You can copy the current study URL from the browser instead.
3. If the error repeats, include the study URL or panel name in a support report.
**Check:** The intended panel is selected, or the study link is available to paste or share. Copying a link does not itself give another person access.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# We lost track of Runner’s reply. Refresh the page to get it back.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/runner-stopped-or-its-reply-is-missing
## Runner stopped or its reply is missing
**Messages you may see**
- `Couldn't retry this response. Try again.`
- `Couldn't switch responses. Try again.`
- `This conversation changed. Reloading the latest version.`
- `Runner can't run multi-step plans right now. Try again in a bit.`
- `Runner hit a problem on our side and stopped. Try again. If it keeps happening, contact support.`
- `Runner couldn't get started on this. Nothing changed — try sending it again.`
- `The AI behind Runner dropped out mid-response. Try again in a moment.`
- `Runner didn’t answer that one. Send it again.`
- `We lost track of Runner’s reply. Refresh the page to get it back.`
A failed response does not prove that every action in that response was undone. Check task details and the affected result before repeating work.
1. Read the latest message and task details in the original conversation.
2. If Runner lost track of a reply, refresh to recover it before sending again.
3. If no work started or the AI response failed, wait a moment and retry once after checking for completed work. If response selection reports a conflict, let the current run settle and use the refreshed conversation before switching responses. If multi-step plans are unavailable, wait before retrying that command.
4. If Runner repeats the failure, contact support with the conversation URL, error, time, and last visible task state.
**Check:** The recovered reply appears or the task proceeds, and you can verify the requested result in the affected store.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Couldn't refine your prompt — your original is untouched. Send it as is or retry.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/screenshots-canvas-images-and-prompt-refinement
## Screenshots, canvas images, and prompt refinement
**Messages you may see**
- `Couldn't grab the screenshot. Try again, or upload an image instead.`
- `Couldn’t add to chat. Please try again.`
- `Only images can be added to chat`
- `Couldn't send this image to chat. It's still on your canvas. Try again.`
- `Couldn't improve this one — send it as written`
- `Couldn't refine your prompt — your original is untouched. Send it as is or retry.`
- `Failed to enhance prompt`
These helpers failed to prepare content for a message. They do not require abandoning your original prompt or canvas image.
1. If screenshot capture fails, retry once or upload a saved image.
2. If sending media to chat fails, select an image, retry adding it, and check the attachment list. Videos are not supported by this action.
3. If prompt refinement fails, send your original text as written or retry refinement.
**Check:** The image appears in the chat composer, or your intended prompt is ready to send.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Invalid file path
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/skill-drafts-and-files
## Skill drafts and files
**Messages you may see**
- `We couldn’t import these skills — nothing was added. Check the URL and try again.`
- `We couldn’t read that file. Try another.`
- `Invalid file path`
- `A file with this path already exists`
- `This file is over the 512 KB limit — pick a smaller one`
- `Files already at the {limit} total limit. Remove one before uploading.`
- `Total files exceed 2MB limit`
- `Adding "{name}" would exceed the {limit} total limit. Largest existing files: {top3}`
- `Total files size {total} exceeds the {limit} cap — remove some files before saving.`
- `{count} files were too large and were left out — the skill still works without them`
- `That change didn't save — your skills are unchanged. Try again.`
- `Name is required`
- `Name must be lowercase alphanumeric with hyphens (e.g. my-skill)`
- `Description is required`
- `Content is required`
- `A draft named "{name}" already exists`
- `We couldn’t save your draft — your edits are still on screen. Try again.`
Skill validation happens before saving. Imports may reject individual files; check the imported file list before assuming the skill is complete.
1. Fill in the name, description, and content. Use lowercase letters, numbers, and hyphens in the name, and choose a distinct name if another draft already uses it.
2. Use a relative file path with forward slashes. Do not start with a slash or include dot or double-dot path segments; avoid duplicate file paths.
3. For size errors, remove or reduce the files identified by the message before saving. Review any files excluded by import.
4. For a read failure, select the file again. Keep a copy of unsaved edits before retrying a save.
5. For import failures, read the individual failure text, correct it, and retry only the missing imports.
**Check:** The draft or skill reopens with the intended content and files, and any intended skill setting remains saved.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Runner didn't stop yet — tap Stop once more.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/stopping-work
## Stopping work
**Messages you may see**
- `Runner didn't stop yet — tap Stop once more.`
- `Failed to stop proposal chat`
Runner could not confirm cancellation. A locally stopped appearance is not proof that every server-side or external action stopped.
1. Select **Stop** once more in the original conversation.
2. Check the latest task state after it settles; refresh if necessary.
3. If work still continues, contact support with the conversation URL and time. Check any external result before starting replacement work.
**Check:** The current task is no longer running. Previously completed changes may remain.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# We couldn’t load what this task needs from you. Close and reopen it.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/task-actions-and-approvals
## Task actions and approvals
**Messages you may see**
- `We couldn’t load what this task needs from you. Close and reopen it.`
- `We couldn’t load this task’s action. Refresh and try again.`
- `We couldn’t mark it done — it’s still on your list. Try again.`
- `We couldn’t hand this back to Runner — your note is still here. Try again.`
- `We couldn’t record your approval — nothing started. Try again.`
- `We couldn’t reject this — it’s still waiting for you. Try again.`
- `We couldn’t restart planning. Try again in a moment.`
- `We couldn’t check on your proposal. Try again.`
- `We couldn't start the mission — nothing changed. Try again.`
- `We couldn’t finish the request. Refreshing Fly’s current status.`
- `We couldn’t stop this proposal — it’s still running. Try again.`
Runner could not load or confirm a task action. Approval, rejection, completion, and stopping are separate operations; inspect the current state before repeating one.
1. Close and reopen an input dialog that failed to load, or refresh the task action. Keep a copy of any note before refreshing.
2. Review the latest task or proposal state. If the action remains available and still matches your intent, retry it once.
3. If stopping failed, treat the proposal as still running until its status confirms otherwise.
4. Report repeated failures with the task URL and action you selected.
**Check:** The requested action is reflected in task status: started, approved, rejected, completed, returned to Runner, or stopped as intended.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Allow microphone access in your browser to talk to Runner.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/voice-input
## Voice input
**Messages you may see**
- `Couldn't start your mic. Check it's not in use, then try again.`
- `Failed to start speech recognition`
- `Couldn't turn your voice into text. Try again or type it out.`
- `Allow microphone access in your browser to talk to Runner.`
- `We didn't hear anything. Try again a little closer to your mic.`
- `We didn't catch any words. Try again.`
- `Couldn't turn that into text. Try again or type it out.`
- `Voice input doesn't work in this browser. Type your message instead.`
- `Couldn't transcribe that. Try again.`
Voice recording and transcription can fail independently; typing is an available way to continue.
1. If microphone access is denied, allow it in this site’s browser permissions.
2. If recording cannot start, check that the microphone is available and not already in use, then retry.
3. If no audio or words were detected, speak closer to the microphone and try again.
4. For transcription failures, retry once or type your message. If the browser is unsupported, type instead.
**Check:** The intended words appear in the input box; review them before sending.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Workspace is full
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-account-and-chat/workspace-access-and-invitations
## Workspace access and invitations
**Messages you may see**
- `Email is required`
- `Enter a valid email address`
- `The invitation didn't send. Check the email and try again.`
- `We couldn't create your workspace. Please try again.`
- `We couldn’t load your workspaces.`
- `You're still in this workspace. Try again.`
- `We couldn't delete the workspace — it's still intact. Try again.`
- `We couldn't add you to the workspace — try opening the invite link again.`
- `Invitation not found`
- `Workspace is full`
- `{organizationName} has reached its seat capacity, so you can't join right now.`
- `Ask {inviterName} to upgrade the workspace plan or free up a seat, then try this invitation link again.`
Workspace loading, joining, leaving, and deletion are different operations. A seat-cap error needs the inviter’s help, not another identical join attempt.
1. For loading or creation, refresh the workspace list and check whether the workspace already exists before creating another.
2. When sending an invitation, enter the intended recipient’s full email address and correct any typo; if sending fails, check the invitation list before retrying. When accepting an invitation, reopen the original invite link while signed in to the intended account. If it is not found, ask the inviter to check the invitation.
3. For **Workspace is full**, ask the inviter to upgrade or free a seat, then retry the invitation.
4. For leave or delete failures, check membership and workspace state. Retry only if you still intend to leave or delete.
**Check:** Joining opens the intended workspace; a leave or delete action is reflected in the refreshed workspace list.
## If the error returns
Contact [Support and community](/en/guides/help-and-reference/support-and-community) after one appropriate retry. Include the exact error, page or conversation URL, workspace/store, approximate time, and what you checked. Remove sign-in codes, credentials, payment details, and customer information.
[All account and chat errors](/en/guides/help-and-reference/error-playbook-account-and-chat)
---
# Preview, publishing, and domain errors
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build
Use the exact message and the screen where it appeared. A preview failure, a build failure, and a publish failure need different actions. Retrying a preview does not publish a store. Restoring a version changes the current project and should be a deliberate choice.
For an unresolved error, share the store link or project identifier, exact message, time, version number if shown, the action that failed, and a screenshot with private information removed. Include visible build details when relevant; never include passwords, API keys, or payment details.
## Find your error
- [Couldn't show this version](/en/guides/help-and-reference/error-playbook-build/couldnt-show-this-version)
- [Version history and restore](/en/guides/help-and-reference/error-playbook-build/version-history-and-restore)
- [Preview build failed or interrupted](/en/guides/help-and-reference/error-playbook-build/preview-build-failed-or-interrupted)
- [Publishing: code needs repair](/en/guides/help-and-reference/error-playbook-build/publishing-code-needs-repair)
- [Publishing: workspace or setup check unavailable](/en/guides/help-and-reference/error-playbook-build/publishing-workspace-or-setup-check-unavailable)
- [Live link and copy failures](/en/guides/help-and-reference/error-playbook-build/live-link-and-copy-failures)
- [Design Mode cannot start](/en/guides/help-and-reference/error-playbook-build/design-mode-cannot-start)
- [Design direction choice cannot be used](/en/guides/help-and-reference/error-playbook-build/design-direction-choice-cannot-be-used)
- [Domain input needs correction](/en/guides/help-and-reference/error-playbook-build/domain-input-needs-correction)
- [Adding, changing, removing, or transferring a domain failed](/en/guides/help-and-reference/error-playbook-build/adding-changing-removing-or-transferring-a-domain-failed)
- [DNS provider or authorization failed](/en/guides/help-and-reference/error-playbook-build/dns-provider-or-authorization-failed)
- [DNS configuration or HTTPS confirmation failed](/en/guides/help-and-reference/error-playbook-build/dns-configuration-or-https-confirmation-failed)
- [Domain purchase and renewal](/en/guides/help-and-reference/error-playbook-build/domain-purchase-and-renewal)
- [Domain registrant details](/en/guides/help-and-reference/error-playbook-build/domain-registrant-details)
- [Preview recovery and visual edit failures](/en/guides/help-and-reference/error-playbook-build/preview-recovery-and-visual-edit-failures)
- [Deployment could not start](/en/guides/help-and-reference/error-playbook-build/deployment-could-not-start)
## Related guides
- [Creative Studio and media errors](/en/guides/help-and-reference/error-playbook-creative)
- [Version history](/en/guides/storefront-and-publishing/version-history)
- [Preview your store](/en/guides/storefront-and-publishing/preview-your-store)
- [Design Mode](/en/guides/storefront-and-publishing/design-mode)
- [Publish and republish](/en/guides/storefront-and-publishing/publish-and-republish)
- [Custom domains](/en/guides/storefront-and-publishing/custom-domains)
- [Troubleshoot storefront builds](/en/guides/help-and-reference/troubleshoot-storefront-builds)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Adding, changing, removing, or transferring a domain failed
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/adding-changing-removing-or-transferring-a-domain-failed
**Exact messages**
- We couldn't add that domain. Nothing changed. Try again.
- We couldn't add that domain. Check the spelling and try again.
- Failed to add domain
- We couldn't switch your domain. Your store is still live at the old address — try again.
- Failed to change domain
- We couldn't remove that domain — it's still connected. Try again.
- Failed to remove domain
- The transfer didn't start — your stores are unchanged. Try again.
- Failed to start domain transfer.
- The transfer didn't go through — try again.
- Domain transfer failed. Please try again.
- Deployment not found. Please deploy your store first.
- Deployment is incomplete. Please redeploy your store.
- Project ID is required
**Meaning:** Runner did not confirm the requested domain operation. Missing deployment/project information can prevent domain setup.
Refresh domain settings and inspect the current assignment before repeating a mutation. For “deploy your store first,” complete publishing before adding the domain; for incomplete deployment, republish and retry. If a project identifier is missing, reopen settings from the intended store; do not fabricate an identifier. For a transfer failure, inspect both source and destination stores and the transfer status before starting another transfer.
**Success:** Settings show the intended domain assignment, and the relevant public address works. For removal, confirm the assignment is absent. Escalate an ambiguous or repeated transfer failure with both stores; do not delete domains as a workaround.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Couldn't show this version
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/couldnt-show-this-version
**Exact messages**
- Couldn't show this version — try again or pick another.
- Your store's preview environment is broken. Try again to repair it.
**Meaning:** Runner could not start or obtain a usable preview for the selected version. This message appears in version previews and the storefront canvas. It does not identify whether the cause is the network, workspace, or saved version, and does not by itself mean the version was lost. A screenshot or older page visible behind the error is not proof that the selected version loaded.
When the store's preview environment fails, the storefront canvas and version previews show "Fixing your store preview…" while Runner repairs it, or replaces it with a new one built from your store's saved code. "Your store's preview environment is broken" means that repair did not succeed. **Try again** starts another repair.
1. Select **Try again** in the preview. This requests that version's preview again.
2. If it fails again, go back to **Version History** and preview another version to check whether the problem affects one version or all versions.
3. Return to the current storefront when you want to continue working. Do not select **Restore** merely to dismiss a preview error.
**Success:** The selected version opens as an interactive page, and its version label matches your selection. If another version works but this one does not, report both version numbers. If none work, report that broader scope to support.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Deployment could not start
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/deployment-could-not-start
**Exact messages**
- Failed to start deployment
The deployment request failed before the UI could confirm it started. Check the latest publish status before retrying, since a failed response alone does not prove no request reached the server. **Success:** A deployment runs to completion and the public store shows the intended version. Escalate repeated start failures with the publish time and store.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Design direction choice cannot be used
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/design-direction-choice-cannot-be-used
**Exact messages**
- This choice could not be submitted.
- Couldn’t load design choices. Try again.
- This choice is no longer active.
- This choice is read-only.
- Selection interrupted.
**Meaning:** The card could not load or submit a design choice, or the choice is no longer interactive. Historical or interrupted cards cannot necessarily accept new selections.
Retry a load/submit action only on the active choice. For an expired, interrupted, or read-only choice, return to the latest conversation and ask Runner to present a new design choice. Check for a submitted/selected state before resubmitting after an uncertain failure.
**Success:** The current card confirms the selected direction and Runner proceeds. Report persistent submission failures with the conversation and choice name.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Design Mode cannot start
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/design-mode-cannot-start
**Exact messages**
- Design mode didn't start. The store preview may still be waking up — try again.
- You can edit visually again once Runner finishes processing.
- Your preview is still loading.
**Meaning:** Visual editing needs a ready preview and may be unavailable while Runner is processing. A startup failure can occur while the preview is still waking up.
Wait for the active task and preview loading to finish, then retry Design Mode. If the storefront itself does not load, resolve that preview/build error first.
**Success:** You can select and edit a visible element. Escalate if the preview works but Design Mode repeatedly fails, including the affected page.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# DNS configuration or HTTPS confirmation failed
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/dns-configuration-or-https-confirmation-failed
**Exact messages**
- Automatic DNS setup failed
- We couldn't update the DNS records. Try automatic setup again or use manual records.
- DNS records are incorrect
- Additional DNS verification required
- Couldn't confirm HTTPS status
**Meaning:** Automatic DNS changes failed, verification found incorrect/missing records, or Runner could not read certificate status. DNS verification and HTTPS readiness are separate checks.
For automatic setup failure, retry that stage or apply the exact manual records shown in Runner at the domain's DNS provider. For incorrect records, compare the displayed host, type, and value with your provider. For additional ownership verification, add the requested ownership record. Preserve unrelated records, especially email records. For HTTPS-status failure after DNS verification, retry the status check; do not change correct DNS records solely to clear a certificate-read error. Pending verification may require waiting and checking again.
**Success:** Runner reports the domain ready and its HTTPS URL opens the intended storefront. Escalate repeated failure with the exact stage and visible record/status details.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# DNS provider or authorization failed
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/dns-provider-or-authorization-failed
**Exact messages**
- Couldn't check the DNS provider
- Couldn't complete authorization
- Authorization wasn't completed
- Couldn't open automatic DNS setup. Try again or use manual records.
**Meaning:** Provider detection or authorization did not complete. Later DNS/HTTPS stages should not be assumed complete.
Retry the provider check when detection failed. For authorization, choose the DNS account/team that manages the exact domain and complete the provider flow. If automatic setup cannot open, use the manual records option where available. Review any existing DNS records before changing them.
**Success:** Runner advances past the failed stage and shows the next DNS verification step. Escalate repeated authorization failure with the provider, domain, and stage; never send credentials.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Domain input needs correction
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/domain-input-needs-correction
**Exact messages**
- That doesn't look like a domain. Try something like yourbrand.com.
- Please enter a valid domain
- Domain name is required
- New domain name is required
- Old domain name is required
- Your domain needs at least 8 characters before the dot.
- Domain prefix must be at least 8 characters long
- Domain prefix can only contain letters, numbers, hyphens, and underscores
- Domain prefix must contain at least one letter
- Domain prefix cannot contain forbidden word: \{word\}
- Domain prefix cannot use restricted word: \{word\}
- Domain prefix contains inappropriate language: \{word\}
- You cannot use .runnerai.dev or .runnerai.com domains
- That domain is already in use. Try another.
- Domain is already in use
**Meaning:** The entered domain or Runner-hosted domain prefix does not satisfy the form's rules, or that name is already assigned. Prefix rules are for the prefix field, not a reason to rewrite an unrelated custom domain.
Enter the domain in the format the field requests, such as `yourbrand.com`. For prefix errors, follow the stated length/character requirements and choose a different name for restricted or occupied names. If a domain belongs to another one of your stores, inspect its existing assignment rather than repeatedly adding it.
**Success:** The field is accepted and the intended domain appears on the correct store. Adding a domain is not proof that DNS and HTTPS are ready. Escalate an apparently incorrect ownership/in-use result with the domain and both store identifiers.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Domain purchase and renewal
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/domain-purchase-and-renewal
**Exact messages**
- Enter a valid keyword or domain name
- Someone already owns this one. Try a variation.
- This domain is not available for purchase
- This TLD is not available for purchase through our platform
- We couldn't open checkout. You haven't been charged. Try again.
- Failed to create checkout session
- The purchase didn't go through and you've been refunded in full. Try again or pick another name.
- Domain purchase failed — refund issued
- We couldn't open renewal checkout. You haven't been charged. Try again.
- Failed to create renewal checkout
- Domain renewal failed — refund issued
**Meaning:** The name is unavailable/unsupported, checkout could not open, or purchase/renewal failed. A refund message reports that failure state; it is not evidence of when a bank will display the credit.
Choose another available supported domain when necessary. Retry opening checkout only after checking whether an earlier checkout or order is already in progress. For a failed paid operation, inspect the domain/order status and refund information before purchasing again. If the payment outcome is unclear, contact support with the order reference rather than paying repeatedly.
**Success:** The purchase/renewal is confirmed and the domain appears with the expected registration/renewal state. Verify DNS separately. Escalate payment/status mismatches with the domain, time, and non-sensitive order reference.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Domain registrant details
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/domain-registrant-details
**Exact messages**
- Address is required
- City is required
- Must be a 2-letter country code (e.g. US)
- Please enter a valid email address
- First name is required
- Last name is required
- Phone must be in E.164 format (e.g. +1234567890)
- State / Province is required
- ZIP / Postal code is required
**Meaning:** Domain-registration contact details failed validation.
Fill each named required field. Use a valid email, a two-letter country code such as `US`, and an international phone number with `+` and country code as the form requests. Correct only the flagged fields and submit again.
**Success:** The registration form is accepted and checkout can proceed. If valid details remain rejected, report the field name and message without posting the full private address or phone number publicly.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Live link and copy failures
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/live-link-and-copy-failures
**Exact messages**
- Failed to copy URL
- Store link unavailable
- Checkout status unavailable
- Status unavailable
**Meaning:** Clipboard copying or retrieval of live-store/checkout status failed; this alone does not show that publishing or checkout failed.
For a copy failure, open the store link and copy its address from the browser. For missing status or a missing link, refresh the status in the affected store and check the latest publish result. Do not invent a public URL or announce checkout is ready while its status is unknown.
**Success:** The public URL opens the intended store; verify checkout separately through the documented setup flow. Escalate a persistent unavailable status with the store and publish time.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Preview build failed or interrupted
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/preview-build-failed-or-interrupted
**Exact messages**
- Your preview didn't build.
- Your store preview can't load.
- The build got cut off — retry.
- Couldn't start the rebuild — try again in a moment.
**Meaning:** A failed build prevents the generated preview from becoming usable. An interrupted build or a rebuild-start error can be a workspace/service problem rather than a code defect.
If the build was cut off, use the rebuild/retry control once and wait for its final result. “Rebuild started” is not a successful build. If code error details are shown, choose the fix action or paste those details into Runner with the affected page and expected behavior. In Version History, the fix action prepares a message: review and send it to start the repair. Do not repeatedly rebuild unchanged code after the same compiler error.
**Success:** The build finishes successfully and the affected preview page works. Escalate repeated interruptions or identical errors after a completed repair with the visible build excerpt.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Preview recovery and visual edit failures
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/preview-recovery-and-visual-edit-failures
**Exact messages**
- We couldn't load your store preview. Hit Refresh to try again — nothing you built is lost.
- Your store's workspace isn't connected yet — wait a moment and try again
- We couldn't download this image. Try again.
- We couldn't upload your image — your page is unchanged. Try again.
- We couldn't undo that — your page is unchanged. ($\{errorMessage\})
- We couldn't redo that — your page is unchanged. ($\{errorMessage\})
The parenthesized error detail varies. For preview recovery, use **Refresh** and wait for the workspace connection. For image upload/download, retry the same image and check the resulting page or downloaded file. For undo/redo, inspect the current page and preserve your intended changes before retrying; report the additional error detail if it repeats. **Success:** The page loads or the intended edit/file is visible. Escalate persistent failures with the page, action, and exact detail.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Publishing: code needs repair
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/publishing-code-needs-repair
**Exact messages**
- Your store won't build yet, so it can't go live. Let Runner fix the errors, then publish.
- Your store couldn't be built, so nothing went live. Let Runner fix it.
- Store publish failed
- Publish failed — your store isn't live yet
- A build error stopped your store from publishing
**Meaning:** Publishing did not complete. A build-specific message means the storefront code failed the build; the generic publish failure alone does not establish that cause.
Open the publish result and read its error details. For a build failure, use **Fix with AI** or give Runner the details, wait for the repair, check the preview, and then publish again. For a generic failure, retain the details and check the latest publish status before retrying. Do not assume a previously published store is offline solely because an update failed.
**Success:** Publishing reports completion and the public store URL shows the intended update. A green preview or a started deployment is insufficient. Escalate repeated failure with the publish time and details.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Publishing: workspace or setup check unavailable
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/publishing-workspace-or-setup-check-unavailable
**Exact messages**
- We couldn't reach your workspace. Retry the check to continue.
- Publishing stopped because your workspace was unavailable. Nothing went live — try again.
- Your workspace is offline — reconnect it to publish.
- We couldn’t verify Store Operations. Retry, or acknowledge this and publish anyway.
- We couldn't open a new fix chat, so no repair was started. Try again.
- We couldn't save your store details. Please try again.
**Meaning:** Runner cannot reach the workspace, verify Store Operations, open the repair conversation, or save the publish setup. These are separate from a confirmed code build error.
For an offline workspace, reconnect/wait for it to be available and retry the publish check. For an unavailable Store Operations check, retry it; publishing after acknowledging the warning is a deliberate option, not proof that checkout or operations are ready. For a repair-chat failure, retry opening the fix chat and confirm a repair actually starts. For store-details save failure, keep your entered details and retry saving before proceeding.
**Success:** The failed check completes or the details save; then verify the actual publish or repair outcome separately. Escalate if the same stage fails again, identifying that stage.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Version history and restore
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-build/version-history-and-restore
**Exact messages**
- Couldn't load your versions — try again.
- Couldn't restore this version — your current store is untouched.
- Can't restore while the agent is working. Try again once it finishes.
- Can't restore while a Design Mode save is running. Try again once it finishes.
**Meaning:** The first message concerns loading the version list. The restore messages concern changing the current project to a saved version; an active agent task or a Design Mode save can block that change.
For a list failure, retry or reopen Version History. For an active-task or Design Mode save warning, let it finish, then review the intended version and try restoring again. For a generic restore failure, reopen history and check the current-version marker before retrying: an error during follow-up refresh is not sufficient evidence of the final server state. Restore only if you still want that version's content.
**Success:** History loads; after an intentional restore, the current-version marker and refreshed storefront show the chosen content. If they disagree or restore keeps failing, stop retrying and provide the version numbers to support.
[All preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
---
# Creative Studio and media errors
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative
Match the exact error to its section. Preserve available original files and unsaved work before reloading a canvas or design editor. For unresolved failures, share the project, action, time, browser, and exact message; never share API keys or private media publicly.
## Find your error
- [Design files: protect unsaved work](/en/guides/help-and-reference/error-playbook-creative/design-saving)
- [Design files: import, images, and fonts](/en/guides/help-and-reference/error-playbook-creative/design-imports)
- [Design export and image operations](/en/guides/help-and-reference/error-playbook-creative/design-export)
- [Creative Studio canvas saving or recovery failed](/en/guides/help-and-reference/error-playbook-creative/canvas-saving)
- [Creative Studio assets, inspiration, and handoff errors](/en/guides/help-and-reference/error-playbook-creative/assets-and-handoffs)
- [Creative Studio upload, download, and GIF errors](/en/guides/help-and-reference/error-playbook-creative/upload-and-download)
- [Creative Studio generation cannot proceed](/en/guides/help-and-reference/error-playbook-creative/generation)
- [Media Library and watermarks](/en/guides/help-and-reference/error-playbook-creative/media-library-and-watermarks)
- [Media Library loading](/en/guides/help-and-reference/error-playbook-creative/media-library-loading)
## Related guides
- [Preview, publishing, and domain errors](/en/guides/help-and-reference/error-playbook-build)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# We couldn't load that image or video. It's still in your asset tray. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/assets-and-handoffs
**Exact messages**
- We couldn't load that image or video. It's still in your asset tray. Try again.
- Some earlier versions can't be shown anymore
- This one didn't load — go back or try again.
- Inspiration didn't load — try again.
- Couldn’t add the reference. Try again.
- We couldn't get these images ready for the product — nothing on the product changed. Try again.
- Couldn't send this image to chat. It's still on your canvas. Try again.
- We couldn't pull the images from this chat reply onto the canvas. They're safe — try again.
- Can't show this image right now — try loading again
An asset could not be retrieved or passed to the next surface. Retry loading from its original asset tray, conversation reply, or inspiration card. For unavailable older versions, select a version that is still available or re-upload the original file. For a product handoff error, return to the canvas, select the intended images, retry, and confirm the product form receives them. For chat handoff, confirm the image is attached in the intended conversation before sending a message. **Success:** The image/video actually appears in the destination; a click or a dismissed error is insufficient. Escalate repeated failures with the source asset and destination, preserving available originals.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# We couldn't set up canvas saving — work here may not be kept if you leave. Reload to try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/canvas-saving
**Exact messages**
- We couldn't set up canvas saving — work here may not be kept if you leave. Reload to try again.
- We couldn't bring back your last canvas, so you're starting with an empty one. Your generated images are still in the asset tray.
Canvas storage did not initialize or the previous canvas could not be restored. Before reloading a tab that contains new work, download important available outputs and preserve prompts/settings where possible. Then reload to retry initialization. For an empty recovered canvas, open the asset tray and add the generated images you need again; do not assume their earlier positions or edits were recovered. **Success:** The saving warning clears and the canvas content you need is present. If it repeats, keep available files and report the browser and project; do not clear browser storage as a first remedy.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Could not export the design. Check that all images have loaded and try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/design-export
**Exact messages**
- Could not export the design. Check that all images have loaded and try again.
- The image could not be exported. Reduce the export size and try again.
- This image or export is too large to render. Reduce the image size or export scale.
- Your browser does not support this export format. Choose PNG or JPEG.
- Background removal did not finish. Your original image is unchanged.
- Could not combine these shapes. Try a different selection.
**Meaning:** The browser could not render/export the design or finish an image/shape operation.
Wait for images and fonts to load before export. Reduce image dimensions or export scale for render-size failures; choose PNG or JPEG for unsupported formats. For background-removal failure, retain the original image and retry the operation. For combine failure, use a different compatible shape selection.
**Success:** Open the exported file and check its contents, or confirm the requested edit appears in the canvas. Escalate repeat failures with export format, scale, browser, and the operation attempted; preserve your editable design file.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# This design file contains invalid or unsupported content. Your current design has not changed.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/design-imports
**Exact messages**
- This design file contains invalid or unsupported content. Your current design has not changed.
- Could not open this design. Choose a valid Runner design or archive under 100 MB.
- Could not add the images. Use PNG, JPEG, WebP, GIF, or AVIF files up to 20 MB each and 75 MB total per upload.
- Image unavailable. Upload it again or use a source that allows cross-origin access.
- Could not add this font. Use a valid font under 5 MB. A document can hold 50 fonts and 20 MB of encoded font data.
- A saved font could not load. Open Typography to replace it before exporting.
- Could not open the selected images. Go back to the canvas and select them again.
- Enter a hex or RGB color
**Meaning:** A file, image source, font, selection, or color is invalid or unavailable.
Use a valid Runner design/archive under 100 MB for import. Image uploads accept PNG, JPEG, WebP, GIF, or AVIF up to 20 MB each and 75 MB total per upload. Re-upload an unavailable image or use a source that permits cross-origin access. Use a valid font under 5 MB, staying within 50 fonts and 20 MB encoded font data per document; replace a failed saved font in Typography before exporting. For unavailable selections, return to the canvas and select the images again. Enter colors in hex or RGB format.
**Success:** The imported content, image, or font renders correctly in the editor; invalid imports should not replace your current design. Escalate valid files that repeatedly fail, including file type and size without sharing private assets unnecessarily.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Your saved design could not be loaded. Editing is paused to protect your work. Reload to try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/design-saving
**Exact messages**
- Your saved design could not be loaded. Editing is paused to protect your work. Reload to try again.
- Your changes could not be saved on this device. Keep this tab open and try saving again, or export your design file.
- Changes could not be saved
- This design was changed in another tab. Export your design file before reloading to keep your changes.
**Meaning:** Loading or saving the design in this browser failed, or another tab changed the same design.
For save failures, keep this tab open and retry saving or export a Runner design file. For a conflict, export your current design file before reloading so your changes can be retained; avoid editing the same design in multiple tabs. For a load failure, editing is paused: reload to retry. Do not clear browser storage as a first step.
**Success:** Saving reports success, or you have an exported design file you can reopen. If persistence keeps failing, report the browser and exact message, preserving the export and open tab where possible.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Add a prompt first
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/generation
**Exact messages**
- Add a prompt first
- Please select an image first
- That model isn't available right now
- This model isn't covered by Runner credits yet
- Your selection doesn't fit this model
- This one didn't generate
- \{label\} failed
- Something in your selection or settings isn't quite right — check them and try again.
Add a prompt or select the required image when requested. Choose an available model; if using Runner credits, select one marked **Runner credits**. Adjust the image count and settings to match the model's displayed requirements. A failed generation can show provider-specific details: use those details to decide whether to change the inputs or retry, and check the generation status before submitting duplicates. Do not paste a provider key into chat. **Success:** The generation completes and its output loads on the canvas. Escalate persistent failures with model name, operation, time, and a non-sensitive description of inputs.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# We couldn't save the new title. The old one is still there — try once more.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/media-library-and-watermarks
**Exact messages**
- We couldn't save the new title. The old one is still there — try once more.
- We couldn't delete this one. It's still in your library — try again.
- Couldn't put the watermark back. Try again.
- Couldn't remove the watermark — it's still on. Try again.
The requested title, deletion, or watermark update did not complete. Reopen the asset to check its current state, then retry the intended action. Delete only if you still want to remove the asset. For a watermark failure, check the displayed switch state and the resulting image rather than assuming the attempted toggle succeeded. **Success:** The title or watermark matches the intended result, or the deleted asset is absent from the library. Escalate repeated failures with the asset and action, without sharing private media publicly.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# We couldn't load your media just now. Nothing was lost — refresh to try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/media-library-loading
**Exact message**
- We couldn't load your media just now. Nothing was lost — refresh to try again.
Runner could not retrieve the media list. Refresh Media Library and check the current store and active filters. An error loading the list does not mean the files were deleted; do not delete or re-upload assets just to clear this message.
**Success:** The expected media appears in the library and opens. If the same load keeps failing, share the store, time, browser, and exact message with support without exposing private media.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Couldn't add those files
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-creative/upload-and-download
**Exact messages**
- Couldn't add those files
- Can't open the file picker here
- Couldn't package your ad sizes
- The zip didn't build. Your sizes are still on the canvas — try downloading again.
- Couldn’t download the image.
- Couldn’t copy. Try again.
- Couldn't turn this video into a GIF
- Some images are unavailable. Upload them again before exporting.
For an unavailable file picker, drag images onto the canvas. For failed uploads, retry and inspect the canvas for the files. For ad-size ZIP failure, retry downloading; the generated sizes remain on the canvas. For image-download or copy failure, retry the same action and check the downloaded file or clipboard result. For GIF conversion failure, retry or download the original video instead. Re-upload unavailable source images before exporting. **Success:** Open the downloaded output and confirm its contents, or confirm the upload appears. Escalate repeat conversion/export failures with source type, size, and the additional error detail.
## Related guides
- [Creative Studio error playbook](/en/guides/help-and-reference/error-playbook-creative)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Store Operations, apps, and automation errors
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps
Find the message you see below, then follow its recovery steps. Text in braces is replaced by your provider, item, or error detail. A failed status check does not prove that an earlier change failed. Before repeating a product import, fulfillment, workflow run, or webhook replay, check whether it already happened.
If recovery fails, send Runner the exact message and details, the affected store and page, what you selected immediately before it appeared, and the time. Include the product, order, workflow run, or delivery ID when available. Do not send passwords, access tokens, client secrets, or webhook signing secrets. Use [Support and community](/en/guides/help-and-reference/support-and-community) when the message calls for support or no safe recovery is available.
## Product imports with an uncertain outcome
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/product-imports-with-an-uncertain-outcome).
## Printful design conflicts and unavailable artwork
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork).
## Printful product review, mockups, and publication
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication).
## Printful connection and catalog
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog).
## Dropshipping catalog and adding products
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products).
## Orders and fulfillment
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment).
## Store setup, products, customers, shipping, and promotions
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/store-setup-products-customers-shipping-and-promotions).
## Shopify migration and import
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/shopify-migration-and-import).
## App connections and ad account permissions
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/app-connections-and-ad-account-permissions).
## SEO reports, audits, and AI visibility
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/seo-reports-audits-and-ai-visibility).
## Analytics reports and tracking settings
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/analytics-reports-and-tracking-settings).
## Workflow editing, validation, and conflicting saves
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/workflow-editing-validation-and-conflicting-saves).
## Workflow runs, triggers, and management
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/workflow-runs-triggers-and-management).
## Webhooks and delivery recovery
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/webhooks-and-delivery-recovery).
## Skills configuration and imports
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/skills-configuration-and-imports).
## Supplier credentials, Stripe setup, and customer email connections
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/supplier-credentials-stripe-setup-and-customer-email-connections).
## Ad search, campaigns, and saved collections
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/ad-search-campaigns-and-saved-collections).
## Email preview and saving
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/email-preview-and-saving).
## Experiment changes, traffic, and results
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/experiment-changes-traffic-and-results).
## Product CSV import
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/product-csv-import).
## Customer notes, lifecycle, and agent settings
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/customer-notes-lifecycle-and-agent-settings).
## Simulation interventions, failed runs, and handing fixes to Runner
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/simulation-interventions-failed-runs-and-handing-fixes-to-runner).
## Negative supplier prices
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/negative-supplier-prices).
## Marketing email action did not complete
[Find the message and recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/marketing-email-action-did-not-complete).
---
# {platform} search isn't configured
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/ad-search-campaigns-and-saved-collections
For a search timeout or temporary provider failure, retry the saved search after the indicated wait. Missing search configuration is a Runner-side setup issue; report the named platform to support. A permission or authorization limitation requires the named account access or a supported current browser; retry authorization if it timed out.
Preserve campaign inputs when generated copy, keywords, suggestions, or a save fails. Review required fields before submitting. For a failed collection creation or saved ad, reopen the collection list to see whether the item exists before retrying. Success means the collection/ad or campaign draft is visible with the intended contents; it does not mean a campaign was published.
**Messages covered:**
- `{platform} search isn't configured`
- `{platform} search timed out`
- `This isn't on your end. Your search is saved. Try again in a minute.`
- `{platform} is temporarily unavailable`
- `We couldn't load {platform}`
- `The ad wasn't saved. Please try again.`
- `The collection wasn't created. Please try again.`
- `Failed to create collection`
- `{provider} authorization timed out. Try again.`
- `{provider} authorization is not supported in this browser. Try a current browser.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't load this report — nothing was lost. Refresh to try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/analytics-reports-and-tracking-settings
Refresh a failed report or delivery-results view and check the selected store, period, and report. A load error or unavailable tracking check does not prove there were zero visitors, events, or deliveries. Previously saved reports may still be visible.
For failed saves or deletes, inspect the current dashboard, funnel, goal, flag, experiment, visitor record, or settings before trying again. A flag reported as still live continues to affect traffic. For tracking connections, event mappings, consent mode, and Meta spend sources, confirm the saved selection after retrying. A failed removal may leave the connection active. Failed key rotation leaves the current key working; do not replace the deployed key until a new one is confirmed.
Success means the changed setting persists after reopening and the intended report or tracking result is visible. Include the affected report/connection and time range when escalating, without API keys or visitor personal data.
**Messages covered:**
- `We couldn't load this report — nothing was lost. Refresh to try again.`
- `We couldn't load consent mode. Try again.`
- `We couldn't save consent mode. Your previous setting is unchanged.`
- `Invalid`
- `Entry pages aren't available yet`
- `Exit pages aren't available yet`
- `We couldn't load this report — refresh to try again.`
- `We couldn't delete your funnel. It's still here, please try again.`
- `We couldn't save your funnel. Please try again.`
- `We couldn't delete your goal. It's still here, please try again.`
- `We couldn't save your goal. Please try again.`
- `Enter the required target and complete each filter.`
- `Goals with filters or patterns can't show individual sessions.`
- `We couldn't load your sales data — refresh to try again.`
- `We couldn't load your visitor data — refresh to try again.`
- `Enter a valid IANA timezone, such as UTC or America/Los_Angeles.`
- `We couldn't create the dashboard. Try again.`
- `We couldn't delete that dashboard. Try again.`
- `Something in this dashboard's setup isn't valid. Check the card settings.`
- `Invalid query`
- `We couldn't load your dashboards. Refresh to try again.`
- `Query must be valid JSON.`
- `We couldn't save the dashboard — your last saved version is safe. Try again.`
- `We couldn't delete the experiment. It's still here. Try again.`
- `Invalid experiment`
- `We couldn't save the experiment. Try again.`
- `We couldn't delete the flag. It's still live. Try again.`
- `Invalid feature flag`
- `We couldn't save the flag. Try again.`
- `We can't show usage right now. Check back shortly.`
- `{argument} is required for {endpoint}.`
- `{argument} (required)`
- `Goal and funnel arguments must contain valid JSON.`
- `Invalid analytics arguments.`
- `The request failed.`
- `We couldn't save those traits. Try again.`
- `We couldn't delete this visitor's data. Try again.`
- `Failed to identify user`
- `Enter a valid traits JSON object: up to 50 keys and 2 KiB; keys up to 100 characters; strings up to 512 characters; values may be string, number, boolean, or null.`
- `Needs reconnecting.`
- `We couldn't save this connection. Please try again.`
- `We couldn't remove this connection — it's still active. Please try again.`
- `We couldn't save that event mapping. Please try again.`
- `We couldn't create a new key — your current key still works. Please try again.`
- `We couldn't create a new server key — your current key still works. Please try again.`
- `Couldn't check page views right now`
- `Couldn't check events right now`
- `We couldn't load Meta ad accounts. Try again.`
- `We couldn't save this spend source. Your previous selection is unchanged.`
- `We couldn't remove this spend source. It is still connected.`
- `Only admins can change this.`
- `We couldn't load delivery results. Refresh to try again.`
- `We couldn't save your settings — nothing changed. Try again.`
- `Could not refresh. Showing the last available data.`
- `Live count unavailable`
- `This panel did not load.`
- `This card could not load. Other cards still work.`
- `This replay could not load.`
- `Could not save the funnel.`
- `Could not delete the funnel.`
- `Could not save the goal.`
- `Could not delete the goal.`
- `Could not create the dashboard. Try again.`
- `Could not save the dashboard. Your last saved version is safe.`
- `Could not delete the dashboard. Try again.`
- `We could not import that file. Nothing was added. Check the format and try again.`
- `We could not remove that import. Try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't connect {provider}.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/app-connections-and-ad-account-permissions
Allow pop-ups for Runner when authorization cannot open. Start Connect or Reconnect again through the app's official authorization flow if sign-in was canceled or credentials were rejected. Ask a workspace owner or admin to connect or select a publishing account when the message requires that role.
Distinguish connection failure from refresh failure: “connected” or “change was saved” followed by a status error means refresh the status first, not authorize or mutate again. If disconnect failed, the app may still be connected. For Google Ads, select the intended publishing account and sync accounts when offered. Recheck the selected account after a successful return.
An app not available to connect yet cannot be enabled by retrying. For an action-toggle save failure, inspect the toggle's current state and retry. Confirm both the connection/account and the intended action work; report the provider, account identifier, and authorization stage if they do not.
**Messages covered:**
- `We couldn't check whether you can connect Stripe. Try again.`
- `We couldn’t start or refresh Stripe setup. Try again.`
- `An organization admin or owner can manage this connection.`
- `Your Google Ads change was saved, but the latest status could not be loaded. Try again.`
- `Try again before connecting or loading ad creatives.`
- `Google Ads is still connected. Please try again.`
- `The Google Ads change could not be completed. Try again.`
- `We couldn't verify who can manage Google Ads.`
- `Connection status unavailable`
- `We couldn't fetch your Google Ads accounts. Please try again.`
- `Google Ads status is unavailable`
- `We couldn't update your Google Ads account. Please try again.`
- `Your {provider} change was saved, but the latest status could not be loaded. Try again.`
- `The {provider} change could not be completed. Try again.`
- `The {provider} sign-in was canceled or failed. Try again.`
- `We couldn't connect {provider}.`
- `We couldn't verify who can manage this connection.`
- `We couldn't open the {provider} sign-in window. Please try again.`
- `Unable to open {provider} authorization. Allow pop-ups and try again.`
- `{provider} wasn't connected. Please try again.`
- `{provider} connected, but the latest status could not be loaded. Refresh the page to try again.`
- `The connection didn't go through. Close this window and try connecting again.`
- `Connection failed`
- `Could not connect. Check your details and try again.`
- `Please allow popups for this site to connect.`
- `That change didn't save — the action is unchanged. Try again.`
- `We couldn't load this app's actions. Try again.`
- `This app is not available to connect yet.`
- `We couldn't load your ad numbers.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Couldn't save — your previous settings still apply. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/customer-notes-lifecycle-and-agent-settings
A failed stage, automation, or agent-setting change leaves the previous setting in place as stated. Reopen the affected customer or settings panel, check the current value, and retry the intended change. Preserve note or product text before refreshing; confirm it appears when reopened after saving.
For a skill name validation error, use lowercase letters, numbers, and hyphens, and provide the required description and content. Select an experiment goal when required. Escalate repeated saves with the affected record or settings page.
**Messages covered:**
- `Couldn't save — your previous settings still apply. Try again.`
- `That change didn't save — your skills are unchanged. Try again.`
- `Please select a goal`
- `Adding "{name}" would exceed the {limit} total limit. Largest existing files: {top3}`
- `Its Printful connection was disconnected. The product and design are preserved, but it can't be sold or edited through Printful.`
- `Name is required`
- `Name must be lowercase alphanumeric with hyphens (e.g. my-skill)`
- `Description is required`
- `Content is required`
- `We couldn't change this customer's stage — it's unchanged. Try again.`
- `We couldn't change that automation — it's still as it was. Try again.`
- `We couldn't save that note. Try again.`
- `We couldn't save this product — nothing was lost. Try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# AliExpress couldn't return products. Please try your search again in a moment.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products
When one supplier fails, retry that supplier; keep results already loaded from others. For unavailable live data, check or reconnect the named supplier through its official flow. Allow its sign-in window to complete and recheck the intended account. A supplier unavailable to the workspace requires access to be made available; reconnecting cannot grant that access.
Finish store setup before importing. A backend-update requirement needs Runner support if no update action is offered. Enter each required variant price and correct the search price range. Use Best match or 180-day orders where AliExpress cannot sort reliably by price. After an Add failure, inspect Products before retrying, especially if the message says the product may already exist. Success means the intended product appears once with the chosen variants and prices.
**Messages covered:**
- `AliExpress cannot reliably sort by price. Best match and 180-day orders remain available.`
- `AliExpress couldn't return products. Please try your search again in a moment.`
- `AliExpress didn't respond`
- `We couldn't open AliExpress sign-in. Try again.`
- `AliExpress is still connected. Disconnecting didn't go through. Try again.`
- `Try again. If it keeps failing, reconnect your account.`
- `We couldn't check your AliExpress connection`
- `Your store backend isn't ready for product imports. Finish store setup, then try again.`
- `Your store backend needs an update before you can add this product.`
- `The product wasn't added to your store. Try again.`
- `Please enter a price for {variant}.`
- `This supplier isn't available to your workspace yet.`
- `Couldn't load {providers}. Results from your other suppliers are still here. Retry just the one that failed.`
- `This product isn't in the preview. Connect the supplier to see it live, or browse the preview catalog.`
- `Live supplier data is unavailable. Try again or reconnect your supplier account.`
- `Enter a valid price range. The minimum can't exceed the maximum.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Email settings didn't load. Refresh to try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/email-preview-and-saving
A failed preview has not rendered the email; keep the editor open and retry Preview. Preserve your edited content before refreshing if saving failed. Reopen the saved email to confirm the intended subject and body, then preview again before sending. A successful save or preview does not mean an email was sent. If the error persists, report the email identifier and whether preview or save failed.
**Messages covered:**
- `Email settings didn't load. Refresh to try again.`
- `Email template not found.`
- `Preview didn't render. Your edits are still here. Try again.`
- `Changes didn't save. Try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't pull that message back — it's still queued.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/experiment-changes-traffic-and-results
Refresh results when they cannot load; the experiment can still be running. A failed stop, cancellation, approval, or traffic change leaves the stated running/queued/traffic state in effect. Inspect that state before repeating the action. Preserve your pending request or edits, and retry only the intended operation.
For a failed launch, no store change occurred as stated. For missing project context, reload the store and try again. Confirm the experiment's status, traffic share, and applied result after recovery, rather than assuming the error stopped traffic. Escalate with the experiment and request identifiers if the state is unclear.
**Messages covered:**
- `We couldn't pull that message back — it's still queued.`
- `Your message didn't send — nothing was lost, try again.`
- `Visitors go back to your current store right away. This test can't be resumed.`
- `We couldn't put the changes live — your store is unchanged. {message}`
- `We couldn't find this store — reload the page and try again.`
- `We couldn't stop it — the experiment is still running. {message}`
- `We couldn't apply that — traffic is unchanged. {message}`
- `We couldn't dismiss that — please try again. {message}`
- `We couldn't change the traffic share — it's unchanged. {message}`
- `We couldn't load your results right now, but your experiment is still running. Refresh to try again.`
- `We couldn't start Experiments. Nothing changed on your store — try once more.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# That didn't go through. Your draft is safe. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/marketing-email-action-did-not-complete
`That didn't go through. Your draft is safe. Try again.` is the fallback when an email action, including an automated-email toggle, fails without a more specific detail. Inspect the affected email and its current enabled/disabled status before repeating the action. Preserve the draft and retry the intended action; verify the saved content or toggle state afterward. A successful toggle is not proof an email was sent. If it repeats, report the email/template identifier and the action you took.
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# {variant}: price cannot be negative
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/negative-supplier-prices
`{variant}: price cannot be negative` prevents the Add before submission. Enter a nonnegative price for the named variant and satisfy any minimum retail price shown. Check every selected variant before trying Add again. Confirm the product has the intended variant prices after it is added.
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# That didn't go through — the order is unchanged. Try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment
Refresh order and supplier-fulfillment status before taking another action. An unavailable Printful item or fulfillment detail is not permission to send the order manually. Check the provider's current order/payment/production state before any retry that could charge, refund, cancel, or start fulfillment.
For manual payment, manual cancellation, or manual review, follow the named provider action on the existing order. If the result is uncertain, ask support to reconcile that order rather than creating another fulfillment. Success is the intended status on both the Runner order and supplier record.
**Messages covered:**
- `That didn't go through — the order is unchanged. Try again.`
- `We couldn’t update this Printful fulfillment. Refresh its status before taking another action.`
- `Item details are unavailable. Refresh before sending this order to production.`
- `We couldn’t load Printful fulfillment details. Refresh before managing this order manually.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't reach Printful
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog
Retry a failed catalog or connection check from Print on Demand. If Runner cannot reach Printful, check the existing connection first, then retry. A connection-status error after disconnecting requires a refresh before another disconnect attempt. Select another blank product when Printful cannot provide usable options.
A missing rating, size guide, delivery estimate, or provider dimension is missing supplier data; do not treat it as a measured value. The shared-app webhook setup message requires a Runner operator, with no store-side reconfiguration. Recovery is confirmed when the connection check succeeds and the required catalog/design options load. Escalate repeated provider failures with the blank product and variant.
**Messages covered:**
- `This design could not be deleted. Please try again.`
- `Your saved designs didn't load, but they're safe. Please try again.`
- `More saved designs could not be loaded. Try again.`
- `Catalog sync unavailable`
- `We couldn't load the product catalog`
- `Your designs and Printful connection are safe. Try loading the catalog again.`
- `This product is unavailable.`
- `The catalog is still available. Try again before connecting or designing.`
- `We couldn't check your Printful connection`
- `Connection status unavailable`
- `Runner could not confirm the Printful connection status. Refresh before trying again.`
- `Provider dimensions unavailable`
- `We can't estimate delivery to this market yet.`
- `Printful hasn't priced this size with this technique — try another combination.`
- `Provider rating unavailable`
- `Size guide unavailable from provider`
- `Your designs are safe. Check the Printful connection, then try again.`
- `We couldn't reach Printful`
- `This blank product is unavailable`
- `Printful cannot provide usable design options for this product. Return to the catalog and choose another product.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Current Printful options could not be loaded. Your design is unchanged.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork
A conflicting edit means your view is no longer current. Preserve any unsaved text or artwork you need, then return to the catalog or Saved designs and reopen the latest design. Reload a changed product before editing it again. Do not repeatedly save a stale view.
For missing print templates or unverified design provenance, choose the different product, size, colour, technique, or artwork requested by the message. For invalid uploads, use the supported formats and size shown below; upload again if size information is missing. A rendering or operation failure can be retried without assuming the artwork itself is invalid. Confirm the intended print area renders and the saved design reopens with your changes. Escalate a repeat failure with the design and selected variant identifiers.
**Messages covered:**
- `Current Printful options could not be loaded. Your design is unchanged.`
- `The text artwork could not be created. Your design is unchanged.`
- `Reduce the font size or shorten the longest line so the printed text is not clipped.`
- `The print template or artwork could not be displayed. Try again.`
- `Unable to display this print area`
- `To avoid overwriting those changes, go back to the catalog and reopen it.`
- `This design was updated somewhere else`
- `Connect Printful to continue`
- `Try again — if it keeps failing, reopen it from Saved designs.`
- `This design didn't load`
- `Return to the catalog to choose or create a design.`
- `This design is unavailable`
- `This image can't be used for printing — it's missing size information. Upload it again.`
- `The last change failed`
- `Your design is unchanged. Try the action again.`
- `Your unsaved design is still here. Return to the catalog and reopen or start the design again.`
- `This design cannot be saved`
- `Quality cannot be calculated for this selection`
- `The background could not be removed. Your artwork is unchanged.`
- `Requires {dpi} DPI`
- `Choose a valid JPEG, PNG, WebP, or SVG image up to 18 MB.`
- `Printful can't supply a print template for this combination — pick a different size, colour or technique.`
- `Runner could not verify this selection with Printful. Try again.`
- `This print-on-demand product changed. Reload it before editing again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Printful pricing didn't load. Retry to ensure your profit numbers are correct before creating this product.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication
Resolve the specific missing value before creating or publishing the product: refresh supplier pricing, enter a price for every selected variant, review changed variants in the designer, and use a shorter title or description when requested. Missing supplier costs or templates require another supported selection, not a guessed value.
Reconnect Printful when shipping authorization has expired. Turning off the shipping estimate in this review is an offered way to continue; it does not establish that live checkout shipping is configured. If the draft exists but cannot be opened, find it in Products rather than creating it again. A publication failure leaves a draft; inspect its status before retrying publication. Do not delete a Printful product while creation is pending or it is active.
Completed mockups remain usable when only some failed. Check the selected listing images and product state after recovery. For a manual-recovery or duplicate-task warning, use the [uncertain-outcome recovery steps](/en/guides/help-and-reference/error-playbook-store-and-apps/product-imports-with-an-uncertain-outcome).
**Messages covered:**
- `Printful pricing didn't load. Retry to ensure your profit numbers are correct before creating this product.`
- `Printful does not provide a base cost for the selected variant with {technique}. Edit the design or choose another product.`
- `Enter a shorter product description.`
- `Your product draft couldn't be saved. Your design and pricing are safe. Please try again.`
- `The selected variants changed. Return to the designer and review them.`
- `Printful could not finish these mockups. Your saved design is unchanged.`
- `Some Printful mockups were unavailable. All completed mockups are shown below.`
- `Printful mockups are unavailable for this product and design.`
- `These product details are too long to save. Please shorten the description.`
- `Enter a valid nonnegative price.`
- `Enter a price for this variant.`
- `Shipping estimate could not be loaded. Try again, or turn off shipping to continue.`
- `Printful authorization expired. Reconnect Printful, or turn off shipping to continue.`
- `Shipping is unavailable for this product and destination. Turn off shipping to continue.`
- `Enter a shorter product title.`
- `This product draft could not be created. Your saved design is unchanged.`
- `Your product stayed a draft. Publishing didn't go through. Please try again.`
- `This saved design is no longer available for a product draft.`
- `The product draft was created, but Runner could not open it. Try again.`
- `Store currencies could not be loaded. You can review the product now, but retry before creating it.`
- `This Printful-managed product can't be deleted while it is being created or active.`
- `This POD product is unavailable`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't read that file. Make sure it's a CSV and try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/product-csv-import
Choose the requested CSV file and ensure it is readable. If a read error persists, check the file locally and export it again. For an import failure, inspect Products and any item-level import results before retrying to avoid duplicate products. Keep the displayed error details for Runner; do not infer a specific file defect from the generic Import Failed title.
**Messages covered:**
- `We couldn't read that file. Make sure it's a CSV and try again.`
- `Import Failed`
- `Invalid File Type`
- `Please select a CSV file.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# This product couldn't be added. It may already be in your store. Check Products, then try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/product-imports-with-an-uncertain-outcome
The request may have reached the supplier or created a store product before Runner could confirm it. Open Products and inspect the current item/status before another Add. For Printful product-draft recovery, do not resubmit; ask support to reconcile the existing draft. A failed deletion that explicitly needs support also requires support review.
For a mockup request with the duplicate-task warning, follow its specific instruction: edit and save the design as a new revision before trying again. Success means one intended product or mockup revision is present, with a confirmed status; disappearance of the toast is not proof.
**Messages covered:**
- `Printful may have accepted this mockup request. To avoid a duplicate task, edit and save the design as a new revision before trying again.`
- `Runner couldn't finish this product draft cleanly. Don't submit it again. Check its status first to avoid duplicates.`
- `We couldn't finish removing a product. Our support team needs to review it.`
- `This product couldn't be added. It may already be in your store. Check Products, then try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't run the audit — your last results are still here. Try again in a few minutes.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/seo-reports-audits-and-ai-visibility
A failed audit or analysis can leave the last report visible. Retry analysis after a few minutes; check the report's date before treating it as new. If only page speed or one model is unavailable, use the completed sections and rerun only to obtain the missing result.
For an unreachable store, open the public URL in a private browser window and resolve its loading problem before analyzing again. Use an HTTP or HTTPS URL without embedded credentials. Missing environment credentials require administrator setup; no-data messages require more search data, not repeated retries. Only a workspace owner or admin can connect Google Search Console.
Correct the named input constraints before submitting again. If opening a fix chat fails, no fix was sent: reopen it and confirm the request appears before expecting a change. Success means the requested report section has a fresh result. Report persistent failures with the public URL, section, and run time.
**Messages covered:**
- `Enter a valid competitor name or public domain.`
- `We couldn't run the audit — your last results are still here. Try again in a few minutes.`
- `We couldn't check AI answers for your brand this time. Try again in a few minutes.`
- `We couldn't get AI answers for that question. Try again in a few minutes.`
- `We couldn't open a chat for this fix — nothing was sent. Try again.`
- `Only a workspace owner or admin can connect Google Search Console.`
- `We couldn't finish analyzing your store — your last report is still here. Try again in a few minutes.`
- `Enter a whole number from {min} to {max}.`
- `We couldn't measure your page speed this time, but the rest of your audit is ready below. Run it again to retry.`
- `We couldn't load your past checks. Retry to see them.`
- `We couldn't finish checking AI answers. Your last results are still here. Try again in a few minutes.`
- `This model didn't answer during that run.`
- `We couldn't get answers from the AI models this time. Try again in a few minutes.`
- `We couldn't get this data right now — analyze again in a few minutes.`
- `Enter an HTTP or HTTPS URL without a username or password.`
- `Search data isn't available right now`
- `Link data isn't available right now`
- `Site health isn't available right now`
- `Search data isn't set up on this environment yet. Check back once your administrator finishes setup.`
- `There isn't enough search data about your store yet. This section will fill in as your store gets more traffic. Check back later.`
- `This part of the report didn't come through. Analyze again in a few minutes.`
- `We couldn't open your store from the outside. Check if it loads in a private browser window, then analyze again.`
- `The rest of your report is still here.`
- `Unreachable`
- `Pages blocked from crawling`
- `Conflicting canonical URLs`
- `Pages returning server errors`
- `Fix the failing route or dependency so the page returns a successful response reliably.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# The import didn't start. Your Shopify data is untouched. Please try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/shopify-migration-and-import
Use the Shopify store address and app credentials for the same source store. Correct missing read access by updating access, releasing the app version, and reinstalling as directed; only a store owner or administrator can change or start the migration. Enter credentials only in the connection form.
For CSV errors, use a recognizable Shopify export, within the displayed upload limit, with actual rows. Split oversized row sets into multiple files. Wait for store preparation or retry store setup before importing. Resume an unfinished import rather than starting another. When an import needs attention, successful records remain; review missing/invalid/conflicting items before retrying them.
A failed progress refresh does not mean the import stopped. Reload status and check imported data. Success means the migration summary and target records agree; use the affected stage/item and migration ID to escalate.
**Messages covered:**
- `Could not copy automatically. Select the scopes and copy them manually.`
- `Enter a valid store-name.myshopify.com address.`
- `Required user access`
- `Configure or confirm Protected customer data access for customer names, email addresses, and physical addresses. These fields are required to migrate complete customer records.`
- `On the app Overview, use Install app in the Installs card. Choose the source store, review the read-only permissions, then press Install. Shopify’s unreviewed-app warning is expected for an app you created yourself. If the app was already installed before you added the required access, install it again and approve the updated permissions.`
- `Could not open a new chat. Try again.`
- `Enter the website you want Runner to use as a visual reference.`
- `{count} failed`
- `This app is missing Shopify read access required for migration. Update the access, release a new version, and reinstall the app.`
- `Only a store owner or administrator can change or start a migration.`
- `This CSV file is empty.`
- `Runner could not recognise this Shopify CSV export. Check the file and try again.`
- `Only Shopify CSV exports can be added to this import.`
- `This CSV file is larger than the 25 MB upload limit.`
- `This CSV file has more rows than Runner supports. Split the export into multiple files.`
- `Shopify could not verify those app credentials. Check the Client ID and secret.`
- `The Store Migration is no longer available.`
- `The migration request didn't go through. Nothing was changed. Please try again.`
- `We couldn't check whether your store is ready. We'll try again automatically.`
- `Those app credentials do not belong to the Shopify store you are importing.`
- `The import didn't start. Your Shopify data is untouched. Please try again.`
- `Your store is still being prepared. Please wait a moment and try again.`
- `Your store couldn't finish setup. Retry store setup before starting a migration.`
- `This store already has an unfinished {source} import. Resume it here before starting another.`
- `This item conflicts with data already in the store and needs review.`
- `This item contains data Runner could not migrate safely.`
- `This item is missing data required for migration.`
- `The import stopped before every stage finished. Successfully imported records remain safe.`
- `Import needs attention`
- `Progress could not refresh: {error}`
- `Review records that could not be migrated and the reason for each failure.`
- `Could not load the imported data.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# This factor can't be changed with a single value here.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/simulation-interventions-failed-runs-and-handing-fixes-to-runner
`This factor can't be changed with a single value here.` means the selected factor is not supported by the single-value intervention control. Choose a supported factor, such as headline, caption, visual style, or duration. Do not keep submitting a different text value for the same unsupported factor. Confirm a new prediction appears after an accepted change.
`Didn't finish: {message}` records the actual failure detail from the simulation request. Read that detail and correct a named input problem before retrying. Check for an existing run and its status first; this generic message does not say which stage failed or whether a run was created. If the detail offers no safe action, send Runner the run/session identifier and the full visible message.
`We couldn't hand this to Runner — nothing was sent. Try again.` means creating the recommendation handoff failed. Retry from the recommendation and confirm it appears in the destination chat. `We couldn't open the chat with Runner — try again.` happens after handoff creation succeeded but opening the chat failed: check the existing handoff and chats before creating another one. Do not assume a fix ran merely because the handoff exists.
For `We couldn't start the re-test — try again.`, inspect the recommendation's existing re-test/run state before retrying. Recovery means the intended re-test appears and eventually has results; it is not proven by a successful click. Escalate persistent failures with the original run, recommendation, and re-test identifiers.
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# This file is over the 512 KB limit — pick a smaller one
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/skills-configuration-and-imports
Fill in the required name, description, and content. Use a valid import URL, and select another file if Runner cannot read the file or rejects its path. A failed import adds no skills when the message says so; inspect the list before retrying other outcomes. Refresh unavailable translations and verify the intended skill content after saving/importing. For missing organization context, reopen Skills from the intended workspace. If this persists, report the workspace and skill name without private skill contents.
**Messages covered:**
- `This file is over the 512 KB limit — pick a smaller one`
- `Invalid file path`
- `We couldn’t read that file. Try another.`
- `Couldn't load category translations.`
- `Organization ID is required`
- `Please fill in the required fields (name, description, content)`
- `Too large (≈{size})`
- `binary over {limit}`
- `text over {limit}`
- `We couldn’t import these skills — nothing was added. Check the URL and try again.`
- `Please enter a URL`
- `We couldn't find any skills matching "{search}". Try a different term.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn’t load Store Operations. Your store data is safe.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/store-setup-products-customers-shipping-and-promotions
For a load failure, retry or refresh the affected Store Operations section. For a failed save, preserve entered values and inspect the current item before saving again. A failed delete leaves the item present or promotion live as stated; verify the list before repeating it. For a partial bulk import, review imported products and retry only failed items.
Validation errors name fields to correct. Save Markets and Stock Locations before adding their shipping options. Add a stock location under General before saving inventory counts. Use non-overlapping cart-total ranges with a rate for each range; edit an existing Ship from/Ship to option instead of duplicating it. A sale price must be below the regular price and meet any displayed minimum retail price.
After recovery, reopen the item to confirm saved values. For shipping, confirm the intended destination and cart total have the expected shipping choice. Escalate persistent load/save failures with the section and affected record, not customer payment details.
**Messages covered:**
- `We couldn’t load Store Operations. Your store data is safe.`
- `Your setup is saved. The storefront build needs attention — head back to the chat and we’ll fix it together.`
- `We couldn’t load your setup milestones. Please try again shortly.`
- `We couldn’t load supplier products. Try again.`
- `We couldn’t add this product. Try again.`
- `We couldn’t configure checkout shipping. Your progress wasn’t changed—try again.`
- `Needs attention`
- `Store setup isn’t available for this project yet.`
- `This customer is still here — deleting didn't go through. Try again.`
- `Customers didn't load — refresh to try again.`
- `Your changes didn't save. Please try again.`
- `We couldn't add this customer. Please try again.`
- `Your changes didn't save. Please try again.`
- `Please enter a valid email`
- `Please enter a valid email address`
- `That didn't save — nothing was lost, try again.`
- `The product is still in your store — deleting didn't go through. Try again.`
- `Your products didn't load — refresh to try again.`
- `Image could not be compressed enough for upload. Please use a smaller image.`
- `File is too large. Maximum size is {maxSize}.`
- `Unsupported file format. Please use JPEG, PNG, GIF, or WebP.`
- `Stock counts couldn't be saved because you haven't set where you ship from. Add a stock location under General, then set inventory.`
- `The image didn't upload — your product is unchanged. Try again.`
- `Two ranges overlap, so a cart total would match both. Adjust the limits.`
- `Each price range must have a minimum or maximum cart total`
- `Please enter a shipping price`
- `Please enter a shipping rate for each price range`
- `Shipping options didn't load — refresh to try again.`
- `Tell us where you ship from first — add a stock location above.`
- `Stock locations didn't load — refresh to try again.`
- `Your store settings didn't load — refresh to try again.`
- `Invalid email format`
- `Product name is required`
- `Product status is required`
- `Shipping destination country is required`
- `Shipping option name is required`
- `Stock location address is required`
- `Stock location region is required`
- `Store name is required`
- `Contact email is required`
- `Business country is required`
- `Select a valid business country`
- `Street address is required`
- `Please fix the following errors`
- `Failed to create product. Please try again.`
- `Failed to load products. Please try again.`
- `Failed to update product. Please try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# We couldn't connect CJ — double-check the API key and try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/supplier-credentials-stripe-setup-and-customer-email-connections
Check the credential named by the message in the provider account, then enter it in Runner's connection form. Never paste API keys or secrets into chat. Retry the official setup link when Stripe setup cannot open; inspect the returned account and setup status before attempting it again. A failed disconnect can leave the integration active, so refresh its status first.
For customer email enable/disable failures, the previous on/off state remains as the message states. Check that state before retrying; do not send customers a test message to determine it. Recovery is confirmed by the intended connection or email setting persisting after a refresh. Escalate with the provider and failed operation if it persists.
**Messages covered:**
- `We couldn't connect CJ — double-check the API key and try again.`
- `CJ is limiting requests for this account. Wait a few minutes, then try again.`
- `CJ didn't respond. Try again in a moment.`
- `We couldn't disconnect CJ — it's still connected. Try again.`
- `We couldn't connect 4PX — check the key and secret, then try again.`
- `We couldn't disconnect 4PX — it's still connected. Try again.`
- `We couldn't turn off customer emails — they're still on. Try again.`
- `We couldn't turn on customer emails — they're still off. Try again.`
- `We couldn't connect Shippo — check the API key and try again.`
- `We couldn't disconnect Shippo — it's still connected. Try again.`
- `Invalid API key. Please check your Shippo API key.`
- `We couldn't connect your Shopify store — nothing changed on Shopify. Try again.`
- `Failed to disconnect Shopify store`
- `Shopify sent back something we couldn't verify. Start the connection again.`
- `Connection link expired. Please start over.`
- `Shopify connected but didn't let Runner read your storefront. Reinstall the Runner app and approve all permissions.`
- `Invalid shop domain. Use the format .myshopify.com`
- `We couldn't connect Stripe — try again.`
- `We couldn't open Stripe setup — try again in a moment.`
- `We couldn't disconnect Stripe — it's still connected. Try again.`
- `We couldn't reopen Stripe setup — please try again.`
- `We couldn't reopen Stripe setup. What you already entered in Stripe is saved — try again.`
- `Couldn't reopen Stripe setup`
- `Stripe is set up, but we couldn't switch it on for your store. Try again.`
- `Couldn't switch on payments`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Webhooks didn't load. Refresh to try again.
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/webhooks-and-delivery-recovery
Retry failed endpoint, settings, log, activity, attempt-history, or test-result reads. A missing test result is not proof that a test was never delivered. For endpoint creation, check the URL; inspect the endpoint list before retrying a mutation. A failed deletion may leave deliveries active, and a failed secret rotation leaves the current signing secret usable.
Correct the whole-number delivery rate or time-range validation before saving. For failed replay/recovery, inspect delivery logs and the selected endpoint/range before sending again; the receiver may already have processed an event. Confirm the receiving system handles retries safely. Use the UI confirmation for the intended replay range, and verify the receiver's result as well as Runner's attempt status.
If setup cannot restart, use Retry and let the setup check finish. Escalate persistent failures with endpoint/delivery identifiers, status, and timestamps. Never share signing secrets or custom authorization headers.
**Messages covered:**
- `Failed deliveries`
- `Webhooks didn't load. Refresh to try again.`
- `Webhooks couldn't load. Select Retry to try again.`
- `Webhook setup couldn't be restarted. Select Retry to try again. We'll keep checking whether setup completes.`
- `The endpoint wasn't created. Check the URL and try again.`
- `The endpoint is still active. Deleting didn't go through. Try again.`
- `Couldn’t load attempt history`
- `Couldn’t load delivery activity`
- `Couldn’t load delivery attempts`
- `Couldn’t load delivery logs`
- `Couldn’t load endpoint settings`
- `Couldn’t load the test result`
- `Couldn’t reveal signing secret`
- `Couldn’t copy signing secret`
- `The secret wasn't rotated. Your current one still works. Try again.`
- `Couldn’t save custom headers`
- `The test didn't send. Please try again.`
- `Recovery didn't start. Nothing was resent. Try again.`
- `Couldn’t update delivery rate`
- `Enter a whole number of at least 1.`
- `Your changes didn't save. The endpoint is unchanged. Try again.`
- `Couldn’t start replay`
- `The end time must be after the start time.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Conflict — your changes were not saved
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/workflow-editing-validation-and-conflicting-saves
Correct the named field, node, connection, JSON, schedule, or file before retrying. Connections must use compatible inputs/outputs and cannot create cycles. Use a valid workflow export for import.
For a save conflict, preserve any local edits you need before choosing Reload server version: that action replaces the local workflow and unsaved node changes. Reopen a node when its underlying workflow changed. If the draft changes during deployment review, close the review and open Deploy again. A restored draft that requests a reload is already restored; reload the canvas rather than restoring again.
A comparison/history load failure does not change the deployed workflow. Refresh a rollback conflict to see what another person deployed. Confirm the saved draft, restored canvas, or active version matches your intent before deploying or enabling a trigger. If uncertainty remains, provide the workflow and version identifiers to support.
**Messages covered:**
- `Add a short note describing what changed.`
- `The draft changed after this review started. Close this review and open Deploy again.`
- `Invalid JSON.`
- `That output cannot connect to this input. Choose compatible nodes that do not create a cycle.`
- `Couldn’t update custom inputs or outputs: {message}`
- `Enter a node name before saving.`
- `Payload must be a JSON object.`
- `Schedule configuration is invalid.`
- `Publish your store to use Live Test. Simulate still works.`
- `The workflow changed while you were editing. Your draft is preserved. Discard it and reopen this node to review the latest changes.`
- `Couldn’t finish saving before restoring. Please try again.`
- `The draft was restored, but the canvas needs to be reloaded.`
- `Couldn’t verify the current draft version. Please refresh and try again.`
- `Save failed`
- `Couldn’t compare this version with the active deployment.`
- `Couldn’t compare this saved draft with the current canvas.`
- `Couldn’t load this saved draft for comparison.`
- `Your saved drafts are still safe. Check your connection and try again.`
- `Couldn’t load draft history`
- `Check your connection and try again.`
- `Couldn’t load version history`
- `Couldn’t restore this draft. Please try again.`
- `Couldn’t prepare this restore.`
- `Someone else deployed while you were rolling back. Please refresh.`
- `Rollback failed`
- `This file is not a valid workflow export.`
- `Could not read this file.`
- `Conflict — your changes were not saved`
- `Reload server version`
- `This replaces your local workflow and any unsaved node changes with the latest server version.`
- `Reload server version?`
- `Resolve the save conflict before deploying.`
- `Node “{nodeId}” is missing required field “{fieldName}”`
- `Node “{nodeId}” has an invalid Marketing Email source or delivery policy`
- `Node “{nodeId}” has an invalid transactional email render source`
- `Enter a valid 5-field cron expression.`
- `Enter a valid IANA timezone, such as America/Los_Angeles.`
- `An agent changed this node`
- `The agent removed the node you’re editing. Reload the agent’s changes or discard them to keep your draft.`
- `Reload agent changes`
- `Discard agent changes`
- `Your staged connection now conflicts with the agent's changes. Adjust or remove the connection, then try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Run failed
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/error-playbook-store-and-apps/workflow-runs-triggers-and-management
For a workflow list, template, event catalog, run detail, or health-check load failure, retry that view. Live Test remains unavailable while its health check fails, and requires a published store; Simulate remains available when stated.
For a failed run, inspect the failed step and completed outputs. Retry only when that step offers a safe retry: earlier steps may already have sent messages or changed external data. A failed stop, pause, resume, or trigger removal requires inspecting current run/trigger state before assuming it took effect.
For batch operations with partial success, retry remaining/failed items only. For failed create, duplicate, rename, pin, delete, or deploy, inspect the workflow list or active deployment before repeating. Success means the intended saved/deployed state or trigger status is shown; a run is recovered only after its required steps and external results succeed. Escalate with the workflow, run, and failed step.
**Messages covered:**
- `Couldn’t pause {triggers}.`
- `Paused {triggers}. {failed} could not be paused.`
- `We lost track of this project. Refresh to continue.`
- `Project unavailable. Please refresh and try again.`
- `We couldn’t delete the selected workflows. Try again.`
- `None of the {count} workflows could be deleted. They remain selected so you can try again.`
- `Deleted {deleted} of {total} workflows. {failed} remain selected so you can try again.`
- `We couldn’t delete this workflow. Try again.`
- `We couldn’t duplicate this workflow. Try again.`
- `We couldn’t export your selection. Try again.`
- `Exported {exported} of {total} workflows. Try the failed items again.`
- `We couldn’t update the pinned state. Try again.`
- `We couldn’t rename this workflow. Try again.`
- `Your workflows are still safe. Check your connection and try loading the list again.`
- `We couldn’t load workflows`
- `We couldn’t create the workflow. Try again.`
- `We couldn’t load templates. Try again, or start from blank.`
- `Couldn’t deploy the workflow. Try again.`
- `Recent events could not be loaded.`
- `Unable to load run details`
- `Upload failed`
- `Save or discard these changes before duplicating the node.`
- `The selected run is still available. Check your connection and try again.`
- `Run failed`
- `Completed steps and their outputs remain available below. Retry only when the failed step offers a safe retry.`
- `Open Playground and run a safe simulation to create the first entry. Simulate is available once the draft has an action, logic, code, or data step.`
- `Your run history is still safe. Check your connection and try again.`
- `Couldn’t load runs`
- `Couldn’t prepare the change preview.`
- `Workflow version is unavailable. Refresh before deploying.`
- `Workflow not found`
- `Live Test is unavailable right now.`
- `Your organization’s event catalog is unavailable. Retry before choosing an event trigger.`
- `Couldn’t load events`
- `Failed to load workflows`
- `Couldn’t pause the trigger.`
- `Couldn’t remove the trigger.`
- `Couldn’t resume the trigger.`
- `Retry failed`
- `Retry failed: {status}`
- `A required store link could not be built from this event.`
- `Workflow health couldn’t be loaded`
- `Live Test stays unavailable until the health check works again.`
- `Could not stop this run. Try again.`
For repeated failures, see [what to send Runner](/en/guides/help-and-reference/error-playbook-store-and-apps).
---
# Frequently asked questions
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/faq
**Entry path:** Runner documentation → **Help and reference** → **FAQ**.
### Can I start without technical experience?
Yes. Describe the business and desired customer experience in plain language. Runner may ask follow-up questions before it starts work. See [Write effective requests](../work-with-runner/write-effective-requests).
### Should I build a new store or connect Shopify?
Choose **Build new** when Runner should create the store project and its commerce setup. Choose **Connect Shopify** when Shopify should remain the connected store system and checkout path. See [Create a Runner store](../start-here/create-runner-store) and [Connect Shopify](../start-here/connect-shopify).
### Does a completed Runner task mean my store is live?
No. Task completion, preview success, publication, live storefront, catalog, and checkout are separate results. Verify each relevant layer.
### What is the difference between Publish and Republish?
**Publish** creates the first live version after requirements are complete. **Republish** sends newer draft changes to a store that already has a live version. See [Publish and republish](../storefront-and-publishing/publish-and-republish).
### Why is a button disabled?
Required input, permission, plan access, store state, data, or a connection may be missing. Read nearby text and see [States and availability](./states-and-availability).
### Why is a navigation entry missing?
Some features are conditional or staged. Confirm the workspace, store, role, plan, publication, and connections. See [Feature availability](../advanced/feature-availability).
### Where do I manage products and orders?
Open the store project, select **Store Operations**, then choose **Products** or **Orders**. See [Store Operations](../store-operations).
### Where do I connect payments, email, or shipping?
Open the project and select **Apps**. Choose the provider and follow its official connection flow. See [Apps and integrations](../apps-and-integrations).
### How do I undo a storefront change?
First send a focused correction or use [Version history](../storefront-and-publishing/version-history). Restoring a version changes project state, so review the selected version before confirming.
### Why are Analytics or SEO empty?
The selected store, date range, publication, or event collection may not yet have data. An empty state is different from a loading or error state. See [Analytics and SEO](../analytics-and-seo).
### Where do I see credits and usage?
Open workspace settings and select the usage or billing destination available to your role. See [Credits and usage](../plans-and-billing/credits-and-usage).
### How do I get help?
Use [Support and community](./support-and-community). Include the exact page, action, visible state, and a privacy-safe screenshot.
## Where should I start?
For a guided first build with screenshots and recordings, follow [Build your first store](../start-here/first-store-quickstart). If work is already in progress, use [Troubleshoot Runner tasks](./troubleshoot-runner-tasks) before sending the same request again.
---
# Glossary
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/glossary
**Entry path:** Runner documentation → **Help and reference** → **Glossary**.
| Term | Meaning in Runner |
| --- | --- |
| Agent | Runner capabilities that use reusable Skills and project or workspace Memory. |
| App | A connection between Runner and another service, or an agent-level capability shown on the Apps page. |
| Artifact | An output produced during a task or workflow, such as a report, file, preview, or earlier task result. |
| Automation | A configured action that runs from a trigger or schedule when available. |
| Chat | A project conversation where you request and review work. |
| Checkout | The customer path that collects shipping and payment to create an order. |
| Credits | Workspace usage allowance shown in the current product. The live billing page is authoritative. |
| Design Mode | A storefront editing view for selecting and changing visible content. |
| DNS | The internet records that connect a domain name to the correct storefront. Runner shows the values to copy into your domain provider. |
| Drafted | A store without a current live publication. |
| Endpoint | A destination address used by an integration, such as a webhook receiver. Treat endpoint addresses and their credentials as sensitive. |
| Experiment | A controlled comparison used to measure a change when the feature is available. |
| Fly | A conditional guided mission workspace. |
| Fulfillment | The work of preparing and sending items from an order, including any supported supplier or shipping-provider steps. |
| Memory | Saved context Runner can reuse at its defined scope. |
| Media Library | The project's place for generated or uploaded visual assets. |
| Preview | The current project storefront view before or independent of publication. |
| Project | The store-specific Runner workspace containing chat, storefront, operations, apps, and tools. |
| Provider | An outside service connected to Runner for payments, shipping, email, sourcing, analytics, or another supported task. |
| Publish | Create the first live version after requirements pass. |
| Republish | Send newer draft changes to a store that already has a live version. |
| Research | A conditional workspace for structured business studies and reports. |
| Session (Analytics) | A recorded storefront visit used in traffic and conversion reports. It is different from a signed-in account session. |
| Session (Account) | A signed-in Runner connection on a browser or device that can be reviewed or revoked in security settings. |
| Simulation | A tool for running a configured scenario and reviewing its result when available. |
| Skill | A reusable set of instructions or workflow that Runner can apply to work. |
| SKU | A store-defined code used to identify a product or variant for inventory and operations. |
| Store Operations | Product, order, customer, promotion, shipping, sourcing, and store-management pages. |
| Task | A unit of work Runner tracks inside a conversation. |
| Variant | A purchasable version of a product, such as a particular size or color, with its own price or inventory. |
| Version | A saved storefront state shown in Version History. |
| Webhook | A configured delivery of a supported project event to another service. |
| Workflow | A reusable multi-step project flow when the feature is enabled. |
| Workspace | The team and billing boundary that contains stores, members, settings, credits, and notifications. |
## Use the terms in a real workflow
Follow [Build your first store](../start-here/first-store-quickstart) to see a conversation, task, preview, and publication check in context. For a status message, use [States and availability](./states-and-availability) to choose a next action.
## Related guides
- [Welcome to Runner AI](../product-guide)
- [States and availability](./states-and-availability)
- [Feature availability](../advanced/feature-availability)
---
# States and availability
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/states-and-availability
Runner uses states to tell you whether an action is ready, waiting, complete, blocked, or unavailable. Read the state before retrying or changing settings.
**Entry path:** Runner documentation → **Help and reference** → **States and availability**.
## Store and publication states
| State | Meaning | Safe next step |
| --- | --- | --- |
| Drafted | The project does not currently have a live published version. | Continue building and complete publication requirements. |
| Deploying | Runner is preparing a publication. | Wait for the state to finish; do not start repeated publications. |
| Published | A live version exists. | Open the live URL and verify the intended change. |
| Publish blocked | One or more required setup items are incomplete. | Open the named requirement and finish it. |
| Republish available | The draft contains changes newer than the live version. | Review the preview, then republish when ready. |
## Task states
| State | Meaning | Safe next step |
| --- | --- | --- |
| Waiting for you | Runner needs an answer, choice, approval, or missing detail. | Open the question and respond once. |
| Working | The current task is still running. | Follow its details instead of starting a duplicate request. |
| Completed | Runner reached the task's terminal success state. | Verify the visible result in the affected page. |
| Stopped | Work ended before completion. | Read why it stopped, correct the cause, then continue or send a focused follow-up. |
| Failed | The task could not finish. | Save the visible error and retry only after checking the cause. |
## Page and control states
| What you see | Meaning |
| --- | --- |
| Disabled button | Required input, permission, plan, or state is missing. Nearby text usually names it. |
| Loading skeleton or spinner | Data is being requested. A persistent loading state needs a reload or support check. |
| Empty state | The page is available but the selected context has no items yet. Use the offered create or connect action. |
| Upgrade message | The current plan or limit does not allow the action. Review the live offer in **Plan & Billing**. |
| Connect or reconnect | The outside service is not connected or needs authorization again. |
| Page not found | The URL is unavailable for the current context, retired, or gated. Return through visible navigation. |
## Runner version recovery
If Runner was updated while your tab was open, a full-screen recovery page can replace the current
view. You cannot close it or use the page behind it until Runner loads a current copy.
| What you see | What happens next |
| --- | --- |
| **A newer version of Runner is ready** | Select **Load latest version** to reload the current tab with the latest Runner version. |
| **You're offline** | **Load latest version** is disabled. Reconnect to the internet; the action becomes available without leaving the recovery page. |
| **Loading latest version…** | Runner is reloading the tab. Keep it open while the action finishes. |
| **We couldn't load the latest version** | Check the connection, then select **Try again**. |
| **Technical details** | Expands the error code, reason, and detection time for troubleshooting. It does not retry or repair the page. |
## Diagnose in order
1. Confirm the selected workspace and store.
2. Expand **Sell**, **Grow**, or **Measure** to locate the tool, then read the nearest status, warning, or prerequisite.
3. Check whether the relevant task is already running.
4. Confirm your role, plan, publication state, and required app connection.
5. Reload once if the state should have just changed.
6. Use the relevant troubleshooting guide before repeating a high-impact action.
## Related guides
- [Feature availability](../advanced/feature-availability)
- [Task states and details](../work-with-runner/task-states-and-details)
- [Store statuses](../workspace/store-statuses)
- [Support and community](./support-and-community)
---
# Support and community
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/support-and-community
Use documentation for known workflows, community for shared learning, and support for account-specific or reproducible product problems.
## What this covers
You will know where each help action opens, how to book a demo or send feedback, and what to include when you need support.
## Availability and prerequisites
- You must be signed in to use the workspace or project avatar menus.
- **Send Feedback** appears only in desktop workspace or project views that expose the feedback action.
- **Book a Demo** uses an external scheduling service inside Runner and needs a working network connection.
- The mobile avatar sheet has a smaller action set than the desktop avatar menu.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgNbwG0GU2bm17vuEiZydJjwfYlOaXgBTsQ69k)
English callouts highlight the controls. Select the image to enlarge it.
The Chat help menu links to contextual help and Help center. The tutorial thumbnail is redacted in this illustration; no video was played or support report sent.
## Entry paths
| Entry | What happens after you select it |
| --- | --- |
| Page help button → **Help center** | Opens Runner documentation. |
| Page help popover → **On this page — Chat** | Opens help for the current Chat page when this context is shown. |
| Page help popover → **Your first store in five minutes** | Opens the linked starter tutorial. |
| Workspace sidebar → **Help center**, when shown | Opens Runner documentation. |
| Workspace sidebar → **Community** | Opens the Runner community in its current destination. |
| Workspace sidebar → **Blog** | Opens educational and company articles. |
| Workspace sidebar → **What's new** | Opens recent Runner product updates. |
| Desktop avatar menu → **Book a Demo** | Opens the scheduling panel inside Runner. |
| Desktop avatar menu → **Send Feedback** | Opens the feedback form when that action is available in the current view. |
| Desktop avatar menu → **Help** | Opens Runner documentation. |
| Project avatar menu → **Community**, **Blog**, or **What's new** | Opens the selected resource; **What's new** stays inside Runner, while Community and Blog open their current destinations. |
| Documentation → **Support** | Opens the configured support email action. |
## Start with help for the current page
1. Open the page help button.
2. Choose the **On this page** guide when it matches your question, or **Help center** to browse documentation.
3. If you are starting a store, choose **Your first store in five minutes** when offered.
**Checkpoint:** A help destination opens; no support report or booking has been sent. Page-specific links vary with the current view.
## Book a demo
1. On desktop, open the avatar menu and select **Book a Demo**.
2. Wait for the scheduler to load.
3. Choose an available date and time, then complete the contact details requested by the scheduler.
4. Confirm the booking in the scheduler.
5. Wait for Runner's success message and for the panel to close.
Closing the panel before the scheduler confirms the meeting does not create a booking. If the
scheduler stays blank or reports that it is unavailable, close it, check the connection, and try
once more. Use the documentation Support action if it repeatedly fails.
## Send feedback
1. On desktop, open the avatar menu and choose **Send Feedback** when shown.
2. Describe the page, action, expected result, and actual result.
3. Add an optional category and a screenshot after removing private information.
4. Review the report before selecting **Submit**. Close the form if you only want to inspect it.
5. After submitting, wait for confirmation before assuming the report was sent.
| Control | What happens after you use it |
| --- | --- |
| **Describe your feedback** | Records the required explanation. Submit stays unavailable until this field contains text. |
| **Usability Issues** / **Missing Features** | Adds an optional category so the report is easier to route. |
| Screenshot upload | Attaches an optional image to the report. Use the remove control to discard the attachment before sending. |
| **Submit** | Sends the report. While it is sending, the action cannot be submitted again. |
| Close | Closes the form without sending a new report. |
Describe one behavior, the page where it happened, and what you expected. Add a screenshot only
after removing customer information, emails, payment details, credentials, and other private data.
After a successful submission, Runner shows a confirmation and closes the form. If submission
fails, keep the description, check the attachment and connection, and retry once.
## Mobile avatar menu
On mobile, the project avatar opens **Profile & Settings**. It includes **Language**, **Inbox**,
**Help**, **Community**, **Blog**, **What's new**, and **Logout**. **Book a Demo** and **Send Feedback**
are not listed in this mobile sheet. Use a wider desktop view for those two actions, or use the
documentation Support action for a private problem.
## Send a useful support report
Include:
1. The workspace and store name, without secrets.
2. The page and exact entry path.
3. What you selected and what happened.
4. What you expected instead.
5. The visible status or error text.
6. Whether the issue repeats after one reload.
7. A screenshot with customer data, emails, payment details, and secrets removed.
For a Runner task, include the conversation and task state. For publishing, include preview status, publication state, and whether the live URL changed. For an app, include the provider and displayed connection state, but never credentials or API keys.
## Choose the channel
| Need | Best starting point |
| --- | --- |
| Learn a normal product workflow | Search these guides. |
| Compare approaches with other users | Community. |
| Follow a released product change | What's new. |
| Resolve access, billing, data, repeated errors, or private project behavior | Support. |
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Demo scheduler is loading | Wait for its date and time controls before interacting. |
| Demo confirmed | Runner shows a success message and closes the panel. Check the confirmation details sent by the scheduler. |
| Feedback Submit is unavailable | Add the required description, or wait for the current submission to finish. |
| Feedback upload fails | Remove the attachment and retry with a supported, privacy-safe image, or send the text without it. |
| Feedback submission fails | The report was not confirmed. Keep the text and retry once before using Support. |
## Related guides
- [Troubleshoot Runner tasks](./troubleshoot-runner-tasks)
- [Troubleshoot storefront builds](./troubleshoot-storefront-builds)
- [Troubleshoot publishing, checkout, and apps](./troubleshoot-publishing-checkout-apps)
- [Changelog](/en/guides/help-and-reference/changelog)
---
# Troubleshoot publishing, checkout, and apps
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/troubleshoot-publishing-checkout-apps
A successful build does not by itself prove publication, catalog data, checkout, or an outside provider. Verify each layer separately.
**Entry paths:** Affected store → **Storefront** → **Publish** for readiness checks; **Sell** → **Apps** for provider connections.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
The build check passes, but incomplete setup leaves Confirm disabled. Resolve the named requirement before retrying publication.
## Before you start
- Record the affected store, public URL, provider, and exact visible state.
- Stop before a real charge, order, provider disconnect, or other consequential action unless the test is authorized.
- Verify one layer at a time; a working Preview does not prove publication or checkout.
## Important controls and results
| Control | What happens after you select it |
| --- | --- |
| **Retry check** | Runs the failed publication or checkout readiness check again. It does not fix the named cause. |
| **Publish** / **Republish** | Starts publication after required checks pass; it does not prove catalog or checkout behavior. |
| **Connect Stripe** | Opens the payment connection path. No payment is accepted until the provider and live checkout are usable. |
| **Reconnect** in Apps | Restarts the provider's official authorization flow for the existing connection. |
## Identify the failing layer
| Layer | Proof to look for | If it is missing |
| --- | --- | --- |
| Preview | The intended page and interaction work in **Storefront**. | Fix the build or content before publishing. |
| Publication | Runner shows a successful published state and a live URL. | Open publication status and resolve the named requirement or error. |
| Live storefront | The live URL shows the intended version in a fresh visit. | Check whether newer changes require **Republish**. |
| Catalog | The expected product, price, availability, and shipping choice are visible. | Correct Store Operations data and storefront availability. |
| Checkout | A safe test can reach the expected checkout and payment/shipping choices. | Check payment, shipping, store mode, and provider status. Do not place a real order unless authorized. |
| Provider | The app shows connected and the provider confirms the expected account. | Reconnect through the official app flow and recheck permissions. |
## Publish recovery
1. Open **Storefront** → **Publish** and read the readiness checks. Stop at a missing Stripe, shipping, or other named requirement; resolve it using [Prepare to publish](../storefront-and-publishing/prepare-to-publish) before retrying.
2. Check whether another publication is already **Deploying**.
3. If publication fails, preserve the displayed error.
4. Retry once only after the named cause is resolved.
5. Open the live URL after success and verify the intended page.
## Checkout recovery
1. Confirm at least one sellable product is visible on the live store.
2. Confirm shipping applies to the test destination.
3. Confirm the payment app is connected to the intended mode and account.
4. Reach checkout through the live storefront rather than a direct guessed URL.
5. Stop before a real charge or order unless the test is explicitly authorized.
## App recovery
1. Open **Sell** → **Apps** and select the provider.
2. Read the displayed state: not connected, connected, needs attention, or unavailable.
3. Reconnect only through the provider's official authorization window.
4. Confirm the returned account and permissions.
5. Verify the actual downstream result; a green connection badge alone is not end-to-end proof.
### Watch: inspect a publication blocker
The recording reviews readiness checks, then chooses Cancel. No store is published and no checkout is completed.
## Related guides
- [Publish and republish](../storefront-and-publishing/publish-and-republish)
- [Live store and checkout](../storefront-and-publishing/live-store-and-checkout)
- [Connect, manage, and reconnect apps](../apps-and-integrations/connect-manage-reconnect)
- [Apps troubleshooting](../apps-and-integrations/troubleshooting)
---
# Troubleshoot Runner tasks
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/troubleshoot-runner-tasks
Troubleshoot from the current task details first. Repeating the same request without checking its state can create duplicate work and hide the original cause.
## Entry path
Open the affected store, return to the conversation, then open the current task's status or details.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
A waiting question needs an answer before work can continue. Check the latest question before sending the same request again.
## Before you start
- Keep the original conversation open so you do not lose the visible state or error.
- Wait for any active action to settle before retrying.
- Do not include secrets, payment details, or customer data in copied evidence.
## Recovery checklist
1. Confirm you are in the conversation where the work started.
2. Read the latest Runner message and task state.
3. If Runner asked a question, answer that question before sending a new request.
4. If the task stopped, identify whether it needs input, access, credits, or a corrected request.
5. If it failed, copy the visible error without including secrets or customer data.
6. Retry once only when the page offers a retry and the cause is transient.
7. Otherwise send a focused follow-up that states the desired result and what is currently wrong.
8. Verify the affected storefront, setting, or asset after Runner reports completion.
## Common problems
| Problem | What to do |
| --- | --- |
| Nothing happens after sending | Confirm the message appears in the conversation and check task details for a waiting state. |
| Runner asks repeated questions | Answer every required field directly and avoid changing the goal in the same reply. |
| The task stops for credits | Open usage or plan settings; do not repeatedly resume unchanged work. |
| The result is incomplete | Name the missing visible outcome in a follow-up. Attach a screenshot when it helps locate the issue. |
| The wrong page changed | Use version history when appropriate, then identify the exact page or section in the correction. |
| A retry fails the same way | Stop retrying and contact support with the conversation, task state, and error. |
## Buttons and results
| Control | Result |
| --- | --- |
| Task details | Opens status, progress, and any available result information. |
| Answer or option control | Sends the requested decision and lets the task continue. |
| Stop, when available | Ends the current run; unfinished work may remain incomplete. |
| Retry or continue | Starts another attempt from the state Runner supports. Use it only after checking the cause. |
| New Chat | Starts a separate conversation; it does not repair the original task automatically. |
## Confirm recovery before another request
After answering a question, confirm your response appears and the task moves out of its waiting state. After a correction, repeat the affected action in the store. If Runner cannot determine whether an outside action completed, verify its result before retrying to avoid duplicates. See [Task states and details](../work-with-runner/task-states-and-details) for the controls available in the current conversation.
## Related guides
- [Chat with Runner](../work-with-runner/chat-with-runner)
- [When Runner asks a question](../work-with-runner/answer-runner-questions)
- [Write effective requests](../work-with-runner/write-effective-requests)
- [Support and community](./support-and-community)
---
# Troubleshoot storefront builds
Source: https://www.runnerai.com/docs/en/guides/help-and-reference/troubleshoot-storefront-builds
The preview is the safest place to find storefront problems. Do not publish until the important pages and interactions work there.
**Entry path:** Affected store → **Storefront** → preview controls.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
Use the current Storefront preview and its device controls to reproduce the affected page before publishing.
## Before you start
- Open the affected store and identify the page and device width where the problem appears.
- Let the latest Runner task finish before comparing its result with Preview.
- Use Preview first; do not publish a broken or uncertain result as a test.
## Start in Storefront
1. Open the affected store and select **Storefront**.
2. Confirm the preview is showing the expected project and latest version.
3. Reload the preview once.
4. Check desktop and mobile device views.
5. Open the affected page through the preview navigation.
6. Compare the result with the latest Runner task and version history.
## Common problems
| What you see | What to check |
| --- | --- |
| Blank or error preview | Wait for the active build to finish, reload once, and inspect the current task for a failure. |
| Old content | Confirm the latest task completed and that the preview is on the newest version. |
| Layout breaks at one width | Reproduce it with the device controls and tell Runner the page, section, and width. |
| Missing image | Check Media Library, the asset selection, and whether the image itself loads. |
| Link opens the wrong page | Name the source button and intended destination in a focused correction. |
| Product is missing | Verify that the product exists and is available to the storefront, not just that the page looks polished. |
| Design Mode change is absent | Confirm the edit was saved or applied, then reopen the same page in preview. |
## Useful controls
| Control | Result |
| --- | --- |
| Refresh preview | Reloads the current preview without publishing it. |
| Device selector | Changes the preview width so you can inspect responsive layouts. |
| Open preview or external view | Opens a larger preview; it does not make the store live. |
| Design Mode | Lets you select and adjust visible storefront content. |
| Version History | Shows saved versions and restore controls. Restoring changes project state, so review first. |
## Escalate with useful evidence
Include the project name, page, device size, expected result, visible result, latest task state, and a screenshot without personal or customer data.
## Verify the correction
After the repair task finishes, reload the same affected page and repeat the interaction at the original device width. Check a second width before publishing. A working homepage alone is not a repair checkpoint for a broken product page or cart.
### Watch: compare preview device widths
The recording switches PC, Pad, and Phone previews. It demonstrates how to compare widths, not an error repair or a published change.
## Related guides
- [Preview your store](../storefront-and-publishing/preview-your-store)
- [Design Mode](../storefront-and-publishing/design-mode)
- [Version history](../storefront-and-publishing/version-history)
- [Troubleshoot Runner tasks](./troubleshoot-runner-tasks)
---
# Open your first store
Source: https://www.runnerai.com/docs/en/guides/open-your-first-store
This guide is a single ordered path from a business idea to a store that can take money. It is written for people who have not sold anything online before, so it explains the e-commerce parts as it goes.
New to Runner? Follow [Build your first store](./start-here/first-store-quickstart), with screenshots and short videos, then return here for products, shipping, payments, and business setup.
You need an idea and an email address to start. A registered business, a domain, and a Stripe account come later, at the steps where they are actually required.
Already selling on Shopify? Use [Connect Shopify](./start-here/connect-shopify) instead. This guide covers building a store from scratch.
## Three states, and why they are separate
A store passes through three states, and they do not happen at the same time. Knowing which one you are in prevents most of the confusion in this process.
| State | What it means | What it does not mean |
| --- | --- | --- |
| **Preview** | Runner has built your storefront and you can look at it. | It is not public. |
| **Published** | The store has a public web address and anyone can visit it. | Publication alone does not prove checkout is ready; payment and provider setup must also be checked. |
| **Checkout ready** | Stripe is connected and an order can be paid for. | This is the point where the store is open for business. |
Publishing is step 7. Payments are step 9. A live store is not necessarily a working one.
## How to use this guide
Eleven steps in four groups.
| Group | Steps |
| --- | --- |
| **Build** | 1. Decide what to sell · 2. Build your storefront |
| **Set up** | 3. Store details · 4. Products · 5. Shipping · 6. Policies and trust |
| **Go live** | 7. Review and publish · 8. Custom domain (optional) · 9. Connect payments |
| **Grow** | 10. First visitors · 11. Weekly operations |
Work through them in order. Several later steps fail quietly if an earlier one is incomplete: shipping does not save without a stock location, products do not show prices without a market, and the domain step needs a successful publication first. Step 8 is the exception — it is optional, and you can do it any time after publishing.
Every step ends with something you can verify yourself. The **Launch checklist** at the end of this guide collects all of them in one place.
Runner does more than build the storefront. It can research what to sell, suggest products, write descriptions, create and update catalog records, and draft your policy pages. Each step below includes prompts you can copy into chat. If something is not working, describe it — Runner can read your store's current state and identify what is missing.
Skills give Runner a repeatable set of instructions for a type of work. Open **Agent** in the sidebar, select the **Skills** filter, then use **Discover** and search for the task you are doing, such as `market research`, `product description`, `policy`, or `SEO`. See [Skills](./agent/skills).
**If a setup helper appears first.** New stores can open a guided setup that asks for store basics, shipping, a first product, payment, and visibility in one pass. It covers parts of steps 3, 4, 5, and 9 out of order. Complete what you can, select **Skip** on the rest, and use the steps below to finish the skipped items properly. See [Onboarding and General settings](./store-operations/onboarding-and-general-settings).
## Step 1 — Decide what to sell
The rest of the process is faster once this is settled. Plan on an afternoon.
You need three answers: what you sell, who buys it, and where it comes from. The third one shapes several later steps.
- **Hold your own stock.** You buy or make the products and ship each order yourself. Higher margin, more work, and money spent before your first sale.
- **Dropshipping.** A supplier holds the stock and ships each order on your behalf. Faster to start and no stock to buy, with thinner margins and less control over delivery times.
Runner supports both, and you can change later. See [Dropshipping](./store-operations/dropshipping).
**Ask Runner**
> I want to start a store but haven't decided what to sell. I'm interested in [topic]
> and can spend around [budget]. What's selling well, and what are the tradeoffs for
> each option?
> Should I dropship [product] or hold my own stock? This is my first store.
> Who buys [product]? What do they care about, and what price do they expect?
**You are done when** you can state what you sell, who buys it, and where it comes from. Keep that description — you paste it into chat in step 2.
**Skip for now:** a domain, a logo, and business registration. Each is cheaper to decide once the product is settled.
## Step 2 — Build your storefront
Use the illustrated [first-store tutorial](./start-here/first-store-quickstart) to create your store, send the description from step 1, review the preview, and request a focused change.
Before continuing, check that:
- The new store appears in your workspace.
- The main preview pages open on desktop and mobile.
- The change you requested is visible in the preview.
A working preview does not publish your store. Continue with business setup below; publishing is step 7.
## Step 3 — Set up your store details
Your store's public identity and where it sells. About 10 minutes, and several later steps depend on it.
**Entry path:** **Workspace → choose a store → Store Operations → General**
1. Open **Store Operations → General**.
2. Enter the store name, a contact email, and your business address. The store name is limited to 30 characters, and the contact email must be a valid address.
3. Under **Markets**, add the countries you sell to and set the currency.
4. Under **Locations**, add the address orders ship from. A home address is valid.
5. Select **Save** and wait for the saved state.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
English callouts highlight the controls. Select the image to enlarge it.
Full detail: [Onboarding and General settings](./store-operations/onboarding-and-general-settings).
**Ask Runner**
> I'm selling to [countries]. What market and currency settings should I use?
**You are done when** General is saved with a store name, a valid contact email, at least one market, and a stock location.
**Worth knowing**
- Currency is set per market, not per product. A product priced in a currency outside your saved markets shows a warning and can fail to display a price on the storefront.
- Store visibility is separate from publishing. **Visible to customers** controls whether the storefront shows the store. It does not put your storefront code online — that is step 7.
- This is a good moment to start Stripe. Payments are step 9, but Stripe's review of your details can take time, so starting now means the wait happens in the background instead of on launch day.
## Step 4 — Add your products
You need at least one complete, sellable product. How long this takes depends entirely on how you source.
**Entry path:** **Workspace → choose a store → Store Operations → Products**
Three routes, and you can mix them.
| Route | Use it when | Where |
| --- | --- | --- |
| **Create manually** | You have your own products | **Products → Add** |
| **Dropshipping** | A supplier holds stock and ships for you | **Store Operations → Dropshipping** |
| **CSV import** | You already have a catalog in a spreadsheet | **Products → Import** |
An empty catalog shows **Add First Product** instead of **Add** and **Import**.
A complete product needs a name and description, a price in a currency that matches a saved market, at least one image, inventory, and **Published** status. A **Draft** product does not appear to customers. Physical goods also need weight and dimensions, because shipping and fulfillment depend on them.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
English callouts highlight the controls. Select the image to enlarge it.
Detail: [Products](./store-operations/products) · [Dropshipping](./store-operations/dropshipping) · [Import products](./store-operations/import-products) · [Inventory and variants](./store-operations/inventory-and-variants)
**Ask Runner.** You do not have to fill these forms in yourself. Runner can create and update products, inventory, and images from chat, and can help you choose what to launch with.
> Which of these should I launch with? [list] — consider margin and how hard each one
> is to ship.
> Write a product description for [product]. Customers care most about [what matters].
> Set inventory for [product] to 50 and mark the blue variant out of stock.
> Check my catalog and tell me which products are missing images, prices, or inventory.
Name the record and the exact result you want, and authorize destructive changes explicitly.
**You are done when** at least one product is **Published**, priced in a saved market currency, has an image and inventory, and appears on the storefront preview.
**Worth knowing**
- Inventory only persists once a stock location is saved. That is part of step 3 — add one there if you skipped it.
- Dropshipping products can behave differently from manually managed ones for cost and inventory. Confirm a destination, a usable shipping method, and a retail price for every variant before adding an item.
- CSV import needs Runner's current template. `Product Handle` and `Product Title` are required; variant rows use the template's option fields, while `Variant SKU` is optional.
## Step 5 — Set up shipping
Runner needs to know where orders ship from and what you charge to deliver them. About 15 minutes.
Order matters here. Shipping does not save without the stock location and market you saved in step 3.
**Entry path:** **Store Operations → General → Shipping**
1. Open **Store Operations → General**.
2. Confirm the **Locations** you saved in step 3 is still in place. This is the address orders ship from.
3. Confirm at least one country is saved under **Markets**.
4. Go to **Shipping** and select **Add**.
5. Give the option a name customers will recognize, such as the delivery speed or method.
6. Choose the destination country under **Ship to**, then open **Shipping cost**. A flat rate is the simplest option. Enter `0` for delivery to display as free.
7. Select **Save** in the dialog, then **Save** on the page, and wait for the saved state.
For price-based bands and the other rate types, see [Shipping](./store-operations/shipping). If a carrier or supplier handles delivery, you may also need a connection under **Apps** — see [Shippo](./apps-and-integrations/shippo-shipping), [CJ Dropshipping](./apps-and-integrations/cj-dropshipping), or [4PX fulfillment](./apps-and-integrations/4px-fulfillment).
**Ask Runner**
> I ship from [place] to [countries]. What shipping options should I set up?
> Is free shipping worth offering on a [price] product, or should I charge for it?
**You are done when** a delivery option with a price appears at checkout. Add a product to the cart and check there, not on the settings page.
**Worth knowing**
- A store with no valid shipping option looks normal everywhere except checkout, where the customer cannot complete the order. This is a common reason a finished-looking store takes no sales.
- Shipping options use the stock location saved in General. There is no separate **Ship from** selector on each row.
- Saving fails without a default market region. Save Markets before Shipping.
- Digital products, bookings, and supplier-fulfilled items can follow different rules.
## Step 6 — Make it legal and trustworthy
These are the pages that tell customers who you are and what happens if something goes wrong. Runner can draft all of them. Your job is to check that they match how you actually operate.
Most stores need a refund and return policy, a shipping policy with realistic delivery times, a privacy policy, terms of service, contact information, and an about page.
**Ask Runner**
> Draft a refund and return policy. I sell [what], ship from [where], and want a
> [number]-day return window.
> Draft privacy policy and terms of service pages and add them to the storefront footer.
> Write an about page based on what I've told you about my business.
Then review the drafts:
1. Read each page and correct anything that does not match your actual terms — the return window, who pays return shipping, and how long delivery really takes.
2. Confirm the pages render on the storefront and are linked in the footer. See [Edit content, pages, and media](./storefront-and-publishing/edit-content-pages-and-media).
3. Check the contact address matches the contact email you saved in step 3.
**You are done when** each policy page opens from the storefront footer and reflects your real terms.
**Worth knowing.** Drafts are a starting point, not legal advice. Tax registration, consumer-protection rules, and required disclosures depend on where you operate and what you sell. Check with a local professional before launch if you are unsure.
Product reviews are a separate trust signal, configured in General. Enabling reviews does not add missing review components to an older storefront — ask Runner to add the capability, then publish that change. See [Reviews](./store-operations/reviews-and-advanced-admin).
## Step 7 — Review and publish
Publishing puts your store online at a public address. The checks take a few minutes. Fixing what they find can take longer.
**Entry path:** **Workspace → select a store → Storefront → Publish**
1. Work through the [publication readiness checklist](./storefront-and-publishing/prepare-to-publish) first.
2. Open **Storefront** and select the publication button. It reads **Publish**, **Publish Changes**, or **Republish** depending on the store's state.
3. Read **Put your store live?** and wait for the build check to finish.
4. Resolve every warning shown, or acknowledge it deliberately.
5. Select **Confirm** only after the check succeeds.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
English callouts highlight the controls. Select the image to enlarge it.
Detail: [Publish and republish](./storefront-and-publishing/publish-and-republish).
**Ask Runner**
> Check whether my store is ready to publish and list anything still missing.
> The publish check is blocked on [item]. What should I do?
**You are done when** the store's public URL opens in a private browser window.
**Worth knowing.** Two things surprise people at this step. Your store is public but cannot take payments yet — that is step 9, and it is the step that opens the store for business. And later changes are not live until you publish again: saving a Design Mode edit, restoring a version, or seeing a correct preview does not update the public store on its own.
Store Operations changes behave differently. Products, prices, inventory, and shipping apply without republishing.
**If a check blocks you,** use the action shown on the item — **Open Store Operations**, **Fix with AI**, or **Retry check**. If it persists, see [Troubleshoot publishing, checkout, and apps](./help-and-reference/troubleshoot-publishing-checkout-apps) and [Troubleshoot storefront builds](./help-and-reference/troubleshoot-storefront-builds).
## Step 8 — Connect a custom domain (optional)
**This step is optional.** Your store already works at the address Runner gave it when you published. A custom domain is about branding, not function. Skipping it does not block payments or anything after it, and you can come back at any time.
Setup takes about 10 minutes, followed by a wait for DNS to propagate. The store needs a successful publication first, and access depends on your plan.
**Entry path:** **Storefront** → published-site menu → **Domain Settings**. On mobile, or when that menu is hidden, use workspace **Settings → Shop: _store name_ → Domain**.
1. Open **Domain Settings** through either entry path above.
2. Either buy a domain through Runner, or add one you already own.
3. If you are adding your own, copy the DNS records Runner shows into your domain provider's settings.
4. Wait for verification. The domain row shows a warning until the records resolve.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
English callouts highlight the controls. Select the image to enlarge it.
Detail: [Connect a custom domain](./storefront-and-publishing/custom-domains).
**You are done when** your domain opens the store — or when you have decided to come back to this later.
**Worth knowing**
- **Domain added successfully** confirms the domain is attached to your store, not that DNS is working. Those are checked separately, and DNS changes can take several hours.
- Buying or renewing a domain starts an external payment flow. Review the details before continuing.
- If you are launching soon, connect payments first. A store on the default address that takes money is worth more than a branded one that does not.
## Step 9 — Connect payments
This is the step that opens the store for business. Everything before it was setup.
Your store can already be live and look finished. Until this step is done, a customer who tries to buy something cannot complete the purchase.
**Entry path:** **Apps → Run your store → Stripe**. After publishing, Runner can also show **Connect Stripe** in the store handoff, which opens the same setup.
Stripe collects business details, identity information, and bank details for payouts. Have these ready, and use a browser that allows the Stripe window to open.
1. Open **Apps → Run your store → Stripe** and select **Connect**.
2. Complete Stripe's setup in the new window.
3. Return to Runner and confirm the connection shows as enabled.
| State | What it means |
| --- | --- |
| **Connecting...** | Runner is preparing the account or setup link. Wait for a result. |
| **Pending review** | Stripe is reviewing your details. This is Stripe's process, not an error in Runner, and it can take time to clear. |
| **Stripe actions required** | Something specific is outstanding. Open it to see what is **Due now**, **Due later**, or **In review**. |
| **Reconnect** or **Continue Onboarding** | An account exists but is not finished. Selecting it resumes the same account. |
Detail: [Connect Stripe for payments](./apps-and-integrations/stripe-payments).
Open your store on a phone. Check a product, add it to the cart, enter a delivery address, and confirm that a shipping option and the payment step appear. Stop before submitting payment.
If you choose to test a real payment, place a deliberate test order and review it in [Orders](./store-operations/orders). A real charge and any refund can incur fees; this is optional and separate from the setup walkthrough.
**Ask Runner**
> Stripe is showing [state]. What does it mean and what should I do next?
> A customer says checkout isn't working. What should I check?
**You are done when** Stripe shows no blocking setup actions and your product, cart, shipping option, and payment step work together. These checks confirm checkout readiness; only a completed payment confirms an actual transaction.
**Worth knowing.** A live store URL is not proof that payments are available. The storefront can be published while checkout is still paused or under review. See [Live store and checkout](./storefront-and-publishing/live-store-and-checkout).
## Step 10 — Get your first visitors
Nobody arrives on their own. Start with the work that costs nothing, and do not spend on ads until step 9 is confirmed.
- **Search.** Product titles and descriptions carry most of the weight for a new store. See [SEO overview](./analytics-and-seo/seo-overview) and [Search performance](./analytics-and-seo/search-performance).
- **Analytics.** Confirm visits are being recorded before you judge anything. See [Analytics overview](./analytics-and-seo/analytics-overview).
- **AI visibility.** How your store appears when people ask AI assistants for recommendations. See [AI visibility](./analytics-and-seo/ai-visibility).
- **Creative.** Images and ad variations from [Creative Studio](./automate-test-and-create/creative-studio), and campaigns through [Runner Ads](./automate-test-and-create/runner-ads).
**Ask Runner**
> Improve the SEO titles and descriptions on my product pages.
> Create three ad creatives for [product] aimed at [audience].
> My store has been live a week with no sales. What should I check first?
**You are done when** analytics shows sessions from people other than you.
**Worth knowing.** Low traffic and low conversion are different problems with different fixes. Check traffic first — conversion cannot be diagnosed on ten visits. See [Traffic and conversion](./analytics-and-seo/traffic-and-conversion). If analytics shows nothing at all, confirm the store is published and the data source is connected before changing anything else. See [Troubleshoot data and publication](./analytics-and-seo/troubleshoot-data-and-publication).
## Step 11 — Run your store weekly
A short routine keeps the store healthy once orders start arriving.
1. Check [Orders](./store-operations/orders) and fulfil anything outstanding.
2. Answer customer messages and handle returns. See [Customers](./store-operations/customers).
3. Check stock levels in [Inventory and variants](./store-operations/inventory-and-variants).
4. Look at [Analytics](./analytics-and-seo/analytics-overview) for what changed since last week.
When you have enough traffic, test changes instead of guessing at them with [Experiments](./automate-test-and-create/experiments), hand repeated work to [Automations](./automate-test-and-create/automations), and run [Promotions](./store-operations/promotions) for specific products or periods.
**Ask Runner**
> Summarize this week's orders and flag anything that needs attention.
> Which products sold best this month, and which aren't moving?
**Worth knowing.** Storefront changes need publishing again before customers see them. Store Operations changes apply without republishing. Before authorizing a destructive or order-lifecycle action from chat, ask Runner to inspect the current state first, then authorize the exact effect you want.
## Launch checklist
Each item is something you can verify yourself. If you can confirm all eight required items, your store is open for business.
**Required**
- [ ] You can say what you sell, who buys it, and where it comes from. (Step 1)
- [ ] The storefront preview loads, and your main pages work on desktop and mobile. (Step 2)
- [ ] General is saved with a store name, a valid contact email, at least one market, and a stock location. (Step 3)
- [ ] At least one product is Published, priced in a saved market currency, with an image and inventory. (Step 4)
- [ ] A delivery option with a price appears at checkout when you add a product to the cart. (Step 5)
- [ ] Your policy pages open from the storefront footer and match your real terms. (Step 6)
- [ ] The public store URL opens in a private browser window. (Step 7)
- [ ] Stripe has no blocking setup actions, and the cart reaches the payment step with the expected shipping option. (Step 9)
**Optional, at any point after publishing**
- [ ] Your custom domain opens the store. (Step 8)
**After launch**
- [ ] Analytics shows sessions from people other than you. (Step 10)
- [ ] You have a weekly routine for orders, stock, and customers. (Step 11)
If an item will not confirm, describe what you are seeing in chat.
> Check my store against the launch checklist and tell me what's still incomplete.
## Related guides
- [Get started with Runner](./start-here)
- [Chat with Runner](./work-with-runner/chat-with-runner)
- [Store Operations](./store-operations)
- [Apps and integrations](./apps-and-integrations)
- [Help and reference](./help-and-reference)
- [Glossary](./help-and-reference/glossary)
---
# Plans and billing
Source: https://www.runnerai.com/docs/en/guides/plans-and-billing
Runner meters work in Credits and sells capacity as a subscription. These two pages separate the decision from the day-to-day: pick and manage a plan on one, read and stretch the resulting balance on the other.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
English callouts highlight the controls. Select the image to enlarge it.
This snapshot shows Free, Plus, and Pro. Scroll in the product to see Max; use the current account and checkout values rather than the prices captured here.
| Your goal | Start here |
| --- | --- |
| Compare Free, Plus, Pro, and Max, or change a subscription | [Subscription plans](/en/guides/plans-and-billing/subscription-plans) |
| See what a balance accomplishes, read usage, or earn Credits | [Credits and usage](/en/guides/plans-and-billing/credits-and-usage) |
Open the intended workspace menu → **Settings → Plan & Billing** to compare plans, or **Usage & Credits** to inspect spending. The current [Pricing page](https://www.runnerai.com/pricing), your account, and the confirmation before payment show the applicable values.
---
# Credits and usage
Source: https://www.runnerai.com/docs/en/guides/plans-and-billing/credits-and-usage
Credits are Runner's universal usage unit. Eligible LLM, image, video, automation, workflow, simulation, skill-driven, and deployment operations all deduct from one displayed balance.
## What this covers
Estimating what a balance accomplishes, selecting one reporting range and reading every block against it, earning bonus Credits, and understanding how usage is recorded.
## Availability and prerequisites
- Usage is scoped to the current workspace, not one store.
- Data can be empty when the workspace has not used Credits in the selected range.
- Credit grants, expiration, and purchase eligibility depend on the grant or plan shown in your account.
- Use **Usage & Credits** for your balance and recorded spend; use the current purchase confirmation for prices.
## Entry path
Open the intended workspace, then select **Settings → Usage & Credits**. Confirm the workspace name in the settings sidebar.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
Open **Usage & Credits** under the intended workspace. This image shows the entry, not a balance or recorded usage; inspect those values in your own workspace.
## What a balance accomplishes
Use your own recent tasks to estimate the next similar change. Start with a small, well-defined request, then check its recorded Credits in Workspace activity. Model choice, context size, output length, media, retries, and task complexity all change the total; there is no fixed price per message or guaranteed number of store builds per balance.
### Estimate your next store build
1. Open **Settings → Usage & Credits** in the workspace where you will build.
2. Make one small, representative request, then find its recorded spend in **Workspace activity**.
3. Compare recent tasks of similar scope and model choice. Estimate initial generation and later revisions separately.
4. Add the work you expect to repeat, and allow for media generation, retries, and larger changes. Check recorded spend again after each stage.
For example, **if your own activity** records 200 Credits for generation and 20 Credits for each of three similar revisions, those tasks total **260 Credits**. These numbers illustrate the calculation; they are not typical costs, a benchmark, or a quote for your next store.
**Check:** Your estimate comes from comparable recorded tasks. A Credit balance does not guarantee a fixed number of stores or revisions.
For the monthly allowance included with each plan, see [Subscription plans](./subscription-plans).
## Controls and reports
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| **7 days** | Inspect recent activity. | Every chart, summary, category, and activity block updates to seven days. |
| **This cycle** | Review the current billing-cycle window. | The page uses the elapsed current cycle shown for the workspace. |
| **90 days** | Look for a longer trend. | Every usage block updates to the longer range. |
| Credits left card | See remaining and total Credits for the current plan/grants. | The progress bar and displayed refresh date explain the current balance state. |
| **Upgrade** | Compare plans when more included capacity is needed. | Runner opens **Plan & Billing**. |
| **Buy Credits** | Review an eligible extra-Credit purchase. | Runner opens **Plan & Billing**; no purchase occurs until its confirmation is completed. |
| Credits per day | Find busy or quiet dates. | Hovering a bar shows that date's usage. |
| Where your Credits came from | Understand plan, daily, signup, purchased, and other grants that apply. | Each row shows source, cadence, note, and Credits. |
| Where your Credits went | Compare spend categories and run counts. | Bars show each category's share for the selected range. |
| Workspace activity | Inspect recent tasks behind the spend. | Category tabs filter the same Task, Project, Type, Credits, and Time columns. |
## Review usage
1. Open **Workspace → Usage & Credits**.
2. Select **7 days**, **This cycle**, or **90 days**.
3. Read **Credits left** before interpreting spend.
4. Compare **Used in range**, **Daily average**, and **Busiest day**.
5. Use **Credits per day** to find when usage changed.
6. Compare sources with spend categories.
7. Filter **Workspace activity** to identify the tasks involved.
8. If you need more capacity, open **Upgrade** or **Buy Credits**, then review the separate billing confirmation.
## Earn bonus Credits
Open the check-in or quest shown in your account and read the reward before claiming it. After a successful claim, return to **Usage & Credits** and inspect the source and balance.
Daily check-ins, consecutive-day bonuses, and introductory quests have separate eligibility and limits. Read the current cap and expiry attached to each grant; a monthly earning cap and a maximum stored bonus balance are different limits. Do not treat bonus Credits as an indefinite rollover balance.
## How usage is recorded
- Usage is recorded after an operation completes and can take a short time to appear.
- One request can produce several records when Runner uses multiple models, tools, media operations, simulations, or deployments.
- If a total looks unexpected, compare the timestamp, project, action type, model or provider, and any retries before contacting support.
## Understand the numbers
- Remaining balance and selected-range spend answer different questions; they do not need to be equal.
- The Credits-per-day chart reports daily spend, while the source card reports grants and remaining balance.
- A category can show runs with zero Credit spend.
- Activity rows show recent tasks for scanning, not a complete permanent audit log.
- Dates use the timezone on your current device.
## Common questions
| Question | Answer |
| --- | --- |
| Why did two similar prompts use different amounts? | They may have used different context sizes, output lengths, tools, models, agent steps, retries, fallbacks, media, simulations, or deployments. |
| Does sending a message consume a fixed number of Credits? | No. Credits follow the metered operations actually performed for the request. |
| Do manual edits consume Credits? | Editing content or code yourself creates no model usage. Asking Runner to make or explain the edit can. |
| Are failed requests always free? | Not necessarily. A failure with no provider-reported usage has no model cost, but usage reported before a failure, or during another successful attempt, can still be recorded. |
| Is a skill charged separately? | No. Activating a skill adds no flat fee; the operations it performs deduct from the same balance. |
| Do bonus Credits roll over? | Read the expiry on each grant. Check-in earning limits, stored-balance limits, and streak bonuses can follow different rules. |
| How does the seventh check-in bonus work? | Each eligible daily check-in awards 10 Credits, and every seventh consecutive claim adds a streak bonus. The claim screen shows the current amount before you collect it. |
| Is a Boost Pack a subscription? | No. It is a one-time purchase of 350 Credits for US$9.90. |
## States and limits
- **Out of Credits** highlights a zero remaining balance and keeps billing actions available.
- Empty activity says there are no logs for the current filter or range.
- A source can show zero when it is actionable but not yet claimed.
- Passive grant types appear only when they contributed Credits.
- Loading covers both balance and consumption data; wait for all cards before comparing them.
## Troubleshooting
- If two numbers seem inconsistent, confirm every block is using the same selected range.
- If a task is missing, clear the activity category filter and try a longer range.
- If the balance did not change after a purchase, return to Plan & Billing and confirm that the purchase reached a completed state before refreshing.
- If no usage appears, verify that you opened the workspace where the task ran.
- If you need a charge or plan decision, use Plan & Billing rather than an old usage screenshot.
- For an unexpected charge or a data-processing requirement, contact team@adaptivemachines.ai with the workspace, project, approximate timestamp, and usage event details.
## Related guides
- [Subscription plans](./subscription-plans)
- [Workspace General](../account-and-settings/workspace-general)
- [Agent Customization](../agent)
---
# Subscription plans
Source: https://www.runnerai.com/docs/en/guides/plans-and-billing/subscription-plans
Plan & Billing is the workspace-level place for subscriptions, plan changes, billing management, and eligible extra-Credit purchases. Use the values shown there because plan names, limits, and prices can change.
## What this covers
Comparing the Runner plans and what each one includes, reviewing a plan action before payment, recognizing scheduled or pending changes, and opening secure billing management.
## Availability and prerequisites
- Open the workspace whose plan you intend to manage.
- Billing actions can require workspace billing permission.
- Boost Packs require an active eligible subscription.
- A past-due or legacy subscription can show different controls or block a new action.
## Entry path
Open the intended workspace, then select **Settings → Plan & Billing**. Confirm the workspace name in the settings sidebar.
The public pricing page and Plan & Billing open on **Monthly** by default. An existing subscription or an explicit billing-period link can open the matching period instead.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
English callouts highlight the controls. Select the image to enlarge it.
Free, Plus, and Pro are visible in this snapshot; scroll for Max. Prices are a dated interface example. Review the current billing period and total before any payment.
## Compare the plans
This table summarizes the plans. The current [Pricing page](https://www.runnerai.com/pricing) and the confirmation shown before payment are authoritative.
| Plan | Included Credits | Model and feature access | Best for |
| --- | --- | --- | --- |
| Free | 150 Credits at signup, plus up to 250 through introductory quests | Runner Lite, and limited previews of selected advanced features | Trying Runner and generating a first store |
| Plus | 1,000 Credits reloaded monthly | Runner Lite, and limited previews of selected advanced features | Regular small changes and steady iteration on one store |
| Pro | 2,500 Credits reloaded monthly | Runner Pro, plus Creative Studio, automations, workflows, simulations, Experiments, and Ads | Complex building and the advanced feature set |
| Max | 10,000 Credits reloaded monthly | Runner Max, plus higher output limits and priority processing during high-traffic periods | Heavy or time-critical work, subject to availability |
Preview availability, duration, and limits can vary during rollout and appear in your account. For what those Credits accomplish in practice, see [Credits and usage](./credits-and-usage).
## Runner models
Runner offers three models so you can choose quality, speed, and Credit tradeoff without managing provider model IDs.
| Model | Included with | Intended tradeoff |
| --- | --- | --- |
| Runner Lite | Free and Plus | Fast, economical work for straightforward tasks |
| Runner Pro | Pro | Balanced capability for complex building and advanced features |
| Runner Max | Max | Highest capability, higher output limits, and priority access when traffic is high |
Use the model picker to see the choices available for the current task. Availability can change; a plan does not promise a permanent roster of underlying provider models.
## Controls
| Entry or button | Why it is useful | What happens next |
| --- | --- | --- |
| Current plan banner | Confirm which workspace plan is active and its displayed status. | Runner can show renewal, end, validity, or pending-change information. |
| **Monthly / Annual · Save 20%** | Compare plans in the desired billing period. | Plan cards update. Monthly can be disabled for an active annual commitment. |
| Plan card | Compare included features and limits. | Selecting an available action moves to a plan confirmation step. |
| **Upgrade** or period-switch action | Start a plan change. | Runner shows a confirmation, schedules the change, requests payment, or opens checkout according to account state. |
| **Manage** / **Manage Billing** | Update payment methods, review invoices, or manage cancellation. | Runner opens the secure billing portal. |
| **Cancel** beside a pending change | Withdraw a scheduled plan change. | Runner refreshes the current subscription after success. |
| Credit Boost Pack | Buy additional Credits when eligible. | Quantity and total are shown before **Confirm Purchase**. |
## Review a plan change
1. Open **Workspace → Plan & Billing**.
2. Confirm the workspace and current plan banner.
3. Select **Monthly** or **Annual · Save 20%** if both are available.
4. Review the current plan cards, feature limits, and displayed amount.
5. Select the intended plan action.
6. Read the confirmation carefully. For Annual, compare the annual total, not only a displayed monthly equivalent. Close or cancel the dialog if you are only comparing; do not continue if the plan, period, or amount is wrong.
7. Complete payment only in the secure checkout or billing page.
8. Return to Plan & Billing and confirm the resulting status. A loading or checkout redirect alone is not proof that the plan changed.
## Manage billing or cancellation
1. Select **Manage** or **Manage Billing** on the current subscription.
2. Use the secure billing portal for payment methods, invoices, and cancellation options presented to your account.
3. Review the portal's final confirmation before submitting a financial or cancellation action.
4. Return to Runner and verify the current plan banner, end/renewal notice, or pending change.
## Buy a Boost Pack
A Boost Pack is a one-time purchase of 350 Credits for US$9.90, plus applicable taxes. It is not a subscription, and its Credits add to the same universal balance.
1. Confirm that an active subscription is shown.
2. Open the Credit Boost Pack.
3. Choose the quantity.
4. Review total Credits and total price.
5. Select **Confirm Purchase** only when both are correct.
6. Wait for **Purchase Complete** and verify the balance in [Credits and usage](./credits-and-usage).
This is a financial action. Closing the confirmation leaves the purchase unsubmitted. Checkout shows the current price, quantity, expiration, and payment terms before you buy.
## States and limits
- **Active**, **Past Due**, **Canceling**, inactive, legacy, and pending-change states can expose different actions.
- An expired previous subscription can show **Renew** instead of the choices shown to a never-paid Free workspace. Wait for billing details to load before selecting Renew.
- An annual commitment can disable Monthly choices.
- A plan change can be immediate, scheduled, or pending additional payment. Use the status Runner shows after the request.
- **Setting Up Your Subscription** means Runner is still confirming the returned payment state.
- A processing timeout asks you to refresh and verify; it does not prove failure or success.
- Extra-Credit purchase is unavailable without an active eligible subscription.
## Troubleshooting
- If the wrong workspace is shown, close Settings and reopen it from the intended workspace.
- If the Monthly toggle is disabled, review the current annual commitment shown on the page.
- If billing management does not open, retry once and allow the secure billing page to open.
- If the subscription is Past Due, follow the displayed billing action before attempting another plan change.
- If payment returns to a processing state, refresh and verify before submitting again to avoid a duplicate attempt.
## Related guides
- [Credits and usage](./credits-and-usage)
- [Workspace General](../account-and-settings/workspace-general)
- [Delete, recover, and leave](../account-and-settings/delete-recover-and-leave)
- [Agent Skills](../agent/skills)
---
# Welcome to Runner AI
Source: https://www.runnerai.com/docs/en/guides/product-guide
Runner helps you turn a business idea into a working online store, then manage the store from one workspace. These guides explain each major page, entry, button, state, and safe next step in plain language.
**[Build your first store, step by step](./start-here/first-store-quickstart)**
Follow screenshots and short videos to create a store, send your first request, check the preview, and prepare to publish.
## Start with the path that matches your goal
**Start**
- [Explore Runner before creating an account](./start-here/explore-runner-before-sign-in)
**Explore Runner before sign-in** — Understand the current public navigation, language, demo, and sign-in actions.
- [Evaluate a finished template](./start-here/browse-and-remix-templates)
**Browse and remix templates** — Compare public previews and understand whether remixing is currently available.
- [Build your first Runner store](./start-here/create-runner-store)
**Create a Runner store** — Create a project, send the first request, and reach the store workspace.
- [Use an existing Shopify store](./start-here/connect-shopify)
**Connect Shopify** — Start the Shopify connection path and understand what remains in Shopify.
**Build**
- [Ask Runner to build or change something](./work-with-runner/chat-with-runner)
**Chat with Runner** — Send a clear request, answer follow-up questions, and follow task progress.
- [Review the storefront](./storefront-and-publishing/preview-your-store)
**Preview your store** — Open the current preview and check desktop or mobile layouts.
- [Put the store online](./storefront-and-publishing/prepare-to-publish)
**Prepare to publish** — Complete required setup before selecting **Publish**.
**Operate**
- [Add and manage products](./store-operations/products)
**Products** — Find product controls and understand the result of each action.
- [Connect payments, shipping, or email](./apps-and-integrations)
**Apps and integrations** — Connect, inspect, reconnect, or disconnect supported services.
**Improve**
- [Understand performance](./analytics-and-seo)
**Analytics and SEO** — Read store, traffic, conversion, search, and AI-visibility views.
- [Find a missing or gated feature](./advanced/feature-availability)
**Feature availability** — Identify prerequisites and the safest next step without guessing.
- [Recover from a problem](./help-and-reference)
**Help and reference** — Diagnose task, build, publish, checkout, or integration states.
## The usual journey
1. [Sign in](./start-here/sign-in) and enter your workspace.
2. Open the store name menu in the sidebar and select **Create Store**. In an empty workspace, use **Create Store** or **+ Store** if shown. Choose **Build new** or **Connect Shopify** only if the store-type chooser appears.
3. [Tell Runner what you want](./work-with-runner/write-effective-requests).
4. Follow the task status and answer any questions Runner shows.
5. Review the result in [Storefront](./storefront-and-publishing/preview-your-store).
6. Make visual changes in [Design Mode](./storefront-and-publishing/design-mode) or send a follow-up request.
7. Configure products, shipping, payments, and store details.
8. Complete the [publication checklist](./storefront-and-publishing/prepare-to-publish), then publish.
9. Use the **Sell**, **Grow**, and **Measure** groups in the sidebar to run and improve the business.
## Browse all documentation
### Get started
- [Start here](./start-here)
sign in, create or connect a store, and complete the first useful workflow.
- [Workspace](./workspace)
manage stores, statuses, teammates, notifications, and workspace navigation.
- [Work with Runner](./work-with-runner)
use chat, history, search, images, profiles, skills, and task details.
### Build and run the store
- [Storefront and publishing](./storefront-and-publishing)
preview, design, conditional code editing, versions, publishing, checkout, and domains.
- [Store Operations](./store-operations)
general settings, shipping, products, orders, customers, promotions, sourcing, and reviews.
- [Apps and integrations](./apps-and-integrations)
payments, email, shipping, Shopify, fulfillment, and agent connections.
### Measure, automate, and create
- [Analytics and SEO](./analytics-and-seo)
metrics, traffic, conversion, search performance, site health, and AI visibility.
- [Automate, test, and create](./automate-test-and-create)
automations, simulations, experiments, Creative Studio, Media Library, and Ads.
- [Agent](./agent)
reusable skills, memory, and the command palette.
### Configure and troubleshoot
- [Account and settings](./account-and-settings)
workspace, billing, usage, store, personal, API key, and security settings.
- [Advanced features](./advanced)
conditional Research, Fly, Workflows, Webhooks, and availability rules.
- [Help and reference](./help-and-reference)
states, troubleshooting, support, Changelog, FAQ, and glossary.
## How to read these guides
Each task page follows the same pattern:
### Show the page pattern
1. **Entry path** tells you exactly where to start in Runner.
2. **Before you start** lists required store state, access, plan, or connection.
3. **Controls** explains what each important button does after you select it.
4. **Steps** describes the shortest safe workflow.
5. **States and troubleshooting** explains what changed and what to try next.
6. **Related guides** links to the next likely task.
## Safety boundaries
Before a high-impact click:
:::warning
- read the confirmation and affected store or workspace name;
- save work that should remain available;
- check whether the action changes the live store, billing, customer communication, secrets, or team access;
- ask a workspace owner when your role does not allow the action.
:::
---
# Get Started with Runner
Source: https://www.runnerai.com/docs/en/guides/start-here
**What this covers:** You will know which setup path to follow and where Runner takes you after each step.
Use this section when you are signing in for the first time, starting a Runner-powered store,
or connecting an existing Shopify store.
**[Build your first store, step by step](/en/guides/start-here/first-store-quickstart)**
Follow screenshots and short videos to create a store, send your first request, check the preview, and prepare to publish.
**Entry path:** Sign in → workspace → store name menu in the sidebar → **Create Store**.
## Choose your path
| Your situation | Start here | What happens next |
| --- | --- | --- |
| You want the shortest complete walkthrough | [Build your first store](/en/guides/start-here/first-store-quickstart) | Move from a store idea to preview and publication checks. |
| You want to explore Runner before signing in | [Explore Runner before sign-in](/en/guides/start-here/explore-runner-before-sign-in) | Review the public navigation, language, demo, and account actions available in the current rollout. |
| You want to evaluate a store template | [Browse and remix templates](/en/guides/start-here/browse-and-remix-templates) | Compare desktop, mobile, and screenshot previews, then check the current remix availability. |
| You do not have a Runner account | [Sign in](/en/guides/start-here/sign-in) | Verify your account, then enter a workspace. |
| You want Runner to create the storefront and store backend | [Create a Runner store](/en/guides/start-here/create-runner-store) | Runner creates a project and opens its conversation. |
| You already sell through Shopify | [Connect Shopify](/en/guides/start-here/connect-shopify) | Runner starts a Shopify connection or reuses an eligible existing connection. |
| You see an introductory dialog or credit reward | [Welcome tour and daily credits](/en/guides/start-here/welcome-tour-and-daily-credits) | Learn the main areas or claim the reward currently shown. |
## The first-run path
1. [Sign in](/en/guides/start-here/sign-in) and open your workspace.
2. Complete the short business questionnaire if Runner shows it.
3. Open the store name menu in the sidebar and select **Create Store**. In an empty workspace, use **Create Store** or **+ Store** if shown.
4. If a store-type chooser appears, select **Build new** for a new Runner store, or **Connect Shopify** for an existing Shopify store.
5. Enter a **Store Name**, select **Create**, and wait for the new store to open.
6. Use the project conversation to tell Runner what you want to build.
## Before you begin
- You need access to the email or Google account used to sign in.
- A workspace can have store and seat limits. Runner shows an upgrade path when a limit
blocks an action.
- **Connect Shopify** may not appear for every workspace.
- A generated preview, a published storefront, and working checkout are separate states.
## If you get stuck
- If an email code fails, request a new code after **Resend verification code** becomes available.
- If **Create Store** opens an upgrade message, review the current workspace plan before retrying.
- If Shopify is not shown, build a Runner store or check whether Shopify access is enabled for
your workspace.
## Related guides
- [Sign in](/en/guides/start-here/sign-in)
- [Explore Runner before sign-in](/en/guides/start-here/explore-runner-before-sign-in)
- [Browse and remix templates](/en/guides/start-here/browse-and-remix-templates)
- [Create a Runner store](/en/guides/start-here/create-runner-store)
- [Connect Shopify](/en/guides/start-here/connect-shopify)
- [Build your first store](/en/guides/start-here/first-store-quickstart)
---
# Browse and remix templates
Source: https://www.runnerai.com/docs/en/guides/start-here/browse-and-remix-templates
Runner's public templates page lets you inspect published templates before signing in and, when remixing is available, request a copy in your own workspace.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgR0WXr5OLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Choose a category and template, inspect **Desktop**, **Mobile**, or **Screenshot**, then select **Start from this store** when you want to begin creating a copy. The image shows the starting action, not a completed remix. Some layouts use **Remix this store** for the same action.
Select the image to enlarge it. Annotations are in English.
## Entry path
Open Runner's public **Templates** page at [www.runnerai.com/templates](https://www.runnerai.com/templates), or follow a Runner template link. No account is required to browse the gallery or open a template.
## Before you start
- You need a Runner account and an active workspace if remixing becomes available.
- A live preview, screenshot, and remix are different: previewing is read-only; only a successful remix creates project work.
- The available templates, descriptions, and remix counts can change.
## Browse the gallery
Use the category filter to narrow the gallery, including templates in **3D Animation**. Each card shows the template title, thumbnail when available, and a short description. Select a card to open its detail page. If the page says **No templates yet**, no public template is available at that moment; return later instead of treating it as an account problem.
## Review a template
| Control or section | What happens after you select it |
| --- | --- |
| **Desktop** | Opens the live template preview in a desktop-shaped frame. It does not edit the template. |
| **Mobile** | Shows the same live preview in a narrow phone-shaped frame. |
| **Screenshot** | Shows the saved full-page image when one is available. It is a static image, not the live store. |
| **About this template** | Explains the template's purpose. |
| **Designed for** | Lists the audiences or store types the template targets. |
| **Highlights and capabilities** | Summarizes the main ideas demonstrated by the template. |
| Remix count | Shows how many copies Runner has recorded. It does not measure live stores or sales. |
| **Back to gallery** | Returns to the public template list. |
If a live preview is unavailable, use **Screenshot** when the template has one. A missing screenshot or preview does not stop you from reading the template details.
## Remix the template
1. Review the template in **Desktop**, **Mobile**, and **Screenshot** as available.
2. Select **Start from this store** only when you want Runner to create a project from it.
3. If you are signed out, complete the sign-in flow. Runner keeps the selected template for the remix path.
4. After sign-in, if setup did not start automatically, return to the template detail and select **Start from this store** again. Then wait while the button shows **Setting up your store…**.
5. The copy succeeds when Runner opens a new project in your workspace. If Runner shows a failure or loses the connection, check your store list before retrying; the message alone does not prove that no project was created.
6. Review the copied storefront, products, settings, and publication state before making it live.
A successful remix becomes your own project; changing it does not alter the public template. It is a starting point, not proof that payments, shipping, catalog data, publication, or checkout are ready.
## Troubleshooting
| State | What to do |
| --- | --- |
| **Preview unavailable** | Switch to **Screenshot** or read the template details. |
| **No screenshot is available for this template** | Use **Desktop** or **Mobile** if the live preview works. |
| Sign-in opens after **Start from this store** | Finish sign-in with the account that owns the intended workspace. If setup does not start, return to the template and select **Start from this store** again. |
| **Setting up your store…** | Keep the page open while Runner creates the project. Do not start the same remix again. |
| **Failed to remix this store. Please try again.** | Check the store-name menu for a newly created project before retrying. If remix remains unavailable, browse the template or create a new Runner store instead. |
| Template not found | Return to the gallery; the template may no longer be published. |
## Related guides
- [Explore Runner before sign-in](./explore-runner-before-sign-in)
- [Sign in](./sign-in)
- [Create a Runner store](./create-runner-store)
- [Preview your store](../storefront-and-publishing/preview-your-store)
---
# Connect a Shopify Store
Source: https://www.runnerai.com/docs/en/guides/start-here/connect-shopify
**What this covers:** You will start Shopify authorization or reuse an eligible Shopify connection for a new Runner project.
Use this path when your catalog and checkout already live in Shopify.
**Entry path:** Store-name menu → **Create Store** → **Connect Shopify**, when available.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Start from the store-name menu and choose **Create Store**. Continue with **Connect Shopify** only if your workspace shows that choice.
The annotations are in English. Select the image to enlarge it.
## Before you start
- **Connect Shopify** must be enabled for your workspace.
- You need the store's permanent domain ending in `.myshopify.com`.
- For a new connection, you need permission to approve access in Shopify.
- Your Runner workspace must have room for another store.
## Create Store controls
| Control | Why it is useful | What happens after you select it |
| --- | --- | --- |
| **Connect Shopify** project type | Keeps the existing Shopify commerce system. | Shows Shopify connection choices and the shop-domain field. |
| **Store Name** | Names the Runner project. | Used in the Runner workspace; it does not rename the Shopify shop. |
| **Use existing connection: _domain_** | Avoids repeating authorization for an eligible connection. | Selects that Shopify connection for the new Runner project. |
| **Connect a different store** | Starts with another Shopify shop. | Shows **Shop domain**. |
| **Shop domain** | Identifies the Shopify store. | Accepts a domain such as `your-store.myshopify.com`. |
| **Connect Shopify** submit button | Starts a new authorization. | Sends you to Shopify; Runner finishes the handoff only after Shopify returns successfully. |
| **Create** | Uses the selected existing connection. | Creates the Runner project and opens it. |
| **Cancel** | Leaves without connecting or creating. | Closes the dialog. |
## Connect a new Shopify store
1. Open the store-name menu, select **Create Store**, then choose **Connect Shopify**.
2. Enter a **Store Name** for the Runner project.
3. Choose **Connect a different store** if connection choices are shown.
4. Enter the full `.myshopify.com` domain in **Shop domain**.
5. Select **Connect Shopify**.
6. Review the access request on Shopify and continue only if it names the store you expect.
7. After Shopify returns to Runner, confirm that the new project appears in the workspace.
## Reuse an existing connection
1. Choose **Connect Shopify** in **Create Store**.
2. Enter the Runner **Store Name**.
3. Select **Use existing connection: _domain_**.
4. Select **Create**.
5. Confirm that Runner opens the new project with the intended store name and Shopify connection.
## Troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| Shopify option is missing | The feature is not enabled for this workspace. | Use **Build new** or check workspace availability. |
| **Connect Shopify** is disabled | The store name or `.myshopify.com` domain is incomplete. | Correct the highlighted field. |
| Connection already linked | That Shopify connection belongs to another Runner store. | Choose another eligible connection or a different shop. |
| Connection not found | A saved connection is no longer available. | Select another connection or start a new authorization. |
| Shopify authorization is canceled | Shopify did not return an approved connection. | Return to **Create Store** and try again when ready. |
Checkout remains in Shopify for this project type. A successful connection does not prove that
the Runner storefront is built or published; review those states separately.
## Related guides
- [Create a Runner store instead](/en/guides/start-here/create-runner-store)
- [Build your first store](/en/guides/start-here/first-store-quickstart)
- [Getting started](/en/guides/start-here)
---
# Create a Runner Store
Source: https://www.runnerai.com/docs/en/guides/start-here/create-runner-store
**What this covers:** You will create a new Runner project and arrive in its project conversation.
Use **Build new** when you are starting from an idea and do not need to keep Shopify checkout.
**Entry path:** Workspace → store name at the top of the left sidebar → **Create Store**. Expand the sidebar first if it is collapsed. In an empty workspace, use **Create Store** or **+ Store** when shown.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
English callouts highlight the controls. Select the image to enlarge it.
Follow [Build your first store, step by step](./first-store-quickstart) for a complete example with screenshots and short recordings.
## Before you start
- You must be signed in to an active workspace.
- Your workspace must have room for another store.
- Enter a name that clearly identifies the store to your team.
## Create Store controls
| Control | Why it is useful | What happens after you select it |
| --- | --- | --- |
| **Build new**, when shown | Chooses Runner's native store path. | The form keeps only the fields needed for a Runner store. If no store-type selector appears, continue with Store Name. |
| **Store Name** | Names the project in your workspace. | **Create** becomes available after the name is valid. |
| **Create** | Confirms the new store. | Runner creates the project and navigates to its conversation. |
| **Cancel** or close | Leaves without creating a store. | The dialog closes and the workspace stays unchanged. |
## Create the store
1. Open the store-name menu in the sidebar and select **Create Store**, or use the creation action in an empty workspace.
2. Choose **Build new** if the form offers that choice. Otherwise, continue with **Store Name**.
3. Enter the **Store Name**.
4. Select **Create**.
5. Wait for the new project to open.
6. In the project conversation, describe your business, audience, visual direction, and required pages. You can also open **Storefront** to enter the first request.
Creating the project does not publish it. Runner still needs your request before it can build a
storefront preview.
After Runner finishes the first build, open **Storefront** to review the preview. A ready preview is not public. When you are ready to make the store public, select **Publish** and resolve every readiness item before confirming.
## Troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| **Create** is disabled | A required value is missing or invalid, or creation is already running. | Review **Store Name** and wait for any pending action. |
| Upgrade message | The workspace has reached its current store limit. | Open the plan information shown by Runner or cancel the dialog. |
| Workspace access has lapsed | New stores cannot be created in that workspace. | Follow the workspace reactivation or plan path shown on screen. |
| Creation failed | Runner could not finish creating the project. | Keep the intended name, return to the workspace, and try once more. |
## Related guides
- [Sign in](/en/guides/start-here/sign-in)
- [Build your first store](/en/guides/start-here/first-store-quickstart)
- [Connect Shopify instead](/en/guides/start-here/connect-shopify)
- [Welcome tour and daily credits](/en/guides/start-here/welcome-tour-and-daily-credits)
---
# Explore Runner Before Signing In
Source: https://www.runnerai.com/docs/en/guides/start-here/explore-runner-before-sign-in
Runner's public pages let you learn about the product, compare pricing, and start a demo or account flow before you enter a workspace.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1kPfxvrvDHKGRP0BUIpjksTZQ9oN4rSwzeqA)
Use **Products** and **Resources** to explore Runner, **EN** to choose a language, and **See how it works** to open the demonstration video. This video action is separate from **Book a demo**, which opens meeting scheduling when available.
Select the image to enlarge it. Annotations are in English.
## What this covers
You will find your way around Runner's public pages, choose a language, book a demo safely, and know whether the main action will start sign-in or open a workspace.
## Availability and prerequisites
- No account is required to browse the public pages.
- Runner can show one of two public navigation layouts. Only the version assigned to the current visit appears; this is normal.
- The **Book a Demo** scheduling panel uses an external service and needs a working network connection.
- The primary account action changes after you sign in.
## Entry path
Open Runner's public home page in a browser. On mobile, select **Open menu** to reveal the navigation and **Close menu** to dismiss it.
## Common controls
| Control | What happens after you select it |
| --- | --- |
| Language selector | Saves the chosen language for the signed-in account or current browser, then reloads the current page in that language. |
| **Book demo** or **Book a demo** | Opens the scheduling panel, whose accessible title is **Book a Demo**. A meeting is created only after the scheduler confirms it. |
| **Start** or **Start for free** | Opens the Runner sign-in or account-creation flow. The label depends on the public navigation version. |
| **Open Workspace** | Appears for a signed-in visitor and opens the protected workspace. |
| Signed-in avatar | Opens the available account menu instead of the signed-out **Start** or **Start for free** action. |
| **Open menu** / **Close menu** | Shows or hides the mobile navigation. Selecting a destination closes the menu as navigation starts. |
The mobile menu contains the links and language control for the public navigation version you were assigned. Its main action stays easy to reach near the menu edge: **Start** or **Start for free** when signed out, or the signed-in workspace action when available.
## Choose your next step
1. Open [Pricing](https://www.runnerai.com/pricing) to compare the public plans and included capabilities.
2. Browse [Templates](https://www.runnerai.com/templates) to inspect a starting point on desktop and mobile.
3. Return to the main account action when you are ready to build.
4. After sign-in, confirm that Runner opens the workspace you intend to use before creating a store.
## Change the language
1. Open the language selector.
2. Select the language you want.
3. Wait for the page to reload.
4. Confirm that the current page, rather than an unrelated destination, reopened in the selected language.
If saving fails, Runner keeps the prior language and reports an error. Retry once after checking the connection. A language change affects interface text; it does not translate content you entered into a store project.
## Book a demo
1. Select **Book demo** or **Book a demo**, whichever your navigation shows.
2. Wait for the scheduler to show available dates and times.
3. Choose a time and complete the requested contact details.
4. Confirm the meeting inside the scheduler.
5. Wait for Runner's success message and the panel to close.
Closing the scheduler before confirmation does not book a meeting. If it remains blank or unavailable, close it, check the connection, and try once more. Use [Support and community](/en/guides/help-and-reference/support-and-community) if the problem repeats.
## Start or reopen Runner
- When signed out, select **Start** or **Start for free** and complete the displayed sign-in or account-creation steps.
- When already signed in, select **Open Workspace** to enter the protected product.
- If a protected action returns you to sign-in, complete sign-in for the intended account before continuing.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Different public links than expected | Runner assigned the other current navigation version. Use the labels that are visible. |
| Mobile links are hidden | Select **Open menu**. After choosing a link, reopen the menu if you need another destination. |
| Account buttons show placeholders | Runner is still checking the session. Wait for **Start**, **Start for free**, or **Open Workspace** before deciding whether you are signed in. The language control can also stay unavailable during this check. |
| Language does not change | The preference was not confirmed. Check the error and connection, then retry once. |
| Demo scheduler is loading | Wait for its date and time controls before entering details. |
| Demo panel closes without success | No booking was confirmed. Reopen it and complete the scheduler confirmation. |
| **Start** or **Start for free** is replaced by **Open Workspace** | Runner recognizes a signed-in session. Open the workspace or use the avatar menu for account actions. |
## Related guides
- [Sign in](/en/guides/start-here/sign-in)
- [Browse and remix templates](/en/guides/start-here/browse-and-remix-templates)
- [Create a Runner store](/en/guides/start-here/create-runner-store)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Build your first store, step by step
Source: https://www.runnerai.com/docs/en/guides/start-here/first-store-quickstart
Build a storefront you can review, change, and prepare to share. Follow the steps in order, or use the table of contents to return to the step you need.
The example is **Quiet Mornings**, a handmade candle store. Use your own business idea instead. Screenshots and silent recordings show the English interface; questions and available controls can vary by store.
**Entry path:** [Runner AI](https://www.runnerai.com) → **Start for free** → sign in → your workspace.
## The short path
1. Open the store-name menu → **Create Store** (or **+ Store** in an empty workspace). Choose **Build new** if shown, or **Connect Shopify** for an existing Shopify store.
2. In the project conversation, describe your business, audience, visual direction, and required pages. Send the request and answer Runner’s questions.
3. When the first build is ready, open **Storefront** and review the preview. A ready preview is not public.
4. When ready to launch, select **Publish** and resolve every readiness item before confirming. Publication and working checkout remain separate checks.
## Before you start
- Use an email or Google account you can access.
- Choose a workspace with an available store slot and enough credits for the request. Resolve any plan or access limit before creating another store.
- Prepare one sentence about what you sell and who buys it. Refine the design after the first preview.
You do not need to connect a payment provider to review a storefront. **Preview**, **published**, and **ready to accept payments** are separate checkpoints.
## 1. Sign in [#sign-in]
1. Open Runner and select **Start for free**. If you are already signed in, select **Open Workspace**.
2. Select **Continue with Google** and choose your account, or enter your **Email**, select **Continue**, and enter the code from Runner's email.
3. Complete any account questions shown. Runner opens your workspace or returns to the page where you started.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
English callouts highlight the controls. Select the image to enlarge it.
**Check:** You can open your workspace without returning to sign-in. See [Sign in](./sign-in) if a code or account choice fails.
## 2. Create a store [#create-store]
1. Select the store name at the top of the left sidebar, then **Create Store**. Expand the sidebar first if it is collapsed. In an empty workspace, use the **Create Store** or **+ Store** action shown there.
2. Choose **Build new** if the form offers a choice. Use [Connect Shopify](./connect-shopify) instead to keep an existing Shopify store.
3. Enter **Quiet Mornings** in **Store Name**, or use your own name.
4. Select **Create** and wait for the new store to open. Do not select Create again while it is working.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
English callouts highlight the controls. Select the image to enlarge it.
**Check:** The sidebar shows the new store's name. Creating the store does not build or publish its storefront yet.
## 3. Describe the first version [#first-request]
1. Select **Storefront**. If it has no built version, Runner shows an input asking what the storefront should look like. You can also use the new store's conversation.
2. Copy this example into the input and change the business details:
~~~text
Build a store for Quiet Mornings, a handmade candle brand for people
who enjoy slow mornings. Use warm cream colors, forest-green accents,
and spacious product photography. Include a homepage, product pages,
About, and Contact. Start with three sample candles: Morning Light,
Cedar Cabin, and Lavender Dusk. Keep the store unpublished.
~~~
3. Select the send arrow (**Send message**). If your starting screen shows **Start building**, use that action.
4. Runner opens the build conversation and starts work. Stay in this store while reviewing the result.
**Check:** Your request appears in the conversation. A progress indicator or a follow-up question appears below it. Sample products are for practice; replace their details before selling them.
## 4. Answer questions and follow the work [#follow-progress]
1. Read each question. Select an answer, or use **Other…** to write your own.
2. Answer the remaining questions. In this example, we choose a candle price and a photography direction.
3. Wait for Runner to continue. Open **Details** when you need to understand a failed or blocked step.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
### Watch: answer the follow-up questions
The recording selects a price, advances to the photography question, then selects a visual direction. **Answered** confirms the choices and Runner resumes work. Your questions depend on your request.
**Check:** No question is still waiting for your answer. A completed message alone is not the final check: open the storefront and inspect what actually loads.
## 5. Preview and make one change [#preview-and-change]
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
1. Open **Storefront**, or select **Preview** on the completed build card when offered.
2. Wait until the store itself appears. **Preparing preview…** means it is not ready to review yet.
3. Open the homepage, a product, About, and Contact. Check the text, images, prices, and navigation.
4. Use the device control to check **PC**, **Pad**, and **Phone**. Look for cut-off text, overlapping buttons, and sideways scrolling.
5. Return to the conversation and request one specific change:
~~~text
Change the homepage headline to “Make room for a slower morning.”
Keep the colors, layout, and product information unchanged.
~~~
6. Wait for the change, reopen the current preview, and confirm the new headline is visible. Check Phone again.
**Check:** You can point to the requested change in the preview. It is still unpublished. If available, [Design Mode](../storefront-and-publishing/design-mode) also lets you select an element for a focused edit.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
### Watch: check desktop and phone layouts
The device control cycles from **PC** to **Pad**, then **Phone**, and back to **PC**. Only the preview frame changes; this action does not publish or edit your store.
## 6. Review the publication checks [#publish-checks]
Publishing can require a paid plan or additional workspace access. If **Publish** opens an upgrade message, review the [current plans](https://www.runnerai.com/pricing) or return to your preview. Resolve that gate before expecting the publication confirmation.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
1. Select **Publish** in the Storefront toolbar. This starts access and readiness checks; it is not proof the store is live.
2. Read **Put your store live?** and wait for the build check.
3. Resolve the items shown. **Fix with AI** requests a repair, **Retry check** runs the check again, and **Open Store Operations** takes you to setup when offered.
4. If you are practising, select **Cancel**. To make this version public, review any warnings and select **Confirm** only when it is enabled.
5. After confirming, wait for a successful publication result, open the public URL, and check the live pages. If publication fails, do not assume your changes are live.
In the screenshot, the build check passes but setup still needs attention. **Publish anyway — I'll finish setup later.**, when offered, acknowledges the listed unfinished setup; it does not complete that work.
### Watch: leave the checks without publishing
The recording reviews the build result and setup warning, then selects **Cancel** and returns to Preview. It does not publish the example store.
**Check:** A working preview proves the build is visible to you. A successful publication and working public URL prove visitors can reach it. Payment connection and checkout checks still need to be completed before taking orders.
Use [Prepare to publish](../storefront-and-publishing/prepare-to-publish) for products, shipping, policies, and other setup. Continue with [Publish and republish](../storefront-and-publishing/publish-and-republish) and [Live store and checkout](../storefront-and-publishing/live-store-and-checkout).
## If a step does not finish
| What you see | Your next step |
| --- | --- |
| No store yet | Open the store-name menu or the empty workspace's creation action. |
| A store-slot or plan limit | Review the workspace's plan or choose a workspace with room. Repeating Create does not remove the limit. |
| A question waiting for input | Answer it before expecting Runner to continue. |
| Preparing preview | Keep the current version open. Use Refresh if offered when preparation stops progressing. |
| Failed, stopped, or conflicting results | Open Details, read the remaining issue, and check the actual preview. Ask Runner to fix the specific problem rather than assuming the success summary is enough. |
| Confirm is disabled | Finish the build or active task and resolve the listed requirements. “No changes” requires a new saved change; it is not a warning to dismiss. |
| A live store cannot take payment | Complete the payment connection and checkout setup shown in Apps or the publication handoff. |
## Related guides
- [Create a Runner store](./create-runner-store)
- [Write effective requests](../work-with-runner/write-effective-requests)
- [Preview your store](../storefront-and-publishing/preview-your-store)
- [Open your first store for business](../open-your-first-store)
---
# Sign In to Runner
Source: https://www.runnerai.com/docs/en/guides/start-here/sign-in
**What this covers:** You will sign in and return to the Runner page or workspace that started the login flow.
Use email when you want a password-free one-time code. Use Google when that account is already
available in your browser.
**Entry path:** Runner home → **Start for free**, or **Open Workspace** if you are already signed in.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
English callouts highlight the controls. Select the image to enlarge it.
For the complete illustrated workflow, follow [Build your first store, step by step](./first-store-quickstart).
## Before you start
- Use an email account you can open on the same trusted device.
- If your organization invited you, sign in with the invited email address.
- Do not share a one-time code or leave it visible in a screenshot.
## Sign-in controls
| Control | Why it is useful | What happens after you select it |
| --- | --- | --- |
| **Continue with Google** | Uses your Google account. | Opens Google's account and consent flow. Runner resumes after Google returns successfully. |
| **Email** | Lets you sign in without a password. | Accepts the address that will receive the one-time code. |
| **Continue** | Requests an email code. | Runner sends a six-digit verification code and opens the code form. |
| Verification code fields | Confirms that you control the email address. | The form submits automatically after all six digits are entered. |
| **Resend verification code** | Replaces a missing or expired code. | Sends another code after the visible countdown finishes. |
### Video: The sign-in screen
The recording is made signed out. It shows that one screen covers both new and returning accounts, and points at **Continue with Google** as the alternative to an email code. No address is typed and no code is requested, so it does not show the code step or what happens after sign-in.
## Sign in with email
1. Enter your email address.
2. Select **Continue**.
3. Open the message from Runner and find the six-digit code.
4. Enter all six digits. You do not need to select another submit button.
5. Wait for Runner to return you to the safe destination that started sign-in.
## Complete the new-account questions
Some new accounts see **Tell Runner about your store** before entering the workspace.
1. Choose an answer for the open question.
2. Select **Next question** to continue.
3. Use **Change** to revise an answered question.
4. Select **Get started** when all required questions are complete.
The questionnaire asks for business context; it does not create or publish a store by itself.
## Troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| Invalid email | The address is incomplete or cannot be used as entered. | Correct the address, then select **Continue** again. |
| Sending | Runner is requesting the verification email. | Keep the page open until the code form appears. |
| Incorrect code | The entered code was not accepted. | Re-enter the latest code or request another one. |
| Resend countdown | Another code cannot be sent yet. | Wait until **Resend verification code** is available. |
| Questionnaire failed to save | Runner could not store the answers. | Keep your answers on screen and try the action again. |
Do not share a verification code with anyone. Runner support does not need it to help with an
account issue.
## Related guides
- [Getting started](/en/guides/start-here)
- [Create a Runner store](/en/guides/start-here/create-runner-store)
- [Build your first store](/en/guides/start-here/first-store-quickstart)
---
# Use the Welcome Tour and Daily Credits
Source: https://www.runnerai.com/docs/en/guides/start-here/welcome-tour-and-daily-credits
**What this covers:** You will leave the welcome tour knowing where core tools live and understand what changes after a daily check-in.
Use this page when Runner opens **Welcome to Runner** or when **Earn free credits** is visible.
## Entry paths
- **Welcome tour:** Runner opens **Welcome to Runner** automatically for an eligible account. The tour has no permanent navigation entry.
- **Daily credits:** **Earn free credits** → **Daily check-in**.
## Before you start
- The welcome tour and daily reward can be absent when the account is not eligible or the step is already complete.
- Read the amount, expiry, and claim state in the current dialog rather than relying on an older screenshot.
- Welcome credits are separate from daily check-in credits. Read the current welcome message to see what has already been added before you claim a daily reward.
## Follow the welcome tour
The six tour steps introduce building and previewing, Creative Studio, Skills, Dropshipping,
Store Operations, and Design Mode.
| Control | What happens |
| --- | --- |
| Step dots | Jumps directly to the selected tour step. |
| **Back** | Returns to the previous step. It is disabled on the first step. |
| **Next** | Opens the next step. |
| **Enlarge video** | Opens the current demonstration at a larger size when the video is ready. |
| **Skip tour** or close | Dismisses the tour without changing the store. |
| **Start building** | Finishes the last step and closes the tour. |
1. Read the purpose of the current area.
2. Play or enlarge the demonstration if it helps.
3. Select **Next**, **Back**, or a step dot to move through the tour.
4. Select **Start building** on the final step, or **Skip tour** when you are ready to work.
The tour is instructional. It does not run a Skill, import a product, or change a storefront.
## Claim a daily reward
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsiEEL0uaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
In the image: 1. Open **Earn free credits**. 2. Find **Daily check-in**. 3. **Done** means today’s reward has already been claimed. Account values are masked in this example. Select the image to enlarge it. The annotations use the English desktop interface.
The dialog can show the current streak, today's available credits, the reward expiry date,
credits granted in the current cycle, and the next milestone.
When Runner shows **Welcome Gift**, the message confirms that the displayed welcome credits are already in the balance. The daily button claims a separate reward; it does not claim the welcome grant again.
Closing **Welcome Gift** does not remove welcome credits that are already in the balance. Closing a still-claimable daily check-in leaves that separate daily reward unclaimed.
1. Confirm that the dialog says a reward is claimable.
2. Review the amount and expiry date shown.
3. Select **Check in today** or the visible claim button.
4. Wait for the claimed state before closing the dialog.
5. Check the displayed balance or reward history to confirm the daily reward was added once.
## Troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| Claim button available | Today's reward can be claimed for the workspace shown. | Select it once and wait for confirmation. |
| Checked in / claimed | Today's reward has already been added. | Return on another eligible day. |
| Reward unavailable | The account is not currently eligible or no claim is due. | Close the dialog; do not assume a credit was added. |
| Claim failed | Runner did not confirm the reward. | Keep the dialog open and try again later. |
Closing a claimable reward leaves it unclaimed. Check the displayed expiry before deciding to return later.
## Related guides
- [Getting started](/en/guides/start-here)
- [Build your first store](/en/guides/start-here/first-store-quickstart)
- [Create a Runner store](/en/guides/start-here/create-runner-store)
---
# Store Operations
Source: https://www.runnerai.com/docs/en/guides/store-operations
Use Store Operations to manage the day-to-day information and activity behind your Runner store.
## Why and when to use Store Operations
Open this area after Runner has created your store. It is the practical control center for store details, shipping rules, products, orders, customers, and promotions. Some work, such as supplier sourcing or review moderation, appears only when the corresponding capability is available.
## Availability and prerequisites
- Sign in and open a Runner project that includes a store.
- Wait if Runner shows **Please wait, the store admin is deploying...**. The pages load when the store backend is ready.
- Your workspace role and the store's state can limit which controls are shown.
- Connected payment, shipping, fulfillment, booking, and supplier services can add status-specific controls.
## Open Store Operations
1. Open **Workspace**.
2. Choose the store you want to manage.
3. Select **Store Operations** in the project navigation.
4. If setup cards appear, [complete the required store details and resolve product/shipping setup](/en/guides/store-operations/onboarding-and-general-settings), then select **Open Store Operations**.
5. Choose a section from the Store Operations menu.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRKgUAoOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
English callouts highlight the controls. Select the image to enlarge it.
If these setup cards appear, complete the required details and resolve the optional milestones before using the admin menu. The image does not show publication or payment setup.
## Ask Runner to help from chat
**Entry path:** Open the project → choose **New Task** or an existing conversation.
You can ask Runner to inspect or update approved store records without finding every admin page
yourself. This includes common work with products and variants, customers, inventory, shipping,
fulfillment, orders, returns, promotions, and related records.
1. Name the record and the exact result you want.
2. Ask Runner to inspect the current state first when the change depends on an order, inventory, or
fulfillment status.
3. Explicitly authorize the exact effect before a destructive or order-lifecycle action. A general
request is not permission to delete a record, cancel an order, or advance fulfillment.
4. Wait for Runner's result, then refresh the relevant Store Operations page and verify the updated
state before retrying or starting another change.
Account access, store-system settings, payments, and tax administration are not available through
this chat capability. Product imports and other file uploads still use their dedicated flows.
## Choose the right section
| Section | Use it for | What selecting it shows |
| --- | --- | --- |
| **General** | Store visibility, identity, markets, stock locations, shipping, and review availability | Opens the shared settings page. Most fields use the page **Save**; the **Product reviews** switch saves immediately. |
| **Orders** | Customer purchases and fulfillment progress | Opens the order list; selecting a row opens the full order record. |
| **Products** | Catalog items, prices, images, variants, inventory, and SEO | Opens the product list; **Add** starts a new product and a row opens editing. |
| **Customers** | Customer contact details, addresses, and order history | Opens the customer list; selecting a row opens the customer record. |
| **Discounts** | Automatic discounts and promotion codes | Opens the promotion list. Use **Create**, or **Add First Promotion** in an empty list, to choose a discount type. |
| **Dropshipping** (project navigation) | Conditional supplier catalog browsing | Open the separate project entry; older layouts can show it inside Store Operations. |
| **Print on demand** (project navigation) | Conditional custom printed products fulfilled by Printful | Open the separate project entry. See [Print on demand with Printful](/en/guides/store-operations/print-on-demand). |
| **Reviews** | Conditional review moderation | Appears after product reviews are enabled and supported by the store. |
**General here** manages operating details such as Markets, Stock Locations, and Shipping. [Store General in Settings](/en/guides/account-and-settings/store-general) manages the Runner name, search preview, favicon, and watermark. Check which General page you opened before editing.
The recording moves through Orders, Customers, and Reviews in the tutorial store. It shows empty states and navigation; no purchase, customer creation, refund, or fulfillment is performed.
## Recommended setup order
1. Complete [onboarding and General settings](/en/guides/store-operations/onboarding-and-general-settings).
2. Add a stock location and configure [shipping](/en/guides/store-operations/shipping).
3. Create [products](/en/guides/store-operations/products) and check [variants and inventory](/en/guides/store-operations/inventory-and-variants).
4. Connect a payment service from **Apps** before testing checkout.
5. Use [orders](/en/guides/store-operations/orders), [customers](/en/guides/store-operations/customers), and [promotions](/en/guides/store-operations/promotions) as activity begins.
6. Use [dropshipping](/en/guides/store-operations/dropshipping), [print on demand](/en/guides/store-operations/print-on-demand), or [reviews](/en/guides/store-operations/reviews-and-advanced-admin) only when those entries and prerequisites are available.
## Common states and limits
- **No data yet** is a valid state. Products, orders, customers, promotions, and reviews show an empty message until records exist.
- **Loading is not success.** Wait for a list, saved confirmation, or updated status before assuming an action finished.
- **Unsaved changes stay on the page.** Use **Save** where shown; if Runner warns about leaving, choose whether to remain, save, or exit without saving.
- **Destructive actions require confirmation.** Deleting a product, customer, or promotion cannot be assumed recoverable.
- **Chat results still need verification.** After Runner changes a store record, refresh the relevant page and confirm the new state before retrying.
- **Conditional entries can be absent.** Do not use a copied URL as proof that your store supports a hidden feature.
## If Store Operations does not load
1. Confirm that you opened the intended project.
2. Wait for the deployment message to clear, then refresh the page.
3. Return to the project and select **Store Operations** again.
4. If only one section fails, try its **Refresh** control when available.
5. If the issue continues, keep the project name, section name, visible error, and approximate time for support.
## Related guides
- [Welcome to Runner AI](/en/guides/product-guide)
- [General settings and onboarding](/en/guides/store-operations/onboarding-and-general-settings)
- [Products](/en/guides/store-operations/products)
- [Orders](/en/guides/store-operations/orders)
---
# Customers
Source: https://www.runnerai.com/docs/en/guides/store-operations/customers
Use Customers to keep buyer records accurate and understand the orders connected to each person.
## Why and when to use Customers
Open this section when you need to find a buyer, add a customer record, correct contact or shipping information, or review the person's order history.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- A customer can appear after checkout or be added manually.
- The list labels records as **Guest** or **Registered** when that account information is available.
- A saved Stock Location can be required by address-related store workflows, but it is not a claim that a customer address is a warehouse.
- Use customer data only for the purpose and access allowed by your organization.
## Open Customers
**Entry path:** **Workspace → choose a store → Store Operations → Customers**
Select a customer row to open their profile, available activity and journey details, and Orders. Select **Edit** to reveal the General form; Orders is hidden while you edit.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4cFKBjWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
English callouts highlight the controls. Select the image to enlarge it.
An empty list is expected before customers exist. No customer record was created for this example.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Search customers...** | Find a customer by known details | Filters the customer list after a short delay. |
| **Refresh** | Request current customer data | Reloads the list and related location data. |
| **Create** / **Add Customer** | Add a customer manually | Opens the customer-creation dialog. |
| **Create** in the dialog | Save the new customer | Creates a valid record and opens its detail page after success. |
| Customer row | Inspect one customer | Opens contact details, shipping address, account type, and order history. |
| **Edit** | Correct customer information | Opens General with names, read-only email, company, phone, and shipping-address fields. Orders is hidden while editing. |
| **Orders** section | Review the customer's purchases | Shows connected orders or **No orders yet** in the read-only detail view. |
| **Save** | Apply changes without leaving | Saves valid edits and keeps the detail page open. |
| Back or close with unsaved changes | Decide what to do with edits | Opens an **Unsaved Changes** dialog with **Save and exit** and **Exit without saving**. |
| **Save and exit** | Apply changes and return | From the unsaved-changes dialog, saves valid edits and returns to the customer list. |
| **Exit without saving** | Discard edits after a warning | Leaves the detail page without applying unsaved changes. |
| Desktop list Delete icon / **Delete** | Remove a customer record | Opens a confirmation; confirming cannot be undone. The current mobile list does not show this action. |
A manually created customer is enrolled in **All subscribed customers**. Add only a real record you are entitled to manage; do not create recipients just to explore the form. Empty activity or journey sections mean no events are available for that customer, not that the profile failed to save.
The empty list can show **0 Customers**. Use the search, sort, and tag filters to locate records once customers exist. Clear filters before concluding a customer is missing.
The blank form shows the required Email and available optional fields. **Create** remains disabled until required information is supplied; no record was saved.
### Video: Customers before the first sale
The recording opens Customers on a store with no sales and points at **Add Customer**. It shows the empty list and the manual entry point only; it does not create a customer, and it does not show checkout adding one.
## Add a customer
1. Select **Create** or **Add Customer**.
2. Enter the required **Email**. Add First Name and Last Name when known; review optional tags, address, company, phone, custom fields, and Memory only when you have relevant information.
3. Review the values for spelling and the intended customer.
4. Select **Create** once.
5. In the opened record, select **Edit** before adding optional company, phone, or shipping-address details.
6. Select **Save**, then return to the list and confirm the new row appears. If you leave with unsaved changes instead, choose **Save and exit** in the warning.
7. A valid new customer is automatically enrolled in **All subscribed customers**.
## Update a customer
1. Search for and select the customer.
2. Select **Edit**. In the **General** form, review First Name, Last Name, the read-only Email, Company, Phone, and Shipping address.
3. Use **Add** to add the address information Runner requests, or **Clear** to remove the current editable address values.
4. Select **Save** to remain on the record. To save while leaving, use the back or close control and choose **Save and exit** in the warning.
5. Leave editing after saving, then inspect **Orders** to confirm the connected purchases.
## States and limits
- **Guest** means the record is not shown as a registered customer account; it can still have orders.
- A checkout guest who orders or books is not added to **All subscribed customers**. A guest joins only through the storefront newsletter form or by creating an account.
- **Registered** identifies an account-backed customer record.
- **No customers yet** and **No orders yet** are valid empty states.
- Search filters the current project only.
- Customer updates do not change historical order totals or payment states.
- Recreating a customer does not override an earlier unsubscribe or an email provider's suppression for that address.
- Delete is explicitly irreversible and currently available from the desktop list only. Confirm the displayed email before continuing and retain data only according to your organization's policy.
## Troubleshooting
- **No customers found:** Clear or shorten the search and verify that you opened the correct project.
- **Save fails:** Complete required fields, correct the email or address, and retry once.
- **You cannot leave the record:** Choose **Save and exit** or respond to the Unsaved Changes dialog with **Exit without saving**.
- **Orders are missing:** Confirm the order used the same customer record or email and refresh both Customers and Orders.
- **Customer details fail to load:** Return to the list, select **Refresh**, and reopen the row.
## Related guides
- [Orders](./orders)
- [Promotions](./promotions)
- [Onboarding and General settings](./onboarding-and-general-settings)
- [Store Operations overview](/en/guides/store-operations)
---
# Sell digital products
Source: https://www.runnerai.com/docs/en/guides/store-operations/digital-products
Use digital products to sell files, such as e-books, PDF guides, templates, and other downloads. Nothing ships. After a buyer pays, Runner emails them a private link to a delivery page on your storefront, where they download the files within the limits you set.
## How it works
1. **Create a Digital product.** Choose **Digital** as the product type. Digital products have no shipping and no stock count.
2. **Add benefits.** A benefit is what the buyer receives, such as a set of files. Benefits are reusable across every product in your store.
3. **Write the delivery email.** Runner sends it once payment is captured.
4. **Publish.** Runner checks that every benefit has a ready file and that store email is on.
5. **Manage deliveries on the order.** Resend the email, revoke or re-grant access, and decide what happens to access after a refund.
### Watch: sell a digital product from start to finish
The recording creates a **Digital** product and adds one benefit of each type: **File downloads**, **Single-use codes or links**, **Shared invite link**, and **Note**. It writes the **Delivery email**, sets the product to **Published**, and saves. A shopper then buys it with a card, sees the purchase on the order page, opens the delivery email, downloads a file, reveals a code, and selects **Email me a new link**. Back in **Orders**, the order's **Digital delivery** card shows each benefit, and the recording uses **Resend**, **Revoke**, and **Re-grant**. Last, it refunds a second order with **Revoke the buyer's access**. The card details are entered off camera.
## Before you start
**Entry path:** **Workspace → choose a store → Store Operations → Products**
If **Digital** is not in the **Product Type** list, digital products are not yet enabled for your account. Contact [Runner support](/en/guides/help-and-reference/support-and-community) to request access. If the product form says **Your store needs an update before it can sell digital products.**, your store runs an older version; contact support to update it.
You need:
- a published store, because buyers open their purchase on your storefront;
- store email turned on under **Project → Apps → Run your store → Email** while the delivery email is on (see [Enable store email](/en/guides/apps-and-integrations/resend-email)); and
- a payment provider, so buyers can pay. See [Stripe payments](/en/guides/apps-and-integrations/stripe-payments).
## 1. Create a digital product
1. Open **Store Operations → Products** and select **Add**.
2. In **Product Type**, choose **Digital**.
3. Enter the name, description, images, and price as you would for any product.
A digital product has no shipping section, and its stock is not tracked: the product list shows **-** under **Inventory**. Shoppers who buy only digital products check out without a shipping step.
## 2. Add benefits
The **Benefits** section lists what buyers receive. Buyers get every benefit on the list.
### Create a benefit
1. Select **Create benefit**.
2. Enter a **Name**, such as "Field guide files". Buyers see it on the delivery page and in the email.
3. Drop files on **Drop files here**, or select **Browse files**. A benefit holds up to 20 files, 5 GB each. Files stay private: buyers download them only through their link.
4. Under **Access rules**, choose:
- **Limit downloads** and the **Downloads per item**. A failed download can be retried within 15 minutes without using another download.
- **Link expires** and how long the **Link works for**, in hours or days. A resend gives the buyer a fresh link.
5. Select **Create** to start uploading the files. Keep the dialog open until the uploads finish and the benefit appears in the product's **Benefits** list.
To reuse a benefit you already made, select **Add existing benefit**. Drag benefits, or use **Move up** and **Move down**, to set the order buyers see. A digital product keeps at least one benefit.
### Choose a benefit type
When you create a benefit, choose its **Type**. You can't change it later.
| Type | What buyers get |
| --- | --- |
| **File downloads** | Private files buyers download from their delivery page. |
| **Single-use codes or links** | Each buyer gets a different code or link from a list you paste. The product sells out when the list runs out. |
| **Shared invite link** | One link every buyer opens, such as a community invite. |
| **Note** | Text buyers see after purchase, or a hidden tag you fulfil yourself. |
If **Type** shows only **File downloads**, your store runs an older version; contact [Runner support](/en/guides/help-and-reference/support-and-community) to update it.
#### Single-use codes or links
1. In **Add codes or links**, paste one code or link per line, up to 10,000 at a time. Repeats are skipped, and every value is stored encrypted.
2. The benefit shows how many values are **Ready to sell** and how many are **Sold or held for orders**, and warns you when only a few are left. When the list is empty, the product shows as sold out and checkout refuses it.
3. Each unit a buyer pays for gets its own value, which the buyer reveals on their delivery page.
4. To take back a value nobody has bought, remove it from **Unused values**.
On the order, the **Digital delivery** card shows the end of each value and whether the buyer revealed it. Select **Reveal** to see the whole value, or **Copy** to copy it.
#### Shared invite link
Enter the **Invite link**, starting with https:// or http://. Every buyer gets the same link, so set its expiry where the link lives, such as in your community's settings. The order card shows whether the buyer opened it.
#### Note
Write the note in **Private note**, then choose its **Visibility**:
- **Visible**: buyers see it after purchase, on the order confirmation and their delivery page.
- **Hidden**: granted on purchase but never shown to the buyer, for example to tag orders you fulfil yourself.
A published product keeps at least one benefit buyers see, so you can't hide its only visible note. You can't hide a note that a product's delivery email names either: remove it from the email first. Hidden notes have no email variables.
### Pause a benefit
Turn off the switch next to a benefit to pause it for every buyer of every product that uses it. Buyers can't download it until you turn it back on. New purchases wait, and their email goes out once you turn the benefit back on.
### Change files later
You can add files to a benefit at any time; existing buyers see them on their delivery page. Removing a file removes it for every buyer. A benefit that products sell keeps at least one file: add another file first, or remove the benefit from those products.
## 3. Write the delivery email
The **Delivery email** section controls the message buyers get once payment is captured.
| Setting | What it does |
| --- | --- |
| **Send the delivery email** | Turn it off to deliver only on the order confirmation page. Buyers then reach their purchase there for 24 hours, and customer resends are off. |
| **From** | The sender name buyers see. The email comes from Runner's address, and replies go to your store's contact email. |
| **Subject** and **Message** | Use **Insert variable** to add the order number, order date, product name, total paid, the buyer's name or email, your store name, and **All benefits**, which prints the list of benefits. Links, expiry, and downloads belong to a single benefit, so they are listed under each one. |
| **Logo URL** and **Accent color** | Every delivery email uses one design. A **Logo URL** puts your logo at the top of the email, and the accent color marks each benefit's name and button. Leave **Logo URL** empty to send the email without a logo. |
Select **Preview** to see the email for a sample order. The editor refuses a variable it doesn't know.
Under **Advanced settings**:
- **Customers can resend the email** lets buyers send it again from their delivery page, up to 3 times a day, to the order's email address.
- **Resend automatically on a temporary bounce** retries once after 30 minutes with the same link.
## 4. Publish
Set **Status** to **Published** and save. If something is missing, Runner saves the product as a draft and shows **This product can't be published yet** with what to fix:
| Message | What to do |
| --- | --- |
| **Add at least one benefit.** | Add a benefit in the **Benefits** section. |
| **Add a file to** a benefit | Upload at least one file to that benefit. |
| **Wait for** a benefit **to finish uploading.** | Keep the page open until every file shows **Ready**. |
| **Turn on the Email app in Apps, or turn off this product's delivery email.** | Turn on **Email** under **Project → Apps → Run your store**, or turn off **Send the delivery email**. |
| **Your store needs an update before it can sell digital products.** | Contact [Runner support](/en/guides/help-and-reference/support-and-community). |
## What buyers get
1. The buyer checks out. A cart with only digital products has no shipping step.
2. Once payment is captured, Runner emails the buyer a link to their delivery page on your storefront. The order confirmation page also shows the purchase for 24 hours.
3. On the delivery page, the buyer downloads each file. Every download counts against the limit, and the link stops working when it expires or when you send a newer one.
4. If you allow it, the buyer can ask for the email again from the delivery page.
## Manage deliveries on an order
In **Store Operations → Orders**, the **Fulfillment** column shows each digital order's delivery state, using the states in the table below. When an order has several benefits, the column shows the one that needs you first: **Failed**, then a state that isn't delivered yet (**Pending**, **Sending**, or **Link ready**), then **Delivered**. **Downloads used up**, **Expired**, and **Revoked** show only when every benefit has ended. An order shows **No shipping** until its payment is captured.
Open **Store Operations → Orders** and select an order. The **Digital delivery** card shows each benefit with its state, **Downloads used**, **Link expires**, and **Last activity**.
| State | Meaning |
| --- | --- |
| **Pending** | Delivery is waiting, for example while the benefit is paused. |
| **Link ready** | The link exists. The email is queued, or the delivery email is off. |
| **Sending** | The email is on its way. |
| **Delivered** | The email reached the buyer. |
| **Failed** | Delivery stopped. The card says why, for example **Store email is off** or **The store is not published**. |
| **Downloads used up** | The buyer used every download. A resend restores them. |
| **Expired** | The link expired. A resend gives a fresh link. |
| **Revoked** | You revoked access. |
Use the actions on the card:
- **Resend** emails a new link, optionally to a corrected address. Earlier links stop working, and used-up downloads are restored.
- **Revoke** stops new downloads for one benefit or the whole order. A download link issued in the last minute can still finish.
- **Re-grant** restores revoked access with a fresh download allowance and emails a new link.
**Delivery history** lists every email and its result, and **Journey** lists every event, such as **Email opened**, **Delivery page opened**, and **Downloaded**. Select **Export CSV** to download the journey.
To find orders that need you, turn on the **Needs attention** filter on the order list. It shows failed deliveries and refunds without an access decision.
### Refunds
When you refund an order with digital items, choose **Keep the buyer's access** or **Revoke the buyer's access** in the refund dialog. A refund made elsewhere, such as in your payment provider's dashboard, shows on the card that the order was refunded and access is still active, with **Keep access** and **Revoke access**, so you can decide later.
## Create a digital product in chat
You can also ask Runner in chat. Attach the files to your message and describe the product, for example "Sell this PDF as a $12 e-book". Runner creates a draft product with a benefit for the files and drafts the delivery email. It stops where only you can act, for example when store email is off. Review the draft in **Products** before you publish.
Files attached in chat are limited to what chat accepts: documents up to 10 MB and images up to 32 MB. Upload larger files in the product form.
## Troubleshooting
| Problem | What to do |
| --- | --- |
| The card shows **Failed** with **Store email is off** | Turn on **Email** under **Project → Apps → Run your store**, then select **Resend**. |
| The card shows **Failed** with **The store is not published** | Publish your store, then select **Resend**. |
| The email **Bounced** | Check the address with the buyer, then select **Resend** and enter the corrected address. |
| **No file was ready when the order was paid.** | Upload a file to the benefit, then select **Resend**. |
| **The benefit is paused.** | Turn the benefit back on. The waiting email goes out. |
---
# Dropshipping
Source: https://www.runnerai.com/docs/en/guides/store-operations/dropshipping
Dropshipping lets you sell supplier products without holding stock: when a customer buys, Runner sends the order to your supplier, and you confirm and pay for it in your supplier account so the supplier ships it to your customer.
**Entry path:** **Workspace → choose a store → Dropshipping**
Older layouts can show Dropshipping inside **Store Operations**. Use the entry your project shows.
## How dropshipping works
| Stage | What you do | What Runner does |
| --- | --- | --- |
| [1. Connect](#1-connect-a-supplier) | Connect your own CJ Dropshipping or AliExpress account. | Uses that account to search, import, and place supplier orders. |
| [2. Browse and choose](#2-browse-and-choose-a-product) | Pick a destination, find a product, and compare variants, stock, and delivery estimates. | Loads live supplier data for your connected account. |
| [3. Review and publish](#3-review-and-publish-a-product) | Choose a target market, set prices, select variants, and add the product. | Creates the product and publishes it to that market. |
| [4. Fulfill orders](#4-fulfill-orders) | **Pay for each supplier order in your supplier account**, then record shipment on the store order. | Creates the supplier order automatically after checkout and shows its status and tracking. |
To stop using a supplier or switch supplier accounts, see [Disconnect a supplier](#disconnect-a-supplier). It's a separate task with its own checks, not part of the everyday workflow.
:::warning
Runner places supplier orders for you, but it **does not pay the supplier**. A supplier order stays unpaid, and does not ship, until you confirm and pay for it in your CJ or AliExpress account.
:::
## Before you start
- **Your own supplier account.** Use a CJ Dropshipping account or an AliExpress buyer account that can pay for orders. You pay the supplier for each order separately from what your customer pays you.
- **Owner or admin role.** Only a workspace owner or admin can connect or disconnect a supplier. Other members see **Only a workspace owner or admin can connect this supplier. Ask them to do it.**
- **A store market.** Dropshipping destinations come from your store markets. Without a market, the page shows **Add a market to choose a shipping destination and browse products.**
- **A payment service.** Customers can only buy after a payment service is connected under **Apps**.
Supplier connections belong to your organization, so every store in the workspace uses the same CJ and AliExpress connections. CJ and AliExpress connect separately; connecting one never replaces the other.
## 1. Connect a supplier
You can browse the **Trending**, **Low cost**, and **Under $5** preview shelves without a connection. Searching, opening live product data, and adding products require a connected supplier.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
English callouts highlight the controls. Select the image to enlarge it.
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Connect supplier** | Start your first supplier connection. | Opens **Connect and manage suppliers** with separate CJ Dropshipping and AliExpress panels. |
| **Manage suppliers** | Check, reconnect, or disconnect an existing connection. | Replaces **Connect supplier** once any supplier is connected and opens the same dialog. |
| **How it works** | Compare the two connection methods. | Explains that CJ uses an API key and AliExpress uses AliExpress sign-in. |
| **CJ API Key** | Connect your CJ account. | Accepts the key you copied from CJ. The value stays hidden. |
| **View CJ instructions** | Find your API key in CJ. | Opens CJ's API key instructions in a new tab. |
| **Connect CJ Dropshipping** | Submit the key. | Runner checks the key with CJ. On success the dialog closes and CJ shows as connected. |
| **Connect AliExpress** | Connect your AliExpress buyer account. | Sends you to AliExpress sign-in, then returns you to Dropshipping. |
| **Reconnect AliExpress** | Renew AliExpress access before or after it expires. | Repeats AliExpress sign-in for the connected account. |
### Connect CJ Dropshipping
1. Open **Dropshipping** and select **Connect supplier** (or **Manage suppliers**).
2. In your CJ Dropshipping account, open **Apps → API**, then select the **API** tab. Copy the key with type **API Key** from the **API Key & MCP Token** column. If you don't have one, select **Add API** to create it. Select **View CJ instructions** in Runner if you need CJ's own steps.
3. Paste the key into **CJ API Key** and select **Connect CJ Dropshipping**.
4. Wait for the dialog to close and CJ Dropshipping to show as connected.
5. Search for a product to confirm that your CJ catalog loads.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw6oh1NIkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
In CJ, open **Apps** (1) and **API** (2), select the **API** tab (3), and copy the key from **API Key & MCP Token** (4). Select the image to enlarge it. Keep your key private; this example hides key values.
If you see **We couldn't connect CJ — double-check the API key and try again.**, copy the key from CJ again and retry. This message means CJ rejected the key. If you see **CJ didn't respond. Try again in a moment.**, CJ had a problem while checking the key; try again shortly. If you see **CJ is limiting requests for this account. Wait a few minutes, then try again.**, the key can still be valid: CJ is limiting calls to your CJ account, for example because another app uses the same key. Wait a few minutes, then try again.
### Connect AliExpress
1. Open **Dropshipping** and select **Connect supplier** (or **Manage suppliers**).
2. Select **Connect AliExpress**. Your browser leaves Runner and opens AliExpress sign-in.
3. Sign in with the AliExpress **buyer** account you will use to pay for supplier orders, and approve access.
4. When AliExpress returns you to Runner, look for **AliExpress is connected**. If you started from a search or a product, Runner returns you to it instead.
If you see **We couldn't open AliExpress sign-in. Try again.**, start the connection again from the same Runner account.
**AliExpress access expires.** AliExpress sets how long access lasts. Runner shows **Your AliExpress authorization expires soon** and emails workspace owners and admins 7 days and 1 day before it expires. Select **Reconnect AliExpress** and sign in with the **same** AliExpress account. If access expires, searching, importing, and new AliExpress orders stop until you reconnect.
The recording reviews existing CJ and AliExpress connections, then returns to the catalog. It does not connect, disconnect, buy, or import anything.
## 2. Browse and choose a product
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgL9CDE0P6BaUgYNS457p8WDbAxIJ2kfdz9Vju)
English callouts highlight the controls. Select the image to enlarge it.
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Trending**, **Low cost**, **Under $5** | Browse ideas without searching. | Opens a preview shelf. Shelves are not popularity, margin, or delivery guarantees. |
| **Search products...** | Find items by keyword. With AliExpress you can also paste a product ID or link. | Loads results from your connected supplier. Without a connection, opens the connection dialog. |
| **Ship to** | Choose the country you sell to. | Reloads products that can ship there. Only countries in your store markets can be selected; others show **Add** so you can create a market. |
| Supplier selector | Limit results to one supplier. | Shows **All suppliers**, **CJ Dropshipping**, or **AliExpress**, depending on what you connected. |
| **Category**, **Ship from**, **Price** | Narrow the results. | Filters by category, supplier warehouse country, and your minimum and maximum price. |
| Sort | Change the result order. | CJ offers price, listing, and newest sorts. AliExpress offers **Best match** and **Most orders (past 180 days)**; it cannot reliably sort by price. |
| Product card | Evaluate one item. | Opens its images, variants, stock, supplier price, and delivery estimates. |
1. Choose **Ship to**. It starts at the United States when that is one of your markets, otherwise at your default market.
2. Browse a shelf or search. Use the supplier selector and filters to narrow results.
3. Open a product card. Check the images, the variants you want to sell, stock (**in stock** or **Out of stock**), and the supplier price.
4. For each variant, review the **Reference shipping method** and **Estimated delivery time**. These are supplier estimates, not delivery guarantees.
5. Select **Back** to compare other products. Your destination stays selected.
## 3. Review and publish a product
The product page combines product setup, market, pricing, and shipping in one place. Selecting **Add Product to Store** creates the product and publishes it to the selected market.
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Target market** | Choose which market sells this product. | Sets the currency for your prices. It starts from your **Ship to** choice. **Add market** creates a new one. |
| **Customer shipping charges** | Decide what customers pay for delivery. | **Use store shipping rates** charges your market's shipping rates at checkout. |
| **Set your markup** | Price all variants from one markup. | Suggests a retail price for each selected variant from its product cost and supplier shipping reference. |
| **Retail prices** | Set your selling price per variant. | Updates the estimated profit and margin for that variant. |
| Variant checkbox | Choose which variants to sell. | Adds or removes the variant. The action bar shows how many variants are selected. |
| **Reference shipping method** | Estimate your supplier shipping cost. | Updates the cost breakdown: **Product cost**, **+ Supplier shipping reference**, **+ Profit · margin**. |
| **Add Product to Store** | Create and publish the product. | Imports the selected variants and publishes the product to the target market. Shows **Connect supplier** when disconnected. |
### Configure product details and prices
1. Choose the **Target market**.
2. Select only the variants you intend to sell. Skip variants that show **Out of stock**.
3. Choose a **Reference shipping method** for each variant and check its **Estimated delivery time**.
4. Enter a markup in **Set your markup**, or type a price for each variant in **Retail prices**.
5. Check the cost breakdown and the **Average estimated profit per unit**. Make sure each price covers the product cost and the supplier shipping you will pay.
CJ quotes supplier costs in US dollars. When your market uses another currency, Runner shows converted amounts for reference only.
### Choose target markets
- Each import publishes to one market at a time. Prices are saved in that market's currency.
- To sell the same product in another market, return to the product in Dropshipping, choose the other **Target market**, enter prices in that currency, and select **Add Product to Store** again.
- Every variant of the product needs a price in the market's currency before it can be published there.
### Set up shipping
- Customers pay your **store shipping rates** for their market, not the supplier's shipping cost. Include the estimated supplier shipping in your product price or your shipping rate.
- A new market's **Shipping cost** is the rate customers pay. **Enter 0 for free shipping.** You can change delivery options later in [Shipping](./shipping).
- Supplier costs vary by delivery address. At checkout, Runner rechecks your supplier connection, stock, price, and shipping for the customer's address. If the supplier can no longer supply the item, checkout stops instead of accepting an order you can't fulfill.
### Publish and check the result
1. Select **Add Product to Store** once your variants and prices are set.
2. Wait for **Published. You can select another market to publish this product there.** A **Changes saved** message with **Preview store** also appears.
3. Open **Products** and check the product, its variants, prices, images, and description. You can edit the title, description, and images there.
4. Preview the store and confirm that the product appears in the market you chose.
Dropshipping products don't track inventory in Runner; the supplier's stock is checked at checkout. The **Inventory** column in Products shows a dash for them.
If you see **The result is not confirmed. Retry the same request before changing this selection.**, select the same action again without changing your selections, then check **Products**.
Older stores can show a different product page with **Ship from**, **Ship to**, a shipping method list, and **Add to Store**. The same rules apply: choose a route and quote, set a price for every selected variant, then add the product.
## 4. Fulfill orders
When a customer buys a dropshipping product, fulfillment has two halves. Runner places the supplier order for you. **You must then confirm and pay for it in your supplier account.** The supplier doesn't ship until you do.
### What Runner does automatically
- After checkout, Runner creates a supplier order in your connected CJ or AliExpress account. You don't need to click anything in Runner to send it.
- One store order can create several supplier orders, one for each supplier, warehouse, or shipping method.
- Each supplier order appears in the store order's **Dropshipping fulfillment** section with its status, **Shipping Method**, **Warehouse**, **Items**, and **Last updated** time. Tracking details appear once the supplier ships.
- If a supplier order can't be created on the first try, Runner keeps retrying and shows **Pending Creation** meanwhile.
- Runner updates supplier status when you open the order, when you select **Refresh Status**, and in a daily background check for orders placed in the last 90 days. For older open orders, select **Refresh Status** or contact support.
Runner does **not** pay the supplier and does **not** mark the store order as shipped for you.
### Fulfill an order step by step
1. Open **Store Operations → Orders** and select the order.
2. Find **Dropshipping fulfillment**. Wait until the supplier order shows **Created** or **Unpaid**. If it still shows **Pending Creation**, check back later; Runner is retrying.
3. **Pay for the supplier order in your supplier account:**
- **CJ Dropshipping:** sign in to CJ, open your orders, and find the order whose number contains your Runner order number (for example, `…-1042-0` for order 1042). Confirm the shipping details and pay for it from your CJ balance or payment method.
- **AliExpress:** Runner shows **Manual payment required** and the **AliExpress supplier order IDs**. Sign in to the connected AliExpress buyer account and pay for each listed order.
4. Return to the order in Runner and select **Refresh Status**. After payment, the status moves to **Processing**, then **Shipped** when the supplier dispatches it.
5. When **every** supplier order in **Dropshipping fulfillment** shows **Shipped**, select **Mark as fulfilled** on the store order, then **Mark as Shipped**. Enter the **Shipping carrier** and a **Tracking Number** from the Dropshipping fulfillment section. This records the shipment on the store order your customer sees.
6. When every supplier order shows **Delivered**, select **Mark as Delivered**.
**Mark as fulfilled** and **Mark as Shipped** apply to the whole store order, including any items you ship yourself, and you can mark an order shipped only once. If an order has several supplier orders, wait until all of them have shipped, then send the other tracking numbers to your customer directly.
:::warning
Don't place the same order again yourself in CJ or AliExpress. Runner already created it. A second order means the supplier ships, and charges you, twice.
:::
### Supplier order statuses
| Status | What it means | What to do |
| --- | --- | --- |
| **Pending Creation** | Runner is still creating the supplier order. | Wait. Runner retries automatically. **Refresh Status** doesn't apply yet. |
| **Created**, **In Cart**, **Unpaid** | The supplier has the order, but it isn't paid. | Pay for it in your CJ or AliExpress account. |
| **Processing**, **Other** | Paid; the supplier is preparing it. AliExpress orders at this stage show **Other**. | Wait for tracking. Select **Refresh Status** to check. If an AliExpress order stays at **Other**, open it in your AliExpress account to see whether it needs anything, such as a complete address. |
| **Shipped** | The supplier dispatched it. | Select **Track Order** to follow it. When every supplier order for the store order has shipped, record the shipment with **Mark as Shipped**. |
| **Delivered** | The supplier reports delivery. | Select **Mark as Delivered** on the store order. |
| **Pending Cancellation** | Runner asked the supplier to cancel. | Wait, then select **Refresh Status**. |
| **Cancelled**, **Voided** | The supplier order won't ship. | Check that the store order is also canceled or refunded. |
| **Failed** | Runner couldn't create the supplier order. | Check your supplier account for the order. If it isn't there, contact support before placing it manually. |
| **Manual review required** | Runner couldn't confirm whether the supplier received the order. | Don't submit it again. Select **Contact support** so the order can be reconciled safely. |
### Cancel or refund a dropshipping order
When you select **Cancel Order** on a store order, Runner automatically asks the supplier to cancel its supplier orders. You don't need a separate step in Runner.
- **CJ Dropshipping:** Runner sends the cancellation to CJ while the supplier order hasn't shipped. CJ decides whether it can still be cancelled.
- **AliExpress:** Runner can only stop the order before it is created in AliExpress; AliExpress doesn't accept cancellations from Runner. After that, Runner shows **Manual cancellation required** and **Do not pay; cancel these supplier order IDs in AliExpress.** Cancel those orders in your AliExpress account.
After you cancel, open the order and check **Dropshipping fulfillment**. **Pending Cancellation** means Runner is waiting for the supplier; **Cancelled** means it's done. If the status doesn't reach **Cancelled**, cancel the order directly in your CJ or AliExpress account, and don't pay for it.
- **A refund doesn't cancel the supplier order.** If you refund a customer without canceling the order, the supplier can still ship it and charge you.
- **Supplier costs aren't refunded by Runner.** If you already paid the supplier, request a refund from CJ or AliExpress.
## Disconnect a supplier
Disconnect only when you stop using a supplier or need to switch supplier accounts. Disconnecting removes your CJ API key or AliExpress access from the organization. It affects every store in the workspace.
:::warning
**Fulfill and close ongoing orders before you disconnect.** After you disconnect, Runner stops updating those supplier orders: status, tracking, **Refresh Status**, and cancellation stop working in Runner, and you must manage them directly in CJ or AliExpress.
:::
### Before you disconnect
1. Open **Store Operations → Orders** and review every order with a **Dropshipping fulfillment** section for this supplier.
2. Pay for every **Created**, **In Cart**, or **Unpaid** supplier order, or cancel it.
3. Wait for **Pending Creation** and **Processing** orders to be created, shipped, or cancelled.
4. Record the shipment on each store order with **Mark as Shipped** once all of its supplier orders have shipped.
5. Set this supplier's products to **Draft** in **Products**, or delete them. After you disconnect, customers can't check out with them.
### Disconnect
1. Open **Dropshipping** and select **Manage suppliers**.
2. Select **Disconnect** for CJ Dropshipping or AliExpress.
3. Read **Disconnect CJ Dropshipping?** or **Disconnect AliExpress?**: **You won't be able to add new products or get updates from this supplier. Products and orders already in Runner stay.**
4. Select **Disconnect** to confirm, or **Cancel** to keep the connection.
5. Check that the supplier no longer shows as connected.
If you see **We couldn't disconnect CJ — it's still connected. Try again.** or **AliExpress is still connected. Disconnecting didn't go through. Try again.**, the connection is still active. Retry, and don't assume it was removed.
### What changes after you disconnect
| Area | Result |
| --- | --- |
| Products | Stay in **Products**, but checkout stops for them until you reconnect and, where needed, import them again. |
| New orders | Customers can't buy this supplier's products, so no new supplier orders are created. |
| Existing supplier orders | Stay in the order, but stop updating. Manage them in CJ or AliExpress. |
| Other supplier | Not affected. Disconnecting CJ doesn't disconnect AliExpress, or the reverse. |
## Troubleshooting
- **Search or Add Product to Store opens the connection dialog:** Connect CJ or AliExpress. The preview shelves don't count as a connection.
- **No results:** Clear the search and filters, confirm **Ship to**, or switch supplier.
- **A country can't be selected in Ship to:** Add a market for it, then choose it again.
- **An order is stuck in Unpaid:** Runner never pays suppliers. Pay for the order in your CJ or AliExpress account.
- **The customer hasn't received tracking:** Runner doesn't copy supplier tracking to the store order. Use **Mark as Shipped** with the tracking number.
- **Refresh Status fails with "That didn't go through — the order is unchanged. Try again.":** The supplier connection may have changed since the order was placed. Check **Manage suppliers**, then manage the order in your supplier account.
- **Checkout stops for a dropshipping product:** The supplier connection, stock, price, or shipping changed. Reconnect the supplier or import the product again.
- **A product shows the wrong result after Add Product to Store:** Check **Products** before retrying. A loading state isn't proof that the import finished.
- For exact error messages, see the [Dropshipping catalog error playbook](/en/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products).
## Related guides
- [Orders](./orders)
- [Products](./products)
- [Shipping](./shipping)
- [Inventory and variants](./inventory-and-variants)
- [Connect CJ Dropshipping](/en/guides/apps-and-integrations/cj-dropshipping)
- [Store Operations overview](/en/guides/store-operations)
---
# Import products
Source: https://www.runnerai.com/docs/en/guides/store-operations/import-products
Import products from a prepared CSV when entering the same structured catalog information one product at a time would be inefficient.
## Why and when to use import
Use Import when you already have product data in a spreadsheet or another system and can map it to Runner's CSV template. Use the manual [Products](./products) form for a small catalog or when you need to learn the fields first.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- Open **Store Operations → Products** in a ready store.
- Complete the store publish/readiness setup that creates its live storefront catalog channel; the import task cannot continue without that channel.
- The populated desktop product list shows **Import**. In an empty catalog, first use **Add First Product**; the mobile view emphasizes manual creation.
- Import accepts CSV files only.
- Use Runner's current Template. Required columns are `Product Handle` and `Product Title`; variant rows use the option fields shown by the template, and `Variant SKU` is optional.
- Starting an import changes the store catalog. Review the file before submitting it.
## Open Import Products
**Entry path:** **Workspace → choose a store → Store Operations → Products → Import**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRTPhrLOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
English callouts highlight the controls. Select the image to enlarge it.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Import** | Open the bulk-import workflow | Opens the Import Products dialog without starting a task. |
| **Template** | Start from Runner's expected columns | Downloads the current `product-import-template.csv` file. |
| **History** | Check earlier import tasks | Switches to a list of import files and their latest states. |
| Upload area | Choose the prepared CSV | Reads the file locally and shows it as ready when content is available. |
| Remove-file control | Correct a wrong selection | Clears the selected file so you can choose another. |
| **Start Import** | Submit the selected CSV | Starts an import task, then moves to History when Runner accepts it. |
| **Cancel** | Leave without submitting | Closes the dialog and clears the selected file. |
| **Refresh** in History | Request the latest task state | Reloads the visible import history. |
| **Back to Import** | Prepare another file | Returns from History to the upload view. |
| **Close** | Leave History | Closes the dialog without changing the task already submitted. |
## Prepare and submit a CSV
1. Select **Import**, then **Template**.
2. Open the downloaded CSV in a spreadsheet editor that preserves CSV formatting.
3. Keep the template headers. Complete `Product Handle` and `Product Title` for products, plus the shown option values for variants. Add `Variant SKU` when your catalog uses SKUs.
4. Review product handles, titles, prices, variants, and any repeated rows before exporting as CSV.
5. Return to the dialog and choose or drag the CSV into the upload area.
6. Wait until the file shows **Ready to import**.
7. Select **Start Import** once.
8. In **History**, follow the submitted file until it reaches a terminal state, then refresh the Products list and inspect the resulting rows.
To learn the workflow without changing the catalog, download **Template**, review its headers, then open **History**. Return with **Back to Import** and close the dialog. Selecting a file prepares it; only **Start Import** submits a catalog change.
The recording inspects import requirements and empty History, then returns to draft products. No CSV is submitted or imported.
## Understand History states
| State | Meaning | What to do |
| --- | --- | --- |
| **Pending** | The task is waiting to start | Leave it in place and check again later; do not immediately submit a duplicate. |
| **Processing** | Runner is working through the file | Keep the dialog open or return to History later. |
| **Completed** | Runner finished handing the file to the catalog importer | Product processing can continue after this state. Refresh Products and inspect names, variants, prices, status, and inventory. |
| **Failed** | Runner could not finish the import task | The current History card records the failed state but not a detailed cause. Check the prerequisites and source CSV before submitting a new file. |
| **Cancelled** | The task did not continue | Confirm whether any products were created before deciding what to submit next. |
History can also show the file size, total rows, and a transaction ID when Runner has those values. These details identify the task; they do not replace checking the product records.
## Limits and troubleshooting
- **Start Import is disabled:** Select a `.csv` file and wait for Runner to finish reading non-empty content.
- **Invalid File Type:** Export the spreadsheet as CSV; renaming another file format does not convert it.
- **File Read Error:** Re-export the CSV, confirm it opens normally on your device, and choose it again.
- **Import Failed:** Confirm the store publish/readiness setup created the live storefront catalog channel, then use the provided template, restore required columns, and check variant option values and any supplied `Variant SKU` values.
- **The task looks stuck:** Open History and select **Refresh**. Pending and Processing are not proof of completion.
- **Unexpected product rows appear:** Do not repeat the same import blindly. Compare the CSV handles with the Products list and correct records deliberately.
## Related guides
- [Products](./products)
- [Inventory and variants](./inventory-and-variants)
- [Onboarding and General settings](./onboarding-and-general-settings)
- [Store Operations overview](/en/guides/store-operations)
---
# Inventory and variants
Source: https://www.runnerai.com/docs/en/guides/store-operations/inventory-and-variants
Use variants and inventory to represent the choices customers can buy and the quantity the store can sell.
## Why and when to use variants and inventory
Add variants when one product has customer choices such as size or color. Enter inventory when Runner should track how many units are available at the store's stock location.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- Save a Stock Location in **Store Operations → General** before entering tracked inventory.
- Save the appropriate Market and currency before setting prices.
- Open a manual product. Booking and dropshipping products can use different availability rules and show a dash in the list instead of normal inventory totals.
- Plan option names and values before editing a live product because changing them can change the set of purchasable variants.
## Open variants and inventory
**Entry path:** **Workspace → choose a store → Store Operations → Products → Add**, or select an existing product row, then find **Variation** and the inline price and stock fields.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggCsEjzIC4NbwvYeKD2nM5xTZ76dBjp0auiyP)
English callouts highlight the controls. Select the image to enlarge it.
Inspect each variation price and stock value before saving. No inventory or price update was saved for this screenshot.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| Add-option control in **Variation** | Add the first customer choice | Creates fields for an option name and its values. |
| Add-value control | Add another choice within an option | Adds another value that can be combined into variants. |
| Another option | Add a second dimension such as color | Creates another option group and expands the variant combinations. |
| **Remove** | Remove an option or value | Removes that choice from the form and can change the generated combinations. |
| **Group by** | Organize a long variant list | On desktop, changes how the current variants are grouped for editing. |
| Variant Price | Set the selling price for a choice | Associates the entered amount and currency with that variant. |
| **Set Sale Price** | Add a lower promotional price | Opens sale-price and optional schedule fields for the selected item or variant. |
| **Available** quantity | Set tracked stock for a variant | Updates the unsaved inventory quantity shown for that variant and Stock Location. |
| **Save** | Apply the full product configuration | Saves valid option, variant, price, and inventory changes together. |
### Video: Where variants and markets sit on a saved product
The recording opens a saved product from the catalogue list and scrolls through **Variation**, the **Variants** list beneath it, and **Markets**. The product has only its default variant, so it shows where these sections live rather than a multi-option product; it does not add an option, enter inventory, or save a change.
## Create product variants
1. Open Add Product or the intended existing product.
2. In **Variation**, select the option-add control.
3. Enter a customer-friendly option name, then add each valid option value.
4. Add another option only when the product has a second independent choice.
5. Review every generated variant. Remove accidental values before entering prices or stock.
6. Set the correct price and available quantity for each variant.
7. Select **Save**, then reopen the row and confirm the variant count.
### Example: two candle sizes
Use one option named `Size` with values `Small` and `Large`. Expect two variants. Set each variant's price and available stock, then **Save** and reopen the product.
| Options you enter | Variants to check |
| --- | --- |
| Size: Small, Large | Small; Large — 2 variants |
| Size: Small, Large plus Scent: Cedar, Citrus | Small/Cedar; Small/Citrus; Large/Cedar; Large/Citrus — 4 variants |
Only add the second option if you sell all four combinations. Confirm stock per variant rather than copying the total into every row.
## Enter inventory
1. Confirm the product is a manually stocked item and a Stock Location is saved.
2. Open the product and find **Stock**.
3. Enter the available quantity for each relevant variant.
4. Review the **Total inventory at Shop location** value.
5. Select **Save**.
6. Return to Products and confirm the Inventory column reflects the saved total.
## States and limits
- Without a saved stock location, Runner shows **Inventory not saved** and keeps the product from claiming that stock was stored.
- Option values create combinations. Adding many values across several options can produce a large variant list that must be checked individually.
- A Sale Price must be lower than the regular Price. Supplier products can enforce an additional minimum retail price.
- A product currency outside the store's saved regions produces a mismatch warning and prevents prices from displaying correctly on the storefront.
- Removing an option or value changes the customer's choices. Inspect the resulting variants before saving.
- Booking and supplier products can manage availability outside the normal Stock fields.
## Troubleshooting
- **Inventory not saved:** Add and save a Stock Location in General, then re-enter the product quantity.
- **The variant count is unexpected:** Check for duplicate or blank values and review every option combination.
- **A sale price is rejected:** Enter a value below the regular price and within any supplier minimum.
- **Prices do not appear to customers:** Align the product currency with a saved Market, then verify product and store visibility.
- **Inventory shows a dash in Products:** Check whether the item is a booking or dropshipping product; those types do not use the standard inventory total in this list.
## Related guides
- [Products](./products)
- [Shipping](./shipping)
- [Import products](./import-products)
- [Onboarding and General settings](./onboarding-and-general-settings)
---
# Onboarding and General settings
Source: https://www.runnerai.com/docs/en/guides/store-operations/onboarding-and-general-settings
Complete the guided setup when it appears, then use General to keep the store's core operating details accurate.
## Why and when to use this page
Use the setup cards the first time Runner asks for store details, a first product, and shipping. Return to General whenever your public store details, selling regions, currency, stock location, shipping setup, or review availability changes.
## Availability and prerequisites
- Open a Runner project with a store backend.
- If the backend is still being prepared, Runner shows **Please wait, the store admin is deploying...**.
- The setup assistant appears only for stores that have not completed it and can differ as Runner rolls out updated onboarding.
- Payment connection is a separate task in **Apps**. Finishing setup does not enable checkout or publish the storefront.
## Open General
**Entry path:** **Workspace → choose a store → Store Operations → General**
If Runner opens setup cards first, complete the required store details and resolve the other milestones. After setup, the General page becomes the normal destination.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
English callouts highlight the controls. Select the image to enlarge it.
This detail shows example or default fields. It does not confirm a saved Market, Stock Location, or shipping configuration.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Set up** | Open the store-details milestone | Opens the required store-details form. |
| **Add a product** | Start the first-product milestone | Opens the product setup flow. |
| **Skip product setup** / **Skip shipping setup** | Defer an optional milestone | Resolves that setup card without configuring the skipped capability. |
| **Set up shipping** | Configure the shipping milestone | Opens shipping setup. |
| **Open Store Operations** | Leave the completed setup screen | Opens normal store administration after all milestones are resolved. |
| **Visible to customers** / **Hide store — visitors see 'Opening Soon'.** | Change visibility later in General | The page-level **Save** stores the selected visible or hidden state. |
| **Add** in Markets or Stock Locations | Add another editable row | Creates an unsaved region or location row for you to complete. |
| **Product reviews** switch | Allow review functionality when supported | Saves this setting immediately. If the request fails, the switch returns to its earlier value; the page-level **Save** is not used for this switch. |
| **Save** | Apply changes across General | Becomes available after page-scoped changes, validates them when selected, and persists valid visibility, identity, market, location, and shipping edits. |
| **Configure** in a setup alert | Resolve a missing checkout prerequisite | Moves to the relevant General section, or opens the payment integrations view in **Apps**. |
Start with store details. **Save and continue** submits the required fields; **Cancel** leaves the milestone unfinished.
## Complete the three setup milestones
1. Open **Store Operations**. A new store shows **Set up store details**, **Add your first product**, and **Shipping basics** instead of the normal admin menu.
2. In **Set up store details**, select **Set up**. Complete the store name, contact, and address fields requested by **Complete your store details**, then select **Save and continue**. This required milestone cannot be skipped.
3. In **Add your first product**, select **Add a product** and complete the product flow. Choose **Skip product setup** only if you intend to add the catalog later.
4. In **Shipping basics**, select **Set up shipping** and complete the requested fields. Choose **Skip shipping setup** only if you will configure delivery later.
5. Wait for **Store setup complete**, then select **Open Store Operations**.
6. Confirm the normal admin menu is available. If you skipped products or shipping, follow the corresponding guide before expecting a sellable store.
A direct Products link does not bypass incomplete setup. If an older store shows a different assistant, follow its visible required fields and optional Skip actions; do not look for payment or Go Live inside the three-card flow above.
The recording opens the store-details form, then closes it and returns to the setup cards. It shows the entry and required fields, not completed setup, publication, or a payment connection.
## Update General settings later
1. Open **Store Operations → General**.
2. Choose the intended store visibility.
3. Review the store name, contact email, and business address.
4. Review Markets, including selling countries, currency, and tax setting.
5. Review Stock Locations before configuring shipping or inventory.
6. Review Shipping, then select **Save** and wait for the saved state for those page settings.
7. Close and reopen General to confirm the saved Market, Stock Location, and store details.
8. Change the conditional **Product reviews** switch separately if needed, and wait for its immediate update to finish.
## States and limits
- The store name is required and the setup form limits it to 30 characters.
- The contact email must be a valid email address.
- Market currency affects product-price display. A product with a currency outside the saved regions shows a warning and may not show prices on the storefront.
- **Visible to customers** controls store visibility. Publishing storefront code and connecting a domain are separate tasks.
- Enabling reviews does not add missing review components to an older storefront. Runner can show guidance to ask the agent to add the capability and publish those storefront changes.
- The page-level **Save** covers visibility, store details, Markets, Stock Locations, and Shipping. The **Product reviews** switch saves separately and immediately.
## Troubleshooting
- **Save is disabled:** Make a page-scoped change; changing only **Product reviews** does not use this button.
- **Save reports an error:** Complete the fields named by the validation message, then try once more.
- **A setup alert remains:** Complete its named prerequisite, save it, then refresh. Stock, shipping, and payment are checked separately.
- **Payment is still missing after connection:** Return from the provider tab, wait for Runner to show the integration as enabled, and refresh if needed.
- **Reviews does not appear in the menu:** The switch, backend support, or storefront capability may not be ready. See the conditional review guide before trying a direct URL.
- **The page warns about unsaved changes:** Stay and save, or explicitly choose to exit without saving. Browser navigation alone does not apply the edits.
## Related guides
- [Shipping](./shipping)
- [Products](./products)
- [Reviews](./reviews-and-advanced-admin)
- [Store Operations overview](/en/guides/store-operations)
---
# Orders
Source: https://www.runnerai.com/docs/en/guides/store-operations/orders
Use Orders to follow each purchase from placement through payment, fulfillment, shipment, delivery, refund, or cancellation.
## Why and when to use Orders
Open an order when you need to confirm what the customer bought, check addresses and totals, understand payment or fulfillment progress, or perform an available next action. The visible controls depend on the order, connected services, and earlier actions.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- Orders appear after customers place them. **No orders yet** is normal for a new store.
- Payment controls require a compatible payment state and connected provider.
- Fulfillment controls require fulfillable items and can depend on shipping or supplier services.
- Booking sections appear only on orders that include supported booking items.
- Dropshipping status, refresh, and tracking appear only when the order has linked supplier fulfillment records.
## Open Orders
**Entry path:** **Workspace → choose a store → Store Operations → Orders**
Select an order row to open its full record.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw69RBMGkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
English callouts highlight the controls. Select the image to enlarge it.
No orders yet is a normal starting state. The conditional actions below require an actual order; this example does not show a refund or fulfillment.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Search orders...** | Find a specific order | Filters the list using the entered order or customer information. |
| **Refresh** on the order list | Request current order data | Reloads the list and available booking or dropshipping status data. |
| Order row | Inspect one purchase | Opens Summary, customer, address, item, payment, fulfillment, activity, and conditional sections. |
| **Copy address** | Reuse a displayed address accurately | Copies that address to the clipboard. |
| **Capture Payment** | Capture an authorized payment | Opens a confirmation; confirming asks the connected service to capture it. |
| **Refund** (dialog: **Refund Payment**) | Return an eligible amount | Opens refund amount and optional note fields; success updates payment state. |
| **Mark as Fulfilled** | Fulfill all currently unfulfilled items | Submits the fulfillment immediately and updates the order after success. |
| **Mark as Shipped** | Record shipment progress | Requests carrier and optional tracking information, then updates fulfillment after success. |
| **Mark as Delivered** | Record delivery completion | Confirms the eligible fulfillment as delivered after success. |
| **Cancel Fulfillment** | Stop an eligible fulfillment | Opens a confirmation and updates that fulfillment if the request succeeds. |
| **Cancel Order** | Permanently cancel an eligible order | On desktop, opens an irreversible confirmation; all fulfillments must be canceled first. |
| **Refresh Status** | Check a linked dropshipping order | Requests the latest supplier status for that record. |
| **Track Order** | Open available supplier tracking | Opens tracking only when a usable tracking destination is present. |
| Booking actions | Update a supported confirmed booking | **Mark Completed** or **Mark No Show** appears only for an eligible booking state. |
### Video: Orders before the first sale
The recording opens Orders on a store that has not sold anything, so the list shows its empty state, and points at **Refresh**, which re-reads the list without changing it. It does not show a real order, a fulfilment, or any state-changing action.
## Review an order safely
1. Search for the order or select it from the list.
2. Confirm the display ID, date, customer, items, totals, shipping address, and billing address.
3. Read Payment and Fulfillment as separate states; one can progress without the other.
4. Review Activity for earlier changes.
5. If a booking or dropshipping section is present, review its separate status and details.
6. When another person or external service may have changed the order, return to the list, select **Refresh**, and reopen the record before acting.
For a new store with **No orders yet**, clear the search and select **Refresh** to confirm the empty list. You can learn list navigation without creating a purchase. The actions below are conditional on an existing order and its payment and fulfillment states.
## Perform a state-changing action
1. Choose only an action shown for the current state. **Mark as Fulfilled** applies immediately to all unfulfilled items; other actions can open a confirmation or required fields.
2. When a dialog appears, verify the order, item quantities, amount, carrier, or tracking information it shows.
3. Submit or confirm once.
4. Wait for the success message and updated state.
5. Refresh before retrying. A timeout or loading indicator is not proof that the first request failed.
## Understand common states
| Area | Example states | How to read them |
| --- | --- | --- |
| Payment | Awaiting payment, Authorized, Paid, Partially paid, Refunded, Partially refunded, Canceled, Requires action | Describes money movement, not shipment progress. |
| Fulfillment | Not fulfilled, Partially fulfilled, Fulfilled, Shipped, Partially shipped, Delivered, Partially delivered, Canceled | Describes preparation and delivery, not whether payment settled. |
| Booking | Confirmed, Completed, No Show, Canceled | Appears only for supported booking items. |
| Dropshipping | Pending creation, Created, Processing, Shipped, Delivered, Failed, Canceled, or other supplier states | Comes from a linked supplier record and may update separately from the store order. |
## Limits and troubleshooting
- **An action is missing:** The order state, item type, provider, or your access does not currently allow it. Do not use a direct URL to bypass the missing control.
- **Cancel Order is unavailable:** This control is desktop-only and requires every fulfillment to be canceled first.
- **An item refund is unavailable:** Use only the refund method Runner exposes for the current order; do not assume every item supports direct refund.
- **A shopper canceled a booking:** When the booking's cancellation policy allows it, the store refunds the policy's percentage of the booking price from a captured payment. If the payment is still only authorized and the whole amount is owed back, the order and its authorization are canceled. If the payment is still only authorized and only part is owed back, the store captures its share and releases the rest of the hold, so the shopper is charged only what the policy keeps. A rescheduled booking shows only its new time.
- **Status did not change:** Wait for the confirmation, return to the order list, select **Refresh**, reopen the record, and check Activity before retrying.
- **Dropshipping says Failed or has no order:** Review the linked supplier details and connection before changing the store order.
- **Order not found:** Clear the search, verify the project, and check the order identifier.
## Related guides
- [Customers](./customers)
- [Shipping](./shipping)
- [Dropshipping](./dropshipping)
- [Store Operations overview](/en/guides/store-operations)
---
# Print on demand with Printful
Source: https://www.runnerai.com/docs/en/guides/store-operations/print-on-demand
Use Print on demand to sell custom products, such as t-shirts, hoodies, mugs, and posters, without holding stock. You design on a Printful blank product in Runner, publish it to your store, and Printful prints and ships each order after you confirm it in Printful.
## How it works
1. **Connect Printful.** Authorize your own Printful account once for your organization.
2. **Choose a blank and design it.** Pick a product, colors, sizes, and printing technique, then add artwork.
3. **Review and publish.** Choose mockups, write the listing, set prices, markets, and shipping, then publish.
4. **Fulfill orders.** Each paid order creates a draft order in Printful. You confirm the draft in Printful to start production.
If you later need to stop using Printful, see [Disconnect Printful](#disconnect-printful).
## Before you start
**Entry path:** **Workspace → choose a store → Print on demand**
**Print on demand** appears in the **Sell** group of the project navigation, next to **Store Operations** and **Dropshipping**. If you do not see it, the feature is not yet enabled for your account. Contact [Runner support](/en/guides/help-and-reference/support-and-community) to request access.
You need:
- a Runner project with a store;
- a [Printful](https://www.printful.com) account with billing set up, because Printful charges your Printful account for each order you confirm;
- the **Admin** or **Owner** role in the Runner organization to connect or disconnect Printful;
- at least one store market and currency under **Store Operations → General**; and
- a stock location and shipping setup before you publish. See [Shipping](/en/guides/store-operations/shipping).
## 1. Connect Printful
You can browse the catalog before connecting. The page shows **Preview mode** until Printful is connected. You must connect Printful before you can design, save, or publish.
1. Open **Print on demand**.
2. Select **Connect Printful**. You can also open a blank and select **Connect your own Printful**.
3. Sign in to Printful if asked, and review the permissions Runner requests.
4. In Printful's store selector, choose the store you want Runner to use. The selector defaults to **Create a new Printful store**; change it if you want to use an existing store.
5. Approve access. Printful returns you to **Print on demand**, and the page shows **Connected**.
The connection belongs to your Runner **organization**, so every store in that organization uses the same Printful store. An organization can have one Printful connection, and a Printful store can be connected to only one Runner organization.
To check which Printful store is connected, open the **Manage store** menu and choose **Manage connection**. The dialog shows the connected store name and Printful store ID.
### Reconnect Printful
If Printful stops accepting Runner's authorization, Runner shows **Reconnect Printful to keep orders flowing**. This usually means the store was deleted in Printful or the Runner app was uninstalled from it. Select **Reconnect Printful** and choose **the same Printful store** in Printful's store selector. Runner rejects a reconnection that picks a different store while the connection is still active.
## 2. Choose a blank and start designing
### Pick a blank
1. Browse **All blanks**, filter by **Product types**, or search by product, brand, print method, or SKU.
2. Open a product to see its images, available colors, sizes, print placements, techniques, base cost, estimated shipping, and delivery estimate for your markets.
3. Choose a **Technique**: **Printing** or **Embroidery**, when both are offered. Under **Printing**, choose the **Printing type** that Printful offers for that product, such as DTG, DTF, sublimation, or all-over print.
4. Choose one or more **colors** and **sizes**. You can select up to **20 variants** (color and size combinations) for one product.
5. Use the **Markup** slider to preview retail price and profit. The price starts at the suggested price, a 35% margin over the break-even: Printful's base cost plus the estimated shipping. Profit is the price minus both, and it shows once the shipping estimate arrives. You can change prices again during review.
6. Select **Start designing**. The designer opens with your chosen options.
If Runner changes your selection, for example "Size changed to match this color", Printful does not offer that exact combination. Review the adjusted options before continuing.
### Add your design
Each print placement, such as front, back, or sleeve, has its own tab in the designer. Add artwork to any placement you want printed.
| Design source | What it does |
| --- | --- |
| **Upload a file** | Upload JPEG, PNG, WebP, or SVG files up to 18 MB. SVG files are converted to PNG. 300 DPI is recommended. |
| **From media gallery** | Reuse images you already created or uploaded in Runner. |
| **Design with Runner AI** | Describe your idea. **Create image** makes new artwork; **Edit current artwork** changes the artwork already on the product. |
| **Inspirations → Text** | Pick a lettering style, such as Bold varsity, Classic serif, or Light script. Runner AI turns your words into print-ready text artwork. |
| **Inspirations → Labels & badges** | Pick a shape, such as a circle badge, shield crest, or ticket tag. Runner AI creates the badge with your text. |
| **Inspirations → Arts** | Place a curated, free-to-use (CC0) artwork from the Art Institute of Chicago directly on your product. |
Select an artwork layer to edit it in the inspector:
- move, resize, rotate, and change opacity;
- **Crop** the artwork without changing the original image;
- **Remove background** so only your design prints;
- **Repeat pattern** in a block, brick, or half-drop layout with adjustable spacing and offset;
- **Duplicate**, **Lock**, and reorder layers; and
- **Undo** and **Redo** changes.
### Check print quality
Before you save, check the quality indicators for each layer:
- **Print quality** compares the artwork's resolution at its current size with the DPI Printful requires. If it says the artwork will print blurry, make it smaller or upload a sharper file.
- **Print area** and **safe area** warnings mean part of the artwork may be cut off or trimmed. Move or resize it until the artwork is inside both.
### Save your design
The designer does not save automatically. Select **Save design** when you finish. The status shows **Unsaved changes** until you save. If you leave with unsaved changes, Runner asks whether to save or discard them.
Saved designs appear under **Saved designs** on the Print on demand page. Open one to keep editing or to turn it into a product. Deleting a saved design does not delete images from your media library.
## 3. Review and publish the product
When your design is ready, select **Publish** in the designer. Runner saves the design and opens **Get it ready to sell**.
### Configure the product
| Section | What to do |
| --- | --- |
| **Product mockups** | Select **Generate mockups** to create photos of your design on the product. Select at least one mockup and up to eight. Drag to reorder them; the first image is your listing image. |
| **Details** | Review the **Product title** and **Product description** that Runner drafted. Use **Brainstorm with AI** for a new description, then check every word. |
| **Markets** | Select **Choose markets** to pick the countries and currencies where you sell this product. Only markets Printful can ship to are listed. Choose at least one market. |
| **Pricing** | Each variant starts at the suggested price, a 35% margin over its break-even: Printful's base cost plus the shipping you pay. Use **Markup** to set a different markup on the break-even, or enter a price for each variant. Earnings are the price minus Printful's base cost minus the shipping you pay, and a price below the break-even shows as a loss. For each market, the table shows retail price, shipping, tax, and the estimated earnings of the variant that earns the least. |
| **Customer shipping charges** | Choose **Use store shipping rates** so shoppers pay your store's shipping rates, or **Charge Printful shipping rates** so shoppers pay Printful's quoted rate for their address at checkout. |
The shipping estimate on this page is a pricing reference: Printful's cheapest standard rate, not express or priority. Printful's actual shipping cost depends on each customer's delivery address. With **Use store shipping rates**, shoppers pay your store's rates and Printful bills you for shipping, so the estimate counts toward the break-even, the suggested price, and your earnings. With **Charge Printful shipping rates**, shoppers pay Printful's rate at checkout, so only Printful's base cost counts.
This product is fulfilled by Printful, so Printful's return policy applies. Review it from the link on the review page.
### Create the draft
1. Select **Create product**.
2. Wait while Runner prepares production files and creates the product. You can check the status anytime.
3. When you see **Your product is now a draft in your store**, select **View product**.
The product is now a **Draft** in **Products**. Shoppers cannot see it yet. You can edit its URL and search engine listing in Products.
### Publish
1. Open the draft product in **Products**.
2. Check **Shipping at checkout** and make sure a shipping mode is selected.
3. Select **Publish product**.
4. Wait for **Synced with Printful.** The product is now live in your store and synced to your Printful store.
To publish, the store needs an active Printful connection, a stock location, a shipping option, and a shipping mode for the product. If one is missing, Runner shows what to fix before you try again.
After a design becomes a product, it is locked to that product. If you edit it again, Runner makes a copy, and saving the copy does not change the existing product.
## 4. Fulfill orders
Runner does **not** send orders to production automatically. Each paid order creates a **draft order** in your Printful store, and you confirm it in Printful to start production.
1. A shopper pays for an order that contains a print-on-demand product.
2. Runner creates a matching draft order in your Printful store. This is automatic for orders with captured payment.
3. Open **Store Operations → Orders** and select the order. The **Printful fulfillment** section shows the draft status and the Printful production cost once Printful has calculated it.
4. When the status is **Draft ready**, select **Place order in Printful**. Printful opens the order in a new tab.
5. Review the order in Printful and confirm it. Printful charges your Printful account and starts production.
6. Return to the order in Runner and select **Refresh status**. Runner also updates the status automatically when Printful sends updates.
| Status | Meaning |
| --- | --- |
| **Preparing draft** | Runner is creating the draft in Printful. |
| **Draft ready** | The draft is in Printful and waiting for you to confirm it there. |
| **Submitted** / **In production** | You confirmed the order, and Printful is producing it. |
| **Partially fulfilled** / **Fulfilled** | Printful shipped some or all items. |
| **Action required** | Printful needs an update before it can continue. Open the order in Printful. |
| **Needs attention** | Runner could not confirm the fulfillment state. Refresh the status, or contact support. |
| **Canceled** / **Deleted** | The Printful order was canceled, or the draft was deleted. |
Keep these rules in mind:
- **Confirm only orders you intend to fulfill.** Confirming in Printful is irreversible production and charges your Printful account.
- **Refunds and cancellations do not change the Printful draft.** If you refund or cancel a customer order, delete or cancel the draft in Printful yourself, and do not confirm it.
- **Deleting a Printful draft does not cancel or refund the customer order.** Handle the customer order separately in Runner.
- If Runner shows **Retry draft**, Printful did not create the draft and it is safe to retry.
- If Runner says Printful created the order but Runner couldn't read it back, **don't resubmit**. Runner reconciles it automatically, so check back later.
## Disconnect Printful
Disconnecting stops Runner from using your Printful store immediately. **Finish or close every ongoing order before you disconnect.** Orders that are not complete are taken offline in Runner and are not retried, even if you connect another Printful store later.
### Before you disconnect
1. In **Store Operations → Orders**, find every order with a **Printful fulfillment** section that is not **Fulfilled**, **Canceled**, or **Deleted**.
2. For each **Draft ready** order, either confirm it in Printful or cancel and refund the customer order in Runner and delete the Printful draft.
3. Wait until confirmed orders show **Fulfilled**, or keep tracking them directly in Printful.
4. Unpublish or remove print-on-demand products you no longer want shoppers to see.
### Disconnect
1. Open **Print on demand**.
2. Open the **Manage store** menu and choose **Manage connection**.
3. Select **Disconnect**.
4. Read the impact, then select **Disconnect Printful**.
After you disconnect:
- your print-on-demand products and drafts stay visible in **Products**, but shoppers cannot add them to a cart or check out;
- those products show **This POD product is unavailable** and can't be sold or edited through Printful;
- ongoing Printful fulfillments are taken offline in Runner; and
- your Printful store and its orders remain in your Printful account.
**Reconnecting does not restore products.** If you connect Printful again later, products from the earlier connection stay unavailable. Create new products from your saved designs.
## Limits
| Item | Limit |
| --- | --- |
| Variants per product | 1–20 color and size combinations |
| Listing images per product | Up to 8 mockups |
| Markets per product | Up to 51 |
| Markup | 0–500% |
| Product title | Up to 255 characters |
| Upload file size | 18 MB (JPEG, PNG, WebP, or SVG) |
| Printful connections | One per organization |
Your plan can also limit how many products you can create. If you reach the limit, Runner shows **You've reached your plan's print-on-demand product limit**.
## Troubleshooting
- **Print on demand is missing from the navigation:** the feature is not enabled for your account. Contact support.
- **Connect Printful fails or you are not allowed to connect:** ask an organization Admin or Owner to connect Printful.
- **Printful event delivery is awaiting Runner setup:** Runner must finish a one-time configuration. You do not need to change anything in your store.
- **A mockup, price, or shipping estimate does not load:** retry from the same page. Your saved design is not affected.
For exact error messages and recovery steps, see:
- [Printful connection and catalog](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog)
- [Printful design conflicts and unavailable artwork](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork)
- [Printful product review, mockups, and publication](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication)
- [Orders and fulfillment errors](/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment)
## Related guides
- [Store Operations](/en/guides/store-operations)
- [Products](/en/guides/store-operations/products)
- [Orders](/en/guides/store-operations/orders)
- [Shipping](/en/guides/store-operations/shipping)
- [Dropshipping](/en/guides/store-operations/dropshipping)
---
# Products
Source: https://www.runnerai.com/docs/en/guides/store-operations/products
Use Products to turn an item into a complete store listing with customer-facing information, prices, media, and status.
## Why and when to use Products
Create a product when you want to sell an item directly, then return to adjust its name, description, category, images, prices, variants, inventory, search listing, or Draft/Published status.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- Open a Runner project with a ready store backend.
- Save at least one Market so product currency can match a selling region.
- Save a Stock Location before expecting inventory changes to be stored.
- **Import** appears in the populated desktop list; a new empty catalog starts with **Add First Product**.
- Dropshipping products can show different cost and inventory behavior from manually managed products.
## Open Products
**Entry path:** **Workspace → choose a store → Store Operations → Products**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
English callouts highlight the controls. Select the image to enlarge it.
Draft rows show catalog records available for editing. They do not prove the items are published or purchasable.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Refresh** | Reload current catalog data | Refetches products and market information; it does not create or publish anything. |
| **Add** / **Add First Product** | Create a manual product | Opens a blank Add Product form. |
| **Import** | Add products from a supported CSV | Opens the import dialog with Template and History. |
| Product row | Review or change an item | Opens Edit Product for that product. |
| Pencil icon | Edit a product without selecting its row | Opens the same Edit Product form. |
| Delete icon | Remove a product | Opens a destructive confirmation; confirming removes the product and cannot be assumed reversible. |
| **Draft** | Keep the listing out of the published catalog | Saves the product with Draft status. |
| **Published** | Make the listing eligible to appear in the catalog | Saves Published status; actual storefront visibility still depends on the store and storefront state. |
| **Save** | Store valid product changes | Saves the product and returns to the refreshed list after success. |
| **Cancel** or back control | Leave the form | Returns toward the list; unsaved form changes are not applied. |
## Create a product
1. Select **Add** or **Add First Product**.
2. Choose a Product Category and enter a clear Name and Description.
3. Add images and choose the intended thumbnail.
4. Choose **Draft** while preparing the listing or **Published** when it is ready for the catalog.
5. Enter the regular Price. Add a lower Sale Price and valid start/end dates only when you want a scheduled sale.
6. Configure [variants and inventory](./inventory-and-variants) if the item has options or tracked stock.
7. Review the SEO page title, meta description, handle, and displayed store URL.
8. Select **Save** and wait until the Products list returns with the updated row.
### Video: Add the first product to an empty catalog
The recording uses the **Add your first product** setup card on a new store, which saves into Store Operations → Products. It shows the short first-product panel with Name, Price, and Description, not the full Add Product form described above, and it completes one setup milestone. It does not publish the store or connect a payment provider.
### Practice with one draft
For a manual candle listing, enter a clear name such as `Cedar Candle`, add the actual product description, and keep **Draft** selected. Use a price in the store's saved Market currency. If Runner asks for a product type first, choose the manual product path before entering these details.
After **Save**, reopen the row and compare its name, price, and Draft status with your input. This checks the catalog save; publication and a working checkout need separate checks.
## Edit or remove a product
1. Select the product row or its pencil icon. **Edit Product** shows the existing Product Type as read-only.
2. Change only the fields that should affect the listing.
3. Select **Save** and confirm the row reflects the new status or information.
4. To remove the product, return to the list and select its delete icon.
5. Read the product name in the confirmation. Continue only if permanent removal is intended.
## States and limits
- **Draft** and **Live** badges in the list summarize product status. The form uses **Draft** and **Published**.
- A currency mismatch warning means the product's currency is outside the store's saved regions; its prices will not display on the storefront until corrected.
- Sale Price must be lower than the regular Price. Supplier items can also enforce a minimum retail price.
- Images accept only the formats and size shown by the form. Failed compression or upload leaves the product image unchanged.
- Booking and dropshipping rows can show a dash instead of normal inventory or variant totals.
- Saving Published status is not the same as publishing or deploying the storefront.
## Troubleshooting
- **Inventory not saved:** Add and save a Stock Location, then reopen the product and enter stock again.
- **Price does not display:** Make the product currency match a saved Market region.
- **Save stays disabled or fails:** Make a change, then complete the required Name and status and fix any inline error. Add a suitable category and price before expecting a complete customer-facing listing, but they are not prerequisites for enabling **Save**.
- **Image upload fails:** Use JPEG, PNG, GIF, or WebP within the size shown in the image hint, then retry.
- **Product is missing from the storefront:** Check Published status, store visibility, storefront publication, and the relevant market. A saved admin row alone is not proof of customer visibility.
## Related guides
- [Import products](./import-products)
- [Inventory and variants](./inventory-and-variants)
- [Dropshipping](./dropshipping)
- [Onboarding and General settings](./onboarding-and-general-settings)
---
# Promotions
Source: https://www.runnerai.com/docs/en/guides/store-operations/promotions
Use Promotions to define a discount, its customer experience, its eligibility rules, and whether it is active or still a draft.
## Why and when to use Promotions
Create a promotion for a planned campaign, customer incentive, free-shipping offer, or buy-and-get offer. Start in Draft while checking the details; use Active only when the discount should be eligible at checkout.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- Open a Runner project with a ready store backend.
- Create the products referenced by a Buy X Get Y rule before building that promotion.
- Confirm the relevant market currency and shipping setup before offering amount-based or free-shipping discounts.
- Test checkout behavior with an appropriate test order before sharing a code publicly.
## Open Promotions
**Entry path:** **Workspace → choose a store → Store Operations → Promotions**
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Create** / **Add First Promotion** | Choose a new discount type | Opens a menu for Amount off order, Percentage off order, Buy X Get Y, or Free shipping. The empty list uses **Add First Promotion**. |
| **Amount off order** | Discount the order total by a fixed amount | Opens a form with amount, method, status, and eligibility settings. |
| **Percentage off order** | Discount the order total by a percentage | Opens a form with a percentage value and the shared settings. |
| **Buy X Get Y** | Give selected products after a qualifying purchase | Opens quantity and product selectors for what the customer buys and gets. |
| **Free shipping** | Remove eligible shipping fees | Opens a promotion whose discount applies to shipping. |
| **Automatic discount** | Apply the promotion without asking the customer for a code | Checkout evaluates the rules automatically, but the form still requires a code value to identify the promotion. |
| **Discount code** | Require a customer-entered code | Customers must enter the required code at checkout. |
| **Active** / **Draft** | Control whether the promotion is usable | Saves the chosen operating state with the promotion. |
| **Add condition** | Limit who can use the promotion | Adds customer attribute, operator, and value fields. |
| **Save** | Apply a valid create or edit form | Creates or updates the promotion and returns to the promotion list after success. |
| Promotion row | Inspect one promotion | Opens type, method, status, code, usage, and available actions. |
| **Edit** | Change the selected promotion | Opens the edit form for that existing promotion type. |
| **Delete** | Permanently remove the promotion | From the desktop list, opens an irreversible confirmation naming the promotion code. The current mobile view does not show this action. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBOjWz1xmaXn1xqodiYlA9g46Lh3VyHFBkOze)
English callouts highlight the controls. Select the image to enlarge it.
This detail shows Draft status, code versus automatic discount, value, and eligibility. Saving and activation are not shown.
### Video: Promotions on a store with none
The recording opens Promotions on a store that has none and points at **Create Discount**. It shows the empty state and the entry point; it does not build a promotion or apply one at checkout.
## Create a promotion
1. Select **Create**, or **Add First Promotion** when the list is empty.
2. Choose the type that matches the offer.
3. Choose **Automatic discount** or **Discount code**.
4. Enter the required code value. For **Discount code**, enter the exact code customers should use; for **Automatic discount**, customers do not enter it.
5. Choose **Draft** while preparing or **Active** when it should be eligible.
6. Enter the Discount value, or select the Buy and Get products and quantities.
7. Leave eligibility as all customers or select **Add condition** and complete every condition field.
8. Review the summary, then select **Save**.
9. Return to the list and confirm the Type, Method, Status, Code, and Used values.
### Example: prepare a 10% code
Choose **Percentage off order**, **Discount code**, code `WELCOME10`, **Draft**, and value `10`. Review eligibility before saving. If you are only learning the form, leave without saving; an unsaved form creates no promotion.
After saving an intended draft, reopen its row and check Code, Method, and Draft status. Keep it Draft until you have separately checked the intended checkout behavior. An automatic discount also needs an internal code, but customers do not type that code.
## Edit or remove a promotion
1. Select a promotion row.
2. Choose **Edit**, change the intended fields, and select **Save**.
3. Test the updated rule before sharing it with customers.
4. To remove it, return to the desktop list, select **Delete**, and read the code in the confirmation.
5. Continue only if permanent removal is intended.
## States and limits
- **Draft** is stored but not intended to be usable at checkout.
- **Active** is eligible to apply when its method and conditions match.
- **Inactive** can appear in the list when an existing promotion is not currently active.
- A percentage value must be between 1 and 100.
- The form requires a code value for both methods. Customers enter it only when **Discount code** is selected.
- Buy X Get Y requires both the qualifying product and the free product.
- Every added condition needs an attribute, operator, and value.
- With an automatic discount, checkout decides whether its rules match; the customer does not enter the form's code value.
## Troubleshooting
- **Save is disabled or shows an error:** Complete the value, code, product, quantity, or condition fields named by the form.
- **A code does not work at checkout:** Confirm exact spelling, Active status, customer eligibility, product requirements, market, and the current checkout.
- **An automatic discount does not apply:** Check that the order meets every condition and that another promotion is not changing the expected result.
- **A free-shipping promotion has no visible effect:** Confirm the order has an eligible saved shipping option and that the promotion is Active.
- **Promotion list fails to load:** Refresh the page and confirm the correct project before trying to create a duplicate.
## Related guides
- [Products](./products)
- [Customers](./customers)
- [Shipping](./shipping)
- [Orders](./orders)
---
# Reviews
Source: https://www.runnerai.com/docs/en/guides/store-operations/reviews-and-advanced-admin
Use Reviews to moderate customer feedback when the capability is enabled.
## Why and when to use Reviews
Enable Reviews when your storefront is ready to collect product feedback and someone will moderate submissions.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
### Reviews
- Open **Store Operations → General** and look for **Product reviews**.
- The Reviews entry and its available controls depend on store support and the current layout. If it is missing or blocked, inspect Product reviews in General rather than forcing a direct route.
- An older storefront can lack review components even after the switch is enabled. When Runner shows the capability hint, ask the agent to add product review capability and publish the resulting storefront changes.
- Reviews appear only after customers submit them through a supported storefront.
## Entry path
**Reviews entry path:** **Workspace → choose a store → Store Operations → General → Product reviews**, turn on the switch, then select **Store Operations → Reviews** when that menu item appears.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglTicdyefCuYB97EiQHRN3LVKtUonPdvTgIM4)
English callouts highlight the controls. Select the image to enlarge it.
The annotated crop highlights the moderation filters. Open General to manage collection settings; no review was approved in this example.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Product reviews** switch | Request review collection for the store | Saves the setting immediately. If the request fails, the switch returns to its earlier value; no page-level **Save** is needed for this switch. |
| **All** | Review every loaded moderation state | Clears the status filter. |
| **Approved** | Review accepted submissions | Filters the list to Approved. |
| **Rejected** | Review declined submissions | Filters the list to Rejected. |
| **Pending** | Find reviews awaiting a decision | Filters the list to Pending. |
| Row checkbox | Select reviews for a bulk decision | Adds or removes that review from the current selection. |
| **Approve** | Accept one review | Updates its status to Approved after success. |
| **Reject** | Decline one review | Updates its status to Rejected after success. |
| **Approve selected** | Accept all checked reviews | Applies Approved to the current selection after success. |
| **Reject selected** | Decline all checked reviews | Applies Rejected to the current selection after success. |
### Video: The Reviews tab before any review arrives
The recording opens Reviews on a store with none and points at the **Pending** filter, where a new submission waits until it is approved. It shows the empty state and the moderation filters only; it does not approve, reject, or publish a review.
## Enable reviews and moderate existing submissions
1. Open **Store Operations → General**.
2. Turn on **Product reviews**.
3. Wait for the setting to finish saving. If the switch returns to off, the request failed; retry after checking store readiness.
4. If Runner says the storefront lacks review components, ask the Runner agent to add product review capability, review the storefront change, and publish it.
5. Return to Store Operations and open **Reviews** after the menu appears.
6. Select **Pending**.
7. Read the product, reviewer, rating, content, and date for each submission.
8. Select **Approve** or **Reject**, or check several rows and use the matching selected action.
9. Wait for the success message and verify the Status column.
## States and limits
- **Pending** needs a moderation decision; **Approved** and **Rejected** record the current decision.
- **No reviews yet** is valid until supported customer submissions exist.
- Turning on the setting does not manufacture reviews or prove the storefront contains a review form.
## Troubleshooting
- **Reviews menu is missing:** Confirm the switch in General, backend readiness, and the storefront capability hint. Refresh after the setting is confirmed.
- **Customers cannot leave reviews:** Verify the storefront includes the review components and that those storefront changes were published.
- **A moderation action fails:** Keep the review selected, refresh once, and retry only after checking its current status.
## Related guides
- [Onboarding and General settings](./onboarding-and-general-settings)
- [Products](./products)
- [Orders](./orders)
- [Store Operations overview](/en/guides/store-operations)
---
# Shipping
Source: https://www.runnerai.com/docs/en/guides/store-operations/shipping
Configure where orders ship from, where customers can receive them, and how the checkout calculates shipping charges.
## Why and when to use shipping settings
Set up shipping before testing checkout or making a physical product available to customers. Return when you add a fulfillment location, sell to a new country, or change the amount customers pay for delivery.
## Availability and prerequisites
If setup cards appear instead of the admin menu, [complete store setup](/en/guides/store-operations/onboarding-and-general-settings) first, then select **Open Store Operations**.
- Create and save a Stock Location first.
- Keep at least one saved Market region. When a default region exists, Runner can add a newly selected shipping destination to it when you save; without a default region, saving fails.
- The shipping choices shown here are store rules. Carrier- or app-specific services can require a separate connection in **Apps**.
- Digital, booking, supplier, or other special product flows can follow different fulfillment rules.
## Open Shipping
**Entry path:** **Workspace → choose a store → Store Operations → General → Shipping**
If Runner shows a shipping setup alert, select **Configure**. It moves you to the Shipping section on General. Shipping is not a permanent item in the Store Operations sidebar.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
English callouts highlight the controls. Select the image to enlarge it.
Use the saved Market and Stock Location before adding a shipping option. This example field view does not show a completed save or checkout rate.
## Main controls
| Control | Why you use it | What happens when selected |
| --- | --- | --- |
| **Add** | Create a shipping option | Adds an unsaved **Free Shipping** row with an empty **Ship to** destination and a free shipping cost. |
| **Name** | Give customers a recognizable delivery choice | Sets the label used for the shipping option. |
| **Ship to** | Choose the customer destination country | Limits the option to that destination. |
| **Shipping cost** | Define how checkout calculates the charge | Opens the Shipping dialog for **Flat rate** or **Rate by price**. |
| **Flat rate** | Charge one amount | Shows a single shipping-price field. |
| **Rate by price** | Vary shipping by cart item total | Shows minimum, maximum, and shipping-price rows. |
| **Add** in the rate dialog | Add another price band | Adds an unsaved cart-total range. |
| **Save** in the rate dialog | Accept the rate draft | Closes the dialog and returns the configured rate to the General page. |
| **Cancel** in the rate dialog | Discard dialog edits | Closes the dialog without applying those rate edits. |
| **Save** on General | Persist the shipping option | Saves the completed shipping and related General changes to the store. |
### Video: Where shipping settings sit on the General page
The recording scrolls Store Operations → General from store visibility, through the market and stock location, to the shipping rates already saved on this store, and ends on **Save**. It shows where the rates live and that edits take effect only when saved; it does not add a rate or prove what checkout charges.
## Add a flat-rate or free option
1. In General, confirm that a Market region and Stock Location are saved.
2. Scroll to Shipping and select **Add**.
3. Enter a clear Name, such as the delivery speed or method customers will recognize.
4. Choose **Ship to**. Shipping options use the Stock Location saved in General; there is no separate **Ship from** selector in each row.
5. Open **Shipping cost**.
6. Choose **Flat rate** and enter a shipping price. Enter `0` when delivery should display as **Free**.
7. Select **Save** in the dialog.
8. Select the page-level **Save** and wait for the saved state.
**Example:** name an option `Standard shipping`, choose a destination in your saved Market, and set **Flat rate** to `0` for free delivery. Select dialog **Save**, then General **Save**. Reopen General and check the destination and saved rate. The first Save only closes the rate editor; it does not persist the shipping settings. Carrier service and the amount shown at checkout require a separate check.
## Add price-based rates
1. Open **Shipping cost** for the intended option.
2. Choose **Rate by price**.
3. Enter a minimum or maximum cart item total and the shipping price for that range.
4. Select **Add** for each additional range.
5. Make sure the ranges do not overlap and every row has a shipping price.
6. Select **Save** in the dialog, then **Save** on General.
## States and limits
- Each price range needs at least a minimum or maximum cart item total.
- Overlapping price ranges are rejected.
- A shipping price is required for flat and price-based methods.
- A destination without a saved region shows **No region configured for this country**.
- When a default Market region exists, saving can add the selected destination country to that region automatically.
- Dialog **Save** prepares the option on the page; use the General page's **Save** to persist the full settings change.
## Troubleshooting
- **Please add a stock location first:** Add and save one in General, then return to Shipping.
- **No default region is available:** Create and save a Market region, then retry the General page **Save**.
- **Please save the stock location first:** Use the General page **Save**, then reopen the shipping row.
- **Overlapping price ranges detected:** Adjust the minimum and maximum values so each cart total matches only one row.
- **Shipping is missing at checkout:** Confirm the destination matches a saved market, the shipping row is saved, the product requires shipping, and any connected service is ready.
## Related guides
- [Onboarding and General settings](./onboarding-and-general-settings)
- [Inventory and variants](./inventory-and-variants)
- [Orders](./orders)
- [Store Operations overview](/en/guides/store-operations)
---
# Storefront and publishing
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing
Use this section to move a storefront from an in-app preview to a verified live store. Each page covers one task and explains what every important control does.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
Start by reviewing the current preview, then follow the guide for the change or launch step you need.
## What this covers
Choose the guide that matches your current storefront task, without confusing an editable preview with a live, purchasable store.
## Understand the four storefront states
| State | What it means | What it does not prove |
| --- | --- | --- |
| **Preview** | Runner is showing a working copy inside your project. You can review pages and layouts. | The store is not necessarily public. |
| **Publish** | Runner checks and sends the current version to a public store URL for the first time. | Products, stock, shipping, payments, and checkout are not automatically verified. |
| **Publish Changes** | A live store already exists and Runner can send newer changes to it. | Unsaved or unfinished changes are not live yet. |
| **Republish** | Runner can retry after a failed publication or a completed publication that did not return a usable URL. | It is not the normal label for publishing new changes to a healthy live store. |
## Choose a task
| What you want to do | Guide | Result |
| --- | --- | --- |
| Review the current storefront | [Preview your store](/en/guides/storefront-and-publishing/preview-your-store) | Check pages, routes, refresh behavior, and responsive layouts. |
| Make visual changes | [Use Design Mode](/en/guides/storefront-and-publishing/design-mode) | Select an element and open the editing controls. |
| Change copy, spacing, type, or images | [Edit content, pages, and media](/en/guides/storefront-and-publishing/edit-content-pages-and-media) | Update one visible page and save the result. |
| Inspect or change a storefront file | [Inspect and edit storefront code](/en/guides/storefront-and-publishing/inspect-and-edit-code) | Open the conditional code editor, save a focused file change, and review its Git state. |
| Compare or recover an earlier state | [Use version history](/en/guides/storefront-and-publishing/version-history) | Preview a version or restore it as a new current version. |
| Check whether the store is ready | [Prepare to publish](/en/guides/storefront-and-publishing/prepare-to-publish) | Resolve or explicitly acknowledge the checks shown by Runner. |
| Put changes online | [Publish and republish](/en/guides/storefront-and-publishing/publish-and-republish) | Start the correct publication flow for the current state. |
| Prove the customer journey works | [Verify the live store and checkout](/en/guides/storefront-and-publishing/live-store-and-checkout) | Confirm the public catalog, cart, and checkout separately. |
| Use your own web address | [Connect a custom domain](/en/guides/storefront-and-publishing/custom-domains) | Add, buy, transfer, renew, or diagnose an eligible domain. |
| Recover from a blocked state | [Troubleshoot preview and publishing](/en/guides/storefront-and-publishing/troubleshoot-preview-and-publishing) | Match the message on screen to the safest next action. |
## Recommended order for a first launch
1. Review the latest version in [Preview](/en/guides/storefront-and-publishing/preview-your-store).
2. Make and save any visual edits in [Design Mode](/en/guides/storefront-and-publishing/design-mode).
3. Check the [publication prerequisites](/en/guides/storefront-and-publishing/prepare-to-publish).
4. Select **Publish** and follow the confirmation flow.
5. Open the public URL and [verify the catalog and checkout](/en/guides/storefront-and-publishing/live-store-and-checkout).
6. Add a [custom domain](/en/guides/storefront-and-publishing/custom-domains) only after the first successful publication.
## Availability and safety
- **Design Mode** is conditional. It is intended for a ready latest version on a desktop layout and may be unavailable while Runner is working.
- **Open code editor** is conditional. Saving, committing, pushing, publishing, and verifying the live store are separate results.
- Publishing can be gated by plan or store state. Follow the message shown in your workspace rather than assuming every account has the same access.
- A publish confirmation can let you acknowledge incomplete setup. That choice can put a browseable storefront online while checkout remains paused or incomplete.
## Related guides
- [Welcome to Runner AI](/en/guides/product-guide)
- [Inspect and edit storefront code](/en/guides/storefront-and-publishing/inspect-and-edit-code)
- [Troubleshoot preview and publishing](/en/guides/storefront-and-publishing/troubleshoot-preview-and-publishing)
---
# Connect a custom domain
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/custom-domains
**Entry path:** Sidebar **Settings** → **Store: _store name_** → **Domain**. On desktop, the **Storefront** published-site menu can also offer **Domain Settings**.
## What this covers
Open Domain Settings for a published store, choose the correct domain workflow, and understand what each high-impact action changes before continuing.
## Why and when to use a custom domain
A custom domain gives customers a branded address for the published store. Connect one after the first successful publication and after the store works at its existing public URL. This isolates domain problems from storefront, catalog, and checkout problems.
## Availability and prerequisites
- **Custom domain** access is plan-dependent.
- The store must have a successful publication before domain controls become available.
- You need access to the project's settings.
- Adding a domain you already own requires permission to change its DNS records at your DNS provider.
- Buying or renewing a domain starts an external payment flow.
- Transferring a domain between stores in the same workspace is limited to workspace owners and admins.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgj47Uwq6IQ3D84warl6z9RO5sLdoxCUgTn1v2)
English callouts highlight the controls. Select the image to enlarge it.
An unpublished store shows this prerequisite. Publish and verify its public URL before following the DNS connection steps below.
## Open Domain Settings
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
After publication, open the dropdown beside **Publish Changes**: 1. Published-site menu. 2. **View Site** opens the live store; **Copy URL** copies its address. 3. **Domain Settings** opens address management. This image does not verify checkout. Select the image to enlarge it. The annotations use the English desktop interface.
1. Confirm the current store name.
2. Open sidebar **Settings**.
3. Under **Store: _store name_**, select **Domain**.
4. If the page asks you to publish first, complete and verify the first publication before adding a domain.
## Domain controls
| Control | Why you use it | What happens when you select it |
| --- | --- | --- |
| **How to connect custom domain?** | Open the current connection help. | The help page opens in a new tab. |
| Enter your domain + **Continue** | Attach a domain you already own. | Runner validates and attaches the address, then checks the DNS provider. **Domain added. Finish the DNS records below and shoppers can reach you there.** confirms attachment only; DNS and ownership are verified separately. The control is unavailable before the first successful publication. |
| **Continue to Cloudflare** | Let Runner add the required records at a supported Cloudflare-managed domain. | Runner opens Cloudflare's authorization page. Choose the account that contains the domain and approve Runner's DNS access. After you return, Runner writes the exact required records and starts a fresh connection check. This option appears only when automatic setup is available. |
| **Use manual records** | Switch from an offered automatic flow to manual DNS setup. | Select it to show the exact **Type / Host / Value** records. When automatic setup is unavailable, Runner displays those records directly. Add every displayed record at your DNS provider, then return to Runner. |
| **I have added the records** | Check DNS immediately after saving manual records. | Runner checks automatically; selecting this button skips the initial wait and immediately checks both the routing records and any ownership challenge. A successful provider authorization alone does not mark the domain connected. |
| Clear icon in the domain field | Remove the typed value. | The input is cleared; no domain is changed. |
| **Buy a Domain** search + **Search** | Find domains offered for purchase. | Runner lists available results or explains that the requested domain is unavailable. |
| **Buy** | Begin purchasing a selected available domain. | Runner opens **Contact Information** with the displayed domain and price. No purchase occurs yet. |
| **Proceed to Payment** | Continue a domain purchase or renewal. | Runner redirects to an external checkout. This can create a charge if you complete it. Review the displayed details first. |
| **Transfer a Domain** / **Choose a domain to transfer** | Move an eligible domain from another store in the same workspace. | Selecting a domain opens a confirmation naming the source and destination stores. Confirming starts the transfer; the source store loses that domain. |
| Domain address under **Your Domains** | Open the site at that address. | The domain opens in a new browser tab. |
| Copy beside **Host** or **Value** | Use the exact DNS record Runner recommends. | The selected Host or Value is copied for use at your DNS provider. Enter the displayed **Type** separately. |
| Remove domain | Detach a custom domain. | Runner opens **Remove Domain**. Selecting **Remove** confirms a change the dialog describes as irreversible. |
| **Renew** | Extend an eligible purchased domain shown near expiry. | Runner opens renewal options and a total before **Proceed to Payment**. |
| **Retry** in a failed transfer | Start another transfer attempt. | Runner starts a fresh attempt for the same selected domain. |
| **Close** in a failed transfer | Leave the failed transfer dialog. | The dialog closes without starting the retry. |
| Close or X during **Transfer in progress** | Dismiss the progress dialog | The server-side transfer continues; closing the dialog does not cancel it. Return later to inspect status and do not start another transfer. |
## Connect a domain you already own
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
This example shows **Store published…domain controls are unlocked**. 1. Enter a domain you own. 2. Select **Continue**. 3. Optionally search under **Buy a Domain**. 4. Open the published address under **Your Domains**. **Transfer a Domain** is a separate option. The store address is masked; no domain was added. Select the image to enlarge it. The annotations use the English desktop interface.
1. Confirm the store works at its current published URL.
2. Open **Domain Settings**.
3. Enter the full domain you control, then select **Continue**.
4. **Domain added. Finish the DNS records below and shoppers can reach you there.** means Runner accepted and attached the address. It does not confirm that DNS is configured or that the site is live.
5. Choose a setup method:
- If Runner detects a supported Cloudflare setup, select **Continue to Cloudflare**, choose the Cloudflare account that contains the domain, and approve Runner's DNS access. After Cloudflare returns you to Runner, Runner writes the exact records shown in Domain Settings.
- If an automatic flow is offered and you prefer manual setup, select **Use manual records**. If automatic setup is unavailable, the records are already displayed. Add every displayed **Type / Host / Value** record at your DNS provider.
6. After saving manual records, select **I have added the records** to skip the initial wait and check immediately. Runner also checks automatically while a connection is pending and when you return from Cloudflare.
7. Wait for the connected status. Runner requires both the routing records and domain-ownership verification to pass; completing Cloudflare authorization alone is not proof of connection.
8. Open the domain from **Your Domains**, then verify the public storefront, product, cart, and checkout again at the custom address.
## Buy, transfer, renew, or remove carefully
- **Buy:** Search, select **Buy**, review the domain and current price, enter accurate contact information, then continue to payment only when you intend to purchase it.
- **Transfer:** Read the named source and destination. The confirmation says the source store loses the domain and that immediate undo is not available. Do not confirm while that source store still needs the address. Closing the progress dialog does not cancel an active transfer.
- **Renew:** Review the renewal period and total before continuing to payment.
- **Remove:** Make sure another working domain exists and record the current setup before selecting **Remove**. The confirmation warns that removal cannot be undone.
## States, limits, and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| **Please publish first** | The project has no successful publication yet. | Publish and verify the existing public URL before adding a custom domain. |
| **No domains found** | No domain is currently attached. | Add an owned domain or search for one to buy. |
| **Please enter a valid domain** | Runner rejected the address format. | Correct the address and retry. |
| **Domain is already attached to another store** | Another store in this workspace uses it. | An owner or admin can select **Transfer it instead?**; other members should contact an admin. |
| **Domain added. Finish the DNS records below and shoppers can reach you there.** | Runner accepted and attached the address. DNS configuration is checked separately. | Read the domain row before treating the address as ready. |
| **Continue to Cloudflare** is not shown | Automatic setup is not currently available for this domain or the Cloudflare connection service is not ready. | Use the manual DNS records displayed in the domain row. Do not wait for an automatic option to appear. |
| Manual DNS records and **I have added the records** | The owned domain is attached, but its routing or ownership verification has not passed. | Add every displayed record exactly, wait for DNS propagation, then select **I have added the records** to check immediately. Runner continues checking automatically. |
| Checking or verifying status after returning from Cloudflare | Runner is reading the actual DNS and ownership state. | Keep the page open or return later. If it does not connect, use the manual records and check again. |
| Blue check and the domain's DNS controls are gone | Both the current DNS configuration and ownership verification passed. | Open the domain and verify the complete customer journey; the check alone does not prove the storefront or checkout works. |
| Spinner with **Setting up your domain — it will be online in a few minutes** | A domain bought through Runner is still being set up. | Do not apply the manual owned-domain DNS instructions to this state. Return later; no fixed completion time is guaranteed. |
| **Transfer in progress** | A workspace domain move has started. | Avoid starting another move for the same domain. Closing the dialog only dismisses it; the transfer continues on the server. Return later to inspect the result. |
| Transfer failed | The move did not complete. | Read the error, then select **Retry** or **Close**. Confirm which store still holds the domain before another action. |
| Purchase or renewal failed | The external purchase did not complete. | Follow the status displayed by Runner and confirm any refund state before trying another payment. |
## Related guides
- [Publish and republish](./publish-and-republish)
- [Verify the live store and checkout](./live-store-and-checkout)
- [Troubleshoot preview and publishing](./troubleshoot-preview-and-publishing)
---
# Use Design Mode
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/design-mode
**Entry path:** Workspace → select a store → **Storefront** → **Design Mode**
## What this covers
Open Design Mode on the latest storefront version, select one visible element, make a controlled change, and save it as part of the current project.
## Why and when to use Design Mode
Use Design Mode for focused visual changes that are easier to point at than describe from scratch: rewrite a heading, replace an image, adjust spacing, change typography, or remove a visible element.
Use Runner chat for broader work that spans several pages, changes store behavior, or requires new functionality.
## Availability and prerequisites
Design Mode is conditional. It is available when:
- you are using a desktop layout;
- the latest storefront version is ready and selected;
- you are not previewing an older version;
- Runner is not currently processing another request; and
- the Design Mode feature is enabled for the workspace.
If the preview is still preparing, a historical version is selected, or Runner is working, the button can be hidden or disabled.
## Open Design Mode
1. Open your project.
2. Select **Storefront**.
3. Make sure the version label says **Current** and the preview is ready.
4. Select **Design Mode** in the storefront toolbar.
5. If a bottom editing bar appears with another **Design Mode** control, select it to enable element selection.
6. Move over the storefront and select the element you want to change.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
Design Mode is open, but no element is selected yet. Select the element you want to change to reveal its available controls; the screenshot does not show an edit or save.
## Design Mode controls
| Control | Why you use it | What happens when you select it |
| --- | --- | --- |
| **Design Mode** in the storefront toolbar | Enter the dedicated editing view. | Runner opens the current storefront in the design panel. |
| **Design Mode** in the bottom bar | Turn element inspection on or off. | When on, selectable elements are outlined and selecting one opens its editing bar. Turning it off clears the current editing session. |
| **Ask Runner AI** field and send arrow | Describe a change for the selected element. | Runner receives the instruction with the selected element. When Runner starts, it clears the selection and resets unsaved direct edits and their undo/redo history, so save any pending direct edits before sending. |
| **Spacing** | Change the space inside or around the element. | A panel opens for horizontal and vertical margin and padding. |
| **Image** | Replace a selected image or background image. | A panel opens with **Upload** and **AI-generated** options when that element supports media editing. |
| **Text** | Change type styling. | A panel opens for font size, weight, family, color, opacity, and alignment when supported. |
| **Delete Element** | Remove the selected element from the current edit. | The element disappears immediately in the editor. Use **Undo** if this was accidental, and review before saving. |
| **Undo** | Reverse the latest unsaved visual edit. | Runner steps backward through the current Design Mode edit history. |
| **Redo** | Reapply an edit you just undid. | Runner steps forward through the current Design Mode edit history. |
| **Save** | Keep the current visual edits. | Runner writes the pending changes into the latest version of each file, so a change that a Runner task made to the same file is kept. While the save runs, a Runner AI task waits for it to finish, even one started in another tab. Runner records a new version snapshot when possible, clears this session's undo/redo history, and reloads the preview. The button is disabled when there is nothing to save, and while an earlier save is still running. If Runner AI is editing your store, Save tells you so and keeps your edits. |
| **Close** | Leave the dedicated design panel. | Runner returns to normal storefront preview and clears unsaved edits and command history. Save first if you want to keep the changes. |
## Make a safe visual change
1. Navigate to the target page in normal Preview before opening Design Mode.
2. Enter Design Mode and select one element.
3. Choose one path for this change:
- For a direct edit, use **Spacing**, **Image**, **Text**, or **Delete Element**, then review it with **Undo** or **Redo** and select **Save**.
- For an AI request, save any pending direct edits first, reselect the element if needed, enter the instruction in **Ask Runner AI**, and send it. When Runner starts, the selection and unsaved direct-edit history are cleared.
4. Wait for the chosen save or Runner request to finish, then review the page in normal Preview.
5. Check the page again in **PC**, **Pad**, and **Phone** layouts. Confirm the saved heading, image, or spacing is still present after the preview reloads.
6. Publish only after the saved preview passes your review.
## States, limits, and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| **Starting design mode…** | Runner is preparing the editable preview. | Keep the latest version selected. |
| **Design mode didn't start** | The editable preview did not become ready. | Select **Try Again**. If it repeats, return to normal Preview and refresh. |
| **Your preview is still loading.** | Element inspection is not ready. | Wait for the storefront to finish loading. |
| **You can edit visually again once Runner finishes processing.** | Runner is handling another request. | Wait for the request to finish, then select the element again. |
| Runner starts after an **Ask Runner AI** request | The visual editor resets for the new task. | Any unsaved direct edits and their undo/redo history are discarded. Save direct edits before sending the request. |
| **The preview reloaded, so your unsaved design changes were discarded.** | The storefront preview reloaded before your edits were saved. This happens, for example, after the store wakes up from sleep, when a save fails after the preview reloaded or after Design Mode was closed and reopened, and when Runner starts a task while you are still typing text on the page. The reloaded page shows only saved changes, so Runner cleared the unsaved edits and their undo/redo history. | Make the edits again, then select **Save**. |
| **AI editing not available for dynamic content** | The selected content cannot be changed through that control. | Describe the page and desired result in regular Runner chat. |
| **Nothing to undo / redo / save** | The current Design Mode session has no matching action. | Select an editable element and make a change first. |
| **You can save again once your previous save finishes.** | An earlier save is still writing your store's files, for example because you closed and reopened Design Mode while it ran. | Wait for the earlier save to finish. If the preview then reloads and discards your newer edits, make them again, then select **Save**. |
| **Another Design Mode save is running. Save again when it finishes.** | A save from another tab, another device, or a teammate is writing your store's files. A tab that was closed during its save holds the store for up to 30 seconds. Your edits stay in the editor. | Wait a moment, then select **Save** again. |
| **Runner AI is editing your store. Save again when it finishes.** | A Runner AI task is changing your store's files, for example one you started in another tab, on another device, or from a chat app. Runner did not save, so the task cannot overwrite your edits. Your edits stay in the editor. | Wait for the task to finish, then select **Save** again. |
| **Runner is restoring or updating your store. Save again when it finishes.** | A version restore or another store update is running. Your edits stay in the editor. | Wait for it to finish, then select **Save** again. |
| **Saved changes to source files** | Runner completed the Design Mode save. | Wait for the preview to reload, then review the changed page again. |
| **We couldn't save your design changes** | Runner could not write one or more edits to your store's files, for example because the save lost its hold on your store after a long pause. Those edits stay in the editor, and **Save** stays available. Edits that did save stay saved. If the preview reloaded during the save, the edits that failed are discarded instead, and the reload notice above follows. | Select **Save** again. If it keeps failing, undo that edit or describe the change in Runner chat. After the reload notice, make the edits again. |
| The edit is saved but not live | Saving changes updates the project, not the published storefront. | Review the current version, then select **Publish Changes**. |
## Related guides
- [Edit content, pages, and media](./edit-content-pages-and-media)
- [Preview your store](./preview-your-store)
- [Use version history](./version-history)
---
# Edit content, pages, and media
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/edit-content-pages-and-media
**Entry path:** Workspace → select a store → **Storefront** → open the target storefront page → **Design Mode** → select an element
## What this covers
Open the exact storefront page you want to change, edit one supported text, layout, or media element, and verify the saved result before publishing.
## Why and when to use this workflow
Use this workflow for page-level polish: correct copy, change typography, adjust spacing, replace a photo, generate an alternative image, or remove an unnecessary element. It keeps the target page and the selected element clear.
For changes to navigation behavior, product data, checkout, or several pages at once, send a regular request to Runner instead of relying only on the visual controls.
## Availability and prerequisites
- [Use Design Mode](./design-mode) covers how to open the editor, the desktop-layout requirement, and when the control is unavailable.
- Some generated or dynamic elements cannot be edited inline. Runner shows fewer controls for those elements.
- AI image generation can use credits. Runner shows the applicable notice in the image panel before you run it.
## Open the page and editor
1. Open your project and select **Storefront**.
2. In normal Preview, select storefront links to reach the page you want.
3. If you know the route, select the path field, enter a same-site path such as `/about`, and press **Enter**.
4. Confirm the correct page is visible.
5. Select **Design Mode**, then select the target element.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
Begin by selecting the target element in this view. Image-specific controls appear only after selecting supported media; no replacement or save is shown here.
## Media controls
[Use Design Mode](./design-mode) documents the shared **Ask Runner AI**, **Spacing**, **Text**, **Delete Element**, **Undo**, **Redo**, and **Save** controls. The controls below appear only when the selected element supports media.
| Control | What it changes | What happens when you use it |
| --- | --- | --- |
| **Image → Upload** | A selected image or supported background image. | Select **Upload Image**, choose an image file, and Runner replaces the selected media after upload succeeds. The current limit shown by the product is 5 MB per image. |
| **Image → AI-generated** | A generated replacement image. | Enter a prompt and select **Run It**. After the first result, **Run Again** requests another result and **History** opens results from this editing session. |
| **History** | Generated images from the current image-editing session. | Select an item to inspect it. **Restore this version** applies that image and its prompt; the download icon downloads an individual result. |
## Edit one page safely
1. Record the current page path so you can return to it.
2. Select the element and check which controls appear. Controls vary by element.
3. Make one change at a time, then use **Undo**, **Redo**, or image **History** to compare the result before you select **Save**.
4. Wait for the chosen save or Runner request to finish.
5. Close Design Mode and reopen the same page. Confirm the new image or content remains after reload, then review it in **PC**, **Pad**, and **Phone** layouts.
6. Repeat for the next page only after the first page is correct.
## States, limits, and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| A selected element has only some controls | Runner exposes controls supported by that element. | Use the available control or ask Runner in chat for a broader change. |
| Upload rejected | The file is missing, is not an image, exceeds the displayed limit, or the upload failed. | Choose another image and try again. |
| **Generating…** | Runner is creating the requested image. | Keep the panel open until it finishes or reports failure. |
| **History** is absent | No AI-generated image exists in this editing session yet. | Generate the first image, or upload your own instead. |
| The route does not open | The path is invalid, external, or not part of the preview. | Return to `/`, use a visible storefront link, or ask Runner to create or repair the page. |
| The saved page differs on mobile | The edit affected a responsive layout. | Reopen Design Mode or ask Runner for a device-specific correction before publishing. |
## Related guides
- [Use Design Mode](./design-mode)
- [Preview your store](./preview-your-store)
- [Publish and republish](./publish-and-republish)
---
# Inspect and edit storefront code
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/inspect-and-edit-code
The code editor lets you inspect or make a focused change to the storefront files behind the current preview. Use it only when a visual edit or Runner request is not the better fit.
## What this covers
Open the conditional code editor, save one focused file change, return to Preview to verify it, and keep commit, push, and publication as separate deliberate actions.
## Entry path
Open a store project → **Storefront** → **Open code editor**.
## Before you start
- Wait until the project workspace and storefront preview are connected.
- Use the code editor only if you understand the file you intend to change.
- Save each changed file before closing its tab or the dialog. Closing an unsaved file does not show a confirmation.
- A saved file changes the project workspace, but it is not automatically committed, pushed, published, or proven correct in Preview.
- Use **Commit** and **Push** only when you are authorized to change the project's configured Git remote.
## Editor controls and click results
| Control or state | What happens after you use it |
| --- | --- |
| **Open code editor** | Opens the full-height **Code editor** dialog. Closing the dialog returns the Storefront panel to Preview. |
| Files icon | Shows the searchable storefront file tree. Expanding a folder loads its contents; selecting a file opens it in a tab. |
| File tab | Switches the editor to that open file. An orange dot means the tab contains unsaved changes. |
| Close icon on a file tab | Closes that tab. Runner does not ask about unsaved changes, so save first. |
| Code editor | Lets you change the active file. Typing changes the open tab but does not save the file by itself. |
| **Command-S** on macOS or **Control-S** on Windows/Linux | Saves the active file to the connected project workspace. The orange unsaved indicator clears after success. |
| Git branch icon | Opens the current branch, changed-file lists, commit form, and push controls. Selecting a changed file opens its diff. |
| **Stage** / **Unstage** | Adds or removes one file from the next commit. It does not save an unsaved editor tab. |
| **Stage All** / **Unstage All** | Applies the same staging choice to every file in the corresponding list. Review the list before using either action. |
| **Commit message** | Records the explanation that will be attached to the next commit. |
| **Commit** | Creates a commit from staged files when the message is not empty. Unstaged and unsaved changes remain outside that commit. |
| **Push** | Immediately sends commits that are ahead of the configured remote. There is no second confirmation in this panel. |
| **Refresh** | Requests the latest Git status for the connected project workspace. |
## Make and verify one focused edit
1. Confirm the project name and the current storefront in Preview.
2. Select **Open code editor**.
3. Keep the Files view open, expand the required folder, and select one file.
4. Read the existing content before changing it.
5. Make the smallest intended edit.
6. Press **Command-S** or **Control-S** and confirm the orange dot disappears.
7. Reopen the file to confirm the saved content, then close the code editor and review the affected page in Preview.
8. Check desktop and mobile layouts when the change can affect either one.
9. If the result is wrong, return to the editor and correct it, or ask Runner to repair the specific file and visible problem.
Saving proves only that Runner wrote the file. Preview proves only that the current project can display it. Publishing and the live customer journey remain separate checks.
## Commit and push only when needed
1. Save every file you intend to include.
2. Open the Git branch view.
3. Select each changed file and review its diff.
4. Use **Stage** for the intended files. Avoid **Stage All** when unrelated changes are present.
5. Enter a clear **Commit message**.
6. Select **Commit** and wait for the Git status to refresh.
7. Use **Push** only after confirming the branch and remote workflow. The action starts immediately.
8. Return to Preview and verify the visible result. A successful commit or push does not publish the storefront.
## Troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| **Open code editor** is missing | The feature is not enabled for this project. | Use Design Mode or ask Runner to make the change. Do not rely on a copied internal route. |
| **Connecting to sandbox...** | The project workspace is not connected yet. | Keep the project open and retry after the workspace reconnects. |
| File-tree spinner | Runner is loading the current folder. | Wait before selecting another folder repeatedly. |
| Selecting a file does nothing | The file could not be read or the workspace disconnected. | Check the connection, then select the file once more. |
| Orange dot remains after save | The file was not saved successfully. | Keep the tab open, read the error message, and retry after reconnecting if necessary. |
| **Open a file from the tree** | No file is active. | Select a file in the Files view. |
| **No changes** | Git does not report saved file changes. | Save the editor tab, then select **Refresh**. |
| **Commit** is disabled | No staged file or no commit message is present. | Stage the intended saved file and enter a message. |
| **Push** is disabled | The branch has no local commit ahead of the remote, or a push is running. | Commit the intended change or wait for the current push. |
| **Failed to load git status** | Runner could not read the repository state. | Select **Retry**. Do not stage or push until the status loads. |
| Down-arrow count shows the branch is behind | The remote contains commits not present in the workspace. | Stop before pushing and ask the project owner how to update the branch safely. |
| Save, stage, commit, or push error | The action did not complete. | Keep the current state, read the error, and retry only after checking connection and permission. |
## Related guides
- [Preview your store](./preview-your-store)
- [Use Design Mode](./design-mode)
- [Use version history](./version-history)
- [Publish and republish](./publish-and-republish)
- [Troubleshoot preview and publishing](./troubleshoot-preview-and-publishing)
---
# Verify the live store and checkout
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/live-store-and-checkout
**Entry path:** After a successful publication, use the public URL or **View store** when the handoff offers it. On desktop, when the published-site menu is shown, open **Storefront** → published-site menu → **View Site**. The current mobile Storefront toolbar hides this menu.
## What this covers
Prove that a customer can open the public store, find a real product, add an available option to the cart, and reach a usable checkout—without treating a successful publish message as proof of the whole journey.
## Why and when to verify the live journey
Run this check after the first publication and after changes to products, navigation, pricing, inventory, shipping, payments, or checkout. The four results are independent:
1. the storefront can be public;
2. the intended catalog can be missing or stale;
3. the cart can fail even when a product page loads; and
4. checkout can be paused even when the storefront is live.
## Availability and prerequisites
- A completed publication must provide a public URL.
- At least one intended product should be active, visible, priced, and available for the region you are testing.
- Shipping or delivery setup must cover the test destination when required.
- For a native Runner store, Stripe must be connected if you expect customers to pay. Shopify stores use Shopify checkout and its payment setup.
- Do not complete a real purchase unless you intentionally want to place that order and understand the charge and fulfillment impact.
## Open the live store
Use either path:
1. After publication, select **View store** in the handoff; or
2. On desktop when shown, select the published-site menu in **Storefront**, then select **View Site**; or
3. Open sidebar **Settings → Shop: _store name_ → Domain** and select the published address, including on mobile when the Storefront menu is hidden.
The desktop published-site menu also offers **Copy URL** when shown, so you can test the same address in another browser session.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
After publication, open the dropdown beside **Publish Changes**: 1. Published-site menu. 2. **View Site** opens the live store; **Copy URL** copies its address. 3. **Domain Settings** opens address management. This image does not verify checkout. Select the image to enlarge it. The annotations use the English desktop interface.
## Live-store controls and results
The Stripe status labels below apply to native Runner stores. For a connected Shopify store, verify the Shopify checkout separately.
| Control or status | What happens |
| --- | --- |
| Published URL | Opens the public storefront. Confirm the address is the one you intend to share. |
| **View store** / **View Site** | Opens the public URL in a new tab. This is different from **Open in new tab** inside Preview. |
| **Copy** / **Copy URL** | Copies the public URL for sharing or an independent browser test. |
| **Storefront live** | Runner found a public store URL that customers can browse and share. It does not confirm checkout. |
| **Checking checkout** | Runner is checking whether the store can accept payments. |
| **Checkout live** | Runner found an enabled Stripe connection. It does not test the selected product, shipping destination, checkout fields, or payment step; verify those separately. |
| **Checkout paused** | The public storefront is browseable, but payments are unavailable until Stripe is connected. |
| **Checkout status unavailable** | Runner could not determine the payment state. Select **Retry checkout status** before claiming checkout is ready. |
| **Connect Stripe** | Opens the payment-connection path. Only an eligible workspace owner or admin can complete it. |
| **Skip for now** | Closes the prompt without enabling payments. |
## Test the customer journey
1. Open the public URL in a fresh tab. For a stronger check, use a signed-out or private browsing session.
2. Confirm the expected home page loads without Runner project controls.
3. Follow the public navigation to a collection or product page.
4. Confirm the intended product is visible with the correct title, media, price, and available options.
5. Choose any required option, such as size or color.
6. Select the storefront's add-to-cart control and confirm the cart count or cart contents change.
7. Open the cart. Confirm product, option, quantity, price, and totals match what you selected.
8. Start checkout and confirm the checkout page accepts the required customer and delivery information.
9. Confirm the payment step is available if Runner reports **Checkout live**.
10. Stop before the final purchase action unless a real test order is authorized.
11. Repeat the core browse and cart steps on a phone-sized viewport or real mobile browser.
## Record each result separately
| Check | Pass condition |
| --- | --- |
| Public URL | Opens without an access gate or missing-page state. |
| Navigation | Important links reach the intended public pages. |
| Catalog | The intended live product and its current data are visible. |
| Cart | Adding an available option produces the correct cart state. |
| Shipping | The intended destination has an expected delivery path when applicable. |
| Checkout | The intended checkout reaches its payment step. Native Runner payment status or Shopify setup also confirms an enabled provider. |
| Mobile | Important content and purchase controls remain usable on a small screen. |
## States, limits, and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| Preview works but public URL fails | Preview and publication are different environments or versions. | Return to Runner, check publication status, and use **Republish** only after fixing the named issue. |
| Public site loads but product is missing | The storefront is live, but the intended catalog is not visible there. | Check product status, market, inventory, and whether the latest changes were published. |
| Add to cart is missing or disabled | The chosen product or option may not be sellable in this context. | Check availability, options, price, stock, and market setup in Store Operations. |
| **Checkout paused** | Payments are not connected. | Select **Connect Stripe**; do not advertise the store as ready for orders yet. |
| **Checkout status unavailable** | Runner cannot confirm the payment state. | Select **Retry checkout status** and independently open the checkout path. |
| Checkout opens but cannot continue | Product, shipping, market, customer fields, or payment setup may be incomplete. | Record the exact step and message, fix that setup, publish changes if needed, and retest from the public URL. |
## Related guides
- [Publish and republish](./publish-and-republish)
- [Prepare to publish](./prepare-to-publish)
- [Troubleshoot preview and publishing](./troubleshoot-preview-and-publishing)
---
# Prepare to publish
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/prepare-to-publish
**Entry path:** Workspace → select a store → **Storefront** → **Publish**, **Publish Changes**, or **Republish** (label depends on publication state) → **Put your store live?**
When conditional conversation version cards are enabled, **Publish** on an unpublished **Current Version** work card opens the same publication checks. Historical version cards do not publish directly.
## What this covers
Reach a successful publication check with the store details you intend to launch, or make an informed choice about any incomplete setup Runner asks you to acknowledge.
## Why and when to prepare
Use this checklist before the first **Publish** and before important **Publish Changes**. It reduces the risk of launching a polished page with no sellable product, incomplete shipping, paused payments, or a failed build.
Runner can sometimes let you publish after acknowledging incomplete setup. That is a deliberate exception, not proof that the store is ready to take orders.
The exact checks and handoff depend on the publication experience enabled for the workspace. Some workspaces show a payment warning before publication and a success toast afterward; others show Store Operations checks before publication and checkout status after publication. Follow the labels shown in your flow.
## Availability and prerequisites
- You need a project with a ready storefront preview.
- Publishing depends on plan eligibility and project access. If Runner opens a plan gate, compare the [public plans](https://www.runnerai.com/pricing) and choose the eligible plan before returning to this flow.
- The storefront workspace must be connected and Runner must be idle.
- Store readiness varies by business. Runner can check store basics, products, shipping or stock details, payment connection, detected changes, and whether the storefront builds.
## Open the readiness flow
1. Open your project and select **Storefront**.
2. Review the latest **Current** version.
3. Select **Publish**, **Publish Changes**, or **Republish**, depending on the label shown.
4. Runner checks access, refreshes the detected changes and setup status, then opens **Put your store live?**.
## Preparation controls
| Control | When it appears | What happens when you select it |
| --- | --- | --- |
| **Open Store Operations** | The confirmation says store setup is incomplete. | Runner closes the confirmation and opens Store Operations. |
| **Retry setup status** | Runner could not verify Store Operations. | Runner checks the setup status again. |
| **Retry check** | Runner could not reach the storefront workspace. | Runner reruns the publication build check. |
| **Fix with AI** | The storefront build check fails and Runner can repair it. | Runner closes the confirmation and sends the build error into the conversation for repair. No publication starts. |
| Warning checkbox | Depending on the publication flow, incomplete or unavailable Store Operations, or no payment connection needs explicit acknowledgment. No-change checks cannot be acknowledged away. | Selecting the checkbox confirms that you understand the named risk; it can enable **Confirm** after the build check succeeds. |
| **Cancel** | You are not ready to continue. | Runner closes the confirmation without publishing. |
| **Confirm** | The build check succeeded and required warnings have been resolved or acknowledged. | Runner starts publication. The button remains disabled while checks are incomplete or Runner is working. |
## Complete the launch checklist
1. In Preview, check the home page, navigation, product page, cart entry, and phone layout.
2. Open Store Operations and confirm the business and store details shown there are correct.
3. Confirm at least one intended product is visible, sellable, and uses the correct price, options, and media.
4. Confirm the stock location and shipping setup needed for that product.
5. Decide whether checkout must accept payments at launch. For a native Runner store, connect Stripe if payments must be accepted. Shopify stores keep checkout in Shopify; review that shop's payment setup. Some workspaces show this warning before publication and others report checkout status afterward; neither is a substitute for testing checkout.
6. Return to **Storefront** and select the publication button.
7. Wait for **Your store is ready to publish!**
8. Resolve every warning. Use an acknowledgment only when you accept its exact customer impact.
9. If you only wanted to inspect readiness, select **Cancel**. Select **Confirm** only when you intend to put this version online.
10. After publication, verify the live storefront, catalog, cart, and checkout separately.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
The build passes in this example, but store setup still needs attention. An acknowledgment does not finish that setup.
### Watch: review checks and cancel
The recording reviews the build result and setup warning, then selects **Cancel**. It does not publish the example store.
## Readiness states and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| **Verifying your store is ready to publish…** | Runner is checking the current storefront build. | Wait for success or a named failure. |
| **Your store is ready to publish!** | The build check passed. | Resolve warnings, then select **Confirm**. |
| **Your store won't build yet, so it can't go live. Let Runner fix the errors, then publish.** | The storefront cannot be published in its current form. | Select **Fix with AI**, review the repair, and start the readiness flow again. |
| **We couldn't reach your workspace. Retry the check to continue.** | The check could not access the current workspace. | Select **Retry check**. If it repeats, reconnect the workspace. |
| **Make a visible change to your storefront before publishing.** | Runner did not find a change since the last publication. | Cancel and make the intended storefront change. **Confirm** stays disabled when there are no changes to publish. |
| **A few operating details still need your attention. You can go live now and finish them in Store Operations.** | Important operating details remain unfinished. | Select **Open Store Operations**. Publish with acknowledgment only if you accept the limitations. |
| **We couldn’t verify Store Operations. Retry, or acknowledge this and publish anyway.** | Setup status is unavailable, not necessarily complete. | Select **Retry setup status** before considering the acknowledgment. |
| **Shoppers can browse but can't pay yet — connect Stripe in Settings to take orders.** | In publication flows that show this warning before launch, Runner did not find an enabled payment connection. | Connect Stripe, or acknowledge only if a browse-only launch is intentional. Other flows report checkout status after publication instead. |
## Related guides
- [Preview your store](./preview-your-store)
- [Publish and republish](./publish-and-republish)
- [Verify the live store and checkout](./live-store-and-checkout)
---
# Preview your store
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/preview-your-store
**Entry path:** Workspace → select a store → **Storefront**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
## What this covers
Review the current storefront inside Runner, move between its pages, and check how it looks on desktop, tablet, and phone layouts without publishing it.
## Why and when to use Preview
Use Preview after Runner creates or changes the storefront. It is the safest place to catch missing copy, broken routes, poor mobile layouts, or unfinished sections before customers see them.
Preview is separate from the live store. A page that looks correct here does not prove that the public URL, catalog data, inventory, payment connection, or checkout works.
## Availability and prerequisites
- Open a project with existing storefront activity or a previewable version.
- If the page says **Tell Runner what your storefront should look like.**, use the input on that page to ask Runner to build the first version.
- If it says **Building the first version of your storefront…** or **Preparing preview…**, the preview is not ready yet.
- Some workspaces use the newer checkpoint-based storefront. The exact version controls can vary with staged availability.
When conditional conversation version cards are enabled, selecting a completed work card's storefront image or **Preview** opens the exact ready version created by that task. It can be historical rather than latest. For an older project without saved version history, **Preview** on the latest storefront work card opens the current live preview instead. Check the **v…**, **Current Version**, and **Published** labels when they are available before editing or starting publication.
A completed task or successful source build does not by itself mean Preview has updated. Runner promotes the finished storefront after the task completes. If that promotion fails, Preview keeps the previous successful version—or shows no built preview when none exists—so confirm the visible version and preview result.
## Open Preview
1. Open your Runner workspace.
2. Select the store you want to review.
3. Select **Storefront** in the project navigation.
4. Wait until the current version appears in the preview area.
### Watch the device control
This silent recording shows the original v1 preview in the English interface. Select **PC**, then **Pad**, then **Phone** to change the preview frame. Select **Phone** again to return to desktop. The storefront stays unpublished throughout this example.
If the project has no storefront yet:
1. Enter what you want in the storefront description input. Describe the look, layout, products, and content you want.
2. Select the send arrow (**Send message**), or **Start building** if that action appears in your workspace.
3. Runner creates a conversation and sends that description as the first request.
4. If creation fails, the description remains in the field so you can retry.
## Preview controls
| Control | Why you use it | What happens when you select it |
| --- | --- | --- |
| **Go Back** | Return to the previous page visited inside the preview. | The preview moves backward in its own page history. It does not leave your Runner project. |
| **Go Forward** | Revisit a page after going back. | The preview moves forward when a later history entry exists. |
| **PC / Pad / Phone** | Check responsive layouts. | Each selection cycles the preview frame to the next device size. It does not change the live storefront. |
| Path field, such as `/` | Open a known storefront route. | Select the path, enter another path on the same preview site, and press **Enter**. Invalid or external addresses are ignored. |
| **Refresh** | Reload the current preview after a change or stalled render. | Runner reloads the visible page and clears the active Design Mode selection and undo/redo session. Save pending design changes first. |
| **Open in new tab** | Review the preview with more space. | Runner opens this preview URL in another browser tab. This is still a preview, not proof of a published store. |
| Version label, such as **v1 · Current** | Identify what you are reviewing. | The label distinguishes the latest current version from a historical preview. |
| **Design Mode** | Start visual editing. | Runner opens the design workspace when the latest version is eligible. |
| **Version History** | Compare earlier storefront versions. | Runner opens the version list without changing the current storefront. |
| **Open code editor** | Inspect or edit the storefront source when this advanced control is available. | Runner opens the full-height **Code editor** dialog. Closing it returns the Storefront panel to Preview; verify the visible result there. |
| Coin / **Invite friends** | Open the referral offer. | Runner opens the referral dialog; no credit is earned merely by opening it. |
| Credit count / **Upgrade** | Review credit, plan, or usage options. | Runner opens a popover whose available actions can lead to workspace Billing or Usage. |
| **Publish**, **Publish Changes**, or **Republish** | Start the publication flow appropriate to the current state. | Runner runs access and readiness checks before any publication starts. |
## Review a storefront page by page
1. Start at `/` and scan the header, announcement area, hero, featured products, sections, and footer.
2. Select every visible navigation link. Confirm the destination appears and the preview path changes as expected.
3. Open a product page from the storefront. Confirm its title, media, price, options, availability, and purchase control are visible.
4. Use the path field for important routes that are not linked from the current page.
5. Cycle through **PC**, **Pad**, and **Phone**. Look for clipped content, overlapping controls, unreadable text, and horizontal scrolling.
6. Select **Refresh** only after saving any Design Mode changes.
7. Record any problem in Runner chat with the page path, device size, and expected result.
## States, limits, and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| **Tell Runner what your storefront should look like.** | Runner has no ready storefront to display. | Enter a request to create the first version. |
| **Building the first version…** | The first version is still being prepared. | Follow task progress and wait for a terminal result. |
| **Preparing preview…** | Runner is starting the selected preview. | Keep the page open; use **Refresh** only if the state stops progressing. |
| **Failed to load the preview for this version** | The selected version could not be displayed. | Return to the current version, refresh, or report the version and error to Runner. |
| **Reconnecting preview** | Runner lost the preview connection and is retrying. | Keep the project open and follow the retry count. If it cannot recover, reconnect the workspace. |
| Preview error bar with **Fix** | The preview reported an error Runner can inspect. | Select **Fix** or **Fix error** to send the displayed diagnostic to Runner. Use **Show more** to expand details and **Dismiss** only to hide the message. |
| A control is disabled | The preview does not currently support that action, the workspace is disconnected, or Runner is working. | Wait for Runner, reconnect the workspace if prompted, or return to the latest ready version. |
| The preview looks correct but the live store does not | The changes have not been published, or you are viewing different versions. | Check the version label, then use [Publish Changes](./publish-and-republish). |
## Related guides
- [Build your first store, step by step](../start-here/first-store-quickstart)
- [Use Design Mode](./design-mode)
- [Edit content, pages, and media](./edit-content-pages-and-media)
- [Inspect and edit storefront code](./inspect-and-edit-code)
- [Use version history](./version-history)
- [Prepare to publish](./prepare-to-publish)
---
# Publish and republish
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/publish-and-republish
**Entry path:** Workspace → select a store → **Storefront** → **Publish**, **Publish Changes**, or **Republish** (label depends on publication state)
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
## What this covers
Use the publication action Runner shows for the current store state, follow the confirmation to a terminal result, and open or copy the public URL when one is available.
## Why and when to publish
Publishing makes the current project version available at a public store URL. Use **Publish** for the first launch, **Publish Changes** for a store that already has a healthy public URL, and **Republish** to retry a failed or incomplete publication result.
Saving a Design Mode edit, restoring a version, or seeing a correct Preview does not update the public store by itself.
Publication handoff varies by workspace rollout. Some workspaces show a payment warning before publication and only a success toast afterward; others show Store Operations checks before publication and open a checkout-status handoff after success.
## Availability and prerequisites
- Complete the [publication readiness checklist](./prepare-to-publish).
- Use the latest **Current** storefront version.
- Wait for Runner to finish any active request.
- Reconnect the storefront workspace if the button says it is unavailable.
- Publishing can be restricted by your plan or project eligibility.
- When publication requires a higher plan, **Upgrade** opens the Plus monthly confirmation. You can return from that confirmation to the full plan list before purchasing.
## Open the publication flow
1. Open your project.
2. Select **Storefront**.
3. Select the publication button at the right side of the toolbar.
4. Read **Put your store live?** and wait for the build check.
5. Resolve the blocking items. Acknowledge a warning only when the dialog offers that option and you understand its effect.
6. Select **Confirm** only when it is enabled and you intend to make this version public. Select **Cancel** to leave without publishing.
### Watch: review the checks without publishing
This silent English-interface recording shows the build result and remaining setup warning. Selecting **Cancel** returns to Preview. A passed build check does not complete the store's operating setup or enable checkout.
## Choose the correct action
| Label | When Runner shows it | What selecting it does |
| --- | --- | --- |
| **Publish** | The store has not completed its first publication. | Opens access, setup, change, and build checks for the current version. |
| **Publish Changes** | A completed publication has a usable public URL. | Opens the same checks so you can send the current version to the existing live store. |
| **Republish** | The last publication failed, or it completed without a usable URL. | Starts a fresh checked publication attempt. |
| **Starting… / Preparing… / Building… / Saving checkpoint… / Publishing…** | A publication step is in progress. | The button is disabled and reports progress. Wait for success or failure. |
## Publication and handoff controls
| Control | What happens when you select it |
| --- | --- |
| **Cancel** in **Put your store live?** | Closes the dialog without publishing this version. |
| **Fix with AI** | Sends a build failure to Runner for repair, without publishing. |
| **Retry check** | Reruns the build check after a workspace-access failure. |
| **Confirm** | Starts publication after the build check and required acknowledgments are complete. |
| **Publish anyway — I'll finish setup later.**, when offered | Acknowledges the listed incomplete setup. It does not complete those tasks or publish the store until you also select Confirm. |
| Published URL | Opens the public storefront in a new tab. |
| **Copy** or **Copy URL** | Copies the public store address to your clipboard. |
| **View store** | In the checkout-status handoff, opens the public storefront after a successful publication. |
| **Connect Stripe** | In flows that show payment status, starts payment connection when checkout is not ready. Access can depend on your workspace role. |
| **Skip for now** | Closes the post-publish payment prompt when shown. The storefront can stay browseable while checkout remains paused. |
| **Retry checkout status** | In the post-publish handoff, checks again for an enabled Stripe connection when status was unavailable. |
| **Close** | Closes the successful checkout-status handoff when it is shown and checkout is already connected. |
| Published-site menu | On desktop when shown, opens **View Site**, **Copy URL**, **Domain Settings**, and the last-published information. |
## Publish to a terminal result
1. Confirm the button label matches your intention.
2. Select it and wait for the build check to finish.
3. If **Fix with AI** appears, use it, review the resulting preview, and restart publication.
4. If warnings appear, fix the underlying setup whenever checkout or normal store operations matter.
5. Select **Confirm**.
6. Keep the project open until Runner reports success or failure.
7. On success, open the public URL. Use **View store** when the checkout-status handoff appears; another rollout can show only a success toast before returning to Storefront.
8. If the URL is unavailable, close the handoff and use **Republish** after the workspace is ready.
9. If publication fails, read the failure, repair it, and select **Republish**. Do not assume the attempted changes are live.
## Publication states and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| **Store published** / **Your store is live** | Runner completed publication and has a public URL. | Open the URL and verify the customer journey. |
| **Publish complete** with **Store link unavailable** | Publication finished without a usable link in the handoff. | Close the dialog, ensure the workspace is ready, then use **Republish**. |
| **Store publish failed** | The publication did not complete. | Review the error or ask Runner to fix it, then use **Republish**. |
| **Your store couldn't be built** | The current project failed before publication. | Select **Fix with AI** and do not retry unchanged work. |
| Button says **Reconnect the sandbox to publish** | Runner cannot reach the storefront workspace. | Reconnect it, then rerun the checks. |
| Button says **Wait for Runner to finish** | A request is still active. | Wait for its terminal result before publishing. |
| **No changes** or disabled **Confirm** | There is no new saved change, a build is incomplete, an AI task is active, or a required check is unresolved. | Complete the item shown. No changes is a blocking state, not a warning you can acknowledge away. |
| Public store shows an older version | The latest project changes were not published successfully. | Check the current version, then use **Publish Changes** and verify again. |
## Related guides
- [Build your first store, step by step](../start-here/first-store-quickstart)
- [Prepare to publish](./prepare-to-publish)
- [Verify the live store and checkout](./live-store-and-checkout)
- [Connect a custom domain](./custom-domains)
---
# Troubleshoot preview and publishing
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/troubleshoot-preview-and-publishing
**Entry path:** Workspace → select a store → **Storefront** → reproduce the preview or publication state shown on screen
## What this covers
Identify which layer is failing—project version, preview, build check, publication, public catalog, checkout, or domain—and take the smallest safe recovery action.
## Why this distinction matters
The storefront journey has several independent layers. Repeating **Publish** cannot fix missing product data, and refreshing Preview cannot repair a payment connection. Start with the exact message and surface that failed.
## Availability and prerequisites
- Keep the project open and note the current version label.
- Record the exact message, page path, and whether it appeared in Preview or on the public URL.
- Wait for active Runner work to reach **Completed**, **Failed**, or **Stopped** before starting a conflicting recovery action.
- Do not remove domains, restore versions, or repeat paid actions just to test a theory.
## Find the failing layer
1. In **Storefront**, check whether a current version exists.
2. Confirm whether normal Preview opens.
3. If you are publishing, read the result of the build check before selecting another action.
4. If publication succeeds, open the public URL rather than the preview URL.
5. On the public store, test the catalog and cart.
6. Check Runner's checkout status and the actual checkout path.
7. If only the custom address fails, check Domain Settings last.
## Important recovery controls
| Control | What happens when selected |
| --- | --- |
| **Refresh** in Preview | Reloads the current preview and clears the active Design Mode selection and undo/redo session. Save pending direct edits first. |
| **Fix** / **Fix error** | Sends the displayed preview diagnostic to Runner as a repair request. **Dismiss** only hides the message. |
| **Fix with AI** | Closes the publication confirmation and sends its build failure to Runner for repair; publication does not start. |
| **Retry check** | Runs the storefront build check again after Runner could not reach the workspace. |
| **Open Store Operations** | Closes the publication confirmation and opens Store Operations so you can complete the named setup. |
| **Retry setup status** | Checks Store Operations readiness again after its status was unavailable. |
| **Republish** | Starts a fresh checked publication attempt after a failed or linkless result. Fix the named cause first. |
| **Retry checkout status** | Checks again for an enabled payment connection; it does not test a product, shipping, or the checkout form. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
A passed build check can appear beside a setup warning. Read both before deciding whether the store is ready.
## State-to-action reference
| Message or symptom | Layer | What it means | Safest next action |
| --- | --- | --- | --- |
| No ready storefront version | Project version | No previewable version exists. | Ask Runner to build the first storefront. |
| **Building the first version…** | Project version | Runner is still creating it. | Follow task progress; do not publish yet. |
| **Build failed** on a version | Project version | That version is not ready. | Open the task details and ask Runner to repair the failure. |
| **Preparing preview…** | Preview | Runner is starting the selected preview. | Keep the latest version selected; refresh only if progress stops. |
| **Failed to load the preview for this version** | Preview | The selected version could not be displayed. | Return to current, refresh, or try another ready version. |
| **Reconnecting preview** | Preview | Runner lost the preview connection and is retrying. | Follow the retry count; reconnect the workspace if recovery fails. |
| Preview error bar with **Fix** | Preview | The running page reported a diagnostic Runner can use. | Select **Show more** to inspect it, **Fix** or **Fix error** to send it to Runner, or **Dismiss** only to hide the bar. |
| **Page not found** | Preview or public route | The path does not exist in that version. | Return to `/`, use visible navigation, and ask Runner to create or repair the route. |
| **Design mode didn't start** | Design Mode | The editable preview did not become ready. | Select **Try Again**, or return to current Preview and refresh. |
| **You can edit visually again once Runner finishes processing.** | Design Mode | Runner is handling another request. | Wait for Runner to finish. |
| **Failed to load version history** | Version history | The version list request failed. | Select **Try Again**. |
| Restore is blocked | Version history | Runner is active or the version is not ready. | Wait for Runner, then choose a ready version. |
| **We couldn't reach your workspace. Retry the check to continue.** | Publication check | Runner could not run the build check. | Select **Retry check**; reconnect the workspace if it repeats. |
| **Your store won't build yet, so it can't go live. Let Runner fix the errors, then publish.** | Publication check | Current storefront cannot pass the build. | Select **Fix with AI**, review the repair, then rerun the checks. |
| **A few operating details still need your attention. You can go live now and finish them in Store Operations.** | Publication setup | Important store operations remain unfinished. | Select **Open Store Operations**. Acknowledge only if the limitation is intentional. |
| **We couldn’t verify Store Operations. Retry, or acknowledge this and publish anyway.** | Publication setup | Setup status is unknown. | Select **Retry setup status** before considering an acknowledgment. |
| **Make a visible change to your storefront before publishing.** | Publication changes | Runner found nothing new since the last publication. | Cancel and make the intended change first. **Confirm** is disabled when there are no changes to publish. |
| **Shoppers can browse but can't pay yet — connect Stripe in Settings to take orders.** | Checkout setup | Some publication flows show this before launch when no enabled payment connection is found. | For a native Runner store, connect Stripe; use the acknowledgment only for an intentional browse-only launch. Other flows report checkout status after publication. |
| **Store publish failed** | Publication | The attempt did not complete. | Repair the named issue, then select **Republish**. |
| **Store link unavailable** | Publication handoff | The attempt finished without a usable public URL in Runner. | Close the dialog, confirm the workspace is ready, then select **Republish**. |
| Public store shows old content | Publication or version | The current project changes are not live. | Confirm the latest current version, select **Publish Changes**, and reopen the public URL. |
| Product missing on public store | Catalog | Publication succeeded, but the intended product is not visible. | Check product status, market, price, and inventory; publish changes if required. |
| Cart action missing or disabled | Catalog or availability | The selected item cannot currently be added. | Check required options, availability, stock, price, and region. |
| **Checkout paused** | Payment | The post-publish flow did not find an enabled Stripe connection. | Select **Connect Stripe**, then retest the actual checkout path. |
| **Checkout status unavailable** | Payment status | Runner cannot confirm payment readiness. | Select **Retry checkout status** and test the public checkout independently. |
| Owned custom domain shows a red warning and a **Type / Host / Value** table | Domain | The current provider configuration check has not passed. | Copy the displayed values exactly to your provider. Runner rechecks automatically while Domain Settings remains open; after saving manual records, select **I have added the records** to check immediately. |
| **Transfer in progress** | Domain | A domain is moving between stores. | Do not start another transfer; follow the shown status. |
## Confirm the recovery
Return to the same page, version, and device size that failed. Repeat the smallest failed step once. Check its visible result: a ready preview, a successful publication with the expected page at the public URL, a correct cart, or a working domain. Record any step that still fails separately.
## Report a problem to Runner
Include these details in one message:
1. the exact page path or public URL;
2. whether it failed in Preview or on the live store;
3. the current version label;
4. the exact error or state text;
5. the last button you selected;
6. the expected result; and
7. whether the issue reproduces after the documented retry action.
For a visual problem, include the device layout and a screenshot. For checkout, stop before a real charge and report the last successful step.
## Recovery boundaries
- Do not repeatedly resume or republish an unchanged failed state. Fix the named cause first.
- Do not restore an older version while Runner is working.
- Do not remove a domain to fix a storefront or checkout issue.
- Do not claim launch success until the public URL, intended catalog, cart, and required checkout step have each been checked.
## Related guides
- [Preview your store](./preview-your-store)
- [Prepare to publish](./prepare-to-publish)
- [Publish and republish](./publish-and-republish)
- [Verify the live store and checkout](./live-store-and-checkout)
- [Connect a custom domain](./custom-domains)
---
# Use version history
Source: https://www.runnerai.com/docs/en/guides/storefront-and-publishing/version-history
**Entry path:** Workspace → select a store → **Storefront** → **Version History** (clock-and-arrow icon)
## What this covers
Compare storefront versions, preview an earlier ready version, and—when needed—restore its content as a new current version while keeping the existing history.
## Why and when to use version history
Use version history when you need to understand what changed, review an earlier design, or recover content that was better before a recent request. Previewing is read-only. Restoring changes the project, so review the confirmation first.
## Availability and prerequisites
- Open a project with at least one storefront version.
- Historical preview and restore are available only for versions Runner can load successfully.
- Wait for Runner to finish an active request before restoring.
- Version history is conditional in workspaces using the checkpoint-based storefront experience.
- Some completed conversation work cards also show a conditional version label, exact-version preview, and **Publish** action for an unpublished current version. Those cards are a quick entry; this page remains the full comparison and restore view.
## Open version history
Open the store you want to review, then follow the numbered callouts below.
1. **Select Storefront in the left sidebar.** This opens your store preview. If the sidebar shows only icons, expand it using the sidebar button in the upper-left corner.
2. **Click the clock-and-arrow icon above the preview, near the upper-right corner.** This is **Version History**. Hover over it to see its name. In the example, it sits just to the left of the published-site address and **Publish Changes**.
3. **Check that the Version History panel opens on the right.** The newest version appears under **Current Version**. Scroll down to review older versions if your store has them. Select **Back** (the left arrow beside the panel title) to close the panel.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsx1z1nuaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Select the image to enlarge it. The annotated desktop views show where to click. Opening history does not restore or publish anything. A store with only one recorded version shows just **Current Version**.
**On a phone:** open **Storefront**, tap **More actions** (**…**) beside the publishing button at the bottom, then tap **Version History**.
If you cannot see the history control, leave **Design Mode** or return to the latest preview first. Wait for an initial build to finish. Availability can also depend on your workspace's storefront experience.
### Example with an earlier version
Compare the labels before choosing a version. This example opens the history only; it does not restore or publish a version.
## Version history controls
| Control | Why you use it | What happens when you select it |
| --- | --- | --- |
| **Back** | Leave the version list. | Runner returns to the storefront view. |
| Version screenshot | Inspect the captured appearance. | The screenshot opens in a larger image viewer when one is available. |
| **View full diff** | See a detailed record of what changed. | Runner opens the change details for that version in a new tab. |
| **Preview** / **Preview this version** | Review an earlier ready version without restoring it. | The storefront switches to a temporary historical preview labeled **Previewing v…**. The latest project version and live store do not change. |
| **Back to latest** / **Return to current** | End a historical preview. | Runner reloads the latest current storefront version. |
| **Restore** | Reuse an earlier version's content. | Runner opens **Restore to v…?**. Confirming creates a new latest version with that content; the selected version, newer versions, and history remain. |
| **More actions** | Reach card actions on compact layouts. | A menu opens with the actions available for that version, such as Preview, Restore, or View full diff. |
| **Publish** on the current version | Start publishing the latest version. | Runner opens the publication checks. It does not publish a historical preview directly. |
## Read the version cards
| Label or state | Meaning |
| --- | --- |
| **Latest** or **Current Version** | This is the newest project version. |
| **Published** | This version is associated with a completed publication. It does not prove checkout is working now. |
| **Building…** | Runner is still creating the version. Preview and restore can be unavailable. |
| **Build failed** | This version did not reach a ready state. Use its error context to ask Runner for a fix. |
| File-change counts | A summary of added, changed, or removed files for that version. |
| Time | When the version was recorded. |
| Description | The recorded summary of the version when one is available. |
## Preview and restore safely
1. Select **Preview** on the version you want to inspect.
2. Confirm the toolbar says **Previewing v…** so you do not mistake it for the latest version.
3. Check the relevant page and device layouts.
4. Select **Back to latest** if you only needed to compare.
5. To recover the older content, select **Restore**.
6. Read the confirmation: Runner will add a new version and keep the existing history.
7. Confirm the restore only when Runner is idle.
8. Confirm that a new **Current Version** appears, then review the restored content in Preview before publishing it. Older history should still be available.
## States, limits, and troubleshooting
| What you see | Meaning | What to do |
| --- | --- | --- |
| **No version history yet** | Only the current starting state exists, or no history is available. | Continue working; return after Runner records another version. |
| **Loading Version History…** | Runner is retrieving the cards. | Keep the panel open until it finishes. |
| **Failed to load version history** | The list request failed. | Select **Try Again**. |
| **Failed to load the preview for this version** | That historical preview could not start. | Return to current and try another ready version. |
| Restore is disabled | Runner is active or the version is not restorable. | Wait for Runner to finish or select a ready version. |
| **Can't restore while the agent is working** | Restoring would conflict with the active task. | Let the task reach a terminal state, then retry. |
| **Can't restore while a Design Mode save is running** | A Design Mode save, possibly from another tab, is writing your store's files. | Wait a few seconds for the save to finish, then retry. |
| Restored content is not live | Restore created a project version, not a publication. | Review it, then select **Publish Changes**. |
## Related guides
- [Preview your store](./preview-your-store)
- [Publish and republish](./publish-and-republish)
- [Troubleshoot preview and publishing](./troubleshoot-preview-and-publishing)
---
# Use cases
Source: https://www.runnerai.com/docs/en/guides/use-cases
New to Runner? Follow [Build your first store](/en/guides/start-here/first-store-quickstart) first, then choose the outcome you need below.
## Explore by goal
- [Storefront and publishing](/en/guides/storefront-and-publishing)
Preview, edit, version, publish, and verify your Runner storefront.
- [Store Operations](/en/guides/store-operations)
Set up and run your store's catalog, orders, customers, promotions, sourcing, and reviews.
- [Apps and integrations](/en/guides/apps-and-integrations)
Find, connect, and manage the services your Runner store and Agent can use.
- [Analytics and SEO](/en/guides/analytics-and-seo)
Read store performance, diagnose conversion, and improve how people and AI search tools find your storefront.
- [Automate, test, and create](/en/guides/automate-test-and-create)
Use Runner's conditional tools for recurring work, shopper testing, experiments, media generation, and advertising.
- [Agent Customization](/en/guides/agent)
Add reusable Skills and trusted Memory so Runner can work in a way that fits your store.
---
# Work with Runner
Source: https://www.runnerai.com/docs/en/guides/work-with-runner
**What this covers:** You will know where to start a request, how to guide the work, and where to review the result.
Use this section after you have opened a store project. Runner keeps the request, progress,
preview, and related project tools together so you can move from an idea to a reviewable result.
**Entry path:** Open the intended store from the store-name menu → open its current task or select **New Task**.
## The everyday loop
1. Open the store you want to change.
2. Start a **New Task** when the work needs a separate conversation.
3. Describe one clear outcome in the message box.
4. Add a reference image, choose a profile, or add a skill when it will help.
5. Select **Send message** and follow the task state.
6. Answer any question Runner asks so it can continue with the right choice.
7. Open **Details**, the preview, or another work-canvas tab to review the result.
8. Send a focused follow-up if anything needs adjustment. Finish by checking that the requested customer action works in the resulting page or tool.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
When a task needs your decision, answer its active card before expecting more work. The [question guide](/en/guides/work-with-runner/answer-runner-questions) includes the matching recording.
## Choose a guide
| What you want to do | Guide |
| --- | --- |
| Start a request and understand the composer | [Chat with Runner](/en/guides/work-with-runner/chat-with-runner) |
| Reopen, rename, or remove a conversation | [Chats and history](/en/guides/work-with-runner/chats-and-history) |
| Find a project tool or recent chat | [Project navigation and search](/en/guides/work-with-runner/project-navigation-and-search) |
| Give Runner clearer direction | [Write effective requests](/en/guides/work-with-runner/write-effective-requests) |
| Add context or change how Runner approaches a task | [Images, models, and skills](/en/guides/work-with-runner/attachments-profiles-and-skills) |
| Respond when Runner needs a decision | [When Runner asks a question](/en/guides/work-with-runner/answer-runner-questions) |
| Understand progress and inspect completed work | [Task states and details](/en/guides/work-with-runner/task-states-and-details) |
| Quickly add a skill or memory | [Agent command palette](/en/guides/agent/command-palette) |
## Before you start
- You must be signed in and have access to a store project.
- A newly created chat is blank until you send a message.
- Some tools, profiles, skills, and navigation destinations are conditional. Runner shows only
what is available for the current account and project.
- Publishing, billing, and destructive actions require their own confirmation paths. A completed
chat task does not by itself mean a store was published or an external action occurred.
## Related guides
- [Build your first store](/en/guides/start-here/first-store-quickstart)
- [Manage stores](/en/guides/workspace/manage-stores)
- [Understand store statuses](/en/guides/workspace/store-statuses)
---
# When Runner Asks a Question
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/answer-runner-questions
**What this covers:** You will answer or intentionally skip Runner's questions without losing task context.
Runner asks a question when your decision can materially change the result. Questions can use a
single choice, multiple choices, or a free-form answer.
**Entry path:** Open a conversation whose task state is waiting for input → question card.
## Before you start
- Answer the newest active question; older cards can be read-only.
- Review the effect carefully when a choice involves access, money, publishing, customer data, or an external service.
- Use **Skip** only when Runner can safely choose without your preference.
## Question controls
| Control or state | What happens |
| --- | --- |
| A single-choice option | Selects the answer and can advance to the next question. The final choice can send the answers automatically. |
| Multiple-choice options | Lets you select more than one permitted answer. |
| **Other…** | Opens a field for an answer that is not listed. |
| Submit or continue action, when shown | Advances the card or sends the completed answers. |
| **Skip**, when offered | Tells Runner to proceed using its best judgment. |
| Disabled card | The task is busy, expired, stopped, or the question can no longer accept an answer. |
## Answer a question
1. Read the question and any explanation above the choices.
2. Read each choice before selecting it: a single choice can advance immediately, and the final answer can submit automatically.
3. Select the choice or choices that match your intent.
4. Choose **Other…** and enter a concise answer when none of the listed choices fit.
5. Use the continue or submit action only if the card shows one.
6. Wait while Runner delivers the answers.
7. Confirm that Runner resumes the task and records your answer in the conversation.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
English callouts highlight the controls. Select the image to enlarge it.
Read each choice before selecting it; the final answer can be sent automatically.
### Watch: answer follow-up questions
The example selects a candle price and a photography direction. **Answered** confirms the choices, then Runner resumes the task.
## Skip when Runner can decide
1. Read what Runner is asking.
2. If the card offers **Skip**, select it only when you are comfortable with Runner using its best judgment.
3. Watch the task resume.
4. Review the result closely, because you did not provide the missing preference.
Skipping is useful for low-risk presentation choices. Give an explicit answer when the decision
affects access, money, publishing, customer data, or a destructive action.
## Troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| Waiting for input | Runner cannot confidently continue without a response. | Answer or intentionally skip the active question. |
| Old question is read-only | A newer message or task state has replaced it. | Answer the newest active question instead. |
| **User interrupted this question** | The task was stopped before the question was completed. | Start a new follow-up message if you still want Runner to continue. |
| Submit is unavailable | One or more required answers are incomplete, or the card is no longer active. | Complete every current question or move to the latest question card. |
| Response error | Runner could not accept the answer. | The card can return to its unanswered state. Keep the conversation open, check the latest task state, and answer again only when the card accepts input. |
## Related guides
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
- [Write effective requests](/en/guides/work-with-runner/write-effective-requests)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
---
# Attachments, Models, and Skills
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/attachments-profiles-and-skills
**What this covers:** You will give Runner the right context and working tools before sending a request.
Images show Runner what you mean. Models and skills change the capabilities available for
the next request. When **Attach** appears, you can also give Runner supported documents as context. Use them deliberately; a clear request is still the most important input.
**Entry path:** Open a store project → conversation composer.
## Before you start
- Use only images you are allowed to share with the current workspace.
- Remove secrets, payment data, and unnecessary customer information.
- Check plan and browser access when a model, Skill, or screen-capture action is missing.
## Composer controls
| Control | What happens when you select it |
| --- | --- |
| **Add** | On desktop, opens **Upload image** or **Attach** when document attachments are enabled, plus **Take screenshot** when supported. |
| **Attach**, when offered | Opens the picker for supported documents and images. |
| **Upload image** | Opens the image picker for JPG/JPEG, PNG, GIF, WebP, BMP, or TIFF files. |
| **From Media Library**, when offered | Opens existing project media so you can choose a reference for the draft. |
| **Take screenshot** | Starts screen capture when the browser and account support it. The browser may ask for permission. |
| **Picture** on mobile | Opens the mobile image picker. An enabled document-attachment flow shows **Attach** instead. |
| Model selector | Lists the Runner models available to the account. A locked model opens the relevant **Plan & Billing** path instead of selecting it. |
| **Quick commands** or **Skills** | Opens available shortcuts that can be added to the request. |
| **More actions** | Reveals composer tools that do not fit in the current layout. |
In the image-only picker, Runner ignores an image with the same name and size as one already in the draft and shows
**Duplicate image ignored**. Unsupported files are ignored with **Use a JPG, PNG, GIF, WebP, BMP,
or TIFF image**. In a mixed selection, supported images remain available. Runner accepts up to 10 attachments per message. Images can be up to 32 MB each. When document attachments are enabled, documents can be up to 10 MB each.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
English callouts highlight the controls. Select the image to enlarge it.
This workspace has document attachments enabled, so the menu shows **Attach**. Opening the menu does not upload a file or send the request.
## Add an image
1. Draft enough of the request to explain why the file matters.
2. Select **Add** on desktop, or the upload button on mobile.
3. Choose **Upload image**, **Picture**, or **Take screenshot**, depending on what is shown.
4. Pick or capture the relevant image.
5. Confirm that the correct image thumbnail appears with the draft and that any upload progress has finished.
6. Remove it before sending if it is the wrong reference.
7. Select **Send message**.
If screen capture is unavailable or permission is denied, take a screenshot with your device and
upload the saved image instead.
## Attach a document when available
1. Open **Add** and select **Attach**. If only **Upload image** or **Picture** appears, this workspace does not support documents in this composer.
2. Choose a supported file, such as a PDF, Word document, presentation, spreadsheet, or CSV.
3. Confirm the attachment appears beside your draft.
4. Tell Runner what to use from it, for example “Use the product names and descriptions in this CSV to draft collection copy; do not change prices.”
5. Select **Send message** and wait for document preparation to finish.
6. Check that Runner's answer reflects the intended document before asking for a store change.
If the file cannot be read, follow the displayed error. Password-protected, damaged, overly complex, or empty documents can fail. Use an unlocked, smaller export or paste the relevant text; keep your draft until the replacement is accepted. Videos are not supported by this attachment flow.
## Choose a model
1. Select the current model in the composer.
2. Review the models Runner makes available. The recorded interface shows **Runner 2.0 Pro**; use the label in your own selector because available profiles can change.
3. Choose the model that matches the task.
4. Confirm the selected model is shown before you send.
If a model is locked, keep the current model or follow the plan information Runner opens. A
locked choice is not applied to the draft.
## Add a skill
1. Open the composer's **Quick commands** or **Skills** control when shown.
2. Search or browse for the capability you need.
3. Select an available skill for this request. **Quick commands** can place its slash command in the composer, such as `/store-seo`; selecting it does not execute the command.
4. Return to the composer and confirm the intended skill or slash command is present. Add the task-specific instructions before sending.
5. Send the request.
The separate [Agent command palette](../agent/command-palette) manages capability state: choosing a row can install, activate, or pause a Skill. It is not the same as selecting a Skill in the composer.
When the current plan does not include a skill, Runner can open the **Agent** or upgrade path
instead. Memory choices appear only when memory is enabled for the account.
Selecting a command prepares the draft. Add your request and review it before sending.
### Watch: prepare a quick command
The recording selects **store-seo** into the composer and leaves it unsent. No SEO analysis starts.
## Troubleshooting
| Problem | What to do |
| --- | --- |
| The image is not added | Use a supported image format, keep it under 32 MB, and keep the message at 10 images or fewer. |
| **Duplicate image ignored** | The same name-and-size image is already in the draft. Keep the existing copy or remove it before selecting the image again. |
| Unsupported-file warning | Choose a JPG/JPEG, PNG, GIF, WebP, BMP, or TIFF image. If **Attach** is available, choose a supported document instead. Otherwise use an image or paste the relevant text. |
| **Take screenshot** is missing | Use a saved image; live capture is conditional. |
| Screen capture stops | Allow the browser permission when appropriate, or attach a normal screenshot. |
| A skill will not toggle | Finish any conflicting composer action and confirm that the plan includes the skill. |
| A locked model opens billing | Close the plan screen to keep the current model, or review access with the workspace owner. |
## Related guides
- [Write effective requests](/en/guides/work-with-runner/write-effective-requests)
- [Agent command palette](../agent/command-palette)
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
- [Workspace settings](/en/guides/workspace/settings)
---
# Chat with Runner
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/chat-with-runner
**What this covers:** You will send a focused request in the right store project and know what each chat control does.
Chat is the main place to ask Runner to build, change, inspect, or explain something about your
store. Keep one main outcome in each request so the result is easier to review.
**Entry path:** Open the intended store from the store-name menu → use the current task, or select **New Task** in the sidebar.
## Before you start
- Confirm the store and conversation before sending a request.
- Keep one main outcome in the draft and remove secrets or unnecessary customer data.
- Wait for a conflicting composer action to finish before selecting **Send message**.
## Chat controls
| Control | Why it is useful | What happens when you select it |
| --- | --- | --- |
| **New Task** | Separates a new task from earlier discussion. | Runner creates and opens a blank conversation. No work starts until you send a message. |
| Message box | Holds the request and any follow-up instructions. | Your text stays as a draft until you send it. |
| **Add** | Gives Runner visual context. | Opens **Upload image** or, when document attachments are enabled, **Attach**. **Take screenshot** is conditional. On mobile, the image-only picker is labeled **Picture**. See the attachment guide for supported formats and limits. |
| Profile selector | Changes the available Runner working profile. | The selected profile is used for the next request; locked choices open the relevant plan path. |
| **Voice input** | Turns speech into draft text. | Requests microphone access, shows **Listening…**, then **Processing…**, and appends the transcript to the current draft. It does not send the request. |
| **More actions** | Keeps less frequently used tools available on smaller layouts. | Opens actions such as **Voice input** or **Enhance prompt** when they do not fit in the toolbar. |
| **Send message** | Starts the request. | Your message is added to the conversation and the task begins. |
| **Stop** | Interrupts a running task. | Runner stops the current turn and preserves the conversation so you can review or continue later. |
| **Helpful** / **Not helpful** | Give feedback on a Runner response. | Opens editable feedback. **Not helpful** requires a reason or description. Nothing is saved until **Submit**; sharing conversation context is optional. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
English callouts highlight the controls. Select the image to enlarge it.
Use **Add** when the request needs a reference. The pictured menu is open before any file is uploaded or message is sent.
## Send a request
1. Confirm that the project name in the sidebar or header is the store you intend to change.
2. Choose **New Task** if the request is separate from the current conversation.
3. Enter the result you want in the message box.
4. Add important context, constraints, and reference images.
5. Select a profile or skill only when it helps this task.
6. Select **Send message**.
7. Keep the conversation open while Runner works, or return to it from **Recent Chats** later.
8. If Runner asks a question, answer it to let the task continue.
9. When the task finishes, open the affected page or tool and check the outcome you requested. A final message alone does not verify the result.
## Draft with voice input
1. Select **Voice input**. If the browser asks, allow microphone access only on a trusted device.
2. Wait for **Listening…**, then speak one focused instruction.
3. Select **Stop voice input** when you finish.
4. Keep the composer open while Runner shows **Processing…**.
5. Review the text added to the draft. Runner appends it after text that was already present.
6. Correct names, numbers, URLs, and product details before selecting **Send message**.
Voice input prepares text only. No request starts until you select **Send message**.
## While Runner is working
- A running task shows active progress in the conversation.
- **Details** opens the step-by-step task record when it is available.
- **Stop** is available during work that can be interrupted.
- The preview or other canvas tabs can update as Runner produces results.
- A waiting-for-input task needs your answer before Runner can proceed confidently.
## Troubleshooting
| What you see | What it means | What to do |
| --- | --- | --- |
| **Send message** is unavailable | The draft is empty, required input is missing, or another action is still being prepared. | Add a clear request and wait for the current composer action to finish. |
| A profile is locked | It is not included in the current plan or account access. | Keep the current profile or follow the **Plan & Billing** path Runner opens. |
| **Voice input unavailable** | The browser or device cannot record through this control. | Type the request or use a supported browser and device. |
| Microphone permission denied | The browser blocked recording. | Allow access only if appropriate, then start voice input again; otherwise type the request. |
| **No speech detected** or transcription failed | Runner did not add usable text to the draft. | Keep the existing draft, check the microphone, and retry once or type the missing text. |
| The task is waiting | Runner needs a decision or more information. | Answer the visible question, or choose **Skip**, when offered, if Runner should use its best judgment. |
| The task failed | Runner could not complete the turn. | Read the error and **Details**, then use **Try again** when offered or send a narrower follow-up. |
| You opened the wrong store | The conversation belongs to another project. | Return to the workspace, open the intended store, and start the request there. |
## Related guides
- [Write effective requests](/en/guides/work-with-runner/write-effective-requests)
- [Images, models, and skills](/en/guides/work-with-runner/attachments-profiles-and-skills)
- [When Runner asks a question](/en/guides/work-with-runner/answer-runner-questions)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
---
# Chats and History
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/chats-and-history
**What this covers:** You will keep project conversations organized and reopen the right context when you need it.
Each store has its own conversation history. Use separate chats for distinct outcomes, and keep
follow-up work in the same chat when it depends on earlier decisions.
**Entry path:** Open a store → expand its task history in the sidebar. Depending on the workspace, the list can be labeled **Store tasks** or **Recent Chats**. Search keeps the **Recent Chats** result heading.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Search your store; 2. Start a new task; 3. Open a workspace tool; 4. Reopen a saved task. Select the image to enlarge it. The numbered callouts use the English desktop interface.
## Before you start
- Confirm the current store because each project has its own conversation history.
- Let an active rename or task action finish before changing conversations.
- Keep a chat when you are unsure; deletion removes context and requires confirmation.
## Conversation controls
| Control or state | What happens |
| --- | --- |
| **New Task** | Opens a blank conversation. It does not start a task until you send a message. |
| A row in the store task history | Opens that conversation and its saved task history. |
| Activity spinner | Indicates that the conversation currently has work in progress. |
| Idle dot | Indicates that the conversation is not currently running. |
| Chat options → **Rename** | Opens a dialog where you can enter and save a clearer chat name. |
| Chat options → **Delete** | Opens a confirmation before the conversation is removed. |
## Start or reopen a chat
1. Open the correct store project.
2. Expand the sidebar and open the store task list when shown.
3. Choose **New Task** for an unrelated task, or select an existing chat to continue its context.
4. Review the conversation title and latest messages before sending new instructions.
5. Confirm that the reopened messages belong to the intended task. Enter the next request and select **Send message**.
## Rename a chat
1. Find the conversation in the current store's task history.
2. Open its options menu.
3. Choose **Rename**.
4. Enter a name that describes the outcome, such as “Update summer collection homepage.”
5. Save the change. The new name appears in the recent-chat list.
## Delete a chat carefully
1. Open the conversation's options menu.
2. Choose **Delete**.
3. Read the confirmation and verify the chat name.
4. Cancel if you still need its instructions or results. Confirm only when you intend to remove it.
## Troubleshooting
| State | What to do |
| --- | --- |
| Task history is empty or absent | Send a request in a new chat. The section appears when the project has conversation history. |
| A running chat does not open instantly | Wait for navigation to finish; Runner may protect unfinished work before changing views. |
| You cannot find a chat by scanning the list | Open project search with `Command/Control + K` and search **Recent Chats**. |
| A renamed title did not update | Reopen the chat list and try the rename once more after the current task settles. |
| You are unsure whether to delete | Keep the chat. Renaming it is the safer way to reduce confusion. |
## Related guides
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
- [Project navigation and search](/en/guides/work-with-runner/project-navigation-and-search)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
---
# Project navigation and search
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/project-navigation-and-search
The sidebar groups tools by the work you want to do. Search finds an available destination or a conversation in the current store.
**Entry path:** Open the intended store → expand the sidebar → **Sell**, **Grow**, **Measure**, or **Search**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Search your store; 2. Start a new task; 3. Open a workspace tool; 4. Reopen a saved task. Select the image to enlarge it. The numbered callouts use the English desktop interface.
## Before you start
- Confirm the store name before navigating or starting a task.
- Save a copy of an unsent draft before leaving its conversation.
- Tool availability varies with store type, plan, role, and enabled features. A visible entry can still open a prerequisite or plan screen.
## Find a destination
| Area | Available destinations can include | Use it for |
| --- | --- | --- |
| **Storefront** | Preview, editing, version history, publication | Review and update what customers see. |
| **Sell** | **Store Operations**, **Dropshipping**, **Print on Demand**, **Apps**, **Webhooks** | Set up the store, catalog, and connections. |
| **Grow** | **Ads**, **SEO**, **Email marketing**, **Automations**, **Creative Studio**, **Media Library** | Create and manage growth work and reusable media. |
| **Measure** | **Analytics**, **Experiments**, **Simulation**, **Research** | Review performance or investigate a business question. |
| **Agent** | **Skills**, **Memory** when enabled | Manage reusable instructions and retained facts. |
| **Fly**, when shown | Guided business missions | Follow the available mission workflow. |
1. Expand the group that matches your goal.
2. Select the destination.
3. Confirm its page heading and current store.
4. Follow any setup or plan message before attempting the feature.
For example, **Dropshipping** can open a dedicated sourcing experience or the related Store Operations section, depending on the store. Follow the page you actually see. The grouped navigation replaces the older **More** overflow menu.
## Search destinations and tasks
**Shortcut:** `Command + K` on macOS or `Control + K` on Windows and Linux.
1. Select **Search** or use the shortcut.
2. Enter part of a destination or task title.
3. Review results under **Control Center** and **Recent Chats**.
4. Select a **Control Center** result to open a tool, or a **Recent Chats** result to reopen a conversation.
5. Confirm the intended page or messages are visible before continuing.
6. Press `Escape` to close Search without navigating.
The **Control Center** heading belongs to Search results; it is not a separate sidebar area you need to find.
## Switch to another store
1. Open the current store-name menu at the top of the sidebar.
2. Select the intended store.
3. Confirm the new store name after navigation.
The menu also offers **Create Store** and **Workspace Settings**. It does not preview another workspace's store list. See [Workspace navigation](/en/guides/workspace/navigation-and-search) for settings and account navigation.
Search shows available destinations under **Control Center**. Select a result to navigate, or press Escape to keep the current page.
### Watch: filter navigation search
The recording types **Analytics** and inspects the matching destination. It stops before opening the result; select a result yourself to navigate.
## Troubleshooting
| What you see | What to do |
| --- | --- |
| Loading results | Wait for Search to finish loading before selecting a row. |
| **No results** | Shorten the query or use the tool's visible name. Clear the query to inspect available results. |
| **Search failed** | Select **Try again** when shown. |
| Tool is absent from its group | Check Search, then read that feature's prerequisites. Availability can differ by store. |
| Navigation pauses | Keep the task open and follow any message about unfinished work. |
| A Skill picker opens instead | Close it and use sidebar **Search**. The [Agent command palette](/en/guides/agent/command-palette) manages capabilities rather than navigation. |
## Related guides
- [Chats and history](/en/guides/work-with-runner/chats-and-history)
- [Workspace navigation and search](/en/guides/workspace/navigation-and-search)
- [Agent command palette](/en/guides/agent/command-palette)
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
---
# Task States and Details
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/task-states-and-details
**What this covers:** You will know whether a task is working, waiting, finished, interrupted, or needs another attempt.
Task states tell you what Runner needs next. The detail view and project canvas help you review
the work without guessing from the last chat message alone.
**Entry path:** Open a store project → select a conversation → inspect the current task card and
choose **Details** when available.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgDROEIVBmoeRbFHcSPrynU5Il76xY2q981Nj4)
1. Check the task status. 2. Select Details to inspect the work. This reference card shows a completed task; completion alone does not prove the storefront is published or checkout works. Select the image to enlarge it.
## Before you start
- Confirm the current conversation and latest task before acting on a state.
- Keep the visible error or waiting question available until recovery succeeds.
- Do not treat a completed task as proof that Preview, publication, or an outside provider succeeded.
## Task states
| State | Meaning | What to do next |
| --- | --- | --- |
| Running | Runner is actively working on the request. | Follow progress, open **Details**, or choose **Stop** if the task should not continue. |
| Waiting for input | Runner needs your choice or missing information. | Answer the active question or choose **Skip**, when offered, so Runner can use its best judgment. |
| Completed | Runner finished the current turn. | Review the message, details, preview, and any changed project area. |
| Failed | Runner could not finish the turn. | Read the error and details, then choose **Try again** when offered or send a narrower request. |
| Stopped | You or Runner interrupted the turn. | Review the partial work, then send a new instruction if the task should continue. |
A completed task means the conversation turn ended successfully. It does not by itself prove
that a store was published, a payment occurred, or an external service accepted a change.
## Review the work
1. Select **Details** on the task.
2. Follow the step-by-step entries to understand what Runner attempted.
3. Open **Usage** when shown to review the displayed credits, tool calls, and agent activity.
4. Review the work plan when the task includes one.
5. Use **Preview** or **Storefront** to inspect the customer-facing result.
6. Open other relevant canvas tabs, such as a file or result Runner surfaced.
7. Use **Add tab** to open another available view, and **Close tab** to remove a view from the canvas.
8. Review **Version History** when you need to compare or locate an earlier project state.
9. Compare the actual page or tool result with your requested outcome. Send a focused follow-up that names any remaining issue.
Only open the task views that Runner actually offers. The available detail and canvas views vary with the request.
## Review a storefront version from a completed work card
> **Conditional:** Version labels and historical previews require saved storefront versions and access to version cards. Older projects without saved version history can still show **Preview** on the latest storefront work card; that action opens the current live preview rather than an exact historical version. If no work-card action appears, open [Preview](/en/guides/storefront-and-publishing/preview-your-store) directly.
| Control or state | What it means or does |
| --- | --- |
| **v…** | Identifies the storefront version shown on the completed work card. |
| **Current Version** | Marks the project's latest version. |
| **Published** | Marks a version associated with a completed publication; it does not prove checkout still works. |
| **Building…** | The version is not ready to preview yet. |
| **Build failed** | The version could not reach a preview-ready state. Open **Details** and keep any visible failure context before asking Runner to fix it. |
| Storefront image or **Preview** | Opens the exact ready version when version data exists. On the latest card of an older project without version history, it opens the current live storefront preview instead. Older unmatched cards do not show **Preview**. |
| **Publish** | Appears only for an unpublished current version and opens publication checks. It is not shown for a historical or already-published version. |
| Version information is refreshing | The storefront image, **Preview**, and current-version **Publish** stay in place but are temporarily disabled. Selecting them does nothing until the refresh finishes. |
Use the version label before judging a screenshot or selecting **Publish**. A ready historical preview is still read-only until you deliberately restore or publish a current version through the available flow.
Use the version labels to distinguish the current result from earlier work. This image shows Version History, not the task Details panel, and no version was restored or published.
## Conversation controls
| Control | What happens |
| --- | --- |
| **Details** / **Hide Details** (or **Hide** in a narrow panel) | Opens the step-by-step task record in the canvas, or returns the canvas to **Storefront**. Hiding it does not remove the task record. |
| **Try again** | Starts another attempt for a failed task when the action is offered. |
| **Jump to latest message** | Moves the conversation to the newest entry. |
| Transcript outline | Lets you move to a visible section of a longer task record. |
| **Preview** or **Storefront** | Opens the project's customer-facing work view. |
| **Add tab** | Opens the list of canvas views available for this project and task. |
| **Close tab** | Removes the selected view from the canvas; it does not delete the underlying project content. |
## If progress looks stuck
- Check whether an unanswered question is waiting lower in the conversation.
- Open **Details** to identify the last completed step.
- Use **Jump to latest message** if the conversation is scrolled away from the active state.
- Do not repeatedly select **Try again** while another attempt is already running.
- If you stop a task, review partial results before asking Runner to continue.
## Related guides
- [When Runner asks a question](/en/guides/work-with-runner/answer-runner-questions)
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
- [Chats and history](/en/guides/work-with-runner/chats-and-history)
- [Understand store statuses](/en/guides/workspace/store-statuses)
- [Version history](/en/guides/storefront-and-publishing/version-history)
---
# Write Effective Requests
Source: https://www.runnerai.com/docs/en/guides/work-with-runner/write-effective-requests
**What this covers:** You will write requests that are easier for Runner to act on and easier for you to review.
A useful request describes the result, not just the topic. Give enough context to make the next
decision clear, then use follow-up messages for focused refinements.
**Entry path:** Open a store → **New Task** or the current task → message box.
## Before you start
- Confirm the store and page or workflow you want to change.
- Decide one visible outcome and any boundary Runner must preserve.
- Remove passwords, secrets, payment details, and unnecessary customer data.
## Composer controls and results
| Control | What happens after you select it |
| --- | --- |
| **More actions** | Opens less frequently used composer tools when they do not fit in the toolbar. |
| **Enhance prompt** | Generates a refined draft; it does not send the request or change the store. |
| **Accept** | Replaces the composer draft with the displayed refinement. |
| **Dismiss** | Closes the refinement and keeps the existing draft. |
| **Regenerate** | Requests another refined version. |
| **Revert to original** | Restores the earlier wording after an accepted refinement. |
| **Send message** | Adds the final draft to the conversation and starts the task. |
## A simple request structure
Include these five parts when they matter:
1. **Goal:** What should be different when the work is done?
2. **Store context:** What do you sell, and who is the customer?
3. **Current issue:** What is confusing, missing, or underperforming now?
4. **Desired result:** What should a customer be able to see or do?
5. **Boundaries:** What must stay unchanged, and what should Runner verify?
**For example:**
> Update the homepage hero for our minimalist travel-bag store. Make the carry-on collection the main focus, keep the existing navigation and product data, and make the primary action lead to that collection. Check the result on mobile and desktop before you finish.
## Send a well-scoped request
1. Start with one coherent outcome.
2. Name the page, section, product, or workflow involved.
3. Describe the customer action you want to improve.
4. Add a reference image when appearance or existing content matters.
5. State anything Runner must not change.
6. Ask for the checks you care about, such as mobile layout or a specific click path.
7. Select **Send message**.
8. Review the result, then send one focused correction at a time.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
Check the result against your request: the example asks for a slower-morning headline while keeping the layout and products. This image shows the resulting preview, not the **Enhance prompt** dialog.
## Use Enhance prompt when available
1. Draft the request in the message box.
2. Open **More actions** if **Enhance prompt** is not visible.
3. Select **Enhance prompt**.
4. Wait while the control shows **Enhancing…**.
5. Review the **Refined prompt**. Check that it preserves the intended page, customer action, and anything you asked Runner to leave unchanged.
6. Choose **Accept** to use it, **Dismiss** to keep your draft, or **Regenerate** for another version.
7. Use **Revert to original** if you accepted the refinement and want your earlier wording back.
8. Select **Send message** only after the request still matches your intent.
## Avoid ambiguous requests
| Instead of | Try |
| --- | --- |
| “Make it better.” | “Make the collection cards easier to scan on mobile, while keeping their current product links.” |
| “Fix checkout.” | “Trace the Add to cart → Cart → Checkout path and tell me where it stops before changing anything.” |
| “Copy this site.” | “Use this reference for spacing and tone, but keep our own branding, products, and navigation.” |
| A long list of unrelated changes | Start one chat for the main outcome, then create another for separate work. |
## Recovery when the result misses the goal
- Point to the exact part that is wrong.
- Describe the expected click result or visible state.
- Add a clearer reference image if the earlier one was unclear.
- Answer Runner's questions rather than repeating the full request.
- For a failed task, read **Details** before choosing **Try again**.
## Related guides
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
- [Images, models, and skills](/en/guides/work-with-runner/attachments-profiles-and-skills)
- [When Runner asks a question](/en/guides/work-with-runner/answer-runner-questions)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
---
# Workspace
Source: https://www.runnerai.com/docs/en/guides/workspace
A workspace groups stores and teammates. After sign-in, Runner can open your current store directly. Check its name before asking Runner to change anything.
**Entry path:** Sign in → current store → store-name menu or **Workspace Settings**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
English callouts highlight the controls. Select the image to enlarge it.
Start with the store-name menu to confirm where you are working.
## Choose your next task
| What you need | Guide |
| --- | --- |
| Switch stores, create another store, or review deletion | [Manage stores](/en/guides/workspace/manage-stores) |
| Understand **Live** and **Unpublished draft** | [Store statuses](/en/guides/workspace/store-statuses) |
| Find a tool, task, or settings area | [Navigation and search](/en/guides/workspace/navigation-and-search) |
| Add a teammate or change member access | [Members and invitations](/en/guides/workspace/members-and-invitations) |
| Share a referral without granting workspace access | [Invite Friends](/en/guides/workspace/invite-friends) |
| Read product and account updates | [Inbox and notifications](/en/guides/workspace/inbox-and-notifications) |
| Change workspace, store, or personal preferences | [Settings](/en/guides/workspace/settings) |
## Orient yourself after sign-in
1. Read the store name at the top of the sidebar.
2. Open its menu if you need another store or **Workspace Settings**.
3. Expand **Sell**, **Grow**, or **Measure** to find tools for the current store.
4. Use **Search** to find a tool or recent conversation.
5. Check **Storefront** when you need to confirm what is currently in Preview or live.
If the workspace is empty, follow its create-store prompt first. Completing a task, preparing a preview, and publishing the store are separate results.
## Access and settings
- Your role determines which member and workspace changes you can make.
- Store and seat limits can replace creation or invitation controls with a plan message.
- Workspace settings affect the team; sidebar **Settings** starts with the store in context; **My Settings** belongs to your account.
- **Invite Friends** is a referral. Use **Members** to give someone access to this workspace.
## Related guides
- [Build your first store](/en/guides/start-here/first-store-quickstart)
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
- [Welcome tour and daily credits](/en/guides/start-here/welcome-tour-and-daily-credits)
---
# Inbox and Notifications
Source: https://www.runnerai.com/docs/en/guides/workspace/inbox-and-notifications
**What this covers:** You will find unread updates and know what can happen when you select a notification.
The **Inbox** combines notifications across the workspaces you can access. It is different from
optional browser notifications that announce when a Runner task finishes.
**Entry path:** Desktop top bar → bell icon. On mobile, open the account or navigation menu and select **Inbox** when shown.
On desktop, the bell opens a panel beside the workspace. On mobile, it opens a bottom drawer. A
blue dot on the bell indicates that unread notifications exist.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1IjV7HprvDHKGRP0BUIpjksTZQ9oN4rSwzeq)
Start with **All** in Inbox, or choose a category such as **Release**. This image shows the category controls only.
Select the image to enlarge it. Annotations are in English.
## Before you start
- Confirm the workspace and affected project before following a notification.
- Save any unsent draft because a notification can navigate to another page or project.
- Avoid browser task notifications on a shared screen when their text may reveal work details.
## Inbox controls
| Control or state | What happens |
| --- | --- |
| **All** | Shows every available notification category. |
| **Subscription** | Filters to plan and billing-related updates. |
| **Release** | Filters to product-release updates. |
| **Event** | Filters to event notifications. |
| Notification row | Performs the action assigned to that notification, if it has one. |
| Close Inbox or change tabs | Marks notifications that were sufficiently visible as read. It does not mark every item at once. |
| Scroll to the bottom | Loads more notifications when more are available. |
The Inbox has no **Mark all as read** control and no separate retry screen for a failed
request.
## Read notifications
1. Select the bell icon.
2. Start with **All**, or choose a category.
3. Read the title, message, relative time, and unread dot.
4. Scroll when you want to load older items.
5. Select a row only after reading what action it represents.
6. Close Inbox or switch tabs when finished; visible unread items are then marked as read. Reopen the same category to check that those items no longer show an unread dot.
## What a notification click can do
Click behavior depends on the notification:
- Open a related page inside Runner.
- Open an external item, such as an invoice, in a new browser tab.
- Copy a build or pre-check error so you can paste it into a support request or Runner chat.
- Open a billing-management path for a payment issue.
- Do nothing when the notification is informational and has no action.
Read the notification before selecting it. A row does not have one universal destination.
## Empty and loading states
| State | Meaning | What to do |
| --- | --- | --- |
| Loading placeholders | Runner is retrieving notifications. | Keep Inbox open until the list settles. |
| **No notifications yet** | The selected category has no items. | Return later or try **All**. |
| **We'll let you know when something happens.** | There is no current update to act on. | Close Inbox and continue working. |
| Loading more | Older items are being retrieved after scrolling. | Wait before scrolling again. |
## Browser task-completion notifications
Some desktop browsers show a separate card in the expanded Agent sidebar:
1. Choose **Turn on** to let the browser request notification permission.
2. Allow permission only if you want system notifications for completed tasks.
3. Choose **Not now** to postpone the prompt.
4. Selecting a system notification focuses Runner and returns to the related conversation.
This feature depends on desktop browser support. Do not expect the same behavior on mobile or in
every installed-app setup. Workspace workflow-completion and store-ready messages can also appear
as temporary on-screen notices; **Preview storefront** on a store-ready notice opens its preview.
## Related guides
- [Navigation and search](/en/guides/workspace/navigation-and-search)
- [Members and invitations](/en/guides/workspace/members-and-invitations)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
---
# Invite Friends
Source: https://www.runnerai.com/docs/en/guides/workspace/invite-friends
**Invite Friends** creates a personal referral link that you can copy or share. It is separate from inviting a teammate to a workspace.
## What this covers
You will share the correct referral link, understand what the recipient sees, and avoid confusing a referral with workspace access.
## Availability and prerequisites
- You must be signed in to a workspace.
- Wait for Runner to generate the referral link before selecting a share action.
- Referral eligibility and any reward are governed by the terms shown in the panel at the time you share. Do not rely on an older amount or screenshot.
- A referral link does not add its recipient to your workspace, stores, or projects.
## Entry path
Open **Earn free credits** and choose the referral action. If your layout still shows **Invite Friends** in the sidebar, it opens the same referral flow. Runner opens a desktop panel or a mobile bottom drawer with your referral link and the currently available terms.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRvFfxwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Open **Earn free credits**, scroll to **More ways to earn**, then choose **Invite friends**. In the image: 1. Find your invite link. 2. Select **Copy link** (**Copy** in older layouts). 3. Use a social sharing option if needed. The personal link is masked; no invitation was sent. Select the image to enlarge it. The annotations use the English desktop interface.
## Share controls
| Control | What happens after you select it |
| --- | --- |
| **Copy link** / **Copy** | Copies the referral link to the clipboard. The label briefly shows **Copied**, then returns to its original text. |
| **X** | Opens X's sharing flow with the referral link prepared. |
| **Facebook** | Opens Facebook's sharing flow with the referral link prepared. |
| **LinkedIn** | Opens LinkedIn's sharing flow with the referral link prepared. |
| Close | Closes the panel without changing or invalidating the referral link. |
Social buttons open the provider's share window or tab. Review the audience and message there before posting; opening a share flow does not publish by itself.
## Share a referral
1. Open **Earn free credits**, scroll to **More ways to earn**, and select **Invite friends**.
2. Read the current eligibility and reward terms.
3. Wait until the referral link and share buttons are ready.
4. Select **Copy link** to send the link privately, or choose a social provider.
5. If you copied it, paste the entire link into the intended message and check that its invite code remains present.
6. Tell the recipient that the link is for signing up to Runner, not for joining your existing workspace.
When a recipient opens the link, Runner records the referral context and sends them to sign in or create an account. The referral context is preserved through that login step. Any resulting eligibility or credit still follows the terms shown by Runner; simply opening the link does not guarantee a reward.
## Invite a teammate instead
To give someone access to the current workspace, open the store-name menu → **Workspace Settings** → **Members** → **Invite people**. A member invitation has its own pending, cancel, and acceptance states. Do not substitute a referral link for that access flow.
## Troubleshooting
| State | Meaning and next step |
| --- | --- |
| Share actions are unavailable | Runner is still generating the link. Wait for it to finish. |
| **Copied** | The link is on the clipboard. Paste it once and verify the complete URL. |
| Social window does not open | The browser may have blocked a pop-up. Allow the share window for Runner or use **Copy** instead. |
| Link does not load | Reopen **Invite Friends** and copy the current link. If it still fails, include the visible error in a support report. |
| Recipient reaches sign-in | This is expected. Runner keeps the referral context while the recipient signs in or creates an account. |
## Related guides
- [Members and invitations](/en/guides/workspace/members-and-invitations)
- [Credits and usage](/en/guides/plans-and-billing/credits-and-usage)
- [Support and community](/en/guides/help-and-reference/support-and-community)
---
# Manage stores
Source: https://www.runnerai.com/docs/en/guides/workspace/manage-stores
Use the store-name menu to choose which store Runner should work on. Each store has its own tasks, storefront, and settings.
**Entry path:** Current store name at the top of the sidebar → store menu.
## Before you start
- Confirm the current workspace and store before creating or removing anything.
- Keep a copy of an unsent request before switching stores.
- Your workspace plan controls how many stores you can create.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
English callouts highlight the controls. Select the image to enlarge it.
Open this menu to choose a store or start **Create Store**. Check the name again after switching.
## Store controls
| Control | What happens |
| --- | --- |
| Current store name | Opens the store menu. |
| Another store name | Opens that store and its tasks. |
| **Create Store** | Opens the creation dialog; a plan message can appear if you have reached the store limit. |
| **Workspace Settings** | Opens settings for the workspace, rather than the store. |
| Sidebar **Settings** | Opens settings for the current store. |
| Store **General** → **Delete Store** | Opens the removal confirmation. Review the named store before proceeding. |
## Open an existing store
1. Select the current store name at the top of the sidebar.
2. Find the store you intend to work on.
3. Select its name and wait for navigation to finish.
4. Confirm the new store name in the sidebar.
5. Open its current task or **Storefront** to check that you are in the right project before sending instructions.
If your account opens an empty workspace instead, use its creation prompt. A workspace with no stores has nothing to switch to yet.
## Create another store
1. Open the store-name menu and select **Create Store**.
2. Choose the available store type. Use the Runner creation path for a new store, or **Connect Shopify** for an existing Shopify shop when offered.
3. Enter the required **Store Name** and complete that path.
4. Wait for Runner to open the project.
5. Confirm the new name appears in the store menu. Creation does not publish the store.
Follow [Create a Runner store](/en/guides/start-here/create-runner-store) or [Connect Shopify](/en/guides/start-here/connect-shopify) for the full walkthrough.
## Review a store deletion
1. Switch to the store you intend to remove.
2. Open sidebar **Settings** and the store's **General** section.
3. Find **Delete Store** and read the confirmation.
4. Verify the store name and the listed consequences.
5. Cancel if you need to keep the store. Enter the required store name and confirm only when you intend to delete it.
6. After a confirmed deletion, check that the store is no longer available in the active store list.
Deletion is destructive. Use a different store from the menu if you only wanted to switch projects.
## Troubleshooting
| What you see | What to do |
| --- | --- |
| Store list is loading | Wait before selecting or creating another store. |
| A store is missing | Confirm your workspace membership and the workspace you opened. Do not create a duplicate just because the list has not loaded. |
| Creation opens an upgrade path | Review the current [public plans](https://www.runnerai.com/pricing) or ask the workspace owner about capacity. |
| Creation returned an error | Check whether a new store already appears before starting another attempt. |
| Store settings are unavailable | Confirm the selected store and your role. Ask a workspace owner or admin for access. |
| Renewal screen | Reactivate the workspace if authorized, or use another workspace you can access. |
## Related guides
- [Store statuses](/en/guides/workspace/store-statuses)
- [Navigation and search](/en/guides/workspace/navigation-and-search)
- [Workspace settings](/en/guides/workspace/settings)
- [Chat with Runner](/en/guides/work-with-runner/chat-with-runner)
---
# Members and Invitations
Source: https://www.runnerai.com/docs/en/guides/workspace/members-and-invitations
**What this covers:** You will invite the right teammate and understand which member actions your role allows.
The **Members** page shows active members and pending invitations for the selected workspace.
Team invitations are separate from the **Invite Friends** referral link available through **Earn free credits**.
**Entry path:** Store-name menu → **Workspace Settings** → **Members**.
## Before you start
- Confirm the workspace and intended email address.
- Review seat capacity and search for an existing member or pending invitation first.
- You need owner or admin permissions for member-management actions. Invitation management also requires a plan with team seats: **Max**, or AppSumo License Tier 2, 3, or 4. AppSumo License Tier 1 is a single-seat plan. Follow the plan gate when shown.
## Members page controls
| Control or value | What it means or does |
| --- | --- |
| **Search members** | Filters visible rows by a member's name or email. |
| Seats used | Shows current members against workspace capacity. Pending invitations also affect whether another invite is allowed. |
| **Invite people** | Opens the invitation form for eligible workspace owners and admins. |
| Email field | Accepts the teammate's email address. There is no role selector in the invitation form. |
| **Send invite** | Sends the invitation after the email is valid and a seat is available. |
| **Active** | The person has joined the workspace. |
| **Pending** / **Not yet joined** | The invitation has not been accepted. |
| **Cancel** | Immediately cancels a pending invitation without another confirmation. |
| **Remove** | Opens a confirmation before an authorized owner or admin removes another member. |
| **Leave** | Opens a confirmation before you leave the workspace. |
## Invite a teammate
1. Confirm the workspace name in settings.
2. Open **Members**.
3. Review seats used and search for the email to avoid a duplicate invitation.
4. If your role and plan allow it, select **Invite people**.
5. Enter a valid email address.
6. Select **Send invite**.
7. Look for **Invitation sent** or **Invitation re-sent**.
8. Confirm that the person appears as **Pending**.
The invitation does not add the person until they open the link with the correct account and
choose **Join**. Invitation links can show already accepted, cancelled, expired, wrong-account,
seat-full, or other error states. Runner does not promise a fixed invitation lifetime here.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgXczT28QoDHrCtKfBidSYNn5cVvw1O6jUa09M)
English callouts highlight the controls. Select the image to enlarge it.
Enter your teammate’s email in this form. The screenshot shows a blank invitation; no invitation has been sent.
## Accept an invitation
1. Open the invitation link from the email addressed to you.
2. Sign in with the same email address that received the invitation.
3. Confirm the inviter and workspace name shown on the page.
4. Select **Join _workspace name_**.
5. Wait for **Joined _workspace name_** and confirm Runner opens that workspace.
Selecting **Join** adds your account to the workspace; it does not create a separate store or
change another member's role. If Runner shows **Wrong account**, select **Sign in as** followed by the invited
address, then finish signing in with that address. If it shows **Workspace is full**, select **Got it** and ask the inviter
to free a seat or update the plan before using the same link again.
## Change a member's role
1. Find the intended member on **Members**.
2. Open the row's **Role** menu when your permissions allow it.
3. Select the intended role and wait for the update.
4. Confirm that the row displays the new role.
Owners can assign owner, admin, or member roles. Admins can manage admins and members, but cannot change an owner or grant ownership. The invitation form has no role selector; review roles after the teammate joins.
## Manage access carefully
### Cancel a pending invitation
1. Search for the pending email.
2. Select **Cancel** only when you intend to invalidate that invitation.
3. Verify that the pending row no longer appears.
Selecting **Cancel** invalidates the pending invitation without a second confirmation.
### Remove a member or leave
1. Find the correct member row.
2. Select **Remove**, or select **Leave** on your own row.
3. Read the confirmation, including the loss of access to workspace projects.
4. Cancel if access should remain.
5. Confirm only when the workspace and person are correct.
An owner cannot be removed from the owner row in the interface. Member-management actions
also follow role hierarchy, so a visible or attempted action can still be rejected when your role
does not permit it.
## Troubleshooting
| State | What to do |
| --- | --- |
| **Invite people** is absent | Check that the workspace is on Max or AppSumo License Tier 2-4, and ask a workspace owner or admin to send the invitation. |
| Seat capacity is reached | Resolve an unused pending invite or ask the owner to review the workspace plan. |
| Email is rejected | Check the complete address and correct any formatting error. |
| Invitation belongs to another account | Sign in with the invited email before choosing **Join**. |
| Invitation is expired or cancelled | Ask a workspace owner or admin to send a new invitation. |
| **Workspace is full** | Ask the inviter to free a seat or update the workspace plan, then try the link again. |
| **Invitation already accepted** | Select **Go to Runner AI** and open the workspace from your workspace switcher. |
| Search shows no result | Clear or shorten the search, then verify the selected workspace. |
## Related guides
- [Workspace settings](/en/guides/workspace/settings)
- [Navigation and search](/en/guides/workspace/navigation-and-search)
- [Inbox and notifications](/en/guides/workspace/inbox-and-notifications)
---
# Navigation and search
Source: https://www.runnerai.com/docs/en/guides/workspace/navigation-and-search
Start by checking the store name. The sidebar tools act on that store; workspace and personal settings have separate entries.
**Entry path:** Open a store → expand the sidebar, or open the navigation menu on mobile.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Search your store; 2. Start a new task; 3. Open a workspace tool; 4. Reopen a saved task. Select the image to enlarge it. The numbered callouts use the English desktop interface.
## Before you start
- Save a copy of an unsent request before switching stores or tasks.
- Available destinations depend on store type, role, plan, and enabled features.
## Find the right scope
| Where to look | What you can do |
| --- | --- |
| Store name at the top of the sidebar | Switch stores, open **Create Store**, or open **Workspace Settings**. |
| **Storefront** | Review the current store's pages and publication state. |
| **Sell**, **Grow**, and **Measure** | Expand grouped tools for store operations, growth, and reporting. |
| **Agent** | Manage the store's available Skills and Memory. |
| Sidebar **Settings** | Open settings with the current store in context. |
| Top-right bell | Open **Inbox** on desktop. On mobile, use the **Inbox** entry when offered in the menu. |
| Top-right avatar → **My Settings** | Open personal account preferences. |
| **Earn free credits** | Review available reward and referral actions. |
## Switch stores
1. Select the store name at the top of the sidebar.
2. Select the store you need from the list.
3. Wait for its page to open.
4. Confirm the new store name before selecting **New Task** or changing settings.
The store menu lists stores in its workspace. The current Settings sidebar does not expose **Workspaces**. Use a workspace-switching entry only when Runner presents one, then open **Settings → Workspace General** and confirm the workspace name. See [Settings](/en/guides/workspace/settings) for the scope controls.
## Find a tool or task
1. Select **Search** in the project sidebar, or press `Command/Control + K`.
2. Type a visible destination name, such as `Storefront`, or part of a task title.
3. Choose a result under **Control Center** for a tool, or **Recent Chats** for a conversation.
4. Confirm that the selected page or task opens in the intended store.
5. Press `Escape` to close search if you do not want to navigate.
[Project navigation and search](/en/guides/work-with-runner/project-navigation-and-search) lists the tool groups and search recovery states. Search navigates; it does not start work on the selected tool.
Search shows available destinations under **Control Center**. Select a result to navigate, or press Escape to keep the current page.
### Watch: filter navigation search
The recording types **Analytics** and inspects the matching destination. It stops before opening the result; select a result yourself to navigate.
## Troubleshooting
| Problem | What to do |
| --- | --- |
| Sidebar labels are hidden | Expand it, or open the mobile navigation menu. |
| A destination is missing | Expand the relevant group, try Search, then check the feature's prerequisites. |
| A store is missing | Confirm the workspace and your membership before creating another store. |
| Search finds nothing | Clear the query and use the current visible tool label. |
| A link opens another browser tab | Return to Runner after reading it; opening a resource does not switch stores. |
## Related guides
- [Manage stores](/en/guides/workspace/manage-stores)
- [Project navigation and search](/en/guides/work-with-runner/project-navigation-and-search)
- [Inbox and notifications](/en/guides/workspace/inbox-and-notifications)
- [Workspace settings](/en/guides/workspace/settings)
---
# Workspace Settings
Source: https://www.runnerai.com/docs/en/guides/workspace/settings
**What this covers:** You will open the correct settings area and know which changes affect a workspace, store, or only your account.
Settings are grouped by scope. Confirm the workspace and store names before changing access,
billing, domains, scripts, or deletion controls.
**Entry paths:**
- Store-name menu → **Workspace Settings** opens workspace settings.
- Top-right user avatar → **My Settings** opens personal settings.
- Sidebar → **Settings** opens settings with the current store in context.
## Before you start
- Confirm the workspace and, for store settings, the **Store: _store name_** group.
- Wait for any **Saving** state before leaving the page.
- Read the final confirmation before access, billing, domain, script, or deletion changes.
## Important controls and results
| Control | What happens after you select it |
| --- | --- |
| **Name** or **Description** | Saves a valid workspace change automatically after editing stops. |
| **Workspace General** | Opens details for the workspace named in the settings sidebar. |
| **Delete Workspace** | Opens a destructive confirmation that requires the complete workspace name. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
English callouts highlight the controls. Select the image to enlarge it.
The workspace group and **Store** group have separate settings. Confirm the named scope before editing.
## Settings sections
| Scope | Sections currently shown | Notes |
| --- | --- | --- |
| Workspace | **Workspace General**, **Members**, **Plan & Billing**, **Usage & Credits** | Member roles control which changes succeed. |
| Store project | **Store General**, **Domain**, **Custom Scripts**, **Agent** | **Experiments** appears only when enabled. Project sections appear only with a store in context. |
| Personal | **My Settings**, and **API Keys** when enabled | Personal changes and API keys belong to your account. |
## Update workspace details
1. Open **Settings → Workspace General**.
2. Confirm the workspace name at the top of the settings panel.
3. Edit **Name** or **Description**.
4. Watch the save state change from **Saving** to **Saved**.
5. Keep the panel open until the save finishes.
These fields save automatically. An empty or invalid name is not saved. If saving fails, Runner
can restore the last server value and show an error. The workspace description accepts up to the
limit displayed by the field, currently 500 characters.
Updating workspace details requires sufficient workspace permission. Deleting a workspace is an
owner action even if another role can see part of the settings interface.
## Switch settings context
1. Open **Settings** and read the workspace and store names in its sidebar.
2. Select **Workspace General** for workspace details or **Store General** for the current store.
3. Select **My Settings** for personal preferences.
The current sidebar does not expose a **Workspaces** list. Use a workspace-switching or creation entry only when Runner presents one; do not look for it under **My Settings**. To leave a workspace, follow [Members and invitations](/en/guides/workspace/members-and-invitations).
## Delete a workspace carefully
1. Open **Settings → Workspace General**.
2. Find **Delete Workspace**.
3. Read the confirmation and affected workspace name.
4. Enter the complete workspace name only when it is the intended target.
5. Cancel if any store, conversation, member access, or workspace data should remain available.
The only workspace cannot be deleted from the interface.
## Access states and troubleshooting
| State | Meaning | What to do |
| --- | --- | --- |
| **Saving** | Runner is storing an automatic change. | Keep the settings panel open. |
| **Saved** | The latest valid field change was accepted. | Continue or close settings. |
| Save error and old value returns | The change was not accepted. | Correct the value, confirm your permission, and try once more. |
| **Create your first workspace** | Your account has no available workspace. | Use the creation action to continue. |
| **Workspace access denied** | Your account cannot open that workspace. | Choose **Go to your workspace**. |
| Renewal screen | The workspace is not active. | Choose **Renew Plan** if authorized, or switch workspaces. |
| A section is missing | It is unavailable for the current role, project context, plan, or feature access. | Confirm the context and ask the workspace owner when necessary. |
## Related guides
- [Members and invitations](/en/guides/workspace/members-and-invitations)
- [Manage stores](/en/guides/workspace/manage-stores)
- [Navigation and search](/en/guides/workspace/navigation-and-search)
- [Images, models, and skills](/en/guides/work-with-runner/attachments-profiles-and-skills)
---
# Store statuses
Source: https://www.runnerai.com/docs/en/guides/workspace/store-statuses
The store summary tells you whether a public version exists. Open **Storefront** to check whether your latest change is part of that version.
**Entry path:** Current store name and summary → **Storefront**.
## Read the summary
| Label | What it tells you | What to check next |
| --- | --- | --- |
| **Unpublished draft** | The store does not have a published version to use as its live storefront. | Review the current preview and prepare its first publication. |
| **Live** | A public storefront exists. | Open the public URL and confirm the intended changes are visible. |
| **Current Version** in the storefront | This is the latest project version. | Compare it with the published version before assuming it is live. |
| **Published** on a version | That version is associated with a completed publication. | Verify the public page and checkout separately. |
Older store-card layouts can use **Drafted**, **Deploying**, and **Published**. Read **Deploying** as an in-progress operation and wait for its result. A live or published label can still refer to an older successful version after a later attempt fails.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
English callouts highlight the controls. Select the image to enlarge it.
This is the current project preview. Use its version and publication controls to compare it with the live store; a visible preview alone does not make it public.
### Video: A storefront still in draft
The recording opens Storefront on a store whose site has never been built, so the tab offers the customize step rather than a published address. It shows what a draft status looks like in this tab; it does not build, preview, or publish a storefront.
## Verify a recent change
1. Confirm the current store name.
2. Open the task that requested the change and review its latest status and **Details**.
3. Open **Storefront** and confirm the expected change in the current ready preview.
4. Check whether that version was published.
5. If it was, open the public URL and repeat the relevant customer action.
You have verified the change only when the intended version and its visible result agree. Task completion alone does not prove a preview, publication, payment, or provider action succeeded.
## If the summary seems wrong
- Let any active publication finish before starting another attempt.
- Refresh the current view once and read the latest publication result.
- Compare the current and published versions in [Version history](/en/guides/storefront-and-publishing/version-history).
- If the public store still shows older content, review the newer preview before using **Publish Changes**.
- If publication failed, follow the named error instead of repeating the same action.
## Related guides
- [Manage stores](/en/guides/workspace/manage-stores)
- [Task states and details](/en/guides/work-with-runner/task-states-and-details)
- [Publish and republish](/en/guides/storefront-and-publishing/publish-and-republish)
- [Verify the live store and checkout](/en/guides/storefront-and-publishing/live-store-and-checkout)
---
# Acceptable Use Policy
Source: https://www.runnerai.com/docs/en/legal/aup
## Runner AI Acceptable Use Policy
This Acceptable Use Policy ("AUP") is issued by Adaptive Machines, Inc. ("Runner AI", "we", "us") and governs your use of the Runner AI services.
**The main rule for using Runner AI is: You are responsible for following the law, the rules of your partners, and your agreements with us.**
These are the principles behind our expectations in more detail:
## You can't use Runner AI to do anything that's illegal where you do business
We understand laws and regulatory frameworks can be complex, but in choosing a market to enter and products to sell, you, the merchant, are making a commitment to take that market seriously, and we trust and expect you to understand applicable boundaries. You must likewise respect that certain business activities are not supported by our platform, such as uploading Protected Health Information subject to HIPAA.
## You should Uphold Platform Integrity and Safety
We are committed to maintaining a safe and trustworthy commercial environment. Activities that harm the integrity of our platform or the safety of our users are strictly prohibited. This includes, but is not limited to:
### Illegal and Regulated Goods
Selling counterfeit goods, illegal drugs, weapons, or any other products that are illegal in your jurisdiction or your customers'.
### Intellectual Property Infringement
Violating the intellectual property rights of others, including copyrights and trademarks.
### Hate, Violence, and Harmful Content
Selling products or publishing content that promotes hatred, discrimination, violence, or facilitates intentional self-harm.
### Fraud and Deception
Engaging in deceptive marketing, financial scams, or any other fraudulent activities.
### Platform Abuse
Sending spam, distributing malware, or attempting to disrupt our services.
## Specific Rules Regarding AI Features
Your use of any artificial intelligence features within Runner AI ("AI Features") is subject to the following additional terms:
### a. Responsibility for Input
You are solely responsible for all text, data, and information you provide to the AI Features ("Input"). You agree not to provide any Input that is illegal, infringes on third-party rights, or contains sensitive personal information.
### b. Accuracy and Responsibility for Output
The content generated by the AI Features ("Output") may contain errors. You must independently review and verify all Output before publishing or relying on it. Runner AI is not liable for any damages resulting from your use of the Output.
### c. Prohibited Uses of AI Features
You may not use the AI Features to generate deceptive content, create hateful or harassing content, or produce spam.
## You need to follow our agreements with you
While we don't want to burden you with a lot of paperwork, our Terms of Service are important for how we operate. Our agreements bind you as a merchant and explain the platform rules you must follow.
Runner AI offers a range of products and services that leverage partnerships with other organizations. When you use one of these products, you are interacting with an entire supply chain of businesses. Runner AI involves an ecosystem of processors working together. If you use these services, you need to respect how the supply chain works and what terms are asked of you.
## The most common product eligibility disputes originate from outside of Runner AI
We are a commerce platform: most product eligibility or takedown disputes that entrepreneurs may encounter originate from outside Runner AI, including from regulators and third-party IP rights holders. In these circumstances, we'll give you notice and tools to self-manage your risks and disputes when appropriate.
## We expect you to act in good faith. If you don't, account-level action may be appropriate
We don't like to see people try to "game" systems to avoid constraints they don't agree with. We also don't tolerate anyone defrauding Runner AI, other merchants, or buyers, using our platform to send spam, or for other malicious practices. In those cases, while we try to minimize impact to business as a first-order principle, account-level action is oftentimes more appropriate.
When you build on Runner AI with these principles in mind, we will give you notice, grant you opportunities to self-remediate conflicts, default to enforcement at the product level, and take account-level action as a last resort when appropriate. Finally, as with all great products, we expect to iterate on and update these principles from time to time.
If you believe a Runner AI user is violating this Acceptable Use Policy, you can contact Runner AI Support via email at support@adaptivemachines.ai.
---
# Cookie Policy
Source: https://www.runnerai.com/docs/en/legal/cookies
## Runner AI Cookie Policy
This Cookie Policy explains how Adaptive Machines, Inc. ("Runner AI", "we", "us", or "our") uses cookies and similar technologies on our website (runner.ai) and the services we provide to our merchants (collectively, the "Services"). It explains what these technologies are and why we use them, as well as your rights to control our use of them. This policy should be read in conjunction with our main [Privacy Policy](/en/legal/policies).
## What are cookies?
A cookie is a small amount of information that's downloaded to your computer or device when you visit certain websites. We use a number of different cookies on the Runner AI website, including strictly necessary, performance, advertising, and social media or content cookies. Cookies make your browsing experience better by allowing the website to remember your actions and preferences (such as login and region selection). This means you don't have to re-enter this information each time you return to the site or browse from one page to another. Cookies also provide information on how people use the website, for instance whether it's their first time visiting or if they are a frequent visitor. Read more about cookies (and other similar tracking technologies) and how we use the data collected through these technologies, in our [Privacy Policy](/en/legal/policies).
## Cookies on Merchant Stores
This section is important for both merchants using our platform and visitors to their stores.
**For Visitors to Merchant Stores:** When you visit a merchant's store powered by Runner AI, that merchant is the Data Controller of your information. This means the merchant decides which cookies to use on their store, especially for analytics and advertising (e.g., Google Analytics, Facebook Pixel). Runner AI acts as a Data Processor, placing cookies that are strictly necessary for the core functionality of the store (e.g., shopping cart, checkout). Any questions about a merchant's privacy practices should be directed to the merchant themselves.
**For Merchants:** As a merchant using Runner AI, you are the Data Controller for your customers' data. You are responsible for complying with all applicable privacy laws, including informing your customers about the cookies you use (including those from third-party apps you install) and obtaining valid consent where required. While Runner AI provides the platform, you are responsible for the specific configuration of your store's privacy settings and policies.
## What cookies do we use and why?
### Necessary Cookies
Some cookies are necessary to allow you to browse our website, use its features, and access secure areas. The use of these cookies is essential for the website to work. For example, we use user-input cookies for the duration of a session to keep track of their input when filling in forms that span several pages.
### Functional Cookies
We also use functional cookies to remember choices you've made or information you've provided, such as your username, language, or the region you are in. This allows us to tailor your website experience specifically to your preferences. For example, authentication cookies are functional cookies that are used for the duration of a session (or persistent, if you agree to the "remember me" function) to allow users to authenticate themselves on subsequent visits or to gain access to authorized content across pages. The functional cookies we use include:
- **User-centric security cookies:** To detect authentication abuses for a limited persistent duration, like repeated failed login attempts.
- **Multimedia content player session cookies (flash cookies):** Used for the duration of a session to store technical data needed to play back video or audio content.
- **Load balancing session cookies:** Used for the duration of the session to identify the same server in the pool in order for the load balancer to redirect requests appropriately.
- **User interface customization persistent cookies:** Used to store a user's preference regarding a service across web pages.
### Performance Cookies
Runner AI is dedicated to optimizing user experience and we use many tools to help us improve our website and our commerce platform. To this end, we use reporting and analytics cookies to collect information about how you use our website or our merchants' storefronts, and how often. The performance cookies we use include:
- **First party analytics cookies:** We use these cookies to estimate the number of unique visitors, to improve our websites and our merchants' websites, and to detect the most searched for words in search engines that lead to a webpage.
- **Third party analytics cookies:** We also use Google Analytics and other third-party analytics providers listed below to help measure how users interact with our website content.
### Advertising Cookies
Advertising cookies are used on our website to tailor marketing to you and your interests and provide you with a more personalized service in the future. These cookies remember that you visited our website and we may share this information with third-parties, such as advertisers. Without these cookies, the advertisements that you see may be less relevant and interesting to you.
### Social Media and Content Cookies
Social media and content cookies are placed by many social media plugins (for example the Facebook 'like' button), and other tools meant to provide or improve the content on a website (for example services that allow the playing of video files, or that create comments sections). We integrate these modules into our platform to improve the experience of browsing and interacting with our websites.
## Merchant Storefronts
When merchants use our platform to power their online stores, we place the following cookies for visitors of their stores.
### Cookies Necessary for the Functioning of the Store
| Name | Description | Duration |
|------|-------------|----------|
| \_medusa\_jwt | Visitor login credential | 7d |
## Third-Party Cookies
Additionally, we use pixels and tags from the following third parties, which may in turn place cookies.
### Cookies Necessary for the Functioning of the Sites
| Third Party | Description | Privacy Policy |
|-------------|-------------|----------------|
| Vercel | We use Vercel for edge routing. | [https://vercel.com/legal/privacy-policy](https://vercel.com/legal/privacy-policy) |
| Intercom | We use Intercom for customer service. | [https://www.intercom.com/legal/privacy](https://www.intercom.com/legal/privacy) |
| Chatwoot | We use Chatwoot, which we host ourselves at support.runnerai.com, for customer service. It sets `cw_conversation` to keep your chat conversation across pages and visits, `cw_user_` to remember which chat contact your browser belongs to when you are signed in, and `cw_snooze_campaigns_till` to hold back chat campaign messages for one hour after you read one. `cw_conversation` and `cw_user_` last one year. | [Privacy Policy](/en/legal/policies) |
### Reporting & Analytics
| Third Party | Description | Privacy Policy |
|-------------|-------------|----------------|
| Google Analytics | We use Google Analytics to help measure how users interact with our websites. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Google Tag Manager | We use Google Tag Manager to help manage analytics vendors. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| PostHog | We use PostHog to do data analytics. | [https://posthog.com/privacy](https://posthog.com/privacy) |
### Advertising
| Third Party | Description | Privacy Policy |
|-------------|-------------|----------------|
| Facebook Pixel | We use Facebook Pixel to help measure how users interact with our websites. | [https://www.facebook.com/privacy/explanation](https://www.facebook.com/privacy/explanation) |
| Google Ads | We use Google Ads to deliver targeted advertisements to individuals who visit our websites. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Instagram | We use Instagram to deliver targeted advertisements to individuals who visit our websites. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| TikTok | We use TikTok to help measure how users interact with our websites. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Twitter | We use Twitter to help measure how users interact with our websites. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube | We use YouTube to deliver targeted advertisements to individuals who visit our websites. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Reddit | We use Reddit to help measure how users interact with our websites. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Pinterest | We use Pinterest to help measure how users interact with our websites. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Whatsapp | We use Whatsapp to help measure how users interact with our websites. | [https://www.whatsapp.com/legal/privacy-policy](https://www.whatsapp.com/legal/privacy-policy) |
### Social Media & Content
| Third Party | Description | Privacy Policy |
|-------------|-------------|----------------|
| Facebook Connect | We use Facebook Connect to allow visitors to our website to interact with and share content via Facebook's social media platform. | [https://www.facebook.com/policy.php](https://www.facebook.com/policy.php) |
| Instagram CDN | We use Instagram CDN to provide content to user. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| Twitter CDN | We use Twitter to allow visitors to our website to interact with and share content via Twitter's social media platform. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube CDN | We use YouTube CDN to provide content to user. | [https://policies.google.com/privacy?hl=en](https://policies.google.com/privacy?hl=en) |
| Tiktok CDN | We use Tiktok CDN to provide content to user. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Reddit CDN | We use Reddit CDN to provide content to user. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Linkedin CDN | We use Linkedin CDN to provide content to user. | [https://www.linkedin.com/legal/privacy-policy](https://www.linkedin.com/legal/privacy-policy) |
| Pinterest CDN | We use Pinterest CDN to provide content to user. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Rednote CDN | We use Rednote CDN to provide content to user. | [https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1](https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1) |
## How long will cookies remain on my computer or mobile device?
The length of time that a cookie remains on your computer or mobile device depends on whether it is a "persistent" or "session" cookie. Session cookies last until you stop browsing and persistent cookies last until they expire or are deleted. Most of the cookies we use are persistent and will expire between 30 minutes and two years from the date they are downloaded to your device. See the section below on how to control cookies for more information on removing them before they expire.
## How to control cookies?
You can control and manage cookies in various ways. Please keep in mind that removing or blocking cookies can negatively impact your user experience and parts of our website may no longer be fully accessible.
Most browsers automatically accept cookies, but you can choose whether or not to accept cookies through your browser controls, often found in your browser's "Tools" or "Preferences" menu. For more information on how to modify your browser settings or how to block, manage or filter cookies can be found in your browser's help file or through such sites as: [www.allaboutcookies.org](https://www.allaboutcookies.org).
Many of the third party advertising and other tracking services listed above offer you the opportunity to opt out of their tracking systems. You can read more about the information they collect and how to opt out through the privacy policy links listed above.
---
# Data Processing Addendum
Source: https://www.runnerai.com/docs/en/legal/dpa
## Runner AI Data Processing Addendum
### I. PURPOSE
This Runner AI Data Processing Addendum ("DPA") supplements and is incorporated by reference into the Runner AI Terms of Service, together with any terms applicable to any additional Runner AI services that you choose to use (the "Terms") by and between You (or "Merchant"), and Adaptive Machines, Inc. ("Runner AI" "we", "us", "our"), which outlines the specific business purposes and services related to this DPA. In case of any conflict between the Terms and this DPA, the DPA shall prevail with respect to the processing of Your Customer Personal Data, as defined below.
You and Runner AI (each a "Party", together the "Parties"), agree that this DPA sets forth the Parties' obligations governing the processing of Your Customer Personal Data. You shall act as a Data Controller and Runner AI shall act as a Data Processor with respect to the processing of Your Customer Personal Data, in connection with Your use of our Services that rely on our processing of Your Customer Personal Data, except for the services described in Appendix E.
Where the processing of Personal Data under this DPA is subject to data protection requirements in the European Economic Area (the "EEA"), the United Kingdom (the "UK") or Switzerland, and Runner AI acts as a Data Processor, Appendix C supplements this DPA. In case of any conflict between Appendix C and other sections of this DPA, Appendix C shall prevail with respect to the processing of Your Customer Personal Data subject to EEA, UK and Swiss data protection requirements. For the avoidance of doubt, Appendix C shall not apply to the processing activities described in Appendix E.
Where the processing of Personal Data under this DPA is subject to U.S. Data Protection Laws, and Runner AI acts as a Data Processor or Service Provider, Appendix D supplements this DPA. In case of any conflict between Appendix D and other sections of this DPA, Appendix D shall prevail with respect to the processing of Your Customer Personal Data subject to U.S. Data Protection Laws. For the avoidance of doubt, Appendix D shall not apply to the processing activities described in Appendix E.
If you receive Enhanced Services from Runner AI (as defined in Section 9 of the Terms of Service) Runner AI shall process Your Customer Personal Data as a Data Controller or Business as set forth in Appendix E. In case of any conflict between Appendix E and other sections of this DPA, Appendix E shall prevail with respect to Runner AI's processing of Your Customer Personal Data as a Data Controller or Business.
### II. DEFINITIONS
Capitalized terms used but not defined in this DPA shall have the same meaning given to them in the Terms:
**A. Applicable Data Protection Law(s):** Any data protection or privacy laws applicable to Runner AI's processing of Personal Data under the Terms, their implementing regulations and secondary legislation, each as may be amended, updated or replaced from time to time, including such laws that apply based on the location or residence of Merchant and/or Your Customer(s).
**B. Customer:** An individual or entity that visits, engages with, and/or purchases a product, good, or service from Your Store(s).
**C. Data Rights Request:** A valid and lawful request by an individual to exercise available rights pertaining to Personal Data under an Applicable Data Protection Law.
**D. Data Controller or Business:** The Party that determines the purposes and means of the processing of Personal Data, or as otherwise defined under any Applicable Data Protection Law.
**E. Data Processor or Service Provider:** The Party or other entity or business that provides services on behalf of and processes Personal Data at the direction and on behalf of the Data Controller or as defined under any Applicable Data Protection Laws.
**F. Personal Data:** Information or data defined as 'personal data,' 'personal information,' or 'personally identifiable information' (or analogous term) under Applicable Data Protection Laws.
**G. Personal Data Breach:** In relation to Your Customer Personal Data, shall be interpreted in accordance with Applicable Data Protection Laws.
**H. "Process," "processes," or "processing":** (a) Any operation or set of operations which is performed on Personal Data or on sets of Personal Data, whether or not by automated means, such as collection, recording, organization, structuring, storage, adaptation or alteration, retrieval, consultation, use, disclosure by transmission, dissemination or otherwise making available, alignment or combination, restriction, erasure or destruction; or (b) the definition given to such term(s) under the Applicable Data Protection Law(s).
**I. "Subprocessor(s)":** Affiliated companies or third-party Data Processors or Service Providers that may process Personal Data at Runner AI's direction for the purpose of providing the Services.
**J. "You," "Your," or "Merchant":** Means each business that You operate and that uses or benefits from the Services, the Enhanced Services or other Additional Services and is a Party to the Terms with Runner AI.
**K. "Your Customer Personal Data":** Personal Data from or about Your Customers excluding any Personal Data about Customers that Runner AI receives as a result of the Customer's relationship with Runner AI, which is governed by Runner AI's Consumer Privacy Policy and not this DPA.
### III. NATURE OF THE PROCESSING AND ROLES OF THE PARTIES
**Runner AI as a Data Processor or Service Provider.** Runner AI receives and processes Your Customer Personal Data in order to provide You with the Services and as otherwise set forth below. Depending on which of the Services You request or use, Runner AI will process the categories of Personal Data set forth at Appendix A, in the manner and on the bases contained therein.
Runner AI shall process Your Customer Personal Data as a Data Processor or Service Provider only to provide the Services instructed in the Terms and any supplemental Terms and as necessary to provide, develop, and improve its Services and engage in any other purposes permitted by Applicable Data Protection Laws.
**Runner AI as a Data Controller or Business.** Runner AI shall process Your Customer Personal Data as a Data Controller or Business (a) in the circumstances and manner set forth in Appendix E, and (b) for any additional purposes compatible with Customer's instructions and Applicable Data Protection Law.
### IV. OBLIGATIONS OF PARTIES
The following section describes the Parties' respective obligations with respect to the processing of Personal Data covered by this DPA.
#### A. General Compliance
1. The Parties will comply with their respective obligations under Applicable Data Protection Laws.
2. Runner AI shall have no obligation to interpret or advise You on Your obligations under Applicable Data Protection Laws, including with respect to the processing of Personal Data covered by this DPA. You are solely responsible for determining Your legal and regulatory obligations, including evaluating whether the technical and organizational measures of the Services are consistent with Your independent legal and regulatory obligations.
#### B. Runner AI's Obligations
##### 1. Data Security
Runner AI will implement and maintain appropriate technical and organizational measures designed to protect Your Customer Personal Data against unauthorized or unlawful processing and against accidental loss, destruction, damage, theft, alteration, or disclosure, as set forth in Appendix B.
##### 2. Personal Data Breach Notification and Investigation
a) As required by Applicable Data Protection Laws, Runner AI will provide notice to You upon Runner AI confirming any Personal Data Breach.
b) Such notice shall include the information required under Applicable Data Protection Laws to the extent such information is reasonably available to Runner AI. Runner AI's response to, or notice of, a Personal Data Breach is not an acknowledgment by Runner AI of any fault or liability.
c) Runner AI agrees to investigate any Personal Data Breach, and use commercially reasonable efforts to identify, prevent, mitigate, and remedy the effects.
#### C. Your Obligations With Respect to Personal Data
##### 1. Privacy Notices and Transparency
You represent and warrant that You are in compliance with all obligations under Applicable Data Protection Laws to provide notice and transparency concerning Your processing of Your Customer Personal Data under the Terms and in connection with Your use of the Services. Consistent with Applicable Data Protection Laws, You shall communicate to the relevant individuals all disclosures necessary for Runner AI to lawfully and fairly process Your Customer Personal Data in connection with this DPA, including when you receive Enhanced Services or other Additional Services, by providing a link to Runner AI's Consumer Privacy Policy and to Your Privacy Policy and providing other disclosures as set forth in Section 9 of the Terms.
##### 2. Customer Rights and Permissions
You represent and warrant that You have all necessary rights, permissions, and consents to make available Your Customer Personal Data to Runner AI, and for Runner AI to process Your Customer Personal Data in order for You to receive the Services, including Enhanced Services or other Additional Services you receive, in accordance with the Terms, this DPA, and Applicable Data Protection Laws.
##### 3. Data Rights Requests
You represent and warrant that You provide the ability for Your Customers to exercise Data Rights Requests, as required under Applicable Data Protection Laws, with respect to processing of Your Customer Personal Data by Runner AI for which You are the Data Controller.
##### 4. Regulatory Inquiries
Unless prohibited by applicable law, You will notify us promptly in accordance with the Notice provision in the Terms of any governmental, regulatory or other third party inquiry or complaint concerning Your use of the Services.
### V. MISCELLANEOUS
#### A. Global Data Transfers
You acknowledge that Your Customer Personal Data may be transferred and processed in any country in which Runner AI, its affiliated companies or third party service providers are located. Any transfer of Your Customer Personal Data to these recipients will be made in compliance with Applicable Data Protection Laws. For more information on international data transfers, where Runner AI is subject to data protection requirements in the EEA, the UK, or Switzerland, see Section II(B)(8) of Appendix C.
#### B. Response to Legal Requests
1. You acknowledge that, in the course of providing the Services to You, Runner AI may share Your Customer Personal Data (i) to comply with legal requirements or to respond to court orders or other similar government or regulatory demands; or (ii) to prevent or investigate suspected fraud, threats to physical safety, illegal activity, or violations of a contract (such as the Terms of Service) or our policies (such as our Acceptable Use Policy).
2. Runner AI will make reasonable efforts before producing Your Customer Personal Data to ensure that such disclosure is permitted under Applicable Data Protection Laws and will be treated as confidential information under the applicable legal framework.
#### C. Disclosure in Corporate Transactions
You acknowledge that, in the course of providing the Services to You, Runner AI may be required to share Your Customer Personal Data with potential counterparties to any corporate or restructuring transaction.
#### D. Runner AI's Use of Service Providers
1. You acknowledge and agree that, in the course of providing the Services to You, Runner AI may use service providers to process Your Customer Personal Data. Runner AI maintains an updated list of all service providers used. If Applicable Data Protection Laws grant you such rights, You may object to Runner AI's use of a service provider, and if Runner AI is unable or unwilling to accommodate such requests, You may, in accordance with such laws, terminate Your use of the impacted Services within 30 days of such notification in accordance with the Terms.
2. Runner AI's use of service providers to process Your Customer Personal Data that You provide will be in compliance with Applicable Data Protection Laws. Where Runner AI engages a service provider, Runner AI will enter into a written agreement with the service provider that imposes contractual obligations that are substantially the same as the ones set out in this DPA.
#### E. DPA Amendment
You acknowledge and agree that Runner AI may amend this DPA from time to time by posting the relevant amended and restated DPA on Runner AI's website, available at https://www.runnerai.com/docs/en/legal/dpa and such amendments to the DPA are effective as of the date of posting. Your continued use of the Services after the amended DPA is posted to Runner AI's website constitutes Your agreement to, and acceptance of, the amended DPA. If You do not agree to any changes to the DPA, do not continue to use the Services.
### VI. APPENDICES
1. [Appendix A - Categories of Personal Data](#appendix-a-categories-of-personal-data)
2. [Appendix B - Data Security](#appendix-b-data-security)
3. [Appendix C - GDPR, UK GDPR, and Switzerland Data Processing Appendix](#appendix-c-gdpr-uk-gdpr-and-switzerland-data-processing-appendix)
4. [Appendix D - U.S. Data Protection Laws](#appendix-d-us-data-protection-laws)
5. [Appendix E - Runner AI as a Data Controller or Business for Enhanced Services](#appendix-e-runner-ai-as-a-data-controller-or-business-for-enhanced-services)
---
## APPENDIX A: CATEGORIES OF PERSONAL DATA
As part of Your use of the Services, and depending on which Services You use, we may receive and process the following categories of Personal Data to provide the Services:
- Identifiers, including name, email address, mailing address, phone number
- Personal information categories listed in the California Customer Records statute, including name, mailing and billing address, phone number, credit or debit card information
- Commercial information, including products you purchase, place in your shopping cart, favorite or review (if you are a customer) and information you provide us about you and your business (if you are a merchant)
- Photos and videos, which may include face imagery, if you choose to provide them
- Internet or other electronic network activity information, including information regarding the device and browser you use, network connection, IP address, and how you browse through our sites
- Geolocation data, including your mailing and billing address
- Inferences, or information derived from other personal information about you, which could include your preferences, interests, and other information used to personalize your experience
- Sensitive personal information, which may include:
- Government-issued identifiers, including social security, driver's license, state identification card, or passport number
- Your account access credentials (such as account log-in, financial account, debit or credit card number in combination with any required security access code, password, or credentials allowing access to an account)
---
## APPENDIX B: DATA SECURITY
Runner AI will maintain an information security program designed to (a) enable You to secure Your Customer Personal Data against unauthorized or unlawful processing and against accidental loss, destruction, damage, theft, alteration, or disclosure; (b) identify reasonably foreseeable risks to the security and availability of the Services You receive; and (c) minimize security risks to the Services.
### I. Runner AI's information security program will include the following safeguards:
#### A. Logical Security
##### 1. Access Controls
Runner AI will make its systems accessible only to authorized personnel, and only as necessary to maintain and provide the Services. Runner AI will maintain access controls and policies designed to manage authorizations for access to its systems, including through the use of firewalls and/or other technology and authentication controls.
##### 2. Restricted User Access
Runner AI will (i) provision and restrict access to its systems in accordance with least privilege principles based on personnel job functions, and (ii) require two-factor authentication (2FA) for access to its systems.
##### 3. Vulnerability Assessments
Runner AI will maintain a vulnerability assessment and penetration testing program, responsible for investigating and tracking identified issues with the Services to resolution where necessary.
##### 4. Application Security
Runner AI maintains an application security program responsible for protecting Services from application security threats.
##### 5. Change Management
Runner AI will maintain controls designed to log, authorize, test, approve and document changes to existing Services resources, and will document change details within its change management or deployment tools. Runner AI will test changes according to its change management standards prior to migration to production.
##### 6. Data Integrity
As appropriate, Runner AI will maintain controls designed to provide data integrity during transmission, storage and processing within the Services.
##### 7. Availability
Runner AI will (i) implement redundancy where appropriate for the Services to minimize the effect of a malfunction on the Services, (ii) design the Services to anticipate and tolerate failures, and (iii) implement appropriate processes designed to move Personal Data traffic away from the affected areas when necessary to recover from failures.
##### 8. Business Continuity and Disaster Recovery
Runner AI will maintain a risk management program designed to support the continuity of its critical business functions, including processes and procedures for identification of, response to, and recovery from, events that could prevent or materially impair Runner AI's provision of the Services You receive.
##### 9. Incident Management
Runner AI provides documentation for You to report security or availability incidents, ask security or availability questions, and submit information about potential security or availability issues. Runner AI will maintain corrective action plans and incident response plans designed to detect, mitigate, investigate, and respond to potential security threats to the Services.
#### B. Physical Security
Where necessary to protect Services, Runner AI will (i) implement reasonable measures designed to prevent unauthorized physical access, damage, or interference to the Services, (ii) use appropriate control devices designed to restrict physical access to the Services to only authorized personnel who have a legitimate business need for such access, and (iii) perform periodic reviews to validate adherence with these standards.
#### C. Runner AI Employees
Runner AI employees who are authorized to access Your Customer Personal Data are bound by obligations of confidentiality as part of their terms of employment. Runner AI will implement and maintain employee security training programs regarding Runner AI information security requirements. The security awareness training programs will be reviewed and updated periodically.
### II. Modifications to this Appendix
Runner AI reviews its security measures from time to time, and may update this Appendix in its sole discretion. Any such updates will replace prior versions of this Appendix as of the date that Runner AI publishes the updated version.
---
## APPENDIX C: GDPR, UK GDPR, AND SWITZERLAND DATA PROCESSING APPENDIX
Where the processing of Your Customer Personal Data under the DPA is subject to data protection requirements in the European Economic Area (the "EEA"), the United Kingdom (the "UK"), or Switzerland (collectively, "European Data Protection Laws"), and Runner AI acts as a Data Processor, Appendix C supplements this DPA.
### I. Nature of the Processing and Role of the Parties
#### A. Personal Data
Under this Appendix You shall act as a Data Controller and Runner AI shall act as a Data Processor with respect to the processing of Your Customer Personal Data as described in Annex 1, as necessary to fulfill the business purposes outlined in the Terms and provide You with the Services You choose to use.
### II. Obligations of the Parties
#### A. Your Obligations
You shall comply with:
- European Data Protection Laws binding on You in relation to Your use of the Services; and
- Your obligations set out in the DPA, including Your obligations set forth in this Appendix.
You represent and warrant that You have a valid legal basis for processing Your Customer Personal Data (including making any such data available to Runner AI) and have obtained any necessary consents, rights and authorizations and given any necessary notices to individuals to enable Runner AI's processing of Your Customer Personal Data to provide the Services, as required by European Data Protection Laws.
#### B. Runner AI's Obligations
##### 1. Instructions of the Controller and Infringement of European Data Protection Laws
a) The Parties agree that the Terms together with this DPA constitute Your documented instructions regarding Runner AI's processing of Your Customer Personal Data ("Documented instructions").
b) Runner AI will process Your Customer Personal Data as a Data Processor: (i) in accordance with Your Documented instructions, or (ii) to comply with Runner AI's obligations under applicable laws, subject to any notice requirements under EEA, EEA member state, UK or Swiss law to which Runner AI is subject.
c) Runner AI will notify You if it receives an instruction that it reasonably determines infringes European Data Protection Laws (but Runner AI has no obligation to actively monitor Your compliance with European Data Protection Laws).
##### 2. Confidentiality obligation
Runner AI will ensure persons who it authorizes to process Your Customer Personal Data either enter into written confidentiality agreements or are subject to statutory obligations of confidentiality.
##### 3. Security measures
a) Runner AI shall implement and maintain appropriate technical and organizational measures designed to protect Your Customer Personal Data against unauthorized or unlawful processing and against accidental loss, destruction, damage, theft, unauthorized access, alteration, or disclosure, as set forth in Annex 2.
b) Taking into account the nature of the Your Customer Personal Data and related processing, Runner AI shall provide such reasonable assistance as You may reasonably request to help You fulfill Your security obligations under European Data Protection Laws.
c) Runner AI shall provide You with notice, without undue delay, upon becoming aware of a breach of security leading to the accidental or unlawful destruction, loss, alteration, unauthorized disclosure of, or access to, Your Customer Personal Data transmitted, stored or otherwise processed.
d) Runner AI agrees to investigate any such security breach and use commercially reasonable efforts to mitigate the effects.
##### 4. Subprocessors
a) You generally authorize Runner AI to engage Subprocessors to process Your Customer Personal Data. You further agree that Runner AI may engage its affiliates as Subprocessors.
b) Runner AI's use of Subprocessors to process Your Customer Personal Data will be in compliance with European Data Protection Laws.
c) Runner AI maintains an updated list of all Subprocessors as set forth in Annex 3. Runner AI will update the list of Subprocessors as appropriate and provide You with a mechanism to obtain notice of the addition or replacement of a Subprocessor. You may object to Runner AI's use of a new Subprocessor.
d) To the extent You object to Runner AI's use of a Subprocessor, and Runner AI is unable or unwilling to accommodate such requests, You may terminate Your use of the impacted Services within 30 days of such notification in accordance with the Terms.
e) Where Runner AI engages a new Subprocessor, Runner AI will enter into a written agreement with the Subprocessor and Runner AI will impose, on the Subprocessor, contractual obligations that are substantially the same as the ones set out in this DPA. Runner AI shall be fully liable for the acts and omissions of its Subprocessors to the same extent Runner AI would be liable if performing the services of each Subprocessor directly under the terms of this DPA. Runner AI's liability will nevertheless be subject to the conditions and limitation of liability set forth in the Terms.
##### 5. Assistance to the Controller
Taking into account the nature of Your Customer Personal Data and related processing, Runner AI shall provide such reasonable assistance as You may reasonably request to assist You in complying with Your obligations:
- to respond to Data Rights Requests under European Data Protection Laws, with respect to all processing of Your Customer Personal Data by Runner AI;
- to notify relevant authorities and/or data subjects of a Personal Data Breach;
- to conduct data protection impact assessments and prior consultations;
- to ensure the security of the processing in accordance with section 3.
##### 6. Assessing compliance
a) Runner AI may fulfill Your right of audit under European Data Protection Laws in relation to the processing of Your Customer Personal Data by providing You - upon Your written request and subject to confidentiality - with:
(i) Runner AI's most recent audit report results, either from Runner AI's self-audits or prepared by an independent third party auditor;
(ii) additional information in Runner AI's control if a data protection or governmental authority requests it.
b) Provided that and only to the extent that European Data Protection Laws grant You this right, You may exercise Your Audit right: (i) to the extent that an independent internationally recognized auditor attests that Runner AI's provision of an audit report does not provide sufficient information for You to verify Runner AI's compliance with this DPA and with European Data Protection Laws or (ii) as necessary for You to respond to a government authority audit. Each audit must conform to the following parameters: (i) be conducted by an independent third party that will enter into a confidentiality agreement with Runner AI; (ii) be limited in scope to matters reasonably required, and as mutually agreed upon, for You to assess Runner AI's compliance with this DPA and the parties' compliance with European Data Protection Laws; (iii) occur at a mutually agreed date and time and only during Runner AI's regular business hours; (iv) occur no more than once annually (unless required under European Data Protection Laws); (v) cover only facilities controlled by Runner AI; (vi) restrict findings to Your Customer Personal Data only; and (vii) treat any results as confidential information to the fullest extent permitted by European Data Protection Laws. For clarification, Runner AI will comply with any of Your rights under this section 6 in accordance with its confidentiality obligations with third parties.
##### 7. End of processing
a) During Your use of the Services, You may leverage account tools to access, return to yourself, or delete Your Customer Personal Data.
b) Following termination, Runner AI will, at Your choice, delete or return Your Customer Personal Data. Notwithstanding the foregoing, Runner AI may retain Your Customer Personal Data: (i) as required by law, including European Data Protection Laws; and (ii) in accordance with its standard backup or record retention policies, provided that, in either case, Runner AI will maintain the confidentiality of, and otherwise comply with the applicable provisions of this DPA with respect to, retained Your Customer Personal Data, and not further Process retained Your Customer Personal Data except for such purpose(s) and duration permitted under such applicable laws.
##### 8. International Transfers
a) You acknowledge that in the course of providing the Services, Adaptive Machines, Inc., a company based in the United States, will process Your Customer Personal Data on servers located in the United States.
b) When Runner AI engages in an International Transfer (meaning a transfer of Your Customer Personal Data from the European Economic Area (EEA), the United Kingdom (UK), or Switzerland to a country outside of those regions that is not recognized as providing an adequate level of data protection), it will do so in compliance with European Data Protection Laws.
c) To the extent that Runner AI is the recipient of Your Customer Personal Data in a country that does not ensure an adequate level of data protection, the Parties agree that such transfers will be subject to appropriate safeguards, specifically the following transfer mechanisms: (i) The Standard Contractual Clauses for the transfer of personal data to third countries pursuant to Regulation (EU) 2016/679 of the European Parliament and of the Council, as approved by European Commission Implementing Decision (EU) 2021/914 of 4 June 2021 (the "EU SCCs"); and/or (ii) For transfers from the United Kingdom, the International Data Transfer Addendum to the European Commission's standard contractual clauses, issued by the UK Information Commissioner's Office under S119A(1) of the UK Data Protection Act 2018 (the "UK Addendum"); and/or (iii) For transfers from Switzerland, the EU SCCs as amended to satisfy the requirements of the Swiss Federal Act on Data Protection.
d) By agreeing to this DPA, you are deemed to have signed the applicable transfer mechanisms, which are incorporated by reference and form an integral part of this DPA.
### ANNEX 1 - PERSONAL DATA
#### DESCRIPTION OF THE PROCESSING OF PERSONAL DATA
**I. Subject Matter of the Processing**
Provision of Runner AI Services to Merchant.
**II. Categories Of Data Subjects**
Customers of Merchant.
**III. Categories Of Personal Data Processed**
See Appendix A above.
**IV. Frequency of the transfer**
Continuous.
**V. Nature Of The Processing**
Collection, recording, hosting, access, use, transfer and deletion of Personal Data as described in the Terms.
**VI. Purposes For Which The Personal Data Is Processed On Behalf Of The Controller**
For the performance and improvement of the Services as described in the Terms.
**VII. Duration Of The Processing**
Duration of the Services under the Terms or applicable agreement, plus the period after such expiration until the anonymization, return, or deletion of data.
**VIII. Competent Supervisory Authority**
The competent supervisory authority will be determined in accordance with the GDPR.
### ANNEX 2 - SECURITY MEASURES
Information on security measures is provided in Appendix B of the DPA.
### ANNEX 3 - LIST OF SUBPROCESSORS
The Subprocessors used by Runner AI for the performance of the Services under the Terms are listed here.
The Subprocessors will process the categories of Personal Data described above in connection with the Services for the duration of their agreement with Runner AI.
---
## APPENDIX D: U.S. DATA PROTECTION LAWS
This section applies only to the extent that: (i) U.S. Data Protection Laws apply to You and/or Your Customer Personal Data in connection with Your use of the Services; (ii) the following provisions are required by U.S. Data Protection Laws; and (iii) Runner AI is acting as a Data Processor or Service Provider. For the avoidance of doubt, this Appendix D shall not apply to the processing activities described in Appendix E.
The Parties agree that the Terms together with this DPA constitute Your documented instructions regarding Runner AI's processing of Your Customer Personal Data ("Documented instructions").
Other than as set forth in Appendix E if you receive certain Enhanced Services, Runner AI will not: (i) retain, use, or disclose Your Customer Personal Data outside its direct business relationship with You or for any other purpose other than for the limited and specified purposes identified in this DPA and/or the Terms, including to provide, develop, and improve the Services or as otherwise permitted by Applicable U.S. Data Protection Laws, or (ii) "sell" or "share" Your Customer Personal Data or engage in "targeted advertising" with Your Customer Personal Data within the meaning of the CCPA or other US Data Protection Laws; or (iii) combine Your Customer Personal Data with Personal Data that it receives from other sources, in each case except as permitted under U.S. Data Protection Laws.
Runner AI will: (i) provide the same level of privacy protection required of Businesses or Data Controllers by U.S. Data Protection Laws, and inform You if it determines that it can no longer meet these obligations, in which case You may take reasonable and appropriate steps to stop or remediate any unauthorized processing of Your Customer Personal Data, (ii) ensure personnel whom it authorizes to process Your Customer Personal Data either enter into written confidentiality agreements or are subject to statutory obligations of confidentiality, (iii) upon reasonable written request, and as part of enabling You to take reasonable and appropriate steps to ensure Runner AI uses Your Customer Personal Data in a manner consistent with U.S. Data Protection Laws, provide the SOC2 report showing a reasonable assessment of Runner AI's information security program; and (iv) upon termination of its Services to You, Runner AI will initiate its purge process to delete, return, or de-identify Your Customer Personal Data provided to Runner AI for processing solely as a Data Processor or Service Provider.
You represent and warrant that You will not share with Runner AI any Personal Data of an individual who has exercised an opt-out right that You have committed to honoring or any sensitive Personal Data of an individual who has not consented to the processing of such sensitive data in accordance with requirements under Applicable Data Protection Laws.
---
## APPENDIX E: RUNNER AI AS A DATA CONTROLLER OR BUSINESS FOR ENHANCED SERVICES
Runner AI shall act as a Data Controller or Business when You receive the Enhanced Services as defined in Section 9 of the Terms of Service. Runner AI may update the services and products for which it acts as a Data Controller or Business from time to time.
As a part of Runner AI's provision of the Enhanced Services, you agree that Runner AI will process Your Customer Personal Data as a Data Controller or Business under Applicable Data Protection Laws in order to provide, develop and improve analytics, product customization, advertising and other services to You and other Merchants that incorporate Your Customers' interactions and transactions with Your Store, with other Merchants, and with Runner AI. When Runner AI processes Your Customer Personal Data in this manner, Runner AI's Consumer Privacy Policy and this Appendix E of this DPA apply. You can disable Runner AI's use of Your Customer Personal Data in this manner by disabling Runner AI Network Intelligence here.
### 1. Privacy Notices, Transparency, and Rights
Consistent with Applicable Data Protection Laws, You shall communicate to the relevant individuals all disclosures necessary for Runner AI to lawfully and fairly process Your Customer Personal Data to provide Enhanced Services to You in connection with this Appendix E of the DPA, including by providing a link to Runner AI's Consumer Privacy Policy in your privacy policy and providing the disclosures as set forth in Section 9.2.5 of the Terms of Service.
### 2. European Requirements
If You are based in the EEA, United Kingdom or Switzerland, or if Your Customers are in the EEA, United Kingdom or Switzerland, You agree, represent, and warrant that you have obtained consent from Customers, and provide Customers with the ability to exercise the right to withdraw consent, object to certain processing, and opt out of certain processing, where required by Applicable Data Protection Laws. For the avoidance of doubt, you must obtain consent for targeted advertising as part of the Enhanced Services, and the use of cookies or other local storage technologies to the extent required by Applicable Data Protection Laws.
### 3. Controller Responsibilities
You are a Data Controller of Your Customer Personal Data and shall individually determine the purposes and means of Your processing of Your Customer Personal Data and how to use and process Your Customer Personal Data, including determining the legal basis for Your processing under Applicable Data Protection Law. Runner AI is a Data Controller of Your Customer Personal Data that it processes in accordance with this Appendix E and shall individually determine the purposes and means of its processing of such Personal Data and how to use and process such Personal Data, including determining the legal basis for its processing under Applicable Data Protection Law.
Each Party is individually responsible for responding to Data Rights Requests that it receives relating to its processing of Your Customer Personal Data as a Data Controller.
### 4. No Effect on Remainder of DPA
This Appendix E shall not otherwise affect any Terms, including the remainder of this DPA, reflecting a Data Controller-Data Processor relationship between Merchants and Runner AI.
---
# Privacy Policy for everyone
Source: https://www.runnerai.com/docs/en/legal/policies
## Table of Content
1. [Introduction](#introduction)
2. [Our values](#our-values)
3. [Why we process your information](#why-we-process-your-information)
4. [Your rights over your information](#your-rights-over-your-information)
5. [Where we send your information](#where-we-send-your-information)
6. [Google user data and Google integrations](#google-user-data-and-google-integrations)
7. [How long do we retain your information](#how-long-do-we-retain-your-information)
8. [Our use of Machine Learning](#our-use-of-machine-learning)
9. [How we protect your information](#how-we-protect-your-information)
10. [How we use "cookies" and other tracking technologies](#how-we-use-cookies-and-other-tracking-technologies)
11. [How you can reach us](#how-you-can-reach-us)
12. [United States Regional Privacy Notice](#united-states-regional-privacy-notice)
13. [Additional Information for Users in Certain Regions](#additional-information-for-users-in-certain-regions)
## Introduction
This Privacy Policy describes how Adaptive Machines, Inc. ("Runner AI", "we", "us", or "our") collects, uses, and discloses personal information when you use our website and services.
In our mission to make commerce better for everyone at Runner AI, we collect and use information about you, our:
- merchants using Runner AI to power their business
- customers who shop at a Runner AI-powered business
- visitors to Runner AI's websites, or anyone contacting Runner AI support
If we change our privacy practices, we may update this privacy policy. If any changes are significant, we will let you know (for example, through the Runner AI admin or by email).
## Our values
Trust is the foundation of the Runner AI platform and includes trusting us to do the right thing with your information. Three main values guide us as we develop our products and services. These values should help you better understand how we think about your information and privacy.
### Your information belongs to you
We carefully analyze what types of information we need to provide our services, and we try to limit the information we collect to only what we really need. Where possible, we delete or anonymize this information when we no longer need it. When building and improving our products, our engineers work closely with our privacy and security teams to build with privacy in mind. In all of this work our guiding principle is that your information belongs to you, and we aim to only use your information to your benefit.
### We protect your information from others
If a third party requests your personal information, we will refuse to share it unless you give us permission or we are legally required. When we are legally required to share your personal information, we will tell you in advance, unless we are legally forbidden.
### We help merchants meet their privacy obligations
Many of the merchants using Runner AI do not have the benefit of a dedicated privacy team, and it is important to us to help them meet their privacy obligations. To do this, we try to build our products and services so they can easily be used in a privacy-friendly way. We also provide detailed FAQs and documentation covering the most important privacy topics, and respond to privacy-related questions we receive.
## Why we process your information
We generally process your information when we need to do so to fulfill a contractual obligation (for example, to process your subscription payments to use the Runner AI platform), or where we or someone we work with needs to use your personal information for a reason related to their business (for example, to provide you with a service). Laws in the European Economic Area ("EEA") and in the United Kingdom ("UK") call these reasons "legitimate interests." These "legitimate interests" include:
- preventing risk and fraud
- answering questions or providing other types of support
- providing and improving our products and services
- providing reporting and analytics
- testing out features or additional services
- assisting with marketing, advertising, or other communications
We only process personal information for these "legitimate interests" after considering the potential risks to your privacy and balancing any risks with certain measures—for example, by providing clear transparency into our privacy practices, offering you control over your personal information where appropriate, limiting the information we keep, limiting what we do with your information, who we send your information to, how long we keep your information, or the technical measures we use to protect your information.
We may also process your personal information where you have provided your consent. In particular, where we cannot rely on an alternative legal basis for processing, where you direct us to transfer information to a third party, where we receive your data from a third party is sourced and it already comes with consent or where we are required by law to ask for your consent (including in the context of some of our sales and marketing activities). At any time, you have a right to withdraw your consent by changing your communication choices, opting out from our communications or by contacting us.
Depending on whether you are a merchant, customer, or visitor, please refer to our supplemental privacy policies, as relevant, to understand our purposes for processing, categories of recipients and legal basis for processing for each type of personal data.
## Your rights over your information
We believe you should be able to access and control your personal information no matter where you live. Depending on how you use Runner AI, you may have the right to request access to, correct, amend, delete, port to another service provider, restrict, or object to certain uses of your personal information. We will not charge you more or provide you with a different level of service if you exercise any of these rights. Please note that a number of these rights apply only in certain circumstances, and all of these rights may be limited by law.
If you buy something from or otherwise provide your information to a Runner AI-powered store and wish to exercise these rights over information about your purchase or interaction, you need to directly contact the merchant you interacted with. We are a processor and process information on their behalf. We will of course help our merchants to fulfill these requests to the extent required by law, such as by giving them the tools to do so and by answering their questions.
If you are a merchant, Runner AI employee, website visitor or other individual that Runner AI has a direct relationship with, please submit a verifiable request to us by emailing support@adaptivemachines.ai. Please note that if you send us a request relating to your personal information, we have to make sure that it is you before we can respond. In order to do so, we may use a third party to collect and verify identification documents. Further information about rights available to US residents can be found below under the header "United States Regional Privacy Notice".
Finally, because there is no common understanding about what a "Do Not Track" signal is supposed to mean, we don't respond to those signals in any particular way.
## Where we send your information
We are an American company, but we work with and process data about individuals across the world. To operate our business, we may send your personal information outside of your state, province, or country. This data may be subject to the laws of the countries where we send it. We take steps to protect your information when we send your information across borders.
Depending on whether you are a merchant, customer, user or visitor, please refer to our supplemental privacy policies, as relevant.
Finally, while we do what we can to protect your information, we may at times be legally required to disclose your personal information (for example, if we receive a valid court order).
When we transfer personal information from the European Economic Area (EEA), the United Kingdom, or Switzerland to countries that have not been deemed to provide an adequate level of data protection, we rely on legal mechanisms such as the Standard Contractual Clauses approved by the European Commission to safeguard the transfer.
## Google user data and Google integrations
This section applies when you use Google Sign-In or connect Google Ads, Google Merchant Center, or another Google service to Runner AI.
### What Google user data we access and store
For Google Sign-In, we access the Google account information you authorize, such as your name, email address, profile image, and Google account identifier, to create or log in to your Runner AI account.
For Google Ads and Google Merchant Center integrations, we request the Google OAuth scopes needed to provide the ads features you choose, including `https://www.googleapis.com/auth/adwords` and `https://www.googleapis.com/auth/content`. Depending on the features you use, we may store OAuth access tokens, refresh tokens, granted scopes, token expiration data, accessible Google Ads customer account identifiers, account names, manager-account status, and selected account bindings. We may also access and process Google Ads campaign, ad group, ad, creative, asset, budget, bidding, targeting, performance metric, conversion value, ROAS, and change-history data, including the user email associated with a Google Ads account change, as well as Google Merchant Center account identifiers and account names.
### How we use Google user data
We use Google user data only to provide or improve user-facing Runner AI features that you request, including signing you in, connecting and refreshing your Google integrations, listing selectable Google Ads and Merchant Center accounts, showing ads dashboards and reports, generating requested AI ads analysis or campaign drafts, publishing or updating campaigns you approve, syncing account access, and troubleshooting or securing those features.
We do not sell Google user data. We do not use Google user data for retargeting, personalized advertising unrelated to your requested Runner AI ads features, credit-worthiness, lending, or transfer to data brokers or information resellers.
### With whom we share, transfer, or disclose Google user data
We share, transfer, or disclose Google user data only in the following circumstances:
- **Google LLC.** We send authorization codes, OAuth tokens, developer-token-authenticated requests, campaign settings, Merchant Center identifiers, and related API request data to Google APIs so that we can authenticate your account, read the Google Ads or Merchant Center data you authorized, and perform the Google Ads or Merchant Center actions you request.
- **Your authorized Runner AI organization users.** Google Ads account metadata, reports, metrics, creatives, change history, Merchant Center account metadata, and campaign drafts may be visible to users in your Runner AI organization according to their workspace permissions.
- **Service providers and subprocessors.** We may share Google user data with service providers that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI, subject to confidentiality and data-processing obligations. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- **Legal, safety, and business-transfer recipients.** We may disclose Google user data when required by law, to protect rights, safety, and security, to investigate abuse, or in connection with a merger, acquisition, financing, reorganization, bankruptcy, or sale of assets, as described elsewhere in this Privacy Policy.
Except as described above or with your explicit direction, we do not share, transfer, or disclose Google user data to third-party advertising platforms, data brokers, information resellers, or other third parties.
### Retention and user control
We retain connected Google integration tokens and account metadata while the integration remains enabled or as needed to provide the Services, comply with law, resolve disputes, enforce agreements, maintain security, or keep backups. Disconnecting Google Ads in Runner AI deletes the active Google Ads integration record, including stored OAuth tokens and account metadata. You can also revoke Runner AI's Google access from your Google account settings.
Runner AI's use and transfer of information received from Google APIs will adhere to the [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy), including the Limited Use requirements.
## How long do we retain your information
We will retain your personal data only for as long as necessary to fulfill the purposes for which we have collected it. To determine the appropriate retention period, we consider the amount, nature and sensitivity of your personal data, the potential risk of harm from unauthorized use or disclosure of your personal data, the purposes for which we process your personal data and whether we can achieve those purposes through other means and the applicable legal requirements. We will also retain and use your personal information to the extent necessary to comply with our legal obligations, resolve disputes and enforce our policies. If you stop using our services or if you delete your account with us, we will delete your information or store your information in an aggregated and anonymized format.
Depending on whether you are a merchant, customer, user or visitor, please refer to our supplemental privacy policies, as relevant, for further details on the retention of your personal information.
## Our use of Machine Learning
To provide our advanced AI-powered features for automated operations and growth, our platform utilizes machine learning. We use these technologies to provide services such as predictive analytics, marketing campaign suggestions, and conversion optimization recommendations.
Our AI features are designed as decision-support tools. They generate data-driven suggestions for your consideration. These are not automated decisions. You, the merchant, retain full control and are solely responsible for reviewing, approving, and implementing any suggestions provided by our AI. The Service will only execute actions upon your explicit approval or based on settings you have pre-configured. Our legal basis for using your data for these purposes is further detailed in our Terms of Service under the 'Data Usage for AI Improvement' clause.
## How we protect your information
Our teams work tirelessly to protect your information, and to ensure the security and integrity of our platform. We also have independent auditors assess the security of our data storage and systems that process financial information. However, we all know that no method of transmission over the Internet, and method of electronic storage, can be 100% secure. This means we cannot guarantee the absolute security of your personal information.
## How we use "cookies" and other tracking technologies
We use cookies and similar tracking technologies on our website and when providing our services. For more information about how we use these technologies, including a list of other companies that place cookies on our sites, a list of cookies that we place when we power a merchant's store, and an explanation of how you can opt out of certain types of cookies, please see our Cookie Policy.
## How you can reach us
If you would like to ask about, make a request relating to, or complain about how we process your personal information, please contact Runner AI Support via email at support@adaptivemachines.ai, or mail us at the addresses below:
Adaptive Machines, Inc.
2911 Noyce Place, 189, Santa Clara, CA 95051, USA
If you buy something from or otherwise provide your information to a Runner AI-powered store, the merchant is your data controller and we are acting as a processor on their behalf.
If you have questions about how a merchant or store processes your personal information, you should contact the merchant or visit their privacy policy.
## United States Regional Privacy Notice
This United States Regional Privacy Notice ("US Notice") supplements our Privacy Policy and all supplemental privacy policies on /en/legal/policies (together, the "Runner AI Privacy Policies").
This US Notice is for individuals residing in certain US states and is designed to help you better understand how we collect, use, and disclose your personal information and, depending on how you use Runner AI and where you reside, how to exercise available rights under various applicable privacy laws in the US, specifically the California Consumer Privacy Act, the Colorado Privacy Act, the Connecticut Act Concerning Personal Data Privacy and Online Monitoring, the Utah Consumer Privacy Act, and the Virginia Consumer Data Protection Act (collectively, the "US Privacy Laws").
### 11.1 What information we collect and share about you
To provide our services to you, we must process information about you, including personal information.
We do not "sell" your personal information as that term is defined under US Privacy Laws.
Here is a summary of the categories of personal information we may collect about you in the future and with whom we may have disclosed that information to, depending on how you use Runner AI.
| Categories of Personal Information Collected | Recipients of Personal Information |
|----------------------------------------------|-------------------------------------|
| Identifiers, including name, email address, mailing address, phone number; | Companies who help us provide you with our services, including cloud storage providers, payment processors, fulfillment partners, security vendors, email providers, marketplaces and data analytics vendors; |
| Personal information categories listed in the California Customer Records statute, including name, mailing and billing address, phone number, credit or debit card information; | Advertisers and marketing vendors; |
| Commercial information, including products you purchase, place in your shopping cart, favorite or review (if you are a customer) and information you provide us about you and your business (if you are a merchant); | Merchants whose shops you visit or make purchases from; |
| Photos and videos, which may include face imagery, if you choose to provide them. | Partners who help you use our Services, such as payment or logistics providers you choose to integrate with your Store. |
| Internet or other electronic network activity information, including information regarding the device and browser you use, network connection, IP address, and how you browse through our sites; | Law enforcement or other third parties in connection with legal requests, to comply with applicable law or to prevent harm. |
| Geolocation data, including your mailing and billing address; | |
| Inferences, or information derived from other personal information about you, which could include your preferences, interests, and other information used to personalize your experience; | |
| Other information you provide; and | |
| Sensitive personal information, which may include: Government-issued identifiers, including social security, driver's license, state identification card, or passport number; Your account access credentials (such as account log-in, financial account, debit or credit card number in combination with any required security access code, password, or credentials allowing access to an account); | |
### 11.2 Why we collect and share your Personal Information
We use and share your personal information for the purposes set out in the Runner AI Privacy Policies. For categories of sensitive personal information that we collect, we only use or disclose such information either with your specific consent when required, or as otherwise permitted by law.
### 11.3 Sources of Personal Information
To make commerce better for everyone at Runner AI, we collect and use personal information provided by:
**You:** We collect the information you provide when you use our platform, including when you sign up for Runner AI as a merchant, visit a Runner AI-powered store, fill in order information, visit one of Runner AI's websites or contact Runner AI Support. We collect account and payment information you provide to us (including information about your business if you are a merchant), Runner AI stores or items you save to favorites, purchases you make, reviews you post, and how you otherwise interact or communicate with stores or other users on our services. We also collect information about how you browse through our sites, including search terms you may enter.
**Your device(s):** We collect information from and about the devices you use, including computers, phones, and other web-connected devices you use to access our services, and we combine this information across different devices you use.
**Third parties:** We receive information from partners who help us provide you with our services including the following:
- **Service Providers.** We receive information from our service providers, who help us provide services to our merchants, like reviewing accounts for fraud or other concerns.
- **Subprocessors.** We work with third party subprocessors for cloud hosting, content delivery, data analysis, internal logging, fulfillment services and email transmission, among others, to provide you with our services. For more information, see Runner AI's subprocessors.
- **Analytics and cookie providers.** We receive information through our use of cookies, social plugins (such as the Facebook "like" button), pixels and tags for business purposes, such as providing information to help measure how users interact with our website content. For more information about how we use these technologies, see our Cookie Policy.
### 11.4 How long we keep your information
Because we need your personal information to provide Runner AI services, we generally keep your personal information, including sensitive personal information, while you use Runner AI products or services or until you tell us to delete your information. We may also keep personal information to comply with legal obligations or protect our or other's interests.
If you are a merchant operating a Runner AI-powered store, and you close the store, stop paying your subscription fees, or we terminate your account, we retain store information for two years before we begin the deletion process.
When you visit or make a purchase from a merchant's Runner AI-powered store, we act as a service provider or processor for the merchant, and the merchant, not Runner AI, decides how long your information is retained.
### 11.5 Your rights over your information
Depending on where you live, how you use Runner AI, and subject to certain exceptions, you may have some or all of the following rights:
- **Right to Know:** The right to request that we disclose to you the personal information we collect, use, or disclose about you, sources from which we collect your personal information, and information about our data practices.
- **Right to Request Correction:** The right to request that we correct inaccurate personal information that we maintain about you.
- **Right to Request Deletion:** The right to request that we delete any personal information that we have collected about you.
To exercise your rights, including the "right to know" and "right to delete," please submit a request through support@adaptivemachines.ai.
If you have visited or made a purchase from a merchant's Runner AI-powered store, please contact the specific merchant directly. If you make a request to us, we will forward your request to the relevant merchant.
Please note that to protect your information and the integrity of our products and services, we may need to verify your identity before processing your request. In some cases we may need to collect additional information to verify your identity, such as your email address or a government issued ID.
Under US Privacy Laws, you may also designate an authorized agent to make these requests on your behalf. If you use an authorized agent to submit a request, we may need to collect additional information, such as a government issued ID, to verify your identity before processing your request to protect your information.
In certain states, you may have the right to appeal our decision regarding a request related to these rights. If you wish to appeal a decision, please contact Runner AI Support.
We will not discriminate against you for exercising any of these rights.
## Additional Information for Users in Certain Regions
### For Users in the European Economic Area (EEA), UK, and Switzerland:
If you are in the EEA, UK, or Switzerland, we only process your personal data when we have a valid legal basis. For information where we are the Data Controller (e.g., for our Merchants and Website Visitors), our legal bases include:
- **Performance of a Contract:** To provide you with our Services as described in our Terms of Service.
- **Legitimate Interest:** For purposes like security, platform improvement, and marketing, where our interests are not overridden by your data protection rights.
- **Consent:** For specific uses, such as sending marketing emails or placing non-essential cookies, where we ask for your consent.
- **Legal Obligation:** To comply with our legal obligations.
### For Users in California:
If you are a California resident, you have rights under the CCPA/CPRA, including the right to know, delete, correct, and the Right to Opt-Out of the Sale or Sharing of Your Personal Information for purposes of cross-context behavioral advertising. You can exercise this right at any time by clicking the "Do Not Sell or Share My Personal Information" link in our website footer or by managing your cookie preferences.
---
# Privacy Policy for consumers
Source: https://www.runnerai.com/docs/en/legal/policies/consumers
## Table of Content
1. [Introduction](#introduction)
2. [What Personal Data We Receive](#what-personal-data-we-receive)
3. [How We Use Your Personal Data](#how-we-use-your-personal-data)
4. [How We Process Your Personal Data on Behalf of Runner AI Merchants](#how-we-process-your-personal-data-on-behalf-of-runner-ai-merchants)
5. [Third-Parties Who May Receive Personal Data](#third-parties-who-may-receive-personal-data)
6. [Third Party Partners & Integrations](#third-party-partners--integrations)
7. [Your Privacy Rights and Choices](#your-privacy-rights-and-choices)
8. [Retention](#retention)
9. [How to Contact Us](#how-to-contact-us)
10. [Changes to this Privacy Policy](#changes-to-this-privacy-policy)
## Introduction
This privacy policy describes the personal data that Runner AI receives and/or processes (which may include collecting, organizing, structuring, storing, using, or disclosing) when you interact with Runner AI or use Runner AI Consumer Services, as defined in the Consumer Terms of Service, including while shopping with a merchant that uses or is powered by Runner AI's platform ("Runner AI Merchants" or "Merchants"). Additionally, please review our [overall privacy policy](/en/legal/policies) that applies to everyone whose information we process. If any provisions in this policy conflict with provisions of the overall privacy policy, the provisions in this policy will apply.
## What Personal Data We Receive
Personal Data is any information from or about an identified or identifiable person, but does not include aggregated or anonymized information. We receive Personal Data when you use or interact with Runner AI or Runner AI services, which may include the following categories:
### 1. Profile and Contact Information
We receive contact or other profile information when you sign up for or interact with Runner AI Consumer Services, which may include phone number, email address or other information you choose to provide us. We may link this information to the different devices or accounts you use when you interact with Runner AI or use the Runner AI Consumer Services.
### 2. Device Information
We receive information about the computers, phones, and other devices you use or interact with Runner AI or Runner AI Consumer Services, including IP address (which may be used to determine general location), device identifiers, cookie IDs, the browser you use, your network connection, or other unique identifiers or device information.
### 3. Payment Information
We receive payment information when you make a purchase through Runner AI or Runner AI Merchants, such as your payment card number and expiration date.
### 4. Use of Runner AI Consumer Services
We receive information regarding your use of or interactions with Runner AI Consumer Services, whether or not you are logged in to Runner AI, such as your interactions with Runner AI Merchants, the Shop(s) you visit, the products you view and visit, the product reviews and ratings you post and share, your order history, other marketing activities related to the Runner AI Consumer Services, and favorited Shops.
### 5. Settings and Privacy Preferences
We receive information about your settings and preferences on Runner AI and our Merchants, as well as information about your browser and device privacy settings.
### 6. Communications with Runner AI
We receive information, including message and email content, when you communicate with Runner AI (such as for customer support inquiries, taking surveys, participating in promotions or research).
### 7. Social Network Accounts
If you choose to link, connect, or login to Runner AI Consumer Services through a third party online service, you direct the service to send us certain information about you controlled by that service, such as profile information. This sharing is subject to the applicable privacy notices and your privacy settings of that service.
## How We Use Your Personal Data
Runner AI uses Personal Data for the following purposes depending on how you interact with us or which Runner AI services you use and based on your activity across all devices where you log in to, or interact with, Runner AI or Runner AI services:
### 1. Provide, Improve, and Customize Runner AI Services
To provide customized Runner AI services to you, including by displaying your purchase history and order status in one place, providing easy payment options when you shop, recommending products, Merchants and Shop(s) and customizing the products featured for you, and to improve Runner AI services, including based on your use of Runner AI Consumer Services and activity with our Merchant(s).
### 2. Track and Implement Your Privacy Preferences and Settings
To track and implement your settings and privacy preferences with Runner AI and our Merchants.
### 3. Perform Product Research and Development
To develop, test, and improve Runner AI services, including troubleshooting our products and services, developing new or improved Runner AI services, and analyzing your use of and interactions with Runner AI services.
### 4. Advertise, Market and Promote Runner AI
To market, advertise, and promote Runner AI services on and off Runner AI, including for personalized communications or advertisements relating to the Runner AI services on third-party services.
### 5. Provide Customized Advertising for our Merchants
To provide advertising services to our Merchants, which may include personalized advertising.
### 6. Communicate with You
To communicate with you about Runner AI services, including about product updates, your account, and changes to our policies and terms. We also use your information to respond to you when you contact us.
### 7. Authentication, Integrity, Security, and Safety
To authenticate your account, provide a secure payment and shopping experience, and to detect, investigate, and prevent malicious conduct, fraudulent activity or unsafe experiences, address security threats, protect public safety, and secure Runner AI Services for you and our Merchants.
### 8. Legal Reasons
To comply with applicable law or respond to valid legal process, including requests from law enforcement or government agencies, to investigate or participate in civil discovery, litigation, or other adversarial legal proceedings, and to enforce or investigate potential violations of our terms or policies.
Runner AI may also aggregate, de-identify, and/or anonymize any information collected through the Runner AI services in such a way that we cannot reasonably link information to you or your device. We may use such aggregate, de-identified, or anonymous information for any purpose, including, for example, to improve the Runner AI service.
## How We Process Your Personal Data on Behalf of Runner AI Merchants
Runner AI also processes your Personal Data from Merchants you interact or shop with in order to help Merchants run their Shop(s) and to provide business services to our Merchants. When Runner AI processes Personal Data in this way, we are acting at the direction of the Merchant, and the Merchants' terms of service and privacy policy apply—not Runner AI's. For more information about how Merchants collect and use personal information when you visit and make purchases in their Shop(s), review the Merchant's terms and privacy policy.
In addition, some Merchants may instruct us to use Personal Data they share with us for targeted advertising for these and other Merchants using these services on third-party sites. You may have the ability to opt out of allowing a Merchant to share your information with us for these purposes directly on that Merchant's site.
## Third-Parties Who May Receive Personal Data
Depending on which Runner AI services you use or interact with, Runner AI may provide Personal Data to the following categories of third parties:
### 1. Vendors
Runner AI works with third-party service providers to provide, support, and improve Runner AI services and technical infrastructure, for business services such as payment processing, including in relation to purchases made when you use Runner AI Services, and for marketing and business analytics.
### 2. Marketing, Advertising, and Analytics Partners
We may use third-party marketing, advertising, and business analytics partners to deliver personalized advertising and to help us understand how people use or interact with Runner AI services and our Merchants. These partners may receive information about your use of, or interactions with, Runner AI services, including through third-party cookies or other technologies.
### 3. Change of Control
We may share Personal Data with actual or prospective acquirers, their representatives and other relevant participants in, or during negotiations of, any sale, merger, acquisition, restructuring, or change in control involving all or a portion of Runner AI's business or assets, including in connection with bankruptcy or similar proceedings.
### 4. Legal Reasons
We may share Personal Data as needed to: (1) enforce or investigate potential violations of its Terms of Service or policies; (2) comply with applicable law or respond to, investigate, or participate in valid legal process and proceedings, including from law enforcement or government agencies; (3) protect our and our Merchants and users' rights and property; (4) meet our corporate and social responsibility commitments; (5) detect, prevent, or investigate potential fraud, abuse, or safety and security concerns, including threats to the public; and (6) resolve disputes and enforce agreements.
### 5. Sharing at Your Discretion
Where you provide consent, we share your information as described at the time of consent, such as when connecting with a third party application or website.
## Third Party Partners & Integrations
Parts of Runner AI services may link to third party services. Runner AI doesn't own or control these third parties. When you interact with these third parties and choose to use their services, your use is subject to the privacy policies of those providers.
## Your Privacy Rights and Choices
You may have certain rights to manage your Personal Data depending on where you live. Depending on your jurisdiction, the following rights may apply, subject to certain exceptions:
### 1. Access and Portability
Right to request access to your Personal Data.
### 2. Correction / Rectification
Right to correct inaccurate or incomplete Personal Data in certain circumstances.
### 3. Deletion / Erasure
Right to delete Personal Data about you.
### 4. Right to opt out of "sharing" for cross-context behavioral advertising or targeted advertising
Right to opt-out of the "sharing" of your Personal Data for cross context behavioral advertising or targeted advertising (as further described in the Third-Parties Who May Receive Personal Data section).
You can also update your account information in your in-app settings. To deactivate or delete your account, email support@adaptivemachines.ai. You may have additional rights available to you. The request can be submitted via email to support@adaptivemachines.ai. Additionally, please see our [overall privacy policy](/en/legal/policies) for more information.
## Retention
We retain Personal Data for as long as we have an ongoing business need to do so (e.g., to provide the Runner AI services, to comply with applicable legal, tax, or accounting requirements, for security and fraud detection or prevention, or in connection with backup or disaster recovery processes), unless a different retention period is permitted or required by applicable law.
The criteria used to determine our retention periods include the following:
1. The length of time we have an ongoing relationship with you and provide Runner AI services to you (for example, for as long as you have an account with us or keep using our services);
2. Whether you modify or delete your information through your accounts;
3. Whether Runner AI has a legal obligation to keep the data (for example, certain laws require Runner AI to keep records of your transactions for a certain period of time); or
4. Whether retention is advisable in light of our legal position (such as in regard to the enforcement of our agreements, the resolution of disputes, the applicable statutes of limitations, litigation, or regulatory investigation).
## How to Contact Us
If you want to exercise your rights, or if you have any questions or concerns related to this Privacy Policy, you may contact us by support@adaptivemachines.ai.
## Changes to this Privacy Policy
We may update this Privacy Policy periodically to account for changes in our collection and/or processing of Personal Data, and we will post the updated Privacy Policy on our website, with a "Last Updated" date at the top.
---
# Privacy Policy for merchants
Source: https://www.runnerai.com/docs/en/legal/policies/merchants
## Table of Content
1. [Introduction](#introduction)
2. [What information we collect about you and why](#what-information-we-collect-about-you-and-why)
3. [When and Why We Share Your Information with Others](#when-and-why-we-share-your-information-with-others)
4. [Google Ads and Google Merchant Center integrations](#google-ads-and-google-merchant-center-integrations)
5. [Your Rights Regarding Your Information](#your-rights-regarding-your-information)
6. [How Long We Keep Your Information](#how-long-we-keep-your-information)
7. [Your Customer Information](#your-customer-information)
## Introduction
If you are a merchant using Runner AI to support your business, we collect and use your personal information to provide you with access to our platform and its services, and generally to help you better manage your business and relationships with customers.
When we process personal information of your customers ("End Users"), we do so as a Data Processor on behalf of you, our Merchant. You, the Merchant, are the Data Controller for your End Users' information. This means you are responsible for legal compliance with applicable data protection laws, including providing your own privacy policy and obtaining any necessary consents from your End Users.
Additionally, please review our [overall privacy policy](/en/legal/policies), which applies to everyone whose information we process.
## What information we collect about you and why
We collect personal information when you sign up for Runner AI, when you use our platform, or when you otherwise provide us information. We may also use third-party service providers to help us review accounts for fraud or other issues. Generally, we need information about you to enable you to use our platform. We process your personal data to fulfill our contract with you, or because maintaining our business relationship, preventing risks and fraud, providing you with efficient services, improving our products and services, and responding to your service requests align with our legitimate interests. In some cases, we will only process your personal information with your consent.
| What we collect | How We Use It |
|-----------------|---------------|
| Information you provide us about you and your business, like your name, the name of your staff or other individuals associated with your business, company name, address, email address, and phone number. | To provide you with the use of our platform and other related services (e.g., to confirm your identity, to contact you about issues with the platform, to invoice you) To advertise and market products or features to you To comply with legal requirements To prevent fraudulent use of our services |
| Payment information you provide us, such as your credit or debit card number or your bank account number. | To provide you with the use of our platform and other related services To charge for our services |
| Information about how you access Runner AI websites, your account, and our platform, including information about the device and browser you use, your network connection, your IP address, and details about how you browse our websites and platform. We collect some of this information by using "cookies" or other similar technologies directly from your device. For more information about how we use these technologies, see our Cookie Policy. | To provide you use of, and to improve, our platform and other related services (e.g., identifying ways to make our platform easier to use or navigate) To advertise and market products or features to you To prevent fraudulent use of our services |
| Copies of government-issued and/or a picture of yourself holding your identification that you provide us | If we need to verify your identity (e.g., to protect you against identity theft or fraud) To verify that we are speaking with you if you contact us To help us determine or verify account ownership To comply with legal requirements |
| Google account, Google Ads, and Google Merchant Center information you authorize Runner AI to access, such as Google sign-in profile information, OAuth tokens and granted scopes, accessible Google Ads customer accounts, account names, manager-account status, selected account bindings, campaign and creative data, performance metrics, change history, and Merchant Center account identifiers and names. | To sign you in, connect and refresh your Google integrations, list selectable ad and Merchant Center accounts, show ads dashboards and reports, generate requested AI ads analysis or campaign drafts, publish or update campaigns you approve, sync account access, troubleshoot issues, and secure the integration. |
We also work with companies that provide us with information about merchants or prospective merchants (for example, to protect against fraud or if we're sponsoring an event).
## When and Why We Share Your Information with Others
Running a business is hard, and we work with multiple companies to help us provide you with a range of services to support your business. We sometimes share your personal information with these companies to help us provide you with Runner AI services.
We also share your personal information with others:
- To prevent or investigate suspected fraud, threats to physical safety, illegal activities, or breaches of contract or our other website agreements.
- To help us with marketing and advertising.
- To comply with legal requirements, or respond to court orders or similar government requests.
- For asset sales or purchases, stock sales, purchases or mergers, bankruptcy, or other business transactions or reorganizations, we will share your personal data with potential buyers, sellers, new owners, or other relevant third parties as necessary during negotiations or in connection with a change in company control (such as a reorganization, merger, or sale of our assets).
Additionally, almost every merchant using the Runner AI platform also uses non-Runner AI services to support their business (sales channels, payment gateways, or shipping providers).
Runner AI has no control over how these services use your personal information, and you should check any other services you use to ensure they meet your privacy expectations.
## Google Ads and Google Merchant Center integrations
If you connect Google Ads or Google Merchant Center to Runner AI, we use the Google user data you authorize only to provide the connected ads features you request. We share, transfer, or disclose that Google user data only with:
- Google LLC, to exchange OAuth codes and tokens, call Google Ads and Merchant Center APIs, read the data you authorized, and perform the Google Ads or Merchant Center actions you request.
- Authorized users in your Runner AI organization, according to their workspace permissions.
- Service providers and subprocessors that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- Legal, safety, and business-transfer recipients when required by law or as described in our overall Privacy Policy.
We do not sell Google user data, and we do not share it with third-party advertising platforms, data brokers, or information resellers except as described above or with your explicit direction. For more detail, see [Google user data and Google integrations](/en/legal/policies#google-user-data-and-google-integrations) in our overall Privacy Policy.
## Your Rights Regarding Your Information
You can access and correct much of your personal information directly through your Runner AI admin. For information you cannot access or correct directly in your Runner AI admin, please submit a data subject request via our support@adaptivemachines.ai. For more information, please see our [overall privacy policy](/en/legal/policies). Please note that certain data subject rights only apply in specific circumstances, and all of these rights may be limited by law.
## How Long We Keep Your Information
Since we need your personal information to provide Runner AI services, we generally retain your personal information for as long as you use Runner AI products or services. If you close your store, stop paying subscription fees, or we terminate your account, we will retain store information for two years before beginning to delete or anonymize personal information. We will not do this immediately if you reactivate your account or if there are legal complaints or audits related to your business. If you contact us to request deletion of your store's information, we will begin the process of deleting or anonymizing personal information after 90 days, unless we are required by law to retain specific information. If you have any questions about this process, please contact our support team by support@adaptivemachines.ai. Please remember that after we anonymize your personal information, we may continue to use non-identifying information to improve our services.
## Your Customer Information
To help grow your business, we collect and use personal information about your customers. Typically, we collect and use this personal information as directed by you. Legally, we are a "data processor" and "service provider," as these terms are used in certain applicable privacy laws, including those in the United States, Canada, Europe, and the United Kingdom.
Since you decide how to use your customers' personal information, you need to ensure your customers understand how you (and how we on your behalf) collect and process their personal information. To do this, you should at least post a privacy policy in your store that describes the information you collect, how you use it, and with whom you share it.
If you collect any "sensitive" personal information from customers (e.g., information about a consumer's Social Security, driver's license, state ID, or passport number; account login information, financial account information, debit or credit card numbers, and any required security codes or passwords; precise geolocation information; health or genetic data, racial or ethnic origin, religious or philosophical beliefs, or union membership; the contents of a consumer's mail, email, or text messages; or criminal offense data), you should obtain explicit consent from the customer to use and process this information.
---
# Privacy Policy for visitors
Source: https://www.runnerai.com/docs/en/legal/policies/visitors
## Table of Content
1. [Introduction](#introduction)
2. [Information We Collect About You and Why](#information-we-collect-about-you-and-why)
3. [When and Why We Share Your Information with Others](#when-and-why-we-share-your-information-with-others)
4. [Your Rights Regarding Your Information](#your-rights-regarding-your-information)
## Introduction
If you visit a Runner AI website or contact Runner AI customer support, we typically use your personal information to provide you with the specific service you are using. Additionally, please review our [overarching Privacy Policy](/en/legal/policies), which applies to everyone whose information we process.
## Information We Collect About You and Why
When you visit our websites or contact Runner AI support, we collect the following personal information about you. We process your personal data to fulfill our contractual obligations to you, to maintain our business relationship, prevent risks and fraud, provide efficient services, improve our products and services, and respond to your requests in accordance with our legitimate interests. In some cases, we process your personal information only with your consent.
| What we collect | How We Use It |
|-----------------|---------------|
| Information about you that you provide us about yourself, like your name, address, email address, and phone number. | To provide you use of, and to improve, the app or service you are trying to use (e.g., to confirm your identity, to contact you about issues with the platform, to invoice you) To verify that we are speaking with you To advertise and market products or features to you To comply with legal requirements |
| Payment information you provide us, such as your payment card number or bank account number. | To enable you to make a payment |
| Information about how you access and use Runner AI websites, and other services, including information about the device and browser you use, your network connection, your IP address, and details about how you browse through our sites, including search terms you may enter. We collect some of this information by using "cookies" or other similar technologies directly from your device. For more information about how we use these technologies, see our Cookie Policy. | To provide you use of, and to improve, our websites and related services (e.g., identifying ways to make our platform easier to use or navigate) To personalize your experience using our websites (e.g., by changing the layout of our webpages) To advertise and market products or features to you |
## When and Why We Share Your Information with Others
We share your personal information with companies that help us provide services to you. We may also share your information:
- To prevent or investigate fraud, threats to safety, illegal activity, or breaches of contracts (e.g., our Terms of Service).
- To support marketing and advertising efforts.
- To comply with legal obligations or respond to court orders, government requests.
- During business transactions (e.g., mergers, acquisitions, asset sales, bankruptcy), we share data with potential buyers, sellers, or relevant third parties involved in negotiations or restructuring.
## Your Rights Regarding Your Information
Please submit a data subject request through support@adaptivemachines.ai if you would like to access or request that we delete your personal information. Please keep in mind that after we anonymize your information, we will continue to use non-identifiable information to improve our services. Please note that some data subject rights only apply in certain circumstances, and all of these rights may be limited by law.
---
# List of Subprocessors
Source: https://www.runnerai.com/docs/en/legal/subprocessors
## List of Subprocessors
To support the delivery of our Services, Adaptive Machines, Inc. ("Runner AI", "we", or "us") uses third-party service providers as subprocessors to process personal data. Runner AI affiliated entities and third-party subprocessors help Runner AI process personal data for merchants in accordance with our [Data Processing Addendum](/en/legal/dpa).
The Subprocessors used by Runner AI for the performance of the Services under the Terms are listed below.
## Third-party subprocessors
| Subprocessor | Service provided | Corporate headquarters | Data that may be processed |
|--------------|------------------|------------------------|----------------------------|
| Vercel Inc. | Hosting and deployment services | USA | Platform data necessary to host and serve the application |
| Google LLC | Cloud hosting and data processing | USA | All platform data |
| Google DeepMind | Conversational artificial intelligence services | USA | Personal data if input at Runner AI chatbox |
| OpenRouter, Inc. | Conversational artificial intelligence services | USA | Personal data if input at Runner AI chatbox |
| Klaviyo, Inc. | Email transmission | USA | Personal data as necessary to provide Runner AI Email |
---
# Terms of Service
Source: https://www.runnerai.com/docs/en/legal/tos
## Terms of Service
### Table of Content
1. [Account Terms](#1-account-terms)
2. [Account Activation](#2-account-activation)
3. [Runner AI Rights](#3-runner-ai-rights)
4. [Your Responsibilities](#4-your-responsibilities)
5. [Payment of Fees and Taxes](#5-payment-of-fees-and-taxes)
6. [Confidentiality](#6-confidentiality)
7. [Limitation of Liability and Indemnification](#7-limitation-of-liability-and-indemnification)
8. [Intellectual Property and Your Materials](#8-intellectual-property-and-your-materials)
9. [Additional Services](#9-additional-services)
10. [Feedback and Reviews](#10-feedback-and-reviews)
11. [DMCA Notice and Takedown Procedure](#11-dmca-notice-and-takedown-procedure)
12. [Privacy and Data Protection](#12-privacy-and-data-protection)
13. [Runner AI Contracting Party](#13-runner-ai-contracting-party)
14. [Term and Termination](#14-term-and-termination)
15. [Modifications](#15-modifications)
16. [General Conditions](#16-general-conditions)
**Last updated on: October 15, 2025**
Welcome to Runner AI! By signing up for a Runner AI Account (as defined in Section 1) or by using any Runner AI Services (as defined below), you are agreeing to be bound by the following terms and conditions (the "Terms of Service").
As used in these Terms of Service, "Company", "we", "us", and "our" refer to Adaptive Machines, Inc. (as defined in Section 13). "You" means the Runner AI User (if registering for or using a Runner AI Service as an individual), or the business employing the Runner AI User (if registering for or using a Runner AI Service as a business) and any of its affiliates.
Runner AI provides a complete commerce platform that enables merchants to unify their commerce activities. Among other features, this platform includes a range of tools for merchants to build and customize online stores, sell in multiple places (including web, mobile, social media, online marketplaces and other online locations ("Online Services"), manage products, inventory, payments, fulfillment, shipping, business operations, marketing and advertising, and engage with existing and potential customers. Any such service or services offered by Runner AI are referred to in these Terms of Services as the "Service(s)". Any new features or tools which are added to the current Services will also be subject to the Terms of Service. You can review the current version of the Terms of Service at any time at https://www.runnerai.com/docs/en/legal/tos.
You must read, agree with and accept all of the terms and conditions contained or expressly referenced in these Terms of Service, including Runner AI's [Acceptable Use Policy](/en/legal/aup) ("AUP") and [Privacy Policy](/en/legal/policies), and [Data Processing Addendum](/en/legal/dpa) ("DPA") before you may sign up for a Runner AI Account or use any Runner AI Service.
Please read the Terms of Service, including any document referred to in these Terms of Service, for the complete picture of your legal requirements. By using Runner AI or any Runner AI services, you are agreeing to these terms. Be sure to occasionally check back for updates.
## 1. Account Terms
### Which means
You are responsible for your Account, the Materials you upload to the Runner AI Service and the operation of your Runner AI Store. If you violate Runner AI's terms of service we may cancel your service access. If we need to reach you, we will communicate via the Primary Email Address.
(1) To access and use the Services, you must register for a Runner AI account ("Account"). To complete your Account registration, you must provide us with your full legal name, business address, phone number, a valid email address, and any other information indicated as required. Runner AI may reject your application for an Account, or cancel an existing Account, for any reason, at our sole discretion.
(2) You must be the older of: (i) 18 years, or (ii) at least the age of majority in the jurisdiction where you reside and from which you use the Services to open an Account.
(3) You confirm that you are receiving any Services provided by Runner AI for the purposes of carrying on a business activity and not for any personal, household or family purpose.
(4) You acknowledge that Runner AI will use the email address you provide on opening an Account or as updated by you from time to time as the primary method for communication with you ("Primary Email Address"). You must monitor the Primary Email Address you provide to Runner AI and your Primary Email Address must be capable of both sending and receiving messages. Your email communications with Runner AI can only be authenticated if they come from your Primary Email Address.
(5) You are responsible for keeping your password secure. Runner AI cannot and will not be liable for any loss or damage from your failure to maintain the security of your Account and password. We may request additional security measures at any time and reserve the right to adjust these requirements at our discretion.
(6) Technical support in respect of the Services is only provided to Runner AI Users. Questions about the Terms of Service should be sent to Runner AI Support.
(7) You agree not to reproduce, duplicate, copy, sell, resell or exploit any portion of the Service, use of the Services, or access to the Services without the express written permission by Runner AI.
(8) You agree not to work around, bypass, or circumvent any of the technical limitations of the Services, use any tool to enable features or functionalities that are otherwise disabled in the Services, or decompile, disassemble or otherwise reverse engineer the Services.
(9) You agree not to access the Services or monitor any material or information from the Services using any robot, spider, scraper, or other automated means.
(10) You understand that your Materials may be transferred unencrypted and involve (a) transmissions over various networks; and (b) changes to conform and adapt to technical requirements of connecting networks or devices. "Materials" means Your Trademarks, copyright content, any products or services you sell through the Services (including description and price), and any photos, images, videos, graphics, written content, audio files, code, information, or other data provided or made available by you or your affiliates to Runner AI or its affiliates.
## 2. Account Activation
### Which means
Only one person can be the "Store Owner", usually the person signing up for the Runner AI Service. The Store Owner is responsible for the Account, is bound by these Terms of Service and is responsible for the actions of others accessing the Account. If you sign up on behalf of your employer, your employer is the Store Owner responsible for your Account.
### 2.1 Store Owner
(1) Subject to Section 2.1.2, the person signing up for the Service by opening an Account will be the contracting party ("Store Owner") for the purposes of our Terms of Service and will be the person who is authorized to use any corresponding Account we may provide to the Store Owner in connection with the Service. You are responsible for ensuring that the name of the Store Owner (including the legal name of the company that owns the Store, if applicable) is clearly visible on the Store's website.
(2) If you are signing up for the Services on behalf of your employer, your employer will be the Store Owner. If you are signing up for the Services on behalf of your employer, then you must use your employer-issued email address and you represent and warrant that you have the authority to bind your employer to our Terms of Service.
(3) Your Runner AI Store can only be associated with one Store Owner. A Store Owner may have multiple Runner AI Stores. "Store" means the online store (whether hosted by Runner AI or on a third party website), or physical retail location(s) associated with the Account.
### 2.2 Staff Accounts
(1) Based on your Runner AI pricing plan, you can create one or more staff accounts ("Staff Accounts") allowing other people to access the Account. Each Staff Account must include a full legal name and a valid email account. With Staff Accounts, the Store Owner can set permissions and let other people work in their Account while determining the level of access by Staff Accounts to specific business information (for example, you can limit Staff Account access to sales information on the Reports page or prevent Staff Accounts from changing general store settings).
(2) The Store Owner is responsible for: (a) ensuring its employees, agents and subcontractors, including via Staff Accounts, comply with these Terms of Service; and (b) any breach of these Terms of Service by the Store Owner's employees, agents or subcontractors. The Store Owner acknowledges and agrees that Store Owner will be responsible for the performance of all of its obligations under the Agreement, regardless of whether it sublicenses or subcontracts any such obligations to any third party, including but not limited to any affiliates or subsidiaries of Store Owner.
(3) The Store Owner and the users under Staff Accounts are each referred to as a "Runner AI User".
### 2.3 Third-Party Payment Providers
Our Services integrate with various third-party payment providers to allow you to process payments for your transactions. Your relationship with such payment providers is governed by their respective terms and conditions. You are solely responsible for creating and maintaining your accounts with these providers and for all activities related to your payment processing.
## 3. Runner AI Rights
### Which means
Runner AI has the right to control who we make our Services available to and we can modify them at any time. We also have the right to refuse or remove Materials from any part of the Services, including your Store. We may offer our services to your competitors, but we will never share your confidential information with them in doing so. In the event of an ownership dispute over a Runner AI Account, we can freeze a Runner AI Account or transfer it to the rightful owner, as determined by us.
(1) The Services have a range of features and functionalities. Not all Services or features will be available to all Merchants at all times and we are under no obligation to make any Services or features available in any jurisdiction. Except where prohibited in these Terms of Service or by applicable law, we reserve the right to modify the Services or any part thereof for any reason.
(2) Runner AI does not pre-screen Materials and it is in our sole discretion to refuse or remove any Materials from any part of the Services, including if we determine in our sole discretion that the goods or services that you offer through the Services, or the Materials uploaded or posted to the Services, violate these Terms of Service.
(3) Verbal or written abuse of any kind (including threats of abuse or retribution) of any Runner AI employee, member, or officer will result in immediate Account termination.
(4) We reserve the right to provide our Services to your competitors and make no promise of exclusivity. You further acknowledge and agree that Runner AI employees and contractors may also be Runner AI customers or merchants and that they may compete with you, although they may not use your Confidential Information (as defined in Section 6) in doing so.
(5) In the event of a dispute regarding Account ownership, we reserve the right to request documentation to determine or confirm Account ownership. Documentation may include, but is not limited to, a scanned copy of your business license, government issued photo ID, the last four digits of the credit card on file, or confirmation of your status as an employee of an entity.
(6) Runner AI reserves the right to determine, in our sole discretion, rightful Account ownership and transfer an Account to the rightful Store Owner. If we are unable to reasonably determine the rightful Store Owner, without prejudice to our other rights and remedies, Runner AI reserves the right to temporarily suspend or disable an Account until resolution has been determined between the disputing parties.
## 4. Your Responsibilities
### Which means
You are responsible for your Runner AI Store, the goods or services you sell, and your relationship with your customers, not us.
(1) You acknowledge and agree to provide public-facing contact information, a refund policy and order fulfilment timelines on your Runner AI Store.
(2) You acknowledge and agree that the Services are not a marketplace, and any contract of sale made through the Services is directly between you and the customer. You are the seller of record for all items you sell through the Services. You are responsible for the creation and operation of your Runner AI Store, your Materials, the goods and services that you may sell through the Services, and all aspects of the transactions between you and your customer(s). This includes, but is not limited to, authorizing the charge to the customer in respect of the customer's purchase, refunds, returns, fulfilling any sales or customer service, fraudulent transactions, required legal disclosures, regulatory compliance, alleged or actual violation of applicable laws (including but not limited to consumer protection laws in any jurisdiction where you offer products or services for sale), or your breach of these Terms of Service. You represent and warrant that your Store, your Materials and the goods and services you sell through the Services will be true, accurate, and complete, and will not violate any applicable laws, regulations or rights of third parties. For the avoidance of doubt, Runner AI will not be the seller or merchant or record and will have no responsibility for your Store or items sold to customers through the Services.
(3) You are solely responsible for the goods or services that you may sell through the Services (including description, price, fees, tax that you calculate, defects, required legal disclosures, regulatory compliance, offers or promotional content), including compliance with any applicable laws or regulations.
(4) You may not use the Runner AI Services for any illegal or unauthorized purpose nor may you, in the use of the Service, violate any laws in your jurisdiction (including but not limited to copyright laws), the laws applicable to you in your customer's jurisdiction, or the laws of the State of Delaware. You will comply with all applicable laws, rules and regulations (including but not limited to obtaining and complying with the requirements of any license or permit that may be necessary to operate your store or that may be held by you) in your use of the Service and your performance of obligations under the Terms of Service.
## 5. Payment of Fees and Taxes
### Which means
A valid payment method (such as a credit card) must remain on file to pay all service fees, including the subscription, transaction and additional fees required for all stores. You will be billed for your Subscription Fees every 30 days. Any Transaction Fees or Additional Fees will be charged to your payment method. If we are unable to process payment of Fees using your payment method, we may make subsequent attempts to process payment of Fees using your payment method. If payment of Fees is unsuccessful within 30 days of our initial attempt to process payment, Runner AI may freeze your store. You are responsible for all taxes relating to your Store or use of the Services. You may be required to remit Taxes to Runner AI or to self-remit to your local taxing authority. No refunds.
(1) You will pay the Fees applicable to your subscription to Online Service and ("Subscription Fees") and any other applicable fees, including but not limited to applicable fees relating to the value of sales made through your Store when using a third-party payment provider to process customer payments. ("Transaction Fees"), and any fees relating to your purchase or use of any products or services such as shipping, Credit Boost Pack or Third Party Services ("Additional Fees"). Together, the Subscription Fees, Transaction Fees and the Additional Fees are referred to as the "Fees".
(2) You must keep a valid payment method on file with us to pay for all incurred and recurring Fees. Runner AI will charge applicable Fees to any valid payment method that you authorize ("Authorized Payment Method"), and Runner AI will continue to charge the Authorized Payment Method for applicable Fees until the Services are terminated, and any and all outstanding Fees have been paid in full. Unless otherwise indicated, all Fees and other charges are in U.S. dollars, and all payments will be in U.S. currency.
(3) Subscription Fees are paid in advance and will be billed in 30 day intervals (each such date, a "Billing Date"). Transaction Fees and Additional Fees will be charged from time to time at Runner AI's discretion. You will be charged on each Billing Date for all outstanding Fees that have not previously been charged. Fees will appear on an invoice, which will be sent to the Store Owner via the Primary Email Address provided. As well, an invoice will appear on the Account page of your Store's administrative console. Users have approximately two weeks to bring up and settle any issues with the billing of Subscription Fees.
(4) If we are not able to process payment of Fees using an Authorized Payment Method, we may make subsequent attempts to process payment using any Authorized Payment Method. If we are unable to successfully process payment of Fees using an Authorized Payment Method within 30 days of our initial attempt, we may suspend and revoke access to your Account and the Services. Your Account will be reactivated upon your payment of any outstanding Fees, plus the Fees applicable to your next billing cycle. You may not be able to access your Account or your storefront during any period of suspension.
(5) All Fees are exclusive of applicable federal, state, local or other governmental sales, goods and services, harmonized or other taxes, fees or charges now in force or enacted in the future ("Taxes").
(6) You are responsible for all applicable Taxes that arise from or as a result of your subscription to or purchase of Runner AI's products and services. To the extent that Runner AI charges these Taxes, they are calculated using the tax rates that apply based on the billing address you provide to us. Such amounts are in addition to the Fees for such products and services and will be billed to your Authorized Payment Method. If you are exempt from payment of such Taxes, you must provide us with evidence of your exemption, which in some jurisdictions includes an original certificate that satisfies applicable legal requirements attesting to tax-exempt status. Tax exemption will only apply from and after the date we receive evidence satisfactory to Runner AI of your exemption. If you are not charged Taxes by Runner AI, you are responsible for determining if Taxes are payable, and if so, self-remitting Taxes to the appropriate tax authorities in your jurisdiction.
(7) For the avoidance of doubt, all sums payable by you to Runner AI under these Terms of Service will be paid free and clear of any deductions or withholdings whatsoever. Other than Taxes charged by Runner AI to you and remitted to the appropriate tax authorities on your behalf, any deductions or withholdings that are required by law will be borne by you and paid separately to the relevant taxation authority. Runner AI will be entitled to charge the full amount of Fees stipulated under these Terms of Service to your Authorized Payment Method ignoring any such deduction or withholding that may be required.
(8) You are solely responsible for determining, collecting, withholding, reporting, and remitting applicable taxes, duties, fees, surcharges and additional charges that arise from or as a result of any sale on your Runner AI Store or your use of the Services. The Services are not a marketplace. Any contract of sale made through the Services is directly between you and the customer.
(9) You must maintain an accurate location in the administrative console of your Runner AI Store. If you change jurisdictions you must promptly update your location in the administrative console.
(10) Runner AI does not provide refunds.
## 6. Confidentiality
### Which means
Both you and Runner AI agree to use the Confidential Information of the other only to perform the obligations in these Terms of Service. Confidential Information must be protected and respected.
(1) "Confidential Information" will include, but will not be limited to, any and all information associated with a party's business and not publicly known, including specific business information, technical processes and formulas, software, customer lists, prospective customer lists, names, addresses and other information regarding customers and prospective customers, product designs, sales, costs (including any relevant processing fees), price lists, and other unpublished financial information, business plans and marketing data, and any other confidential and proprietary information, whether or not marked as confidential or proprietary. Runner AI's Confidential Information includes all information that you receive relating to us, or to the Services, that is not known to the general public including information related to our security program and practices.
(2) Each party agrees to use the other party's Confidential Information solely as necessary for performing its obligations under these Terms of Service and in accordance with any other obligations in these Terms of Service including this Section 6. Each party agrees that it will take all reasonable steps, at least substantially equivalent to the steps it takes to protect its own proprietary information, to prevent the duplication, disclosure or use of any such Confidential Information, other than (i) by or to its employees, agents and subcontractors who must have access to such Confidential Information to perform such party's obligations hereunder, who each will treat such Confidential Information as provided herein, and who are each subject to obligations of confidentiality to such party that are at least as stringent as those contained herein; or (ii) as required by any law, regulation, or order of any court of proper jurisdiction over the parties and the subject matter contained in these Terms of Service, provided that, if legally permitted, the receiving party will give the disclosing party prompt written notice and use commercially reasonable efforts to ensure that such disclosure is accorded confidential treatment. Confidential Information will not include any information that the receiving party can prove: (A) was already in the public domain, or was already known by or in the possession of the receiving party, at the time of disclosure of such information; (B) is independently developed by the receiving party without use of or reference to the other party's Confidential Information, and without breaching any provisions of these Terms of Service; or (C) is thereafter rightly obtained by the receiving party from a source other than the disclosing party without breaching any provision of these Terms of Service.
## 7. Limitation of Liability and Indemnification
### Which means
We are not responsible for damages or lawsuits that arise if you break the law, breach this agreement or go against the rights of a third party. The Service is provided on an "as is" and "as available" basis. We provide no warranties and our liability is limited in the event of errors or interruptions.
(1) You expressly understand and agree that, to the extent permitted by applicable laws, Runner AI and its suppliers will not be liable for any direct, indirect, incidental, special, consequential or exemplary damages, including but not limited to, damages for loss of profits, goodwill, use, data or other intangible losses arising out of or relating to the use of or inability to use the Service or these Terms of Service (however arising, including negligence).
TO THE MAXIMUM EXTENT PERMITTED BY LAW, NOTWITHSTANDING ANYTHING TO THE CONTRARY CONTAINED HEREIN, OUR LIABILITY TO YOU FOR ANY DAMAGES ARISING FROM OR RELATED TO THESE TERMS (FOR ANY CAUSE WHATSOEVER AND REGARDLESS OF THE FORM OF THE ACTION), WILL AT ALL TIMES BE LIMITED TO THE AMOUNT OF FEES YOU PAID TO US IN THE PRECEDING SIX (6) MONTHS (OR, IF NO FEES HAVE BEEN PAID, TO A MAXIMUM OF FIFTY US DOLLARS ($50)). THE EXISTENCE OF MORE THAN ONE CLAIM WILL NOT ENLARGE THIS LIMIT.
(2) You agree to indemnify and hold us and (as applicable) our parent, subsidiaries, affiliates, Runner AI partners, officers, directors, agents, employees, and suppliers harmless from any claim or demand, including reasonable attorneys' fees, made by any third party due to or arising out of (a) your breach of these Terms of Service or the documents it incorporates by reference (including the AUP); (b) or your violation of any law or the rights of a third party; or (c) any aspect of the transaction between you and your Customer, including but not limited to refunds, fraudulent transactions, alleged or actual violation of applicable laws (including but not limited to Federal and State consumer protection laws), or your breach of the Terms of Service.
(3) You will be responsible for any breach of the Terms of Service by your affiliates, agents or subcontractors and will be liable as if it were your own breach.
(4) Your use of the Services is at your sole risk. The Services are provided on an "as is" and "as available" basis without any warranty or condition, express, implied or statutory.
(5) Runner AI does not warrant that the Services will be uninterrupted, timely, secure, or error-free.
(6) Runner AI does not warrant that the results that may be obtained from the use of the Services will be accurate or reliable.
Specifically, you acknowledge that the Services utilize artificial intelligence and machine learning algorithms to provide features such as automated operations and growth suggestions. You understand that these are probabilistic systems and Runner AI makes no warranty regarding the profitability, success, or specific outcomes of any actions taken based on the outputs or suggestions of these AI systems.
(7) Runner AI is not responsible for any of your tax obligations or liabilities related to the use of Runner AI's Services.
(8) Runner AI does not warrant that the quality of any products, services, information, or other materials purchased or obtained by you through the Services will meet your expectations, or that any errors in the Services will be corrected.
(9) In no event shall Runner AI be liable for any loss of revenue, data, or customer goodwill resulting from the use of Experiments or the performance of any AI-generated experiments.
## 8. Intellectual Property and Your Materials
### Which means
Anything you upload remains yours (if it was yours) and is your responsibility, but Runner AI can use and publish the things you upload. Anything uploaded to Runner AI remains the property and responsibility of its initial owner. However, Runner AI will receive a license of materials published through our platform that we may use to operate and promote our Services.
### 8.1 Your Materials
(1) We do not claim ownership of the Materials you provide to Runner AI; however, we do require a license to those Materials. You grant the company a non-exclusive, transferable, sub-licensable, royalty-free, worldwide right and license to host, use, distribute, expose, modify, run, copy, store, publicly perform, communicate to the public (including by telecommunication), broadcast, reproduce, make available, display, and translate, and create derivative works of any Materials provided by you in connection with the Services. We may use our rights under this license to operate, provide, and promote the Services and to perform our obligations and exercise our rights under the Terms of Service. You represent, warrant, and agree that you have all necessary rights in the Materials to grant this license. You irrevocably waive any and all moral rights you may have in the Materials in favour of Runner AI and agree that this waiver may be invoked by anyone who obtains rights in the materials through Runner AI, including anyone to whom Runner AI may transfer or grant (including by way of license or sublicense) any rights in the Materials.
(2) If you owned the Materials before providing them to Runner AI then, despite uploading them to your Runner AI Store they remain yours, subject to any rights or licenses granted in the Terms of Service or elsewhere. You can remove your Runner AI Store at any time by deleting your Account. Removing your Runner AI Store does not terminate any rights or licenses granted to the Materials that Runner AI requires to exercise any rights or perform any obligations that arose during the Term.
(3) You agree that Runner AI can, at any time, review and delete any or all of the Materials submitted to the Services, although Runner AI is not obligated to do so.
(4) You grant Runner AI a non-exclusive, transferable, sub-licensable, royalty-free, worldwide right and license to use the names, trademarks, service marks and logos associated with your Store ("Your Trademarks") to operate, provide, and promote the Services and to perform our obligations and exercise our rights under the Terms of Service. This license will survive any termination of the Terms of Service solely to the extent that Runner AI requires the license to exercise any rights or perform any obligations that arose during the Term.
### 8.2 Runner AI Intellectual Property
(1) You agree that you may not use any trademarks, logos, or service marks of Runner AI, whether registered or unregistered, including but not limited to the word mark Runner AI, and graphic mark Runner AI ("Runner AI Trademarks") unless you are authorized to do so by Runner AI in writing. You agree not to use or adopt any marks that may be considered confusing with the Runner AI Trademarks. You agree that any variations or misspellings of the Runner AI Trademarks would be considered confusing with the Runner AI Trademarks.
(2) You agree not to purchase, register, or use search engine or other pay-per-click keywords (such as Google Ads), trademarks, email addresses, social media names, or domain names (including without limitation top-level domains, sub-domains, and page URLs) that use or include Runner AI or Runner AI Trademarks or that use or include any terms that may be confusing with the Runner AI Trademarks.
(3) You acknowledge and agree that the Terms of Service do not give you any right to implement Runner AI patents.
### 8.3 Data Usage for AI Improvement
To monitor, improve, and protect our Services, and to optimize our artificial intelligence algorithms and models, you grant us a perpetual, irrevocable, worldwide, royalty-free right to use your 'Materials' and associated operational data in an anonymized and aggregated form. We commit that any such use will not identify any specific individual, merchant, or their customers, and will be used solely for the purpose of enhancing the overall service quality and technical capabilities of our platform.
## 9. Additional Services
### 9.1 Third-Party Shipping Integrations
Our Services may integrate with various third-party shipping carriers and services to manage your fulfillment. Your use of such third-party services is subject to their respective terms and conditions, and you are solely responsible for your relationship with them.
### 9.2 Beta Services
#### Which means
Beta Services may be offered from time to time. They are not a part of the regular Services, and they might have errors or change at any time. You use Beta Services at your own risk, and we are not responsible for any losses or harm that might come from using a Beta Service. You may be required to keep your participation in the Beta Services confidential.
From time to time, Runner AI may, in its sole discretion, invite you to use, on a trial basis, pre-release or beta features that are in development and not yet available to all merchants ("Beta Services"). Beta Services are not part of the Services, and Beta Services may be subject to additional terms and conditions, which Runner AI will provide to you prior to your use of the Beta Services. Such Beta Services and all associated conversations and materials relating thereto will be considered Runner AI Confidential Information and subject to the confidentiality provisions in this agreement. Without limiting the generality of the foregoing, you agree that you will not make any public statements or otherwise disclose your participation in the Beta Services without Runner AI's prior written consent. Runner AI makes no representations or warranties that the Beta Services will function. Runner AI may discontinue the Beta Services at any time in its sole discretion. Runner AI will have no liability for any harm or damage arising out of or in connection with a Beta Service. The Beta Services may not work in the same way as a final version. Runner AI may change or not release a final or commercial version of a Beta Service in our sole discretion.
### 9.3 Runner AI Pixel Manager
#### Which means
The Runner AI Pixel Manager enables you or a third party to track customer events by adding pixels to your Runner AI Store. If you use the Runner AI Pixel Manager, you are responsible for obtaining all necessary consents from store visitors and customers whose events you track.
Runner AI allows you to add pixels to your Runner AI Store to enable you or a third party to track customer events (the "Runner AI Pixel Manager"). You may manage your pixels from within the user interface in the administrative console of your Runner AI Store.
(1) In addition to the terms applicable to your use of the Services generally (including these Terms of Service, Runner AI's Acceptable Use Policy, and Privacy Policy), the following terms apply to your access to and use of the Runner AI Pixel Manager:
- a. You will comply with all applicable laws and obtain all necessary consents from every site visitor and customer whose events you track;
- b. If you provide Runner AI with any data collected using pixels, including names, email addresses, phone numbers, or other data that personally identifies an individual, you will obtain all necessary rights and consents prior to providing Runner AI with the foregoing information;
- c. You agree that Runner AI may disable any pixels that Runner AI identifies as malicious, in Runner AI's sole discretion; and
- d. You will not, and will not allow any third parties to, use pixels:
- i. to engage in or promote any unlawful, infringing, defamatory or otherwise harmful activity; or
- ii. to disable, interfere with or circumvent any aspect of the Services.
(2) Runner AI may collect information associated with the Runner AI Pixel Manager, such as how pixels are used, and how and what scripts are added. Runner AI may use this data to improve, maintain, protect and develop the Runner AI Pixel Manager.
### 9.4 Experiments (Beta) and Automated Experiments
#### Which means
The Experiments feature uses AI to test different versions of your store. By turning it on, you allow us to show AI-generated variations of your store to some of your visitors, including but not limited to layouts, pricing, and shipping rules.
Only your store's Administrator can enable this and decide how much traffic to test (starting at 10% by default). Because this is a Beta feature, there is no guarantee that it will increase your sales or work perfectly every time. You use it at your own risk.
(1) **Authorization for Experimental Traffic**: By actively enabling Experiments within the Services, you expressly authorize Runner AI to conduct automated experiments on your Store. You acknowledge and agree that:
- **Traffic Allocation**: Upon activation, the System will automatically allocate ten percent (10%) or agreed traffic ratio of your Store's web traffic to an experimental group (the "Experiment Group").
- **User Control**: You retain the right to manually increase, decrease, or disable this traffic allocation at any time through the administrative dashboard.
- **Experimental Variations**: Visitors in the Experiment Group may see variations, including but not limited to store layouts, product pricing, shipping rates, and other store content or logic, that differ from your primary Store version. You are responsible for compliance with local laws regarding dynamic pricing and consumer disclosure.
(2) **Administrative Control**: Access to Experiments settings is restricted to Users with "Admin" permissions. Only an authorized Administrator has the authority to:
- Enable or disable the Experiments feature;
- Adjust experimental settings, including traffic allocation percentages.
Runner AI shall not be liable for any settings modified by individuals to whom you have granted administrative access.
(3) **Beta Disclaimer and Limitation of Liability**: The Experiments feature is provided as a "Beta" feature and is not part of the standard Services. Notwithstanding anything to the contrary in these Terms of Service:
- **Evolution of Service**: The functionality, performance, and UI layouts of Experiments may change, be suspended, or be discontinued by Runner AI at any time without notice.
- **No Guarantee of Results**: Runner AI makes no representations or warranties regarding the outcome of any experiments. We do not guarantee any specific conversion rates, revenue increases, search engine rankings, or other business results.
- **Assumption of Risk**: You acknowledge that experimental AI-generated content may contain errors. Your use of Experiments is at your sole risk, and Runner AI is not responsible for any negative impact on your Store's performance, including but not limited to loss of revenue, pricing errors, or customer disputes, resulting from such experiments.
## 10. Feedback and Reviews
### Which means
We welcome customer feedback but are under no obligation to ensure that ideas and suggestions regarding our Services or the services of third parties remain confidential and we can use the feedback in any way we want.
Runner AI welcomes any ideas and/or suggestions regarding improvements or additions to the Services. Under no circumstances will any disclosure of any idea, suggestion or related material or any review of the Services, Third Party Services or any Third Party Provider (collectively, "Feedback") to Runner AI be subject to any obligation of confidentiality or expectation of compensation. By submitting Feedback to Runner AI (whether submitted directly to Runner AI or posted on any Runner AI hosted forum or page), you waive any and all rights in the Feedback and that Runner AI is free to implement and use the Feedback if desired, as provided by you or as modified by Runner AI, without obtaining permission or license from you or from any third party. Any reviews of a Third Party Service or Third Party Provider that you submit to Runner AI must be accurate to the best of your knowledge, and must not be illegal, obscene, threatening, defamatory, invasive of privacy, infringing of intellectual property rights, or otherwise injurious to third parties or objectionable. Runner AI reserves the right (but not the obligation) to remove or edit Feedback of Third Party Services or Third Party Providers, but does not regularly inspect posted Feedback.
## 11. DMCA Notice and Takedown Procedure
### Which means
Runner AI respects intellectual property rights and you should too. If we receive a DMCA Notice, we may disable access or remove the allegedly infringing content from your Store. If you don't think the claim is valid, you can send a counter notification. If you believe one of our merchants is infringing your intellectual property rights, you can send Runner AI a DMCA Notice. We will expeditiously disable access or remove the content and notify the merchant.
Runner AI supports the protection of intellectual property and asks Runner AI merchants to do the same. It's our policy to respond to all notices of alleged copyright infringement. If someone believes that one of our merchants is infringing their intellectual property rights, they can send a DMCA Notice to Runner AI's designated agent using the support@adaptivemachines.ai. Upon receiving a DMCA Notice, we may remove or disable access to the Materials claimed to be a copyright infringement. Once provided with a notice of takedown, the merchant can reply with a counter notification using the email if they object to the complaint. The original complainant has 14 business days after we receive a counter notification to seek a court order restraining the merchant from engaging in the infringing activity, otherwise we restore the material.
## 12. Privacy and Data Protection
### Which means
Runner AI's use and collection of personal information is governed by our Privacy Policy. Runner AI's use and collection of customer personal information is further governed by our Data Processing Addendum.
Runner AI is firmly committed to protecting the privacy of your personal information and the personal information of your customers. By using the Service, you acknowledge and agree that Runner AI's collection, usage and disclosure of this personal information is governed by our [Privacy Policy](/en/legal/policies).
To the extent that Runner AI processes personal information of your customers as a "data processor" or "service provider" under certain data privacy or protection laws, including the EU or UK General Data Protection Regulation and the California Consumer Privacy Act, Runner AI's collection and use of personal information is also subject to our [Data Processing Addendum](/en/legal/dpa).
## 13. Runner AI Contracting Party
"Contracting Party" means Adaptive Machines, Inc., a Delaware corporation, with its principal place of business at 131 Continental Dr Suite 305 Newark, DE, 19713 US
The parties irrevocably and unconditionally submit to the exclusive jurisdiction of the state and federal courts located in the State of Delaware with respect to any dispute or claim arising out of or in connection with the Terms of Service. The United Nations Convention on Contracts for the International Sale of Goods will not apply to these Terms of Service and is hereby expressly excluded.
## 14. Term and Termination
### Which means
You can cancel your subscription at any time from within your account settings. We may terminate your account at any time. For Stores on a free plan, Runner AI reserves the right to permanently delete the Store and all associated data if the Store remains inactive for a period of fourteen (14) consecutive days.
(1) The term of these Terms of Service will begin on the date of your completed registration for use of a Service and continue until terminated by us or by you, as provided below (the "Term").
(2) You may cancel your Account and terminate the Terms of Service at any time by accessing your account settings.
(3) Without limiting any other remedies, we may suspend or terminate your Account or the Terms of Service for any reason, without notice and at any time (unless otherwise required by law), including if we suspect that you (by conviction, settlement, insurance or escrow investigation, or otherwise) have engaged in fraudulent activity in connection with the use of the Services. Termination of the Terms of Service will be without prejudice to any rights or obligations which arose prior to the date of termination.
(4) Upon termination of the Services by either party for any reason:
- Runner AI will cease providing you with the Services and you will no longer be able to access your Account;
- unless otherwise provided in the Terms of Service, you will not be entitled to any refunds of any Fees, pro rata or otherwise;
- any outstanding balance owed to Runner AI for your use of the Services through the effective date of such termination will immediately become due and payable in full; and
- your Runner AI Store will be taken offline.
(5) If there are any outstanding Fees owed by you at the date of termination of the Service, you will receive one final invoice via email. Once that invoice has been paid in full, you will not be charged again.
(6) Inactive Free Accounts: For Stores on a free subscription plan (excluding temporary "free trials" of a paid plan), Runner AI reserves the right to permanently delete the Store and all associated data if the Store remains inactive for a period of fourteen (14) consecutive days. Runner AI will provide notice via the Primary Email Address prior to such deletion. You acknowledge that Runner AI shall have no liability for any data loss resulting from the deletion of an inactive Store under this Section.
## 15. Modifications
### Which means
If we make a material change to the Terms of Service that adversely affects your rights under the Terms of Service or your use of our Services in a material way, we will notify you in advance (unless the change relates to legal requirements or to prevent abuse of our Services, among other things).
(1) We reserve the right, in our sole and absolute discretion, to update or change any portion of the Terms of Service at any time. We will provide you with reasonable advance notice of changes to the Terms of Service that materially adversely affect your use of the Services or your rights under the Terms of Service by sending an email to the Primary Email Address, providing notice through the Runner AI administrative console, or by similar means. However, Runner AI may make changes that materially adversely affect your use of the Services or your rights under the Terms of Service at any time and with immediate effect (i) for legal, regulatory, fraud and abuse prevention, or security reasons; or (ii) to restrict products or activities that we deem unsafe, inappropriate, or offensive. Unless we indicate otherwise in our notice (if applicable), any changes to the Terms of Service will be effective immediately upon posting of such updated terms at this location. Your continued access to or use of the Services after we provide such notice, if applicable, or after we post such updated terms, constitutes your acceptance of the changes and consent to be bound by the Terms of Service as amended. If you do not agree to the amended Terms of Service, you must stop accessing and using the Services.
(2) Runner AI may change the Fees for the Services from time-to-time. We will provide you with 30 days advanced notice prior to any changes in Fees by sending an email to the Primary Email Account, providing notice through the Runner AI administrative console, or by similar means. Runner AI will not be liable to you or to any third party for any modification, price change, suspension or discontinuance of the Services (or any part thereof).
## 16. General Conditions
(1) The Terms of Service, including the documents it incorporates by reference, constitute the entire agreement between you and Runner AI and govern your use of the Services and your Account, superseding any prior agreements between you and the company (including, but not limited to, any prior versions of the Terms of Service).
(2) The failure of Runner AI to exercise or enforce any right or provision of the Terms of Service will not constitute a waiver of such right or provision. If any provision of the Terms of Service, including all terms and conditions and other documents it incorporates by reference, is held by a court of competent jurisdiction to be contrary to law, such provision will be changed and interpreted so as to best accomplish the objectives of the original provision to the fullest extent allowed by law, and the remaining provision of the Terms of Service will remain in full force and effect.
(3) Save for Runner AI and its affiliates, you or anyone accessing Runner AI Services pursuant to these Terms of Service, unless otherwise provided in these Terms of Service, no person or entity who is not a party to these Terms of Service will have any right to enforce any term of these Terms of Service, regardless of whether such person or entity has been identified by name, as a member of a class or as answering a particular description. For the avoidance of doubt, this will not affect the rights of any permitted assignee or transferee of these Terms.
(4) These Terms of Service and any dispute or claim arising out of or in connection with it will be governed by and interpreted in accordance with the laws of the State of Delaware, without regard to its principles of conflicts of laws.
(5) The Terms of Service may be available in languages other than English. To the extent of any inconsistencies or conflicts between these English Terms of Service and Runner AI's Terms of Service available in another language, the most current English version of the Terms of Service will prevail. Any disputes arising out of these Terms of Service will be resolved in English unless otherwise determined by Runner AI (acting in its sole discretion) or as required by applicable law.
(6) All the terms and provisions of the Terms of Service will be binding upon and inure to the benefit of the parties to the Terms of Service and to their respective heirs, successors, permitted assigns and legal representatives. The company will be permitted to assign these Terms of Service without notice to you or consent from you. You will have no right to assign or otherwise transfer the Terms of Service, or any of your rights or obligations hereunder, to any third party without Runner AI's prior written consent, to be given or withheld in Runner AI's sole discretion.
(7) If any provision, or portion of the provision, in these Terms of Service is, for any reason, held to be invalid, illegal or unenforceable in any respect, then such invalidity, illegality or unenforceability will not affect any other provision (or the unaffected portion of the provision) of the Terms of Service, and the Terms of Service will be construed as if such invalid, illegal or unenforceable provision, or portion of the provision, had never been contained within the Terms of Service.
(8) On termination, all related rights and obligations under the Terms of Service immediately terminate, except that (a) you will remain responsible for performing all of your obligations in connection with transactions entered into before termination and for any liabilities that accrued before or as a result of termination; and Sections 1 (Account Terms), 5 (Payment of Fees), 6 (Confidentiality), 7 (Limitation of Liability and Indemnification), 8.1 (Intellectual Property and Your Materials), 10 (Feedback and Reviews), 12 (Privacy and Data Protection), 13 (Runner AI Contracting Party), 14 (Cancellation and Termination), 15 (Modifications), and 16 (General Conditions) will survive the termination or expiration of these Terms of Service.
---
Adaptive Machines, Inc.
131 Continental Dr Suite 305 Newark, DE, 19713 US
---
# Cuenta y configuración
Source: https://www.runnerai.com/docs/es/guides/account-and-settings
Las capturas y grabaciones muestran la interfaz en inglés.
Runner agrupa la configuración por quién o qué afectan: el espacio de trabajo, la tienda actual o tú. Esto mantiene la facturación compartida y los miembros separados de los dominios específicos de la tienda y tu perfil personal.
## Qué cubre esta guía
Sabrás dónde vive cada grupo de configuración y qué páginas requieren un rol, plan, tienda publicada o función escalonada.
## Disponibilidad y requisitos previos
- Debes haber iniciado sesión.
- Abre **Configuración** desde el menú del espacio de trabajo o proyecto.
- La configuración de Tienda aparece solo cuando abres Configuración desde dentro de un proyecto.
- Coincide el nombre del espacio de trabajo o tienda en la barra lateral de configuración antes de editar. Los controles personales aparecen bajo tu nombre de cuenta.
- Para terminar sesiones en otros dispositivos o eliminar tu cuenta, contacta con el soporte de Runner. Consulta [Seguridad y sesiones](/es/guides/account-and-settings/security-and-sessions).
- Algunos controles requieren permiso de propietario del espacio de trabajo o administrador.
- Las páginas de Dominio, Clave API y Experimentos pueden estar ocultas o limitadas por plan, estado de publicación o disponibilidad escalonada.
## Abrir Configuración
1. En el espacio de trabajo o proyecto deseado, abre su menú.
2. Selecciona **Configuración**.
3. Confirma el selector **Espacio de Trabajo: _nombre del espacio de trabajo_**, luego elige una página bajo ese grupo, **Tienda: _nombre de la tienda_**, o tu nombre de cuenta. Abrir Configuración dentro de una tienda puede comenzar en General de la Tienda.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Coincide los encabezados de espacio de trabajo y tienda antes de elegir una página. Los controles de cuenta se encuentran debajo de estos grupos.
## Mapa de configuración
| Grupo y página | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Espacio de trabajo → **General** | Renombra o describe el espacio de trabajo. | Los cambios válidos se guardan automáticamente. La zona de peligro también contiene Eliminar espacio de trabajo. |
| Espacio de trabajo → **Miembros** | Invita a personas y gestiona acceso activo o pendiente. | Los Propietarios pueden invitar, cancelar invitaciones o eliminar miembros; los miembros elegibles pueden salir. |
| Espacio de trabajo → **Plan y Facturación** | Revisa el plan actual y las acciones de facturación disponibles. | Las tarjetas de plan, confirmación, pago, gestión de facturación y opciones de crédito extra aparecen según el estado de la cuenta. |
| Espacio de trabajo → **Uso y créditos** | Comprende el saldo, las fuentes y el gasto. | Un control de rango de fechas actualiza el resumen, gráfico, tarjetas de categoría y feed de actividad. |
| Tienda → **General** | Gestiona la identidad de la tienda actual y su apariencia de búsqueda. | Aparecen controles de nombre, Título de página, Descripción, favicon, marca de agua y Eliminar tienda. |
| Tienda → **Dominio** | Conecta, compra, renueva o transfiere un dominio. | La disponibilidad depende del plan, publicación, permiso y estado del dominio. |
| Tienda → **Scripts personalizados** | Añade JavaScript a la tienda. | Los cambios permanecen sin guardar hasta que selecciones **Guardar cambios**. |
| Tienda → **Agente** | Elige Habilidades disponibles en este proyecto. | Puedes añadir o deshabilitar Habilidades configurables para esta tienda. |
| Tienda → **Experimentos** | Configura objetivos de experimentos automatizados y tráfico. | Esta página Beta aparece solo cuando está habilitada y requiere una tienda publicada. |
| Tu nombre de cuenta → **Mi configuración** | Elige idioma, correos semanales de rendimiento y sonidos de la interfaz. | Las preferencias se guardan; los cambios de idioma recargan la página localizada actual. |
| Tu nombre de cuenta → **Claves API** | Crea credenciales para acceso programático. | El secreto completo aparece una vez; revocar es destructivo. Esta página es condicional. |
## Elige el alcance correcto
1. Usa **Espacio de trabajo** para miembros, Créditos compartidos, plan y facturación.
2. Usa **Tienda** para la tienda actual, dominio, scripts y configuración del Agente del proyecto.
3. Usa **Personal** para tu propio perfil, idioma y claves API.
4. Antes de una acción sensible, confirma los nombres de espacio de trabajo y tienda mostrados en el diálogo.
## Estados comunes y límites
- **Guardando…** seguido de **Guardado** confirma que un campo de guardado automático terminó.
- Un control deshabilitado puede indicar permiso faltante, una puerta de plan, un requisito previo de tienda u una operación ya en progreso.
- Las páginas de facturación y dominio muestran los términos y cantidad actuales. No confíes en una captura de pantalla antigua o precio copiado.
- Las acciones destructivas requieren confirmación, pero la confirmación exacta difiere según la acción.
- Las páginas ocultas no deben abrirse a través de enlaces copiados a menos que la interfaz actual las exponga para tu cuenta.
## Solución de problemas
- Si el grupo Tienda está ausente, cierra Configuración, entra en el proyecto previsto y abre Configuración de nuevo.
- Si una página muestra un estado de actualización o publicación primero, completa ese requisito previo solo si se ajusta a tu flujo de trabajo previsto.
- Si un guardado automático falla, el valor anterior permanece o se devuelve; corrige el campo e intenta de nuevo.
- Si no estás seguro de qué espacio de trabajo se está cambiando, cierra el diálogo y reabre Configuración desde ese espacio de trabajo.
- Si necesitas ayuda de seguridad de cuenta pero no hay entrada aprobada visible, contacta con soporte de Runner en lugar de adivinar una ruta directa.
## Guías relacionadas
- [Espacio de trabajo General](/es/guides/account-and-settings/workspace-general)
- [Miembros e invitaciones](/es/guides/workspace/members-and-invitations)
- [Planes de suscripción](/es/guides/plans-and-billing/subscription-plans)
- [Tienda General](/es/guides/account-and-settings/store-general)
- [Seguridad y sesiones](/es/guides/account-and-settings/security-and-sessions)
---
# Configuración de Experimentos
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/ai-lab
Las capturas y grabaciones muestran la interfaz en inglés.
La configuración de Experimentos configura experimentos automatizados de tienda para una tienda publicada elegible. Úsala cuando quieras que Runner optimice intencionalmente un objetivo comercial seleccionado con parte de tu tráfico en vivo.
## Qué cubre esta guía
Sabrás cómo habilitar la configuración Beta, elegir un objetivo y asignación de tráfico, guardarlo y reconocer estados de inicio o parada.
## Disponibilidad y requisitos previos
- **Experimentos** es una página Beta condicional y está oculta a menos que esté habilitada para la cuenta.
- La tienda debe estar publicada. Un borrador muestra un estado no disponible de publicación primero.
- Habilitar Experimentos requiere aceptación de los **términos de los Experimentos** vinculados.
- Cambiar la configuración de experimentos en vivo puede afectar a los visitantes de la tienda. Revisa el objetivo y tráfico seleccionados antes de guardar.
## Ruta de acceso
Dentro de un proyecto elegible, selecciona **Configuración → Tienda: _nombre de la tienda_ → Experimentos**.
## Controles
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Interruptor **Activar los Experimentos** | Revela o detiene la configuración de Experimentos de la tienda. | Activar revela controles de objetivo y tráfico; Guardar envía la configuración habilitada. Desactivar una configuración activa comienza a detenerla. |
| **términos de los Experimentos** | Revisa los términos adjuntos a la habilitación de la Beta. | La sección legal se abre en una pestaña nueva. |
| **Define tu objetivo** | Dile a Runner qué métrica debe mejorar el experimento. | Seleccionar un objetivo marca esa tarjeta como activa. |
| Deslizador/entrada de **Tráfico** | Elige la parte del tráfico de la tienda asignada a experimentos. | El valor se mantiene dentro del mínimo mostrado y 100%. |
| Botones de porcentaje rápido | Elige un valor de tráfico común. | El deslizador y el valor numérico se actualizan juntos. |
| **Guardar** | Aplica la configuración de objetivo y tráfico habilitada. | Runner inicia la operación de configuración y deshabilita los controles hasta que termine. |
Los objetivos disponibles incluyen Tasa de conversión, Tasa de adición al carrito, Tasa de inicio de pago, Tasa de participación en banner, Tasa de clics en botón y Valor promedio de pedido.
Los pasos de configuración a continuación se aplican solo después de que se despeje la puerta de publicación inicial. Si se muestra un selector de modelo, revisa el modelo disponible antes de guardar; las opciones dependen de tu cuenta. Consulta [publicación](/es/guides/storefront-and-publishing) si la tienda aún es un borrador.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
La tienda no publicada muestra un requisito previo en lugar de controles de experimento. No se lanzó ni midió ningún experimento.
## Configurar Experimentos
1. Publica la tienda y luego abre **Tienda → Experimentos**.
2. Lee la descripción de Beta y los **términos de los Experimentos**.
3. Activa **Activar los Experimentos**.
4. Selecciona un objetivo.
5. Elige una asignación de tráfico en o por encima del mínimo mostrado.
6. Revisa el objetivo y porcentaje seleccionados.
7. Selecciona **Guardar**.
8. Espera a que el estado de inicio termine y confirma el estado guardado antes de irte.
## Detener Experimentos
1. Vuelve a la configuración de Experimentos de la misma tienda.
2. Desactiva **Activar los Experimentos**.
3. Espera a través de **Deteniendo experimento, por favor espera…**.
4. Confirma el estado deshabilitado después de que termine la operación.
No repitas el interruptor mientras una operación esté en progreso.
## Estados y límites
- Una tienda no publicada muestra que la función no está disponible actualmente y te pide que publiques primero.
- **Iniciando experimento, por favor espera…** bloquea cambios concurrentes.
- **Deteniendo experimento, por favor espera…** bloquea cambios concurrentes.
- El objetivo es obligatorio antes de Guardar.
- El tráfico está limitado al mínimo mostrado hasta 100%.
- La entrada de configuración completa puede estar ausente para cuentas sin la función.
## Solución de problemas
- Si falta Experimentos, no confíes en un enlace directo copiado; la función no está habilitada para la cuenta.
- Si la página te pide que publiques, completa la publicación antes de configurar un experimento en vivo.
- Si Guardar informa que se requiere un objetivo, selecciona una tarjeta de objetivo e intenta de nuevo.
- Si los controles están deshabilitados, espera a que termine la operación de inicio o parada actual.
- Si el estado guardado no está claro, reabre la página antes de alternar de nuevo.
## Guías relacionadas
- [Tienda General](./store-general)
- [Planes de suscripción](../plans-and-billing/subscription-plans)
- [Descripción general de Cuenta y Configuración](/es/guides/account-and-settings)
---
# Claves API
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/api-keys
Las capturas y grabaciones muestran la interfaz en inglés.
Las claves API son secretos personales para acceso programático a Runner. Crea una solo para una aplicación en la que confíes, almacénala de forma segura y revócala cuando ya no sea necesaria.
## Qué cubre esta guía
Sabrás cómo crear y guardar el secreto de una sola vez, identificar claves existentes sin exponerlas y revocar una clave con confirmación.
## Disponibilidad y requisitos previos
- **Claves API** es condicional y aparece solo cuando está habilitada para tu cuenta.
- La página indica **Cada clave actúa como tú**. Las claves pertenecen a tu cuenta personal, no a una tienda.
- No confundas estas claves con las **Claves API de Analíticas** de solo lectura en [General del Espacio de Trabajo](/es/guides/account-and-settings/workspace-general).
- Nunca pongas una clave completa en chat, Memoria de Agente, una Habilidad, una captura de pantalla, control de versiones o documentación del producto.
## Ruta de acceso
Selecciona **Configuración → tu nombre de cuenta → Claves API**. Si la entrada está ausente, la función no está disponible para la cuenta actual.
## Controles
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Generar nueva clave** | Crea una nueva credencial. | Se abre un diálogo con un campo Nombre opcional. |
| **Nombre** | Identifica la aplicación más tarde sin exponer el secreto. | El nombre aparece en la tabla de claves; en blanco crea una clave sin título. |
| **Crear clave** | Genera la credencial. | Runner abre **Clave API generada** y muestra el secreto completo una sola vez. |
| Icono de ojo | Verifica el valor recién generado completo antes de almacenarlo. | El valor de una sola vez se muestra u oculta en el diálogo de éxito. |
| Icono de copiar | Copia la nueva clave con precisión. | Runner la copia al portapapeles y muestra confirmación. |
| **La he guardado** | Cierra la vista del secreto de una sola vez. | El valor completo se borra del diálogo y no se puede mostrar de nuevo allí. |
| Tabla de clave existente | Identifica claves de forma segura. | Runner muestra Nombre, Prefijo, Creado y Último uso, no el secreto completo. |
| Icono de eliminar | Revoca una clave existente. | Una confirmación explica que la revocación no se puede deshacer. |
| **Revocar** | Deshabilita la clave seleccionada. | Después del éxito, la clave se elimina de la lista y ya no puede autenticar. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg0z7QP9dmUDVzwn9xNJv4t2isec7IFkOaWAro)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
La lista vacía es el estado inicial. No se generó ni mostró ningún secreto en este ejemplo.
## Inspecciona el diálogo antes de crear una credencial
1. Selecciona **Generar nueva clave**.
2. Encuentra el campo **Nombre** opcional; una etiqueta como `Reporting integration` ayuda a identificar la aplicación más tarde.
3. Selecciona **Cancelar** si solo estás explorando. No se crea ninguna clave hasta que selecciones **Crear clave**.
El flujo de trabajo a continuación se aplica cuando Claves API está disponible y estás listo para almacenar un nuevo secreto.
## Generar y almacenar una clave
1. Abre **tu nombre de cuenta → Claves API**.
2. Selecciona **Generar nueva clave**.
3. Ingresa un Nombre descriptivo, como la aplicación o entorno. No pongas un secreto en el nombre.
4. Selecciona **Crear clave**.
5. En **Clave API generada**, revela la clave solo si es necesario y selecciona Copiar.
6. Almacénala en un gestor de secretos de confianza.
7. Confirma el valor almacenado antes de seleccionar **La he guardado**.
8. Usa el Prefijo de la tabla para identificar la clave más tarde sin exponer el valor completo.
Runner advierte que la clave completa no se mostrará de nuevo. Si cierras el diálogo sin guardarla, revoca esa clave y crea un reemplazo en lugar de intentar recuperar el secreto.
## Revocar una clave
1. Coincide la clave prevista por Nombre y Prefijo.
2. Selecciona su icono de eliminar.
3. Revisa la confirmación de **Revocar**.
4. Selecciona **Revocar** solo cuando la aplicación dependiente esté lista para dejar de usarla.
5. Confirma **Clave API revocada** y elimina el secreto antiguo de la aplicación.
La revocación es destructiva y no se puede deshacer. Crea una nueva clave si se necesita acceso de nuevo.
## Estados y límites
- **Sin claves API aún** es el estado vacío normal.
- El valor completo de una clave nueva aparece solo en su diálogo de éxito.
- Las filas existentes muestran un prefijo y fechas de uso, no una clave recuperable.
- **nunca** bajo Último uso significa que Runner no ha registrado una solicitud para esa clave.
- Los botones Crear y Revocar muestran progreso y no deben enviarse repetidamente.
## Solución de problemas
- Si falta Claves API, no uses un enlace directo copiado; la función está deshabilitada para esta cuenta.
- Si la copia del portapapeles falla, revela el nuevo valor y cópialo manualmente en un gestor de secretos seguro, luego ocúltalo de nuevo.
- Si perdiste una clave completa, revoca su fila y genera un reemplazo.
- Si una aplicación deja de funcionar después de la revocación, actualízala con una clave recién creada; la clave antigua no se puede restaurar.
- Si se seleccionó la clave incorrecta, Cancela la confirmación y compara Nombre y Prefijo de nuevo.
## Guías relacionadas
- [Seguridad y sesiones](./security-and-sessions)
- [Configuración personal y espacios de trabajo](./personal-settings-and-workspaces)
- [Seguridad de memoria](../agent/memory)
---
# Scripts personalizados y Agente de tienda
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/custom-scripts-and-store-agent
Las capturas y grabaciones muestran la interfaz en inglés.
Los Scripts personalizados cambian el comportamiento de la tienda, mientras que el Agente de tienda cambia qué Habilidades puede usar Runner para el proyecto actual. Ambas son configuraciones específicas de la tienda y deben revisarse con cuidado extra.
## Qué cubre esta guía
Podrás añadir y guardar un script, pausarlo sin eliminarlo, y añadir o deshabilitar una Habilidad solo para el proyecto actual.
## Disponibilidad y requisitos previos
- Abre Configuración desde dentro del proyecto previsto.
- JavaScript personalizado puede cambiar el comportamiento de la tienda. Añade solo código que entiendas y en el que confíes.
- Las acciones de Habilidad dependen de las Habilidades de espacio de trabajo disponibles y de si una Habilidad del Sistema es configurable.
- La página completa del Agente y la puerta del plan aún controlan la disponibilidad más amplia de Habilidades.
## Rutas de entrada
- Scripts: **Configuración → Tienda: _nombre de la tienda_ → Scripts Personalizados**
- Habilidades del proyecto: **Configuración → Tienda: _nombre de la tienda_ → Agente**
## Controles de Scripts personalizados
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Añadir script** | Crea una entrada de script de tienda. | Se abre una nueva fila de Script habilitada con Código JavaScript vacío. |
| Fila de script | Expande o contrae su editor. | **Nombre del script** y **Código JavaScript** se hacen visibles. |
| Icono de ojo / ojo oculto | Habilita o deshabilita un script. | La fila local cambia de estado; selecciona Guardar cambios para aplicarlo. |
| Icono de eliminar | Elimina un script de la lista pendiente. | La fila desaparece sin un segundo diálogo; Guardar cambios aplica la eliminación. |
| **Guardar cambios** | Aplica cada edición de script pendiente. | Runner guarda la lista completa de scripts y muestra un mensaje de éxito o error. |
Runner permite hasta diez entradas de script. El botón Guardar cambios permanece deshabilitado cuando nada ha cambiado.
El editor en blanco te permite revisar los campos del script antes de la instalación. No se guardó ningún script de seguimiento en este ejemplo.
## Añadir o cambiar un script
1. Abre **Tienda → Scripts Personalizados**.
2. Selecciona **Añadir script**.
3. Ingresa un **Nombre del script** claro y **Código JavaScript** de confianza.
4. Deja el script habilitado solo si debe ejecutarse en la tienda.
5. Revisa todas las otras filas porque **Guardar cambios** aplica la lista completa.
6. Selecciona **Guardar cambios** y espera **Guardado**.
7. Verifica la tienda de forma segura después de guardar.
Runner intenta evitar que un error de script bloquee la página, pero eso no hace que el código desconocido sea seguro. Un script aún puede afectar la privacidad, el rendimiento, el seguimiento y la experiencia del cliente.
### Inspecciona un borrador de script primero
Para una primera vista, selecciona **Añadir script**, nómbralo `Store analytics`, y apaga su control de ojo. Deja el código vacío y no selecciones **Guardar cambios**. Esto te permite identificar el editor y el estado deshabilitado antes de añadir código de un proveedor de confianza. Cuando guardes un script real, vuelve a abrir la lista y verifica tanto su código como su estado habilitado.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Para las Habilidades del proyecto, elige **Agente** bajo el encabezado de la tienda. Esta imagen muestra su entrada; no muestra una Habilidad siendo añadida o deshabilitada.
## Controles del Agente de tienda
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Fila de Habilidad activa | Ve qué Habilidad está disponible en este proyecto. | La fila muestra nombre, descripción y tipo Sistema o Personalizado. |
| **Desactivar** | Elimina una Habilidad configurable de este proyecto solo. | La Habilidad sale de la lista activa de este proyecto; no se elimina globalmente. |
| **Añadir habilidad** | Añade una Habilidad de espacio de trabajo disponible a este proyecto. | Seleccionar una Habilidad listada la habilita para el proyecto actual. |
| **Crear habilidad personalizada…** | Crea una nueva capacidad personalizada. | Se abre el editor de Habilidades, luego la lista del proyecto se actualiza después del éxito. |
## Configurar Habilidades del proyecto
1. Abre **Tienda → Agente**.
2. Revisa las Habilidades actualmente activas.
3. Selecciona **Añadir habilidad**, luego elige una Habilidad disponible o **Crear habilidad personalizada…**.
4. Espera el mensaje de éxito y confirma que la Habilidad aparece.
5. Usa **Desactivar** cuando una Habilidad configurable deba dejar de aplicarse a este proyecto.
6. Abre **Agente** en la navegación del proyecto para detalles completos de Habilidad, pausa, edita, importa o elimina acciones.
## Estados y límites
- Los cambios de script permanecen locales hasta que **Guardar cambios** tenga éxito.
- Eliminar una fila de script no tiene confirmación separada antes de Guardar cambios.
- Alcanzar diez scripts deshabilita **Añadir script**.
- El Agente de tienda puede mostrar carga, un error, **No hay habilidades activadas** o la lista activa.
- Las Habilidades del Sistema fijas no muestran **Desactivar**.
- Deshabilitar en Agente de tienda cambia el alcance de este proyecto; no elimina ni pausa globalmente la Habilidad.
## Solución de problemas
- Si un script aún se ejecuta, confirma que su estado deshabilitado fue seguido por **Guardar cambios**.
- Si Guardar falla, la lista guardada anteriormente permanece sin cambios; corrige el código o intenta de nuevo después del error.
- Si **Añadir habilidad** no tiene la entrada esperada, verifica la página completa del Agente y el plan actual.
- Si **Desactivar** está ausente, la Habilidad del Sistema no es configurable para este proyecto.
- Si una nueva Habilidad aparece globalmente pero no aquí, añádela al proyecto desde Agente de tienda.
## Guías relacionadas
- [Tienda General](./store-general)
- [Habilidades del Agente](../agent/skills)
- [Crear, importar y gestionar Habilidades](../agent/create-import-manage-skills)
- [Seguridad de clave API](./api-keys)
---
# Eliminar, recuperar y salir
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/delete-recover-and-leave
Runner usa diferentes flujos de confirmación para eliminar una tienda, eliminar un espacio de trabajo, salir de un espacio de trabajo y solicitar la eliminación de cuenta. Revisa el alcance exacto antes de cualquier acción destructiva.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Antes de abrir una acción de eliminación, compruebe en **Settings** si corresponde al espacio de trabajo o a la tienda. Esta imagen solo muestra la navegación; no se ha realizado ninguna eliminación ni recuperación.
Las anotaciones están en inglés. Seleccione la imagen para ampliarla.
## Qué cubre esta guía
Sabrás qué elimina cada acción, qué confirmación requiere y cuándo la recuperación condicional de tienda puede aparecer.
## Disponibilidad y requisitos previos
- Necesitas permiso para el elemento que estás cambiando.
- El último espacio de trabajo no se puede eliminar.
- La recuperación de la tienda es una función heredada condicional. Úsala solo si Runner expone **Eliminados recientemente** y lista la tienda allí. La navegación actual de la tienda no promete este destino.
- No trates la recuperación condicional como una garantía al aprobar la eliminación.
- El avatar global actual y los menús de Configuración no exponen la página protegida de seguridad de cuenta. Usa la eliminación de cuenta solo cuando Runner o soporte de Runner te dé una entrada aprobada.
## Rutas de entrada y mapa de acciones
| Acción y ruta de entrada | Confirmación | Qué sucede después del éxito |
| --- | --- | --- |
| Configuración → Tienda: _nombre de la tienda_ → **General → Eliminar** | Escribe el nombre exacto de la tienda, luego selecciona **Eliminar**. | La tienda se elimina. Si eliminas la tienda actual, Runner abre otra tienda disponible o la entrada de nueva tienda. |
| Selección múltiple condicional → **Eliminar seleccionadas** | Escribe `DELETE`, luego selecciona **Eliminar todo**. | Las tiendas seleccionadas salen de la cuadrícula activa después de que la operación tenga éxito. |
| Lista de tiendas heredadas condicional → **Eliminados recientemente → Recuperar proyecto** | Sin confirmación destructiva; selecciona Recuperar proyecto. | La tienda vuelve a la lista de proyectos activos y sus recursos de espacio de trabajo comienzan a prepararse nuevamente. |
| Configuración → Espacio de trabajo → General → **Eliminar espacio de trabajo** | El Propietario escribe el nombre exacto del espacio de trabajo, luego selecciona **Eliminar**. | Runner elimina el espacio de trabajo y cambia a otro espacio de trabajo disponible. |
| Configuración → Espacio de trabajo → Miembros → tu fila → **Salir** | Revisa el diálogo del espacio de trabajo nombrado, luego selecciona **Salir**. | Pierdes acceso a sus proyectos y Runner te redirige a otro espacio de trabajo disponible o selector. |
| Eliminación de cuenta → correo a support@adaptivemachines.ai | Envía la solicitud desde la dirección de correo de tu cuenta de Runner. | El soporte de Runner responde con el siguiente paso. |
## Eliminar una tienda
1. En la tienda deseada, abre **Configuración → Tienda: _nombre de la tienda_ → General** y confirma los nombres del espacio de trabajo y de la tienda.
2. Selecciona **Eliminar**.
3. Lee la advertencia sobre datos de tienda.
4. Escribe el nombre exacto de la tienda.
5. Selecciona el botón destructivo **Eliminar**.
6. Espera el resultado de la eliminación. Confirma que Runner ha abierto otra tienda o la entrada de nueva tienda, luego verifica que la tienda eliminada ya no esté disponible.
La confirmación advierte que la acción no se puede revertir. Aunque algunas cuentas muestran una función de recuperación separada, puede estar ausente o no disponible; nunca elimines asumiendo que Recuperar aparecerá.
## Recuperar una tienda desde una vista heredada cuando esté disponible
1. Continúa solo si tu espacio de trabajo expone la lista de tiendas heredadas y su entrada de **Eliminados recientemente**.
2. Abre **Eliminados recientemente**; no lo busques en la navegación actual de la tienda ni adivines un enlace directo.
3. Coincide la tienda por nombre y fecha de eliminación.
4. Selecciona **Recuperar proyecto** una sola vez.
5. Espera **Proyecto recuperado** y confirma que la tienda vuelve a la lista activa.
6. Abrela solo después de que sus recursos de espacio de trabajo requeridos estén disponibles.
Si **Eliminados recientemente** está ausente, no se expone una ruta de recuperación en esa vista. Contacta con soporte si necesitas ayuda; esta guía no promete disponibilidad o una ventana de recuperación.
## Eliminar un espacio de trabajo
1. Como Propietario del espacio de trabajo, abre **Configuración → Espacio de trabajo → General** para el espacio de trabajo exacto.
2. Selecciona **Eliminar espacio de trabajo**.
3. Lee la advertencia de eliminación permanente.
4. Escribe el nombre exacto del espacio de trabajo.
5. Selecciona **Eliminar**.
6. Confirma que Runner cambia a otro espacio de trabajo.
El único espacio de trabajo no se puede eliminar. Eliminar un espacio de trabajo se presenta como permanente y no recuperable.
## Salir de un espacio de trabajo
1. Abre **Configuración → Espacio de trabajo → Miembros**.
2. Encuentra tu fila marcada **(tú)**.
3. Selecciona **Salir** si está disponible.
4. Confirma el nombre del espacio de trabajo y selecciona **Salir** en el diálogo.
5. Confirma que se te redirige y ya no tienes acceso a sus proyectos.
Salir no elimina el espacio de trabajo para sus miembros restantes. La fila del Propietario no ofrece esta acción Salir en la página Miembros.
## Solicitar eliminación de cuenta
1. Escribe a support@adaptivemachines.ai desde la dirección de correo de tu cuenta de Runner.
2. Pide que se elimine la cuenta.
3. Sigue las instrucciones de la respuesta del soporte de Runner.
Esta solicitud es más amplia que eliminar una tienda o espacio de trabajo. Revisa [Seguridad y sesiones](./security-and-sessions) antes de continuar.
## Solución de problemas
- Un botón final deshabilitado significa que el texto de confirmación no coincide exactamente o la acción aún se está ejecutando.
- Un error de eliminación no prueba que nada haya cambiado. Actualiza la lista activa y verifica el elemento antes de intentarlo de nuevo.
- **Recuperando…** bloquea otros botones Recuperar hasta que la solicitud actual termine.
- Si la recuperación informa un error, verifica las listas activas y eliminadas recientemente antes de intentarlo de nuevo.
- Si Salir informa un error, verifica tu acceso actual y espacio de trabajo antes de intentarlo de nuevo.
- Si no recibes respuesta sobre la eliminación de la cuenta, no envíes varias solicitudes. Responde en el mismo hilo de correo.
## Guías relacionadas
- [Tienda General](./store-general)
- [Espacio de trabajo General](./workspace-general)
- [Miembros e invitaciones](../workspace/members-and-invitations)
- [Seguridad y sesiones](./security-and-sessions)
---
# Configuración personal y espacios de trabajo
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/personal-settings-and-workspaces
Las capturas y grabaciones muestran la interfaz en inglés.
Mis Configuraciones cambia tus preferencias de Runner en todos los proyectos. Usa el conmutador de espacio de trabajo por separado cuando quieras trabajar en otro equipo.
## Qué cubre esta guía
Elige el idioma de la interfaz, correos semanales de rendimiento y sonidos de la interfaz sin cambiar la configuración del espacio de trabajo.
## Disponibilidad y requisitos previos
- Debes haber iniciado sesión.
- La vista revisada de **Mi configuración** muestra Idioma, Correos semanales de rendimiento y Sonidos de la interfaz. Los controles de perfil pueden diferir según la cuenta o la pantalla.
- Las acciones de creación de espacio de trabajo y membresía pueden estar limitadas por permisos de cuenta o estado del espacio de trabajo actual.
## Rutas de entrada
- Preferencias: **Configuración → tu nombre de cuenta → Mis Configuraciones**
- Cambio de espacio de trabajo: sigue la [navegación del espacio de trabajo](/es/guides/workspace).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBH6DLmxmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Selecciona **Mi configuración** para preferencias de interfaz. **Claves API** abre la página de credenciales personales separada.
## Controles de Mi configuración
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Idioma** | Cambia el idioma de la interfaz de Runner. | Runner guarda la opción y recarga la página actual en esa configuración regional. |
| **Correos semanales de rendimiento** | Recibe una vez por semana el informe de rendimiento de tu tienda en tu bandeja de entrada. | El interruptor guarda si Runner envía el informe; está activado de forma predeterminada. |
| **Sonidos de la interfaz** | Escucha un clic suave al tocar, cambiar opciones o recibir una alerta. | El interruptor guarda la preferencia; desactívalo para silenciar los sonidos. |
## Cambiar idioma o correos de informes
1. Abre **Mi configuración** bajo tu nombre de cuenta.
2. Elige **Idioma** cuando estés listo para que la página se recargue.
3. Confirma que la interfaz usa el idioma seleccionado después de recargar.
4. Cambia **Correos semanales de rendimiento** solo cuando desees cambiar la entrega de los informes de tu tienda.
5. Espera a que la preferencia se guarde, luego vuelve a abrir la página para verificarla.
## Verifica una preferencia sin cambiar tu perfil
1. Abre **Mi configuración** y encuentra **Sonidos de la interfaz**.
2. Elige si los clics y alertas deben hacer un sonido.
3. Espera a que la configuración se guarde, luego cierra y vuelve a abrir **Mi configuración**.
4. Confirma que el interruptor aún coincide con tu elección.
Para cambiar o crear espacios de trabajo, usa la [guía del espacio de trabajo](/es/guides/workspace). No hay un destino público de **Espacios de trabajo** en la barra lateral de Configuración actual. Para salir de un espacio de trabajo, sigue [Miembros e invitaciones](/es/guides/workspace/members-and-invitations).
## Estados y límites
- Una actualización de idioma mantiene el control ocupado hasta que se complete la persistencia y navegación.
- Mi configuración no expone controles de sesiones, eliminación de cuenta ni clave API. Consulta [Seguridad y sesiones](./security-and-sessions) y [Claves API](./api-keys).
## Solución de problemas
- Si el idioma no cambia, espera a que se complete la actualización actual, luego selecciónalo de nuevo una vez.
- Si abriste la configuración del espacio de trabajo incorrecto, cierra el diálogo, cambia de espacio de trabajo, luego vuelve a abrir Configuración.
- Si necesitas salir, abre la página Miembros de ese espacio de trabajo en lugar de buscar Salir aquí.
## Guías relacionadas
- [Miembros e invitaciones](../workspace/members-and-invitations)
- [General del espacio de trabajo](./workspace-general)
- [Seguridad y sesiones](./security-and-sessions)
- [Eliminar, recuperar y salir](./delete-recover-and-leave)
---
# Seguridad y Sesiones
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/security-and-sessions
Runner no tiene una página en la aplicación que muestre tus sesiones o elimine tu cuenta. Cierras sesión desde el menú del avatar. El soporte de Runner gestiona las solicitudes para terminar sesiones en otros dispositivos y para eliminar tu cuenta.
## Qué cubre esta guía
Sabrás cómo cerrar sesión en el dispositivo que usas y cómo pedir al soporte de Runner que termine otras sesiones o elimine tu cuenta.
## Disponibilidad y requisitos previos
- Debes haber iniciado sesión para cerrar sesión.
- Envía las solicitudes de soporte desde la dirección de correo de tu cuenta de Runner, para que el soporte pueda confirmar que la cuenta es tuya.
- La eliminación de la cuenta es permanente. Elimina todos los datos que pertenecen a la cuenta.
## Cerrar sesión en este dispositivo
1. Selecciona tu avatar en la navegación superior.
2. Selecciona **Cerrar sesión**.
3. Confirma que Runner muestra la página de inicio sin sesión.
## Terminar sesiones en otros dispositivos
1. Cierra sesión en cada dispositivo al que aún tengas acceso.
2. Si no puedes acceder a un dispositivo, o no reconoces un inicio de sesión, escribe a support@adaptivemachines.ai.
3. Indica qué cuenta está afectada y qué viste.
## Solicitar eliminación de cuenta
1. Escribe a support@adaptivemachines.ai desde la dirección de correo de tu cuenta de Runner.
2. Pide que se elimine la cuenta.
3. Sigue las instrucciones de la respuesta del soporte de Runner.
Eliminar una tienda o un espacio de trabajo no elimina tu cuenta. Consulta [Eliminar, recuperar y salir](./delete-recover-and-leave) para esas acciones.
## Solución de problemas
- Si Runner aún te muestra con la sesión iniciada después de **Cerrar sesión**, recarga la página.
- Si el soporte no puede asociar tu solicitud a una cuenta, envíala de nuevo desde la dirección de correo con la que inicias sesión.
## Guías relacionadas
- [Claves API](./api-keys)
- [Configuración personal y espacios de trabajo](./personal-settings-and-workspaces)
- [Eliminar, recuperar y salir](./delete-recover-and-leave)
---
# General de tienda
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/store-general
Las capturas y grabaciones muestran la interfaz en inglés.
General de tienda controla la tienda actual en lugar de todo el espacio de trabajo. Úsalo para renombrar la tienda, actualizar su apariencia en navegador y búsqueda, o revisar su límite de eliminación.
## Qué cubre esta guía
Podrás actualizar campos de identidad de tienda, guardar un favicon, entender el control de marca de agua con puerta de plan, y evitar eliminar la tienda incorrecta.
## Disponibilidad y requisitos previos
- Abre Configuración desde dentro del proyecto deseado; de lo contrario, el grupo Tienda no se muestra.
- Los campos de búsqueda requieren que se cargue la configuración del backend de la tienda.
- Eliminar la marca de agua de Runner requiere el plan mostrado junto a ese control.
- Eliminar tienda es destructivo y requiere el nombre exacto de la tienda.
## Ruta de acceso
Dentro del proyecto deseado, selecciona **Configuración → Tienda: _nombre de la tienda_ → General**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Selecciona **General** bajo el encabezado de la tienda, no el encabezado del espacio de trabajo. Este detalle de navegación no muestra campos de tienda editados o guardados.
## Controles
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Espacio de trabajo asociado, Creador, Hora de creación | Confirma qué tienda y contexto de propiedad estás viendo. | Estos detalles son de solo lectura. |
| **Nombre** | Renombra la tienda dentro de Runner. | Un cambio válido se guarda automáticamente. |
| **Título de la página** | Establece el título mostrado en pestañas del navegador y resultados de búsqueda. | Un cambio válido se guarda automáticamente y actualiza la vista previa. |
| **Descripción** | Establece la descripción de búsqueda corta de la tienda. | Un cambio válido se guarda automáticamente. |
| Botón Favicon | Cambia el icono de pestaña del navegador. | Se abre un popover con opciones **Subir** e **Generado por IA**. |
| **Subir imagen** | Usa tu propio archivo favicon. | Runner valida el archivo y muestra una vista previa antes de **Guardar**. |
| **Ejecutar** | Genera un favicon desde el mensaje. | Runner muestra una vista previa generada; no se aplica hasta **Guardar**. |
| Cambiar Eliminar marca de agua | Controla la marca de agua de la tienda de Runner. | El cambio está disponible solo en el plan mostrado junto al control. |
| **Chat para compradores** | Permite que los compradores obtengan respuestas instantáneas en la tienda. | El interruptor guarda la preferencia de la tienda y actualiza una vista previa abierta. Está activado de forma predeterminada. |
| **Eliminar** | Elimina la tienda actual. | **Eliminar tienda** se abre y requiere el nombre exacto de la tienda. |
## Actualiza la identidad de la tienda
1. Abre **Tienda → General** y confirma el Espacio de trabajo asociado y Nombre de tienda.
2. Edita **Nombre**, **Título de la página** o **Descripción**.
3. Espera a **Guardado** después de cada campo de guardado automático.
4. Verifica la vista previa de estilo navegador junto a la sección favicon.
Título de página y Descripción aplican los límites de caracteres actuales mostrados por sus campos. Si un campo deja de aceptar más texto, acórtalo en lugar de pegar alrededor del límite.
### Ejemplo: separa el nombre de la tienda del título de búsqueda
Para una tienda de velas, el **Nombre** de Runner podría ser `Candle Studio`, mientras que el **Título de la página** es `Candle Studio | Hand-poured candles`. Escribe una breve **Descripción** de los productos que realmente vendes. Después de cada mensaje de **Guardado**, vuelve a abrir General y verifica el valor. Los motores de búsqueda pueden tardar en actualizarse y pueden elegir un texto diferente para los resultados de búsqueda.
## Cambia el favicon
1. Selecciona el botón favicon actual.
2. Elige **Subir** o **Generado por IA**.
3. Para Cargar, selecciona un archivo ICO, PNG o SVG bajo el límite de tamaño de archivo mostrado.
4. Para Generado por IA, ingresa un mensaje opcional y selecciona **Ejecutar**.
5. Revisa la vista previa.
6. Selecciona **Guardar** para aplicarlo. Cerrar el popover descarta una vista previa sin guardar.
## Estados y límites
- Los campos de guardado automático muestran retroalimentación de guardado, éxito o error.
- Carga de Favicon rechaza formatos no compatibles y archivos de tamaño excesivo.
- **Generando…** y **Subiendo…** son estados de progreso; espera una vista previa.
- El control de marca de agua puede mostrar una insignia de plan y bloquear el cambio.
- Eliminar tienda permanece no disponible hasta que el proyecto y su nombre se carguen.
## Zona de peligro
Seleccionar **Eliminar** abre una confirmación que advierte que todos los datos de la tienda se perderán. El botón final permanece deshabilitado hasta que escribas el nombre exacto de la tienda. Algunas cuentas exponen por separado recuperación condicional, pero no debes confiar en la recuperación al decidir eliminar.
## Solución de problemas
- Si el grupo Tienda está ausente, reabre Configuración desde dentro del proyecto.
- Si un título o descripción se revierte, corrige su problema de validación y espera a Guardado.
- Si la carga de favicon falla, verifica tipo y tamaño, luego elige el archivo de nuevo.
- Si la creación de favicon generado falla, revisa el mensaje e intenta de nuevo solo después de que el intento anterior termine.
- Si Eliminar marca de agua está bloqueado, usa la insignia de plan para revisar disponibilidad.
## Guías relacionadas
- [Conecta un dominio personalizado](../storefront-and-publishing/custom-domains)
- [Scripts personalizados y agente de tienda](./custom-scripts-and-store-agent)
- [Eliminar, recuperar y salir](./delete-recover-and-leave)
---
# General del espacio de trabajo
Source: https://www.runnerai.com/docs/es/guides/account-and-settings/workspace-general
Las capturas y grabaciones muestran la interfaz en inglés.
General del espacio de trabajo controla la identidad compartida de un espacio de trabajo de Runner. Úsalo cuando el nombre del equipo o descripción cambia, o cuando necesites revisar la zona de peligro del espacio de trabajo.
## Qué cubre esta guía
Podrás actualizar detalles del espacio de trabajo y reconocer cuándo un cambio se ha guardado exitosamente.
## Disponibilidad y requisitos previos
- Se requiere un administrador o propietario del espacio de trabajo para cambiar el Nombre o Descripción compartidos.
- Solo el Propietario del espacio de trabajo puede completar la eliminación del espacio de trabajo.
- Runner no permite que el último espacio de trabajo restante sea eliminado.
## Ruta de acceso
Abre **Configuración**, confirma **Espacio de Trabajo: _nombre del espacio de trabajo_** en la barra lateral, luego selecciona la página **General** de ese grupo.
## Controles
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Nombre** | Establece el nombre completo del espacio de trabajo visible para otros miembros. | Un cambio válido se guarda automáticamente después de editar. |
| **Descripción** | Explica para qué es el espacio de trabajo o equipo. | Un cambio válido se guarda automáticamente. |
| **Eliminar espacio de trabajo** | Elimina un espacio de trabajo que ya no necesitas. | Se abre un popover de confirmación de nombre. El botón está deshabilitado para el último espacio de trabajo. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTBoRI6D7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este ejemplo de espacio de trabajo no tiene claves de analíticas listadas. Cambiar la identidad del espacio de trabajo y crear una credencial de analíticas son acciones separadas.
## Actualizar detalles del espacio de trabajo
1. Abre **Configuración → Espacio de trabajo → General**.
2. Edita **Nombre** o **Descripción**.
3. Sal del campo y observa el estado.
4. Espera a **Guardado** antes de cerrar Configuración o cambiar de espacio de trabajo.
5. Reabre la página si necesitas verificar el valor persistido.
**Punto de control:** cierra Configuración, vuelve a abrir General para el mismo espacio de trabajo y confirma el Nombre o Descripción guardados. Un campo cambiado que aún muestra **Guardando…** no es este punto de control.
## Estados y límites
- El nombre no puede estar vacío y debe mantenerse dentro de los límites de validación mostrados.
- La descripción acepta un resumen corto del espacio de trabajo y tiene un límite de caracteres mostrado.
- **Guardando…** significa que el cambio aún está en progreso.
- **Guardado** confirma que el valor actual fue aceptado.
- Un error de guardado restaura o retiene el valor guardado anterior.
- **Eliminar espacio de trabajo** está deshabilitado cuando este es tu último espacio de trabajo.
## Las claves API de analíticas son un ámbito separado
General del Espacio de Trabajo puede incluir **Claves API de Analíticas** para herramientas de reporte externas con acceso de solo lectura a analíticas. Estas son diferentes de las [Claves API personales](/es/guides/account-and-settings/api-keys), que actúan como tu cuenta iniciada. Verifica el ámbito antes de crear o compartir cualquier credencial. Una lista de claves de analíticas vacía significa que no hay clave listada aquí; no es la lista de claves personales.
## Límite de eliminación
Seleccionar **Eliminar espacio de trabajo** no elimina inmediatamente. Runner pide a un Propietario que escriba el nombre exacto del espacio de trabajo, luego habilita el botón destructivo **Eliminar**. La eliminación no se puede restaurar desde esta pantalla y elimina los datos y configuración del espacio de trabajo.
## Solución de problemas
- Si un Nombre vacío vuelve a su valor anterior, ingresa un nombre válido no vacío.
- Si **Guardado** nunca aparece, mantén el diálogo abierto, verifica el error e intenta de nuevo.
- Si Eliminar espacio de trabajo está deshabilitado, probablemente este sea el último espacio de trabajo o el espacio de trabajo no se ha cargado.
- Si abriste la configuración del espacio de trabajo incorrecto, cierra el diálogo y reabrelo desde el espacio de trabajo deseado.
## Guías relacionadas
- [Miembros e invitaciones](../workspace/members-and-invitations)
- [Configuración personal y espacios de trabajo](./personal-settings-and-workspaces)
- [Eliminar, recuperar y salir](./delete-recover-and-leave)
---
# Funciones avanzadas
Source: https://www.runnerai.com/docs/es/guides/advanced
Runner incluye formas avanzadas de investigar clientes, planificar trabajo, construir flujos de trabajo reutilizables y recibir eventos. Estas páginas se separan intencionalmente del viaje de tienda principal porque la disponibilidad y los puntos de entrada pueden diferir según el espacio de trabajo.
> **Disponibilidad:** **Investigación** puede aparecer bajo **Medir**, **Fly** en la navegación principal, y **Webhooks** bajo **Crear**. **Flujo de trabajo** sigue siendo condicional: úsalo solo cuando Runner muestre una entrada para tu espacio de trabajo o el soporte de Runner proporcione una. No adivines ni edites una URL para llegar a una página oculta. Si falta una entrada esperada, consulta [Feature availability](/es/guides/advanced/feature-availability).
| Función | Úsala para | Guía |
| --- | --- | --- |
| Investigación | Convierte una pregunta comercial en un estudio y informe estructurados. | [Investigación](/es/guides/advanced/research) |
| Fly | Establece una misión y sigue un espacio de trabajo de planificación comercial guiado. | [Fly](/es/guides/advanced/fly) |
| Flujo de trabajo | Ve y ejecuta flujos de múltiples pasos reutilizables cuando Runner proporciona una entrada. | [Flujo de trabajo](/es/guides/advanced/workflows) |
| Webhooks | Configura entregas de eventos compatibles cuando Runner proporciona una entrada. | [Webhooks](/es/guides/advanced/webhooks) |
Para herramientas agrupadas bajo **Crecer** y **Medir**, consulta [Automate, test, and create](/es/guides/automate-test-and-create).
---
# Disponibilidad de funciones
Source: https://www.runnerai.com/docs/es/guides/advanced/feature-availability
Runner puede mostrar diferentes funciones según el espacio de trabajo, rol, plan, tipo de tienda, estado de publicación, servicios conectados, datos y acceso a lanzamiento por fases.
**Ruta de entrada:** Documentación de Runner → **Funciones avanzadas** → **Disponibilidad de funciones**.
## Restricciones de disponibilidad comunes
| Lo que ves | Requisito probable | Qué hacer |
| --- | --- | --- |
| La entrada falta | La función está en fase, deshabilitada o no disponible para este espacio de trabajo. | Verifica el espacio de trabajo y pregunta a un propietario o al soporte. No uses una URL adivinada. |
| Mensaje de actualización | El plan actual no incluye la acción o se alcanzó su límite. | Abre **Plan y Facturación** y revisa la oferta actual en pantalla. |
| Requisito de publicación | La herramienta necesita una tienda activa o datos de sitio publicados. | Completa la lista de verificación de publicación y regresa después de una publicación exitosa. |
| Botón de conexión | Un proveedor o cuenta debe conectarse primero. | Abre la aplicación nombrada y completa su flujo de conexión oficial. |
| Panel vacío | La función está disponible pero no tiene datos para la tienda, filtro o período seleccionado. | Confirma tienda, rango de fechas, publicación y recopilación de eventos. |
| Mensaje de permiso | Tu rol en el espacio de trabajo no puede realizar la acción. | Pide a un propietario que la complete o cambia el acceso. |
| Página no encontrada | La ruta no está disponible, está retirada o no es válida para este contexto. | Regresa a través de la navegación visible y contacta al soporte si la entrada misma está rota. |
## Verifica en orden
1. Confirma el espacio de trabajo y tienda seleccionados.
2. Expande **Crear**, **Crecer** y **Medir** en la navegación del proyecto antes de decidir que falta una entrada. En móvil, abre primero el menú del proyecto.
3. Verifica si la página menciona un requisito previo.
4. Verifica tu rol y el plan actual en la configuración del espacio de trabajo.
5. Confirma la publicación, datos o conexión de aplicación requeridos.
6. Recarga una vez después de un cambio reciente de acceso o conexión.
7. Contacta al soporte con la página exacta, estado visible, nombre del espacio de trabajo y tienda.
### Qué no asumir
- Una entrada oculta no prueba que la función se haya eliminado de todas las cuentas.
- Una página vacía no prueba que la recopilación esté rota.
- Una ruta de origen no prueba que tu espacio de trabajo pueda usar la función.
- Una conexión exitosa no prueba el pago, cumplimiento o informes posteriores sin un resultado de extremo a extremo.
## Cuando la página es solo una vista previa
Una vista previa de función puede mostrar tarjetas de muestra mientras un aviso de actualización bloquea acciones reales. Lee ese aviso antes de interpretar las tarjetas como datos de tu tienda. Para el diccionario completo de estados, consulta [States and availability](../help-and-reference/states-and-availability).
## Guías relacionadas
- [Estados y disponibilidad](../help-and-reference/states-and-availability)
- [Planes de suscripción](../plans-and-billing/subscription-plans)
- [Soluciona problemas de publicación, pago y aplicaciones](../help-and-reference/troubleshoot-publishing-checkout-apps)
- [Soporte y comunidad](../help-and-reference/support-and-community)
---
# Fly
Source: https://www.runnerai.com/docs/es/guides/advanced/fly
Las capturas y grabaciones muestran la interfaz en inglés.
Fly es un espacio de trabajo guiado para convertir un objetivo de tienda en una misión, revisar el trabajo propuesto y seguir el progreso desde un único panel de control.
## Ruta de acceso
Abre un proyecto de tienda y selecciona **Fly** cuando esté disponible. Si falta la entrada, consulta [Disponibilidad de funciones](./feature-availability).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOvxtCXuJCcW62zHrU8smjSnqvixd1twlAf4u)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Revisa la primera misión y sus etapas de lanzamiento antes de elegir Iniciar esta misión. Esta vista es de configuración, no una misión activa.
## Antes de empezar
- Fly debe estar habilitado para el proyecto actual.
- Revisa la tienda, la misión y las tareas de propuesta afectadas antes de aprobar el trabajo.
- Las acciones de propuesta, cancelación y siguiente misión pueden cambiar el trabajo real del proyecto; usa el texto de confirmación como autoridad final.
## Inicia la primera misión
Los proyectos sin una misión abren la incorporación automáticamente.
1. Abre **Fly** y lee el objetivo propuesto de la tienda.
2. Si un tablero ya muestra una misión, revisa esa misión en lugar de comenzar otra.
3. Revisa la misión sugerida y sus etapas. La introducción **Consigue tu primer pedido pagado** presenta cinco etapas y una acción **Iniciar esta misión**. Selecciónala solo cuando tengas la intención de comenzar esa misión; de lo contrario, cierra la incorporación.
4. Confirma que el tablero muestre la misión prevista antes de revisar propuestas.
**Punto de control:** Abrir la incorporación solo muestra la propuesta para una misión. La misión existe después de que la confirmes y el tablero la muestre.
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Inicia tu primera misión** | Reabre la incorporación cuando el proyecto aún no tiene una misión. |
| **Iniciar esta misión** | Inicia la misión descrita por la introducción. Revisa su objetivo y etapas antes de confirmar. |
| **Establecer esta misión**, cuando se muestra en la configuración de la misión | Crea la misión propuesta para el proyecto actual y abre el tablero de Fly. Revisa la tienda y el objetivo antes de confirmar. |
Cerrar la incorporación sin confirmar la misión deja el proyecto sin una nueva misión. Puedes regresar con **Iniciar tu primera misión**.
Después de la incorporación, **Obtén tu primera propuesta** puede abrir una lista de verificación de lanzamiento de solo lectura. Cuando **Ver detalle** aparece en **Construir tienda**, abre la primera conversación de Runner del proyecto. El botón está ausente cuando no se registra la primera conversación.
## Leer el panel
El panel de control reúne la misión actual y la actividad de la tienda. En pantallas más pequeñas, las mismas secciones se apilan verticalmente.
| Sección | Qué muestra |
| --- | --- |
| Progreso de la misión | El objetivo activo y el progreso hacia él. |
| Pedidos, Ingresos y Sesiones | Las señales principales de la tienda de hoy. Estos son resúmenes de solo lectura. |
| **Feeds** | Señales recientes y observaciones actuales de Fly. Selecciona una historia para abrir su visor. |
| **Trabajo en curso** | Propuestas aprobadas que se están ejecutando o esperando tu acción. Selecciona una tarjeta para abrir los detalles de su propuesta. |
| **Trabajo anterior** | Propuestas completadas o fallidas. Selecciona una tarjeta para revisarla; **Mostrar más** carga entradas más antiguas. |
| **Tus tareas pendientes** | Tareas que necesitan tu atención. **Anterior** y **Siguiente** se mueven a través de más de una página de elementos. |
| Vista previa de la tienda | Muestra el estado de publicación actual cuando está disponible. Selecciónalo para abrir **Tienda**. |
| **Abrir chat** | Abre el chat de Fly para que puedas preguntar sobre la misión o el trabajo visible. **Cerrar chat** lo cierra. |
| **Todo al día** | Aparece cuando ninguna tarea pendiente o propuesta necesita una decisión. Confirma que Fly sigue monitoreando la tienda; no significa que todas las tareas en ejecución estén terminadas. |
| **Explorar Runner** | Cuando la cola está vacía, ofrece **Abrir Estudio Creativo** cuando esté habilitado, **Explorar Habilidades** y **Explorar Automatizaciones**. Cada botón abre esa herramienta de proyecto sin iniciar trabajo por sí solo. |
Una sección vacía de **Trabajo en curso** o **Trabajo anterior** puede estar oculta. Eso significa que no hay nada en ese estado, no que el historial del proyecto haya sido borrado.
En el chat de Fly, **Nueva conversación** inicia un hilo nuevo, mientras que el historial reabre uno anterior. El primer mensaje crea la conversación. Si el envío falla, el borrador permanece en el compositor para que puedas reintentar sin reescribirlo.
### Lee una historia de Fly
El visor de historias muestra **elemento actual de total** en su encabezado. Usa las flechas anterior y siguiente para moverte entre elementos, o cierra el visor para volver al panel de control. Cuando una historia incluye una tarjeta de fuente vinculada, seleccionarla abre esa fuente exacta en una nueva pestaña del navegador. Si la historia no se puede cargar, selecciona **Reintentar** sin salir de Fly. Las tarjetas de noticias de mercado pueden desaparecer después de que dejen de ser recientes.
## Revisa una propuesta
Abre una propuesta desde el panel de control antes de permitir que comience el trabajo. Una propuesta puede contener varias tareas; seleccionar una tarea también puede incluir los requisitos previos de los que depende.
| Control o estado | Qué sucede después |
| --- | --- |
| Selección de tarea | Elige qué tareas aprobar. Las tareas de requisito previo requeridas se incluyen para que el trabajo seleccionado pueda ejecutarse en orden. |
| **Aprobar y ejecutar** | Aprueba las tareas seleccionadas e inicia la ejecución. No está disponible cuando no se selecciona ninguna tarea. Las acciones conectadas pueden tener efectos reales. |
| **Rechazar** | Abre una confirmación. Confirmar cierra la propuesta y no ejecuta ninguna de sus tareas; esto no se puede deshacer. |
| **Cancelar** | Abre **¿Cancelar esta propuesta?** mientras se ejecuta el trabajo. **Confirmar cancelación** detiene las tareas sin terminar; el trabajo completado se mantiene. **Mantener en ejecución** cierra la confirmación. |
| **Vista previa** | Abre el resultado del flujo de trabajo completado cuando una vista previa está disponible. |
| **Ver detalle** | En una tarea de propuesta inicial compatible, abre la conversación de Runner relacionada para que puedas revisar el contexto del trabajo. |
| Esperando tu acción | La ejecución se pausa hasta que completes la acción manual solicitada y selecciones **Resolver**. |
| **Útil** / **No es útil** | **Útil** se guarda de inmediato. **No es útil** abre motivos y detalles editables; cerrarlos mantiene los comentarios existentes y los cambios solo se guardan después de **Enviar**. |
Algunas páginas de propuesta en fase de revisión también muestran un panel de chat de propuesta. Úsalo para preguntar sobre esa propuesta; no reemplaza **Aprobar y ejecutar**, **Rechazar**, **Cancelar** o **Resolver** cuando se muestra la acción aplicable.
La sección **Resultados** permanece oculta mientras una propuesta está bajo revisión, en ejecución o siendo verificada. Puede aparecer después de la finalización o el fallo solo cuando los datos de resultado están listos. Una sección de Resultados faltante durante el trabajo activo no es evidencia de que la propuesta haya fallado.
Para resultados de documentos y medios, **Descargar** guarda el entregable disponible, **Restaurar medios** vuelve a intentar obtener medios no disponibles y **Continuar en el chat** abre instrucciones de seguimiento editables. Estas acciones no cambian el estado de aceptación o revisión de la propuesta.
Cuando una propuesta incluye generación de video de Fly, la tarea actual produce un video de 720p de 6 segundos con audio. Pedir otra duración en el mensaje de la tarea no cambia esa longitud de salida.
## Resuelve una tarea de tu propiedad
Cuando una tarea marcada como **Tu tarea** se pausa para una acción que solo tú puedes completar, lee sus instrucciones, completa la acción fuera de la tarjeta y luego selecciona **Resolver**.
**Resolver** es tu confirmación de que completaste la acción solicitada; Runner no verifica independientemente ese resultado externo. Mientras Runner verifica el estado, la tarjeta muestra **Cargando acción de tarea**. Mientras se envía, el botón muestra **Resolviendo…**. **Esta tarea ya no está esperando tu acción.** significa que no se puede resolver desde la tarjeta actual. Si ves **No se pudo resolver esta tarea. Por favor, inténtalo de nuevo.**, verifica la conexión e inténtalo una vez más. No marques una tarea como resuelta antes de que la acción solicitada esté realmente completa.
## Resuelve tareas pendientes
Selecciona **Resolver** solo en una tarea de un clic elegible. Runner luego registra tu confirmación desde el panel de control. Las tareas más detalladas, incluidas las tareas con salidas de archivo, permanecen de solo lectura en la lista de tareas pendientes; abre la propuesta relacionada para revisar sus instrucciones y estado actual.
Si la resolución falla, mantén la tarea abierta e inténtalo de nuevo después de verificar la conexión. No asumas que la tarea se completó hasta que su estado cambie.
## Sigue el trabajo en curso y anterior
1. Abre una tarjeta en **Trabajo en curso** para ver su propuesta actual y estados de tarea.
2. Si dice **Esperando tu acción**, completa la acción manual solicitada y selecciona **Resolver** en lugar de aprobar la propuesta de nuevo.
3. Usa Cancelar solo cuando el trabajo sin terminar deba detenerse. El trabajo ya completado no se revierte.
4. Abre **Trabajo anterior** para revisar resultados y propuestas fallidas.
5. Para un fallo, mantén el título de la propuesta y el error de tarea visible antes de pedir ayuda.
## Completa una misión y elige la siguiente
Cuando Runner reconoce que se logra una misión, **Misión completada** abre un flujo guiado. Si lo cierras antes de elegir otro objetivo, **Elige tu siguiente misión** puede reabrir el flujo.
1. Selecciona **Revisa el viaje** para ver el resumen de la misión, momentos importantes y el trabajo que Fly completó junto a ti.
2. Selecciona **Ve qué sigue** para revisar la siguiente misión sugerida.
3. Ajusta el objetivo con el ajuste preestablecido disponible o controles de aumento/disminución, luego selecciona **Continuar**.
4. Lee el resumen del lanzamiento cuidadosamente.
5. Selecciona **Comenzar misión** solo cuando el nuevo objetivo sea correcto.
6. Cuando la siguiente misión esté activa, selecciona **Ir al control de misión** para volver al panel de control.
**Comenzar misión** tiene efectos reales en el proyecto: las tareas ya en ejecución continúan, la generación de propuestas se reanuda contra el nuevo objetivo, y las propuestas en las que no has actuado se cierran para que Fly pueda regenerarlas para el nuevo objetivo. El progreso actual se mantiene.
## Solución de problemas
| Estado | Siguiente paso |
| --- | --- |
| La incorporación se abre automáticamente | Establece la misión o cierra la incorporación y vuelve más tarde. |
| Aparece el panel de control | Existe una misión; usa el panel de control en lugar de crear un duplicado. |
| **Esperando tu acción** | Abre la propuesta, completa la acción manual específica y luego selecciona **Resolver**. |
| Conflicto de cancelación o estado cambió en otro lugar | Actualiza la propuesta y usa su estado actual. |
| La vista previa completada no se carga | Selecciona **Reintentar** en la vista previa del flujo de trabajo, o reabre la propuesta completada para el resultado más reciente. |
| La propuesta falló | Ábrela desde **Trabajo anterior** y mantén el error de tarea visible. |
| La verificación final no puede recuperarse | La propuesta se resuelve como fallida en lugar de permanecer en el trabajo en curso. Ábrela desde **Trabajo anterior** y mantén el error visible antes de reintentar. |
| La siguiente misión no puede comenzar | Inténtalo de nuevo. Si otra sesión ya la inició, el panel de control se actualiza a la misión activa. |
| Entrada faltante o página no encontrada | Fly no está disponible en este contexto. Consulta [Disponibilidad de funciones](./feature-availability). |
## Guías relacionadas
- [Disponibilidad de funciones](./feature-availability)
- [Estados y detalles de tareas](../work-with-runner/task-states-and-details)
- [Soluciona problemas de tareas de Runner](../help-and-reference/troubleshoot-runner-tasks)
---
# Investigación
Source: https://www.runnerai.com/docs/es/guides/advanced/research
La investigación proporciona un lugar con alcance de proyecto para investigar necesidades de compradores, conceptos, posicionamiento y otras decisiones comerciales.
## Ruta de acceso
Abre un proyecto de tienda y expande **Medir** y selecciona **Investigación** cuando la función esté disponible. En móvil, abre primero el menú del proyecto. Si **Investigación** está ausente, ese espacio de trabajo actualmente no expone la función; consulta [Feature availability](./feature-availability).
## Antes de empezar
- La investigación debe estar habilitada para el proyecto actual.
- Prepara una pregunta comercial con al menos cinco caracteres y elimina datos de cliente innecesarios.
- El reconocimiento en vivo, paneles e informes pueden usar datos externos o créditos; revisa cada acción disponible antes de iniciarla.
## Inicia o reabre un estudio
La página de inicio de investigación tiene dos modos: **Nuevo estudio** y **Paneles guardados**.
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Nuevo estudio** | Abre el formulario de pregunta y los estudios recientes del proyecto. |
| Campo de pregunta | Acepta la decisión empresarial que deseas investigar. **Iniciar estudio** permanece no disponible hasta que la pregunta sea válida. |
| Tarjeta de escenario | Coloca una dirección de investigación sugerida en el campo de pregunta para que puedas editarla. |
| **Iniciar estudio** | Crea un estudio en vivo a partir de la pregunta actual y abre su espacio de trabajo guiado. |
| **Ver un ejemplo terminado primero** | Abre una vista previa de ejemplo de solo lectura. No crea un estudio en vivo, y las acciones que requieren un estudio en vivo pueden no estar disponibles. |
| Tarjeta de estudio reciente | Reabre el estudio existente de ese proyecto. |
| **Paneles guardados** | Abre paneles guardados para reutilización. |
| **Lanzar estudio** | Selecciona ese panel guardado y regresa a **Nuevo estudio**. Ingresa una nueva pregunta de investigación, luego selecciona **Iniciar estudio** para crear el estudio. |
| **Cargar más** | Carga estudios o paneles guardados adicionales. |
| **Reintentar** | Solicita la biblioteca actual o etapa fallida nuevamente. |
Usa una decisión enfocada como la pregunta. Una pregunta como "¿Qué afirmación de producto deberíamos liderar para compradores por primera vez?" le da al estudio un trabajo más claro que un tema amplio como "marketing".
## Muévete a través de las etapas guiadas
El lado izquierdo de un estudio hace preguntas y ofrece opciones. Selecciona las opciones relevantes, agrega una respuesta personalizada cuando sea necesario, luego usa la acción principal para la etapa actual.
| Acción | Qué inicia Runner |
| --- | --- |
| **Construir plan de investigación** | Convierte tu pregunta y respuestas en un plan de estudio. |
| **Modificar entradas** | Reabre las entradas de planificación antes de que comience el reconocimiento. |
| **Reconstruir plan de investigación** | Reemplaza el plan actual con un nuevo plan basado en las entradas modificadas. |
| **Comenzar reconocimiento [fuente]** (por ejemplo, **Comenzar reconocimiento X**) | Comienza el reconocimiento en la fuente nombrada por el plan aprobado. |
| **Construir el panel de validación** | Construye el panel de audiencia utilizado para desafiar y validar los hallazgos. |
| **Comenzar discusión de panel** | Comienza la conversación del panel. |
| **Generar resumen, actas e informe** | Produce los artefactos escritos finales de la discusión completada. |
| **Reintentar** seguido de un nombre de etapa | Repite la etapa fallida. Revisa la falla primero para no repetir la misma entrada ciegamente. |
La acción principal exacta cambia a medida que cada etapa se vuelve lista. No selecciones una acción de etapa posterior hasta que estés satisfecho con el plan, hallazgos o panel actual.
## Revisa artefactos de estudio
En escritorio, el chat guiado y el lienzo de artefactos se sientan lado a lado y pueden redimensionarse. En dispositivos móviles, usa **Chat de estudio** y **Artefactos** para cambiar entre ellos.
| Pestaña de artefacto | Lo que contiene |
| --- | --- |
| **Resumen** | La línea de tiempo del estudio y qué etapas están listas o pendientes. Seleccionar un elemento listo abre su artefacto. |
| **Plan** | El enfoque de investigación aprobado. Permanece vacío hasta que se termine la planificación. |
| **Reconocimiento [fuente]** (por ejemplo, **Reconocimiento X**) | El progreso del reconocimiento y las fuentes para la fuente actual del estudio. |
| **Hallazgos** | Temas y evidencia producidos después del reconocimiento. |
| **Panel** | La audiencia de validación construida a partir de los hallazgos. |
| **Discusión** | La conversación del panel y respuestas de seguimiento. |
| **Informe** | El espacio de trabajo del informe final después de que se complete la discusión. |
Una pestaña pendiente no es un error: su estado vacío explica qué etapa anterior debe terminar primero. La línea de tiempo de descripción general también marca las etapas no disponibles como pendientes.
## Guarda un panel útil
Abre **Panel** y selecciona **Guardar panel** cuando su audiencia sea útil para estudios posteriores. Ingresa el nombre del panel y descripción opcional en el formulario de guardado, luego confirma. Runner reporta **Panel guardado para estudios futuros**, y el panel aparece bajo **Paneles guardados**.
Guardar preserva el panel para reutilización; no inicia otro estudio. En una vista previa de ejemplo, guardar no está disponible porque el ejemplo no es datos de proyecto en vivo.
## Lee y comparte el informe
El espacio de trabajo del informe final separa tres vistas:
- **Informe** presenta el resultado de investigación completo.
- **Resumen** da la versión más corta enfocada en decisiones.
- **Actas** registra la discusión del panel.
Selecciona **Compartir** para compartir el enlace del estudio actual con el panel de compartición del dispositivo cuando sea compatible. Si el compartición nativa no está disponible, Runner copia el enlace y muestra **Enlace de estudio copiado**. Compartir envía un enlace, no un informe estático descargado; el destinatario aún necesita acceso apropiado.
## Continúa la discusión del panel
Durante la etapa de discusión, usa el compositor de seguimiento para pedir una respuesta más clara o probar un ángulo diferente.
| Control | Resultado |
| --- | --- |
| **Desafiar un hallazgo** | Llena el compositor con un mensaje de desafío que puedes editar. |
| **Pregunta al panel** | Llena el compositor con una pregunta directa al panel. |
| **Cambiar la audiencia** | Llena el compositor con una solicitud para considerar una audiencia diferente. |
| **Enviar seguimiento** | Envía el mensaje actual a la discusión del panel en vivo. |
Las tarjetas de sugerencia preparan texto; no envían nada hasta que selecciones **Enviar seguimiento**. Si el compositor está sobre su límite o el estudio no está listo, la acción de envío permanece no disponible.
## Solución de problemas
| Estado | Significado y siguiente paso |
| --- | --- |
| Ejemplo | Una demostración completada, no investigación de proyecto en vivo. Regresa a **Nuevo estudio** para crear la tuya. |
| Artefacto pendiente | Una etapa anterior no ha terminado. Regresa a Descripción general o Chat de estudio y continúa la etapa disponible. |
| La etapa se está ejecutando | Runner está preparando el siguiente artefacto. Puedes regresar a través de estudios recientes más tarde. |
| Falla reintentable | Lee el error visible, luego usa el **Reintentar** específico de la etapa una vez. |
| La recuperación está bloqueada | Selecciona **Actualizar estudio** para cargar el estado actual del servidor antes de continuar. |
| El seguimiento falla | Mantén el mensaje, usa Reintentar cuando se ofrezca, o actualiza el estudio antes de reenviar. |
| La biblioteca de estudio o panel falla | Selecciona **Reintentar**. Preserva la pregunta y el error visible si se repite. |
| Historial de estudio vacío | Este proyecto aún no tiene un estudio. Comienza con una pregunta enfocada en decisiones. |
## Ruta recomendada
1. Abre **Nuevo estudio** e ingresa una pregunta enfocada en decisiones.
2. Selecciona **Iniciar estudio** y responde las opciones guiadas.
3. Revisa el Plan; usa **Modificar entradas** antes del reconocimiento si el alcance es incorrecto.
4. Muévete a través de Reconocimiento, Hallazgos, Panel y Discusión, revisando cada artefacto listo.
5. Guarda el panel solo cuando su audiencia será útil nuevamente.
6. Genera y lee el Informe, Resumen y Actas.
7. Comparte el enlace del estudio solo con personas que deberían tener acceso.
8. Usa seguimientos para brechas específicas en lugar de iniciar un estudio duplicado.
## Prueba el ejemplo antes de un estudio en vivo
1. Abre **Medir** → **Investigación** → **Nuevo estudio**.
2. Selecciona **Ver un ejemplo terminado primero**.
3. Lee el plan de ejemplo y el informe usando las pestañas de artefactos disponibles.
4. Regresa a **Nuevo estudio** y escribe una decisión que deseas investigar.
5. Selecciona **Iniciar estudio** solo cuando estés listo para crear un estudio en vivo.
**Punto de control:** El ejemplo te permite inspeccionar el formato de salida sin crear un estudio. Para tu propio estudio, confirma que tu pregunta aparezca en su espacio de trabajo; las acciones de exploración y reporte posteriores tienen su propio progreso y resultados.
## Guías relacionadas
- [Disponibilidad de funciones](./feature-availability)
- [Experimentos](../automate-test-and-create/experiments)
- [Descripción general de análisis](../analytics-and-seo/analytics-overview)
- [Soporte y comunidad](../help-and-reference/support-and-community)
---
# Webhooks
Source: https://www.runnerai.com/docs/es/guides/advanced/webhooks
Los Webhooks permiten que otro servicio reciba eventos seleccionados de un proyecto de Runner. Esta es una función avanzada y sensible a la seguridad: úsala solo cuando sepas qué servicio debe recibir los eventos y cómo ese servicio los verifica.
## Ruta de acceso
Abre **Crear** → **Webhooks** cuando Runner haga la entrada disponible para tu espacio de trabajo. Si no hay entrada, no adivines una URL; consulta [Feature availability](./feature-availability) o pregunta al soporte si la función está habilitada.
## Antes de empezar
- Usa Webhooks solo cuando Runner o el soporte exponga una entrada aprobada.
- Conoce el servicio receptor previsto y cómo verifica los eventos.
- Trata las direcciones de punto final, secretos de firma y datos entregados como sensibles.
## Lo que Runner muestra
Tu espacio de trabajo puede mostrar el banco de trabajo de webhooks de Runner o un portal de proveedor incrustado. Sigue la sección que coincida con tu pantalla.
### Inspecciona el banco de trabajo de Runner
**Condicional:** Cuando el banco de trabajo de primera parte está habilitado, usa estas pestañas:
| Pestaña | Qué revisar |
| --- | --- |
| **Puntos finales** | Destinos de recepción configurados y su estado. |
| **Catálogo** | Tipos de eventos disponibles antes de elegir lo que recibe un destino. |
| **Registros** | Entregas registradas y su estado devuelto. |
| **Actividad** | Actividad reciente de webhook. |
1. Abre **Puntos finales** e identifica el destino que deseas inspeccionar.
2. Lee **Catálogo** para verificar el tipo de evento relevante.
3. Abre **Registros** e inspecciona una entrega disponible para ese destino.
4. Compara su estado con el propio registro del servicio receptor antes de llamar a la entrega exitosa.
**Punto de control:** Un punto final guardado confirma la configuración; un registro de entrega exitoso y un registro receptor coincidente confirman ese evento en particular. Un registro vacío no prueba que la entrega esté funcionando. Las acciones de prueba, reenvío y reproducción envían eventos; úsalas solo para una prueba intencionada.
### Portal de proveedor incrustado
Runner prepara el servicio de webhook antes de mostrar el portal de gestión integrado.
| Estado de página o control | Lo que significa o hace |
| --- | --- |
| **Cargando...** | Runner está verificando si el servicio de webhook está listo. |
| **La plataforma de webhook se está inicializando** | La configuración aún está en progreso. Espera y mantén la página abierta, o regresa más tarde. |
| **La inicialización está tomando más tiempo del esperado** | La configuración no se ha completado después de la espera normal. **Reintentar** pide a Runner que aprovisione el servicio nuevamente. |
| **Reintentando…** | El reintento está en progreso; el botón permanece no disponible hasta que la solicitud se termine. |
| Mensaje de error | Runner no pudo preparar el servicio. Mantén el mensaje visible para el soporte. |
| Portal de webhook integrado | El servicio está listo. Las etiquetas y controles exactos dentro de este portal administrado por el proveedor pueden cambiar, así que sigue las instrucciones mostradas allí en lugar de confiar en nombres de botón fijos en esta guía. |
| **Reconectar Shopify** | Abre la página de integración de Shopify cuando una conexión de Shopify más antigua necesita nuevos permisos de webhook. Reconecta antes de esperar que lleguen eventos de Shopify. |
## Recuperate de una inicialización larga
1. Espera a que el mensaje de inicialización se termine.
2. Si **La inicialización está tomando más tiempo del esperado** aparece, selecciona **Reintentar** una vez.
3. Espera a que el portal integrado reemplace la pantalla de inicialización.
4. Si aparece un error nuevamente, guarda el nombre del proyecto y el mensaje exacto, luego contacta al soporte en lugar de reintentar repetidamente.
## Reconecta Shopify cuando se solicite
1. Lee el aviso **Vuelve a conectar tu tienda Shopify**.
2. Selecciona **Reconectar Shopify**.
3. Completa el flujo de conexión en la página de integración de Shopify.
4. Regresa a Webhooks y confirma que el aviso de reconexión se haya ido antes de confiar en la entrega de eventos.
Reconectar cambia la autorización de integración de la tienda. Solo una persona que pueda gestionar esa conexión de tienda debe continuar.
## Notas de seguridad
- Trata las direcciones de punto final, secretos de firma y contenidos de eventos como sensibles.
- Agrega o cambia un destino solo cuando su propietario haya proporcionado la dirección segura correcta.
- Revisa cada confirmación mostrada dentro del portal integrado; sus acciones pueden afectar entregas futuras.
- Si un valor de firma se expone, reemplázalo en el servicio de webhook de Runner y el sistema receptor antes de enviar más eventos.
## Solución de problemas
| Problema | Siguiente paso |
| --- | --- |
| Sin entrada de Webhooks | La función no está expuesta en este espacio de trabajo. Verifica [Disponibilidad de funciones](./feature-availability). |
| La inicialización no se termina | Usa **Reintentar** una vez, luego reporta el estado exacto si se repite. |
| Aparece mensaje de error | Mantén el mensaje completo y el nombre del proyecto para el soporte. |
| El aviso de reconexión de Shopify permanece | Termina de reconectar desde la página de integración, luego recarga Webhooks una vez. |
| El portal integrado está en blanco o se comporta diferente | Recarga una vez. Si persiste, captura lo que es visible; la interfaz del proveedor integrado puede diferir por cuenta o lanzamiento. |
## Guías relacionadas
- [Disponibilidad de funciones](./feature-availability)
- [Seguridad y sesiones](../account-and-settings/security-and-sessions)
- [Solución de problemas de aplicaciones](../apps-and-integrations/troubleshooting)
- [Soporte y comunidad](../help-and-reference/support-and-community)
---
# Flujo de trabajo
Source: https://www.runnerai.com/docs/es/guides/advanced/workflows
Flujo de trabajo convierte un proceso repetible en pasos conectados que Runner puede ejecutar con las mismas entradas y reglas una y otra vez.
> **Condicional:** La interfaz de Flujo de trabajo existe, pero la navegación estándar del proyecto actual no expone una entrada de Flujo de trabajo. Úsala solo cuando Runner muestre una entrada de Flujo de trabajo aprobada para tu espacio de trabajo o cuando el soporte de Runner proporcione una ruta aprobada. No adivines ni edites una URL para acceder a ella. Si tu plan permite solo una vista previa, Runner puede mostrar la página mientras mantiene sus controles bloqueados.
## Ruta de acceso
Abre la entrada **Flujo** solo cuando Runner la presente en tu espacio de trabajo. La página enumera los flujos de trabajo del proyecto actual. Si no hay entrada presente, usa [Disponibilidad de funciones](./feature-availability) o contacta con soporte en lugar de intentar una URL directa.
## Antes de empezar
- El acceso a Flujo de trabajo depende del lanzamiento de funciones actual y del plan.
- Confirma el proyecto y los servicios conectados antes de probar o implementar un flujo de trabajo.
- Una vista previa o borrador guardado no está activo; la implementación y la activación son acciones separadas y consecuentes.
## Lista de flujos de trabajo
Cuando no hay flujos de trabajo, selecciona **Crear flujo de trabajo**. Cuando la lista ya tiene elementos, usa **Nuevo flujo de trabajo**.
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Crear flujo de trabajo** o **Nuevo flujo de trabajo** | Abre **Crear un flujo de trabajo**. |
| **Flujo de trabajo en blanco** | Crea un **Flujo de trabajo sin título** y abre su constructor. |
| Tarjeta de plantilla | Crea un flujo de trabajo a partir de esa plantilla y abre su constructor. Si las plantillas no se cargan, **Reintentar** las solicita de nuevo. |
| Nombre del flujo de trabajo | Abre ese flujo de trabajo en el constructor. |
| **Cambiar nombre** | Hace que el nombre sea editable. Presionar Intro o hacer clic fuera guarda; Escape cancela la edición. |
| **Fijar arriba** / **Desfijar** | Mueve el flujo de trabajo hacia o fuera del grupo fijado. No ejecuta el flujo de trabajo. |
| **Duplicar** | Crea una copia y abre la copia en el constructor. |
| **Exportar** | Descarga el flujo de trabajo como archivo JSON. No implementa ni ejecuta nada. |
| **Eliminar** | Abre una confirmación. Confirmar elimina permanentemente ese flujo de trabajo y no se puede deshacer. |
Usa el menú Más de cada fila para encontrar **Cambiar nombre**, **Fijar arriba** o **Desfijar**, **Duplicar**, **Exportar** y **Eliminar**.
Las etiquetas de fila también pueden mostrar si una versión está en estado **En producción**, tiene un **Borrador más reciente**, expone un Punto final, o está vinculada a una Programación o Evento. Una etiqueta pausada o bloqueada por plan significa que el desencadenamiento automático no está activo actualmente.
### Trabajar con varios flujos de trabajo
Selecciona la casilla de verificación junto a una o más filas. La barra de selección muestra cuántas están seleccionadas y ofrece:
- **Exportar** para descargar los flujos de trabajo seleccionados.
- **Eliminar** para abrir una confirmación masiva. Confirmar elimina permanentemente cada flujo de trabajo seleccionado.
- **Limpiar** para eliminar la selección sin cambiar ningún flujo de trabajo.
**Seleccionar todo** selecciona los flujos de trabajo mostrados en la lista actual. Siempre recomprueba el recuento antes de la eliminación masiva.
## Construir y guardar
El lienzo del constructor es donde añades pasos, los conectas y configuras qué recibe y hace cada paso. **Añadir componente** abre la biblioteca de componentes que se puede buscar. Los controles del lienzo amplían, reducen, ajustan el flujo de trabajo en la pantalla y organizan automáticamente los pasos conectados.
Los cambios se guardan automáticamente; no hay un botón Guardar separado. La flecha Atrás finaliza un guardado pendiente antes de volver a la lista de flujos de trabajo.
| Estado de guardado | Qué hacer |
| --- | --- |
| **Guardando...** | Espera antes de cerrar la página o implementar. |
| **Guardado** | El último cambio del lienzo se almacena. |
| **Error al guardar** | Selecciona **Reintentar** después de verificar la conexión. |
| **Conflicto: sus cambios no se guardaron** | Una versión guardada es más reciente. **recargar** descarta las ediciones locales conflictivas y carga la versión guardada. |
El panel inferior contiene **Zona de pruebas** y **Ejecuciones**. En Zona de pruebas, completa las entradas de texto, producto o medios requeridas antes de ejecutar. El control de ejecución permanece no disponible mientras falten entradas requeridas. Los resultados aparecen en el área de salida.
El menú Más del constructor también proporciona **Exportar JSON** e **Importar JSON…**. Exportar descarga el lienzo actual. Importar reemplaza inmediatamente el lienzo actual y desencadena el guardado automático sin confirmación, así que exporta una copia de seguridad y verifica el archivo seleccionado antes de importar.
## Elige la prueba correcta
Las pruebas pueden tener consecuencias muy diferentes.
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Simular** | Abre un diálogo de simulación. Usa datos de muestra generados o pega JSON, luego selecciona **Ejecutar simulación**. Las acciones del lado de escritura como correos electrónicos, publicaciones de Slack y cambios de tienda se simulan. |
| **Prueba en vivo** | Abre un diálogo de prueba en vivo. Usa datos generados, JSON pegado o un evento reciente cuando esté disponible. **Ejecutar prueba en vivo** realiza llamadas API reales y puede enviar mensajes o cambiar servicios conectados. La ejecución se marca como prueba en el historial. |
| **Omitir esperas** | Durante una prueba en vivo, omite los períodos de espera configurados para que la prueba pueda continuar antes. No elimina otros efectos reales. |
| **Ejecutar flujo de trabajo** | Inicia el flujo de trabajo configurado inmediatamente y abre Ejecuciones. Sus pasos pueden tener efectos reales; revisa cada paso e entrada primero. |
| **Detener** | Solicita que se detenga la ejecución actual. El trabajo ya completado no se revierte. |
| **Caché** | En una reejecución, omite nodos elegibles cuyas entradas no han cambiado para que puedas enfocarte en el trabajo modificado aguas abajo. |
Usa Simulación para verificar ramificación y flujo de datos. Usa Prueba en vivo solo cuando los efectos secundarios reales sean aceptables en las cuentas conectadas.
Ambas pruebas usan el activador que elegiste, incluso antes de implementar. Para un activador **Programación** o **Una vez**, la prueba inicia la ejecución como si el activador se disparara en ese momento, así que puedes probar un flujo de trabajo de una sola vez antes de su fecha programada.
## Revisar historial de ejecución
Abre **Ejecuciones** en el panel inferior para ver ejecuciones anteriores. Filtra la lista con **En vivo**, **Prueba** o **Todas las ejecuciones**, luego selecciona una ejecución para inspeccionar sus resultados de nodo, salida, tiempo y errores. Los estados incluyen Completado, Fallido, En ejecución y Cancelado.
Si la lista dice **Aún no se ha ejecutado**, el flujo de trabajo actual no tiene ejecución registrada. Iniciar otra ejecución no es una solución para una fallida; abre primero la ejecución fallida y lee su error.
Algunos nodos fallidos elegibles ofrecen **Reintentar desde "nodo"**. Esto inicia un nuevo intento inmediatamente, sin otra confirmación. Las acciones aguas abajo pueden ejecutarse de nuevo, así que verifica primero los mensajes o cambios de tienda ya producidos por la ejecución fallida.
## Implementar y activar
Selecciona **Implementar** para abrir **Implementar flujo de trabajo**. Revisa el resumen de cambios, compatibilidad del contrato API, resultados de validación y registro de cambios opcional antes de continuar.
Opcionalmente, puedes vincular el flujo de trabajo implementado a un evento, una programación recurrente o una ejecución única. Solo se puede seleccionar uno de esos tipos de desencadenamiento a la vez. Una ejecución única necesita una fecha y hora futuras, introducidas en tu propia zona horaria.
- **Implementar flujo de trabajo** publica una versión con la configuración seleccionada.
- **Activar e implementar** aparece cuando una nueva vinculación de evento, programación o ejecución única haría que la automatización esté activa. Confirmarlo publica la versión y permite que futuros desencadenadores se ejecuten automáticamente con efectos reales.
Un error de guardado, conflicto sin resolver o problema de validación puede bloquear la implementación. Resuélvelo en lugar de seleccionar Implementar repetidamente.
El estado de producción muestra **No implementado**, **Borrador más reciente** o **En producción**, además del activador. Antes de la primera implementación, es el activador que elegiste (**Evento**, **Programación**, **Una vez** o **Manual**) o **Sin activador**. Después de una implementación, es **Manual** si no hay ningún activador vinculado; si no, el estado de la vinculación, como **Activo**, **Programado**, **Completado** o **Pausado**. Abrir una vinculación existente ofrece controles consecuentes:
- **Pausar** detiene los desencadenadores automáticos pero mantiene el flujo de trabajo y la vinculación.
- **Reanudar desencadenador** permite que la vinculación retenida se desencadene de nuevo.
- **Eliminar desencadenador** elimina permanentemente la vinculación pero no elimina el flujo de trabajo.
Cada acción abre una confirmación e puede incluir un motivo. Eliminar la marca de una vinculación existente durante la implementación pausa esa vinculación en lugar de eliminarla permanentemente.
## Historial de versiones y reversión
Selecciona **Historial de versiones** para abrir el panel **Historial de versiones**.
| Acción | Resultado |
| --- | --- |
| **Revisar reversión** | Abre **¿Quieres volver a esta versión?**. **Confirmar reversión** hace que la versión implementada seleccionada reemplace la versión implementada actual. Esto puede cambiar lo que hacen las ejecuciones futuras, pero no reemplaza el lienzo de borrador actual. |
| **Restaurar** en Historial de borradores | Reemplaza el lienzo actual con el borrador guardado seleccionado después de la confirmación. Los cambios del lienzo sin guardar o más recientes se pueden perder. |
Añade un motivo de reversión opcional para que otros miembros del espacio de trabajo entiendan el cambio. Revisa el lienzo restaurado y el estado de implementación antes de iniciar otra ejecución.
## Lista de verificación de operación segura
1. Confirma que estás en el proyecto y flujo de trabajo correcto.
2. Espera a **Guardado** antes de probar o implementar.
3. Completa y revisa cada entrada requerida.
4. Comienza con **Ejecutar simulación** cuando sea posible.
5. Usa Prueba en vivo o Ejecutar flujo de trabajo solo cuando sus efectos de servicio conectado sean aceptables.
6. Inspecciona **Ejecuciones** y salidas antes de implementar.
7. Trata **Activar e implementar**, reversión, restauración y eliminación como acciones consecuentes que requieren una revisión final.
## Solución de problemas
| Problema | Siguiente paso |
| --- | --- |
| No hay entrada **Flujo** visible | Esto es esperado en la navegación estándar. No adivines una URL; consulta [Disponibilidad de funciones](./feature-availability) o pregunta al soporte de Runner si tu espacio de trabajo tiene una entrada aprobada. |
| Los controles están bloqueados por una vista previa del plan | Sigue el mensaje del plan en pantalla o pregunta a un propietario del espacio de trabajo sobre el acceso. |
| La lista de plantillas falla | Selecciona **Reintentar** o crea un **Flujo de trabajo en blanco**. |
| El botón de ejecución no está disponible | Completa cada entrada requerida y corrige cualquier valor inválido. |
| Aparece conflicto de guardado | Decide si la versión guardada debe ganar antes de seleccionar **recargar**, porque las ediciones locales conflictivas se descartan. |
| La ejecución falla | Ábrela en **Ejecuciones**, mantén visible el error e entradas, y evita iniciar ejecuciones idénticas repetidamente. |
| La implementación está bloqueada | Resuelve los mensajes de guardado, conflicto, contrato o validación mostrados en el diálogo de implementación. |
## Verifica el resultado antes de la siguiente etapa
Después de guardar, vuelve a abrir el mismo flujo de trabajo y confirma que sus pasos e insumos estén presentes. Un flujo de trabajo guardado está listo para revisión, pero no necesariamente se ha ejecutado. Cuando tu espacio de trabajo exponga controles de prueba o implementación, inspecciona el estado de ejecución resultante y la salida antes de pasar a la implementación. Una ejecución fallida necesita que se corrija su entrada o paso fallido antes de otro intento.
## Guías relacionadas
- [Automatizaciones](../automate-test-and-create/automations)
- [Estados y detalles de tareas](../work-with-runner/task-states-and-details)
- [Solucionar problemas de tareas de Runner](../help-and-reference/troubleshoot-runner-tasks)
- [Disponibilidad de funciones](./feature-availability)
---
# Personalización del Agente
Source: https://www.runnerai.com/docs/es/guides/agent
Las capturas y grabaciones muestran la interfaz en inglés.
La página **Agente**, encabezada **Enseña a Runner cómo trabajas**, reúne Habilidades y Memoria en un solo lugar buscable. Úsala cuando quieras que Runner repita un método útil, recuerde un hecho estable o deje de usar una capacidad que ya no necesitas.
## Qué cubre esta guía
Sabrás cómo abrir Personalización del Agente, encontrar una capacidad existente y elegir si una Habilidad o Memoria es la herramienta correcta.
## Disponibilidad y requisitos previos
- Necesitas acceso a un proyecto de tienda.
- Las Habilidades pueden depender de tu plan actual. Si tu plan no incluye Habilidades, Runner muestra la ruta de actualización disponible en lugar de habilitar la acción.
- Memoria aparece solo cuando la función de Memoria unificada está habilitada para tu cuenta.
- Los enlaces antiguos de **Habilidades**, **Memoria** y **Personalizar** redirigen a esta página del Agente.
## Abre Personalización del Agente
Desde un proyecto, selecciona **Agente** en la barra lateral. Usa los filtros **Todo**, **Habilidades** y **Memoria** para acotar la página. **Recomendado para ti**, **Añadida** y **Descubrir** son secciones dentro de esa página, no pestañas de navegación separadas.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Usa los filtros de la página para enfocarte en Habilidades o Memoria. Las Habilidades activas existentes aparecen en **Añadida**; navegar una recomendación no la instala.
## Controles principales
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Buscar habilidades y memoria** | Encuentra una capacidad sin escanear cada sección. | Los filtros de la página coinciden con Habilidades y Memoria. El botón de borrar restaura la lista completa. |
| Pestaña en inglés **Todo** | Revisa todo lo disponible para la página del Agente. | Runner muestra el área de Habilidades y, cuando esté habilitada, Memoria. |
| Pestaña en inglés **Habilidades** | Enfócate en instrucciones y habilidades reutilizables. | Runner muestra Habilidades recomendadas, añadidas, pausadas y detectables. |
| Pestaña en inglés **Memoria** | Enfócate en hechos que Runner debe retener. | Runner muestra memorias agrupadas por alcance. Esta pestaña se oculta cuando Memoria no está disponible. |
| **Añadir** | Instala o reactiva una Habilidad. | La Habilidad se mueve a **Añadida** después de que Runner complete la acción. |
| **Añadida** | Ve que una Habilidad está activa. | Para Habilidades configurables, seleccionarla pausa esa Habilidad. |
| **Importar** | Trae una Habilidad compatible desde una URL. | Runner verifica la fuente, luego abre una importación editable o un selector de múltiples Habilidades. |
| **Crear habilidad** | Escribe una instrucción reutilizable personalizada. | Se abre el editor de Habilidades. Los campos obligatorios deben estar completos antes de poder guardarse. |
| **Añadir una memoria** | Guarda un hecho estable o preferencia. | Se abre el diálogo **Nueva memoria**. |
## Elige entre una Habilidad y Memoria
1. Usa una **Habilidad** cuando Runner deba seguir un proceso repetible, formato o conjunto de instrucciones.
2. Usa **Memoria** cuando Runner deba retener un hecho conciso, preferencia, corrección, convención o decisión.
3. Mantén los secretos fuera de ambos. Nunca almacenes contraseñas, claves API, detalles de pago o credenciales privadas.
4. Vuelve a la pestaña en inglés **Todo** y busca un término para confirmar que el nuevo elemento aparece.
## Estados y límites
- **Recomendado para ti** muestra un pequeño conjunto de Habilidades tendencia.
- **Añadida** contiene Habilidades activas; **En pausa** contiene Habilidades inactivas.
- **Descubrir** puede mostrar filas de carga, resultados de búsqueda o un mensaje sin resultados.
- Una Habilidad del sistema puede ser de solo lectura o fija. Una Habilidad personalizada puede ofrecer acciones de edición y eliminación.
- Un área de Memoria vacía ofrece **Añadir una memoria**. Una búsqueda sin coincidencia ofrece **Borrar búsqueda** sin eliminar nada.
- Los estados de carga, plan e indisponibilidad no significan que se haya añadido una capacidad.
## Solución de problemas
- Si falta la pestaña en inglés **Memoria**, la función no está habilitada para la cuenta actual. Continúa usando Habilidades o verifica de nuevo desde la navegación visible más tarde.
- Si **Añadir** abre una pantalla de actualización, compara planes antes de tomar una decisión de facturación.
- Si la búsqueda no encuentra nada, borra la consulta y verifica las pestañas en inglés **Todo**, **Habilidades** y **Memoria** por separado.
- Si un cambio falla, mantén el diálogo abierto, corrige el problema mostrado y reintenta. No asumas que un aviso o estado de carga significa que el cambio se completó.
## Guías relacionadas
- [Usa y pausa Habilidades](/es/guides/agent/skills)
- [Crear, importar y gestionar Habilidades](/es/guides/agent/create-import-manage-skills)
- [Añade y edita Memoria](/es/guides/agent/memory)
- [Usa la paleta de comandos del Agente](/es/guides/agent/command-palette)
---
# Paleta de comandos del Agente
Source: https://www.runnerai.com/docs/es/guides/agent/command-palette
Las capturas y grabaciones muestran la interfaz en inglés.
La paleta de comandos del Agente es un atajo orientado al teclado para las capacidades del Agente. Es útil cuando sabes qué necesitas y no quieres examinar la página completa del Agente.
## Qué cubre esta guía
Podrás abrir la paleta, buscar sus tres grupos de capacidades, usar el teclado y entender qué hace seleccionar cada resultado.
## Disponibilidad y requisitos previos
- Debes estar dentro de un proyecto.
- Las Habilidades siguen sujetas al acceso del plan y al estado configurable de cada Habilidad.
- Los resultados de Memoria aparecen solo cuando la Memoria unificada está habilitada.
- Esta paleta es diferente de la búsqueda de navegación del proyecto: **Command/Ctrl + K** busca destinos y conversaciones, mientras que **Command/Ctrl + Shift + K** abre capacidades del Agente.
## Ruta de acceso
En un proyecto donde la paleta está disponible, presiona **Command + Shift + K** en macOS o **Ctrl + Shift + K** en Windows y Linux. Verifica que el diálogo muestre los filtros **Habilidades** y **Memoria** antes de seleccionar un resultado. Si abre la búsqueda de navegación en su lugar, ciérralo y usa la barra lateral **Agente**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Si el atajo de teclado no abre la paleta de capacidades, usa esta página de **Agente** para encontrar las mismas Habilidades. Esta imagen muestra la página de respaldo, no la paleta de comandos.
## Controles
| Entrada o tecla | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Campo de búsqueda | Encuentra Habilidades por nombre, descripción, categoría o tipo, y Memorias por contenido, etiquetas, tipo o alcance. | Los resultados se actualizan bajo Añadidas, Descubrir y Memoria. |
| Pestaña en inglés **Todo** | Busca cada tipo de capacidad disponible. | Las Habilidades y, cuando esté disponible, Memoria aparecen juntas. |
| Pestaña en inglés **Habilidades** | Limita los resultados a Habilidades instaladas y detectables. | Las filas de Memoria se ocultan. |
| Pestaña en inglés **Memoria** | Limita los resultados a memorias guardadas. | Esta pestaña se oculta cuando Memoria no está disponible. |
| Flechas arriba/abajo | Muévete a través de los resultados sin un ratón. | La fila resaltada cambia. |
| Intro | Selecciona la fila resaltada. | El resultado realiza su acción específica del tipo. |
| Escape | Sal sin cambiar nada. | La paleta se cierra. |
## Qué hace la selección
| Tipo de resultado | Qué sucede cuando se selecciona |
| --- | --- |
| Habilidad configurable añadida | Runner alterna el estado activo de la Habilidad cuando tu plan lo permite. |
| Habilidad del sistema fija | La fila permanece sin cambios si esa Habilidad no se puede alternar. |
| Habilidad de descubrimiento | Runner comienza a añadir la Habilidad; la fila puede mostrar **Añadiendo…**. |
| Memoria | La paleta se cierra y abre **Agente → Memoria** con una búsqueda basada en esa memoria. |
| Habilidad sin acceso al plan | Runner abre **Agente → Habilidades**, donde la puerta del plan explica el siguiente paso disponible. |
## Usa la paleta
1. Presiona **Command/Ctrl + Shift + K**.
2. Escribe una palabra distintiva del nombre de la Habilidad, fuente o contenido de memoria.
3. Si es necesario, selecciona las pestañas en inglés **Habilidades** o **Memoria** para reducir la lista.
4. Usa las teclas de flecha para resaltar una fila.
5. Revisa el texto de acción a la derecha, como **Añadir** o **Abrir**.
6. Presiona Intro solo cuando esa sea la acción que deseas.
7. Confirma el resultado en la página del Agente o en el estado de paleta actualizado.
## Estados y límites
- **Nada que mostrar** significa que la pestaña actual y la consulta no devolvieron filas.
- **Añadiendo…** es un estado de progreso, no confirmación de que la instalación haya terminado.
- La paleta está optimizada para selección rápida; crear, editar, eliminar, alcance de Memoria y configuración detallada de Habilidades permanecen en la página completa del Agente.
- Seleccionar una Habilidad activa puede pausarla. Lee el estado de la fila antes de presionar Intro.
## Solución de problemas
- Si el atajo abre la búsqueda del proyecto o más de un diálogo, presiona Escape para cerrarlo y usa la barra lateral **Agente** para gestionar las mismas capacidades.
- Si Memoria está ausente, la cuenta actualmente no tiene la superficie de Memoria unificada.
- Si Intro abre la página del Agente en lugar de alternar una Habilidad, sigue la puerta del plan mostrada.
- Si no hay resultados, borra la búsqueda o selecciona la pestaña en inglés **Todo**.
- Si una Habilidad permanece sin cambios, puede ser una Habilidad del sistema fija.
## Guías relacionadas
- [Descripción general de personalización del Agente](/es/guides/agent)
- [Habilidades](./skills)
- [Memoria](./memory)
- [Planes de suscripción](../plans-and-billing/subscription-plans)
---
# Crear, importar y gestionar Habilidades
Source: https://www.runnerai.com/docs/es/guides/agent/create-import-manage-skills
Las capturas y grabaciones muestran la interfaz en inglés.
Las Habilidades personalizadas te permiten empaquetar tus propias instrucciones para uso repetido. La importación es útil cuando una Habilidad compatible ya existe y quieres revisarla antes de añadirla a Runner.
## Qué cubre esta guía
Sabrás cómo crear o importar una Habilidad, entenderás cada control del editor y distinguirás la pausa reversible de la eliminación permanente.
## Disponibilidad y requisitos previos
- Abre un proyecto con acceso a **Agente → Habilidades**.
- Las Habilidades requieren acceso al plan.
- La importación requiere una URL de fuente compatible que Runner pueda leer.
- No importes instrucciones en las que no confíes. Revisa el nombre, descripción, contenido, configuración y archivos incluidos antes de guardar.
## Rutas de entrada
- Crear: Barra lateral **Agente** → filtro **Habilidades** → **Crear habilidad** en la sección **Descubrir**.
- Importar: Barra lateral **Agente** → filtro **Habilidades** → **Importar** en **Descubrir**.
- Editar o eliminar: Barra lateral **Agente** → filtro **Habilidades** → una fila en **Añadida** → **Más acciones**.
## Controles del editor de Habilidades
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Nombre** | Da a la Habilidad su identidad en listas y comandos. | Runner valida que un nombre esté presente antes de guardar. |
| **Descripción** | Explica cuándo se debe usar la Habilidad. | La descripción aparece en listas de Habilidades y selectores. |
| **Contenido** | Almacena las instrucciones reutilizables. | Escribe en **Editar** y usa **Vista previa** para verificar las instrucciones formateadas. |
| **Configuración avanzada** | Revela configuraciones opcionales de invocación y organización. | Expándelo solo cuando necesites cambiar esas configuraciones. |
| **Cambiar a Markdown** / **Cambiar a formulario** | Cambia cómo editas la Habilidad. | Abre el editor de Markdown o basado en campos; cambiar de vista no guarda la Habilidad. |
| **Categoría** | Agrupa Habilidades relacionadas. | Esta etiqueta opcional afecta cómo se organizan las Habilidades. |
| **Etiqueta de atajo** | Da a la Habilidad una etiqueta de comando más clara. | La etiqueta opcional aparece con controles orientados a comandos. |
| **Habilitado** | Elige si la nueva Habilidad o la editada comienza activa. | Comienza activada para una nueva Habilidad. Desactívala antes de crear la Habilidad si debe comenzar en pausa. |
| **Desactivar invocación automática de IA** | Evita que Runner elija la Habilidad automáticamente. | La Habilidad permanece disponible para uso manual. |
| **Invocable por usuario** | Permite el uso manual de comando de barra. | Desactivarla elimina la invocación manual mientras mantiene otro uso permitido. |
| **Sugerencia de argumento** | Muestra la entrada esperada después de un comando. | La sugerencia puede mostrar ejemplos como una URL o número de problema. |
| Área de archivos | Añade texto de apoyo o activos necesarios por la Habilidad. | Runner valida límites de archivo individual y total antes de guardar. |
| **Cancelar** | Sal sin aplicar la edición actual. | El diálogo se cierra; los cambios sin guardar se descartan. |
| **Crear** / **Guardar** | Persiste una Habilidad válida. | Runner cierra el editor después del éxito y actualiza la lista de Habilidades. |
## Crea una Habilidad personalizada
1. Abre la barra lateral **Agente** y selecciona el filtro **Habilidades**.
2. En **Descubrir**, selecciona **Crear habilidad**.
3. Ingresa un **Nombre** en minúsculas y con guiones, como `homepage-copy-review`, una **Descripción** concisa y el **Contenido** de la Habilidad. Estos campos son obligatorios.
4. Selecciona **Vista previa** en Contenido para verificar las instrucciones. Expande **Configuración avanzada** para configuraciones opcionales solo cuando las necesites.
5. Revisa **Habilitado** y cualquier configuración avanzada de invocación que hayas cambiado. Estos controles determinan cómo Runner puede usar la Habilidad.
6. Selecciona **Crear**.
7. Confirma que la Habilidad aparece bajo **Añadida** o **En pausa**, dependiendo de la configuración Habilitada.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4coukNWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este ejemplo muestra instrucciones en vista previa antes de **Crear**. El borrador no ha sido guardado.
### Observa: revisa un borrador de Habilidad
La grabación cambia el ejemplo entre Markdown y vista previa de formulario, luego cancela. Para mantener tu propia Habilidad, selecciona **Crear** y confirma que aparece en la lista.
## Importa una Habilidad
1. Abre **Agente**, selecciona el filtro **Habilidades** y encuentra **Importar** en **Descubrir**.
2. Pega la URL de fuente compatible.
3. Selecciona **Importar**.
4. Para una Habilidad descubierta, Runner abre el editor con campos importados rellenados. Para una fuente que contiene varias Habilidades, Runner abre un selector.
5. Revisa cada campo importado y cualquier advertencia de archivo excluido o tamaño.
6. Realiza los cambios necesarios, luego selecciona **Crear**.
7. Confirma que la Habilidad aparece en la página del Agente antes de cerrar tu flujo de trabajo.
La importación no hace que el contenido sin revisar sea confiable. Trata las instrucciones importadas como cualquier otro contenido que pueda influir en el trabajo de Runner.
## Edita, pausa o elimina
1. Selecciona una fila de Habilidad personalizada o abre **Más acciones → Editar**.
2. Cambia los campos que necesites y selecciona **Guardar**. Vuelve a abrir la Habilidad para confirmar las instrucciones actualizadas.
3. Para dejar de usarla sin perderla, selecciona **Añadida** para moverla a **En pausa**.
4. Para eliminarla, abre **Más acciones → Eliminar**.
5. Revisa el diálogo de confirmación nombrado y selecciona **Eliminar** solo cuando tengas la intención de eliminar la Habilidad.
**Eliminar es destructivo.** No es lo mismo que pausar, y la página no lo presenta como una acción deshacible. Las Habilidades del sistema no ofrecen eliminación.
## Estados y límites
- Falta de Nombre, Descripción o Contenido bloquea el guardado y muestra un mensaje de validación.
- Un nombre de Habilidad importada duplicado puede ser rechazado o marcado como ya presente.
- Los archivos que exceden los límites aceptados pueden omitirse; una advertencia de tamaño total puede bloquear el guardado hasta que se reduzca el contenido.
- Mientras se ejecuta guardado, importación o eliminación, espera el mensaje de éxito o error antes de tomar otra acción.
- Las Habilidades del sistema de solo lectura pueden mostrar detalles pero no exponen controles de edición de Habilidades personalizadas.
## Solución de problemas
- Si **Importar** permanece no disponible, espera a que se complete la verificación de Habilidad existente y confirma que el campo URL no esté vacío.
- Si la importación abre un selector por lotes, selecciona solo las Habilidades que reconoces y necesitas.
- Si el guardado está bloqueado, verifica los campos obligatorios y cualquier advertencia de archivo en la parte superior del editor.
- Si una Habilidad desapareció después de seleccionar **Añadida**, verifica **En pausa** antes de recrearla.
- Si la eliminación falla, la Habilidad permanece; cierra el error y reintenta después de verificar tus permisos.
## Guías relacionadas
- [Habilidades](./skills)
- [Descripción general de personalización del Agente](/es/guides/agent)
- [Usa la paleta de comandos del Agente](./command-palette)
- [Almacena configuración del Agente](../account-and-settings/custom-scripts-and-store-agent)
---
# Memoria
Source: https://www.runnerai.com/docs/es/guides/agent/memory
Las capturas y grabaciones muestran la interfaz en inglés.
La Memoria es para hechos concisos que Runner debe retener, como una preferencia de escritura, una regla de negocio corregida o una decisión aprobada. Reduce la explicación repetida en todas las tareas.
## Qué cubre esta guía
Podrás agregar, encontrar, editar y eliminar de forma segura una memoria.
## Disponibilidad y requisitos previos
- Necesitas un proyecto de tienda.
- La pestaña **Memoria** aparece solo cuando la Memoria unificada está habilitada para tu cuenta.
- La Memoria es independiente de la puerta del plan de Habilidades.
- Nunca guardes contraseñas, claves API, detalles de pago, credenciales privadas u otros secretos en Memoria.
## Ruta de acceso
Selecciona **Agente** en la barra lateral, luego el filtro **Memoria**.
## Controles de memoria
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Agregar una memoria** | Guarda un nuevo hecho para Runner. | Se abre el diálogo **Nueva memoria**. |
| **Contenido** | Indica el hecho que Runner debe retener. | Este texto se convierte en la memoria visible. |
| **Alcance** | Elige dónde debe aplicarse el hecho. | Selecciona **Esta tienda**, **Personal** u **Organización**. |
| **Tipo** | Explica qué tipo de hecho es. | Selecciona Preferencia, Corrección, Convención, Conocimiento o Decisión. |
| **Etiquetas** | Facilita encontrar y agrupar la memoria. | Ingresa una o más etiquetas separadas por comas. Se requiere al menos una etiqueta para guardar. |
| **Importancia** | Indica a Runner con qué intensidad debe considerar el hecho. | Selecciona Baja, Media o Alta. |
| **Agregar memoria** | Guarda una nueva memoria válida. | El diálogo se cierra después del éxito y la memoria aparece en su grupo de alcance. |
| Icono de edición | Corrige o refina una memoria. | **Editar memoria** se abre con los valores actuales. |
| **Guardar** | Aplica una edición. | La fila se actualiza después del éxito de la actualización. |
| Icono de eliminación o **Eliminar** | Elimina una memoria. | Runner abre un diálogo de confirmación destructiva. |
## Agregar una memoria
1. Abre la barra lateral **Agente**, luego selecciona el filtro **Memoria**.
2. Selecciona **Agregar una memoria**.
3. Escribe un hecho claro en **Contenido**, como “Usar mayúsculas y minúsculas para los encabezados en esta tienda.”
4. Elige el **Alcance** más específico correcto.
5. Elige el **Tipo** más cercano.
6. Añade **Etiquetas** útiles separadas por comas, como `copy, headings`.
7. Establece **Importancia**. Usa Alta con moderación para hechos que Runner debe priorizar cuando la información compite.
8. Selecciona **Agregar memoria**.
9. Confirma que la nueva fila aparezca bajo el alcance previsto.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El ejemplo es una preferencia no guardada. Elige el alcance más estrecho antes de seleccionar **Añadir memoria**.
### Observa: elige un alcance de memoria
La grabación inspecciona las opciones de alcance para una preferencia de ejemplo, luego cancela. No guarda una memoria. Sigue los pasos anteriores y verifica la nueva fila para confirmar tu propio guardado.
## Editar o eliminar una memoria
1. Encuentra la memoria navegando su grupo de alcance o usando búsqueda.
2. Selecciona el icono de edición, actualiza los campos y selecciona **Guardar**. Vuelve a abrir la fila para verificar el nuevo contenido y alcance.
3. Para eliminarlo, selecciona el icono de eliminación o **Eliminar** dentro del diálogo de edición.
4. Revisa **Eliminar memoria** y selecciona **Eliminar** para confirmar.
Eliminar una memoria no se puede deshacer desde este diálogo. Cancelar cierra la confirmación sin eliminarla.
## Estados y límites
- Una cuenta nueva puede mostrar **Sin memorias aún** con una acción **Agregar una memoria**.
- Una búsqueda sin coincidencia dice cuántas memorias están ocultas y ofrece **Borrar búsqueda**.
- El Contenido y al menos una etiqueta son obligatorios antes de que el botón guardar esté disponible.
- Las memorias se agrupan por alcance y muestran su tipo, alcance, recuento de uso y hora de uso reciente.
- La Memoria pone un hecho disponible para Runner; no es una garantía de que el hecho anule cada instrucción o límite de seguridad.
## Solución de problemas
- Si la pestaña **Memoria** está ausente, usa la navegación visible en lugar de un enlace directo antiguo. La función no está habilitada para la cuenta actual.
- Si **Agregar memoria** está deshabilitado, agrega Contenido y al menos una etiqueta separada por comas.
- Si la lista parece vacía después de la búsqueda, selecciona **Borrar búsqueda**.
- Si una edición falla, la memoria anterior permanece. Corrige el problema mostrado e intenta de nuevo.
- Si una memoria se está aplicando demasiado ampliamente, edítala y elige un alcance más específico.
## Guías relacionadas
- [Tipos y alcances de memoria](./memory-types-and-scopes)
- [Descripción general de Personalización del Agente](/es/guides/agent)
- [Usa la paleta de comandos del Agente](./command-palette)
- [Seguridad de claves API](../account-and-settings/api-keys)
---
# Tipos y alcances de memoria
Source: https://www.runnerai.com/docs/es/guides/agent/memory-types-and-scopes
Las capturas y grabaciones muestran la interfaz en inglés.
El alcance evita que un hecho llegue al trabajo incorrecto, mientras que el Tipo e Importancia ayudan a Runner a interpretarlo. Usa esta página cuando una memoria debe aplicarse a más de una tarea pero no necesariamente a cada tienda o persona.
**Ruta de entrada:** **barra lateral → Agente → Memoria → Añadir una memoria**, o abre una memoria existente para editarla.
## Qué cubre esta guía
Podrás elegir el alcance más específico correcto, clasificar una memoria y usar etiquetas e importancia sin almacenar datos sensibles.
## Disponibilidad y requisitos previos
- La Memoria Unificada debe estar habilitada para la cuenta.
- Abre **barra lateral → Agente → Memoria → Añadir una memoria**, o edita una memoria existente.
- No uses ningún alcance para contraseñas, claves API, datos de tarjetas, códigos de autenticación u otros secretos.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Usa **Alcance** para donde se aplica el hecho y **Tipo** para lo que representa. Este es un ejemplo no guardado; [Añadir y editar Memoria](/es/guides/agent/memory) incluye la guía completa y la grabación.
## Opciones de alcance
| Alcance | Úsalo cuando | Qué sucede después |
| --- | --- | --- |
| **Esta tienda** | El hecho es específico de la tienda actual, catálogo, marca o flujo de trabajo. | Runner agrupa la memoria bajo el alcance de tienda y puede aplicarla al trabajo de esta tienda. Una memoria nueva usa de forma predeterminada este alcance, el tipo **Preferencia** y la importancia **Media**. |
| **Personal** | El hecho describe tu propia preferencia de trabajo. | Runner lo agrupa como Personal en lugar de compartirlo como una regla en todo el espacio de trabajo. |
| **Organización** | El hecho es una regla o convención aprobada compartida en el espacio de trabajo. | Runner lo agrupa bajo Organización para que pueda informar trabajo más allá de una tienda. |
Elige el alcance más específico que siga siendo útil. Por ejemplo, una regla de envío específica de una tienda no debe ser una memoria de Organización a menos que realmente se aplique en todas partes.
## Opciones de tipo
| Tipo | Buen uso | Ejemplo |
| --- | --- | --- |
| **Preferencia** | Un estilo deseado o una opción de trabajo | "Usa descripciones de productos concisas y editoriales." |
| **Corrección** | Un hecho que Runner obtuvo incorrectamente antes | "La ventana de devoluciones se indica en el documento de política aprobada." |
| **Convención** | Una regla de nomenclatura o formato repetible | "Usa mayúsculas de oración para los títulos de colecciones." |
| **Conocimiento** | Un hecho estable de negocio o producto | "La colección insignia se llama Studio Essentials." |
| **Decisión** | Una opción aprobada que el trabajo futuro debe respetar | "Mantén el pago como invitado habilitado." |
No incluyas un secreto en un ejemplo o memoria. En su lugar, refiere a la ubicación de una credencial protegida en lugar de almacenar su valor.
## Importancia y etiquetas
| Control | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Baja** | Mantén disponible un hecho útil pero opcional. | Runner le da menos peso cuando la información compite. |
| **Media** | Usa la prioridad normal para hechos de trabajo estables. | Runner le da el peso medio predeterminado. |
| **Alta** | Marca una regla o decisión aprobada importante. | Runner le da más peso al elegir entre memorias relevantes. |
| **Etiquetas** | Facilita la búsqueda y agrupación. | Las etiquetas separadas por comas se guardan con la memoria; se requiere al menos una. |
La importancia es una sugerencia de prioridad, no una instrucción para ignorar la solicitud actual, los permisos de cuenta o las restricciones de seguridad.
## Clasificar una memoria
1. Escribe el hecho como una oración clara.
2. Pregunta dónde debe aplicarse: solo esta tienda, solo para ti, o en toda la organización.
3. Selecciona el Tipo más cercano según por qué existe el hecho.
4. Agrega un pequeño conjunto de etiquetas específicas.
5. Comienza con importancia Media a menos que haya una razón clara para elegir Baja o Alta.
6. Guarda y confirma que la fila aparezca bajo el encabezado de alcance esperado.
## Estados y límites
- La lista muestra el Tipo, Alcance, cuántas veces se usó la memoria y una hora de uso reciente relativa.
- Editar Alcance mueve la memoria a un grupo diferente después de que la guardada tenga éxito.
- La selección de memoria depende de la relevancia y prioridad; una memoria Alta no está garantizada que aparezca en cada respuesta.
## Solución de problemas
- Si una memoria influye en la tienda incorrecta, cambia su Alcance a **Esta tienda** en el proyecto correcto.
- Si dos memorias entran en conflicto, edita o elimina la desactualizada en lugar de elevar ambas a Alta.
- Si la búsqueda pierde una memoria, intenta palabras de su Contenido o Etiquetas, luego borra el filtro.
- Si una convención compartida no es visible para los colaboradores, confirma que se guardó como **Organización**, no Personal.
## Guías relacionadas
- [Agregar y editar Memoria](./memory)
- [Descripción general de Personalización del Agente](/es/guides/agent)
- [Seguridad y sesiones](../account-and-settings/security-and-sessions)
---
# Habilidades
Source: https://www.runnerai.com/docs/es/guides/agent/skills
Las capturas y grabaciones muestran la interfaz en inglés.
Las Habilidades le dan a Runner un conjunto repetible de instrucciones para un tipo de trabajo. Son útiles cuando quieres que un proceso confiable esté disponible en futuras conversaciones en lugar de reescribir el mismo mensaje cada vez.
## Qué cubre esta guía
Podrás agregar una Habilidad, determinar si está activa, pausarla y entender qué acciones están disponibles para Habilidades del Sistema y Personalizadas.
## Disponibilidad y requisitos previos
- Abre un proyecto de tienda donde tengas permiso para administrar capacidades del Agente.
- El uso de Habilidades está limitado por plan. Runner muestra una ruta de actualización cuando el plan actual no lo incluye.
- Algunas Habilidades del Sistema no se pueden pausar, editar o eliminar.
## Ruta de acceso
Selecciona **Agente** en la barra lateral, luego el filtro **Habilidades**. Desplázate a **Recomendado para ti**, **Añadida** o **Descubrir** dentro de la misma página.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Lee la fuente de la Habilidad y el estado actual antes de seleccionar **Añadir** o **Añadida**. La captura de pantalla muestra Habilidades existentes, no el resultado de instalar una nueva.
## Secciones de habilidades y controles
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Recomendado para ti** | Revisa rápidamente un pequeño conjunto de Habilidades populares. | Seleccionar **Añadir** inicia la instalación. |
| **Añadida** | Ve qué Habilidades están activas. | Cada fila muestra el nombre de la Habilidad, descripción, tipo y acciones disponibles. |
| **En pausa** | Encuentra Habilidades que están actualmente desactivadas. | Seleccionar **Añadir** reactiva una Habilidad configurable. |
| **Descubrir** | Explora o busca Habilidades adicionales. | Un nombre de Habilidad puede abrir su fuente en una pestaña nueva; **Añadir** la instala en tu espacio de trabajo. |
| Fila de Habilidad | Lee los detalles de la Habilidad. | Una Habilidad Personalizada se abre en modo de edición. Una Habilidad del Sistema se abre en modo de visualización. |
| Botón **Añadida** | Pausa una Habilidad configurable activa. | La Habilidad se mueve a **En pausa** después de que la actualización tenga éxito. |
| Botón **Añadir** | Instala o reactiva una Habilidad. | El botón muestra progreso, luego la Habilidad aparece bajo **Añadida**. |
| Más acciones | Encuentra acciones de edición, visualización o eliminación. | Las acciones disponibles dependen de si la Habilidad es del Sistema o Personalizada. |
## Agregar una Habilidad descubierta
1. Selecciona **Agente** en la barra lateral, luego el filtro **Habilidades**. Desplázate a **Recomendado para ti**, **Añadida** o **Descubrir** dentro de la misma página.
2. Busca la tarea o formato que necesitas.
3. Revisa el nombre de la Habilidad, fuente y descripción.
4. Selecciona **Añadir**.
5. Espera a que el estado de progreso termine.
6. Confirma que la Habilidad aparezca bajo **Añadida** antes de confiar en ella en el chat.
## Pausar o reactivar una Habilidad
1. Encuentra la Habilidad bajo **Añadida**.
2. Selecciona su botón **Añadida**.
3. Confirma que se mueve a **En pausa**.
4. Para reactivarla, selecciona **Añadir** en la sección Pausadas.
Pausar es reversible. Detiene que la Habilidad esté activa sin eliminar su definición.
## Habilidades del Sistema y Personalizadas
| Tipo de Habilidad | Acciones típicas | Límite importante |
| --- | --- | --- |
| **Sistema** | Ver detalles; pausar solo cuando la Habilidad lo permite | Las Habilidades del Sistema fijas no ofrecen eliminación y pueden no ofrecer pausa. |
| **Personalizado** | Editar, pausar, reactivar o eliminar | Eliminar requiere confirmación y elimina la Habilidad en lugar de simplemente pausarla. |
## Estados y límites
- **Agregando...** significa que la instalación aún se está ejecutando. Espera a **Añadida**.
- Los resultados de búsqueda pueden provenir del directorio público de Habilidades así como de Habilidades ya en tu espacio de trabajo.
- Una puerta de plan bloquea la activación; no elimina definiciones de Habilidades existentes.
- El contenido importado puede omitir archivos que excedan los límites aceptados. Revisa cualquier advertencia antes de guardar.
- **Sin resultados de skills.sh para esta búsqueda** significa que no se devolvió ningún resultado de descubrimiento compatible; no afecta las Habilidades agregadas.
## Solución de problemas
- Si **Añadir** no se completa, intenta una vez más después de verificar el error mostrado. Evita hacer clic repetidamente mientras el botón está ocupado.
- Si una Habilidad no se puede pausar, probablemente sea una Habilidad del Sistema fija. Abre sus detalles para confirmar.
- Si la Habilidad esperada está ausente, borra la búsqueda y verifica tanto **Añadida** como **En pausa**.
- Si una Habilidad recién agregada no está disponible en un proyecto, verifica **Configuración → Tienda → Agente** para la selección de Habilidades de ese proyecto.
## Guías relacionadas
- [Crear, importar y administrar Habilidades](./create-import-manage-skills)
- [Descripción general de Personalización del Agente](/es/guides/agent)
- [Usa la paleta de comandos del Agente](./command-palette)
- [Configuración del Agente de Tienda](../account-and-settings/custom-scripts-and-store-agent)
---
# Analytics y SEO
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo
Comienza en **Medir** → **Análisis** para el comportamiento registrado de la tienda, o **Crecer** → **SEO** para la vista general de **SEO & GEO**. Elige una guía a continuación para la pregunta que necesitas responder.
> **Disponibilidad:** **Análisis** depende de tu plan y datos de tienda registrados. **SEO** requiere un plan de pago: **Plus** o superior, o AppSumo License Tier 2, 3 o 4. También puede depender de una tienda pública, acceso del proveedor y suficientes datos públicos para analizar.
| Objetivo | Comienza aquí |
| --- | --- |
| Comprende la página de rendimiento completa | [Descripción general de Analytics](/es/guides/analytics-and-seo/analytics-overview) |
| Cambia la ventana de informes | [Métricas y filtros](/es/guides/analytics-and-seo/metrics-filters) |
| Encuentra fricción de embudo o carrito | [Tráfico y conversión](/es/guides/analytics-and-seo/traffic-and-conversion) |
| Inicia una revisión de visibilidad de tienda | [Descripción general de SEO](/es/guides/analytics-and-seo/seo-overview) |
| Lee estimaciones de búsqueda orgánica | [Rendimiento de búsqueda](/es/guides/analytics-and-seo/search-performance) |
| Inspecciona enlaces y problemas técnicos | [Enlaces de retroceso y auditoría del sitio](/es/guides/analytics-and-seo/backlinks-and-site-audit) |
| Comprende la visibilidad en respuestas de IA | [Visibilidad de IA](/es/guides/analytics-and-seo/ai-visibility) |
| Prueba mensajes e inspecciona fuentes | [Mensajes, palabras clave y citaciones](/es/guides/analytics-and-seo/prompts-keywords-citations) |
| Recuperarse de páginas vacías o bloqueadas | [Solucionar problemas de datos y publicación](/es/guides/analytics-and-seo/troubleshoot-data-and-publication) |
Estas vistas informan o analizan datos disponibles. Abrir un informe no cambia la tienda, y una pantalla de configuración no es prueba de que el tráfico, clasificaciones o menciones de IA mejoraron.
---
# Visibilidad de IA
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/ai-visibility
Las capturas y grabaciones muestran la interfaz en inglés.
La visibilidad de IA te ayuda a inspeccionar si los datos de búsqueda de IA disponibles mencionan tu marca, competidores o fuentes públicas.
> **Condicional:** La visibilidad de IA puede depender del acceso al espacio de trabajo, plan, disponibilidad del proveedor, una tienda pública y datos suficientes. Completar la configuración no crea menciones ni mejora la visibilidad por sí solo.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **SEO** → **Visibilidad en IA** → **Abrir**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una nueva tienda debe completar el requisito previo de publicación de SEO antes de usar informes. La vista previa de datos de muestra es ilustrativa; no se muestra ningún resultado de análisis aquí.
## Antes de empezar
Si SEO muestra la lista de verificación de configuración de la primera tienda, completa su requisito de publicación antes de esperar datos de informes. Los valores etiquetados **Vista previa · datos de ejemplo** son ejemplos, no los resultados de tu tienda. Los pasos a continuación son condicionales a que el informe correspondiente esté disponible.
- Publica la tienda y completa el paso principal de elegibilidad de SEO.
- Verifica que Runner detecte el dominio de tienda pública que tienes la intención de rastrear; la configuración no proporciona un campo de marca editable separado.
- Agrega solo competidores relevantes para que las comparaciones de participación de voz sigan siendo útiles.
- Conecta Google Search Console solo si la entrada opcional está disponible y deseas autorizarla.
## Controles y resultados de clics
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Tienda detectada | Muestra la tienda pública que la configuración usará como su objetivo inicial. |
| Campos de competidor en configuración | Agrega marcas de comparación a las opciones de configuración; ingresar un nombre no ejecuta una búsqueda. |
| Vista previa del mensaje inicial | Muestra ideas de mensaje de ejemplo para la configuración. Previsualizarlas no ejecuta ni guarda resultados de mensaje. |
| Google Search Console → **Conectar** | Abre **Apps** para la conexión opcional de Google Search Console. |
| **Continuar** | Avanza al siguiente paso de configuración cuando la entrada actual es válida. |
| **Omitir por ahora** | Cierra la configuración sin iniciar la Búsqueda de Marca ni crear una instantánea. |
| **Ejecutar Brand Lookup** | Abre la configuración de tres pasos de Visibilidad en IA para la tienda detectada. |
| **Finalizar configuración** | Envía la tienda detectada y las opciones de competidor, cierra la configuración e inicia la Búsqueda de Marca. Los resultados permanecen pendientes hasta que se complete la búsqueda. |
| **Pedir a Runner que lo corrija** | Abre una nueva conversación de Runner con la evidencia de visibilidad de IA guardada y su mejora recomendada. No edita ni publica la tienda por sí solo. |
| **Ver brechas de citación** | Abre una conversación de Runner basada en evidencia enfocada en oportunidades de citación faltantes; revisa sus sugerencias antes de hacer cambios. |
## Completar la configuración
1. Abre **Crecer** → **SEO**, luego abre la tarjeta de **Visibilidad en IA**.
2. Selecciona **Ejecutar Brand Lookup** para abrir la configuración.
3. Confirma que la tienda pública detectada es la tienda que tienes la intención de revisar.
4. Agrega un pequeño conjunto de competidores relevantes, luego selecciona **Continuar**.
5. Revisa la vista previa del mensaje inicial sin tratarlo como una prueba completada, luego continúa.
6. Conecta Search Console solo si la opción es útil y estás autorizado a conectar la cuenta.
7. Selecciona **Finalizar configuración** para enviar e iniciar la Búsqueda de Marca.
8. Espera a un estado completado; no inicies una búsqueda duplicada mientras esté pendiente.
9. Lee menciones, volumen de búsqueda de IA estimado, participación de voz, consultas y fuentes citadas juntas.
## Leer el panel
- **Menciones** cuenta respuestas disponibles o registros que hacen referencia a la marca rastreada.
- **Cuota de visibilidad** compara marcas rastreadas dentro del conjunto de datos disponible; no es todo internet.
- **Consultas** muestran preguntas asociadas con los resultados recopilados.
- **Fuentes citadas** muestran páginas referenciadas en respuestas disponibles y pueden incluir sitios que no controlas.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Pendiente | La búsqueda fue aceptada pero no está terminada. Espera antes de iniciarla de nuevo. |
| Completado sin menciones | El resultado no contiene menciones de la marca. Revisa las consultas y fuentes en lugar de asumir que la configuración falló. |
| Falló | Abre el error visible, confirma el objetivo público y vuelve a intentar más tarde. |
| Proveedor no disponible o acceso faltante | El modelo o fuente de datos solicitado no se puede usar ahora. Usa secciones completadas e intenta de nuevo más tarde. |
| Datos insuficientes | El proveedor no pudo producir una vista confiable para el objetivo. Mantén el sitio público y vuelve a visitarlo después de que tenga más contenido descubrible. |
## Verifica antes de iniciar la búsqueda
Abrir la configuración te permite revisar la tienda detectada y los competidores. **Finalizar configuración** inicia la búsqueda y puede usar capacidad de pago. Para revisar el formulario sin ejecutar, usa **Omitir por ahora**. Después de una búsqueda completada, confirma el objetivo y la evidencia devuelta antes de interpretar el panel de control.
## Guías relacionadas
- [Mensajes, palabras clave y citaciones](./prompts-keywords-citations)
- [Descripción general de SEO](./seo-overview)
- [Rendimiento de búsqueda](./search-performance)
---
# Descripción general de Analytics
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/analytics-overview
Las capturas y grabaciones muestran la interfaz en inglés.
Analytics te ayuda a conectar visitas registradas, actividad de compras y ventas para la tienda seleccionada.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Análisis**.
## Antes de empezar
- Tu plan debe incluir la superficie de informes. Una vista previa del plan no muestra los resultados medidos de tu tienda.
- Se necesita una tienda publicada y actividad de compradores registrada para informes significativos de tráfico y ventas.
- Selecciona la misma tienda, período y filtros al comparar informes.
## Elige el diseño que ves
Si tu pantalla muestra **Ventas Netas**, **GMV**, **Sesiones** y **Tasa de Conversión** sobre una sola página de desplazamiento, sigue [las instrucciones del tablero anterior](#if-you-see-the-earlier-dashboard) a continuación. Si muestra navegación de informes agrupados, usa las instrucciones del banco de trabajo que siguen. Si sobre el gráfico aparecen **Informe de esta semana** y **Más informes**, sigue [las instrucciones de ese diseño](#if-you-see-the-sections-layout). Los diseños tienen controles diferentes.
## Elige un informe
**Condicional:** Si tu pantalla muestra **Analíticas de la tienda**, usa el banco de trabajo agrupado a continuación. Algunos espacios de trabajo aún muestran el tablero de una sola página descrito más adelante.
| Control | Qué abre |
| --- | --- |
| **Resumen** | Un resumen de la actividad de la tienda seleccionada. Usa un enlace disponible de **Ver detalles** para inspeccionar el informe subyacente. |
| **Comercio** | Informes de comercio, embudo, producto, adquisición y objetivos. |
| **Comportamiento** | Informes de página, evento, recorrido y otros informes de navegación compatibles. |
| **Audiencia** | Informes de visitantes, usuarios, segmentos y características. |
| **Página en vivo** | La vista de actividad en vivo disponible. |
| **Configurar** | Herramientas de configuración de seguimiento y otras analíticas. Abrirlo no crea eventos. |
| Selector de fecha | Actualiza el informe seleccionado para el período elegido. |
| **Comparar**, cuando se muestra | Agrega el período de comparación compatible. |
## Revisa tu primer informe
1. Abre **Resumen** y confirma la tienda seleccionada.
2. Elige un período que contenga actividad conocida de la tienda, como **7 días** o **30 días**.
3. Lee el resumen visible, luego abre **Comercio** para inspeccionar los datos de ventas y embudo.
4. Abre el subinforme relevante para la pregunta que necesitas responder. Por ejemplo, compara las etapas del embudo antes de inspeccionar un problema sospechado en el pago.
5. Abre **Comportamiento** para inspeccionar una página o recorrido afectado cuando esos informes tengan datos.
6. Regresa a **Resumen** para comparar el detalle con el resumen.
**Punto de control:** Puedes identificar el informe, el período activo y los eventos detrás de un resultado. Un informe vacío no confirma ni la colección de eventos en funcionamiento ni una tienda rota.
## Si ves Más informes [#if-you-see-the-sections-layout]
El resumen muestra **Visitantes**, **Ingresos**, **Pedidos**, **Visitantes que compraron**, **Ingresos por visitante** y **En línea ahora**, y debajo el gráfico de tendencia y listas de canales, productos y lugares. El rango de fechas, **Diario** / **Semanal** y **Filtrar** están encima.
Selecciona **Más informes** para abrir **Todos los informes**, que agrupa cada informe:
| Grupo | Informes |
| --- | --- |
| **Ventas** | **Ingresos**, **Productos**, **Embudos**, **Canales** y **Objetivos**. |
| **Clientes** | **Visitantes**, **Personas**, **Segmentos**, **En vivo** y **Mapa** cuando está disponible. |
| **Salud de la tienda** | **Páginas**, **Eventos**, **Velocidad y errores**, **Sesiones**, **Grabaciones** y **Estado del seguimiento**. |
| **Configuración** | **Seguimiento**, **Indicadores de funciones**, **Paneles personalizados**, **API**, **Uso** y **Ajustes**. Abrirlos no crea eventos. |
Busca en la lista por nombre de informe, como **Embudos** o **Mapa**. Dentro de un informe, las pestañas cambian a los otros informes de su grupo y la flecha atrás vuelve al resumen.
1. Revisa el rango de fechas sobre el gráfico.
2. Lee juntas las cifras de arriba. Una tasa de compra dice poco sin el número de visitantes al lado.
3. Selecciona **Informe de esta semana** para la última semana completa: ingresos por dispositivo, visitas y días antes de comprar, las horas en que se compra y los países principales.
4. Selecciona **Más informes** y abre el informe de tu pregunta, como **Canales** para ver de dónde llegaron los compradores.
Una tienda nueva muestra **Tienda nueva** y un recuento de visitas hasta que haya suficientes personas para dibujar gráficos. La etiqueta **Datos de ejemplo · no es tu tienda** indica que las cifras son un ejemplo, no tus resultados. Un panel con **Próximamente** aún no tiene fuente de datos; no es un problema de tu tienda.
## Si ves el tablero anterior [#if-you-see-the-earlier-dashboard]
Usa su selector de rango de tiempo, luego lee **Ventas Netas**, **GMV**, **Sesiones** y **Tasa de Conversión** juntos. Desplázate a las secciones de producto, fuente, embudo, abandono y reembolso.
## Solución de problemas
| Estado | Siguiente paso |
| --- | --- |
| Guion, cero o gráfico vacío | Borra los filtros opcionales, intenta un período más largo y confirma que existan visitas u órdenes reales. |
| Aviso de actualización o vista previa del plan | Revisa el acceso en Plan & Billing antes de diagnosticar la colección. |
| El informe se está cargando | Espera a que su solicitud termine antes de cambiar los filtros nuevamente. |
| Un informe tiene datos y otro no | Verifica el evento que cada informe necesita. Las visitas pueden existir antes que las órdenes. |
| El informe no puede cargarse | Recarga una vez y conserva el nombre del informe, el período y el error si falla nuevamente. |
| **Este panel no se cargó.** | Selecciona **Reintentar** si aparece, o recarga la página. Los demás paneles siguen mostrando tus datos. |
| Entrada de navegación faltante | Expande **Medir** y confirma el espacio de trabajo seleccionado. Consulta [Disponibilidad de funciones](../advanced/feature-availability). |
## Guías relacionadas
- [Métricas y filtros](./metrics-filters)
- [Tráfico y conversión](./traffic-and-conversion)
- [Solucionar problemas de datos y publicación](./troubleshoot-data-and-publication)
---
# Enlaces de retroceso y auditoría del sitio
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/backlinks-and-site-audit
Las capturas y grabaciones muestran la interfaz en inglés.
Los Enlaces de retroceso y la Auditoría del sitio te ayudan a inspeccionar referencias fuera del sitio y problemas técnicos en el sitio desde el mismo espacio de trabajo de SEO.
> **Condicional:** Ambas secciones requieren un objetivo analizado elegible. Los datos de enlace y rastreo pueden ser incompletos, y los resultados opcionales de Lighthouse dependen de una verificación de página exitosa.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **SEO** → tarjeta **Backlinks** o **Estado del sitio** → **Abrir**. El informe técnico puede usar **Auditoría del sitio** dentro de la vista abierta.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una nueva tienda debe completar el requisito previo de publicación de SEO antes de usar informes. La vista previa de datos de muestra es ilustrativa; no se muestra ningún resultado de análisis aquí.
## Antes de empezar
Si SEO muestra la lista de verificación de configuración de la primera tienda, completa su requisito de publicación antes de esperar datos de informes. Los valores etiquetados **Vista previa · datos de ejemplo** son ejemplos, no los resultados de tu tienda. Los pasos a continuación son condicionales a que el informe correspondiente esté disponible.
- Publica y abre la tienda objetivo exitosamente.
- Completa el análisis inicial de SEO.
- Decide si necesitas contexto de enlace, un rastreo técnico o ambos.
- No elimines ni redirijas páginas únicamente desde una etiqueta de problema automatizado; inspecciona la página afectada primero.
## Controles y resultados de enlace de retroceso
| Control o sección | Qué muestra o hace |
| --- | --- |
| **Backlinks** | Abre enlaces totales, dominios de referencia, dominios principales y páginas principales vinculadas. |
| Vista Seguir / No seguir | Separa tipos de enlace cuando el proveedor incluye esa información. |
| Historial Nuevo / Perdido | Muestra cambios de enlace registrados por el proveedor. |
| Enlaces de retroceso rotos | Lista enlaces que parecen llevar a un destino no disponible. |
| Puntuación de spam | Proporciona una señal del proveedor para revisión; no es prueba de que un dominio sea dañino. |
| **Pedir a Runner que los audite** | Abre una nueva conversación de Runner con la evidencia de enlace de retroceso guardada y una solicitud de auditoría. No elimina enlaces ni cambia la tienda. |
## Controles y resultados de auditoría del sitio
| Control o sección | Qué muestra o hace |
| --- | --- |
| **Iniciar nueva auditoría** | Abre la configuración de rastreo. No cambia la tienda. |
| Control de páginas máximas | Limita cuánto del sitio público intenta rastrear la auditoría. |
| **Incluir Lighthouse** | Agrega verificaciones de rendimiento, accesibilidad, mejores prácticas y SEO compatibles. |
| **Ejecutar auditoría** | Inicia el rastreo configurado. |
| **Problemas** | Lista hallazgos agrupados para que puedas abrir la explicación, recomendación y páginas afectadas. |
| **Páginas** | Muestra cada URL rastreada con estado, título, H1, recuento de palabras, recuento de imágenes y tiempo de respuesta. |
| **Corregir todo con Runner** | Abre una nueva conversación de Runner con la evidencia de auditoría guardada y una solicitud de arreglo amplia. No edita ni publica la tienda por sí solo. |
| Fila de problema | Abre por qué importa el problema, la recomendación y páginas afectadas. |
| **Corregir con Runner** | Abre una nueva conversación de Runner con el problema seleccionado, URLs afectadas y una solicitud de arreglo. No edita ni publica la tienda por sí solo. |
## Ejecutar una auditoría enfocada
1. Abre **Auditoría del sitio**.
2. Selecciona **Iniciar nueva auditoría**.
3. Elige un límite de página apropiado para la tienda pública.
4. Habilita Lighthouse solo cuando necesites las verificaciones de calidad de página adicionales.
5. Selecciona **Ejecutar auditoría** y espera a que se complete.
6. Usa **Problemas** para comenzar con hallazgos de alto impacto, luego usa **Páginas** para inspeccionar las URLs afectadas y datos a nivel de página.
7. Abre un problema y verifica sus páginas afectadas manualmente.
8. Usa **Corregir con Runner** para un hallazgo apropiado, o **Corregir todo con Runner** para una solicitud de revisión amplia; ambos abren una conversación de Runner y requieren que revises cualquier trabajo propuesto antes de aceptar o publicar cambios.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Sin enlaces de retroceso | El proveedor no encontró datos de enlace para el objetivo; esto no es prueba de que no existan enlaces. |
| Enlace perdido | El proveedor ya no ve un enlace anterior. Abre la fuente y destino antes de actuar. |
| Rastreo falló | Confirma que la URL pública es accesible y no está bloqueada, luego ejecuta una auditoría más pequeña. |
| Lighthouse no disponible | Usa los resultados de rastreo que se completaron e intenta la verificación opcional más tarde. |
| El recuento de problemas es cero | No se devolvieron problemas coincidentes por esta auditoría; continúa con la revisión normal de la tienda. |
## Revisa los hallazgos existentes antes de otro rastreo
1. Abre **Backlinks** para inspeccionar los enlaces disponibles y los dominios de referencia.
2. Regresa a la vista general de SEO y abre **Estado del sitio**.
3. Si existe una auditoría, selecciona un problema y lee su recomendación y las URL afectadas.
4. Abre una página pública afectada y confirma que el problema se aplica.
5. Si se muestra una cola de corrección, revisa la corrección seleccionada antes de entregarla a Runner.
**Punto de control:** Tienes una URL afectada, evidencia de apoyo y una corrección propuesta. Seleccionar un hallazgo o abrir una conversación con Runner no significa que la corrección se haya aplicado o publicado.
## Guías relacionadas
- [Descripción general de SEO](./seo-overview)
- [Rendimiento de búsqueda](./search-performance)
- [Solucionar problemas de datos y publicación](./troubleshoot-data-and-publication)
---
# Métricas y filtros
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/metrics-filters
Las capturas y grabaciones muestran la interfaz en inglés.
Usa el mismo período y filtros para hacer una comparación significativa entre tráfico, órdenes y ventas.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Análisis** → controles de informe.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEkGsXzhdR6T0uwqnz73letZimQpFvYfSrhLM)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Elige Últimas 24 horas, Últimos 7 días o Últimos 30 días en el menú de fecha de Analytics de una sola página.
## Antes de empezar
- Decide qué pregunta debe responder el período: actividad actual, una semana reciente o una tendencia más amplia.
- Un día actual parcial no es directamente comparable con un día pasado completo.
- Los controles de filtro varían según el informe y el diseño de Analytics disponible para tu espacio de trabajo.
## Controles y resultados de clics
Primero verifica tu diseño visible. El tablero de una sola página ofrece **Últimas 24 horas**, **Últimos 7 días** y **últimos 30 días**. Si tu espacio de trabajo muestra en su lugar el banco de trabajo de **Analíticas de la tienda**, usa los controles a continuación:
| Control | Resultado |
| --- | --- |
| **Hoy** / **Ayer** | Selecciona el día actual o el anterior. |
| **7 días** / **30 días** | Selecciona una ventana semanal o mensual reciente. |
| Fechas personalizadas | Te permite elegir las fechas de inicio y fin del informe. |
| **Comparar**, cuando se muestra | Agrega o elimina un período de comparación. |
| **Segmento**, cuando se muestra | Estrecha el informe a la audiencia seleccionada. |
| Filtros adicionales | Restringe eventos o registros coincidentes. Usa solo las condiciones necesarias para tu pregunta y respeta el límite mostrado por el formulario. |
Si tu espacio de trabajo muestra el tablero anterior, su selector ofrece **Últimas 24 horas**, **Últimos 7 días** y **últimos 30 días** en su lugar.
### Controles junto a Más informes
Si tu página de Analítica muestra **Informe de esta semana** y **Más informes** sobre el gráfico, usa estos controles:
| Control | Resultado |
| --- | --- |
| Rango de fechas | Elige **Hoy**, **Ayer**, **Últimos 7 días**, **Últimos 30 días**, **Últimos 90 días**, **Este mes** o **Personalizado…**. Las flechas pasan al periodo anterior o siguiente. |
| Opción de comparar en el rango de fechas | Muestra cada cifra junto al periodo de igual duración justo antes. Con 30 días, la opción dice **Comparar con los 30 días anteriores**. |
| **Filtrar** | Acota los informes por **Fuente**, **País**, **Dispositivo** o **Producto visto**. El botón inferior muestra cuántos visitantes coinciden, como **Mostrar 136 visitantes**; selecciónalo para aplicar el filtro. |
| Etiquetas de filtro | Cada filtro activo aparece sobre el informe, junto a un recuento como **Mostrando 40 de 136 visitantes**. Quítalo desde su etiqueta o selecciona **Borrar todo**. |
| **Diario** / **Semanal** | Cambia cómo agrupa los días el gráfico de tendencia. |
**Producto visto** conserva a los visitantes que vieron ese producto, así que cada informe describe a esos clientes. Algunos informes, como **Productos** y **En vivo**, ignoran el rango de fechas o los filtros; ahí esos controles se ocultan.
## Compara un período
1. Abre el informe y elige **Últimos 7 días** o **últimos 30 días** en el tablero de una sola página. En el banco de trabajo, elige **7 días**, **30 días** o fechas personalizadas.
2. Espera a que el informe se actualice y confirma que la etiqueta de fecha coincida con tu elección.
3. Habilita **Comparar** si está disponible y verifica qué período utiliza.
4. Aplica un segmento o filtro solo cuando la pregunta concierna a esa audiencia o evento.
5. Confirma que la condición seleccionada permanezca visible antes de interpretar las cifras.
6. Elimina la condición y desactiva la comparación para volver a la vista más amplia.
**Punto de control:** Puedes indicar qué fechas y condiciones produjeron las cifras mostradas. Borrar los filtros debería restaurar la consulta más amplia, incluso si ambas consultas están vacías.
## Lee métricas con sus conteos
- Verifica las sesiones y compras registradas antes de interpretar los porcentajes de conversión.
- Lee GMV y ventas netas por separado: describen diferentes medidas de ventas.
- Un cambio porcentual brusco con una muestra pequeña necesita más evidencia.
- Igualar las longitudes de los períodos, filtros y definiciones de métricas antes de comparar otro servicio.
## Solución de problemas
| Estado | Siguiente paso |
| --- | --- |
| El nuevo período aún está vacío | Borra los filtros y confirma que la tienda tuvo actividad relevante en ese período. |
| Un filtro no está disponible | Usa los controles compatibles con ese informe; no asumas que todas las vistas tienen los mismos campos. |
| Límite de filtros alcanzado | Elimina una condición innecesaria antes de agregar otra. |
| Los valores cambian inesperadamente | Revisa las fechas personalizadas, el segmento activo, el período de comparación y pedidos o reembolsos inusuales. |
| El informe no se actualiza | Recarga una vez y conserva el período seleccionado y el error visible para soporte. |
## Guías relacionadas
- [Descripción general de Analytics](./analytics-overview)
- [Tráfico y conversión](./traffic-and-conversion)
- [Solucionar problemas de datos y publicación](./troubleshoot-data-and-publication)
---
# Indicaciones, palabras clave y citas
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/prompts-keywords-citations
Las capturas y grabaciones muestran la interfaz en inglés.
Las secciones de detalle de visibilidad de IA te ayudan a aprender qué preguntas muestran tu marca y qué fuentes respaldan las respuestas disponibles.
> **Condicional:** El Explorador de indicaciones y sus modelos pueden estar limitados por plan o proveedor. Ejecutar una indicación solicita una salida de modelo nueva y puede usar capacidad de pago; revisa el aviso del espacio de trabajo actual antes de ejecutarla.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **SEO** → **Visibilidad en IA** → **Abrir** → **Prompts**, **Keywords** o **Citas**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una nueva tienda debe completar el requisito previo de publicación de SEO antes de usar informes. La vista previa de datos de muestra es ilustrativa; no se muestra ningún resultado de análisis aquí.
## Antes de empezar
Si SEO muestra la lista de verificación de configuración de la primera tienda, completa su requisito de publicación antes de esperar datos de informes. Los valores etiquetados **Vista previa · datos de ejemplo** son ejemplos, no los resultados de tu tienda. Los pasos a continuación son condicionales a que el informe correspondiente esté disponible.
- Completa la configuración de visibilidad de IA.
- Escribe una pregunta de comprador enfocada.
- Selecciona al menos un modelo disponible.
- Usa búsqueda web solo cuando quieras que el modelo consulte fuentes públicas actuales.
## Controles y resultados de clics
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Campo de indicación | Acepta la pregunta a probar y advierte cuando la entrada es demasiado larga. |
| Selector de modelo | Elige qué respuestas de modelo disponibles solicitar. |
| **Permitir búsqueda web** | Permite que los modelos compatibles consulten fuentes web públicas para esta ejecución. |
| Resaltado de marca | Indica a la vista de resultados qué mención de marca destacar. No obliga al modelo a mencionar la marca. |
| **Ejecutar Explorador de prompts** | Inicia las solicitudes de modelo seleccionadas. No edita la tienda ni guarda una mejora de visibilidad. |
| **Prompts** | Muestra preguntas rastreadas o exploradas y sus resultados disponibles. |
| **Keywords** | Muestra términos asociados con el conjunto de datos de visibilidad de IA. |
| **Citas** | Muestra fuentes citadas en respuestas de modelo disponibles. |
| **Menciones** | Muestra respuestas o registros donde se detectó la marca rastreada. |
## Explora una pregunta de comprador
1. Abre **Prompts**.
2. Ingresa una pregunta en lenguaje natural que un comprador podría hacer.
3. Selecciona el modelo o modelos disponibles que necesitas.
4. Decide si habilitar **Permitir búsqueda web**.
5. Opcionalmente elige la marca rastreada para resaltar.
6. Selecciona **Ejecutar Explorador de prompts** una vez.
7. Espera a que cada modelo solicitado termine o falle.
8. Compara la respuesta, el estado **Marca mencionada** o **Marca no mencionada**, citas y consultas relacionadas.
9. Abre **Keywords** y **Citas** para encontrar temas y fuentes recurrentes.
## Interpreta resultados de forma segura
- Una respuesta es una muestra, no una clasificación estable.
- "Marca no mencionada" describe esa respuesta, no todas las respuestas posibles.
- Una cita significa que el modelo hizo referencia a una fuente; no significa que Runner respalde la fuente.
- Los resultados con búsqueda web desactivada y búsqueda web activada responden preguntas diferentes y no deben tratarse como pruebas idénticas.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Botón Ejecutar deshabilitado | Ingresa una indicación válida y selecciona al menos un modelo. |
| Un modelo falla | Usa los resultados del modelo completado e intenta el proveedor fallido más tarde. |
| Sin citas | La respuesta puede no haber usado o devuelto fuentes públicas. Intenta de nuevo solo con búsqueda web si eso coincide con tu objetivo. |
| Resultados no relacionados | Haz la indicación más específica sobre el producto, audiencia o necesidad de compra. |
| Error de acceso del proveedor | Elige un modelo disponible o pregunta a un propietario del espacio de trabajo sobre el acceso. |
## Inspecciona primero la evidencia guardada
1. Abre **Visibilidad en IA** desde la vista general de SEO y elige **Citas**.
2. Inspecciona una fuente disponible y su respuesta asociada. Sigue el enlace de la fuente cuando se proporcione uno.
3. Regresa a Runner y compara la fuente con el prompt o keyword relacionado.
4. Inicia una nueva ejecución de **Explorador de prompts** solo si la búsqueda guardada no responde a tu pregunta.
**Punto de control:** Puedes identificar la respuesta y la página citada detrás de un hallazgo. Una búsqueda de Brand Lookup guardada y una nueva ejecución de Prompt Explorer son muestras separadas; abrir evidencia guardada no ejecuta otro prompt.
## Guías relacionadas
- [Visibilidad de IA](./ai-visibility)
- [Rendimiento de búsqueda](./search-performance)
- [Solucionar problemas de datos y publicación](./troubleshoot-data-and-publication)
---
# Rendimiento de búsqueda
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/search-performance
Las capturas y grabaciones muestran la interfaz en inglés.
El rendimiento de búsqueda te ayuda a identificar qué consultas y páginas parecen más importantes en los datos disponibles para Runner.
> **Condicional:** Estas estimaciones aparecen solo después de que un análisis de SEO elegible devuelve datos del proveedor. Un dominio nuevo o con poco tráfico puede tener pocos o ningún dato.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **SEO** → tarjeta de **Rendimiento de búsqueda** → **Abrir**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una nueva tienda debe completar el requisito previo de publicación de SEO antes de usar informes. La vista previa de datos de muestra es ilustrativa; no se muestra ningún resultado de análisis aquí.
## Antes de empezar
Si SEO muestra la lista de verificación de configuración de la primera tienda, completa su requisito de publicación antes de esperar datos de informes. Los valores etiquetados **Vista previa · datos de ejemplo** son ejemplos, no los resultados de tu tienda. Los pasos a continuación son condicionales a que el informe correspondiente esté disponible.
- Completa un análisis de SEO exitoso para el objetivo público.
- Usa el dominio analizado mostrado por Runner, especialmente cuando el proyecto tiene más de un dominio.
- Lee las estimaciones del proveedor como señales direccionales; pueden no coincidir exactamente con tu análisis de primera parte.
## Secciones principales
| Sección | Qué significa |
| --- | --- |
| Tráfico orgánico estimado | Una estimación del proveedor de visitas de búsqueda sin pagar. |
| Palabras clave orgánicas | Términos de búsqueda para los que el dominio tiene datos de visibilidad disponibles. |
| Clasificación de dominio | Una medida de autoridad o visibilidad comparativa del proveedor disponible. |
| Top 3 palabras clave | Palabras clave estimadas para clasificarse cerca de la parte superior de los resultados de búsqueda. |
| **Palabras clave principales** | Consultas con su información de posición o tráfico disponible. |
| **Páginas principales** | Páginas públicas que reciben la visibilidad orgánica estimada más fuerte. |
| **Preguntar a Runner** | Crea una nueva conversación de Runner con la evidencia del informe guardado y una solicitud de mejora sugerida. No edita ni publica la tienda por sí solo. |
| **Ver 5 mejoras rápidas** | Crea la misma entrega de Runner basada en evidencia para que puedas pedir oportunidades priorizadas en el chat. Revisa cualquier trabajo propuesto antes de aplicarlo o publicarlo. |
| **Analizar de nuevo** | Solicita una nueva instantánea; no cambia contenido ni clasificación. |
## Revisa oportunidades de búsqueda
1. Abre **Rendimiento en búsquedas** después de que se complete el análisis.
2. Confirma que el dominio analizado es la tienda pública que pretendías.
3. Lee las métricas de resumen como una línea de base, no una promesa.
4. Escanea **Palabras clave principales** para términos que coincidan con los productos y la audiencia.
5. Abre o anota las **Páginas principales** correspondientes.
6. Compara el contenido de la página con la pregunta del comprador detrás de cada palabra clave útil.
7. Realiza cambios en la tienda a través de Runner o el editor de tienda, luego publícalos por separado.
8. Vuelve más tarde y selecciona **Analizar de nuevo** cuando haya pasado suficiente tiempo para que las fuentes públicas cambien.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Sin datos orgánicos | El proveedor puede no tener suficiente información para el dominio. Confirma la publicación e intenta más tarde. |
| Palabra clave pero sin página coincidente | Abre la lista de páginas y el sitio público; el proveedor puede atribuir la consulta a una URL diferente. |
| La estimación difiere de Analytics | Analytics registra eventos de tienda; SEO usa estimaciones de búsqueda externas. Alinea la pregunta antes de compararlas. |
| El contenido recién publicado está ausente | El descubrimiento de búsqueda no es inmediato. Confirma que la página es pública y espera antes de actualizar. |
## Elige una mejora revisable
Usa **Keywords** y **Páginas** en el informe abierto para conectar una consulta útil a una página pública. Si se muestra **Abrir cola de correcciones**, inspecciona la corrección propuesta y su página afectada antes de comenzar a trabajar con Runner.
**Punto de control:** Puedes nombrar la consulta, la página y el cambio a revisar. Las cifras de búsqueda externa son estimaciones. Una conexión opcional a Google Search Console puede proporcionar clics de primera mano cuando estén disponibles; no está conectada automáticamente y no debe confundirse con las estimaciones.
## Guías relacionadas
- [Descripción general de SEO](./seo-overview)
- [Enlaces de retroceso y auditoría del sitio](./backlinks-and-site-audit)
- [Tráfico y conversión](./traffic-and-conversion)
---
# Descripción general de SEO
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/seo-overview
Las capturas y grabaciones muestran la interfaz en inglés.
SEO te ayuda a inspeccionar cómo se puede descubrir una tienda pública en resultados de búsqueda y respuestas generadas por IA.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **SEO**. La vista general de **SEO & GEO** enlaza a informes individuales.
## Si esta es tu primera visita de SEO
El recorrido introductorio explica el espacio de trabajo; **Saltar el tour** abre la vista general. Para una nueva tienda, **Vamos a hacer que tu tienda sea encontrada** muestra tres etapas de configuración: publicar la tienda, verificaciones automáticas de IA y seguimiento automático de palabras clave. Comienza con el requisito de publicación.
Las métricas etiquetadas como **Vista previa · datos de ejemplo** ilustran el formato del informe. No son mediciones de tu tienda. Las instrucciones del informe a continuación se aplican después de que se complete la configuración requerida y estén disponibles los resultados reales.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una nueva tienda debe completar el requisito previo de publicación de SEO antes de usar informes. La vista previa de datos de muestra es ilustrativa; no se muestra ningún resultado de análisis aquí.
## Antes de empezar
- Publica la tienda a menos que Runner ofrezca un objetivo personalizado elegible en tu espacio de trabajo.
- Confirma que la página pública se carga antes de iniciar el análisis.
- Permite tiempo para que los proveedores de búsqueda e IA tengan datos sobre un sitio recién publicado.
- Trata el análisis como una instantánea de fuentes disponibles, no como una garantía de clasificación o menciones.
## Controles principales y resultados de clics
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Tarjetas de informe de resumen → **Abrir** | Abre **Rendimiento de búsqueda**, **Visibilidad en IA**, **Backlinks** o **Estado del sitio**. |
| Cola de correcciones o cajón de revisión, cuando se muestra | Te permite inspeccionar una corrección propuesta y sus páginas afectadas antes de comenzar a trabajar. |
| **Rendimiento en búsquedas** | Abre estimaciones de tráfico orgánico, palabras clave, clasificación, palabras clave principales y páginas principales. |
| **Backlinks** | Abre vistas de enlaces, dominios de referencia, historial de enlaces y calidad de enlaces. |
| **Auditoría del sitio** | Abre resultados de rastreo técnico y problemas. |
| Secciones de visibilidad de IA | Abre el panel, indicaciones, palabras clave, citas o menciones cuando estén disponibles. |
| **Analizar** | Inicia el análisis para el objetivo elegible. No edita ni publica la tienda. |
| **Analizar de nuevo** | Solicita un análisis actualizado y reemplaza resultados obsoletos cuando se completa la actualización. |
| **Publicar** | Inicia la ruta de preparación de publicación separada cuando la tienda aún es un borrador. |
| Google Search Console → **Conectar** | Abre **Apps** filtradas para Google Search Console cuando esa conexión está disponible. |
## Inicia una revisión de SEO
1. Abre **Crecer** → **SEO** y confirma el objetivo en la vista general.
2. Si ves la puerta de publicación, usa la ruta de publicación y vuelve solo después de que la URL en vivo funcione.
3. Lee los informes existentes primero. Selecciona **Analizar** solo cuando se necesite un nuevo análisis, después de revisar su aviso de uso actual.
4. Espera a que el estado del análisis termine; no inicies repetidamente el mismo análisis.
5. Abre las tarjetas de **Rendimiento de búsqueda**, **Backlinks** y **Estado del sitio** para inspeccionar los informes disponibles.
6. Regresa a la vista general, abre **Visibilidad en IA** e inspecciona sus secciones de detalle disponibles.
7. Vuelve a ejecutar con **Analizar de nuevo** después de cambios públicos significativos o cuando Runner marca el resultado como obsoleto.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Puerta de publicación | La tienda actual no es elegible para análisis público. Publica y verifica la URL en vivo primero. |
| Analizando | Runner está recopilando datos disponibles. Espera a que se complete. |
| Actualizado | La instantánea mostrada se completó exitosamente. |
| Obsoleto | Los datos públicos pueden haber cambiado; usa **Analizar de nuevo** cuando una actualización sea útil. |
| Resultado parcial | Algunos proveedores devolvieron datos y otros no. Usa las secciones disponibles e intenta más tarde solo las que faltan. |
| Objetivo inaccesible | El analizador no pudo cargar la página pública. Abre la URL exacta directamente, resuelve problemas de publicación, dominio o acceso, luego analiza de nuevo. |
## Guías relacionadas
- [Rendimiento de búsqueda](./search-performance)
- [Enlaces de retroceso y auditoría del sitio](./backlinks-and-site-audit)
- [Visibilidad de IA](./ai-visibility)
- [Solucionar problemas de datos y publicación](./troubleshoot-data-and-publication)
---
# Tráfico y conversión
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/traffic-and-conversion
Las capturas y grabaciones muestran la interfaz en inglés.
Las vistas de tráfico y conversión te ayudan a ver dónde llegan los compradores, qué tan lejos progresan y dónde un viaje puede necesitar atención.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Análisis** → **Resumen**, **Comercio** o **Comportamiento** en el banco de trabajo. En el tablero anterior, desplázate debajo de las tarjetas de resumen.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvR648EFhEHcK82Y0dyL6sSr9NUGjnQeMWZJk)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El diseño de Análisis de una sola página en una tienda de tutoriales sin actividad registrada. La ilustración de diagnósticos Alpha no es evidencia de un problema de tienda.
## Antes de empezar
- Selecciona un rango de tiempo y mantenlo activo mientras comparas secciones.
- La tienda necesita sesiones registradas para análisis de tráfico y órdenes para análisis de ventas o reembolsos.
- Usa el embudo como evidencia de dónde inspeccionar, no como prueba de por qué los compradores se fueron.
## Abre el informe para tu pregunta
En el tablero de una sola página, mantén el mismo período seleccionado y desplázate a **Sesiones de Tráfico**, fuentes, ventas a lo largo del tiempo, el embudo, abandono y reembolsos. Los destinos agrupados a continuación se aplican solo cuando tu espacio de trabajo muestra el banco de trabajo de análisis.
| Pregunta | Destino del banco de trabajo |
| --- | --- |
| ¿Dónde se detuvo la compra? | **Comercio** → informe de embudo |
| ¿Qué productos o fuentes contribuyeron? | **Comercio** → informe de producto o adquisición |
| ¿Qué página o recorrido necesita inspección? | **Comportamiento** → informe de página o recorrido |
Usa **Ver detalles** desde la vista general cuando enlace al informe relevante. La disponibilidad y los datos varían según la tienda.
Si tu página de Analítica muestra **Informe de esta semana** y **Más informes** sobre el gráfico, abre estos informes desde **Más informes**:
| Pregunta | Informe |
| --- | --- |
| ¿Dónde se detuvo la compra? | **Embudos** |
| ¿Qué canales y campañas trajeron compradores? | **Canales**. Cambia entre **Último clic** y **Primera visita** para comparar qué visita recibe el mérito. |
| ¿Qué productos se venden y desde dónde? | **Productos**; luego selecciona un producto para ver sus fuentes, lugares y productos comprados con él. |
| ¿Qué fuentes y páginas de entrada convierten visitas en pedidos? | **Visitantes**. Lee la tasa de compra de cada fuente junto a su número de visitas. |
| ¿Dónde viven los compradores? | **Mapa** |
| ¿Desde qué página se van las personas? | **Páginas** → **Páginas de salida** |
## Secciones y resultados de clics
| Sección o control | Qué muestra o hace |
| --- | --- |
| **Sesiones de Tráfico** | Muestra la tendencia de visitas en el período seleccionado. |
| Vista de fuente de ventas | Desglosa las ventas registradas por fuente cuando los datos de fuente están disponibles. |
| Vista de ventas netas de producto | Compara la contribución del producto a las ventas netas. |
| Embudo de **Tasa de Conversión** | Muestra el progreso a través de **Tráfico**, **Agregar al Carrito**, **Proceso de pago** y **Compra**. |
| **Tasa de Abandono del Carrito** | Resume los carritos que no llegaron a una compra completada. |
| **Tasa de Reembolsos** | Muestra la actividad reembolsada para la ventana de informes. |
| Selector de rango de tiempo | Recalcula cada sección para el nuevo período. |
## Diagnostica una caída en la conversión
1. Desplázate al embudo en el tablero de una sola página, o abre el informe de **Comercio** relevante en el banco de trabajo. Selecciona un período con suficientes sesiones para ser útil. Si no hay datos, verifica la colección y el período antes de diagnosticar la conversión.
2. Verifica si el tráfico subió, bajó o se mantuvo estable.
3. Compara fuentes de tráfico para ver si la mezcla cambió.
4. Encuentra la caída más grande entre etapas de embudo adyacentes.
5. Si **Tráfico → Agregar al Carrito** cae, inspecciona información del producto, precios, confianza y claridad de la página de producto.
6. Si **Agregar al Carrito → Proceso de pago** cae, inspecciona costos del carrito, claridad de envío y la ruta al pago.
7. Si **Proceso de pago → Compra** cae, prueba la ruta de pago y pago sin realizar un pedido real innecesario.
8. Revisa los reembolsos por separado para que los problemas posteriores a la compra no se oculten dentro de las ventas de primera línea.
**Punto de control:** Nombra la etapa, página, período y cuenta de apoyo antes de proponer un cambio. Abre la página de la tienda afectada para probar tu explicación; el embudo identifica dónde inspeccionar, no la causa de la caída.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| La etapa del embudo es cero | Ningún evento coincidente llegó a esa etapa en el rango seleccionado. Confirma el seguimiento con un recorrido seguro de la tienda. |
| El tráfico existe pero las ventas no | La tienda recibió visitas sin una compra registrada. Inspecciona la primera caída grande del embudo. |
| Las ventas existen pero la fuente está en blanco | La atribución de fuente no estaba disponible para esas ventas; no asignes una fuente por conjetura. |
| La tasa de reembolso cambia bruscamente | Verifica el período de pedido subyacente y el número de pedidos antes de sacar una conclusión. |
| Los gráficos no coinciden con otro servicio | Alinea rangos de fechas, zonas horarias, definiciones de eventos y filtros antes de comparar totales. |
## Guías relacionadas
- [Métricas y filtros](./metrics-filters)
- [Descripción general de Analytics](./analytics-overview)
- [Rendimiento de búsqueda](./search-performance)
---
# Solucionar problemas de datos y publicación
Source: https://www.runnerai.com/docs/es/guides/analytics-and-seo/troubleshoot-data-and-publication
Las capturas y grabaciones muestran la interfaz en inglés.
Usa esta página para identificar si un resultado faltante proviene del estado de la tienda, rango de fechas, acceso al plan, acceso a funciones o una fuente de datos externa.
## Rutas de entrada
- Proyecto de tienda → **Medir** → **Análisis** para datos de eventos de la tienda.
- Proyecto de tienda → **Crecer** → **SEO** para datos de búsqueda pública y visibilidad de IA.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este requisito de publicación explica por qué una nueva tienda no tiene informe de SEO. Los datos de muestra no son un análisis completado.
## Antes de empezar
- Anota la página exacta, tienda, período seleccionado y mensaje visible.
- Verifica si el problema afecta una sección o toda la página.
- Para SEO, abre la tienda pública directamente antes de iniciar otro análisis.
- Para Analytics, confirma que el período seleccionado podría contener el evento que esperas.
## Controles y resultados de clics
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Rango de tiempo de Analytics | Actualiza el informe para el período seleccionado; no crea eventos de tráfico u órdenes faltantes. |
| **Analizar** | Inicia el análisis de SEO o visibilidad de IA disponible para el objetivo público actual. |
| **Analizar de nuevo** | Solicita una nueva instantánea después de un cambio significativo en el sitio público. |
| **Reintentar** | Repite la sección o solicitud fallida cuando se ofrece; no corrige publicación, acceso o requisitos previos del proveedor. |
## Solución de problemas
| Qué ves | Significado probable | Próximo paso |
| --- | --- | --- |
| Pantalla de actualización o plan | El plan actual no incluye la página. | Revisa el acceso al plan; las recargas repetidas no lo desbloquearán. |
| La entrada de navegación falta | La función no está habilitada para este espacio de trabajo. | Trátala como condicional y pregunta a un propietario del espacio de trabajo o soporte. |
| **Publica tu tienda para comenzar a analizar** | SEO no tiene un objetivo público elegible. | Completa la publicación, abre la URL en vivo, luego vuelve a SEO. |
| Panel de Analytics, cero o gráfico vacío | No existen eventos coincidentes para el período seleccionado. | Intenta una ventana más larga y verifica que la tienda tenga visitas u órdenes. |
| **Tienda nueva** con un recuento de visitas | Los gráficos empiezan cuando han llegado suficientes personas para que las cifras signifiquen algo. | Comparte el enlace de la tienda; el recuento muestra cuántas visitas faltan. |
| **Datos de ejemplo · no es tu tienda** | La página muestra cifras de ejemplo, no tus resultados. | Si seleccionaste **Ver datos de ejemplo**, selecciona **Volver a los datos del proyecto**. Si la página ofrece **Mejorar a Pro**, tu plan no incluye estos informes y los ejemplos se mantienen hasta que mejores el plan. |
| **Próximamente** en un panel | Ese panel aún no tiene fuente de datos. | Usa los demás paneles; no es un problema de la tienda ni del seguimiento. |
| **Este panel no se cargó.** | Falló una solicitud. | Selecciona **Reintentar** si aparece, o recarga la página. Los demás paneles siguen mostrando tus datos. |
| Objetivo inaccesible | El analizador no pudo cargar la página pública. | Abre la URL exacta directamente y resuelve problemas de publicación, dominio o acceso, luego analiza de nuevo. |
| Datos insuficientes | El proveedor no puede devolver una estimación útil aún. | Mantén el sitio público e intenta de nuevo después de más actividad o descubrimiento público. |
| Secciones parciales | Algunos proveedores se completaron y otros no. | Usa resultados completados; intenta de nuevo solo la sección faltante más tarde. |
| Etiqueta obsoleta | La instantánea guardada puede no reflejar más el sitio público. | Selecciona **Analizar de nuevo** después de cambios significativos. |
## Verifica datos de Analytics
1. Abre **Análisis** y anota el período seleccionado.
2. Elige **30 días** (o **últimos 30 días** en el diseño anterior), luego borra los filtros opcionales para descartar una consulta estrecha.
3. Confirma que la tienda en vivo ha recibido sesiones reales.
4. Confirma que existen órdenes o reembolsos antes de esperar métricas de ventas o reembolsos.
5. Compara etapas del embudo para ver qué eventos están presentes.
6. Recarga una vez. Si toda la página aún falla, registra la tienda y la hora para soporte.
## Verifica publicación y análisis de SEO
1. Abre la tienda pública en una pestaña separada.
2. Confirma que se carga sin un requisito de vista previa privada o inicio de sesión.
3. Vuelve a **SEO** y confirma el dominio u objetivo previsto.
4. Selecciona **Analizar** o **Analizar de nuevo** una vez.
5. Espera un resultado terminal en lugar de iniciar trabajos repetidos.
6. Si una sección falla, preserva las secciones exitosas e intenta más tarde solo la que falta.
## Lo que una configuración exitosa no prueba
- La publicación no garantiza la indexación de búsqueda.
- La indexación de búsqueda no garantiza tráfico o una posición superior.
- La configuración de visibilidad de IA no garantiza una mención.
- Una ejecución de indicación exitosa no predice todas las respuestas futuras del modelo.
- Un evento de Analytics no explica por qué un comprador actuó.
## Separar el acceso al informe de la colección
Expande **Medir** o **Crecer** antes de tratar una entrada como faltante. Una vista previa del plan no es un informe en vivo. En el banco de trabajo de análisis, **Configurar** contiene herramientas de seguimiento y configuración; abrirlo no crea eventos de compradores. Confirma la tienda, el período, los filtros y la actividad real antes de cambiar la configuración de la colección.
**Punto de control:** Identifica si el acceso está bloqueado, la consulta está vacía o una solicitud nombrada falló. Un informe vacío por sí solo no puede distinguir entre falta de actividad y colección faltante.
## Guías relacionadas
- [Descripción general de Analytics](./analytics-overview)
- [Descripción general de SEO](./seo-overview)
- [Visibilidad de IA](./ai-visibility)
- [Documentación de Runner](../product-guide)
---
# Aplicaciones e integraciones
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations
Las capturas y grabaciones muestran la interfaz en inglés.
Aplicaciones reúne tus servicios de tienda y aplicaciones de agente opcionales en un solo lugar. Úsalo cuando desees que Runner acepte pagos, envíe correos electrónicos de tienda, trabaje con proveedores de envío o cumplimiento, conecte Shopify o permita que el Agente use otro servicio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El centro muestra los estados de conexión existentes y los controles disponibles. Abrir esta página no crea una conexión.
## Abrir Aplicaciones
Desde una tienda abierta, selecciona **Apps** en la navegación del proyecto.
**Ruta de acceso:** **Proyecto → Apps**
La página puede mostrar dos secciones:
- **Gestiona tu tienda** contiene los servicios utilizados por el escaparate y las operaciones de la tienda.
- **Conecta tus herramientas** contiene servicios que el Agente de Runner puede usar mientras trabaja para ti.
Las aplicaciones de agente y Shopify son condicionales. Pueden estar ocultas o no disponibles para algunos espacios de trabajo. Los requisitos del proveedor también pueden impedir que una tarjeta visible se conecte.
## Controles de página
| Control o estado | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Buscar herramientas** | Encuentra un servicio sin escanear cada tarjeta. | Runner filtra el catálogo de herramientas. Limpiar el campo restaura la lista. |
| **Conectar** | Inicia una nueva conexión. | Runner abre el diálogo de credenciales específico del proveedor o el flujo de autorización. La conexión no está completa hasta que la tarjeta cambie de estado. |
| **Conectando...** | Muestra que Runner está procesando la solicitud. | La acción permanece no disponible hasta que la solicitud tenga éxito, falle o se cancele fuera de Runner. |
| **Conectado** o una acción conectada | Confirma que Runner reconoce la conexión. | Las tarjetas específicas del proveedor pueden exponer un enlace de panel de control, control de desconexión, cambio o diálogo de gestión. |
| **Gestionar** | Abre una conexión de aplicación de agente existente. | Puedes revisar sus herramientas o desconectarla. |
| **Reconectar** | Repara una conexión que necesita autorización de nuevo. | Runner reinicia el flujo de conexión del proveedor. |
| **En revisión** | Muestra que Stripe aún está revisando la cuenta. | Espera a que el estado cambie o sigue cualquier solicitud de acción mostrada en la tarjeta. |
| Eliminar o **Desconectar** | Elimina una conexión después de la confirmación. | La advertencia específica del proveedor explica qué proyectos y acciones futuras se verán afectados. |
## Encuentra una conexión existente o solicita una herramienta
Usa la franja **Conectado** para abrir una app ya conectada y revisar sus controles de gestión. Para encontrar una nueva App de Agente, desplázate a **Conecta tus herramientas** y usa **Buscar herramientas**. Limpia la búsqueda antes de decidir que una app está ausente.
**Solicitar una app** abre un formulario de solicitud. Enviar una solicitud no conecta un proveedor ni lo hace disponible de inmediato. Las conexiones de proveedores de CJ comienzan en [Dropshipping](/es/guides/apps-and-integrations/cj-dropshipping), no en una tarjeta de Apps.
## Conectar una aplicación de forma segura
1. Abre **Proyecto → Apps**.
2. Busca el servicio o encuéntralo bajo **Gestiona tu tienda** o **Conecta tus herramientas**.
3. Selecciona **Conectar**.
4. Lee el diálogo antes de ingresar un dominio, clave API, secreto o credenciales del proveedor.
5. Completa cualquier paso de autorización en el sitio del proveedor.
6. Vuelve a Aplicaciones y verifica la tarjeta. Trata solo un estado conectado confirmado, como una insignia conectada o controles conectados, como una conexión completada.
7. Si Runner muestra **Reconectar**, **En revisión** o un aviso de acción, sigue ese estado en lugar de repetir ciegamente la configuración inicial.
:::warning
Nunca pegues claves API o secretos en un chat de Runner. Ingresalos solo en el diálogo de integración que los solicita.
:::
## Elige una guía
- [Conectar, gestionar, reconectar o desconectar una aplicación](/es/guides/apps-and-integrations/connect-manage-reconnect)
- [Conectar Stripe para pagos](/es/guides/apps-and-integrations/stripe-payments)
- [Habilitar correo electrónico de tienda](/es/guides/apps-and-integrations/resend-email)
- [Conectar Shippo para envío](/es/guides/apps-and-integrations/shippo-shipping)
- [Conectar Shopify](/es/guides/apps-and-integrations/shopify)
- [Conectar CJ desde Dropshipping](/es/guides/apps-and-integrations/cj-dropshipping)
- [Conectar cumplimiento de 4PX](/es/guides/apps-and-integrations/4px-fulfillment)
- [Conectar y controlar aplicaciones de agente](/es/guides/apps-and-integrations/agent-apps)
- [Solucionar problemas de conexión de una aplicación](/es/guides/apps-and-integrations/troubleshooting)
---
# Conectar cumplimiento de 4PX
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/4px-fulfillment
Las capturas y grabaciones muestran la interfaz en inglés.
Conecta 4PX cuando quieras que Runner use tu cuenta de 4PX para envío transfronterizo y cumplimiento. Esta conexión requiere tanto una clave de API como un secreto de API.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Apps → Gestiona tu tienda → 4PX**
Necesitas:
- una cuenta de 4PX con una clave de API y secreto de API actuales;
- autorización para usar esas credenciales en esta tienda de Runner; y
- saber que desconectar elimina ambas credenciales y desactiva 4PX solo en esta tienda. Las demás tiendas conservan su propia conexión con 4PX.
Trata ambos campos como secretos. No los pegues en el chat de Runner.
En móvil, selecciona primero la fila del proveedor **4PX** para abrir sus detalles, luego usa los controles en ese diálogo. Un formulario de configuración visible solo muestra dónde comenzar; los pasos de conexión y operación del proveedor a continuación se aplican después de autorizar el servicio.
## Controles y resultados de 4PX
| Control | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Conectar** | Abre la configuración de 4PX. | Runner solicita **Clave API de 4PX** y **Secreto API de 4PX**. |
| Campos de clave de API y secreto | Identifican y autorizan la cuenta de 4PX. | Runner solo envía después de que ambos campos contengan un valor. |
| Iconos de ojo | Ayudan a verificar un error de escritura en cualquier campo. | Cada icono alterna independientemente ese campo entre texto oculto y visible. |
| **Conectar** del diálogo | Envía ambas credenciales. | En caso de éxito, Runner borra ambos campos, cierra el diálogo y marca 4PX conectado. |
| **Cancelar** o cerrar | Se detiene antes del envío. | Runner borra ambos campos del diálogo. |
| Eliminar o **Desconectar** | Inicia la eliminación. | Runner abre **¿Desconectar 4PX?**. |
| **Desconectar** de confirmación | Elimina las credenciales de esta tienda. | Runner desactiva 4PX en esta tienda. Las demás tiendas no se ven afectadas. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGp76tmTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Revisa los dos campos de credenciales antes de conectar. Este ejemplo se detiene antes de la presentación; no verifica el cumplimiento ni un envío.
## Conecta 4PX
1. Abre **Proyecto → Apps**.
2. Encuentra **4PX** y selecciona **Conectar**.
3. Copia la clave de API y el secreto de API de la cuenta de 4PX que pretendas usar.
4. Pégalos en **Clave API de 4PX** y **Secreto API de 4PX**.
5. Verifica que los dos valores estén en los campos correctos.
6. Selecciona **Conectar**.
7. Espera **4PX conectado exitosamente** y confirma que la tarjeta muestra su control de desconexión.
8. Verifica un escenario seguro de envío transfronterizo o cumplimiento antes de usarlo para un pedido de cliente en vivo.
## Desconecta o reemplaza credenciales
Selecciona el control de desconexión y lee **¿Desconectar 4PX?**. Confirma solo cuando sea aceptable desactivar 4PX en esta tienda. Las demás tiendas del espacio de trabajo conservan su propia conexión.
Para rotar credenciales, desconecta la conexión actual, confirma que la tarjeta ya no está conectada, luego reconecta con la clave y secreto de reemplazo.
## Si 4PX no se conecta
- Confirma que la clave y el secreto provengan de la misma cuenta de 4PX.
- Vuelve a copiar ambos valores en lugar de editar ningún secreto por conjetura.
- **Error al conectar 4PX** significa que Runner no completó la conexión del proveedor. Verifica las credenciales en 4PX e intenta de nuevo.
- Si la tarjeta se conecta pero el cumplimiento falla, verifica el acceso a la cuenta, soporte de destino y los datos de pedido requeridos por 4PX.
- Si la desconexión falla, asume que las credenciales actuales permanecen activas.
## Guías relacionadas
- [Conecta, administra y reconecta una aplicación](./connect-manage-reconnect)
- [Conecta Shippo para envío](./shippo-shipping)
- [Soluciona problemas de conexión de una aplicación](./troubleshooting)
---
# Conectar y controlar aplicaciones de agente
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/agent-apps
Las capturas y grabaciones muestran la interfaz en inglés.
Las aplicaciones de agente permiten que el Agente de Runner use un servicio externo mientras trabaja en tu proyecto. Puedes inspeccionar las herramientas de la aplicación y desactivar las herramientas que no deseas que use el Agente.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Apps → Conecta tus herramientas**
Las aplicaciones de agente son condicionales. La sección puede estar oculta, una aplicación individual puede no estar disponible, o el catálogo puede no cargar. La disponibilidad puede variar según el espacio de trabajo, proyecto, proveedor y acceso al producto por fases.
Necesitas:
- acceso al proyecto;
- una cuenta o credencial aceptada por el proveedor seleccionado; y
- permiso para que Runner use las herramientas que dejes habilitadas.
Revisa cada herramienta antes de conectar. El acceso a las herramientas se aplica al proyecto actual y puede permitir que el Agente lea o cambie datos en el servicio externo.
La conexión de la cuenta externa pertenece a tu cuenta de Runner con sesión iniciada, mientras que los cambios de herramientas se guardan para el proyecto actual. Desconectar puede, por lo tanto, eliminar la conexión utilizada por otros proyectos aunque sus opciones de herramientas sean separadas.
Comienza bajo **Conecta tus herramientas**. Abre una app, lee su lista de herramientas, luego cierra los detalles si solo estás comparando capacidades. La autorización es una decisión separada; revisar herramientas no conecta la cuenta externa.
## Buscar e inspeccionar una aplicación
| Control o estado | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Buscar herramientas** | Filtra el catálogo de herramientas. | El catálogo muestra nombres y descripciones coincidentes. |
| Selector de categoría | Reduce el catálogo de aplicaciones de agente. | Elige **Todo** para eliminar el filtro de categoría. |
| **Anterior** y **Siguiente** | Se mueve a través de un catálogo largo. | Runner muestra la página anterior o siguiente de aplicaciones coincidentes. |
| Tarjeta de aplicación | Muestra el nombre de la aplicación, descripción y estado de conexión. | Seleccionarla abre **Detalles de la app**. |
| **No se encontraron aplicaciones** | Muestra que los filtros actuales no tienen coincidencia. | **Borrar búsqueda** restablece la búsqueda y categoría. |
| Marcadores de posición de carga | Muestra que Runner está obteniendo el catálogo. | Espera a las tarjetas antes de elegir una aplicación. |
## Controles de detalles de la aplicación
| Control o estado | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Descripción de la aplicación y categoría | Ayuda a confirmar que abriste el servicio previsto. | No se otorga acceso externo al ver detalles. |
| Cambio de herramienta | Limita lo que Runner puede pedirle a la aplicación conectada que haga. | Antes de conectar, Runner guarda tus opciones con la conexión. Después de conectar, un cambio se guarda inmediatamente. |
| **Anterior** y **Siguiente** en la lista de herramientas | Revisa aplicaciones con muchas herramientas. | Se mueve a través de herramientas sin cerrar el diálogo. |
| Campos de credencial requeridos | Admite aplicaciones que no usan autorización del navegador. | **Conectar** permanece no disponible hasta que se completen los campos requeridos. Los campos similares a secretos están enmascarados. |
| **Conectar** | Envía credenciales del proveedor cuando esa estrategia es requerida. | Runner intenta la conexión con tu acceso a herramientas elegido. |
| **Conectar y autorizar** | Inicia la autorización del proveedor. | Runner abre una ventana de autorización. |
| **Conectando...** | Muestra que la autorización está en progreso. | La acción permanece no disponible hasta que Runner reciba un resultado. |
| **Conectado** | Confirma que Runner reconoce la cuenta. | Cierra el diálogo o gestiona el acceso a herramientas. |
| **Gestionar** | Reabre una aplicación conectada. | Revisa y cambia sus herramientas habilitadas o desconéctala. |
| **Desconectar** | Inicia la eliminación. | Runner pregunta **¿Estás seguro de que deseas desconectar?** |
| **Cancelar** o **Confirmar** | Resuelve la advertencia de desconexión. | Cancelar mantiene el acceso; Confirmar elimina la conexión de la aplicación de agente a nivel de cuenta de Runner. La configuración de herramientas del proyecto es separada. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgkttueHjXIfFwWx7Qu1lJBZMSPHcazYdR0voC)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Revisa las herramientas una página a la vez con **Siguiente**. Abrir esta lista no autoriza Notion; **Conectar y autorizar** inicia ese paso separado.
## Conectar una aplicación de agente
1. Abre **Proyecto → Apps** y desplázate a **Conecta tus herramientas**.
2. Busca la app o elige una categoría.
3. Selecciona la tarjeta de la app para abrir **Detalles de la app**.
4. Lee su descripción e inspecciona cada herramienta disponible.
5. Apaga cualquier herramienta que Runner no deba usar en este proyecto.
6. Ingresa las credenciales requeridas del proveedor o selecciona **Conectar y autorizar**.
7. Completa el paso del proveedor. Si tu navegador bloquea la ventana de autorización, permite el
popup para Runner y comienza de nuevo.
8. Regresa al diálogo y confirma que dice **Conectado**.
9. Selecciona **Gestionar** más tarde para revisar el acceso a herramientas o desconectar la app.
El diálogo de conexión indica que las credenciales del proveedor se envían a través del servicio de conexión y no se almacenan en Runner. Aún así, debes tratar cada credencial como un secreto e ingresarla solo en los campos de credencial de la aplicación.
## Cambiar acceso a herramientas
1. Selecciona **Gestionar** en la aplicación conectada.
2. Encuentra la herramienta que deseas cambiar.
3. Activa o desactiva su cambio.
4. Espera **Herramienta habilitada** o **Herramienta deshabilitada**.
5. Si Runner muestra **Error al actualizar herramienta**, deja el diálogo abierto, verifica el cambio actual después de que se actualice, e intenta de nuevo solo si el estado guardado es claro.
Desactivar una herramienta limita el uso de esa herramienta por parte de Runner. No elimina datos creados previamente en el servicio externo.
## Reparar o desconectar una conexión
Si el catálogo ya no muestra una conexión utilizable, abre la aplicación e inicia **Conectar** o **Conectar y autorizar** de nuevo, luego confirma **Conectado**.
Para eliminar el acceso, selecciona **Gestionar → Desconectar**, revisa la confirmación y selecciona **Confirmar**. Esto elimina la conexión de la aplicación de agente de la cuenta con sesión iniciada, no solo el acceso a herramientas del proyecto actual. Si la desconexión falla, Runner mantiene el estado conectado; no asumas que la cuenta externa fue eliminada.
## Si faltan aplicaciones de agente
- La función puede no estar habilitada para el espacio de trabajo.
- Borra la búsqueda y establece la categoría en **Todo**.
- Actualiza Aplicaciones si el catálogo nunca sale de su estado de carga.
- Una aplicación individual puede informar que aún no está disponible para conectar.
- Si la lista de herramientas falla, selecciona **Reintentar** dentro de **Detalles de la app**.
- No se debe prometer ninguna entrada de catálogo específica hasta que aparezca en el espacio de trabajo actual.
## Guías relacionadas
- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
- [Conectar, gestionar y reconectar una aplicación](./connect-manage-reconnect)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
---
# Conectar CJ Dropshipping
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/cj-dropshipping
Las capturas y grabaciones muestran la interfaz en inglés.
Conecta CJ Dropshipping cuando quieras buscar, importar y operar productos de proveedores de CJ con tu propia cuenta de CJ.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Dropshipping → Conectar proveedor**
Si tu proyecto usa la navegación anterior, abre **Operaciones de la tienda → Dropshipping** en su lugar. La página actual de Apps no lista CJ; usa la entrada del proveedor.
Necesitas:
- una cuenta de CJ Dropshipping y su clave API actual;
- autoridad para conectarla a la organización; y
- un producto de muestra seguro para verificar la conexión antes de confiar en ella.
Mantén la clave API privada e ingrésala solo en el diálogo de conexión de CJ de Runner. Desconectar elimina la autorización del proveedor de las importaciones de CJ propiedad del comerciante hasta que te vuelvas a conectar.
## Controles y resultados de CJ
| Control | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Conectar proveedor** | Abre las opciones de proveedor desde Dropshipping. | Elige CJ Dropshipping para abrir la configuración de la clave API. |
| Opción de proveedor **CJ Dropshipping** | Abre la configuración de CJ desde Dropshipping. | Runner solicita **Clave API de CJ**. |
| **Clave API de CJ** | Conecta tu propia cuenta de proveedor. | El diálogo acepta una clave no vacía para la presentación. |
| Icono de ojo | Ayuda a verificar un error de escritura. | Alterna la visibilidad de la clave. Ocúltala antes de compartir tu pantalla. |
| Diálogo **Conectar** | Envía la clave. | En caso de éxito, Runner limpia el campo, cierra el diálogo y marca CJ como conectado. |
| **Cancelar** o cerrar | Sale sin conectar. | Runner limpia la clave del diálogo. |
| Eliminar o **Desconectar** | Inicia la eliminación. | Runner abre una confirmación antes de eliminar la conexión. |
| Confirmación **Desconectar** | Elimina tu clave. | Las futuras operaciones de búsqueda, importación, pago y proveedor autorizadas por el comerciante de CJ están bloqueadas hasta que se restaure una conexión válida. |
Para inspeccionar la configuración sin autorizar CJ, abre la opción de proveedor y su formulario de clave vacío, luego selecciona **Cancelar**. Conectar e importar a continuación requieren tu propia cuenta de proveedor válida; una vista previa del catálogo no verifica ninguna de las acciones.
## Conecta tu cuenta de CJ
1. Abre **Proyecto → Dropshipping** (o la entrada de Operaciones de la tienda anterior cuando se muestre).
2. Selecciona **Conectar proveedor**, luego elige **CJ Dropshipping**.
3. Copia la clave API de la cuenta de CJ que deseas que Runner use.
4. Pégala en **Clave API de CJ**.
5. Selecciona **Conectar** en el diálogo.
6. Espera a que Runner confirme la conexión.
7. Envía una búsqueda segura o abre un producto de muestra de CJ en Dropshipping para verificar que la conexión pueda acceder al catálogo deseado.
Las conexiones de proveedores son compartidas por la organización. En **Gestionar proveedores**, verifica CJ y AliExpress por separado; conectar uno no conecta al otro.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este ejemplo muestra proveedores conectados existentes. Demuestra dónde inspeccionar cada conexión; no se realizó ninguna conexión, importación o desconexión para esta guía.
## Desconectar o reemplazar la clave
Lee cuidadosamente la confirmación de desconexión. Desconectar elimina tu clave API de CJ. No transfiere de manera transparente las importaciones propiedad del comerciante a otra cuenta de CJ.
Después de una desconexión, las futuras búsquedas e importaciones de CJ requieren una conexión. El pago y la finalización del pedido para las importaciones afectadas propiedad del comerciante fallan cuando Runner no puede verificar la conexión en vivo, el producto, la variante, el inventario, el precio o el flete. Vuelve a conectar la misma cuenta de CJ y verifica el artículo nuevamente. Si su identidad de proveedor o datos en vivo ya no coinciden, elimina el producto afectado e impórtalo nuevamente.
Para reemplazar la clave, desconecta la actual, confirma que Runner ya no la muestra como conectada, luego conecta la de reemplazo. Verifica los productos CJ existentes antes de aceptar nuevos pedidos; cambiar de cuentas puede hacer que una importación existente no esté disponible.
## Si CJ no se conecta
- Copia la clave API nuevamente de la cuenta de CJ deseada; no la edites por conjeturas.
- **No se pudo conectar CJ Dropshipping** significa que Runner no aceptó la conexión del proveedor. Verifica la clave en CJ e inténtalo de nuevo.
- Si el diálogo se cierra sin un estado conectado, actualiza la página actual antes de enviar nuevamente.
- Si la búsqueda o importación falla después de conectar, confirma que esta cuenta de CJ puede acceder a esa operación de catálogo.
- Si la desconexión falla, asume que la clave existente y el contexto de la cuenta permanecen activos hasta que Runner confirme la eliminación.
- Si el proceso de pago se detiene después de reconectar, verifica que el producto y las variantes pertenezcan a la cuenta de CJ conectada; vuelve a importar el artículo cuando no lo hagan.
## Guías relacionadas
- [Conectar, gestionar y reconectar una aplicación](./connect-manage-reconnect)
- [Conectar cumplimiento de 4PX](./4px-fulfillment)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
---
# Conectar, gestionar y reconectar una aplicación
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/connect-manage-reconnect
Las capturas y grabaciones muestran la interfaz en inglés.
Usa esta guía para llevar una aplicación a través de su ciclo de vida de conexión: inicia la conexión, confirma su estado real, repara la autorización cuando sea necesario y desconéctala de forma segura.
**Ruta de acceso:** **Proyecto → Apps**
## Antes de empezar
Úsalo cuando:
- una aplicación dice **Conectar**, **Conectando...**, **Reconectar** o **En revisión**;
- necesitas verificar si un flujo de proveedor anterior realmente terminó;
- una aplicación de agente necesita acceso a herramientas diferente; o
- tienes la intención de eliminar una conexión y necesitas entender la advertencia primero.
Necesitas acceso al proyecto y cualquier cuenta, credencial o aprobación solicitada por el proveedor externo. Algunas aplicaciones son condicionales y pueden no aparecer en cada espacio de trabajo.
En móvil, toca la fila del proveedor para abrir su diálogo de detalles antes de elegir **Conectar**. Las Apps de Agente están bajo **Conecta tus herramientas**; los proveedores de tienda están bajo **Gestiona tu tienda**. Para CJ, utiliza la [guía de conexión del proveedor](/es/guides/apps-and-integrations/cj-dropshipping).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Identifica el proveedor y su estado actual antes de abrir la configuración. Los controles conectados existentes no son evidencia de una nueva autorización.
## Lee la tarjeta antes de actuar
| Estado de tarjeta o control | Significado | Qué hacer |
| --- | --- | --- |
| Indicador de carga | Runner está verificando la conexión guardada. | Espera antes de seleccionar otra acción. |
| **Conectar** | Runner no tiene una conexión utilizable para esta aplicación. | Abre el diálogo de configuración o el flujo de autorización del proveedor. |
| **Conectando...** | Una solicitud de conexión está en progreso. | Termina el flujo del proveedor o espera a que Runner devuelva un resultado. |
| **Conectado** | Runner reconoce una conexión utilizable. | Usa su control de gestión o desconexión si necesitas un cambio. |
| **Gestionar** | La aplicación de agente conectada tiene herramientas configurables. | Abre los detalles de la aplicación y revisa el acceso a herramientas. |
| **Reconectar** | La autorización falta, ha expirado o de otra manera necesita atención. | Inicia la autorización de nuevo. No asumas que la conexión anterior aún funciona. |
| **En revisión** | Stripe tiene la cuenta pero no la ha hecho lista. | Sigue el estado o aviso de acción; la etiqueta no es un botón de Conectar. |
| **Continuar incorporación** | Stripe aún necesita información. | Continúa la configuración existente en lugar de crear otra cuenta. |
| Eliminar o **Desconectar** | Una conexión puede ser eliminada. | Lee y confirma el impacto específico del proveedor. |
## Conectar o reparar una conexión
1. Abre **Apps** y encuentra la app.
2. Selecciona **Conectar**.
3. Proporciona solo los campos mostrados en el diálogo. Dependiendo de la app, esto puede ser un dominio de tienda, una clave API, una clave y secreto, credenciales del proveedor o autorización externa.
4. Completa el paso del proveedor, luego regresa a Apps.
5. Confirma que la tarjeta ahora muestra una insignia de conectado o los controles conectados del proveedor.
Un diálogo cerrado o ventana del proveedor no es prueba de éxito.
6. Si la tarjeta muestra **Reconectar** o **Continuar con la incorporación**, selecciona esa acción y
continúa con la conexión existente.
## Desconectar solo cuando quieras eliminar el acceso
1. Para eliminar la app, selecciona su control de desconexión, lee la confirmación y elige
**Desconectar** o **Confirmar** solo cuando el impacto a nivel de espacio de trabajo sea aceptable.
2. Vuelve a abrir Apps y confirma que la tarjeta regresó a su estado desconectado.
La grabación abre los formularios en blanco de Shippo, 4PX y Shopify, luego los cierra. No se ingresan credenciales y no se conecta ningún proveedor.
## Los proveedores de tienda y las Apps de Agente son diferentes
Los proveedores bajo **Gestiona tu tienda** usan controles específicos del proveedor:
- **Correo** usa un interruptor de encendido/apagado.
- **Stripe** puede mostrar controles de incorporación, revisión, acción requerida, panel de control y desconexión.
- **Shippo**, **4PX** y **Shopify** solicitan datos de configuración específicos del proveedor
y muestran una confirmación de desconexión destructiva.
## Seguridad de la conexión
- Trata las claves y secretos del proveedor como contraseñas.
- Lee si una conexión pertenece al espacio de trabajo o solo al proyecto actual.
- Que una ventana del proveedor se complete no garantiza que Runner haya recibido un resultado utilizable.
- No desconectes un proveedor de envío, pago, correo o cumplimiento durante operaciones activas de la tienda sin verificar la advertencia y tus pedidos actuales.
- Si una desconexión informa un error, actualiza e inspecciona el estado actual antes de intentar nuevamente. No asumas que el proveedor fue eliminado.
## Guías relacionadas
- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
- [Conectar y controlar aplicaciones de agente](./agent-apps)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
---
# Habilitar correo electrónico de tienda
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/resend-email
Las capturas y grabaciones muestran la interfaz en inglés.
La aplicación de tienda **Correo** habilita mensajes transaccionales desde tu tienda cuando el servicio de correo electrónico está disponible para el espacio de trabajo. Úsalo para eventos de tienda que necesiten un mensaje automatizado al cliente en lugar de una campaña manual.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Apps → Gestiona tu tienda → Correo**
La tarjeta está etiquetada como **Correo** en Runner. No ingresas una clave API de Resend en este flujo. La disponibilidad puede variar con la configuración del espacio de trabajo, la preparación de la tienda y el soporte de correo electrónico.
Antes de habilitarlo:
- confirma que estás trabajando en el espacio de trabajo previsto;
- revisa el contenido de correo electrónico orientado al cliente de la tienda donde ese editor esté disponible; y
- planifica verificar el viaje completo del correo electrónico con una dirección que controles.
En móvil, selecciona primero la fila del proveedor **Correo** para abrir sus detalles, luego usa los controles en ese diálogo. Un formulario de configuración visible solo muestra dónde comenzar; los pasos de conexión y operación del proveedor a continuación se aplican después de que autorices el servicio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Ubica **Correo** bajo **Gestiona tu tienda**. Esta vista general muestra la entrada; no se cambió ninguna configuración de correo y no se envió ningún mensaje al cliente.
## Controles y resultados de correo electrónico
| Control o estado | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Indicador de carga | Evita cambios antes de que Runner conozca el estado guardado. | El cambio aparece después de que se carga la configuración actual. |
| Cambio de correo electrónico desactivado | Muestra que las notificaciones de correo electrónico de tienda están deshabilitadas. | Activarlo crea o habilita la conexión de correo electrónico del espacio de trabajo. |
| Cambio de correo electrónico activado | Muestra que Runner ha habilitado la integración de correo electrónico. | Desactivarlo desconecta la integración. |
| Estado de carga del cambio | Muestra que el cambio se está guardando. | Los cambios posteriores esperan hasta que Runner tenga éxito o falle. |
| Mensaje de éxito | Confirma que Runner aceptó el cambio de configuración. | El cambio permanece en el nuevo estado. |
| Mensaje de error | Muestra que Runner no pudo habilitar o deshabilitar el correo electrónico. | El cambio vuelve al estado guardado para que puedas reintentar. |
## Habilitar correo electrónico
1. Abre **Proyecto → Apps**.
2. Encuentra **Correo** bajo **Gestiona tu tienda**.
3. Activa el interruptor.
4. Espera a que aparezca **Notificaciones de correo habilitadas** y confirma que el interruptor permanece activado.
5. Si Runner te indica que se requiere una nueva publicación en otra parte del producto, publica
la última versión de la tienda antes de probar el resultado en vivo.
6. Activa un evento de tienda apropiado con datos de prueba seguros y confirma que el mensaje llega.
## Desactivar correo electrónico
Desactiva el cambio solo después de verificar si otras tiendas en el espacio de trabajo dependen de la misma conexión. Runner muestra **Notificaciones de correo electrónico deshabilitadas** después de que el cambio tenga éxito. Si guardar falla, Runner muestra un error y restaura el estado anterior.
Desactivar la integración no describe qué sucede con los mensajes ya enviados. Solo cambia si Runner puede usar la conexión de correo electrónico actual para eventos de tienda futuros.
## Si el correo electrónico no funciona
- Si la tarjeta sigue cargando, actualiza Aplicaciones antes de cambiar el cambio de nuevo.
- Si habilitar falla, verifica que el correo electrónico esté disponible para el espacio de trabajo e intenta una vez más.
- Si el cambio está activado pero no llega ningún mensaje, verifica el evento de tienda, dirección del destinatario, configuración del mensaje y última versión publicada.
- Verifica el correo no deseado o filtrado usando una dirección que controles; no pruebes con el pedido de un cliente real.
- Si desactivar falla, asume que el estado anterior aún está activo.
## Guías relacionadas
- [Conectar, administrar y reconectar una aplicación](./connect-manage-reconnect)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
---
# Conectar Shippo para envío
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/shippo-shipping
Las capturas y grabaciones muestran la interfaz en inglés.
Conecta Shippo cuando desees que Runner use tu cuenta de Shippo para envío y cumplimiento. La conexión usa una clave API proporcionada por Shippo.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Apps → Gestiona tu tienda → Shippo**
Necesitas:
- una cuenta de Shippo y una clave API de Shippo actual;
- autorización para conectar esa cuenta a esta tienda de Runner; y
- saber que desconectar Shippo elimina su clave y lo desactiva solo en esta tienda. Las demás tiendas conservan su propia conexión con Shippo.
No pegues la clave API en el chat o documentación.
En móvil, selecciona primero la fila del proveedor **Shippo** para abrir sus detalles, luego usa los controles en ese diálogo. Un formulario de configuración visible solo muestra dónde comenzar; los pasos de conexión y operación del proveedor a continuación se aplican después de que autorices el servicio.
## Controles y resultados de Shippo
| Control | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Conectar** | Abre la configuración de Shippo. | Runner solicita **Clave API de Shippo**. |
| **Clave API de Shippo** | Identifica tu cuenta de Shippo. | Runner verifica el formato de la clave y muestra un error mientras el valor sea inválido. |
| Icono de ojo | Te permite inspeccionar el valor para errores de escritura. | Alterna el campo entre texto oculto y visible. Ocúltalo de nuevo antes de compartir tu pantalla. |
| Diálogo **Conectar** | Envía la clave. | Si tiene éxito, Runner cierra el diálogo, borra el campo y cambia la tarjeta a conectada. |
| **Cancelar** o cerrar | Sale de la configuración sin enviar. | Runner borra la clave ingresada del diálogo. |
| Eliminar o **Desconectar** | Inicia la eliminación. | Runner abre **¿Desconectar Shippo?** para esta tienda. |
| Confirmación **Desconectar** | Elimina la conexión de esta tienda. | Runner elimina la clave API de esta tienda y desactiva Shippo en ella. Las demás tiendas no se ven afectadas. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg2lkPdDEah7FSPqAV903v8Lem6fdQJcxZEiXo)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El formulario vacío muestra dónde pertenece una clave de Shippo. Selecciona **Cancelar** para salir sin enviar credenciales; las operaciones de envío necesitan una verificación separada después de la conexión.
## Conectar Shippo
1. Abre **Proyecto → Apps**.
2. Encuentra **Shippo** y selecciona **Conectar**.
3. Copia la clave API de la cuenta de Shippo que tienes la intención de usar.
4. Pégala en **Clave API de Shippo**.
5. Si Runner reporta una clave inválida, vuelve a Shippo y copia de nuevo en lugar de editar el secreto por conjetura.
6. Selecciona **Conectar** en el diálogo.
7. Espera el mensaje de éxito y confirma que la tarjeta muestra su control de desconexión conectado.
8. Usa datos de prueba seguros para verificar el flujo de envío antes de confiar en él para pedidos de clientes.
## Desconectar o reemplazar la clave
Selecciona el control de desconexión de la tarjeta y lee **¿Desconectar Shippo?**. Confirma solo cuando sea aceptable eliminar la clave y desactivar Shippo en esta tienda. Las demás tiendas del espacio de trabajo conservan su propia conexión.
Para usar una clave diferente, desconecta la integración actual, confirma que la tarjeta ya no está conectada, luego completa el flujo de conexión con la clave de reemplazo.
## Si Shippo no se conecta
- **Clave API inválida** significa que el valor no coincide con el formato de clave de Shippo aceptado.
- **Error al conectar Shippo** significa que Runner no terminó la conexión del proveedor. Mantén la clave privada, confirma que es actual en Shippo e intenta de nuevo desde la tarjeta.
- Si el diálogo se cierra pero la tarjeta no se conecta, actualiza Aplicaciones antes de enviar de nuevo.
- Si la desconexión falla, asume que la clave existente aún está activa.
- Una tarjeta conectada no prueba que las tarifas, etiquetas, transportistas o un envío específico funcionen. Verifica esas operaciones por separado con datos de prueba seguros.
## Guías relacionadas
- [Conectar, gestionar y reconectar una aplicación](./connect-manage-reconnect)
- [Conectar cumplimiento de 4PX](./4px-fulfillment)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
---
# Conectar Shopify
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/shopify
Las capturas y grabaciones muestran la interfaz en inglés.
Conecta Shopify cuando tu escaparate o flujo de trabajo de Runner necesite acceso a una
tienda Shopify existente. Runner inicia la autorización desde el dominio `myshopify.com` de la tienda y
Shopify te pide que instales y autorices la aplicación Runner.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Apps → Gestiona tu tienda → Shopify**
También puedes elegir **Conectar Shopify** al crear una tienda desde el espacio de trabajo. Esta
guía se enfoca en la tarjeta de conexión bajo Aplicaciones.
Necesitas:
- disponibilidad de integración de Shopify en el espacio de trabajo;
- un dominio de tienda Shopify en el formato `your-store.myshopify.com`;
- permiso para instalar y autorizar la aplicación Runner en esa tienda Shopify; y
- autoridad para conectar la tienda al espacio de trabajo de Runner.
Un espacio de trabajo que ya tiene una tienda Shopify conectada puede requerirte que la desconectes
antes de conectar otra.
En móvil, selecciona primero la fila del proveedor **Shopify** para abrir sus detalles, luego usa los controles en ese diálogo. Un formulario de configuración visible solo muestra dónde comenzar; los pasos de conexión y operación del proveedor a continuación se aplican después de autorizar el servicio.
## Controles y resultados de Shopify
| Control | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Conectar** | Abre la configuración de Shopify. | Runner solicita el **Dominio de la tienda**. |
| **Dominio de la tienda** | Identifica la tienda Shopify exacta. | Runner acepta el formato `your-store.myshopify.com` y muestra un error para un dominio inválido. |
| **Continuar a Shopify** | Inicia la autorización del proveedor. | Runner te redirige a Shopify para instalar la aplicación Runner y autorizar el acceso. |
| **Cancelar** o cerrar | Se detiene antes de la autorización. | Runner cierra el diálogo y borra el dominio ingresado. |
| **Conectando...** | Muestra que el redireccionamiento de autorización está comenzando. | La acción permanece no disponible mientras Runner se va a Shopify. |
| Eliminar o **Desconectar** | Inicia la eliminación. | Runner abre **¿Desconectar Shopify?**. |
| Confirmación **Desconectar** | Elimina la conexión de Shopify de Runner. | Runner elimina el token de escaparate de Shopify de todos los proyectos del espacio de trabajo. La tienda Shopify y sus pedidos no se eliminan. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgzy8MJHxvQbMAZ2hlg7w6ye8S5vnLIHkGPOqr)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Ingresa el dominio permanente de Shopify cuando estés listo para autorizar el acceso. Este ejemplo se detiene antes de **Continuar a Shopify**.
## Conectar Shopify
1. Abre **Proyecto → Apps** y busca **Shopify**.
2. Selecciona **Conectar**.
3. Ingresa el dominio `myshopify.com` exacto de la tienda en **Dominio de la tienda**.
4. Corrige cualquier mensaje de dominio inválido antes de continuar.
5. Selecciona **Continuar a Shopify**.
6. En Shopify, verifica el nombre de la tienda y el acceso solicitado antes de autorizar la aplicación Runner.
7. Vuelve a Runner y confirma que la tarjeta de Shopify muestre su control de desconexión conectado.
8. Verifica los datos de la tienda prevista y la ruta de pago antes de realizar cambios en vivo.
## Desconectar o cambiar tiendas
Selecciona el control de desconexión y lee **¿Desconectar Shopify?**. Confirmar elimina el
token de escaparate de Shopify de todos los proyectos en el espacio de trabajo. No elimina la
tienda Shopify ni los pedidos existentes de Shopify.
Para conectar una tienda Shopify diferente, desconecta primero la conexión del espacio de trabajo existente,
confirma que la tarjeta ya no está conectada, luego repite la configuración con el dominio de la otra tienda.
## Si Shopify no se conecta
- Usa el dominio permanente `myshopify.com`, no un dominio de escaparate personalizado.
- Si Runner dice que el espacio de trabajo ya tiene una tienda conectada, revisa esa conexión
antes de eliminarla.
- Si Shopify rechaza la autorización, comienza de nuevo desde la tarjeta de Shopify.
- Si la tienda devuelta no coincide con el dominio que ingresaste, detente y verifica cuál
cuenta de Shopify y tienda están abiertas.
- Si el enlace de conexión expiró, comienza de nuevo desde **Conectar** en lugar de reutilizar la página
del proveedor anterior.
- Si Runner reporta que falta acceso requerido, revisa los permisos de la aplicación en Shopify.
- Si la desconexión falla, asume que la conexión existente sigue activa.
## Guías relacionadas
- [Conectar, administrar y reconectar una aplicación](./connect-manage-reconnect)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
---
# Conectar Stripe para pagos
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/stripe-payments
Las capturas y grabaciones muestran la interfaz en inglés.
Conecta Stripe cuando quieras que una tienda Runner publicada acepte pagos de clientes. Runner
muestra el estado de la conexión, mientras que Stripe recopila y revisa la información comercial
necesaria para el acceso a pagos y transferencias.
## Antes de empezar
**Ruta de entrada:** **Proyecto → Apps → Gestiona tu tienda → Stripe**
Después de publicar, Runner también puede mostrar **Conectar Stripe** en el flujo posterior a la publicación de la tienda. Ese botón
abre el mismo viaje de configuración de pagos.
Necesitas:
- permiso para administrar la conexión del espacio de trabajo;
- la información comercial y de identidad que Stripe solicita; y
- un navegador que permita que se abra la ventana de configuración de Stripe.
El escaparate puede publicarse mientras el proceso de pago sigue pausado o en verificación. Una URL de una tienda publicada no demuestra que los pagos estén disponibles.
En móvil, selecciona primero la fila del proveedor **Stripe** para abrir sus detalles, luego usa los controles en ese diálogo. Un formulario de configuración visible solo muestra dónde comenzar; los pasos de conexión y operación del proveedor a continuación se aplican después de que autorices el servicio.
## Controles y resultados de Stripe
| Control o estado | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **Conectar** | Inicia la incorporación de pagos. | Runner abre un flujo de configuración alojado en Stripe en una nueva ventana. |
| **Conectando...** | Muestra que Runner está preparando la cuenta de Stripe o el enlace de configuración. | La acción permanece no disponible hasta que Runner devuelva un resultado. |
| **Reconectar** | Reanuda una cuenta que existe pero no está lista. | Runner abre un enlace de incorporación nuevo para la cuenta existente. |
| **En revisión** | Muestra que Stripe está revisando los datos enviados. | La etiqueta es informativa; sigue cualquier aviso de acción adicional. |
| **Acciones de Stripe requeridas** | Enumera la información o verificación que necesita atención. | Revisa los detalles de **Vence ahora**, **Vence más tarde**, **En revisión**, **Pagos pausados** o **Retiros pausados**. |
| **Continuar Incorporación** | Completa los requisitos pendientes de Stripe. | Runner abre Stripe para la cuenta existente. |
| Icono Abrir panel de Stripe | Te permite administrar una cuenta habilitada en Stripe. | Abre el panel de Stripe conectado en una nueva pestaña. |
| Icono Eliminar | Inicia la desconexión. | Abre **¿Desconectar Stripe?** en lugar de eliminarlo inmediatamente. |
| **Desconectar** | Confirma la desconexión de Stripe de Runner. | Runner desconecta Stripe del espacio de trabajo. Los pedidos existentes no se ven afectados. |
## Conectar Stripe
1. Abre **Proyecto → Apps**.
2. Encuentra **Stripe** bajo **Gestiona tu tienda**.
3. Selecciona **Conectar**. Runner abre Stripe en una nueva ventana.
4. Completa solo los pasos mostrados por Stripe.
5. Regresa a Runner y vuelve a abrir Apps.
6. Confirma que la tarjeta muestra los controles de conexión y que Runner indica que la configuración de pagos está
lista antes de esperar que el proceso de compra acepte pagos.
7. Si ves **Reconectar**, **Continuar configuración**, **En revisión** o **Acciones de Stripe
requeridas**, sigue ese estado en lugar de empezar de nuevo.
8. Prueba el proceso de compra en línea solo cuando Runner indique que la configuración de pagos está lista.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgdRbFueMh3McYFndyrWQxNbi4IRHOVuEC8JtX)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una conexión existente puede mostrar estos controles de gestión. La captura no verifica el proceso de compra, los pagos ni los abonos; muestra dónde inspeccionar la conexión.
## Comprende el resultado
| Estado | Qué significa para ti |
| --- | --- |
| No conectado | El pago aún necesita un proveedor de pagos. |
| Se requiere reconexión | Existe una cuenta de Stripe, pero su autorización o incorporación es incompleta. |
| En revisión | Stripe ha recibido los datos, pero la cuenta todavía no está lista. |
| Se requieren acciones | Stripe necesita información específica, o los pagos o retiros pueden estar pausados. |
| Conectado | Runner reconoce la conexión de Stripe. Verifica el proceso de pago de la tienda publicada antes de anunciar que los pagos están disponibles. |
## Desconectar o reconectar
Para desconectar, selecciona el icono de eliminar, lee **¿Desconectar Stripe?**, luego elige
**Desconectar**. La confirmación indica que los pedidos existentes permanecen. Los clientes pueden seguir sin poder realizar nuevos pagos
hasta que se restaure una conexión de pago utilizable.
Para reconectar, selecciona **Reconectar** o **Continuar Incorporación**. Runner reutiliza la cuenta existente cuando es posible; no crees una segunda configuración simplemente porque se cerró la primera ventana del proveedor.
## Si Stripe no se conecta
- Si la ventana de configuración se cierra temprano, vuelve a Aplicaciones y usa **Reconectar**.
- Si Runner muestra **Acciones de Stripe requeridas**, completa los requisitos del proveedor enumerados.
- Si la cuenta permanece **En revisión**, no crees repetidamente nuevos intentos de incorporación.
- Si Runner muestra un error de conexión o enlace, reintenta desde la tarjeta de Stripe después de confirmar
que tu navegador permite la nueva ventana.
- Nunca envíes documentos de identidad, IDs de cuenta o detalles de pago en el chat de Runner.
## Guías relacionadas
- [Conectar, administrar y reconectar una aplicación](./connect-manage-reconnect)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)
- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
---
# Solucionar problemas de conexión de aplicaciones
Source: https://www.runnerai.com/docs/es/guides/apps-and-integrations/troubleshooting
Las capturas y grabaciones muestran la interfaz en inglés.
Usa esta guía cuando una aplicación no carga, se conecta, se reconecta, guarda su acceso a herramientas o
se desconecta como se esperaba. Comienza desde el estado que Runner realmente muestra en lugar de repetir un
flujo de proveedor ciegamente.
**Ruta de acceso:** **Proyecto → Apps**
## Antes de empezar
1. Confirma que abriste Aplicaciones para el proyecto y el espacio de trabajo correctos.
2. Borra **Buscar herramientas** y cualquier filtro de categoría de aplicaciones del Agente.
3. Actualiza la página una vez y espera a que se carguen los estados de conexión.
4. Lee el estado exacto de la tarjeta: **Conectar**, **Conectando...**, **Conectado**, **Reconectar**,
**En revisión** o un aviso de acción requerida.
5. Abre solo la acción de recuperación que corresponda a ese estado.
6. Nunca incluyas una clave API, un secreto, un documento de identidad, datos de pago ni una URL de callback completa
del proveedor en un mensaje de soporte o una captura de pantalla.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgJFpud5MziL9zFEdkGCVveD1jTZUlSay3IctK)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
La búsqueda filtra el catálogo de herramientas. Si no aparece la que necesitas, borra la búsqueda y los filtros antes de solicitar una aplicación; un resultado de búsqueda no es una conexión autorizada.
## Controles y resultados importantes
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Borrar búsqueda** | Elimina la búsqueda actual de Aplicaciones de Agente para que el catálogo disponible pueda aparecer de nuevo. |
| **Conectar** / **Conectar y autorizar** | Abre el flujo de configuración o autorización externa para esa aplicación. |
| **Reconectar**, cuando se muestra | Reinicia la autorización para una conexión de proveedor existente. |
| **Reintentar** | Repite la solicitud fallida de catálogo, lista de herramientas o conexión mostrada por el panel actual. |
| **Continuar incorporación** | Vuelve al flujo de incorporación de Stripe existente cuando se requiere acción. |
| **Desconectar** | Abre una confirmación o inicia el flujo de eliminación documentado; verifica el estado guardado antes de cambiar las credenciales del lado del proveedor. |
## Tabla de síntoma y recuperación
| Lo que ves | Significado probable | Acción segura siguiente |
| --- | --- | --- |
| La aplicación falta | La búsqueda, una categoría, el acceso al espacio de trabajo o una característica condicional la está ocultando. | Borra la búsqueda, elige **Todo**, luego confirma que la característica está disponible para este espacio de trabajo. |
| La tarjeta sigue cargando | Runner no ha resuelto la conexión guardada. | Actualiza Aplicaciones una vez. Evita enviar otra conexión mientras el estado es desconocido. |
| **No se encontraron aplicaciones** | Ninguna Aplicación de Agente coincide con los filtros actuales. | Selecciona **Borrar búsqueda**. |
| **Conectar** no hace nada | Un campo requerido está vacío o es inválido, o el flujo del proveedor no pudo iniciarse. | Lee los errores de campo, vuelve a copiar el valor requerido y permite ventanas emergentes del proveedor cuando sea aplicable. |
| **Conectando...** no termina | La autorización externa fue cerrada, bloqueada o nunca devolvió un resultado. | Vuelve a Aplicaciones, actualiza el estado, luego usa **Reconectar** si Runner lo ofrece. |
| El proveedor dice éxito pero Runner no | Runner no ha confirmado una conexión utilizable. | Reabre Aplicaciones. Trata solo **Conectado** como éxito; usa **Reconectar** en lugar de crear duplicados. |
| **Reconectar** | La autorización existente necesita atención. | Selecciónalo y completa el flujo del proveedor de nuevo. |
| **En revisión** | Stripe está revisando los detalles enviados. | Sigue los avisos de acción; no inicies otra cuenta simplemente para eliminar la etiqueta. |
| **Acciones de Stripe requeridas** | Stripe necesita información o ha pausado una capacidad. | Revisa los detalles de **Vence ahora**, **Vence más tarde**, **En revisión**, pago y transferencia, luego usa **Continuar incorporación** cuando se muestre. |
| Clave API o secreto rechazado | El valor es incorrecto, expirado, de la cuenta equivocada o no aceptado para esta integración. | Vuelve a copiarlo del proveedor. No edites secretos por conjetura. |
| Dominio de Shopify inválido | El valor no es el dominio permanente de la tienda Shopify. | Usa `your-store.myshopify.com`, no un dominio de escaparate personalizado. |
| La ventana de autorización de Aplicación de Agente está bloqueada | El navegador impidió el flujo externo. | Permite ventanas emergentes para Runner e inicia **Conectar y autorizar** de nuevo. |
| Las herramientas de Aplicación de Agente no se cargan | Runner no pudo recuperar la lista de herramientas de esa aplicación. | Selecciona **Reintentar** en **Detalles de la app**. |
| El cambio de herramienta reporta falla | La nueva configuración de herramienta no fue guardada. | Espera a que el cambio se actualice, confirma su estado actual, luego reintenta una vez. |
| La desconexión reporta falla | Runner no confirmó la eliminación. | Asume que la conexión existente sigue activa y reabre Aplicaciones antes de intentar de nuevo. |
## Verificaciones específicas del proveedor
### Stripe
- Continúa un intento de incorporación existente con **Reconectar** o **Continuar incorporación**.
- Lee los requisitos de acción en lugar de confiar solo en el color de la tarjeta.
- Un escaparate publicado aún puede tener pagos pausados o no disponibles.
- Usa la acción del panel de Stripe solo después de que Runner tenga una cuenta asociada.
### Correo electrónico
- Un cambio de cambio fallido vuelve al estado guardado.
- Un cambio habilitado no prueba que un correo electrónico particular fue entregado.
- Verifica el evento de tienda, destinatario, configuración de correo electrónico y versión publicada actualmente
con datos de prueba seguros.
### Shippo
- Vuelve a copiar la clave API de Shippo de la cuenta prevista.
- Una tarjeta conectada no verifica tarifas, transportistas, etiquetas o creación de envíos.
### Shopify
- Usa el dominio permanente `myshopify.com`.
- Si un espacio de trabajo ya tiene una tienda conectada, revísala antes de desconectar.
- Reinicia la autorización cuando el enlace de conexión expire o la tienda devuelta no
coincida con el dominio que ingresaste.
### CJ Dropshipping
- Confirma que la clave API pertenece a la cuenta de CJ que pretendes usar.
- Tras desconectarla, las búsquedas, importaciones, compras y operaciones futuras de CJ con tu cuenta de comerciante quedan bloqueadas hasta que restaures una conexión válida.
- Vuelve a conectar la misma cuenta de CJ y revisa las importaciones existentes. Si la identidad del proveedor o los datos actuales de un artículo ya no coinciden, elimínalo e impórtalo de nuevo.
### 4PX
- Confirma que la clave API y el secreto pertenecen a la misma cuenta y están en los campos correctos.
- Una tarjeta conectada no prueba que un destino u orden sea elegible para cumplimiento.
### Aplicaciones de Agente
- La sección completa o una aplicación individual puede estar condicionalmente no disponible.
- Borra filtros antes de tratar una aplicación como ausente.
- Revisa los cambios de herramienta antes de reconectar; no otorgues más acceso simplemente para facilitar la configuración.
## La desconexión falló o produjo un resultado incierto
1. Mantén la cuenta del proveedor y las operaciones actuales de la tienda sin cambios.
2. Reabre **Proyecto → Apps** y verifica el estado de la tarjeta.
3. Si aún muestra conectado, trata la conexión como activa.
4. No elimines credenciales del lado del proveedor hasta que entiendas si el pago en vivo activo, correo electrónico, envío, proveedor o trabajo de cumplimiento aún depende de ellas.
5. Reintenta la desconexión de Runner solo después de que el estado sea claro.
## Pide ayuda de forma segura
Proporciona:
- el nombre de la aplicación;
- el estado visible exacto y el texto de error;
- si el problema ocurre mientras se conecta, se devuelve, se administran herramientas o se desconecta;
- la URL del proyecto sin valores de consulta secretos; y
- una captura de pantalla segura para la privacidad si muestra materialmente el problema.
No proporciones la clave API real, secreto, contraseña del proveedor, documento de identidad, detalles de pago,
datos del cliente o parámetros de autorización ocultos.
Si la herramienta sigue sin aparecer después de borrar la búsqueda y los filtros, usa **Solicitar una app** (o **Solicitar esta app** en el resultado vacío). El formulario solicita compatibilidad con un proveedor; no lo conecta. Para problemas con CJ, abre [Configuración del proveedor de Dropshipping](/es/guides/apps-and-integrations/cj-dropshipping).
## Guías relacionadas
- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
- [Conectar, administrar y reconectar una aplicación](./connect-manage-reconnect)
- [Conectar y controlar Aplicaciones de Agente](./agent-apps)
---
# Automatizar, probar y crear
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create
Abre **Crecer** para Automatizaciones, Creative Studio, Biblioteca de medios y Anuncios. Abre **Medir** para Simulación y Experimentos. Estas guías te llevan desde la configuración hasta la revisión del trabajo resultante.
> **Disponibilidad:** Cada función en esta sección puede depender de un plan, acceso al espacio de trabajo, rol, estado de tienda, créditos, datos o conexión de proveedor. Una entrada faltante es un estado de disponibilidad, no prueba de que el proyecto esté roto.
| Objetivo | Comienza aquí |
| --- | --- |
| Encuentra y comprende el trabajo recurrente | [Automatizaciones](/es/guides/automate-test-and-create/automations) |
| Activa una automatización o personaliza su correo electrónico | [Crear y gestionar automatizaciones](/es/guides/automate-test-and-create/create-and-manage-automations) |
| Configura una prueba de comprador o, cuando esté disponible, una predicción de campaña | [Simulaciones](/es/guides/automate-test-and-create/simulations) |
| Lee viajes, embudo, resultados y recomendaciones | [Ejecuciones de simulación y resultados](/es/guides/automate-test-and-create/simulation-runs-and-results) |
| Inicia un experimento de tienda controlado | [Experimentos](/es/guides/automate-test-and-create/experiments) |
| Lee rendimiento y decide qué aplicar | [Medición de experimentos](/es/guides/automate-test-and-create/experiment-measurement) |
| Genera o edita imágenes y videos | [Creative Studio](/es/guides/automate-test-and-create/creative-studio) |
| Encuentra y reutiliza medios generados | [Biblioteca de medios](/es/guides/automate-test-and-create/media-library) |
| Conecta cuentas de anuncios y comprende campañas | [Runner Ads](/es/guides/automate-test-and-create/runner-ads) |
| Revisa rendimiento creativo y guarda inspiración | [Creatividades publicitarias y tendencias](/es/guides/automate-test-and-create/ad-creatives-and-trending) |
---
# Creatividades publicitarias y tendencias
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/ad-creatives-and-trending
Las capturas y grabaciones muestran la interfaz en inglés.
Creativos te ayuda a comparar medios de campañas conectadas, mientras que Tendencias te ayuda a descubrir y organizar inspiración publicitaria pública.
> **Condicional:** Ambas páginas están detrás de la disponibilidad de Runner Ads y el acceso al plan. El rendimiento creativo necesita una cuenta conectada compatible y datos de campaña devueltos. **Tendencias** puede buscar en la biblioteca pública de Meta o TikTok sin conectar tu cuenta de anuncios; sus resultados dependen de la fuente de descubrimiento externa.
## Rutas de entrada
- Proyecto de tienda → **Crecer** → **Anuncios** → **Creativos**.
- Proyecto de tienda → **Crecer** → **Anuncios** → **Tendencias**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEooJlJchdR6T0uwqnz73letZimQpFvYfSrhL)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Tendencias abre una búsqueda en la biblioteca pública. Los resultados de búsqueda y el rendimiento de la campaña conectada son conjuntos de datos diferentes.
## Antes de empezar
- Confirma que el espacio de trabajo y el plan pueden abrir Runner Ads.
- Conecta una cuenta de Google o Meta autorizada antes de esperar datos de rendimiento creativo.
- Elige una pregunta de rendimiento o tema de inspiración para que los filtros sigan siendo útiles.
- Trata los datos de tendencias externos como material de referencia, no como el resultado medido de tu tienda.
## Controles de creatividades y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Rango de tiempo | Actualiza las métricas creativas de la semana pasada, mes o período reciente más amplio. |
| Selector de cuenta | Filtra datos creativos cuando hay múltiples cuentas compatibles conectadas. |
| Ordenar | Ordena tarjetas por gasto, retorno de la inversión publicitaria, clics, impresiones, ingresos, puntuación de clic o puntuación de conversión. |
| Fichas de métrica | Añade, elimina o reordena las métricas mostradas en tarjetas creativas. |
| Tarjeta creativa | Abre la vista previa creativa y los detalles de rendimiento disponibles. |
## Revisa creatividades conectadas
1. Abre **Anuncios** → **Creativos**.
2. Si aparece el aviso de conexión, primero conecta la cuenta de Google o Meta autorizada.
3. Selecciona la ventana de informes y la cuenta.
4. Elige el orden que coincida con tu pregunta.
5. Mantén un pequeño conjunto de fichas de métrica visibles para que las comparaciones sigan siendo legibles.
6. Abre una tarjeta creativa para inspeccionar el activo y sus métricas disponibles.
7. Compara varios creatividades antes de decidir que una imagen o video causó el resultado.
## Controles de tendencias y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Meta** / **TikTok** | Cambia la biblioteca de anuncios externa siendo explorada. |
| **Buscar** de palabra clave | Solicita anuncios que coincidan con la palabra clave enviada. |
| País, medios, estado o filtros de tiempo | Reduce la biblioteca actual cuando es compatible con esa fuente. |
| Ordenar | Reordena resultados usando la recencia disponible, impresión, publicación o señal de alcance. |
| **Borrar** | Elimina filtros activos y vuelve a la consulta de biblioteca predeterminada. |
| Tarjeta de anuncio | Abre una vista previa más grande con los detalles devueltos por la fuente. |
| **Índice de impresiones** en un detalle de Meta | Muestra el índice no negativo suministrado para esa instantánea externa cuando uno está disponible. No es el rendimiento de campaña medido de tu tienda. |
| Estrella / **Save to collection** | Abre colecciones existentes para la instantánea de anuncio. |
| **New collection** | Crea una colección nombrada y guarda el anuncio seleccionado en ella después del éxito. |
| **Collections** | Abre inspiración guardada; seleccionar una colección muestra sus instantáneas de anuncio guardadas. |
| **Volver a Tendencias** | Vuelve de colecciones a la vista de descubrimiento. |
## Guarda inspiración publicitaria
1. Abre **Anuncios** → **Tendencias**.
2. Elige **Meta** o **TikTok**.
3. Busca un producto, audiencia o tema de mensaje.
4. Reduce resultados con solo los filtros necesarios para la pregunta.
5. Abre un anuncio para inspeccionarlo.
6. Selecciona la estrella para abrir **Save to collection**.
7. Elige una colección existente o crea una nueva claramente nombrada.
8. Abre **Collections** para confirmar que la instantánea fue guardada.
## Solución de problemas
| Estado | Significado y paso siguiente |
| --- | --- |
| Aviso de conexión en Creatividades | Ninguna cuenta de rendimiento compatible está conectada. Completa la conexión primero. |
| Cuadrícula creativa vacía | La cuenta, período o proveedor seleccionado no devolvió creatividades. Amplía el filtro y confirma que existen campañas. |
| Resultados de tendencias vacíos | Borra filtros o usa una palabra clave más amplia; la fuente puede no tener datos coincidentes. |
| El detalle de Meta no tiene **Índice de impresiones** | La instantánea externa actual no tiene un valor utilizable. Falta no significa cero. |
| Colección vacía | Ninguna instantánea guardada está en esa colección. Vuelve a Tendencias y guarda un anuncio. |
| Guardar falló | La instantánea o colección no fue confirmada. Reintenta después de recargar la tarjeta de fuente. |
| Anuncio de tendencia fuerte | Es inspiración, no prueba de que el mismo creativo funcionará para tu tienda. Crea y mide tu propia campaña por separado. |
## Verifica lo que representa la tarjeta
En **Creativos**, confirma la cuenta y el período seleccionados antes de comparar las métricas de una tarjeta. En **Tendencias**, confirma la biblioteca externa y los filtros antes de tratar un anuncio como inspiración relevante.
**Punto de control:** Un elemento de inspiración guardado aparece en la colección seleccionada después de un guardado exitoso. Es una instantánea de referencia, no una campaña que hayas publicado o un resultado medido para tu tienda.
## Guías relacionadas
- [Runner Ads](./runner-ads)
- [Creative Studio](./creative-studio)
- [Biblioteca de medios](./media-library)
---
# Automatizaciones
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/automations
Las capturas y grabaciones muestran la interfaz en inglés.
Las automatizaciones te ayudan a encontrar trabajo recurrente que Runner puede realizar cuando ocurre un desencadenante enumerado.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **Automatizaciones**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgUokxtnwmWbL01zqS4swQkOHahZevAM9fnVpR)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Las tarjetas de automatización muestran su estado configurado. Una insignia En vivo por sí sola no confirma una ejecución o una entrega de correo electrónico.
## Antes de empezar
- **Order Confirmation**, **Welcome Email** y **Account Closed Email** funcionan en todos los planes. Las demás automatizaciones necesitan un plan que incluya automatizaciones; sin él, al activarlas se abre un aviso para mejorar el plan.
- Cada tarjeta de automatización tiene su propia disponibilidad y estado.
- Activar una automatización no la ejecuta inmediatamente; espera el desencadenante descrito por esa automatización.
## Controles de biblioteca y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Buscar** | Filtra tarjetas por palabras en el nombre o descripción de la automatización. |
| **Todo** o una categoría | Muestra cada automatización o solo tarjetas de categorías como **Gestión de clientes**, **Operaciones de la tienda** o **Informes y análisis**. Las categorías disponibles dependen de la biblioteca mostrada. |
| Filtro de estado | Muestra tarjetas **Todos los estados**, **En vivo**, **En pausa**, **Bloqueado por el plan** o **Próximamente**. |
| Cambio de tarjeta | Solicita **En vivo** cuando está activado y **En pausa** cuando está desactivado, si la automatización está disponible. |
| Botón de información | Abre **Detalles de la automatización** con descripción, estado, categoría y última ejecución. |
| Botón de edición | Abre **Redactar correo** para automatizaciones que admiten una plantilla de correo electrónico. |
| **Reintentar** | Recarga la biblioteca después de una falla de carga. |
> **Tamaño de pantalla:** Los botones de información y edición de correo electrónico se muestran en diseños de escritorio más amplios. Si no los ves en una pantalla de tamaño de teléfono, reabre Automatizaciones en una ventana más amplia.
## Encuentra la automatización correcta
1. Abre **Automatizaciones**.
2. Busca el resultado que necesitas, como un mensaje de cliente o informe.
3. Reduce la lista con una categoría cuando el resultado es amplio.
4. Usa el filtro de estado para encontrar elementos en vivo o bloqueados.
5. Selecciona el botón de información en una tarjeta.
6. Lee la descripción, estado, categoría y última ejecución antes de cambiar el cambio.
7. Si aparece un botón de edición de correo electrónico, revisa la plantilla antes de habilitar la automatización.
## Significados de estado
| Estado | Significado y paso siguiente |
| --- | --- |
| **En vivo** | La automatización está habilitada y espera su desencadenante. Esto no significa que ya haya sido ejecutada. |
| **En pausa** | La automatización está disponible pero no iniciará nuevo trabajo desencadenado hasta que se habilite. |
| **Bloqueado por el plan** | El plan actual impide que la automatización se ejecute. Revisa el acceso antes de confiar en ella. |
| **Próximamente** | La tarjeta es visible para descubrimiento pero no puede ser habilitada. |
| **Nunca ejecutado** o **Última ejecución —** | No hay tiempo de ejecución completado disponible para este proyecto. |
## Solución de problemas
- Si ninguna tarjeta coincide, borra **Buscar**, elige **Todo** y elige **Todos los estados**.
- Si un cambio está deshabilitado, lee el estado de la tarjeta y la razón de disponibilidad.
- Si un cambio vuelve a su estado anterior, lee el mensaje de error y recarga la biblioteca antes de reintentar.
- Si la biblioteca no se carga, selecciona **Reintentar** una vez y contacta al soporte si se repite.
## Punto de control antes de habilitar
El panel de detalles debería explicar el disparador de la automatización seleccionada y su estado actual. Ciérralo para volver a la misma tarjeta. Una insignia **En vivo** autoriza futuros disparadores; utiliza la información de la última ejecución y el mensaje o informe resultante real para verificar la ejecución.
### Ver: inspeccionar una automatización pausada
La grabación filtra a Pausado, abre los detalles de Revisión de solicitud, luego los cierra. No habilita la automatización, edita su correo electrónico ni envía un mensaje.
## Guías relacionadas
- [Crear y administrar automatizaciones](./create-and-manage-automations)
- [Runner Ads](./runner-ads)
- [Descripción general de análisis](../analytics-and-seo/analytics-overview)
---
# Crear y gestionar automatizaciones
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/create-and-manage-automations
Las capturas y grabaciones muestran la interfaz en inglés.
Usa los controles de automatización para decidir qué flujos de trabajo disponibles pueden ejecutarse y qué correos electrónicos de clientes compatibles deben contener.
> **Condicional:** La página actual gestiona tarjetas de automatización proporcionadas por Runner; no presenta un generador de flujos de trabajo en blanco para crear ninguna automatización arbitraria. La edición de correo electrónico aparece solo en tarjetas compatibles.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **Automatizaciones** → elige una tarjeta.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgu7RtXsbqHvBxClMcD3zm6P2XTVQw91N0sga5)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Revisión de solicitud está pausada y no muestra tiempo de última ejecución. Inspecciona estos detalles antes de habilitar la automatización.
## Antes de empezar
- Lee la descripción de la automatización y el activador antes de habilitarla.
- Confirma que el plan actual permite la automatización.
- Para correo electrónico de cliente, verifica el remitente, asunto, variables, enlaces y detalles de marca antes de guardar.
- Guardar una plantilla cambia su configuración almacenada; no envía un correo electrónico de prueba o cliente por sí solo.
## Controles de tarjeta y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Activar | Cambia el estado solicitado a **En vivo**. Los activadores coincidentes futuros pueden iniciar la automatización. |
| Desactivar | Cambia el estado solicitado a **En pausa**. Los nuevos activadores coincidentes no deben iniciarlo. |
| Botón de información | Abre la descripción de la automatización, estado, categoría, razón de disponibilidad y hora de última ejecución. |
| Botón de edición de correo electrónico | Abre **Redactar correo** cuando la tarjeta tiene una plantilla personalizable. |
> **Tamaño de pantalla:** Los botones de información y edición de correo electrónico se muestran en diseños de escritorio más amplios. Si están ausentes en una pantalla de tamaño de teléfono, usa una ventana más amplia antes de seguir los pasos a continuación.
## Controles de correo electrónico y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **De** | Cambia el valor del remitente almacenado para esta plantilla. |
| **Asunto** | Edita el asunto del correo electrónico. |
| **Cuerpo** | Edita el contenido del correo electrónico. |
| **Insertar variable** | Abre los marcadores de posición compatibles e inserta el seleccionado en la posición actual. |
| **Vista previa** | Representa una vista previa del borrador actual; no envía el correo electrónico. |
| URL del logotipo y color de acento | Actualiza las entradas de marca utilizadas por la plantilla. |
| **Guardar** | Almacena la configuración de correo electrónico actual y cambia **Sin guardar** a **Guardado** después del éxito. |
| Vista previa **Reintentar** | Intenta representar el borrador actual nuevamente después de un fallo de vista previa. |
## Habilita y personaliza de forma segura
1. Selecciona el botón de información y confirma cuándo se ejecuta la automatización.
2. Si hay un botón de edición de correo electrónico disponible, abre **Redactar correo**.
3. Edita el asunto y el cuerpo en lenguaje simple orientado al cliente.
4. Inserta solo variables ofrecidas por el menú.
5. Selecciona **Vista previa** y verifica el contenido representado.
6. Vuelve a **Editar** si falta algo o no está claro.
7. Selecciona **Guardar** y espera a **Guardado**.
8. Cierra el compositor, luego activa el interruptor de la tarjeta solo cuando el activador y el mensaje estén listos.
9. Vuelve más tarde para verificar el valor de **Última ejecución**; una insignia **En vivo** por sí sola no prueba la ejecución.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| **Sin guardar** | El borrador difiere de la plantilla almacenada. Guarda o cierra sin depender del borrador. |
| **Guardado** | La configuración de plantilla actual fue almacenada. La acción de guardar no envió ningún correo electrónico. |
| Vista previa fallida | Selecciona **Reintentar**. Si se repite, verifica la sintaxis de variables y preserva tu borrador antes de recargar. |
| Plantilla de correo electrónico no encontrada | Esta tarjeta no tiene personalización recuperable. Cierra el diálogo y recarga la biblioteca. |
| Alternancia bloqueada | Verifica **Bloqueado por el plan**, **Próximamente** o la razón de disponibilidad en la tarjeta. |
## Revisa el correo electrónico antes de guardar
En **Vista previa**, verifica el asunto, la marca, los enlaces y la representación de variables. Regresa a **Editar** para corregir el borrador. Cerrar sin guardar deja la plantilla almacenada en su lugar.
**Punto de control:** **Guardado** confirma la configuración de la plantilla. La entrega necesita un disparador coincidente y una ejecución completada; las acciones de vista previa y guardar no envían un correo electrónico al cliente.
### Ver: inspeccionar una automatización pausada
La grabación filtra a Pausado, abre los detalles de Revisión de solicitud, luego los cierra. No habilita la automatización, edita su correo electrónico ni envía un mensaje.
## Guías relacionadas
- [Automatizaciones](./automations)
- [Biblioteca de medios](./media-library)
- [Solucionar problemas de datos y publicación](../analytics-and-seo/troubleshoot-data-and-publication)
---
# Creative Studio
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/creative-studio
Las capturas y grabaciones muestran la interfaz en inglés.
Creative Studio te proporciona un lienzo visual para crear medios de campaña y producto a partir de un mensaje, imágenes seleccionadas o ambas.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **Creative Studio**. El destino abre el lienzo de **Creative Studio**.
Cuando la función está habilitada, una vista de detalle de imagen generada en el chat de Runner también puede ofrecer **Abrir imagen generada en Creative Studio**, que abre el lienzo con esa salida seleccionada.
El selector de modelo de imagen a imagen muestra los requisitos del modelo y la financiación antes de Ejecutar. Abrir el selector no inicia la generación.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggKevjc4IC4NbwvYeKD2nM5xTZ76dBjp0auiy)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Se selecciona una imagen de ejemplo existente en el lienzo, con prompt, modelo y controles de Ejecutar. Revisa estas entradas antes de iniciar la generación.
## Antes de empezar
- Decide si necesitas una imagen nueva, una edición de imagen, un video nuevo o animación a partir de una imagen.
- Verifica la entrada, salida, calidad, límites y etiqueta de financiación del modelo seleccionado. El selector puede mostrar **Créditos de Runner** o tu propia clave Fal como fuente de financiación; elige la fuente que pretendes usar.
- Para una edición, agrega la imagen de origen al lienzo y selecciónala primero.
- Mantén el activo original disponible hasta que apruebes el resultado.
## Controles de generación y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Mensaje | Describe la imagen, edición, movimiento o video que deseas. |
| Botón de modelo | Abre **Elegir un modelo**, con cuatro pestañas de modalidad: texto a imagen, imagen a imagen, texto a video e imagen a video. |
| Búsqueda y filtros de modelo | Reduce los modelos por nombre, tipo de generación o caso de uso. |
| Estrella en un modelo | Agrega o elimina ese modelo de **Favoritos**. |
| Cargar imágenes | Abre el selector de archivos y agrega imágenes compatibles para usar en el lienzo. |
| **Ejecutar** | Inicia un trabajo con el mensaje actual, modelo seleccionado e entradas de lienzo seleccionadas. |
| **Generaciones** | Abre la cola de fondo con trabajos en ejecución, completados, fallidos e interrumpidos. |
| **Borrar completadas** | Elimina entradas de cola completadas de la vista de cola; no elimina medios guardados. |
## Controles de lienzo y activos
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Bandeja de activos | Abre activos generados de la conversación actual o todos los activos del proyecto. |
| Búsqueda de activos | Filtra la bandeja de activos. |
| **Añadir al lienzo** | Coloca el activo disponible seleccionado en el lienzo. |
| **Enfocar en el lienzo** | Mueve la ventana gráfica a ese activo cuando ya está presente. |
| **Biblioteca de medios** | Abre la página completa de medios guardados. |
| Deshacer / Rehacer | Revierte o reaplica cambios de lienzo compatibles. |
| Controles de zoom y minimapa | Cambia la ventana gráfica sin cambiar el medio en sí. |
| Selecciona elemento(s), luego haz clic derecho | Abre el menú contextual del lienzo. Las acciones disponibles cambian según el número y tipo de elementos seleccionados. |
| **Herramientas de producto** | Para selecciones de imagen compatibles, abre Fotografía de producto, Escena de producto, Colocación de producto, Sostenimiento de producto, Prueba virtual, Eliminar o Reemplazar fondo, Reluminar, Concepto de material y Ampliar flujos de trabajo. Las herramientas de una imagen y dos imágenes permanecen deshabilitadas hasta que se seleccione el número requerido. |
| **Establecer como miniatura del producto** | Con una imagen seleccionada, abre el selector de producto. Elegir **Usar como miniatura** carga la imagen y actualiza la miniatura y lista de imágenes de ese producto. |
| **Extender video** / **Eliminar fondo de video** | Con un video seleccionado, abre el flujo de trabajo de video correspondiente cuando está disponible. |
| **Exportar GIF** | Convierte el video seleccionado en un GIF descargable; un error de conversión deja el video original sin cambios. |
| Duplicar / Recortar / Combinar imágenes / Orden de capas / Descargar | Aplica la operación de lienzo seleccionada cuando se cumplen sus requisitos de recuento de imágenes y tipo de medio. |
| **Eliminar** | Elimina solo el elemento seleccionado del lienzo. No elimina el activo guardado de la Biblioteca de medios. |
## Crear medios
1. Abre **Creative Studio**.
2. Elige un modelo y lee sus requisitos de entrada.
3. Para texto a imagen o texto a video, deja la selección del lienzo vacía y escribe un mensaje específico.
4. Para la edición de imágenes, usa **Añadir al lienzo** en la imagen fuente, selecciónala, luego elige un modelo de **Imagen a Imagen**. Por ejemplo, **Nano Banana 2 Edit** aparece cuando está disponible; inspecciona sus requisitos en lugar de asumir que todos los modelos toman las mismas entradas.
5. Para imagen a video, selecciona la imagen única que el modelo animará.
6. Revisa la etiqueta de financiación del modelo y el aviso de crédito actual.
7. Selecciona **Ejecutar** una sola vez.
8. Abre **Generaciones** para seguir el progreso mientras continúas con otro trabajo del lienzo.
9. Inspecciona la salida completada en el lienzo. Los medios generados se guardan en la biblioteca de medios después de una generación exitosa.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Nada en cola | No hay generación de fondo actual listada. |
| Pendiente o en ejecución | El trabajo aún se está procesando. Continúa trabajando y espera a que se complete. |
| Exitoso | La salida generada está disponible en el lienzo y en medios guardados. Revísala antes de reutilizarla. |
| Fallido | El trabajo no produjo la salida esperada. Lee el mensaje, corrige entradas e intenta deliberadamente. |
| Interrumpido | El procesamiento terminó antes del éxito. Confirma financiación y acceso del proveedor antes de reintentar. |
| Ejecutar no disponible | Verifica mensaje, imágenes seleccionadas, recuento de entrada exacto, acceso al modelo y créditos. |
| Activo no disponible | Intenta cargar la bandeja nuevamente o elige otro activo guardado; no dependas de una vista previa rota. |
## Revisa la configuración sin iniciar un trabajo
1. Abre **Elegir un modelo** y compara su tipo de entrada compatible con tu tarea.
2. Cierra el selector después de seleccionar un modelo apropiado.
3. Verifica el prompt y las imágenes seleccionadas en el lienzo.
4. Lee el aviso de financiación antes de **Ejecutar**.
**Punto de control:** El modelo, el prompt y la selección de fuente describen el trabajo previsto. La generación comienza solo después de **Ejecutar**; la cola luego proporciona el estado, y una salida completada aún necesita tu revisión visual.
### Ver: revisar un modelo de edición de imágenes
La grabación inspecciona los requisitos de imagen a imagen y regresa a una imagen de ejemplo existente en el lienzo. No inicia una generación.
## Guías relacionadas
- [Biblioteca de medios](./media-library)
- [Creatividades publicitarias y tendencias](./ad-creatives-and-trending)
- [Runner Ads](./runner-ads)
---
# Medición de experimentos
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/experiment-measurement
Las capturas y grabaciones muestran la interfaz en inglés.
La medición de experimentos te ayuda a comparar el control con la variación activa antes de tomar una decisión de tienda en vivo.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Experimentos** → selecciona un experimento → **Rendimiento**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El requisito previo de publicación debe resolverse antes de que un experimento real pueda recopilar datos. No se muestran mediciones de experimentos aquí.
## Antes de empezar
- Confirma el objetivo del experimento y la asignación de tráfico actual.
- Espera una muestra útil antes de interpretar cambios de porcentaje pequeños.
- Revisa los cambios de variación en la pestaña **Experimentos** antes de considerar **Aplicar cambios**.
- Pregunta a un propietario del espacio de trabajo antes de una acción que implemente cambios o detenga pruebas en vivo.
## Controles de rendimiento y resultados
| Control o sección | Qué sucede o aparece |
| --- | --- |
| **Experimentos** | Abre mensajes de ciclo, planes, vista previa, cambios y solicitudes pendientes. |
| **Rendimiento** | Abre tiempo de ejecución, tamaño de muestra, división de tráfico, gráfico y tabla de métricas. |
| Selector de métrica | Cambia el gráfico a una medida compatible como conversión, agregar al carrito, pago, compra, valor de pedido, ingresos por visitante, clics en banner, abandono de carrito o tasa de error. |
| Gráfico de control / Variación | Compara la serie registrada para la versión original y de experimento. |
| Control de tráfico → **Actualizar** | Guarda una nueva asignación de experimento dentro del rango permitido. |
| **Información de IA** → **Permitir** | Aprueba la sugerencia de tráfico mostrada. |
| **Información de IA** → **Cancelar** | Descarta esa sugerencia sin aprobarla. |
| **Pregúntale a Runner** | Envía un mensaje dentro del espacio de trabajo del experimento. |
| **Ver plan** | Abre el plan de ciclo actual y la lista de tareas pendientes. |
## Revisa la medición
1. Abre **Rendimiento**.
2. Confirma tiempo de ejecución, tamaño de muestra y división de tráfico antes de leer la tendencia.
3. Selecciona la métrica que coincida con el objetivo del experimento.
4. Compara control y variación durante el mismo período.
5. Verifica métricas de apoyo para error, abandono o compensaciones de ingresos.
6. Vuelve a **Experimentos** y revisa los cambios exactos que produjeron la variación.
7. Lee cualquier solicitud de **Información de IA** antes de permitir un cambio de tráfico.
8. Elige continuar midiendo, ajustar tráfico, detener o prepararse para aplicar solo después de revisar tanto el comportamiento como la implementación.
## Acciones de alto impacto
| Acción | Qué hace el primer clic | Qué significa la confirmación |
| --- | --- | --- |
| **Aplicar cambios** | Abre **Aplicar cambios de experimento**. | Confirmar aplica los cambios del experimento a la ruta principal de la tienda e inicia la implementación de producción. Revisa el experimento nombrado primero. |
| **Detener** | Abre **Detener experimento** con advertencias. | Confirmar finaliza el experimento actual. Si la autorización de experimento permanece habilitada, Runner puede iniciar otro; usa la configuración del proyecto cuando tengas la intención de deshabilitar completamente los experimentos. |
| Tráfico **Actualizar** | Envía la nueva asignación. | El tráfico elegible futuro usa la división actualizada después del éxito. |
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Sin datos de ciclo | La medición aún no ha producido un resultado de ciclo. Mantén el experimento en ejecución o inspecciona su estado. |
| No se pueden cargar métricas | Recarga **Rendimiento** e intenta más tarde; no apliques cambios de datos faltantes. |
| Resultado plano o mixto | La evidencia disponible no muestra una mejora clara. Continúa midiendo o detente sin aplicar. |
| Actualización de tráfico fallida | El valor actual no fue almacenado. Recarga antes de intentar una asignación válida nuevamente. |
| Aplicar falló | No se confirmó ninguna aplicación de producción exitosa. Preserva el error y verifica la tienda en vivo antes de reintentar. |
## Punto de control antes de cambiar el tráfico
Deberías poder nombrar el objetivo, el tamaño de la muestra, la división activa y la variación exacta antes de elegir una acción. Si alguno de los brazos no tiene datos útiles, mantén el resultado inconcluso. Abrir **Rendimiento** o un diálogo de confirmación no detiene el experimento ni aplica cambios; esos cambios requieren que la acción correspondiente tenga éxito.
## Guías relacionadas
- [Experimentos](./experiments)
- [Ejecuciones de simulación y resultados](./simulation-runs-and-results)
- [Métricas y filtros](../analytics-and-seo/metrics-filters)
---
# Experimentos
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/experiments
Las capturas y grabaciones muestran la interfaz en inglés.
Los experimentos te permiten a Runner probar variaciones de tienda controladas contra un objetivo comercial seleccionado.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Experimentos**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Publica la tienda antes de comenzar un experimento. Esta pantalla de requisitos previos no muestra un experimento lanzado.
## Antes de empezar
- Publica la tienda y confirma que puede recibir tráfico real.
- Elige un objetivo principal que coincida con la prioridad actual de la tienda.
- Elige una asignación de tráfico con la que te sientas cómodo asignando a variaciones de experimento.
- Entiende que lanzar inicia un proceso de experimento; no garantiza una ganancia de rendimiento.
## Controles de lanzamiento y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Tarjeta de objetivo | Selecciona la métrica que Runner debe optimizar, como conversión, agregar al carrito, pago iniciado, participación en banner, clic en botón o valor promedio de pedido. |
| Deslizador de tráfico o preestablecido | Establece la parte del tráfico elegible asignado al experimento dentro del rango permitido. |
| **Lanzar Experimentos** | Autoriza e inicia el experimento para la tienda, objetivo y valor de tráfico seleccionados. |
| Título del experimento o **Ver experimento** | Abre el espacio de trabajo de detalle del experimento. |
| **Todos los experimentos**, **En ejecución** o **Detenido** | Filtra la lista de experimentos por estado. |
## Inicia un experimento
1. Abre **Experimentos**.
2. Si aparece el muro de publicación, publica y verifica la tienda primero.
3. Lee cada objetivo y selecciona el vinculado a la decisión que necesitas.
4. Establece la asignación de tráfico.
5. Revisa la tienda, objetivo y tráfico una vez más.
6. Selecciona **Lanzar Experimentos** una sola vez.
7. Espera a que aparezca la tarjeta del experimento.
8. Abre el experimento para seguir la planificación, cambios, ciclos y mediciones.
## Controles de tarjeta de experimento
| Control o sección | Qué muestra o hace |
| --- | --- |
| Insignia de estado | Muestra **Pendiente**, **En ejecución**, **Completada**, **Error** o **Cancelado**. El filtro de lista **Detenido** agrupa experimentos completados, fallidos y cancelados. |
| Ciclo y tráfico | Muestra el recuento de ciclo actual y la asignación. |
| Vista previa | Muestra la variación del experimento cuando una vista previa está disponible. |
| **Cambios** | Lista cambios de tienda asociados con el ciclo más reciente. |
| **Información de IA** | Abre una sugerencia pendiente como un ajuste de tráfico. |
| **Permitir** | Aprueba la sugerencia mostrada con su valor actual. |
| **Cancelar** | Descarta esa sugerencia pendiente. |
| Menú de más acciones | Abre **Detener** y **Aplicar cambios** cuando esas acciones están disponibles. |
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Muro de publicación | La tienda no tiene implementación en vivo exitosa. Publica antes de habilitar Experimentos. |
| Pantalla de lista de espera o actualización | La función o plan no está disponible para este espacio de trabajo. |
| Preparando o planificando | Runner está configurando el próximo ciclo. Espera un plan o solicitud visible. |
| Esperando aprobación | Runner necesita una decisión antes de poder continuar esa sugerencia. Léela antes de elegir **Permitir**. |
| Sin cambios aún | El experimento actual no ha producido un cambio de variación visible. |
| Fallido | Abre el experimento y preserva el error visible para soporte antes de iniciar un reemplazo. |
## Verifica el acceso antes de preparar un lanzamiento
Si Runner muestra una vista previa del plan, las tarjetas de muestra ilustran la función; no son un experimento en ejecución en tu tienda. Resuelve el requisito de acceso mostrado antes de los pasos de lanzamiento. Una puerta de publicación es separada y requiere una tienda en vivo funcionando.
**Punto de control:** Después de un lanzamiento elegible, la tarjeta de experimento real debería identificar el objetivo y la asignación previstos. Espera el tráfico registrado antes de interpretar el rendimiento; una tarjeta creada por sí sola no prueba ni medición ni mejora.
## Guías relacionadas
- [Medición de experimentos](./experiment-measurement)
- [Simulaciones](./simulations)
- [Tráfico y conversión](../analytics-and-seo/traffic-and-conversion)
---
# Biblioteca de medios
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/media-library
Las capturas y grabaciones muestran la interfaz en inglés.
La Biblioteca de medios te proporciona un registro visual filtrable de imágenes y videos de proyecto generados que se pueden reutilizar más tarde.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **Biblioteca de medios**. El destino abre la página de **Biblioteca de medios**.
También puedes abrirla desde la bandeja de activos en [Creative Studio](./creative-studio).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgPzvLcwpojWS3a1ps2R0mnEqK6T9PkBh7u5zQ)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una biblioteca de imágenes de ejemplo. Elige una imagen para inspeccionar sus detalles guardados; abrir la biblioteca no genera nuevos medios.
Una vista de detalle de imagen de ejemplo muestra su solicitud, modelo y controles de reutilización. No se ha cambiado ninguna miniatura de producto.
## Antes de empezar
- Genera o guarda medios en un flujo de Runner compatible.
- Sabe si estás buscando una imagen o un video.
- Para miniaturas de producto, confirma qué producto debe cambiar antes de completar el diálogo de selección.
## Controles de biblioteca y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Todo** | Muestra cada imagen y video guardado disponible. |
| **Imágenes** | Filtra la cuadrícula a imágenes. |
| **Vídeos** | Filtra la cuadrícula a videos. |
| Tarjeta de medios | Abre **Detalles de la imagen** o **Detalles del vídeo**. |
| **Cargar más** | Obtiene medios adicionales cuando hay más elementos disponibles. |
## Controles de detalle y resultados de clic
| Control o campo | Qué sucede o aparece |
| --- | --- |
| Tipo, Origen y Creado | Explica qué es el elemento, de dónde vino y cuándo fue guardado. |
| Mensaje y Modelo | Muestra el contexto de generación cuando está disponible. |
| Título | Te permite ingresar un nombre reutilizable más claro. |
| **Guardar** | Almacena un título cambiado; no está disponible cuando nada cambió. |
| **Cerrar** | Cierra detalles sin guardar un título sin guardar. |
| **Establecer como miniatura del producto** | Abre el flujo de selección y confirmación de producto para una imagen. No se aplica a videos. |
| **Eliminar** | Abre una confirmación irreversible; solo el segundo **Eliminar** elimina el elemento. |
| Eliminar **Cancelar** | Vuelve a detalles sin eliminar el elemento. |
## Encontrar e inspeccionar medios
1. Abre **Biblioteca de medios**.
2. Elige **Imágenes** o **Vídeos** cuando la cuadrícula es grande.
3. Selecciona una tarjeta para abrir detalles.
4. Revisa origen, fecha, mensaje y modelo para confirmar que es el activo previsto.
5. Cierra los detalles para volver a la cuadrícula filtrada.
**Punto de control:** La vista de detalle muestra el activo que pretendías, con su contexto de generación disponible. Si la cuadrícula está vacía, vuelve a **Todo** antes de asumir que faltan medios.
## Renombrar o aplicar una imagen
1. Reabre el activo deseado, introduce un título útil y selecciona **Guardar**.
2. Para una imagen que debería convertirse en una miniatura de producto, selecciona **Establecer como miniatura del producto**.
3. Elige el producto deseado y revisa la confirmación antes de aplicar el cambio.
4. Abre el producto después y confirma que la imagen correcta aparece.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| **Sin medios aún** | No hay medios compatibles disponibles. Crea una imagen o video en Creative Studio primero. |
| Vista filtrada vacía | La biblioteca no tiene elemento de ese tipo. Vuelve a **Todo**. |
| Sin cambios para guardar | El título coincide con el valor almacenado. Cierra el diálogo o edítalo. |
| Guardar falló | El nuevo título no fue confirmado. Presérvalo, recarga e intenta nuevamente. |
| Acción de miniatura ausente | Solo las imágenes pueden usar el flujo de miniatura de producto. |
| Confirmación de eliminación | La acción no se puede deshacer. Elige **Cancelar** a menos que la eliminación permanente sea intencional y autorizada. |
## Guías relacionadas
- [Creative Studio](./creative-studio)
- [Runner Ads](./runner-ads)
- [Automatizaciones](./automations)
---
# Runner Ads
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/runner-ads
Las capturas y grabaciones muestran la interfaz en inglés.
Runner Ads trae reportes de cuentas de anuncios compatibles y controles de campaña al proyecto de tienda.
## Ruta de acceso
Abre un proyecto de tienda → **Crecer** → **Anuncios** → **Resumen**. El submenú de Anuncios también abre **Creativos** y **Tendencias**; estas son vistas separadas.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglh1549efCuYB97EiQHRN3LVKtUonPdvTgIM4)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El resumen de Anuncios no conectado ofrece autorización de Google, Meta y TikTok. Seleccionar un proveedor inicia la conexión; esta pantalla no confirma una cuenta conectada.
## Antes de empezar
- Confirma que el espacio de trabajo tiene acceso a Ads y un plan elegible.
- Usa una cuenta que esté autorizada para conectar el proveedor de anuncios.
- Sabe qué proveedor y cuenta de anuncios pertenecen a este negocio.
- Conectar inicia el flujo de autorización del proveedor; no se completa hasta que Runner muestre la cuenta conectada.
## Controles de conexión y resultados de clic
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Conectar Google Ads** | Abre el flujo de autorización seguro de Google. |
| **Conectar Facebook e Instagram** | Abre el flujo de autorización de Meta. |
| **Conectar TikTok Ads** | Abre la autorización de TikTok cuando ese canal está habilitado. |
| **Cancelar conexión** | Cancela un intento de autorización de proveedor que aún está pendiente. |
| Configuración de conexión | Abre el estado del canal conectado más los controles compatibles por ese proveedor, como conectar, sincronizar, reautorizar o desconectar. |
| Sincronizar | Solicita una lista de cuenta fresca para esa conexión. No crea una campaña. |
| **Reautorizar** | Para TikTok, inicia la autorización nuevamente cuando este control aparece y la conexión lo requiere. |
| Desconectar | Abre una confirmación antes de eliminar la conexión del proveedor de Runner. |
## Conecta una cuenta
1. Abre **Anuncios** → **Resumen**.
2. Selecciona el botón del proveedor correcto.
3. Completa la autorización en la ventana del proveedor.
4. Vuelve a Runner y espera la sincronización de cuenta.
5. Confirma que el nombre del proveedor y la cuenta aparecen en la configuración de conexión o el selector de cuenta.
6. Si la conexión permanece pendiente, espera la sincronización o usa la ruta de reintento visible.
7. No trates el clic del botón inicial como una conexión completada.
## Controles y resultados del panel
| Control o sección | Qué sucede o aparece |
| --- | --- |
| Rango de tiempo | Actualiza los reportes para la semana pasada, mes o período reciente más amplio. |
| Selector de cuenta | Filtra resultados cuando hay más de una cuenta conectada disponible. |
| Tarjetas KPI | Resumen de métricas de anuncios disponibles para las cuentas y período seleccionados. |
| Tabla de campaña | Lista métricas de campaña y controles de estado compatibles. |
| Campaña **Pausar** / **Activar** | Para campañas de Google Ads o TikTok compatibles, solicita el cambio de estado externo correspondiente. Las campañas de Meta no muestran este control. Úsalo solo cuando esté autorizado y confirma el estado devuelto. |
| Gráfico de tendencia | Compara el rendimiento de campaña y cuenta seleccionados a lo largo del tiempo. |
| Fuente de actividad | Muestra la actividad de cuenta de anuncios reciente disponible. |
| **Crear campaña** | Abre una opción de proveedor o destino de campaña solo cuando un canal de creación compatible está conectado. |
## Rutas de creación de campaña
- Con Google Ads conectado, **Crear campaña** abre el flujo de cuatro pasos de Runner: **Channel & Goal**, **Plan**, **Editar campañas** y **Review & Publish**.
- Con TikTok Ads conectado, la creación abre TikTok Ads Manager en una pestaña nueva en lugar de un asistente de TikTok en la aplicación.
- Con ambos disponibles, el botón abre una opción de proveedor.
- Una conexión solo de Meta puede proporcionar reportes pero no muestra un destino de creación de campaña en el flujo actual.
- En el flujo de Google, **Siguiente** avanza después de que los campos requeridos sean válidos, **Atrás** vuelve a un paso completado y **Publish Campaign** envía la campaña revisada al proveedor.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Lista de espera | Ads está deshabilitado para el espacio de trabajo. Unirse o ver la lista de espera no lo desbloquea inmediatamente. |
| Pantalla de actualización | El plan actual no puede abrir el espacio de trabajo de Ads. |
| Autorización pendiente | La ventana del proveedor no se ha completado o devuelto. Complétala o cancela el intento. |
| Reautorización requerida | Para TikTok, abre la configuración de conexión y selecciona **Reautorizar** cuando se muestre antes de esperar datos frescos. |
| Datos temporalmente retrasados | Mantén datos parciales disponibles e intenta más tarde; evita solicitudes repetidas del proveedor. |
| Reportes no disponibles para un canal | Esa conexión no puede proporcionar el reporte solicitado. Usa canales compatibles o reportes del proveedor. |
| Botón Crear ausente | Ningún canal actualmente conectado admite un destino de creación. |
## Identifica la pantalla antes de conectar
Una lista de espera significa que Anuncios no está disponible en este espacio de trabajo. Una vista previa del plan puede mostrar informes de muestra mientras las acciones reales permanecen bloqueadas. Una pantalla de conexión solicita la cuenta del proveedor necesaria para usar los informes. Sigue los pasos de conexión solo cuando la página ofrezca el flujo de conexión utilizable.
**Punto de control:** Después de la autorización, verifica el proveedor exacto y la cuenta seleccionada en Runner. Una tabla de campaña vacía puede simplemente significar que esa cuenta no tiene campañas coincidentes o datos para el período elegido.
## Guías relacionadas
- [Creatividades publicitarias y tendencias](./ad-creatives-and-trending)
- [Creative Studio](./creative-studio)
- [Tráfico y conversión](../analytics-and-seo/traffic-and-conversion)
---
# Ejecuciones de simulación y resultados
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/simulation-runs-and-results
Las capturas y grabaciones muestran la interfaz en inglés.
La página de ejecución convierte la actividad del comprador generada en evidencia que puedes inspeccionar antes de decidir si la tienda debe cambiar.
> **Condicional:** Una página de ejecución existe solo después de que se ha lanzado una simulación elegible. Los resultados pueden ser parciales, no disponibles o fallidos, y las recomendaciones generadas no se aplican automáticamente.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Simulación** → selecciona una simulación reciente.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Las simulaciones de comprador y página requieren publicación antes de una ejecución. Esta pantalla de configuración no contiene recorridos completados ni resultados.
## Antes de empezar
- Espera a que la ejecución alcance un estado completado o fallido antes de tratar sus totales como finales.
- Ten en cuenta la página de destino y el modo seleccionado mientras interpretas los resultados.
- No trates el comportamiento de la persona generada como comportamiento observado de compradores reales.
## Controles de ejecución y resultados de clics
| Control o sección | Qué sucede o aparece |
| --- | --- |
| Enlace Atrás | Regresa a la página de aterrizaje de Simulación y ejecuciones recientes. |
| **Recorridos** | Abre rutas de persona individuales, decisiones, pasos y capturas de pantalla disponibles. |
| **Tablero de embudo** | Agrupa sesiones de comprador por la etapa de recorrido más lejana alcanzada. |
| **Resultados** | Resume sesiones terminales, salidas explícitas, límites de turnos y fallos técnicos. |
| Tarjeta de persona o sesión | Abre ese recorrido de comprador generado. |
| **Ver detalles del paso** | Abre la acción seleccionada, página, intención, justificación y captura de pantalla cuando esté disponible. |
| **Enviar a Runner** | Crea un traspaso de chat de Runner que contiene el contexto de la recomendación. No aplica el cambio. |
| **Validar compradores** | Inicia una ejecución de comparación de mismo comprador para una recomendación elegible. |
## Lee una ejecución de comportamiento de comprador
1. Confirma que el estado es **Completada** o anota qué partes aún se están ejecutando.
2. Lee los totales de sesión y el resumen de alcance de pago.
3. Abre **Tablero de embudo** para encontrar la caída común más temprana.
4. Abre **Recorridos** e inspecciona sesiones representativas en ese punto.
5. Usa **Ver detalles del paso** para revisar la operación intentada y el estado de página visible.
6. Abre **Resultados** para separar salidas de comprador de fallos técnicos o límites de turnos.
7. Lee cada recomendación de optimización con su evidencia, área afectada, riesgo y plan de validación.
8. Usa **Enviar a Runner** solo cuando quieras una tarea de chat revisable; inspecciona la tarea antes de aceptar cambios.
## Lee una auditoría de estímulo de página
1. Espera el informe agregado.
2. Lee la puntuación de intención y el número de perspectivas de comprador juntos.
3. Revisa diferencias de segmento y distribución de puntuación.
4. Lee temas de fricción y comentarios de apoyo.
5. Usa el resultado para formar una hipótesis comprobable, no una predicción de conversión garantizada.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Resultados pendientes | Las sesiones no han terminado. Espera más sesiones terminales. |
| Informe no disponible | La ejecución terminó sin el informe agregado esperado. Preserva el ID de ejecución y contacta con soporte. |
| Reproducción no disponible | No se pudo cargar una reproducción o captura de pantalla firmada. Recarga la ejecución para solicitar acceso fresco. |
| Fallo técnico | La automatización no pudo completar ese recorrido; exclúyelo de conclusiones de comportamiento. |
| Validación en cola o en ejecución | La comparación no está lista. Espera antes de juzgar la recomendación. |
| Mejorado, retrocedido o inconcluso | La comparación de mismo comprador favorece, daña o no puede distinguir el cambio sugerido dentro de esa prueba generada. |
## Coincide el resultado con su modo
Las instrucciones de recorrido y embudo anteriores se aplican a las ejecuciones de comprador. Una ejecución de **Predicción de campañas**, cuando está disponible, en su lugar expone **Sociedad**, **Charla** e **Informe**. Lee sus suposiciones de audiencia y entradas de campaña antes del informe.
**Punto de control:** Identifica si un hallazgo proviene de un recorrido generado, una reacción de página o una predicción de campaña. Ninguno es una compra registrada por un cliente real. Mantén las fallas técnicas separadas de las reacciones de la audiencia.
## Guías relacionadas
- [Simulaciones](./simulations)
- [Experimentos](./experiments)
- [Tráfico y conversión](../analytics-and-seo/traffic-and-conversion)
---
# Simulaciones
Source: https://www.runnerai.com/docs/es/guides/automate-test-and-create/simulations
Las capturas y grabaciones muestran la interfaz en inglés.
La simulación te permite enviar personas de comprador generadas a través de un recorrido de tienda en vivo o pedirles que evalúen una página pública.
## Ruta de acceso
Abre un proyecto de tienda → **Medir** → **Simulación**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Las simulaciones de comprador y página requieren publicación antes de una ejecución. Esta pantalla de configuración no contiene recorridos completados ni resultados.
## Antes de empezar
- Para **Comportamiento del comprador** y **Auditoría de estímulo de página**, publica la tienda y confirma que sus páginas públicas se cargan.
- **Predicción de campañas**, cuando esté disponible, utiliza entradas de campaña y no requiere una tienda publicada.
- Revisa el plan actual o aviso de uso antes de lanzar trabajo pagado.
- Elige una pregunta real de tienda y una página de destino.
- Trata los compradores generados como pruebas direccionales, no como demanda real de clientes.
## Modos
| Modo | Cuándo usarlo | Qué hace Runner después del lanzamiento |
| --- | --- | --- |
| **Comportamiento del comprador** | Quieres observar navegación, decisiones y fricción de recorrido. | Inicia múltiples recorridos de comprador en la página en vivo seleccionada y prepara vistas de embudo, recorrido, resultado y recomendación. |
| **Auditoría de estímulo de página** | Quieres reacciones enfocadas a una página. | Recopila evaluaciones de comprador generadas para intención de compra, segmentos y fricción en esa página. |
## Controles y resultados de clics
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Selector de modo | Elige **Comportamiento del comprador**, **Auditoría de estímulo de página** o **Predicción de campañas** cuando ese modo está habilitado. |
| Orientación de persona | Añade dirección de audiencia opcional, como sensibilidad de precio o preocupaciones de envío. |
| **Página de destino** | Abre páginas de tienda pública descubiertas como Inicio, Colección, Producto, Carrito, Pago o una página personalizada. |
| Ventana gráfica de dispositivo | Elige solo móvil, solo escritorio o una mezcla ponderada para comportamiento de comprador. |
| Tamaño de panel | Cambia cuántos recorridos de comprador generados solicita la ejecución dentro del rango permitido. |
| **Iniciar simulación** | Inicia la ejecución configurada y abre su página de ejecución. Se desactiva hasta que se selecciona una página de destino. |
| Tarjeta de simulación reciente | Abre una ejecución anterior y su estado actual o resultados. |
| **Ver todo** | Expande la lista de ejecuciones recientes cuando existen más ejecuciones. |
| **Reintentar** | Recarga páginas de destino o ejecuciones después de un fallo visible. |
## Lanza una simulación enfocada
1. Abre **Simulación**.
2. Selecciona **Comportamiento del comprador** o **Auditoría de estímulo de página**.
3. Añade orientación de persona concisa solo cuando una audiencia específica importa.
4. Selecciona **Página de destino** y elige una página en vivo descubierta.
5. Para comportamiento de comprador, elige la mezcla de dispositivos y tamaño de panel.
6. Revisa el aviso de uso actual.
7. Selecciona **Iniciar simulación** una sola vez.
8. Sigue la página de ejecución hasta que se complete o falle.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Muro de publicación | No hay implementación en vivo exitosa disponible. Publica y verifica la tienda primero. |
| Sin páginas de destino | Runner no pudo descubrir páginas públicas. Abre la tienda en vivo y reintenta la carga de página. |
| Sin simulaciones aún | Configura el panel y destino para crear la primera ejecución. |
| En cola o pendiente | La ejecución fue aceptada pero no ha iniciado todo el trabajo. Espera en lugar de lanzar un duplicado. |
| En ejecución | El trabajo de comprador aún está en progreso; los resultados pueden permanecer incompletos. |
| Fallido | Abre el error mostrado en la ejecución e inicia una nueva ejecución solo después de corregir el destino o fallo temporal. |
## Predicción de campañas, cuando esté disponible
Este modo pide a los miembros de la audiencia generada que evalúen una campaña en lugar de navegar por una tienda publicada.
1. Abre **Medir** → **Simulación** y elige **Predicción de campañas** si se muestra.
2. Revisa las entradas de campaña solicitadas por el formulario.
3. Añade la campaña que deseas evaluar y lee el aviso de uso actual.
4. Inicia la predicción solo cuando las entradas y el gasto solicitado sean correctos.
5. Abre el espacio de trabajo resultante e inspecciona las vistas disponibles de **Sociedad**, **Charla** e **Informe**.
**Punto de control:** Un informe completado es una predicción generada para la campaña suministrada. No lanza un anuncio ni mide el rendimiento real de la campaña. Si el modo está ausente, utiliza un modo disponible o verifica [Disponibilidad de funciones](../advanced/feature-availability).
## Guías relacionadas
- [Ejecuciones de simulación y resultados](./simulation-runs-and-results)
- [Experimentos](./experiments)
- [Descripción general de análisis](../analytics-and-seo/analytics-overview)
---
# Ayuda y referencia
Source: https://www.runnerai.com/docs/es/guides/help-and-reference
Comienza aquí cuando sabes el resultado que deseas pero la pantalla actual no coincide.
| Situación | Guía |
| --- | --- |
| Un botón está deshabilitado, una página está vacía, falta una entrada o Runner te pide que cargues la última versión | [Estados y disponibilidad](/es/guides/help-and-reference/states-and-availability) |
| Una tarea de chat de Runner está esperando, detenida o falló | [Soluciona problemas de tareas de Runner](/es/guides/help-and-reference/troubleshoot-runner-tasks) |
| La compilación o vista previa de la tienda es incorrecta | [Soluciona problemas de compilaciones de tienda](/es/guides/help-and-reference/troubleshoot-storefront-builds) |
| La publicación, pago o una aplicación no funciona | [Soluciona problemas de publicación, pago y aplicaciones](/es/guides/help-and-reference/troubleshoot-publishing-checkout-apps) |
| Necesitas una persona o quieres reportar un problema | [Soporte y comunidad](/es/guides/help-and-reference/support-and-community) |
| Quieres revisar actualizaciones de productos de Runner | [Registro de cambios](/es/guides/help-and-reference/changelog) |
| Tienes una pregunta corta sobre el producto | [Preguntas frecuentes](/es/guides/help-and-reference/faq) |
| Un término de Runner no te es familiar | [Glosario](/es/guides/help-and-reference/glossary) |
## Elige la ruta más corta
Usa una guía de solución de problemas cuando algo falle, **Soporte y comunidad** cuando necesites ayuda con una cuenta privada o un proyecto, y las preguntas frecuentes, el glosario o la referencia de estados cuando necesites una definición. Para la configuración inicial, empieza con [Crea tu primera tienda](/es/guides/start-here/first-store-quickstart).
---
# Registro de cambios
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/changelog
El Registro de cambios mantiene lanzamientos de productos en un lugar para que puedas ver qué cambió sin salir de Runner.
## Leer el Changelog público
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRzXySfwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXk)
En el [Changelog público](https://www.runnerai.com/changelog), lee el mes junto a **Monthly Update** y la sección **What’s New**; después desplázate hacia abajo para ver actualizaciones anteriores. No necesitas iniciar sesión. El mes es una fecha, no un filtro.
Selecciona la imagen para ampliarla. Las anotaciones están en inglés.
Las secciones siguientes describen el Changelog del espacio de trabajo cuando está disponible. Sus filtros, indicador de no leídos y controles de regreso pertenecen a esa versión y no aparecen en la cronología pública anterior.
## Qué cubre esta guía
Abrirás actualizaciones recientes, las filtrarás por tipo, comprenderás el marcador no leído y regresarás a la tienda o espacio de trabajo correcto.
## Disponibilidad y requisitos previos
- Solo el Changelog del espacio de trabajo o proyecto requiere iniciar sesión; la página pública está disponible sin cuenta.
- El punto no leído aparece solo cuando Runner tiene una actualización que no has abierto.
- Un filtro cambia solo los lanzamientos mostrados en esta página; no cambia ninguna característica de producto.
## Rutas de entrada
| Entrada | Qué sucede después de seleccionarla |
| --- | --- |
| Barra lateral del espacio de trabajo → **Registro de cambios** | Abre todas las actualizaciones de producto disponibles dentro del espacio de trabajo actual. |
| Avatar del proyecto de escritorio → **Registro de cambios** | Abre el mismo Registro de cambios mientras mantiene el proyecto actual como destino de retorno. |
| Avatar del proyecto móvil → **Registro de cambios** | Abre el Registro de cambios desde la hoja **Perfil y Configuración**. |
| Barra lateral del espacio de trabajo contraída → vista previa del icono de Registro de cambios → **Ver todo** | Abre el Registro de cambios completo después de obtener una vista previa del lanzamiento más reciente. |
Abrir el Registro de cambios completo borra el punto no leído. Esto marca las actualizaciones como vistas; no ejecuta ni habilita las características descritas en un lanzamiento.
## Filtra lanzamientos
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Todo** | Muestra todos los lanzamientos disponibles. |
| **Destacar** | Muestra lanzamientos categorizados como nuevas características. |
| **Mejora** | Muestra lanzamientos categorizados como mejoras. |
| **Corrección** | Muestra lanzamientos categorizados como correcciones. |
| Tarjeta de lanzamiento | Muestra el título, fecha, tipo, descripción y medios disponibles de ese lanzamiento. |
| **Volver a la tienda** | Regresa al proyecto actual cuando el Registro de cambios se abrió allí; de lo contrario, regresa a la lista de tiendas del espacio de trabajo. |
En móvil dentro de un proyecto, el shell del proyecto proporciona el control de retorno, por lo que la acción **Volver a la tienda** a nivel de página puede estar oculta.
## Revisa una actualización
1. Abre **Registro de cambios** desde la barra lateral del espacio de trabajo o menú de avatar.
2. Comienza con **Todo** para ver lanzamientos en orden de fecha.
3. Selecciona **Destacar**, **Mejora** o **Corrección** cuando necesites un tipo de cambio.
4. Lee el título del lanzamiento, fecha, descripción y cualquier medio incluido.
5. Usa el control de retorno para volver a la tienda o espacio de trabajo de donde viniste.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Punto rojo no leído | Una actualización más reciente no ha sido abierta. Abre Registro de cambios para borrarlo. |
| **Hoy** | La fecha de lanzamiento coincide con el día actual. |
| Sin elemento bajo un filtro | Ningún lanzamiento disponible tiene esa categoría. Regresa a **Todo**. |
| Vista previa de lanzamiento más reciente | Pausar sobre el icono de escritorio contraído puede mostrar la actualización más reciente. Selecciona **Ver todo** para el historial completo. |
| El retorno va a un alcance diferente | Reabre el espacio de trabajo o proyecto previsto, luego abre Registro de cambios desde allí para que Runner tenga el contexto de retorno correcto. |
## Usa una nota de versión para encontrar el siguiente paso
1. Abre **Registro de cambios** y elige **Destacar**, **Mejora**, **Corrección** o **Todo**.
2. Lee la entrada fechada que corresponda al comportamiento que quieras aprender.
3. Vuelve con **Volver a la tienda** y abre la herramienta correspondiente desde la navegación del proyecto.
**Comprueba:** La lista filtrada muestra la categoría de actualización elegida. Las notas de versión describen cambios; el plan y el acceso actuales de tu espacio de trabajo determinan si puedes usarlos.
## Guías relacionadas
- [Soporte y comunidad](/es/guides/help-and-reference/support-and-community)
- [Navegación y búsqueda del espacio de trabajo](/es/guides/workspace/navigation-and-search)
- [Disponibilidad de características](/es/guides/advanced/feature-availability)
---
# Preguntas frecuentes
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/faq
**Ruta de entrada:** Documentación de Runner → **Ayuda y referencia** → **Preguntas frecuentes**.
### ¿Puedo comenzar sin experiencia técnica?
Sí. Describe el negocio y la experiencia del cliente deseada en lenguaje simple. Runner puede hacer preguntas de seguimiento antes de comenzar el trabajo. Consulta [Escribe solicitudes efectivas](../work-with-runner/write-effective-requests).
### ¿Debo construir una nueva tienda o conectar Shopify?
Elige **Crear nuevo** cuando Runner deba crear el proyecto de tienda y su configuración de comercio. Elige **Conectar Shopify** cuando Shopify deba permanecer como el sistema de tienda conectado y la ruta de pago. Consulta [Crear una tienda de Runner](../start-here/create-runner-store) y [Conectar Shopify](../start-here/connect-shopify).
### ¿Una tarea completada de Runner significa que mi tienda está en vivo?
No. La finalización de tareas, el éxito de vista previa, la publicación, la tienda en vivo, el catálogo y el pago son resultados separados. Verifica cada capa relevante.
### ¿Cuál es la diferencia entre Publicar y Republicar?
**Publicar** crea la primera versión en vivo después de que se completen los requisitos. **Republicar** envía cambios de borrador más nuevos a una tienda que ya tiene una versión en vivo. Consulta [Publicar y republicar](../storefront-and-publishing/publish-and-republish).
### ¿Por qué está deshabilitado un botón?
Puede faltar entrada requerida, permiso, acceso al plan, estado de tienda, datos o una conexión. Lee el texto cercano y consulta [Estados y disponibilidad](./states-and-availability).
### ¿Por qué falta una entrada de navegación?
Algunas funciones son condicionales o por etapas. Confirma el espacio de trabajo, tienda, rol, plan, publicación y conexiones. Consulta [Disponibilidad de funciones](../advanced/feature-availability).
### ¿Dónde administro productos y pedidos?
Abre el proyecto de tienda, selecciona **Operaciones de la tienda**, luego elige **Productos** u **Pedidos**. Consulta [Operaciones de la tienda](../store-operations).
### ¿Dónde conecto pagos, correo electrónico o envío?
Abre el proyecto y selecciona **Apps**. Elige el proveedor y sigue su flujo de conexión oficial. Consulta [Aplicaciones e integraciones](../apps-and-integrations).
### ¿Cómo deshago un cambio de tienda?
Primero envía una corrección enfocada o usa [Historial de versiones](../storefront-and-publishing/version-history). Restaurar una versión cambia el estado del proyecto, así que revisa la versión seleccionada antes de confirmar.
### ¿Por qué están vacíos Análisis o SEO?
La tienda seleccionada, rango de fechas, publicación o recopilación de eventos puede no tener datos aún. Un estado vacío es diferente de un estado de carga o error. Consulta [Análisis y SEO](../analytics-and-seo).
### ¿Dónde veo créditos y uso?
Abre la configuración del espacio de trabajo y selecciona el destino de uso o facturación disponible para tu rol. Consulta [Créditos y uso](../plans-and-billing/credits-and-usage).
### ¿Cómo obtengo ayuda?
Usa [Soporte y comunidad](./support-and-community). Incluye la página exacta, acción, estado visible y una captura de pantalla segura para la privacidad.
## ¿Por dónde empiezo?
Para crear tu primera tienda con capturas y grabaciones, sigue [Construye tu primera tienda](../start-here/first-store-quickstart). Si ya hay trabajo en curso, consulta [Solucionar problemas de tareas de Runner](./troubleshoot-runner-tasks) antes de enviar otra vez la misma solicitud.
---
# Glosario
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/glossary
**Ruta de entrada:** Documentación de Runner → **Ayuda y referencia** → **Glosario**.
| Término | Significado en Runner |
| --- | --- |
| Agente | Capacidades de Runner que utilizan Habilidades reutilizables y Memoria de proyecto o espacio de trabajo. |
| Aplicación | Una conexión entre Runner y otro servicio, o una capacidad de nivel de agente que se muestra en la página de Aplicaciones. |
| Artefacto | Un resultado producido durante una tarea o flujo de trabajo, como un informe, archivo, vista previa o resultado de tarea anterior. |
| Automatización | Una acción configurada que se ejecuta desde un disparador o cronograma cuando está disponible. |
| Chat | Una conversación de proyecto donde solicitas y revisas trabajo. |
| Pago | La ruta del cliente que recopila envío y pago para crear un pedido. |
| Créditos | Asignación de uso del espacio de trabajo que se muestra en el producto actual. La página de facturación en vivo es autorizada. |
| Modo de diseño | Una vista de edición de tienda para seleccionar y cambiar contenido visible. |
| DNS | Los registros de internet que conectan un nombre de dominio a la tienda correcta. Runner muestra los valores para copiar en tu proveedor de dominio. |
| Borrador | Una tienda sin una publicación en vivo actual. |
| Punto final | Una dirección de destino utilizada por una integración, como un receptor de webhook. Trata las direcciones de punto final y sus credenciales como sensibles. |
| Experimento | Una comparación controlada utilizada para medir un cambio cuando la función está disponible. |
| Fly | Un espacio de trabajo de misión guiada condicional. |
| Cumplimiento | El trabajo de preparar y enviar artículos de un pedido, incluidos los pasos de proveedor o proveedor de envío compatibles. |
| Memoria | Contexto guardado que Runner puede reutilizar en su alcance definido. |
| Biblioteca de medios | El lugar del proyecto para activos visuales generados o cargados. |
| Vista previa | La vista actual de la tienda del proyecto antes o independiente de la publicación. |
| Proyecto | El espacio de trabajo específico de la tienda de Runner que contiene chat, tienda, operaciones, aplicaciones y herramientas. |
| Proveedor | Un servicio externo conectado a Runner para pagos, envío, correo electrónico, abastecimiento, análisis u otra tarea compatible. |
| Publicar | Crea la primera versión en vivo después de que pasen los requisitos. |
| Republicar | Envía cambios de borrador más nuevos a una tienda que ya tiene una versión en vivo. |
| Investigación | Un espacio de trabajo condicional para estudios y reportes comerciales estructurados. |
| Sesión (Análisis) | Una visita de tienda registrada utilizada en informes de tráfico y conversión. Es diferente de una sesión de cuenta con sesión iniciada. |
| Sesión (Cuenta) | Una conexión de Runner con sesión iniciada en un navegador o dispositivo que se puede revisar o revocar en la configuración de seguridad. |
| Simulación | Una herramienta para ejecutar un escenario configurado y revisar su resultado cuando está disponible. |
| Habilidad | Un conjunto reutilizable de instrucciones o flujo de trabajo que Runner puede aplicar al trabajo. |
| SKU | Un código definido por la tienda utilizado para identificar un producto o variante para inventario y operaciones. |
| Operaciones de la tienda | Páginas de producto, pedido, cliente, promoción, envío, abastecimiento y gestión de tienda. |
| Tarea | Una unidad de trabajo que Runner rastrea dentro de una conversación. |
| Variante | Una versión comprable de un producto, como un tamaño o color particular, con su propio precio o inventario. |
| Versión | Un estado de tienda guardado que se muestra en Historial de versiones. |
| Webhook | Una entrega configurada de un evento de proyecto compatible a otro servicio. |
| Flujo de trabajo | Un [flujo de proyecto reutilizable de varios pasos](/es/guides/advanced/workflows) cuando la función está habilitada. |
| Espacio de trabajo | El límite de equipo y facturación que contiene tiendas, miembros, configuración, créditos y notificaciones. |
## Usa los términos en un flujo real
Sigue [Crea tu primera tienda](../start-here/first-store-quickstart) para ver una conversación, una tarea, una vista previa y una comprobación de publicación en contexto. Para un mensaje de estado, usa [Estados y disponibilidad](./states-and-availability) para elegir el siguiente paso.
## Guías relacionadas
- [Te damos la bienvenida a Runner AI](../product-guide)
- [Estados y disponibilidad](./states-and-availability)
- [Disponibilidad de funciones](../advanced/feature-availability)
---
# Estados y disponibilidad
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/states-and-availability
Runner usa estados para decirte si una acción está lista, esperando, completa, bloqueada o no disponible. Lee el estado antes de reintentar o cambiar configuración.
**Ruta de entrada:** Documentación de Runner → **Ayuda y referencia** → **Estados y disponibilidad**.
## Estados de tienda y publicación
| Estado | Significado | Siguiente paso seguro |
| --- | --- | --- |
| Borrador | El proyecto actualmente no tiene una versión publicada en vivo. | Continúa construyendo y completa los requisitos de publicación. |
| Implementando | Runner está preparando una publicación. | Espera a que el estado termine; no inicies publicaciones repetidas. |
| Publicado | Existe una versión en vivo. | Abre la URL en vivo y verifica el cambio previsto. |
| Publicación bloqueada | Uno o más elementos de configuración requeridos están incompletos. | Abre el requisito nombrado y complétalo. |
| Republicación disponible | El borrador contiene cambios más nuevos que la versión en vivo. | Revisa la vista previa, luego republica cuando esté listo. |
## Estados de tareas
| Estado | Significado | Siguiente paso seguro |
| --- | --- | --- |
| Esperando por ti | Runner necesita una respuesta, opción, aprobación o detalle faltante. | Abre la pregunta y responde una vez. |
| Trabajando | La tarea actual aún se está ejecutando. | Sigue sus detalles en lugar de iniciar una solicitud duplicada. |
| Completado | Runner alcanzó el estado de éxito terminal de la tarea. | Verifica el resultado visible en la página afectada. |
| Detenido | El trabajo terminó antes de completarse. | Lee por qué se detuvo, corrige la causa, luego continúa o envía un seguimiento enfocado. |
| Falló | La tarea no pudo terminar. | Guarda el error visible y reintenta solo después de verificar la causa. |
## Estados de página y control
| Lo que ves | Significado |
| --- | --- |
| Botón deshabilitado | Falta entrada requerida, permiso, plan o estado. El texto cercano generalmente lo nombra. |
| Esqueleto de carga o indicador de progreso | Se están solicitando datos. Un estado de carga persistente necesita una recarga o verificación de soporte. |
| Estado vacío | La página está disponible pero el contexto seleccionado aún no tiene elementos. Usa la acción de crear o conectar ofrecida. |
| Mensaje de actualización | El plan actual o límite no permite la acción. Revisa la oferta en vivo en **Plan y Facturación**. |
| Conectar o reconectar | El servicio externo no está conectado o necesita autorización nuevamente. |
| Página no encontrada | La URL no está disponible para el contexto actual, está retirada o está cerrada. Regresa a través de la navegación visible. |
## Recuperación de versión de Runner
Si Runner se actualizó mientras tu pestaña estaba abierta, una página de recuperación de pantalla completa puede reemplazar la vista actual. No puedes cerrarla ni usar la página detrás de ella hasta que Runner cargue una copia actual.
| Lo que ves | Lo que sucede después |
| --- | --- |
| **Una versión más nueva de Runner está lista** | Selecciona **Cargar última versión** para recargar la pestaña actual con la última versión de Runner. |
| **Estás sin conexión** | **Cargar última versión** está deshabilitado. Reconéctate a internet; la acción se vuelve disponible sin dejar la página de recuperación. |
| **Cargando última versión…** | Runner está recargando la pestaña. Mantenla abierta mientras se completa la acción. |
| **No pudimos cargar la última versión** | Verifica la conexión, luego selecciona **Intentar de nuevo**. |
| **Detalles técnicos** | Expande el código de error, razón y tiempo de detección para solución de problemas. No reintenta ni repara la página. |
## Diagnostica en orden
1. Confirma el espacio de trabajo y tienda seleccionados.
2. Expande **Crear**, **Crecer** o **Medir** para localizar la herramienta y lee el estado, la advertencia o el requisito más cercano.
3. Verifica si la tarea relevante ya se está ejecutando.
4. Confirma tu rol, plan, estado de publicación y conexión de aplicación requerida.
5. Recarga una vez si el estado debería haber cambiado recientemente.
6. Usa la guía de solución de problemas relevante antes de repetir una acción de alto impacto.
## Guías relacionadas
- [Disponibilidad de características](../advanced/feature-availability)
- [Estados y detalles de tareas](../work-with-runner/task-states-and-details)
- [Estados de tienda](../workspace/store-statuses)
- [Soporte y comunidad](./support-and-community)
---
# Soporte y comunidad
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/support-and-community
Las capturas y grabaciones muestran la interfaz en inglés.
Usa documentación para flujos de trabajo conocidos, comunidad para aprendizaje compartido y soporte para problemas específicos de cuenta o reproducibles del producto.
## Qué cubre esta guía
Sabrás dónde se abre cada acción de ayuda, cómo reservar una demostración o enviar comentarios, y qué incluir cuando necesites soporte.
## Disponibilidad y requisitos previos
- Debes estar conectado para usar los menús de avatar del espacio de trabajo o proyecto.
- **Enviar comentarios** aparece solo en vistas de espacio de trabajo o proyecto de escritorio que expongan la acción de comentarios.
- **Reservar una demostración** utiliza un servicio de programación externo dentro de Runner y necesita una conexión de red funcional.
- La hoja de avatar móvil tiene un conjunto de acciones más pequeño que el menú de avatar de escritorio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgNbwG0GU2bm17vuEiZydJjwfYlOaXgBTsQ69k)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El menú de ayuda de Chat enlaza a ayuda contextual y al Centro de ayuda. La miniatura del tutorial está ocultada en esta ilustración; no se reprodujo ningún vídeo ni se envió ningún informe al soporte.
## Rutas de entrada
| Entrada | Qué sucede después de seleccionarla |
| --- | --- |
| Botón de ayuda de página → **Centro de ayuda** | Abre la documentación de Runner. |
| Popover de ayuda de página → **En esta página — Chat** | Abre la ayuda para la página actual de Chat cuando se muestra este contexto. |
| Popover de ayuda de página → **Tu primera tienda en cinco minutos** | Abre el tutorial de inicio enlazado. |
| Barra lateral del espacio de trabajo → **Centro de ayuda**, cuando se muestra | Abre la documentación de Runner. |
| Barra lateral del espacio de trabajo → **Comunidad** | Abre la comunidad de Runner en su destino actual. |
| Barra lateral del espacio de trabajo → **Blog** | Abre artículos educativos y de la empresa. |
| Barra lateral del espacio de trabajo → **Registro de cambios** | Abre actualizaciones recientes del producto de Runner. |
| Menú de avatar de escritorio → **Reservar una demostración** | Abre el panel de programación dentro de Runner. |
| Menú de avatar de escritorio → **Enviar comentarios** | Abre el formulario de comentarios cuando esa acción está disponible en la vista actual. |
| Menú de avatar de escritorio → **Ayuda** | Abre la documentación de Runner. |
| Menú de avatar de proyecto → **Comunidad**, **Blog** o **Registro de cambios** | Abre el recurso seleccionado; el Registro de cambios permanece dentro de Runner, mientras que Comunidad y Blog abren sus destinos actuales. |
| Documentación → **Soporte** | Abre la acción de correo electrónico de soporte configurada. |
## Comienza con la ayuda para la página actual
1. Abre el botón de ayuda de la página.
2. Elige la guía **En esta página** cuando coincida con tu pregunta, o **Centro de ayuda** para explorar la documentación.
3. Si estás comenzando una tienda, elige **Tu primera tienda en cinco minutos** cuando se ofrezca.
**Punto de control:** Se abre un destino de ayuda; no se ha enviado ningún informe de soporte o reserva. Los enlaces específicos de la página varían con la vista actual.
## Reservar una demostración
1. En escritorio, abre el menú de avatar y selecciona **Reservar una demostración**.
2. Espera a que se cargue el programador.
3. Elige una fecha y hora disponible, luego completa los detalles de contacto solicitados por el programador.
4. Confirma la reserva en el programador.
5. Espera el mensaje de éxito de Runner y a que se cierre el panel.
Cerrar el panel antes de que el programador confirme la reunión no crea una reserva. Si el programador permanece en blanco o informa que no está disponible, ciérralo, verifica la conexión e intenta una vez más. Usa la acción de soporte de documentación si falla repetidamente.
## Enviar comentarios
1. En el escritorio, abre el menú de avatar y elige **Enviar comentarios** cuando se muestre.
2. Describe la página, acción, resultado esperado y resultado real.
3. Añade una categoría opcional y una captura de pantalla después de eliminar información privada.
4. Revisa el informe antes de seleccionar **Enviar**. Cierra el formulario si solo deseas inspeccionarlo.
5. Después de enviar, espera la confirmación antes de asumir que el informe fue enviado.
| Control | Qué sucede después de usarlo |
| --- | --- |
| **Describe tus comentarios** | Registra la explicación requerida. Enviar permanece no disponible hasta que este campo contenga texto. |
| **Problemas de usabilidad** / **Funciones faltantes** | Agrega una categoría opcional para que el informe sea más fácil de enrutar. |
| Carga de captura de pantalla | Adjunta una imagen opcional al informe. Usa el control de eliminación para descartar el archivo adjunto antes de enviar. |
| **Enviar** | Envía el informe. Mientras se envía, la acción no se puede enviar nuevamente. |
| Cerrar | Cierra el formulario sin enviar un nuevo informe. |
Describe un comportamiento, la página donde sucedió y qué esperabas. Agrega una captura de pantalla solo después de eliminar información del cliente, correos electrónicos, detalles de pago, credenciales y otros datos privados. Después de un envío exitoso, Runner muestra una confirmación y cierra el formulario. Si el envío falla, mantén la descripción, verifica el archivo adjunto y la conexión, e intenta una vez más.
## Menú de avatar móvil
En móvil, el avatar del proyecto abre **Perfil y configuración**. Incluye **Idioma**, **Bandeja de entrada**, **Ayuda**, **Comunidad**, **Blog**, **Registro de cambios** y **Cerrar sesión**. **Reservar una demostración** y **Enviar comentarios** no se enumeran en esta hoja móvil. Usa una vista de escritorio más ancha para esas dos acciones, o usa la acción de soporte de documentación para un problema privado.
## Envía un informe de soporte útil
Incluye:
1. El nombre del espacio de trabajo y tienda, sin secretos.
2. La página y ruta de entrada exacta.
3. Qué seleccionaste y qué sucedió.
4. Qué esperabas en su lugar.
5. El texto de estado o error visible.
6. Si el problema se repite después de una recarga.
7. Una captura de pantalla con datos del cliente, correos electrónicos, detalles de pago y secretos eliminados.
Para una tarea de Runner, incluye la conversación y el estado de la tarea. Para publicación, incluye el estado de vista previa, estado de publicación y si la URL en vivo cambió. Para una aplicación, incluye el proveedor y el estado de conexión mostrado, pero nunca credenciales o claves API.
## Elige el canal
| Necesidad | Mejor punto de partida |
| --- | --- |
| Aprende un flujo de trabajo de producto normal | Busca en estas guías. |
| Compara enfoques con otros usuarios | Comunidad. |
| Sigue un cambio de producto lanzado | Registro de cambios. |
| Resuelve acceso, facturación, datos, errores repetidos o comportamiento de proyecto privado | Soporte. |
## Solución de problemas
| Estado | Significado y siguiente paso |
| --- | --- |
| El programador de demostración se está cargando | Espera a que sus controles de fecha y hora se carguen antes de interactuar. |
| Demostración confirmada | Runner muestra un mensaje de éxito y cierra el panel. Verifica los detalles de confirmación enviados por el programador. |
| Envío de comentarios no disponible | Agrega la descripción requerida o espera a que se complete el envío actual. |
| La carga de comentarios falla | Elimina el archivo adjunto e intenta nuevamente con una imagen compatible y segura para la privacidad, o envía el texto sin ella. |
| El envío de comentarios falla | El informe no fue confirmado. Mantén el texto e intenta una vez más antes de usar Soporte. |
## Guías relacionadas
- [Solucionar problemas de tareas de Runner](./troubleshoot-runner-tasks)
- [Solucionar problemas de compilaciones de tienda](./troubleshoot-storefront-builds)
- [Solucionar problemas de publicación, pago y aplicaciones](./troubleshoot-publishing-checkout-apps)
- [Registro de cambios](/es/guides/help-and-reference/changelog)
---
# Solucionar problemas de publicación, pago y aplicaciones
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/troubleshoot-publishing-checkout-apps
Las capturas y grabaciones muestran la interfaz en inglés.
Una compilación exitosa no prueba por sí sola la publicación, datos de catálogo, pago o un proveedor externo. Verifica cada capa por separado.
**Rutas de entrada:** Tienda afectada → **Tienda online** → **Publicar** para comprobar la preparación; **Crear** → **Apps** para las conexiones de proveedores.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
La comprobación de compilación pasa, pero la configuración incompleta deja Confirmar deshabilitado. Resuelve el requisito indicado antes de volver a intentar publicar.
## Antes de empezar
- Registra la tienda afectada, URL pública, proveedor y estado visible exacto.
- Detente antes de un cargo real, pedido, desconexión de proveedor u otra acción consecuente a menos que la prueba esté autorizada.
- Verifica una capa a la vez; una vista previa funcional no prueba publicación o pago.
## Controles y resultados importantes
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Reintentar comprobación** | Ejecuta nuevamente la verificación de publicación o pago fallida. No arregla la causa nombrada. |
| **Publicar** / **Republicar** | Inicia la publicación después de que pasen las verificaciones requeridas; no prueba comportamiento de catálogo o pago. |
| **Conectar Stripe** | Abre la ruta de conexión de pago. Ningún pago se acepta hasta que el proveedor y el pago en vivo sean utilizables. |
| **Reconectar** en Aplicaciones | Reinicia el flujo de autorización oficial del proveedor para la conexión existente. |
## Identifica la capa que falla
| Capa | Prueba a buscar | Si falta |
| --- | --- | --- |
| Vista previa | La página y interacción previstas funcionan en **Tienda online**. | Arregla la compilación o contenido antes de publicar. |
| Publicación | Runner muestra un estado publicado exitoso y una URL en vivo. | Abre el estado de publicación y resuelve el requisito o error nombrado. |
| Tienda en vivo | La URL en vivo muestra la versión prevista en una visita nueva. | Verifica si cambios más nuevos requieren **Republicar**. |
| Catálogo | El producto, precio, disponibilidad y opción de envío esperados son visibles. | Corrige datos de Operaciones de la tienda y disponibilidad de tienda. |
| Pago | Una prueba segura puede alcanzar el pago esperado y opciones de envío/pago. | Verifica pago, envío, modo de tienda y estado del proveedor. No realices un pedido real a menos que esté autorizado. |
| Proveedor | La aplicación muestra conectada y el proveedor confirma la cuenta esperada. | Reconecta a través del flujo de aplicación oficial y verifica permisos. |
## Recuperación de publicación
1. Abre **Tienda online** → **Publicar** y lee las comprobaciones. Detente si falta Stripe, el envío u otro requisito indicado; resuélvelo con [Preparar la publicación](../storefront-and-publishing/prepare-to-publish) antes de volver a intentarlo.
2. Verifica si otra publicación ya está **Desplegando**.
3. Si la publicación falla, preserva el error mostrado.
4. Reintentar solo una vez después de que se resuelva la causa nombrada.
5. Abre la URL en vivo después del éxito y verifica la página prevista.
## Recuperación de pago
1. Confirma que al menos un producto vendible sea visible en la tienda en vivo.
2. Confirma que el envío se aplique al destino de prueba.
3. Confirma que la aplicación de pago está conectada al modo y cuenta previstos.
4. Alcanza el pago a través de la tienda en vivo en lugar de una URL adivinada directa.
5. Detente antes de un cargo real u orden a menos que la prueba esté explícitamente autorizada.
## Recuperación de aplicación
1. Abre **Crear** → **Apps** y selecciona el proveedor.
2. Lee el estado mostrado: no conectado, conectado, necesita atención o no disponible.
3. Reconecta solo a través de la ventana de autorización oficial del proveedor.
4. Confirma la cuenta devuelta y los permisos.
5. Verifica el resultado real descendente; una insignia de conexión verde sola no es prueba de extremo a extremo.
### Vídeo: inspecciona un bloqueo de publicación
La grabación revisa las comprobaciones y después selecciona Cancelar. No se publica ninguna tienda ni se completa una compra.
## Guías relacionadas
- [Publicar y republicar](../storefront-and-publishing/publish-and-republish)
- [Tienda en vivo y pago](../storefront-and-publishing/live-store-and-checkout)
- [Conectar, administrar y reconectar aplicaciones](../apps-and-integrations/connect-manage-reconnect)
- [Solución de problemas de aplicaciones](../apps-and-integrations/troubleshooting)
---
# Solucionar problemas de tareas de Runner
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/troubleshoot-runner-tasks
Las capturas y grabaciones muestran la interfaz en inglés.
Soluciona problemas desde los detalles de la tarea actual primero. Repetir la misma solicitud sin verificar su estado puede crear trabajo duplicado y ocultar la causa original.
## Ruta de acceso
Abre la tienda afectada, vuelve a la conversación y luego abre el estado o los detalles de la tarea actual.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una pregunta en espera necesita una respuesta antes de que el trabajo pueda continuar. Revisa la última pregunta antes de enviar la misma solicitud nuevamente.
## Antes de empezar
- Mantén la conversación original abierta para no perder el estado visible o el error.
- Espera a que cualquier acción activa se estabilice antes de reintentar.
- No incluyas secretos, detalles de pago o datos de clientes en la evidencia copiada.
## Lista de verificación de recuperación
1. Confirma que estés en la conversación donde comenzó el trabajo.
2. Lee el último mensaje de Runner y el estado de la tarea.
3. Si Runner hizo una pregunta, responde esa pregunta antes de enviar una nueva solicitud.
4. Si la tarea se detuvo, identifica si necesita entrada, acceso, créditos o una solicitud corregida.
5. Si falló, copia el error visible sin incluir secretos o datos de clientes.
6. Reintentar una sola vez cuando la página ofrece un reintento y la causa es transitoria.
7. De lo contrario, envía un seguimiento enfocado que indique el resultado deseado y qué está actualmente mal.
8. Verifica la tienda, configuración o activo afectado después de que Runner informe la finalización.
## Problemas comunes
| Problema | Qué hacer |
| --- | --- |
| Nada sucede después de enviar | Confirma que el mensaje aparezca en la conversación y verifica los detalles de la tarea para un estado de espera. |
| Runner hace preguntas repetidas | Responde cada campo requerido directamente y evita cambiar el objetivo en la misma respuesta. |
| La tarea se detiene por créditos | Abre la configuración de uso o plan; no reanudes repetidamente el trabajo sin cambios. |
| El resultado está incompleto | Nombra el resultado visible faltante en un seguimiento. Adjunta una captura de pantalla cuando ayude a ubicar el problema. |
| La página incorrecta cambió | Usa el historial de versiones cuando sea apropiado, luego identifica la página o sección exacta en la corrección. |
| Un reintento falla de la misma manera | Deja de reintentar y contacta al soporte con la conversación, el estado de la tarea y el error. |
## Botones y resultados
| Control | Resultado |
| --- | --- |
| Detalles de la tarea | Abre el estado, el progreso y cualquier información de resultado disponible. |
| Control de respuesta u opción | Envía la decisión solicitada y permite que la tarea continúe. |
| Detener, cuando esté disponible | Finaliza la ejecución actual; el trabajo sin terminar puede permanecer incompleto. |
| Reintentar o continuar | Inicia otro intento desde el estado que Runner admite. Úsalo solo después de verificar la causa. |
| Nuevo chat | Inicia una conversación separada; no repara automáticamente la tarea original. |
## Confirma la recuperación antes de otra solicitud
Después de responder a una pregunta, confirma que tu respuesta aparece y que la tarea sale de su estado de espera. Después de una corrección, repite la acción afectada en la tienda. Si Runner no puede determinar si una acción externa se completó, verifica su resultado antes de volver a intentarlo para evitar duplicados. Consulta [Estados y detalles de tareas](../work-with-runner/task-states-and-details) para los controles disponibles en la conversación actual.
## Guías relacionadas
- [Chat con Runner](../work-with-runner/chat-with-runner)
- [Cuando Runner hace una pregunta](../work-with-runner/answer-runner-questions)
- [Escribir solicitudes efectivas](../work-with-runner/write-effective-requests)
- [Soporte y comunidad](./support-and-community)
---
# Solucionar problemas de compilaciones de tienda
Source: https://www.runnerai.com/docs/es/guides/help-and-reference/troubleshoot-storefront-builds
Las capturas y grabaciones muestran la interfaz en inglés.
La vista previa es el lugar más seguro para encontrar problemas de tienda. No publiques hasta que las páginas e interacciones importantes funcionen allí.
**Ruta de entrada:** Tienda afectada → **Tienda online** → controles de vista previa.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Utiliza la vista previa actual de Storefront y sus controles de dispositivo para reproducir la página afectada antes de publicar.
## Antes de empezar
- Abre la tienda afectada e identifica la página y el ancho del dispositivo donde aparece el problema.
- Deja que la última tarea de Runner se complete antes de comparar su resultado con la vista previa.
- Usa la vista previa primero; no publiques un resultado roto o incierto como prueba.
## Comienza en Tienda
1. Abre la tienda afectada y selecciona **Tienda online**.
2. Confirma que la vista previa muestre el proyecto esperado y la versión más reciente.
3. Recarga la vista previa una vez.
4. Verifica las vistas de dispositivos de escritorio y móvil.
5. Abre la página afectada a través de la navegación de vista previa.
6. Compara el resultado con la última tarea de Runner y el historial de versiones.
## Problemas comunes
| Lo que ves | Qué verificar |
| --- | --- |
| Vista previa en blanco o con error | Espera a que se complete la compilación activa, recarga una vez e inspecciona la tarea actual para detectar un fallo. |
| Contenido antiguo | Confirma que la última tarea se completó y que la vista previa está en la versión más reciente. |
| El diseño se rompe en un ancho | Reprodúcelo con los controles del dispositivo e indica a Runner la página, sección y ancho. |
| Imagen faltante | Verifica la Biblioteca de medios, la selección de activos y si la imagen misma se carga. |
| El enlace abre la página incorrecta | Nombra el botón de origen y el destino previsto en una corrección enfocada. |
| El producto falta | Verifica que el producto exista y esté disponible para la tienda, no solo que la página se vea pulida. |
| El cambio del Modo de diseño está ausente | Confirma que la edición se guardó o se aplicó, luego reabre la misma página en vista previa. |
## Controles útiles
| Control | Resultado |
| --- | --- |
| Actualizar vista previa | Recarga la vista previa actual sin publicarla. |
| Selector de dispositivo | Cambia el ancho de la vista previa para que puedas inspeccionar diseños responsivos. |
| Abrir vista previa o vista externa | Abre una vista previa más grande; no hace que la tienda sea pública. |
| Modo de diseño | Te permite seleccionar y ajustar el contenido visible de la tienda. |
| Historial de versiones | Muestra versiones guardadas y controles de restauración. La restauración cambia el estado del proyecto, así que revisa primero. |
## Escala con evidencia útil
Incluye el nombre del proyecto, la página, el tamaño del dispositivo, el resultado esperado, el resultado visible, el estado de la última tarea y una captura de pantalla sin datos personales o de clientes.
## Verifica la corrección
Después de que la tarea de reparación termine, recarga la misma página afectada y repite la interacción en el ancho de dispositivo original. Verifica un segundo ancho antes de publicar. Una página de inicio funcional por sí sola no es un punto de control de reparación para una página de producto o carrito rota.
### Mira: compara anchos de dispositivo en la vista previa
La grabación cambia entre las vistas previas de PC, Pad y Teléfono. Demuestra cómo comparar anchos, no una reparación de errores o un cambio publicado.
## Guías relacionadas
- [Vista previa de tu tienda](../storefront-and-publishing/preview-your-store)
- [Modo de diseño](../storefront-and-publishing/design-mode)
- [Historial de versiones](../storefront-and-publishing/version-history)
- [Solucionar problemas de tareas de Runner](./troubleshoot-runner-tasks)
---
# Abre tu primera tienda
Source: https://www.runnerai.com/docs/es/guides/open-your-first-store
Las capturas y grabaciones muestran la interfaz en inglés.
Esta guía es un único camino ordenado desde una idea de negocio hasta una tienda capaz de recibir dinero. Está escrita para personas que nunca han vendido nada en línea, así que explica los conceptos de comercio electrónico sobre la marcha.
¿Nuevo en Runner? Sigue [Construye tu primera tienda](./start-here/first-store-quickstart), con capturas de pantalla y videos cortos, luego regresa aquí para productos, envíos, pagos y configuración del negocio.
Para empezar necesitas una idea y una dirección de correo electrónico. El registro de la empresa, un dominio y una cuenta de Stripe llegan más tarde, en los pasos donde realmente hacen falta.
¿Ya vendes con Shopify? Usa [Conectar Shopify](./start-here/connect-shopify) en su lugar. Esta guía cubre la creación de una tienda desde cero.
## Tres estados y por qué son distintos
Una tienda pasa por tres estados, y no ocurren al mismo tiempo. Saber en cuál estás evita la mayor parte de la confusión de este proceso.
| Estado | Qué significa | Qué no significa |
| --- | --- | --- |
| **Vista previa** | Runner ha construido tu tienda y puedes verla. | No es pública. |
| **Publicado** | La tienda tiene una dirección web pública y cualquiera puede visitarla. | La publicación por sí sola no prueba que el pago esté listo; también se debe verificar la configuración de pago y proveedor. |
| **Pago listo** | Stripe está conectado y un pedido se puede pagar. | Este es el punto en el que la tienda está abierta al público. |
Publicar es el paso 7. Los pagos son el paso 9. Una tienda en línea no es necesariamente una tienda que funciona.
## Cómo usar esta guía
Once pasos en cuatro grupos.
| Grupo | Pasos |
| --- | --- |
| **Crear** | 1. Decidir qué vender · 2. Construir tu tienda |
| **Configurar** | 3. Datos de la tienda · 4. Productos · 5. Envío · 6. Políticas y confianza |
| **Salir a producción** | 7. Revisar y publicar · 8. Dominio personalizado (opcional) · 9. Conectar pagos |
| **Crecer** | 10. Primeros visitantes · 11. Operación semanal |
Sigue el orden. Varios pasos posteriores fallan en silencio si uno anterior queda incompleto: el envío no se guarda sin una ubicación de inventario, los productos no muestran precios sin un mercado, y el paso del dominio necesita una publicación exitosa previa. El paso 8 es la excepción: es opcional y puedes hacerlo en cualquier momento después de publicar.
Cada paso termina con algo que puedes verificar por ti mismo. La **Lista de lanzamiento** al final de esta guía los reúne en un solo lugar.
Runner hace más que construir la tienda. Puede investigar qué vender, sugerir productos, escribir descripciones, crear y actualizar registros del catálogo y redactar tus páginas de políticas. Cada paso incluye indicaciones que puedes copiar en el chat. Si algo no funciona, descríbelo: Runner puede leer el estado actual de tu tienda e identificar qué falta.
Las habilidades le dan a Runner un conjunto repetible de instrucciones para un tipo de trabajo. Abre **Agente** en la barra lateral, selecciona el filtro **Habilidades**, luego usa **Descubrir** y busca la tarea que estás realizando, como `market research`, `product description`, `policy` o `SEO`. Ver [Habilidades](./agent/skills).
**Si primero aparece un asistente de configuración.** Las tiendas nuevas pueden abrir una configuración guiada que pide los datos básicos, el envío, un primer producto, el pago y la visibilidad en una sola pasada. Cubre partes de los pasos 3, 4, 5 y 9 en otro orden. Completa lo que puedas, elige **Omitir** en el resto y usa los pasos siguientes para terminar bien lo omitido. Consulta [Incorporación y configuración general](./store-operations/onboarding-and-general-settings).
## Paso 1 — Decidir qué vender
El resto del proceso avanza más rápido cuando esto está resuelto. Calcula una tarde.
Necesitas tres respuestas: qué vendes, quién lo compra y de dónde viene. La tercera condiciona varios pasos posteriores.
- **Tener tu propio inventario.** Compras o fabricas los productos y envías cada pedido tú mismo. Más margen, más trabajo y dinero gastado antes de la primera venta.
- **Dropshipping.** Un proveedor mantiene el inventario y envía cada pedido en tu nombre. Arranque más rápido y sin comprar stock, con márgenes más ajustados y menos control sobre los plazos.
Runner admite ambos, y puedes cambiar más adelante. Consulta [Dropshipping](./store-operations/dropshipping).
**Preguntar a Runner**
> Quiero abrir una tienda pero no he decidido qué vender. Me interesa [tema] y puedo
> invertir unos [presupuesto]. ¿Qué se está vendiendo bien y qué ventajas e
> inconvenientes tiene cada opción?
> ¿Debería hacer dropshipping de [producto] o tener mi propio inventario?
> Es mi primera tienda.
> ¿Quién compra [producto]? ¿Qué les importa y qué precio esperan?
**Listo cuando** puedas decir qué vendes, quién lo compra y de dónde viene. Guarda esa descripción: la pegarás en el chat en el paso 2.
**Déjalo para después:** dominio, logotipo y registro de la empresa. Cada uno sale más barato de decidir una vez definido el producto.
## Paso 2 — Construir tu tienda
Usa el [tutorial ilustrado de la primera tienda](./start-here/first-store-quickstart) para crear tu tienda, enviar la descripción del paso 1, revisar la vista previa y solicitar un cambio enfocado.
Antes de continuar, verifica que:
- La nueva tienda aparece en tu espacio de trabajo.
- Las páginas principales de vista previa se abren en escritorio y móvil.
- El cambio que solicitaste es visible en la vista previa.
Una vista previa funcional no publica tu tienda. Continúa con la configuración del negocio a continuación; la publicación es el paso 7.
## Paso 3 — Configurar los datos de la tienda
La identidad pública de tu tienda y dónde vende. Unos 10 minutos, y varios pasos posteriores dependen de ello.
**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → General**
1. Abre **Operaciones de la tienda → General**.
2. Introduce el nombre de la tienda, un correo de contacto y tu dirección comercial. El nombre está limitado a 30 caracteres y el correo debe ser una dirección válida.
3. En **Markets**, añade los países a los que vendes y establece la moneda.
4. En **Ubicaciones de inventario**, añade la dirección desde la que salen los pedidos. Un domicilio particular es válido.
5. Selecciona **Guardar** y espera al estado guardado.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Detalle completo: [Incorporación y configuración general](./store-operations/onboarding-and-general-settings).
**Preguntar a Runner**
> Vendo a [países]. ¿Qué configuración de mercado y moneda debería usar?
**Listo cuando** General esté guardado con nombre de tienda, un correo de contacto válido, al menos un mercado y una ubicación de inventario.
**Conviene saber**
- La moneda se define por mercado, no por producto. Un producto con precio en una moneda fuera de tus mercados guardados muestra una advertencia y puede no mostrar precio en la tienda.
- La visibilidad de la tienda y la publicación son cosas distintas. **Visible para clientes** controla si la tienda se muestra. No pone en línea el código de tu tienda: eso es el paso 7.
- Este es un buen momento para empezar con Stripe. Los pagos son el paso 9, pero la revisión de tus datos por parte de Stripe puede tardar. Empezar ahora hace que la espera ocurra en segundo plano y no el día del lanzamiento.
## Paso 4 — Añadir tus productos
Necesitas al menos un producto completo y vendible. La duración depende por completo de cómo te abastezcas.
**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Productos**
Tres vías, y puedes combinarlas.
| Vía | Cuándo usarla | Dónde |
| --- | --- | --- |
| **Crear manualmente** | Tienes productos propios | **Productos → Añadir** |
| **Dropshipping** | Un proveedor almacena y envía por ti | **Operaciones de la tienda → Dropshipping** |
| **Importación CSV** | Ya tienes el catálogo en una hoja de cálculo | **Productos → Importar** |
Un catálogo vacío muestra **Añadir primer producto** en lugar de **Añadir** e **Importar**.
Un producto completo necesita nombre y descripción, un precio en una moneda que coincida con un mercado guardado, al menos una imagen, inventario y estado **Publicado**. Un producto en **Borrador** no aparece a los clientes. Los productos físicos también necesitan peso y dimensiones, porque el envío y la logística dependen de ellos.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Detalle: [Productos](./store-operations/products) · [Dropshipping](./store-operations/dropshipping) · [Importar productos](./store-operations/import-products) · [Inventario y variantes](./store-operations/inventory-and-variants)
**Pregunta a Runner.** No tienes que rellenar estos formularios tú mismo. Runner puede crear y actualizar productos, inventario e imágenes desde el chat, y ayudarte a elegir con qué empezar.
> ¿Con cuál debería empezar? [lista] — ten en cuenta el margen y la facilidad de envío.
> Escribe una descripción para [producto]. Lo que más importa a los clientes es
> [aspecto clave].
> Pon el inventario de [producto] en 50 y marca la variante azul como agotada.
> Revisa mi catálogo y dime qué productos no tienen imagen, precio o inventario.
Nombra el registro y el resultado exacto que quieres, y autoriza los cambios destructivos de forma explícita.
**Listo cuando** al menos un producto esté **Publicado**, con precio en una moneda de mercado guardada, con imagen e inventario, y aparezca en la vista previa de la tienda.
**Conviene saber**
- Los cambios de stock solo se conservan cuando hay una ubicación de inventario guardada. Eso forma parte del paso 3: añádela allí si te la saltaste.
- Los productos de dropshipping pueden comportarse de forma distinta a los gestionados manualmente en coste e inventario. Antes de añadir un artículo, confirma destino, un método de envío utilizable y un precio de venta para cada variante.
- La importación CSV necesita la plantilla actual de Runner. `Product Handle` y `Product Title` son obligatorios, y las filas de variantes requieren `Variant SKU` y los valores de opción.
## Paso 5 — Configurar el envío
Runner necesita saber desde dónde salen los pedidos y cuánto cobras por entregarlos. Unos 15 minutos.
Aquí el orden importa. El envío no se guarda sin la ubicación de inventario y el mercado que guardaste en el paso 3.
**Ruta de acceso:** **Operaciones de la tienda → General → Envío**
1. Abre **Operaciones de la tienda → General**.
2. Comprueba que la **Ubicación de inventario** guardada en el paso 3 sigue ahí. Es la dirección desde la que salen los pedidos.
3. Confirma que hay al menos un país guardado en **Markets**.
4. Ve a **Envío** y selecciona **Añadir**.
5. Da a la opción un nombre que los clientes reconozcan, como la velocidad o el método de entrega.
6. Elige el país de destino en **Enviar a** y abre **Costo de envío**. La tarifa plana es la opción más sencilla. Introduce `0` para que la entrega se muestre como gratuita.
7. Selecciona **Guardar** en el diálogo, luego **Guardar** en la página, y espera al estado guardado.
Para tramos por precio y los demás tipos de tarifa, consulta [Envío](./store-operations/shipping). Si un transportista o proveedor se encarga de la entrega, puede que también necesites una conexión en **Apps**: consulta [Shippo](./apps-and-integrations/shippo-shipping), [CJ Dropshipping](./apps-and-integrations/cj-dropshipping) o [Logística 4PX](./apps-and-integrations/4px-fulfillment).
**Preguntar a Runner**
> Envío desde [lugar] a [países]. ¿Qué opciones de envío debería configurar?
> ¿Merece la pena ofrecer envío gratuito en un producto de [precio] o debería cobrarlo?
**Listo cuando** en el pago aparezca una opción de entrega con precio. Añade un producto al carrito y compruébalo ahí, no en la página de configuración.
**Conviene saber**
- Una tienda sin una opción de envío válida parece normal en todas partes menos en el pago, donde el cliente no puede completar el pedido. Es un motivo frecuente de que una tienda aparentemente terminada no venda.
- Las opciones de envío usan la ubicación de inventario guardada en General. No hay un selector **Enviar desde** por fila.
- Guardar falla sin una región de mercado predeterminada. Guarda Mercados antes que Envío.
- Los productos digitales, las reservas y los artículos gestionados por proveedor pueden seguir otras reglas.
## Paso 6 — Dar cumplimiento legal y confianza
Estas son las páginas que dicen a los clientes quién eres y qué ocurre si algo sale mal. Runner puede redactarlas todas. Tu trabajo es comprobar que coinciden con cómo operas realmente.
La mayoría de tiendas necesitan una política de reembolso y devolución, una política de envío con plazos realistas, una política de privacidad, condiciones del servicio, una forma de contacto y una página "acerca de".
**Preguntar a Runner**
> Redacta una política de reembolso y devolución. Vendo [qué], envío desde [lugar]
> y quiero un plazo de devolución de [número] días.
> Redacta las páginas de política de privacidad y condiciones del servicio y añádelas
> al pie de página de la tienda.
> Escribe una página "acerca de" con lo que te he contado de mi negocio.
Después revisa los borradores:
1. Lee cada página y corrige lo que no coincida con tus condiciones reales: plazo de devolución, quién paga el envío de vuelta y cuánto tarda realmente la entrega.
2. Comprueba que las páginas se muestran en la tienda y están enlazadas en el pie. Consulta [Editar contenido, páginas y medios](./storefront-and-publishing/edit-content-pages-and-media).
3. Comprueba que la dirección de contacto coincide con el correo guardado en el paso 3.
**Listo cuando** cada página de política se abra desde el pie de la tienda y refleje tus condiciones reales.
**Conviene saber.** Los borradores son un punto de partida, no asesoramiento legal. El registro fiscal, las normas de protección al consumidor y la información obligatoria dependen de dónde operas y qué vendes. Si tienes dudas, consulta a un profesional local antes del lanzamiento.
Las reseñas de producto son otra señal de confianza y se configuran en General. Activar las reseñas no añade componentes que falten en una tienda antigua: pide a Runner que añada la funcionalidad y publica ese cambio. Consulta [Reseñas](./store-operations/reviews-and-advanced-admin).
## Paso 7 — Revisar y publicar
Publicar pone tu tienda en línea en una dirección pública. Las comprobaciones tardan unos minutos. Arreglar lo que encuentran puede llevar más.
**Ruta de acceso:** **Espacio de trabajo → seleccionar una tienda → Tienda online → Publicar**
1. Recorre primero la [lista de preparación para publicar](./storefront-and-publishing/prepare-to-publish).
2. Abre **Tienda online** y selecciona el botón de publicación. Según el estado dirá **Publicar**, **Publicar cambios** o **Republicar**.
3. Lee **Confirmar Implementación** y espera a que termine la verificación de la compilación.
4. Resuelve cada advertencia mostrada, o acéptala de forma deliberada.
5. Selecciona **Confirmar** solo cuando la comprobación haya tenido éxito.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Detalle: [Publicar y republicar](./storefront-and-publishing/publish-and-republish).
**Preguntar a Runner**
> Comprueba si mi tienda está lista para publicar y enumera lo que todavía falta.
> La comprobación de publicación está bloqueada en [elemento]. ¿Qué hago?
**Listo cuando** la URL pública de la tienda se abra en una ventana de navegación privada.
**Conviene saber.** Dos cosas sorprenden en este paso. Tu tienda es pública pero todavía no puede cobrar: eso es el paso 9, el que realmente la abre al público. Y los cambios posteriores no están en línea hasta que vuelvas a publicar: guardar una edición en modo de diseño, restaurar una versión o ver una vista previa correcta no actualiza por sí solo la tienda pública.
Los cambios en Operaciones de Tienda funcionan distinto. Productos, precios, inventario y envío se aplican sin republicar.
**Si una comprobación te bloquea,** usa la acción que aparece en ese elemento: **Abrir Operaciones de la tienda**, **Corregir con IA** o **Reintentar comprobación**. Si persiste, consulta [Solucionar publicación, pago y aplicaciones](./help-and-reference/troubleshoot-publishing-checkout-apps) y [Solucionar compilaciones de la tienda](./help-and-reference/troubleshoot-storefront-builds).
## Paso 8 — Conectar un dominio personalizado (opcional)
**Este paso es opcional.** Tu tienda ya funciona en la dirección que Runner te dio al publicar. Un dominio personalizado es cuestión de marca, no de funcionamiento. Omitirlo no bloquea los pagos ni nada posterior, y puedes volver cuando quieras.
La configuración lleva unos 10 minutos, seguidos de una espera a que se propague el DNS. La tienda necesita una publicación exitosa previa, y el acceso depende de tu plan.
**Ruta de acceso:** **Tienda online** → menú del sitio publicado → **Configuración del dominio**. En móvil, o si ese menú está oculto, usa **Configuración → Tienda: _nombre de la tienda_ → Dominio** en el espacio de trabajo.
1. Abre **Configuración del dominio** por cualquiera de las rutas anteriores.
2. Compra un dominio a través de Runner, o añade uno que ya tengas.
3. Si añades uno propio, copia los registros DNS que muestra Runner en la configuración de tu proveedor de dominios.
4. Espera la verificación. La fila del dominio muestra una advertencia hasta que los registros se resuelvan.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Detalle: [Conecta un dominio personalizado](./storefront-and-publishing/custom-domains).
**Listo cuando** tu dominio abra la tienda, o cuando hayas decidido dejarlo para más adelante.
**Conviene saber**
- **Dominio agregado exitosamente** solo confirma que el dominio está asociado a tu tienda, no que el DNS funcione. Se comprueban por separado y los cambios de DNS pueden tardar varias horas.
- Comprar o renovar un dominio inicia un flujo de pago externo. Revisa los datos antes de continuar.
- Si vas a lanzar pronto, conecta primero los pagos. Una tienda en la dirección por defecto que cobra vale más que una con marca propia que no puede cobrar.
## Paso 9 — Conectar pagos
Este es el paso que abre la tienda al público. Todo lo anterior era preparación.
Tu tienda puede estar ya en línea y parecer terminada. Hasta que este paso esté hecho, un cliente que intente comprar no podrá completar la compra.
**Ruta de entrada:** **Apps → Gestiona tu tienda → Stripe**. Después de publicar, Runner también puede mostrar **Conectar Stripe** en la entrega de la tienda, lo que abre la misma configuración.
Stripe recopila datos del negocio, información de identidad y datos bancarios para los pagos. Tenlos a mano y usa un navegador que permita abrir la ventana de Stripe.
1. Abre **Apps → Gestiona tu tienda → Stripe** y selecciona **Conectar**.
2. Completa la configuración de Stripe en la ventana nueva.
3. Vuelve a Runner y confirma que la conexión aparece como habilitada.
| Estado | Qué significa |
| --- | --- |
| **Conectando...** | Runner está preparando la cuenta o el enlace de configuración. Espera un resultado. |
| **En revisión** | Stripe está revisando tus datos. Es su proceso, no un error de Runner, y puede tardar. |
| **Acciones de Stripe requeridas** | Hay algo concreto pendiente. Ábrelo para ver qué está **Vence ahora**, **Vence más tarde** o **En revisión**. |
| **Reconectar** o **Continuar incorporación** | Existe una cuenta pero está incompleta. Al seleccionarlo se reanuda la misma cuenta. |
Detalle: [Conectar Stripe para pagos](./apps-and-integrations/stripe-payments).
Abre tu tienda en un teléfono. Revisa un producto, agrégalo al carrito, ingresa una dirección de entrega y confirma que aparezca una opción de envío y el paso de pago. Detente antes de enviar el pago.
Si eliges probar un pago real, realiza un pedido de prueba deliberado y revísalo en [Orders](./store-operations/orders). Un cargo real y cualquier reembolso pueden incurrir en tarifas; esto es opcional y separado del recorrido de configuración.
**Preguntar a Runner**
> Stripe muestra [estado]. ¿Qué significa y qué debo hacer ahora?
> Un cliente dice que el pago no funciona. ¿Qué debería comprobar?
**Has terminado cuando** Stripe no muestra acciones de configuración bloqueantes y tu producto, carrito, opción de envío y paso de pago funcionan juntos. Estas verificaciones confirman la preparación para el pago; solo un pago completado confirma una transacción real.
**Conviene saber.** Una URL activa no demuestra que los pagos estén disponibles. La tienda puede estar publicada mientras el pago sigue pausado o en revisión. Consulta [Tienda en vivo y pago](./storefront-and-publishing/live-store-and-checkout).
## Paso 10 — Conseguir tus primeros visitantes
Nadie llega solo. Empieza por lo que no cuesta dinero y no gastes en anuncios hasta confirmar el paso 9.
- **Búsqueda.** En una tienda nueva, los títulos y descripciones de producto son lo que más pesa. Consulta [Resumen de SEO](./analytics-and-seo/seo-overview) y [Rendimiento de búsqueda](./analytics-and-seo/search-performance).
- **Analítica.** Confirma que se registran las visitas antes de juzgar nada. Consulta [Resumen de analítica](./analytics-and-seo/analytics-overview).
- **Visibilidad en IA.** Cómo aparece tu tienda cuando alguien pide recomendaciones a asistentes de IA. Consulta [Visibilidad en IA](./analytics-and-seo/ai-visibility).
- **Creatividades.** Imágenes y variantes de anuncios desde [Creative Studio](./automate-test-and-create/creative-studio), y campañas con [Runner Ads](./automate-test-and-create/runner-ads).
**Preguntar a Runner**
> Mejora los títulos y descripciones SEO de mis páginas de producto.
> Crea tres creatividades de anuncio para [producto] dirigidas a [audiencia].
> Mi tienda lleva una semana en línea sin ventas. ¿Qué debería revisar primero?
**Listo cuando** la analítica muestre sesiones de personas distintas de ti.
**Conviene saber.** Poco tráfico y poca conversión son problemas distintos con soluciones distintas. Revisa primero el tráfico: la conversión no se puede diagnosticar con diez visitas. Consulta [Tráfico y conversión](./analytics-and-seo/traffic-and-conversion). Si la analítica no muestra nada, confirma que la tienda está publicada y la fuente de datos conectada antes de cambiar otra cosa. Consulta [Solucionar datos y publicación](./analytics-and-seo/troubleshoot-data-and-publication).
## Paso 11 — Gestionar tu tienda cada semana
Una rutina corta mantiene la tienda sana una vez que empiezan a llegar pedidos.
1. Revisa [Pedidos](./store-operations/orders) y prepara lo pendiente.
2. Responde a los mensajes de clientes y gestiona devoluciones. Consulta [Clientes](./store-operations/customers).
3. Revisa los niveles de stock en [Inventario y variantes](./store-operations/inventory-and-variants).
4. Mira [Analítica](./analytics-and-seo/analytics-overview) para ver qué ha cambiado desde la semana pasada.
Cuando tengas tráfico suficiente, prueba los cambios en lugar de adivinar con [Experimentos](./automate-test-and-create/experiments), delega el trabajo repetitivo en [Automatizaciones](./automate-test-and-create/automations) y lanza [Promociones](./store-operations/promotions) para productos o periodos concretos.
**Preguntar a Runner**
> Resume los pedidos de esta semana y señala lo que necesita atención.
> ¿Qué productos se han vendido mejor este mes y cuáles no se mueven?
**Conviene saber.** Los cambios en la tienda requieren publicar de nuevo antes de que los clientes los vean. Los cambios en Operaciones de Tienda se aplican sin republicar. Antes de autorizar desde el chat una acción destructiva o del ciclo de vida de un pedido, pide a Runner que inspeccione el estado actual y luego autoriza el efecto exacto que quieres.
## Lista de lanzamiento
Cada elemento es algo que puedes verificar tú mismo. Si confirmas los ocho elementos obligatorios, tu tienda está abierta al público.
**Obligatorio**
- [ ] Puedes decir qué vendes, quién lo compra y de dónde viene. (Paso 1)
- [ ] La vista previa de la tienda carga y tus páginas principales funcionan en escritorio y móvil. (Paso 2)
- [ ] General está guardado con nombre de tienda, correo de contacto válido, al menos un mercado y una ubicación de inventario. (Paso 3)
- [ ] Al menos un producto está publicado, con precio en una moneda de mercado guardada, imagen e inventario. (Paso 4)
- [ ] En el pago aparece una opción de entrega con precio al añadir un producto al carrito. (Paso 5)
- [ ] Tus páginas de políticas se abren desde el pie de la tienda y coinciden con tus condiciones reales. (Paso 6)
- [ ] La URL pública de la tienda se abre en una ventana de navegación privada. (Paso 7)
- [ ] Stripe no tiene acciones de configuración bloqueantes, y el carrito llega al paso de pago con la opción de envío esperada. (Paso 9)
**Opcional, en cualquier momento tras publicar**
- [ ] Tu dominio personalizado abre la tienda. (Paso 8)
**Después del lanzamiento**
- [ ] La analítica muestra sesiones de personas distintas de ti. (Paso 10)
- [ ] Tienes una rutina semanal para pedidos, stock y clientes. (Paso 11)
Si algún elemento no se confirma, describe en el chat lo que estás viendo.
> Comprueba mi tienda con la lista de lanzamiento y dime qué sigue incompleto.
## Guías relacionadas
- [Empezar con Runner](./start-here)
- [Chatear con Runner](./work-with-runner/chat-with-runner)
- [Operaciones de Tienda](./store-operations)
- [Aplicaciones e integraciones](./apps-and-integrations)
- [Ayuda y referencia](./help-and-reference)
- [Glosario](./help-and-reference/glossary)
---
# Planes y facturación
Source: https://www.runnerai.com/docs/es/guides/plans-and-billing
Las capturas y grabaciones muestran la interfaz en inglés.
Runner mide el trabajo en Créditos y vende capacidad como suscripción. Estas dos páginas separan la decisión del día a día: en una eliges y gestionas un plan, en la otra lees y aprovechas el saldo resultante.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Esta captura muestra Gratis, Plus y Pro. Desplázate en el producto para ver Max; usa los valores actuales de cuenta y pago en lugar de los precios capturados aquí.
| Tu objetivo | Empieza aquí |
| --- | --- |
| Comparar Gratis, Plus, Pro y Max, o cambiar una suscripción | [Planes de suscripción](/es/guides/plans-and-billing/subscription-plans) |
| Ver qué logra un saldo, leer el uso o ganar Créditos | [Créditos y uso](/es/guides/plans-and-billing/credits-and-usage) |
Abre el menú del espacio de trabajo deseado → **Configuración → Plan y Facturación** para comparar planes, o **Uso y créditos** para inspeccionar el gasto. La [página de precios](https://www.runnerai.com/pricing) actual, tu cuenta y la confirmación antes del pago muestran los valores aplicables.
---
# Créditos y uso
Source: https://www.runnerai.com/docs/es/guides/plans-and-billing/credits-and-usage
Las capturas y grabaciones muestran la interfaz en inglés.
Los Créditos son la unidad universal de uso de Runner. Las operaciones elegibles de LLM, imagen, vídeo, automatización, flujo de trabajo, simulación, habilidades y despliegue se descuentan todas de un único saldo mostrado.
## Qué cubre esta guía
Estimar qué logra un saldo, seleccionar un rango de informe y leer cada bloque contra ese mismo rango, ganar Créditos de bonificación y comprender cómo se registra el uso.
## Disponibilidad y requisitos previos
- El uso está limitado al espacio de trabajo actual, no a una tienda.
- Los datos pueden estar vacíos cuando el espacio de trabajo no ha usado Créditos en el rango seleccionado.
- Las concesiones de Créditos, vencimiento y elegibilidad de compra dependen de la concesión o plan mostrado en tu cuenta.
- Usa **Uso y créditos** para tu saldo y gasto registrado; usa la confirmación de compra actual para los precios.
## Ruta de acceso
Abre el espacio de trabajo deseado, luego selecciona **Configuración → Uso y Créditos**. Confirma el nombre del espacio de trabajo en la barra lateral de configuración.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Abre **Uso y créditos** bajo el espacio de trabajo deseado. Esta imagen muestra la entrada, no un saldo o uso registrado; inspecciona esos valores en tu propio espacio de trabajo.
## Qué logra un saldo
Usa tus propias tareas recientes para estimar el próximo cambio similar. Comienza con una solicitud pequeña y bien definida, luego verifica sus Créditos registrados en la actividad del Espacio de trabajo. La elección del modelo, el tamaño del contexto, la longitud de la salida, los medios, los reintentos y la complejidad de la tarea cambian el total; no hay un precio fijo por mensaje ni un número garantizado de construcciones de tienda por saldo.
### Estima tu próxima construcción de tienda
1. Abre **Configuración → Uso y Créditos** en el espacio de trabajo donde construirás.
2. Haz una solicitud pequeña y representativa, luego encuentra su gasto registrado en **Actividad del espacio de trabajo**.
3. Compara tareas recientes de alcance y elección de modelo similares. Estima la generación inicial y las revisiones posteriores por separado.
4. Añade el trabajo que prevés repetir y ten en cuenta el coste de generar imágenes o vídeos, los reintentos y los cambios más grandes. Vuelve a comprobar el gasto registrado después de cada etapa.
Por ejemplo, **si tu propia actividad** registra 200 Créditos para generación y 20 Créditos para cada una de tres revisiones similares, esas tareas suman **260 Créditos**. Estos números ilustran el cálculo; no son costos típicos, un punto de referencia o una cotización para tu próxima tienda.
**Verifica:** Tu estimación proviene de tareas registradas comparables. Un saldo de Créditos no garantiza un número fijo de tiendas o revisiones.
Para la asignación mensual incluida con cada plan, consulta [Planes de suscripción](./subscription-plans).
## Controles e informes
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| **7 días** | Inspecciona actividad reciente. | Cada gráfico, resumen, categoría y bloque de actividad se actualiza a siete días. |
| **Este ciclo** | Revisa la ventana del ciclo de facturación actual. | La página usa el ciclo actual transcurrido mostrado para el espacio de trabajo. |
| **90 días** | Busca una tendencia más larga. | Cada bloque de uso se actualiza al rango más largo. |
| Tarjeta Créditos restantes | Ve Créditos restantes y totales para el plan/concesiones actual. | La barra de progreso y fecha de actualización mostrada explican el estado del saldo actual. |
| **Mejorar** | Compara planes cuando se necesita más capacidad incluida. | Runner abre **Plan y Facturación**. |
| **Comprar Créditos** | Revisa una compra de Créditos adicionales elegible. | Runner abre **Plan y Facturación**; ninguna compra ocurre hasta que se complete su confirmación. |
| Créditos por día | Encuentra fechas ocupadas o tranquilas. | Pasar el ratón sobre una barra muestra el uso de ese día. |
| De dónde vinieron tus Créditos | Comprende las concesiones de plan, diarias, de registro, compradas y otras que se aplican. | Cada fila muestra fuente, cadencia, nota y Créditos. |
| A dónde fueron tus Créditos | Compara categorías de gasto y recuentos de ejecución. | Las barras muestran la parte de cada categoría para el rango seleccionado. |
| Actividad del espacio de trabajo | Inspecciona tareas recientes detrás del gasto. | Las pestañas de categoría filtran las mismas columnas Tarea, Proyecto, Tipo, Créditos y Hora. |
## Revisa el uso
1. Abre **Espacio de trabajo → Uso y Créditos**.
2. Selecciona **7 días**, **Este ciclo** o **90 días**.
3. Lee **Créditos restantes** antes de interpretar gasto.
4. Compara **Usado en rango**, **Promedio diario** y **Día de mayor uso**.
5. Usa **Créditos por día** para encontrar cuándo cambió el uso.
6. Compara fuentes con categorías de gasto.
7. Filtra **Actividad del espacio de trabajo** para identificar las tareas involucradas.
8. Si necesitas más capacidad, abre **Mejorar** o **Comprar Créditos**, luego revisa la confirmación de facturación separada.
## Gana Créditos de bonificación
Abre el check-in o misión mostrada en tu cuenta y lee la recompensa antes de reclamarla. Después de un reclamo exitoso, regresa a **Uso y créditos** e inspecciona la fuente y el saldo.
Los check-ins diarios, los bonos por días consecutivos y las misiones introductorias tienen elegibilidad y límites separados. Lee el límite actual y la expiración adjunta a cada concesión; un límite de ganancias mensual y un saldo máximo de bonificación almacenado son límites diferentes. No trates los Créditos de bonificación como un saldo de rollover indefinido.
## Cómo se registra el uso
- El uso se registra después de que una operación termina y puede tardar un poco en aparecer.
- Una sola solicitud puede producir varios registros cuando Runner usa varios modelos, herramientas, operaciones de medios, simulaciones o despliegues.
- Si un total parece inesperado, compara la marca de tiempo, el proyecto, el tipo de acción, el modelo o proveedor y cualquier reintento antes de contactar con soporte.
## Comprende los números
- El saldo restante y el gasto del rango seleccionado responden preguntas diferentes; no necesitan ser iguales.
- El gráfico Créditos por día reporta gasto diario, mientras que la tarjeta de fuente reporta concesiones y saldo restante.
- Una categoría puede mostrar ejecuciones con gasto de Créditos cero.
- Las filas de actividad muestran tareas recientes para escanear, no un registro de auditoría permanente completo.
- Las fechas usan la zona horaria en tu dispositivo actual.
## Preguntas frecuentes
| Pregunta | Respuesta |
| --- | --- |
| ¿Por qué dos indicaciones similares usaron cantidades diferentes? | Pueden haber usado distintos tamaños de contexto, longitudes de salida, herramientas, modelos, pasos del agente, reintentos, alternativas, medios, simulaciones o despliegues. |
| ¿Enviar un mensaje consume un número fijo de Créditos? | No. Los Créditos siguen a las operaciones medidas que realmente se realizaron para la solicitud. |
| ¿Las ediciones manuales consumen Créditos? | Editar contenido o código tú mismo no genera uso de modelo. Pedir a Runner que haga o explique la edición sí puede hacerlo. |
| ¿Las solicitudes fallidas siempre son gratuitas? | No necesariamente. Un fallo sin uso reportado por el proveedor no tiene coste de modelo, pero el uso reportado antes de un fallo, o durante otro intento exitoso, sí puede registrarse. |
| ¿Una habilidad se cobra por separado? | No. Activar una habilidad no añade una tarifa fija; las operaciones que realiza se descuentan del mismo saldo. |
| ¿Los Créditos de bonificación se acumulan? | Lee la expiración en cada concesión. Los límites de ganancias de check-in, los límites de saldo almacenado y los bonos por racha pueden seguir reglas diferentes. |
| ¿Cómo funciona la bonificación del séptimo registro? | Cada registro diario elegible otorga 10 Créditos, y cada séptima reclamación consecutiva añade una bonificación por racha. La pantalla de reclamación muestra el importe actual antes de recogerlo. |
| ¿Un Paquete de impulso es una suscripción? | No. Es una compra única de 350 Créditos por 9,90 USD. |
## Estados y límites
- **Sin Créditos** destaca un saldo restante cero y mantiene acciones de facturación disponibles.
- Actividad vacía dice que no hay registros para el filtro o rango actual.
- Una fuente puede mostrar cero cuando es accionable pero aún no se ha reclamado.
- Los tipos de concesión pasiva aparecen solo cuando contribuyeron Créditos.
- La carga cubre datos de saldo y consumo; espera a que se carguen todas las tarjetas antes de compararlas.
## Solución de problemas
- Si dos números parecen inconsistentes, confirma que cada bloque está usando el mismo rango seleccionado.
- Si falta una tarea, borra el filtro de categoría de actividad e intenta un rango más largo.
- Si el saldo no cambió después de una compra, regresa a Plan y Facturación y confirma que la compra alcanzó un estado completado antes de actualizar.
- Si no aparece uso, verifica que abriste el espacio de trabajo donde se ejecutó la tarea.
- Si necesitas una decisión de cargo o plan, usa Plan y Facturación en lugar de una captura de pantalla de uso antigua.
- Ante un cargo inesperado o un requisito de tratamiento de datos, escribe a team@adaptivemachines.ai indicando el espacio de trabajo, el proyecto, la marca de tiempo aproximada y los detalles del evento de uso.
## Guías relacionadas
- [Planes de suscripción](./subscription-plans)
- [General del espacio de trabajo](../account-and-settings/workspace-general)
- [Personalización del agente](../agent)
---
# Planes de suscripción
Source: https://www.runnerai.com/docs/es/guides/plans-and-billing/subscription-plans
Las capturas y grabaciones muestran la interfaz en inglés.
Plan y Facturación es el lugar a nivel de espacio de trabajo para suscripciones, cambios de plan, gestión de facturación y compras de Créditos adicionales elegibles. Usa los valores mostrados allí porque los nombres de planes, límites y precios pueden cambiar.
## Qué cubre esta guía
Comparar los planes de Runner y lo que incluye cada uno, revisar una acción de plan antes del pago, reconocer cambios programados o pendientes, y abrir la gestión de facturación segura.
## Disponibilidad y requisitos previos
- Abre el espacio de trabajo cuyo plan deseas gestionar.
- Las acciones de facturación pueden requerir permiso de facturación del espacio de trabajo.
- Los Paquetes de impulso requieren una suscripción activa elegible.
- Una suscripción vencida o heredada puede mostrar controles diferentes o bloquear una nueva acción.
## Ruta de acceso
Abre el espacio de trabajo deseado, luego selecciona **Configuración → Plan y Facturación**. Confirma el nombre del espacio de trabajo en la barra lateral de configuración.
La página pública de precios y Plan y Facturación se abren en **Mensual** de forma predeterminada. Una suscripción existente o un enlace explícito a un período de facturación pueden abrir el período correspondiente en su lugar.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Gratis, Plus y Pro son visibles en esta captura; desplázate para ver Max. Los precios son un ejemplo de interfaz desactualizado. Revisa el período de facturación actual y el total antes de cualquier pago.
## Compara los planes
Esta tabla resume los planes. La [página de precios](https://www.runnerai.com/pricing) actual y la confirmación que se muestra antes del pago son las fuentes oficiales.
| Plan | Créditos incluidos | Acceso a modelos y funciones | Ideal para |
| --- | --- | --- | --- |
| Gratis | 150 Créditos al registrarte, más hasta 250 mediante misiones introductorias | Runner Lite, y vistas previas limitadas de funciones avanzadas seleccionadas | Probar Runner y generar una primera tienda |
| Plus | 1.000 Créditos recargados mensualmente | Runner Lite, y vistas previas limitadas de funciones avanzadas seleccionadas | Cambios pequeños habituales e iteración constante sobre una tienda |
| Pro | 2.500 Créditos recargados mensualmente | Runner Pro, además de Creative Studio, automatizaciones, flujos de trabajo, simulaciones, Experimentos y Ads | Construcción compleja y el conjunto de funciones avanzadas |
| Max | 10.000 Créditos recargados mensualmente | Runner Max, además de límites de salida más altos y procesamiento prioritario en períodos de alto tráfico | Trabajo intenso o urgente, sujeto a disponibilidad |
La disponibilidad, duración y límites de las vistas previas pueden variar durante el lanzamiento y aparecen en tu cuenta. Para saber qué logran esos Créditos en la práctica, consulta [Créditos y uso](./credits-and-usage).
## Modelos de Runner
Runner ofrece tres modelos para que elijas el equilibrio entre calidad, velocidad y Créditos sin gestionar los ID de modelo del proveedor.
| Modelo | Incluido con | Equilibrio previsto |
| --- | --- | --- |
| Runner Lite | Gratis y Plus | Trabajo rápido y económico para tareas sencillas |
| Runner Pro | Pro | Capacidad equilibrada para construcción compleja y funciones avanzadas |
| Runner Max | Max | Máxima capacidad, límites de salida más altos y acceso prioritario cuando el tráfico es alto |
Usa el selector de modelos para ver las opciones disponibles para la tarea actual. La disponibilidad puede cambiar; un plan no promete una lista permanente de modelos de proveedores subyacentes.
## Controles
| Entrada o botón | Por qué es útil | Qué sucede después |
| --- | --- | --- |
| Banner del plan actual | Confirma qué plan del espacio de trabajo está activo y su estado mostrado. | Runner puede mostrar información de renovación, fin, validez o cambio pendiente. |
| **Mensual / Anual · Ahorra 20%** | Compara planes en el período de facturación deseado. | Las tarjetas de plan se actualizan. Mensual puede desactivarse para un compromiso anual activo. |
| Tarjeta de plan | Compara características incluidas y límites. | Seleccionar una acción disponible se mueve a un paso de confirmación de plan. |
| Acción **Mejorar** o cambio de período | Inicia un cambio de plan. | Runner muestra una confirmación, programa el cambio, solicita pago o abre el pago según el estado de la cuenta. |
| **Gestionar** / **Gestionar facturación** | Actualiza métodos de pago, revisa facturas o gestiona la cancelación. | Runner abre el portal de facturación seguro. |
| **Cancelar** junto a un cambio pendiente | Retira un cambio de plan programado. | Runner actualiza la suscripción actual después del éxito. |
| Paquete de impulso de crédito | Compra Créditos adicionales cuando sea elegible. | La cantidad y el total se muestran antes de **Confirmar compra**. |
## Revisa un cambio de plan
1. Abre **Espacio de trabajo → Plan y Facturación**.
2. Confirma el espacio de trabajo y banner del plan actual.
3. Selecciona **Mensual** o **Anual · Ahorra 20%** si ambos están disponibles.
4. Revisa las tarjetas del plan actual, límites de características y monto mostrado.
5. Selecciona la acción de plan deseada.
6. Lee la confirmación cuidadosamente. Para Anual, compara el total anual, no solo un equivalente mensual mostrado. Cierra o cancela el diálogo si solo estás comparando; no continúes si el plan, período o monto es incorrecto.
7. Completa el pago solo en la página de pago seguro o de facturación.
8. Regresa a Plan y Facturación y confirma el estado resultante. Una redirección de carga o pago por sí sola no es prueba de que el plan cambió.
## Gestiona la facturación o cancelación
1. Selecciona **Gestionar** o **Gestionar facturación** en la suscripción actual.
2. Usa el portal de facturación seguro para métodos de pago, facturas y opciones de cancelación presentadas a tu cuenta.
3. Revisa la confirmación final del portal antes de enviar una acción financiera o de cancelación.
4. Regresa a Runner y verifica el banner del plan actual, aviso de fin/renovación o cambio pendiente.
## Compra un Paquete de impulso
Un Paquete de impulso es una compra única de 350 Créditos por 9,90 USD, más los impuestos aplicables. No es una suscripción, y sus Créditos se suman al mismo saldo universal.
1. Confirma que se muestre una suscripción activa.
2. Abre el Paquete de impulso de crédito.
3. Elige la cantidad.
4. Revisa Créditos totales y precio total.
5. Selecciona **Confirmar compra** solo cuando ambos sean correctos.
6. Espera a **Compra completada** y verifica el saldo en [Créditos y uso](./credits-and-usage).
Esta es una acción financiera. Cerrar la confirmación deja la compra sin enviar. El pago muestra el precio actual, la cantidad, el vencimiento y las condiciones de pago antes de comprar.
## Estados y límites
- Los estados **Activa**, **Vencida**, **Cancelando**, inactivo, heredado y cambio pendiente pueden exponer diferentes acciones.
- Una suscripción anterior vencida puede mostrar **Renovar** en lugar de las opciones mostradas a un espacio de trabajo Gratis nunca pagado. Espera a que se carguen los detalles de facturación antes de seleccionar Renovar.
- Un compromiso anual puede deshabilitar opciones Mensual.
- Un cambio de plan puede ser inmediato, programado o pendiente de pago adicional. Usa el estado que Runner muestra después de la solicitud.
- **Configurando tu suscripción** significa que Runner aún está confirmando el estado de pago devuelto.
- Un tiempo de espera de procesamiento te pide que actualices y verifiques; no prueba fallo o éxito.
- La compra de Créditos adicionales no está disponible sin una suscripción activa elegible.
## Solución de problemas
- Si se muestra el espacio de trabajo incorrecto, cierra Configuración y reabrela desde el espacio de trabajo deseado.
- Si el botón Mensual está deshabilitado, revisa el compromiso anual actual mostrado en la página.
- Si la gestión de facturación no se abre, intenta de nuevo una vez y permite que se abra la página de facturación segura.
- Si la suscripción está Vencida, sigue la acción de facturación mostrada antes de intentar otro cambio de plan.
- Si el pago vuelve a un estado de procesamiento, actualiza y verifica antes de enviar de nuevo para evitar un intento duplicado.
## Guías relacionadas
- [Créditos y uso](./credits-and-usage)
- [General del espacio de trabajo](../account-and-settings/workspace-general)
- [Eliminar, recuperar y salir](../account-and-settings/delete-recover-and-leave)
- [Habilidades del agente](../agent/skills)
---
# Te damos la bienvenida a Runner AI
Source: https://www.runnerai.com/docs/es/guides/product-guide
Runner te ayuda a convertir una idea de negocio en una tienda en línea funcional, luego administra la tienda desde un espacio de trabajo. Estas guías explican cada página importante, entrada, botón, estado y próximo paso seguro en lenguaje simple.
**[Construye tu primera tienda, paso a paso](./start-here/first-store-quickstart)**
Sigue las capturas de pantalla y los vídeos cortos para crear una tienda, enviar tu primera solicitud, revisar la vista previa y preparar la publicación.
## Comienza con la ruta que coincida con tu objetivo
**Empezar**
- [Explorar Runner antes de crear una cuenta](./start-here/explore-runner-before-sign-in)
**Explorar Runner antes de iniciar sesión** — Comprende la navegación pública actual, idioma, demostración y acciones de inicio de sesión.
- [Evaluar una plantilla de tienda terminada](./start-here/browse-and-remix-templates)
**Examina y remixea plantillas de tienda** — Compara vistas previas públicas y comprende si el remixeo está disponible actualmente.
- [Construir tu primera tienda de Runner](./start-here/create-runner-store)
**Crear una tienda de Runner** — Crea un proyecto, envía la primera solicitud y llega al espacio de trabajo de la tienda.
- [Usar una tienda Shopify existente](./start-here/connect-shopify)
**Conectar Shopify** — Inicia la ruta de conexión de Shopify y comprende qué permanece en Shopify.
**Crear**
- [Pedir a Runner que construya o cambie algo](./work-with-runner/chat-with-runner)
**Chatear con Runner** — Envía una solicitud clara, responde preguntas de seguimiento y sigue el progreso de la tarea.
- [Revisar la tienda](./storefront-and-publishing/preview-your-store)
**Previsualiza tu tienda** — Abre la vista previa actual y verifica diseños de escritorio o móvil.
- [Poner la tienda en línea](./storefront-and-publishing/prepare-to-publish)
**Prepararse para publicar** — Completa la configuración requerida antes de seleccionar **Publicar**.
**Operar**
- [Agregar y administrar productos](./store-operations/products)
**Productos** — Encuentra controles de producto y comprende el resultado de cada acción.
- [Conectar pagos, envíos o correo electrónico](./apps-and-integrations)
**Aplicaciones e integraciones** — Conecta, inspecciona, reconecta o desconecta servicios compatibles.
**Mejorar**
- [Entender el rendimiento](./analytics-and-seo)
**Análisis y SEO** — Lee vistas de tienda, tráfico, conversión, búsqueda y visibilidad de IA.
- [Encontrar una característica faltante o restringida](./advanced/feature-availability)
**Disponibilidad de características** — Identifica requisitos previos y el próximo paso más seguro sin adivinar.
- [Recuperarse de un problema](./help-and-reference)
**Ayuda y referencia** — Diagnostica estados de tarea, compilación, publicación, pago e integración.
## El viaje habitual
1. [Inicia sesión](./start-here/sign-in) y entra en tu espacio de trabajo.
2. Abre el menú del nombre de la tienda en la barra lateral y selecciona **Crear tienda**. En un espacio de trabajo vacío, usa **Crear tienda** o **+ Tienda** si se muestra. Elige **Crear nuevo** o **Conectar Shopify** solo si aparece el selector de tipo de tienda.
3. [Dile a Runner lo que quieres](./work-with-runner/write-effective-requests).
4. Sigue el estado de la tarea y responde cualquier pregunta que Runner muestre.
5. Revisa el resultado en [Tienda](./storefront-and-publishing/preview-your-store).
6. Realiza cambios visuales en [Modo de diseño](./storefront-and-publishing/design-mode) o envía una solicitud de seguimiento.
7. Configura productos, envíos, pagos y detalles de la tienda.
8. Completa la [lista de verificación de publicación](./storefront-and-publishing/prepare-to-publish), luego publica.
9. Usa los grupos **Crear**, **Crecer** y **Medir** en la barra lateral para gestionar y mejorar el negocio.
## Examina toda la documentación
### Comienza
- [Comienza aquí](./start-here)
inicia sesión, crea o conecta una tienda y completa el primer flujo de trabajo útil.
- [Espacio de trabajo](./workspace)
administra tiendas, estados, compañeros de equipo, notificaciones y navegación del espacio de trabajo.
- [Trabajar con Runner](./work-with-runner)
usa chat, historial, búsqueda, imágenes, perfiles, habilidades y detalles de tareas.
### Construir y ejecutar la tienda
- [Tienda y publicación](./storefront-and-publishing)
vista previa, diseño, edición de código condicional, versiones, publicación, pago y dominios.
- [Operaciones de Tienda](./store-operations)
configuración general, envíos, productos, pedidos, clientes, promociones, abastecimiento y reseñas.
- [Aplicaciones e integraciones](./apps-and-integrations)
pagos, correo electrónico, envíos, Shopify, cumplimiento y conexiones de agentes.
### Medir, automatizar y crear
- [Análisis y SEO](./analytics-and-seo)
métricas, tráfico, conversión, rendimiento de búsqueda, salud del sitio y visibilidad de IA.
- [Automatizar, probar y crear](./automate-test-and-create)
automatizaciones, simulaciones, experimentos, Estudio Creativo, Biblioteca de Medios y Anuncios.
- [Agente](./agent)
habilidades reutilizables, memoria y paleta de comandos.
### Configurar y solucionar problemas
- [Cuenta y configuración](./account-and-settings)
espacio de trabajo, facturación, uso, tienda, personal, clave de API y configuración de seguridad.
- [Características avanzadas](./advanced)
Investigación condicional, Fly, Flujos de trabajo, Webhooks y reglas de disponibilidad.
- [Ayuda y referencia](./help-and-reference)
estados, solución de problemas, soporte, Registro de cambios, Preguntas frecuentes y glosario.
## Cómo leer estas guías
Cada página de tarea sigue el mismo patrón:
### Ver la estructura de la página
1. **Ruta de entrada** te dice exactamente dónde comenzar en Runner.
2. **Antes de comenzar** enumera el estado de tienda requerido, acceso, plan o conexión.
3. **Controles** explica qué hace cada botón importante después de seleccionarlo.
4. **Lista de tareas** describe el flujo de trabajo seguro más corto.
5. **Estados y solución de problemas** explica qué cambió y qué intentar a continuación.
6. **Guías relacionadas** enlaza a la siguiente tarea probable.
## Límites de seguridad
Antes de un clic de alto impacto:
:::warning
- lee la confirmación y el nombre de tienda o espacio de trabajo afectado;
- guarda el trabajo que debe permanecer disponible;
- verifica si la acción cambia la tienda en vivo, facturación, comunicación con clientes, secretos o acceso del equipo;
- pregunta a un propietario del espacio de trabajo cuando tu rol no permite la acción.
:::
---
# Comenzar con Runner
Source: https://www.runnerai.com/docs/es/guides/start-here
**Qué cubre esta guía:** Sabrás qué ruta de configuración seguir y dónde Runner te lleva después de cada paso.
Usa esta sección cuando inicies sesión por primera vez, comiences una tienda impulsada por Runner,
o conectes una tienda Shopify existente.
**[Crea tu primera tienda, paso a paso](/es/guides/start-here/first-store-quickstart)**
Sigue las capturas de pantalla y los vídeos cortos para crear una tienda, enviar tu primera solicitud, revisar la vista previa y preparar la publicación.
**Ruta de entrada:** Iniciar sesión → espacio de trabajo → menú con el nombre de la tienda en la barra lateral → **Crear tienda**.
## Elige tu ruta
| Tu situación | Comienza aquí | Qué sucede después |
| --- | --- | --- |
| Quieres el recorrido completo más corto | [Construye tu primera tienda](/es/guides/start-here/first-store-quickstart) | Muévete desde una idea de tienda hasta verificaciones de vista previa y publicación. |
| Quieres explorar Runner antes de iniciar sesión | [Explorar Runner antes de iniciar sesión](/es/guides/start-here/explore-runner-before-sign-in) | Revisa la navegación pública, idioma, demostración y acciones de cuenta disponibles en el lanzamiento actual. |
| Quieres evaluar una plantilla de tienda | [Explorar y remixar plantillas de tienda](/es/guides/start-here/browse-and-remix-templates) | Compara vistas previas de escritorio, móvil y captura de pantalla, luego verifica la disponibilidad actual de remixado. |
| No tienes una cuenta de Runner | [Iniciar sesión](/es/guides/start-here/sign-in) | Verifica tu cuenta, luego entra en un espacio de trabajo. |
| Quieres que Runner cree la vitrina y el backend de la tienda | [Crear una tienda Runner](/es/guides/start-here/create-runner-store) | Runner crea un proyecto y abre su conversación. |
| Ya vendes a través de Shopify | [Conectar Shopify](/es/guides/start-here/connect-shopify) | Runner inicia una conexión de Shopify o reutiliza una conexión existente elegible. |
| Ves un diálogo introductorio o recompensa de crédito | [Tour de bienvenida y créditos diarios](/es/guides/start-here/welcome-tour-and-daily-credits) | Aprende las áreas principales o reclama la recompensa actualmente mostrada. |
## La ruta de primera ejecución
1. [Inicia sesión](/es/guides/start-here/sign-in) y abre tu espacio de trabajo.
2. Completa el breve cuestionario comercial si Runner lo muestra.
3. Abre el menú con el nombre de la tienda en la barra lateral y selecciona **Crear tienda**. En un espacio de trabajo vacío, usa **Crear tienda** o **+ Tienda** si aparece.
4. Si aparece un selector de tipo de tienda, selecciona **Crear nuevo** para una nueva tienda Runner o **Conectar Shopify** para una tienda Shopify existente.
5. Introduce un **Nombre de la tienda**, selecciona **Crear** y espera a que se abra la nueva tienda.
6. Usa la conversación del proyecto para decirle a Runner qué quieres construir.
## Antes de comenzar
- Necesitas acceso a la cuenta de correo electrónico o Google utilizada para iniciar sesión.
- Un espacio de trabajo puede tener límites de tienda y asiento. Runner muestra una ruta de actualización cuando un límite
bloquea una acción.
- **Conectar Shopify** puede no aparecer para cada espacio de trabajo.
- Una vista previa generada, una vitrina publicada y un pago funcional son estados separados.
## Si te atascas
- Si un código de correo electrónico falla, solicita un nuevo código después de que **Reenviar código de verificación** esté disponible.
- Si **Crear tienda** abre un mensaje de actualización, revisa el plan actual del espacio de trabajo antes de reintentar.
- Si Shopify no se muestra, construye una tienda Runner o verifica si el acceso a Shopify está habilitado para
tu espacio de trabajo.
## Guías relacionadas
- [Iniciar sesión](/es/guides/start-here/sign-in)
- [Explorar Runner antes de iniciar sesión](/es/guides/start-here/explore-runner-before-sign-in)
- [Explorar y remixar plantillas de tienda](/es/guides/start-here/browse-and-remix-templates)
- [Crear una tienda Runner](/es/guides/start-here/create-runner-store)
- [Conectar Shopify](/es/guides/start-here/connect-shopify)
- [Construye tu primera tienda](/es/guides/start-here/first-store-quickstart)
---
# Examinar y remixar plantillas de tienda
Source: https://www.runnerai.com/docs/es/guides/start-here/browse-and-remix-templates
La página de plantillas de tienda públicas de Runner te permite inspeccionar plantillas publicadas antes de iniciar sesión y, cuando el remixado está disponible, solicitar una copia en tu propio espacio de trabajo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgR0WXr5OLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Elige una categoría y una plantilla, revisa **Escritorio**, **Móvil** o **Captura de pantalla** y selecciona **Usar esta plantilla** cuando quieras comenzar a crear una copia. La imagen muestra la acción inicial, no un remix completado.
Selecciona la imagen para ampliarla. Las anotaciones están en inglés.
## Ruta de acceso
Abre la página pública **Plantillas** de Runner en [www.runnerai.com/templates](https://www.runnerai.com/templates), o sigue un enlace a una plantilla de tienda de Runner. No se requiere cuenta para examinar la galería o abrir una plantilla.
## Antes de empezar
- Necesitas una cuenta de Runner y un espacio de trabajo activo si el remixado se vuelve disponible.
- Una vista previa en vivo, captura de pantalla y remixado son diferentes: la vista previa es de solo lectura; solo un remixado exitoso crea trabajo de proyecto.
- Las plantillas disponibles, descripciones y recuentos de remixado pueden cambiar.
## Examina la galería
Usa el filtro de categoría para reducir la galería, incluidas las plantillas de **Animación 3D**. Cada tarjeta muestra el título de la plantilla, una miniatura cuando esté disponible y una breve descripción. Selecciona una tarjeta para abrir su página de detalles. Si la página dice **Aún no hay plantillas de tienda**, ninguna plantilla pública está disponible en ese momento; vuelve más tarde en lugar de tratarlo como un problema de cuenta.
## Revisa una plantilla
| Control o sección | Qué sucede después de seleccionarlo |
| --- | --- |
| **Escritorio** | Abre la vista previa de la plantilla en vivo en un marco con forma de escritorio. No edita la plantilla. |
| **Móvil** | Muestra la misma vista previa en vivo en un marco con forma de teléfono estrecho. |
| **Captura de pantalla** | Muestra la imagen de página completa guardada cuando una está disponible. Es una imagen estática, no la tienda en vivo. |
| **Acerca de esta plantilla** | Explica el propósito de la plantilla. |
| **Diseñado para** | Enumera las audiencias o tipos de tienda que la plantilla tiene como objetivo. |
| **Aspectos destacados y capacidades** | Resume las ideas principales demostradas por la plantilla. |
| Recuento de remixado | Muestra cuántas copias ha registrado Runner. No mide tiendas en vivo o ventas. |
| **Volver a la galería** | Regresa a la lista de plantillas públicas. |
Si una vista previa en vivo no está disponible, usa **Captura de pantalla** cuando la plantilla tenga una. Una captura de pantalla o vista previa faltante no te impide leer los detalles de la plantilla.
## Remixar la plantilla
1. Revisa la plantilla en **Escritorio**, **Móvil** y **Captura de pantalla** según sea disponible.
2. Selecciona **Usar esta plantilla** solo cuando quieras que Runner cree un proyecto a partir de él.
3. Si has cerrado sesión, completa el flujo de inicio de sesión. Runner mantiene la plantilla seleccionada para la ruta de remixado.
4. Después de iniciar sesión, si la configuración no comenzó automáticamente, vuelve al detalle de la plantilla y selecciona **Usar esta plantilla** nuevamente. Luego espera mientras el botón muestra **Preparando tu tienda…**.
5. La copia tiene éxito cuando Runner abre un nuevo proyecto en tu espacio de trabajo. Si Runner muestra un fallo o pierde la conexión, revisa tu lista de tiendas antes de intentarlo de nuevo; el mensaje por sí solo no prueba que no se creó ningún proyecto.
6. Revisa la tienda copiada, productos, configuración y estado de publicación antes de hacerla pública.
Un remixado exitoso se convierte en tu propio proyecto; cambiarlo no altera la plantilla pública. Es un punto de partida, no una prueba de que los pagos, envíos, datos del catálogo, publicación o pago estén listos.
## Solución de problemas
| Estado | Qué hacer |
| --- | --- |
| **Vista previa no disponible** | Cambia a **Captura de pantalla** o lee los detalles de la plantilla. |
| **No hay captura de pantalla disponible para esta plantilla** | Usa **Escritorio** o **Móvil** si la vista previa en vivo funciona. |
| El inicio de sesión se abre después de **Usar esta plantilla** | Termina el inicio de sesión con la cuenta que posee el espacio de trabajo previsto. Si la configuración no comienza, vuelve a la plantilla y selecciona **Usar esta plantilla** nuevamente. |
| **Preparando tu tienda…** | Mantén la página abierta mientras Runner crea el proyecto. No inicies el mismo remixado nuevamente. |
| **No se pudo remezclar esta tienda. Por favor, inténtalo de nuevo.** | Revisa el menú del nombre de la tienda para un proyecto recién creado antes de intentarlo de nuevo. Si la remezcla sigue no disponible, navega por la plantilla o crea una nueva tienda de Runner en su lugar. |
| Plantilla no encontrada | Vuelve a la galería; la plantilla puede que ya no esté publicada. |
## Guías relacionadas
- [Explorar Runner antes de iniciar sesión](./explore-runner-before-sign-in)
- [Iniciar sesión](./sign-in)
- [Crear una tienda de Runner](./create-runner-store)
- [Vista previa de tu tienda](../storefront-and-publishing/preview-your-store)
---
# Conectar una tienda Shopify
Source: https://www.runnerai.com/docs/es/guides/start-here/connect-shopify
**Qué cubre esta guía:** Comenzarás la autorización de Shopify o reutilizarás una conexión de Shopify elegible para un nuevo proyecto de Runner.
Usa esta ruta cuando tu catálogo y pago ya viven en Shopify.
**Ruta de entrada:** Menú del nombre de la tienda → **Crear tienda** → **Conectar Shopify**, cuando esté disponible.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Abra el menú del nombre de la tienda y elija **Create Store**. Continúe con **Connect Shopify** solo si su espacio de trabajo muestra esa opción.
Las anotaciones están en inglés. Seleccione la imagen para ampliarla.
## Antes de empezar
- **Conectar Shopify** debe estar habilitado para tu espacio de trabajo.
- Necesitas el dominio permanente de la tienda que termina en `.myshopify.com`.
- Para una nueva conexión, necesitas permiso para aprobar el acceso en Shopify.
- Tu espacio de trabajo de Runner debe tener espacio para otra tienda.
## Controles de Crear tienda
| Control | Por qué es útil | Qué sucede después de seleccionarlo |
| --- | --- | --- |
| Tipo de proyecto **Conectar Shopify** | Mantiene el sistema de comercio Shopify existente. | Muestra opciones de conexión de Shopify y el campo de dominio de tienda. |
| **Nombre de la tienda** | Nombra el proyecto de Runner. | Se usa en el espacio de trabajo de Runner; no cambia el nombre de la tienda Shopify. |
| **Usar conexión existente: _dominio_** | Evita repetir la autorización para una conexión elegible. | Selecciona esa conexión de Shopify para el nuevo proyecto de Runner. |
| **Conectar otra tienda** | Comienza con otra tienda Shopify. | Muestra **Dominio de la tienda**. |
| **Dominio de la tienda** | Identifica la tienda Shopify. | Acepta un dominio como `your-store.myshopify.com`. |
| Botón de envío **Conectar Shopify** | Inicia una nueva autorización. | Te envía a Shopify; Runner termina la entrega solo después de que Shopify regrese exitosamente. |
| **Crear** | Usa la conexión existente seleccionada. | Crea el proyecto de Runner y lo abre. |
| **Cancelar** | Se va sin conectar o crear. | Cierra el diálogo. |
## Conectar una nueva tienda Shopify
1. Abre el menú del nombre de la tienda, selecciona **Crear tienda**, luego elige **Conectar Shopify**.
2. Ingresa un **Nombre de la tienda** para el proyecto de Runner.
3. Elige **Conectar otra tienda** si se muestran opciones de conexión.
4. Ingresa el dominio completo `.myshopify.com` en **Dominio de la tienda**.
5. Selecciona **Conectar Shopify**.
6. Revisa la solicitud de acceso en Shopify y continúa solo si nombra la tienda que esperas.
7. Después de que Shopify regrese a Runner, confirma que el nuevo proyecto aparezca en el espacio de trabajo.
## Reutilizar una conexión existente
1. Elige **Conectar Shopify** en **Crear tienda**.
2. Ingresa el **Nombre de la tienda** de Runner.
3. Selecciona **Usar conexión existente: _dominio_**.
4. Selecciona **Crear**.
5. Confirma que Runner abre el nuevo proyecto con el nombre de tienda deseado y la conexión a Shopify.
## Solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| La opción de Shopify falta | La característica no está habilitada para este espacio de trabajo. | Usa **Crear nuevo** o verifica la disponibilidad del espacio de trabajo. |
| **Conectar Shopify** está deshabilitado | El nombre de la tienda o el dominio `.myshopify.com` está incompleto. | Corrige el campo resaltado. |
| Conexión ya vinculada | Esa conexión de Shopify pertenece a otra tienda de Runner. | Elige otra conexión elegible u otra tienda. |
| Conexión no encontrada | Una conexión guardada ya no está disponible. | Selecciona otra conexión o inicia una nueva autorización. |
| La autorización de Shopify se cancela | Shopify no devolvió una conexión aprobada. | Vuelve a **Crear tienda** e intenta nuevamente cuando estés listo. |
El pago permanece en Shopify para este tipo de proyecto. Una conexión exitosa no prueba que
la tienda de Runner esté compilada o publicada; revisa esos estados por separado.
## Guías relacionadas
- [Crear una tienda de Runner en su lugar](/es/guides/start-here/create-runner-store)
- [Compilar tu primera tienda](/es/guides/start-here/first-store-quickstart)
- [Comenzar](/es/guides/start-here)
---
# Crear una tienda de Runner
Source: https://www.runnerai.com/docs/es/guides/start-here/create-runner-store
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Crearás un nuevo proyecto de Runner y llegarás a su conversación de proyecto.
Usa **Crear nuevo** cuando estés comenzando desde una idea y no necesites mantener el pago de Shopify.
**Ruta de entrada:** Espacio de trabajo → nombre de la tienda en la parte superior de la barra lateral izquierda → **Crear tienda**. Expande la barra lateral primero si está colapsada. En un espacio de trabajo vacío, usa **Crear tienda** o **+ Tienda** cuando se muestre.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Sigue [Construye tu primera tienda, paso a paso](./first-store-quickstart) para un ejemplo completo con capturas de pantalla y grabaciones cortas.
## Antes de empezar
- Debes estar conectado a un espacio de trabajo activo.
- Tu espacio de trabajo debe tener espacio para otra tienda.
- Ingresa un nombre que identifique claramente la tienda a tu equipo.
## Controles de Crear tienda
| Control | Por qué es útil | Qué sucede después de seleccionarlo |
| --- | --- | --- |
| **Crear nuevo**, cuando se muestra | Elige la ruta de tienda nativa de Runner. | El formulario mantiene solo los campos necesarios para una tienda de Runner. Si no aparece un selector de tipo de tienda, continúa con Nombre de la Tienda. |
| **Nombre de la tienda** | Nombra el proyecto en tu espacio de trabajo. | **Crear** se vuelve disponible después de que el nombre sea válido. |
| **Crear** | Confirma la nueva tienda. | Runner crea el proyecto y navega a su conversación. |
| **Cancelar** o cerrar | Se va sin crear una tienda. | El diálogo se cierra y el espacio de trabajo permanece sin cambios. |
## Crear la tienda
1. Abre el menú del nombre de la tienda en la barra lateral y selecciona **Crear tienda**, o usa la acción de creación en un espacio de trabajo vacío.
2. Elige **Crear nuevo** si el formulario ofrece esa opción. De lo contrario, continúa con **Nombre de la tienda**.
3. Ingresa el **Nombre de la tienda**.
4. Selecciona **Crear**.
5. Espera a que se abra el nuevo proyecto.
6. En la conversación del proyecto, describe tu negocio, público, estilo visual y páginas necesarias. También puedes abrir **Tienda online** para ingresar la primera solicitud.
Crear el proyecto no lo publica. Runner aún necesita tu solicitud antes de poder compilar una vista previa de tienda.
Cuando Runner termine la primera versión, abre **Tienda online** para revisar la vista previa. Una vista previa lista todavía no es pública. Cuando quieras hacer pública la tienda, selecciona **Publicar** y resuelve todos los requisitos antes de confirmar.
## Solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| **Crear** está deshabilitado | Falta un valor requerido o es inválido, o la creación ya se está ejecutando. | Revisa **Nombre de la tienda** y espera cualquier acción pendiente. |
| Mensaje de actualización | El espacio de trabajo ha alcanzado su límite actual de tiendas. | Abre la información del plan mostrada por Runner o cancela el diálogo. |
| El acceso al espacio de trabajo ha caducado | No se pueden crear nuevas tiendas en ese espacio de trabajo. | Sigue la ruta de reactivación del espacio de trabajo o plan mostrada en pantalla. |
| La creación falló | Runner no pudo terminar de crear el proyecto. | Mantén el nombre previsto, vuelve al espacio de trabajo e intenta una vez más. |
## Guías relacionadas
- [Iniciar sesión](/es/guides/start-here/sign-in)
- [Compilar tu primera tienda](/es/guides/start-here/first-store-quickstart)
- [Conectar Shopify en su lugar](/es/guides/start-here/connect-shopify)
- [Tour de bienvenida y créditos diarios](/es/guides/start-here/welcome-tour-and-daily-credits)
---
# Explorar Runner Antes de Iniciar Sesión
Source: https://www.runnerai.com/docs/es/guides/start-here/explore-runner-before-sign-in
Las páginas públicas de Runner te permiten conocer el producto, comparar precios e iniciar una demostración o flujo de cuenta antes de entrar en un espacio de trabajo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1kPfxvrvDHKGRP0BUIpjksTZQ9oN4rSwzeqA)
Usa **Productos** y **Recursos** para explorar Runner, el **selector de idioma** para elegir un idioma y **Cómo funciona** para abrir el vídeo de demostración. Esta acción es distinta de **Reservar una demo**, que abre la reserva de una reunión cuando está disponible.
Selecciona la imagen para ampliarla. Las anotaciones están en inglés.
## Qué cubre esta guía
Te orientarás en las páginas públicas de Runner, elegirás un idioma, reservarás una demostración de forma segura y sabrás si la acción principal iniciará sesión o abrirá un espacio de trabajo.
## Disponibilidad y requisitos previos
- No se requiere cuenta para explorar las páginas públicas.
- Runner puede mostrar uno de dos diseños de navegación pública. Solo aparece la versión asignada a la visita actual; esto es normal.
- El panel de programación **Reservar una demostración** utiliza un servicio externo y necesita una conexión de red funcional.
- La acción de cuenta principal cambia después de que inicies sesión.
## Ruta de acceso
Abre la página de inicio pública de Runner en un navegador. En dispositivos móviles, selecciona **Abrir el menú** para revelar la navegación y **Cerrar el menú** para cerrarla.
## Controles comunes
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| Selector de idioma | Guarda el idioma elegido para la cuenta con sesión iniciada o navegador actual, luego recarga la página actual en ese idioma. |
| **Reservar** o **Reservar demostración** | Abre el panel de programación, cuyo título accesible es **Reservar una demostración**. Una reunión se crea solo después de que el programador la confirme. |
| **Inicio** o **Empezar** | Abre el flujo de inicio de sesión o creación de cuenta de Runner. La etiqueta depende de la versión de navegación pública. |
| **Abrir espacio de trabajo** | Aparece para un visitante con sesión iniciada y abre el espacio de trabajo protegido. |
| Avatar con sesión iniciada | Abre el menú de cuenta disponible en lugar de la acción **Inicio** o **Empezar** sin sesión. |
| **Abrir el menú** / **Cerrar el menú** | Muestra u oculta la navegación móvil. Seleccionar un destino cierra el menú cuando comienza la navegación. |
El menú móvil contiene los enlaces y el control de idioma para la versión de navegación pública que te fue asignada. Su acción principal se mantiene fácil de alcanzar cerca del borde del menú: **Inicio** o **Empezar** cuando no tienes sesión iniciada, o la acción de espacio de trabajo con sesión iniciada cuando esté disponible.
## Elige tu próximo paso
1. Abre [Precios](https://www.runnerai.com/pricing) para comparar los planes públicos y las capacidades incluidas.
2. Navega por [Plantillas](https://www.runnerai.com/templates) para inspeccionar un punto de partida en escritorio y móvil.
3. Regresa a la acción principal de la cuenta cuando estés listo para construir.
4. Después de iniciar sesión, confirma que Runner abre el espacio de trabajo que pretendes usar antes de crear una tienda.
## Cambiar el idioma
1. Abre el selector de idioma.
2. Selecciona el idioma que deseas.
3. Espera a que se recargue la página.
4. Confirma que la página actual, en lugar de un destino no relacionado, se reabrió en el idioma seleccionado.
Si la guardación falla, Runner mantiene el idioma anterior e informa un error. Reinténtalo una vez después de verificar la conexión. Un cambio de idioma afecta el texto de la interfaz; no traduce el contenido que ingresaste en un proyecto de tienda.
## Reservar una demostración
1. Selecciona **Reservar** o **Reservar demostración**, según lo que muestre tu navegación.
2. Espera a que el programador muestre fechas y horas disponibles.
3. Elige una hora y completa los detalles de contacto solicitados.
4. Confirma la reunión dentro del programador.
5. Espera el mensaje de éxito de Runner y que se cierre el panel.
Cerrar el programador antes de la confirmación no reserva una reunión. Si permanece en blanco o no está disponible, ciérralo, verifica la conexión e intenta una vez más. Usa [Soporte y comunidad](/es/guides/help-and-reference/support-and-community) si el problema se repite.
## Iniciar o reabrir Runner
- Cuando no tienes sesión iniciada, selecciona **Inicio** o **Empezar** y completa los pasos de inicio de sesión o creación de cuenta mostrados.
- Cuando ya tienes sesión iniciada, selecciona **Abrir espacio de trabajo** para entrar en el producto protegido.
- Si una acción protegida te devuelve al inicio de sesión, completa el inicio de sesión para la cuenta deseada antes de continuar.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Enlaces públicos diferentes a los esperados | Runner asignó la otra versión de navegación actual. Usa las etiquetas que son visibles. |
| Los enlaces móviles están ocultos | Selecciona **Abrir el menú**. Después de elegir un enlace, reabre el menú si necesitas otro destino. |
| Los botones de cuenta muestran marcadores de posición | Runner aún está verificando la sesión. Espera a **Inicio**, **Empezar** u **Abrir espacio de trabajo** antes de decidir si tienes sesión iniciada. El control de idioma también puede permanecer no disponible durante esta verificación. |
| El idioma no cambia | La preferencia no fue confirmada. Verifica el error y la conexión, luego reinténtalo una vez. |
| El programador de demostración se está cargando | Espera a que aparezcan sus controles de fecha y hora antes de ingresar detalles. |
| El panel de demostración se cierra sin éxito | No se confirmó ninguna reserva. Reabrelo y completa la confirmación del programador. |
| **Inicio** o **Empezar** es reemplazado por **Abrir espacio de trabajo** | Runner reconoce una sesión iniciada. Abre el espacio de trabajo o usa el menú de avatar para acciones de cuenta. |
## Guías relacionadas
- [Iniciar sesión](/es/guides/start-here/sign-in)
- [Explorar y remixar plantillas de tienda](/es/guides/start-here/browse-and-remix-templates)
- [Crear una tienda Runner](/es/guides/start-here/create-runner-store)
- [Soporte y comunidad](/es/guides/help-and-reference/support-and-community)
---
# Crea tu primera tienda, paso a paso
Source: https://www.runnerai.com/docs/es/guides/start-here/first-store-quickstart
Crea un escaparate que puedas revisar, modificar y preparar para compartir. Sigue los pasos en orden o usa el índice para volver al que necesites.
El ejemplo es **Quiet Mornings**, una tienda de velas artesanales. Puedes usar tu propia idea de negocio. Las capturas y los vídeos sin sonido muestran la interfaz en inglés; las preguntas y los controles disponibles pueden variar según la tienda.
**Ruta de acceso:** [Runner AI](https://www.runnerai.com) → **Empezar** → inicia sesión → tu espacio de trabajo.
## El recorrido breve
1. Abre el menú del nombre de la tienda → **Crear tienda** (o **+ Tienda** en un espacio de trabajo vacío). Elige **Crear nuevo** si aparece, o **Conectar Shopify** para una tienda Shopify existente.
2. En la conversación del proyecto, describe tu negocio, público, estilo visual y páginas necesarias. Envía la solicitud y responde a las preguntas de Runner.
3. Cuando la primera versión esté lista, abre **Tienda online** y revisa la vista previa. Una vista previa lista todavía no es pública.
4. Cuando quieras lanzar la tienda, selecciona **Publicar** y resuelve todos los requisitos antes de confirmar. La publicación y el funcionamiento del proceso de pago se comprueban por separado.
## Antes de empezar
- Usa un correo electrónico o una cuenta de Google a los que tengas acceso.
- Elige un espacio de trabajo con capacidad para otra tienda y suficientes créditos para la solicitud. Resuelve cualquier límite de plan o acceso antes de crear otra tienda.
- Prepara una frase sobre lo que vendes y quién lo compra. Ajusta el diseño después de la primera vista previa.
No necesitas conectar un proveedor de pagos para revisar un escaparate. **Vista previa**, **publicado** y **listo para aceptar pagos** son comprobaciones independientes.
## 1. Inicia sesión [#sign-in]
1. Abre Runner y selecciona **Empezar**. Si ya has iniciado sesión, selecciona **Abrir espacio de trabajo**.
2. Selecciona **Continuar con Google** y elige tu cuenta, o introduce tu **Correo**, selecciona **Continuar** e introduce el código del correo de Runner.
3. Responde a las preguntas de cuenta que aparezcan. Runner abre tu espacio de trabajo o te devuelve a la página donde empezaste.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
**Comprueba:** Puedes abrir tu espacio de trabajo sin volver al inicio de sesión. Consulta [Iniciar sesión](./sign-in) si falla un código o la elección de cuenta.
## 2. Crea una tienda [#create-store]
1. Selecciona el nombre de la tienda en la parte superior de la barra lateral izquierda y luego **Crear tienda**. Expande primero la barra lateral si está contraída. En un espacio vacío, usa la acción **Crear tienda** o **+ Tienda** que aparezca.
2. Elige **Crear nuevo** si el formulario ofrece esa opción. Usa [Conectar Shopify](./connect-shopify) si quieres conservar una tienda Shopify existente.
3. Introduce **Quiet Mornings** en **Nombre de la tienda**, o usa tu propio nombre.
4. Selecciona **Crear** y espera a que se abra la nueva tienda. No vuelvas a seleccionar Crear mientras esté trabajando.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
**Comprueba:** La barra lateral muestra el nombre de la nueva tienda. Crear la tienda aún no construye ni publica su escaparate.
## 3. Describe la primera versión [#first-request]
1. Selecciona **Tienda online**. Si no tiene una versión construida, Runner muestra un campo para describir cómo quieres que sea. También puedes usar la conversación de la nueva tienda.
2. Copia este ejemplo en el campo y adapta los datos del negocio:
~~~text
Build a store for Quiet Mornings, a handmade candle brand for people
who enjoy slow mornings. Use warm cream colors, forest-green accents,
and spacious product photography. Include a homepage, product pages,
About, and Contact. Start with three sample candles: Morning Light,
Cedar Cabin, and Lavender Dusk. Keep the store unpublished.
~~~
3. Selecciona la flecha de envío (**Enviar mensaje**). Si la pantalla inicial muestra **Empezar a construir**, usa esa acción.
4. Runner abre la conversación de creación y empieza a trabajar. Permanece en esta tienda mientras revisas el resultado.
**Comprueba:** Tu solicitud aparece en la conversación. Debajo aparece un indicador de progreso o una pregunta de seguimiento. Los productos de ejemplo sirven para practicar; sustituye sus datos antes de venderlos.
## 4. Responde a las preguntas y sigue el trabajo [#follow-progress]
1. Lee cada pregunta. Selecciona una respuesta o usa **Otro…** para escribir la tuya.
2. Responde a las preguntas restantes. En este ejemplo, elegimos el precio de las velas y un estilo de fotografía.
3. Espera a que Runner continúe. Abre **Detalles** cuando necesites entender un paso fallido o bloqueado.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
### Vídeo: responde a las preguntas de seguimiento
El vídeo selecciona un precio, pasa a la pregunta sobre fotografía y elige una dirección visual. **Respondido** confirma las elecciones y Runner reanuda el trabajo. Las preguntas dependen de tu solicitud.
**Comprueba:** No queda ninguna pregunta pendiente de respuesta. Un mensaje de finalización no basta: abre el escaparate y comprueba lo que realmente carga.
## 5. Revisa la vista previa y haz un cambio [#preview-and-change]
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
1. Abre **Tienda online** o selecciona **Vista previa** en la tarjeta de creación completada si se ofrece esa acción.
2. Espera a que aparezca la tienda. **Preparando la vista previa…** significa que aún no está lista para revisar.
3. Abre la página de inicio, un producto, Acerca de y Contacto. Revisa los textos, las imágenes, los precios y la navegación.
4. Usa el control de dispositivo para comprobar **PC**, **Tablet** y **Teléfono**. Busca textos cortados, botones superpuestos y desplazamiento horizontal.
5. Vuelve a la conversación y pide un único cambio concreto:
~~~text
Change the homepage headline to “Make room for a slower morning.”
Keep the colors, layout, and product information unchanged.
~~~
6. Espera al cambio, vuelve a abrir la vista previa actual y confirma que el nuevo titular sea visible. Revisa Teléfono otra vez.
**Comprueba:** Puedes identificar el cambio solicitado en la vista previa. La tienda sigue sin publicar. Si está disponible, el [Modo Diseño](../storefront-and-publishing/design-mode) también permite seleccionar un elemento para editarlo de forma concreta.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
### Vídeo: revisa los diseños de ordenador y teléfono
El control de dispositivo pasa de **PC** a **Tablet**, luego a **Teléfono** y vuelve a **PC**. Solo cambia el marco de la vista previa; esta acción no publica ni modifica tu tienda.
## 6. Revisa las comprobaciones de publicación [#publish-checks]
Publicar puede requerir un plan de pago o acceso adicional al espacio de trabajo. Si **Publicar** abre un mensaje para cambiar de plan, revisa los [planes actuales](https://www.runnerai.com/pricing) o vuelve a la vista previa. Resuelve ese requisito de acceso antes de esperar la confirmación de publicación.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
1. Selecciona **Publicar** en la barra de herramientas de Escaparate. Esto inicia las comprobaciones de acceso y preparación; no demuestra que la tienda esté en línea.
2. Lee **Confirmar Implementación** y espera a la comprobación de compilación.
3. Resuelve los elementos que aparezcan. **Corregir con IA** solicita una reparación, **Reintentar comprobación** vuelve a ejecutar la comprobación y **Abrir Operaciones de la tienda** lleva a la configuración cuando se ofrece.
4. Si estás practicando, selecciona **Cancelar**. Para hacer pública esta versión, revisa las advertencias y selecciona **Confirmar** solo cuando esté habilitado.
5. Después de confirmar, espera a una publicación correcta, abre la URL pública y comprueba las páginas en línea. Si la publicación falla, no des por hecho que tus cambios estén publicados.
En la captura, la comprobación de compilación pasa, pero la configuración aún necesita atención. **Publicar de todos modos; terminaré la configuración más tarde.**, cuando se ofrece, reconoce la configuración pendiente indicada; no completa ese trabajo.
### Vídeo: sal de las comprobaciones sin publicar
El vídeo revisa el resultado de compilación y la advertencia de configuración, luego selecciona **Cancelar** y vuelve a la vista previa. No publica la tienda de ejemplo.
**Comprueba:** Una vista previa que funciona demuestra que puedes ver la versión construida. Una publicación correcta y una URL pública que funciona demuestran que los visitantes pueden acceder. Aún debes conectar el proveedor de pagos y comprobar el proceso de compra antes de aceptar pedidos.
Consulta [Preparar la publicación](../storefront-and-publishing/prepare-to-publish) para los productos, envíos, políticas y otros ajustes. Continúa con [Publicar y volver a publicar](../storefront-and-publishing/publish-and-republish) y [Tienda en línea y proceso de pago](../storefront-and-publishing/live-store-and-checkout).
## Si un paso no termina
| Lo que ves | Tu siguiente paso |
| --- | --- |
| Aún no hay una tienda | Abre el menú del nombre de la tienda o la acción de creación del espacio vacío. |
| Un límite de tiendas o del plan | Revisa el plan del espacio de trabajo o elige uno con capacidad disponible. Repetir Crear no elimina el límite. |
| Una pregunta pendiente | Respóndela para que Runner pueda continuar. |
| Preparando la vista previa | Mantén abierta la versión actual. Usa Actualizar si se ofrece cuando la preparación deje de avanzar. |
| Resultados fallidos, detenidos o contradictorios | Abre Detalles, lee el problema pendiente y comprueba la vista previa real. Pide a Runner que corrija el problema concreto sin dar por suficiente el resumen de éxito. |
| Confirmar está deshabilitado | Termina la compilación o la tarea activa y resuelve los requisitos indicados. «Sin cambios» requiere un nuevo cambio guardado; no es una advertencia que puedas descartar. |
| Una tienda en línea no puede aceptar pagos | Completa la conexión del proveedor y la configuración del pago en Aplicaciones o en la pantalla posterior a la publicación. |
## Guías relacionadas
- [Crear una tienda Runner](./create-runner-store)
- [Escribir solicitudes eficaces](../work-with-runner/write-effective-requests)
- [Revisar la vista previa de tu tienda](../storefront-and-publishing/preview-your-store)
- [Abrir tu primera tienda al público](../open-your-first-store)
---
# Iniciar Sesión en Runner
Source: https://www.runnerai.com/docs/es/guides/start-here/sign-in
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Iniciarás sesión y volverás a la página de Runner o espacio de trabajo que inició el flujo de inicio de sesión.
Usa correo electrónico cuando quieras un código único sin contraseña. Usa Google cuando esa cuenta ya esté
disponible en tu navegador.
**Ruta de entrada:** Inicio de Runner → **Empezar**, o **Abrir espacio de trabajo** si ya has iniciado sesión.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Para el flujo de trabajo ilustrado completo, sigue [Construye tu primera tienda, paso a paso](./first-store-quickstart).
## Antes de empezar
- Usa una cuenta de correo electrónico que puedas abrir en el mismo dispositivo de confianza.
- Si tu organización te invitó, inicia sesión con la dirección de correo electrónico invitada.
- No compartas un código único o lo dejes visible en una captura de pantalla.
## Controles de inicio de sesión
| Control | Por qué es útil | Qué sucede después de seleccionarlo |
| --- | --- | --- |
| **Continuar con Google** | Usa tu cuenta de Google. | Abre el flujo de cuenta y consentimiento de Google. Runner se reanuda después de que Google regresa exitosamente. |
| **Correo** | Te permite iniciar sesión sin contraseña. | Acepta la dirección que recibirá el código único. |
| **Continuar** | Solicita un código de correo electrónico. | Runner envía un código de verificación de seis dígitos y abre el formulario de código. |
| Campos de código de verificación | Confirma que controlas la dirección de correo electrónico. | El formulario se envía automáticamente después de que se ingresan los seis dígitos. |
| **Reenviar código de verificación** | Reemplaza un código faltante o expirado. | Envía otro código después de que finaliza la cuenta atrás visible. |
## Iniciar sesión con correo electrónico
1. Ingresa tu dirección de correo electrónico.
2. Selecciona **Continuar**.
3. Abre el mensaje de Runner y encuentra el código de seis dígitos.
4. Ingresa los seis dígitos. No necesitas seleccionar otro botón de envío.
5. Espera a que Runner te devuelva al destino seguro que inició el inicio de sesión.
## Completa las preguntas de nueva cuenta
Algunas cuentas nuevas ven **Cuéntale a Runner sobre tu tienda** antes de entrar en el espacio de trabajo.
1. Elige una respuesta para la pregunta abierta.
2. Selecciona **Siguiente pregunta** para continuar.
3. Usa **Cambiar** para revisar una pregunta respondida.
4. Selecciona **Empezar** cuando todas las preguntas requeridas estén completas.
El cuestionario solicita contexto comercial; no crea ni publica una tienda por sí solo.
## Solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| Correo electrónico inválido | La dirección está incompleta o no se puede usar como se ingresó. | Corrige la dirección, luego selecciona **Continuar** nuevamente. |
| Enviando | Runner está solicitando el correo electrónico de verificación. | Mantén la página abierta hasta que aparezca el formulario de código. |
| Código incorrecto | El código ingresado no fue aceptado. | Reingresa el código más reciente o solicita otro. |
| Cuenta atrás de reenvío | Otro código no se puede enviar aún. | Espera hasta que **Reenviar código de verificación** esté disponible. |
| El cuestionario no se guardó | Runner no pudo almacenar las respuestas. | Mantén tus respuestas en pantalla e intenta la acción nuevamente. |
No compartas un código de verificación con nadie. El soporte de Runner no lo necesita para ayudarte con un
problema de cuenta.
## Guías relacionadas
- [Comenzar](/es/guides/start-here)
- [Crear una tienda Runner](/es/guides/start-here/create-runner-store)
- [Construye tu primera tienda](/es/guides/start-here/first-store-quickstart)
---
# Usa el Tour de Bienvenida y Créditos Diarios
Source: https://www.runnerai.com/docs/es/guides/start-here/welcome-tour-and-daily-credits
**Qué cubre esta guía:** Saldrás del tour de bienvenida sabiendo dónde viven las herramientas principales y comprenderás qué cambia después de un registro diario.
Usa esta página cuando Runner abre **Te damos la bienvenida a Runner** o cuando **Ganar créditos** es visible.
## Rutas de entrada
- **Tour de bienvenida:** Runner abre **Te damos la bienvenida a Runner** automáticamente para una cuenta elegible. El recorrido no tiene una entrada de navegación permanente.
- **Créditos diarios:** **Ganar créditos** → **Check-in diario**.
## Antes de empezar
- El tour de bienvenida y la recompensa diaria pueden estar ausentes cuando la cuenta no es elegible o el paso ya está completo.
- Lee el monto, vencimiento y estado de reclamación en el diálogo actual en lugar de confiar en una captura de pantalla anterior.
- Los créditos de bienvenida son separados de los créditos de check-in diario. Lee el mensaje de bienvenida actual para ver qué ya se ha añadido antes de reclamar una recompensa diaria.
## Sigue el tour de bienvenida
Los seis pasos del tour presentan construcción y vista previa, Creative Studio, Habilidades, Dropshipping,
Operaciones de la tienda y Modo de diseño.
| Control | Qué sucede |
| --- | --- |
| Puntos de paso | Salta directamente al paso del tour seleccionado. |
| **Atrás** | Regresa al paso anterior. Está deshabilitado en el primer paso. |
| **Siguiente** | Abre el siguiente paso. |
| **Ampliar vídeo** | Abre la demostración actual en un tamaño más grande cuando el video esté listo. |
| **Saltar el tour** o cerrar | Descarta el tour sin cambiar la tienda. |
| **Empezar a construir** | Finaliza el último paso y cierra el tour. |
1. Lee el propósito del área actual.
2. Reproduce o amplía la demostración si te ayuda.
3. Selecciona **Siguiente**, **Atrás** o un punto de paso para moverte a través del tour.
4. Selecciona **Empezar a construir** en el paso final, u **Saltar el tour** cuando estés listo para trabajar.
El tour es instructivo. No ejecuta una habilidad, importa un producto ni cambia una vitrina.
## Reclama una recompensa diaria
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsiEEL0uaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
En la imagen: 1. Abre **Ganar créditos**. 2. Busca **Check-in diario**. 3. **Done** en la imagen indica que la recompensa de hoy ya se reclamó. Los valores de la cuenta están ocultos. Selecciona la imagen para ampliarla. Las anotaciones usan la interfaz de escritorio en inglés.
El diálogo puede mostrar la racha actual, los créditos disponibles hoy, la fecha de vencimiento de la recompensa,
créditos otorgados en el ciclo actual y el próximo hito.
Cuando Runner muestra **Regalo de bienvenida**, el mensaje confirma que los créditos de bienvenida mostrados ya están en el saldo. El botón diario reclama una recompensa separada; no reclama el regalo de bienvenida nuevamente.
Cerrar **Regalo de bienvenida** no elimina los créditos de bienvenida que ya están en el saldo. Cerrar un registro diario aún reclamable deja esa recompensa diaria separada sin reclamar.
1. Confirma que el diálogo dice que una recompensa es reclamable.
2. Revisa el monto y la fecha de vencimiento mostrados.
3. Selecciona **Registrarse hoy** o el botón de reclamación visible.
4. Espera el estado reclamado antes de cerrar el diálogo.
5. Verifica el saldo mostrado o el historial de recompensas para confirmar que la recompensa diaria se añadió una vez.
## Solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| Botón de reclamación disponible | La recompensa de hoy se puede reclamar para el espacio de trabajo mostrado. | Selecciónalo una vez y espera la confirmación. |
| Registrado / reclamado | La recompensa de hoy ya ha sido agregada. | Regresa en otro día elegible. |
| Recompensa no disponible | La cuenta no es actualmente elegible o no hay reclamación vencida. | Cierra el diálogo; no asumas que se agregó un crédito. |
| La reclamación falló | Runner no confirmó la recompensa. | Mantén el diálogo abierto e intenta nuevamente más tarde. |
Cerrar una recompensa reclamable la deja sin reclamar. Verifica el vencimiento mostrado antes de decidir regresar más tarde.
## Guías relacionadas
- [Comenzar](/es/guides/start-here)
- [Construye tu primera tienda](/es/guides/start-here/first-store-quickstart)
- [Crear una tienda Runner](/es/guides/start-here/create-runner-store)
---
# Operaciones de la tienda
Source: https://www.runnerai.com/docs/es/guides/store-operations
Las capturas y grabaciones muestran la interfaz en inglés.
Usa Operaciones de Tienda para administrar la información y actividad diaria detrás de tu tienda de Runner.
## Por qué y cuándo usar Operaciones de Tienda
Abre esta área después de que Runner haya creado tu tienda. Es el centro de control práctico para detalles de tienda, reglas de envío, productos, pedidos, clientes y promociones. Algunos trabajos, como el abastecimiento de proveedores o la moderación de reseñas, aparecen solo cuando la capacidad correspondiente está disponible.
## Disponibilidad y requisitos previos
- Inicia sesión y abre un proyecto de Runner que incluya una tienda.
- Espera si Runner muestra **Estamos preparando el panel de gestión de tu tienda; espera un momento.**. Las páginas se cargan cuando el backend de la tienda está listo.
- Tu rol en el espacio de trabajo y el estado de la tienda pueden limitar qué controles se muestran.
- Los servicios conectados de pago, envío, cumplimiento, reserva y proveedor pueden agregar controles específicos de estado.
## Abre Operaciones de Tienda
1. Abre **Espacio de trabajo**.
2. Elige la tienda que deseas administrar.
3. Selecciona **Operaciones de la tienda** en la navegación del proyecto.
4. Si aparecen tarjetas de configuración, [completa los detalles requeridos de la tienda y resuelve la configuración de productos/envíos](/es/guides/store-operations/onboarding-and-general-settings), luego selecciona **Abrir Operaciones de la tienda**.
5. Elige una sección del menú de Operaciones de la tienda.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRKgUAoOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Si aparecen estas tarjetas de configuración, completa los detalles requeridos y resuelve los hitos opcionales antes de usar el menú de administración. La imagen no muestra la configuración de publicación o pago.
## Pide a Runner que ayude desde el chat
**Ruta de entrada:** Abre el proyecto → elige **Nueva tarea** o una conversación existente.
Puedes pedir a Runner que inspeccione o actualice registros de tienda aprobados sin encontrar cada página de administrador
tú mismo. Esto incluye trabajo común con productos y variantes, clientes, inventario, envíos,
cumplimiento, pedidos, devoluciones, promociones y registros relacionados.
1. Nombra el registro y el resultado exacto que deseas.
2. Pide a Runner que inspeccione el estado actual primero cuando el cambio dependa de un pedido, inventario o
estado de cumplimiento.
3. Autoriza explícitamente el efecto exacto antes de una acción destructiva o de ciclo de vida de pedido. Una solicitud general
no es permiso para eliminar un registro, cancelar un pedido o avanzar el cumplimiento.
4. Espera el resultado de Runner, luego actualiza la página relevante de Operaciones de Tienda y verifica el estado actualizado
antes de reintentar o comenzar otro cambio.
El acceso a la cuenta, la configuración del sistema de tienda, los pagos y la administración fiscal no están disponibles a través de
esta capacidad de chat. Las importaciones de productos y otras cargas de archivos aún usan sus flujos dedicados.
## Elige la sección correcta
| Sección | Úsala para | Qué muestra al seleccionarla |
| --- | --- | --- |
| **General** | Visibilidad de tienda, identidad, mercados, ubicaciones de stock, envío y disponibilidad de reseñas | Abre la página de configuración compartida. La mayoría de campos usan **Guardar** de página; el interruptor **Reseñas de productos** se guarda inmediatamente. |
| **Pedidos** | Compras de clientes y progreso de cumplimiento | Abre la lista de pedidos; seleccionar una fila abre el registro de pedido completo. |
| **Productos** | Artículos de catálogo, precios, imágenes, variantes, inventario y SEO | Abre la lista de productos; **Añadir** inicia un nuevo producto y una fila abre la edición. |
| **Clientes** | Detalles de contacto de clientes, direcciones e historial de pedidos | Abre la lista de clientes; seleccionar una fila abre el registro de cliente. |
| **Promociones** | Descuentos automáticos y códigos de promoción | Abre la lista de promociones. Usa **Crear** o **Agregar Primera Promoción** en una lista vacía para elegir un tipo de descuento. |
| **Dropshipping** (navegación del proyecto) | Navegación condicional del catálogo del proveedor | Abre la entrada del proyecto por separado; los diseños más antiguos pueden mostrarlo dentro de Operaciones de la tienda. |
| **Impresión bajo demanda** (navegación del proyecto) | Productos impresos personalizados condicionales, gestionados por Printful | Abre la entrada del proyecto por separado. Consulta [Impresión bajo demanda con Printful](/es/guides/store-operations/print-on-demand). |
| **Reseñas** | Moderación condicional de reseñas | Aparece después de que las reseñas de productos estén habilitadas y sean compatibles con la tienda. |
**General aquí** gestiona detalles operativos como Mercados, Ubicaciones de Stock y Envíos. [General de la tienda en Configuración](/es/guides/account-and-settings/store-general) gestiona el nombre de Runner, la vista previa de búsqueda, el favicon y la marca de agua. Verifica qué página de General abriste antes de editar.
La grabación se mueve a través de Pedidos, Clientes y Reseñas en la tienda de tutoriales. Muestra estados vacíos y navegación; no se realiza ninguna compra, creación de cliente, reembolso o cumplimiento.
## Orden de configuración recomendado
1. Completa [incorporación y configuración general](/es/guides/store-operations/onboarding-and-general-settings).
2. Agrega una ubicación de stock y configura [envío](/es/guides/store-operations/shipping).
3. Crea [productos](/es/guides/store-operations/products) y verifica [variantes e inventario](/es/guides/store-operations/inventory-and-variants).
4. Conecta un servicio de pago desde **Apps** antes de probar el pago.
5. Usa [pedidos](/es/guides/store-operations/orders), [clientes](/es/guides/store-operations/customers) y [promociones](/es/guides/store-operations/promotions) cuando la actividad comience.
6. Usa [dropshipping](/es/guides/store-operations/dropshipping), [impresión bajo demanda](/es/guides/store-operations/print-on-demand) o [reseñas](/es/guides/store-operations/reviews-and-advanced-admin) solo cuando esas entradas y requisitos previos estén disponibles.
## Estados comunes y límites
- **Sin datos aún** es un estado válido. Productos, pedidos, clientes, promociones y reseñas muestran un mensaje vacío hasta que existan registros.
- **Cargar no es éxito.** Espera una lista, confirmación guardada o estado actualizado antes de asumir que una acción terminó.
- **Los cambios sin guardar permanecen en la página.** Usa **Guardar** donde se muestre; si Runner advierte sobre salir, elige si permanecer, guardar o salir sin guardar.
- **Las acciones destructivas requieren confirmación.** Eliminar un producto, cliente o promoción no puede asumirse como recuperable.
- **Los resultados del chat aún necesitan verificación.** Después de que Runner cambie un registro de tienda, actualiza la página relevante y confirma el nuevo estado antes de reintentar.
- **Las entradas condicionales pueden estar ausentes.** No uses una URL copiada como prueba de que tu tienda admite una característica oculta.
## Si Operaciones de Tienda no se carga
1. Confirma que abriste el proyecto previsto.
2. Espera a que se borre el mensaje de implementación, luego actualiza la página.
3. Vuelve al proyecto y selecciona **Operaciones de la tienda** nuevamente.
4. Si solo una sección falla, intenta su control **Actualizar** cuando esté disponible.
5. Si el problema continúa, mantén el nombre del proyecto, nombre de la sección, error visible y hora aproximada para soporte.
## Guías relacionadas
- [Te damos la bienvenida a Runner AI](/es/guides/product-guide)
- [Configuración general e incorporación](/es/guides/store-operations/onboarding-and-general-settings)
- [Productos](/es/guides/store-operations/products)
- [Pedidos](/es/guides/store-operations/orders)
---
# Clientes
Source: https://www.runnerai.com/docs/es/guides/store-operations/customers
Las capturas y grabaciones muestran la interfaz en inglés.
Usa Clientes para mantener los registros de compradores precisos y comprender los pedidos conectados a cada persona.
## Por qué y cuándo usar Clientes
Abre esta sección cuando necesites encontrar un comprador, agregar un registro de cliente, corregir información de contacto o envío, o revisar el historial de pedidos de la persona.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Un cliente puede aparecer después del pago o ser agregado manualmente.
- La lista etiqueta registros como **Invitado** o **Registrado** cuando esa información de cuenta está disponible.
- Una ubicación de stock guardada puede ser requerida por flujos de trabajo de tienda relacionados con direcciones, pero no es una afirmación de que una dirección de cliente sea un almacén.
- Usa datos de clientes solo para el propósito y acceso permitido por tu organización.
## Abre Clientes
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Clientes**
Selecciona una fila de cliente para abrir su perfil, detalles de actividad y recorrido disponibles, y Pedidos. Selecciona **Editar** para revelar el formulario General; Pedidos está oculto mientras editas.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4cFKBjWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Se espera una lista vacía antes de que existan clientes. No se creó ningún registro de cliente para este ejemplo.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Buscar clientes...** | Encuentra un cliente por detalles conocidos | Filtra la lista de clientes después de un breve retraso. |
| **Actualizar** | Solicita datos de cliente actuales | Recarga la lista y datos de ubicación relacionados. |
| **Crear** / **Agregar cliente** | Agrega un cliente manualmente | Abre el diálogo de creación de cliente. |
| **Crear** en el diálogo | Guarda el nuevo cliente | Crea un registro válido y abre su página de detalle después del éxito. |
| Fila de cliente | Inspecciona un cliente | Abre detalles de contacto, dirección de envío, tipo de cuenta e historial de pedidos. |
| **Editar** | Corregir información del cliente | Abre General con nombres, correo de solo lectura, empresa, teléfono y campos de dirección de envío. Pedidos está oculto mientras se edita. |
| Sección **Pedidos** | Revisar las compras del cliente | Muestra pedidos conectados o **Aún no hay pedidos** en la vista de detalles de solo lectura. |
| **Guardar** | Aplica cambios sin salir | Guarda ediciones válidas y mantiene la página de detalle abierta. |
| Atrás o cerrar con cambios sin guardar | Decide qué hacer con las ediciones | Abre un diálogo **Cambios sin guardar** con **Guardar y salir** y **Salir sin guardar**. |
| **Guardar y salir** | Aplica cambios y regresa | Del diálogo de cambios sin guardar, guarda ediciones válidas y regresa a la lista de clientes. |
| **Salir sin guardar** | Descarta ediciones después de una advertencia | Sale de la página de detalle sin aplicar cambios sin guardar. |
| Icono Eliminar de escritorio / **Eliminar** | Elimina un registro de cliente | Abre una confirmación; confirmar no se puede deshacer. La lista móvil actual no muestra esta acción. |
Un cliente creado manualmente está inscrito en **Todos los clientes suscritos**. Añade solo un registro real que tengas derecho a gestionar; no crees destinatarios solo para explorar el formulario. Secciones de actividad o recorrido vacías significan que no hay eventos disponibles para ese cliente, no que el perfil no se guardó.
La lista vacía puede mostrar **0 Clientes**. Usa la búsqueda, ordena y filtra por etiquetas para localizar registros una vez que existan clientes. Borra los filtros antes de concluir que falta un cliente.
El formulario en blanco muestra el Correo requerido y los campos opcionales disponibles. **Crear** permanece deshabilitado hasta que se proporcione la información requerida; no se guardó ningún registro.
## Agrega un cliente
1. Selecciona **Crear** o **Agregar cliente**.
2. Ingresa el **Correo** requerido. Añade Nombre y Apellido cuando se conozcan; revisa etiquetas opcionales, dirección, empresa, teléfono, campos personalizados y Memoria solo cuando tengas información relevante.
3. Revisa los valores para ortografía y el cliente deseado.
4. Selecciona **Crear** una vez.
5. En el registro abierto, selecciona **Editar** antes de añadir detalles opcionales de empresa, teléfono o dirección de envío.
6. Selecciona **Guardar**, luego regresa a la lista y confirma que aparece la nueva fila. Si sales con cambios sin guardar en su lugar, elige **Guardar y salir** en la advertencia.
7. Un cliente nuevo válido se inscribe automáticamente en **Todos los clientes suscritos**.
## Actualiza un cliente
1. Busca y selecciona el cliente.
2. Selecciona **Editar**. En el formulario **General**, revisa Nombre, Apellido, el Correo de solo lectura, Empresa, Teléfono y Dirección de envío.
3. Usa **Añadir** para agregar la información de dirección que Runner solicita, o **Borrar** para eliminar los valores de dirección editables actuales.
4. Selecciona **Guardar** para permanecer en el registro. Para guardar mientras sales, usa el control atrás o cerrar y elige **Guardar y salir** en la advertencia.
5. Deja de editar después de guardar, luego inspecciona **Pedidos** para confirmar las compras conectadas.
## Estados y límites
- **Invitado** significa que el registro no se muestra como una cuenta de cliente registrada; aún puede tener pedidos.
- Un invitado que compra o reserva en el pago no se inscribe en **Todos los clientes suscritos**. Solo se inscribe mediante el formulario del boletín de la tienda o al crear una cuenta.
- **Registrado** identifica un registro de cliente respaldado por cuenta.
- **Aún no hay clientes** y **Aún no hay pedidos** son estados vacíos válidos.
- La búsqueda filtra solo el proyecto actual.
- Las actualizaciones de cliente no cambian los totales de pedidos históricos o estados de pago.
- Volver a crear un cliente no anula una baja anterior ni la supresión de esa dirección por parte de un proveedor de correo electrónico.
- Eliminar es explícitamente irreversible y actualmente disponible solo desde la lista de escritorio. Confirma el correo electrónico mostrado antes de continuar y retén datos solo según la política de tu organización.
## Solución de problemas
- **No se encontraron clientes:** Borra o acorta la búsqueda y verifica que abriste el proyecto correcto.
- **La guardación falla:** Completa los campos requeridos, corrige el correo electrónico o dirección e intenta una vez más.
- **No puedes salir del registro:** Elige **Guardar y salir** o responde al diálogo Cambios sin guardar con **Salir sin guardar**.
- **Faltan pedidos:** Confirma que el pedido usó el mismo registro de cliente o correo electrónico y actualiza tanto Clientes como Pedidos.
- **Los detalles del cliente no se cargan:** Regresa a la lista, selecciona **Actualizar** y reabre la fila.
## Guías relacionadas
- [Pedidos](./orders)
- [Promociones](./promotions)
- [Incorporación y configuración general](./onboarding-and-general-settings)
- [Descripción general de operaciones de tienda](/es/guides/store-operations)
---
# Vender productos digitales
Source: https://www.runnerai.com/docs/es/guides/store-operations/digital-products
Usa los productos digitales para vender archivos, como libros electrónicos, guías en PDF, plantillas y otras descargas. No se envía nada. Cuando un comprador paga, Runner le envía por correo un enlace privado a una página de entrega en tu tienda, donde descarga los archivos dentro de los límites que fijes.
## Cómo funciona
1. **Crea un producto digital.** Elige **Digital** como tipo de producto. Los productos digitales no tienen envío ni inventario.
2. **Añade beneficios.** Un beneficio es lo que recibe el comprador, por ejemplo un conjunto de archivos. Los beneficios se pueden reutilizar en todos los productos de tu tienda.
3. **Escribe el correo de entrega.** Runner lo envía en cuanto se captura el pago.
4. **Publica.** Runner comprueba que cada beneficio tenga un archivo listo y que el correo de la tienda esté activado.
5. **Gestiona las entregas desde el pedido.** Reenvía el correo, revoca o vuelve a conceder el acceso y decide qué pasa con el acceso después de un reembolso.
### Vídeo: vende un producto digital de principio a fin
El vídeo crea un producto **Digital** y añade un beneficio de cada tipo: **Descargas de archivos**, **Códigos o enlaces de un solo uso**, **Enlace de invitación compartido** y **Nota**. Escribe el **Correo de entrega**, cambia el producto a **Publicado** y guarda. Después, un comprador lo compra con tarjeta, ve la compra en la página del pedido, abre el correo de entrega, descarga un archivo, muestra un código y selecciona **Enviarme un nuevo enlace por correo**. De vuelta en **Pedidos**, la tarjeta **Entrega digital** del pedido muestra cada beneficio, y el vídeo usa **Reenviar**, **Revocar** y **Volver a conceder**. Por último, reembolsa un segundo pedido con **Revocar el acceso del comprador**. Los datos de la tarjeta se introducen fuera de cámara. La interfaz, los subtítulos y la voz del vídeo están en inglés.
## Antes de empezar
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Productos**
Si **Digital** no aparece en la lista **Tipo de producto**, los productos digitales todavía no están activados en tu cuenta. Contacta con el [soporte de Runner](/es/guides/help-and-reference/support-and-community) para pedir acceso. Si el formulario del producto muestra **Tu tienda necesita una actualización antes de poder vender productos digitales.**, tu tienda usa una versión anterior; contacta con el soporte para actualizarla.
Necesitas:
- una tienda publicada, porque los compradores abren su compra en tu tienda;
- el correo de la tienda activado en **Proyecto → Apps → Gestiona tu tienda → Email** mientras el correo de entrega esté activado (consulta [Activar el correo de la tienda](/es/guides/apps-and-integrations/resend-email)); y
- un proveedor de pagos para que los compradores puedan pagar. Consulta [Pagos con Stripe](/es/guides/apps-and-integrations/stripe-payments).
## 1. Crea un producto digital
1. Abre **Operaciones de la tienda → Productos** y selecciona **Agregar**.
2. En **Tipo de producto**, elige **Digital**.
3. Escribe el nombre, la descripción, las imágenes y el precio como en cualquier producto.
Un producto digital no tiene sección de envío y su inventario no se controla: la lista de productos muestra **-** en **Inventario**. Quien compra solo productos digitales paga sin paso de envío.
## 2. Añade beneficios
La sección **Beneficios** muestra lo que reciben los compradores. Los compradores obtienen todos los beneficios de la lista.
### Crea un beneficio
1. Selecciona **Crear beneficio**.
2. Escribe un **Nombre**, por ejemplo «Archivos de la guía». Los compradores lo ven en la página de entrega y en el correo.
3. Suelta los archivos en **Suelta los archivos aquí** o selecciona **Buscar archivos**. Un beneficio admite hasta 20 archivos de hasta 5 GB cada uno. Los archivos son privados: los compradores solo los descargan con su enlace.
4. En **Reglas de acceso**, elige:
- **Limitar descargas** y el número de **Descargas por artículo**. Una descarga fallida se puede reintentar durante 15 minutos sin gastar otra descarga.
- **El enlace caduca** y cuánto tiempo **El enlace funciona durante**, en horas o días. Al reenviar, el comprador recibe un enlace nuevo.
5. Selecciona **Crear** para empezar a subir los archivos. Mantén el diálogo abierto hasta que terminen las subidas y el beneficio aparezca en la lista **Beneficios** del producto.
Para reutilizar un beneficio que ya creaste, selecciona **Añadir beneficio existente**. Arrastra los beneficios, o usa **Subir** y **Bajar**, para fijar el orden que ven los compradores. Un producto digital conserva al menos un beneficio.
### Elige el tipo de beneficio
Al crear un beneficio, elige su **Tipo**. No podrás cambiarlo después.
| Tipo | Qué reciben los compradores |
| --- | --- |
| **Descargas de archivos** | Archivos privados que los compradores descargan desde su página de entrega. |
| **Códigos o enlaces de un solo uso** | Cada comprador recibe un código o enlace distinto de una lista que pegas. El producto se agota cuando la lista se termina. |
| **Enlace de invitación compartido** | Un enlace que abren todos los compradores, como una invitación a una comunidad. |
| **Nota** | Un texto que los compradores ven tras la compra, o una etiqueta oculta para pedidos que gestionas tú. |
Si **Tipo** solo muestra **Descargas de archivos**, tu tienda usa una versión anterior; contacta con el [soporte de Runner](/es/guides/help-and-reference/support-and-community) para actualizarla.
#### Códigos o enlaces de un solo uso
1. En **Añadir códigos o enlaces**, pega un código o enlace por línea, hasta 10.000 a la vez. Los repetidos se omiten y cada valor se guarda cifrado.
2. El beneficio muestra cuántos valores están **Listos para vender** y cuántos están **Vendidos o reservados para pedidos**, y te avisa cuando quedan pocos. Si la lista está vacía, el producto aparece agotado y no se puede comprar.
3. Cada unidad que paga un comprador recibe su propio valor, que el comprador descubre en su página de entrega.
4. Para retirar un valor que nadie ha comprado, quítalo de **Valores sin usar**.
En el pedido, la tarjeta **Entrega digital** muestra el final de cada valor y si el comprador lo descubrió. Selecciona **Mostrar** para ver el valor completo o **Copiar** para copiarlo.
#### Enlace de invitación compartido
Escribe el **Enlace de invitación**, que empiece por https:// o http://. Todos los compradores reciben el mismo enlace, así que fija su caducidad donde se gestiona el enlace, por ejemplo en los ajustes de tu comunidad. La tarjeta del pedido muestra si el comprador lo abrió.
#### Nota
Escribe la nota en **Nota privada** y elige su **Visibilidad**:
- **Visible**: los compradores la ven tras la compra, en la confirmación del pedido y en su página de entrega.
- **Oculta**: se concede con la compra, pero nunca se muestra al comprador; por ejemplo, para etiquetar pedidos que gestionas tú.
Un producto publicado conserva al menos un beneficio que ven los compradores, así que no puedes ocultar su única nota visible. Tampoco puedes ocultar una nota que nombra el correo de entrega de un producto: quítala antes del correo. Las notas ocultas no tienen variables de correo.
### Pausa un beneficio
Desactiva el interruptor junto a un beneficio para pausarlo para todos los compradores de todos los productos que lo usan. Los compradores no pueden descargarlo hasta que lo vuelvas a activar. Las compras nuevas esperan, y su correo se envía en cuanto reactivas el beneficio.
### Cambia los archivos más tarde
Puedes añadir archivos a un beneficio en cualquier momento; los compradores existentes los ven en su página de entrega. Al quitar un archivo, desaparece para todos los compradores. Un beneficio que venden los productos conserva al menos un archivo: añade otro archivo primero o quita el beneficio de esos productos.
## 3. Escribe el correo de entrega
La sección **Correo de entrega** controla el mensaje que reciben los compradores en cuanto se captura el pago.
| Ajuste | Qué hace |
| --- | --- |
| **Enviar el correo de entrega** | Desactívalo para entregar solo en la página de confirmación del pedido. Los compradores acceden allí a su compra durante 24 horas, y el reenvío por parte del cliente queda desactivado. |
| **De** | El nombre del remitente que ven los compradores. El correo sale de la dirección de Runner y las respuestas llegan al correo de contacto de tu tienda. |
| **Asunto** y **Mensaje** | Usa **Insertar variable** para añadir el número de pedido, la fecha del pedido, el nombre del producto, el total pagado, el nombre o el correo del comprador, el nombre de tu tienda y **Todos los beneficios**, que imprime la lista de beneficios. El enlace, la caducidad y las descargas pertenecen a un único beneficio, por eso aparecen dentro de cada uno. |
| **URL del logotipo** y **Color de acento** | Todos los correos de entrega usan el mismo diseño. Con una **URL del logotipo**, tu logotipo aparece en la parte superior del correo, y el color de acento destaca el nombre y el botón de cada beneficio. Deja **URL del logotipo** vacía para enviar el correo sin logotipo. |
Selecciona **Vista previa** para ver el correo de un pedido de ejemplo. El editor rechaza las variables que no conoce.
En **Configuración avanzada**:
- **Los clientes pueden reenviar el correo** permite que los compradores lo pidan de nuevo desde su página de entrega, hasta 3 veces al día, a la dirección de correo del pedido.
- **Reenviar automáticamente si hay un rebote temporal** reintenta una vez después de 30 minutos con el mismo enlace.
## 4. Publica
Pon **Estado** en **Publicado** y guarda. Si falta algo, Runner guarda el producto como borrador y muestra **Este producto aún no se puede publicar** con lo que hay que corregir:
| Mensaje | Qué hacer |
| --- | --- |
| **Añade al menos un beneficio.** | Añade un beneficio en la sección **Beneficios**. |
| **Añade un archivo a** un beneficio | Sube al menos un archivo a ese beneficio. |
| **Espera a que** un beneficio **termine de subirse.** | Mantén la página abierta hasta que cada archivo muestre **Listo**. |
| **Activa la app Email en Apps o desactiva el correo de entrega de este producto.** | Activa **Email** en **Proyecto → Apps → Gestiona tu tienda** o desactiva **Enviar el correo de entrega**. |
| **Tu tienda necesita una actualización antes de poder vender productos digitales.** | Contacta con el [soporte de Runner](/es/guides/help-and-reference/support-and-community). |
## Qué recibe el comprador
1. El comprador paga. Un carrito con solo productos digitales no tiene paso de envío.
2. En cuanto se captura el pago, Runner le envía por correo un enlace a su página de entrega en tu tienda. La página de confirmación del pedido también muestra la compra durante 24 horas.
3. En la página de entrega, el comprador descarga cada archivo. Cada descarga cuenta para el límite, y el enlace deja de funcionar cuando caduca o cuando envías uno más reciente.
4. Si lo permites, el comprador puede pedir el correo de nuevo desde la página de entrega.
## Gestiona las entregas de un pedido
En **Operaciones de la tienda → Pedidos**, la columna **Gestión** muestra el estado de entrega de cada pedido digital, con los estados de la tabla de abajo. Si un pedido tiene varios beneficios, la columna muestra el que más requiere tu atención: primero **Fallido**, después un estado aún sin entregar (**Pendiente**, **Enviando** o **Enlace listo**) y después **Entregado**. **Descargas agotadas**, **Caducado** y **Revocado** solo aparecen cuando todos los beneficios han terminado. Un pedido muestra **Sin envío** hasta que se captura el pago.
Abre **Operaciones de la tienda → Pedidos** y selecciona un pedido. La tarjeta **Entrega digital** muestra cada beneficio con su estado, **Descargas usadas**, **El enlace caduca** y **Última actividad**.
| Estado | Significado |
| --- | --- |
| **Pendiente** | La entrega está esperando, por ejemplo mientras el beneficio está en pausa. |
| **Enlace listo** | El enlace existe. El correo está en cola, o el correo de entrega está desactivado. |
| **Enviando** | El correo va de camino. |
| **Entregado** | El correo llegó al comprador. |
| **Fallido** | La entrega se detuvo. La tarjeta explica por qué, por ejemplo **El correo de la tienda está desactivado** o **La tienda no está publicada**. |
| **Descargas agotadas** | El comprador usó todas sus descargas. Un reenvío las restablece. |
| **Caducado** | El enlace caducó. Un reenvío da un enlace nuevo. |
| **Revocado** | Revocaste el acceso. |
Usa las acciones de la tarjeta:
- **Reenviar** envía un enlace nuevo, opcionalmente a una dirección corregida. Los enlaces anteriores dejan de funcionar y las descargas agotadas se restablecen.
- **Revocar** detiene las descargas nuevas de un beneficio o de todo el pedido. Un enlace de descarga emitido en el último minuto todavía puede terminar.
- **Volver a conceder** restablece un acceso revocado con un cupo de descargas nuevo y envía un enlace nuevo.
**Historial de entrega** muestra cada correo y su resultado, y **Recorrido** muestra cada evento, como **Correo abierto**, **Página de entrega abierta** y **Descargado**. Selecciona **Exportar CSV** para descargar el recorrido.
Para encontrar los pedidos que te necesitan, activa el filtro **Requiere atención** en la lista de pedidos. Muestra las entregas fallidas y los reembolsos sin decisión sobre el acceso.
### Reembolsos
Cuando reembolsas un pedido con artículos digitales, elige **Mantener el acceso del comprador** o **Revocar el acceso del comprador** en el diálogo de reembolso. Un reembolso hecho en otro lugar, por ejemplo en el panel de tu proveedor de pagos, aparece en la tarjeta como reembolsado con el acceso aún activo, con **Mantener el acceso** y **Revocar el acceso**, para que decidas más tarde.
## Crea un producto digital en el chat
También puedes pedírselo a Runner en el chat. Adjunta los archivos a tu mensaje y describe el producto, por ejemplo «Vende este PDF como libro electrónico por 12 €». Runner crea un borrador del producto con un beneficio para los archivos y redacta el correo de entrega. Se detiene donde solo tú puedes actuar, por ejemplo cuando el correo de la tienda está desactivado. Revisa el borrador en **Productos** antes de publicar.
Los archivos adjuntos en el chat están limitados a lo que acepta el chat: documentos de hasta 10 MB e imágenes de hasta 32 MB. Sube los archivos más grandes en el formulario del producto.
## Solución de problemas
| Problema | Qué hacer |
| --- | --- |
| La tarjeta muestra **Fallido** con **El correo de la tienda está desactivado** | Activa **Email** en **Proyecto → Apps → Gestiona tu tienda** y selecciona **Reenviar**. |
| La tarjeta muestra **Fallido** con **La tienda no está publicada** | Publica tu tienda y selecciona **Reenviar**. |
| El correo aparece como **Rebotado** | Confirma la dirección con el comprador, selecciona **Reenviar** y escribe la dirección corregida. |
| **No había ningún archivo listo cuando se pagó el pedido.** | Sube un archivo al beneficio y selecciona **Reenviar**. |
| **El beneficio está en pausa.** | Vuelve a activar el beneficio. El correo pendiente se envía. |
---
# Dropshipping
Source: https://www.runnerai.com/docs/es/guides/store-operations/dropshipping
El dropshipping te permite vender productos de proveedores sin tener existencias: cuando un cliente compra, Runner envía el pedido a tu proveedor, y tú lo confirmas y lo pagas en tu cuenta de proveedor para que el proveedor lo envíe a tu cliente.
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Dropshipping**
Los diseños más antiguos pueden mostrar Dropshipping dentro de **Operaciones de la tienda**. Usa la entrada que muestre tu proyecto.
## Cómo funciona el dropshipping
| Etapa | Qué haces tú | Qué hace Runner |
| --- | --- | --- |
| [1. Conectar](#1-conectar-un-proveedor) | Conecta tu propia cuenta de CJ Dropshipping o AliExpress. | Usa esa cuenta para buscar, importar y crear pedidos al proveedor. |
| [2. Explorar y elegir](#2-explorar-y-elegir-un-producto) | Elige un destino, busca un producto y compara variantes, existencias y plazos de entrega estimados. | Carga datos en vivo del proveedor para tu cuenta conectada. |
| [3. Revisar y publicar](#3-revisar-y-publicar-un-producto) | Elige un mercado de destino, fija los precios, selecciona las variantes y añade el producto. | Crea el producto y lo publica en ese mercado. |
| [4. Completar pedidos](#4-completar-los-pedidos) | **Paga cada pedido al proveedor en tu cuenta de proveedor** y luego registra el envío en el pedido de la tienda. | Crea el pedido al proveedor automáticamente después del pago del cliente y muestra su estado y seguimiento. |
Para dejar de usar un proveedor o cambiar de cuenta de proveedor, consulta [Desconectar un proveedor](#desconectar-un-proveedor). Es una tarea aparte, con sus propias comprobaciones, y no forma parte del trabajo diario.
:::warning
Runner crea los pedidos al proveedor por ti, pero **no paga al proveedor**. Un pedido al proveedor sigue sin pagar, y no se envía, hasta que lo confirmas y lo pagas en tu cuenta de CJ o AliExpress.
:::
## Antes de empezar
- **Tu propia cuenta de proveedor.** Usa una cuenta de CJ Dropshipping o una cuenta de comprador de AliExpress que pueda pagar pedidos. Pagas al proveedor cada pedido por separado de lo que tu cliente te paga a ti.
- **Rol de propietario o administrador.** Solo un propietario o administrador del espacio de trabajo puede conectar o desconectar un proveedor. Los demás miembros ven **Solo el propietario o un administrador del espacio de trabajo puede conectar este proveedor. Pídeselo.**
- **Un mercado de la tienda.** Los destinos de dropshipping salen de los mercados de tu tienda. Sin un mercado, la página muestra **Añade un mercado para elegir un destino de envío y explorar productos.**
- **Un servicio de pago.** Los clientes solo pueden comprar después de conectar un servicio de pago en **Apps**.
Las conexiones de proveedores pertenecen a tu organización, así que todas las tiendas del espacio de trabajo usan las mismas conexiones de CJ y AliExpress. CJ y AliExpress se conectan por separado; conectar uno nunca reemplaza al otro.
## 1. Conectar un proveedor
Puedes explorar los estantes de vista previa **Tendencias**, **Selección económica** y **Menos de 5 $** sin conexión. Para buscar, abrir datos de productos en vivo y añadir productos necesitas un proveedor conectado.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
| Control | Para qué lo usas | Qué sucede al seleccionarlo |
| --- | --- | --- |
| **Conectar proveedor** | Iniciar tu primera conexión con un proveedor. | Abre **Conectar y gestionar proveedores** con paneles separados para CJ Dropshipping y AliExpress. |
| **Gestionar proveedores** | Revisar, reconectar o desconectar una conexión existente. | Sustituye a **Conectar proveedor** en cuanto hay algún proveedor conectado y abre el mismo diálogo. |
| **Cómo funciona** | Comparar los dos métodos de conexión. | Explica que CJ usa una clave API y AliExpress usa el inicio de sesión de AliExpress. |
| **Clave API de CJ** | Conectar tu cuenta de CJ. | Acepta la clave que copiaste de CJ. El valor permanece oculto. |
| **Ver las instrucciones de CJ** | Encontrar tu clave API en CJ. | Abre las instrucciones de CJ sobre la clave API en una pestaña nueva. |
| **Conectar CJ Dropshipping** | Enviar la clave. | Runner comprueba la clave con CJ. Si todo va bien, el diálogo se cierra y CJ aparece como conectado. |
| **Conectar AliExpress** | Conectar tu cuenta de comprador de AliExpress. | Te lleva al inicio de sesión de AliExpress y luego te devuelve a Dropshipping. |
| **Reconectar AliExpress** | Renovar el acceso a AliExpress antes o después de que venza. | Repite el inicio de sesión de AliExpress para la cuenta conectada. |
### Conectar CJ Dropshipping
1. Abre **Dropshipping** y selecciona **Conectar proveedor** (o **Gestionar proveedores**).
2. En tu cuenta de CJ Dropshipping, abre **Apps → API** y selecciona la pestaña **API**. Copia la clave de tipo **API Key** de la columna **API Key & MCP Token**. Si no tienes una, selecciona **Add API** para crearla. Si necesitas los pasos de CJ, selecciona **Ver las instrucciones de CJ** en Runner.
3. Pega la clave en **Clave API de CJ** y selecciona **Conectar CJ Dropshipping**.
4. Espera a que el diálogo se cierre y CJ Dropshipping aparezca como conectado.
5. Busca un producto para confirmar que se carga tu catálogo de CJ.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw6oh1NIkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
En CJ, abre **Apps** (1) y **API** (2), selecciona la pestaña **API** (3) y copia la clave de **API Key & MCP Token** (4). Selecciona la imagen para ampliarla. Mantén tu clave en privado; este ejemplo oculta los valores de las claves.
Si ves **No pudimos conectar CJ; revisa la clave de API y vuelve a intentarlo.**, vuelve a copiar la clave de CJ e inténtalo de nuevo. Este mensaje significa que CJ rechazó la clave. Si ves **CJ no ha respondido. Vuelve a intentarlo en un momento.**, CJ tuvo un problema al comprobar la clave; vuelve a intentarlo en breve. Si ves **CJ está limitando las solicitudes de esta cuenta. Espera unos minutos y vuelve a intentarlo.**, la clave puede seguir siendo válida: CJ está limitando las llamadas a tu cuenta de CJ, por ejemplo porque otra aplicación usa la misma clave. Espera unos minutos y vuelve a intentarlo.
### Conectar AliExpress
1. Abre **Dropshipping** y selecciona **Conectar proveedor** (o **Gestionar proveedores**).
2. Selecciona **Conectar AliExpress**. Tu navegador sale de Runner y abre el inicio de sesión de AliExpress.
3. Inicia sesión con la cuenta de **comprador** de AliExpress que usarás para pagar los pedidos al proveedor y aprueba el acceso.
4. Cuando AliExpress te devuelva a Runner, busca **AliExpress está conectado**. Si empezaste desde una búsqueda o un producto, Runner te devuelve allí.
Si ves **No pudimos abrir el inicio de sesión de AliExpress. Vuelve a intentarlo.**, vuelve a iniciar la conexión desde la misma cuenta de Runner.
**El acceso a AliExpress vence.** AliExpress decide cuánto dura el acceso. Runner muestra **Tu autorización de AliExpress vence pronto** y envía un correo a los propietarios y administradores del espacio de trabajo 7 días y 1 día antes del vencimiento. Selecciona **Reconectar AliExpress** e inicia sesión con la **misma** cuenta de AliExpress. Si el acceso vence, la búsqueda, la importación y los nuevos pedidos de AliExpress se detienen hasta que vuelvas a conectar.
La grabación revisa las conexiones existentes de CJ y AliExpress y luego vuelve al catálogo. No conecta, desconecta, compra ni importa nada.
## 2. Explorar y elegir un producto
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgL9CDE0P6BaUgYNS457p8WDbAxIJ2kfdz9Vju)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
| Control | Para qué lo usas | Qué sucede al seleccionarlo |
| --- | --- | --- |
| **Tendencias**, **Selección económica**, **Menos de 5 $** | Ver ideas sin buscar. | Abre un estante de vista previa. Los estantes no garantizan popularidad, margen ni plazos de entrega. |
| **Buscar productos...** | Encontrar artículos por palabra clave. Con AliExpress también puedes pegar un ID o enlace de producto. | Carga resultados de tu proveedor conectado. Sin conexión, abre el diálogo de conexión. |
| **Enviar a** | Elegir el país al que vendes. | Vuelve a cargar los productos que se pueden enviar allí. Solo puedes seleccionar países de los mercados de tu tienda; los demás muestran **Agregar** para que crees un mercado. |
| Selector de proveedor | Limitar los resultados a un proveedor. | Muestra **Todos los proveedores**, **CJ Dropshipping** o **AliExpress**, según lo que hayas conectado. |
| **Categoría**, **Enviar desde**, **Precio** | Acotar los resultados. | Filtra por categoría, país del almacén del proveedor y tu precio mínimo y máximo. |
| Orden | Cambiar el orden de los resultados. | CJ ofrece ordenar por precio, por publicación y por más recientes. AliExpress ofrece **Mejor coincidencia** y **Más pedidos (últimos 180 días)**; no puede ordenar por precio de forma fiable. |
| Tarjeta de producto | Evaluar un artículo. | Abre sus imágenes, variantes, existencias, precio del proveedor y plazos de entrega estimados. |
1. Elige **Enviar a**. Empieza en Estados Unidos si es uno de tus mercados; si no, en tu mercado predeterminado.
2. Explora un estante o busca. Usa el selector de proveedor y los filtros para acotar los resultados.
3. Abre una tarjeta de producto. Revisa las imágenes, las variantes que quieres vender, las existencias (**en stock** o **Sin existencias**) y el precio del proveedor.
4. Para cada variante, revisa el **Método de envío de referencia** y el **Plazo de entrega estimado**. Son estimaciones del proveedor, no garantías de entrega.
5. Selecciona **Atrás** para comparar otros productos. Tu destino sigue seleccionado.
## 3. Revisar y publicar un producto
La página del producto reúne en un solo lugar la configuración del producto, el mercado, los precios y el envío. Al seleccionar **Añadir producto a la tienda**, se crea el producto y se publica en el mercado seleccionado.
| Control | Para qué lo usas | Qué sucede al seleccionarlo |
| --- | --- | --- |
| **Mercado de destino** | Elegir qué mercado vende este producto. | Define la moneda de tus precios. Empieza con lo que elegiste en **Enviar a**. **Añadir mercado** crea uno nuevo. |
| **Gastos de envío del cliente** | Decidir cuánto pagan los clientes por la entrega. | **Usar las tarifas de envío de la tienda** cobra en el pago las tarifas de envío de tu mercado. |
| **Definir recargo** | Poner precio a todas las variantes con un solo recargo. | Sugiere un precio de venta para cada variante seleccionada a partir de su coste de producto y la referencia de envío del proveedor. |
| **Precios de venta** | Fijar tu precio de venta por variante. | Actualiza el beneficio y el margen estimados de esa variante. |
| Casilla de variante | Elegir qué variantes vender. | Añade o quita la variante. La barra de acciones muestra cuántas variantes están seleccionadas. |
| **Método de envío de referencia** | Estimar tu coste de envío del proveedor. | Actualiza el desglose de costes: **Coste del producto**, **+ Referencia de envío del proveedor**, **+ Beneficio · margen**. |
| **Añadir producto a la tienda** | Crear y publicar el producto. | Importa las variantes seleccionadas y publica el producto en el mercado de destino. Muestra **Conectar proveedor** si no hay conexión. |
### Configurar los detalles y precios del producto
1. Elige el **Mercado de destino**.
2. Selecciona solo las variantes que vas a vender. Omite las variantes que muestran **Sin existencias**.
3. Elige un **Método de envío de referencia** para cada variante y revisa su **Plazo de entrega estimado**.
4. Introduce un recargo en **Definir recargo** o escribe un precio para cada variante en **Precios de venta**.
5. Revisa el desglose de costes y el **Beneficio medio estimado por unidad**. Asegúrate de que cada precio cubra el coste del producto y el envío del proveedor que vas a pagar.
CJ indica los costes del proveedor en dólares estadounidenses. Si tu mercado usa otra moneda, Runner muestra importes convertidos solo como referencia.
### Elegir los mercados de destino
- Cada importación publica en un solo mercado cada vez. Los precios se guardan en la moneda de ese mercado.
- Para vender el mismo producto en otro mercado, vuelve al producto en Dropshipping, elige el otro **Mercado de destino**, introduce los precios en esa moneda y selecciona otra vez **Añadir producto a la tienda**.
- Todas las variantes del producto necesitan un precio en la moneda del mercado antes de poder publicarse allí.
### Configurar el envío
- Los clientes pagan las **tarifas de envío de la tienda** de su mercado, no el coste de envío del proveedor. Incluye el envío estimado del proveedor en el precio del producto o en tu tarifa de envío.
- El **Costo de envío** de un mercado nuevo es la tarifa que pagan los clientes. **Introduce 0 para el envío gratuito.** Puedes cambiar las opciones de entrega más adelante en [Envío](./shipping).
- Los costes del proveedor varían según la dirección de entrega. En el pago, Runner vuelve a comprobar tu conexión con el proveedor, las existencias, el precio y el envío para la dirección del cliente. Si el proveedor ya no puede suministrar el artículo, el pago se detiene en lugar de aceptar un pedido que no puedes completar.
### Publicar y comprobar el resultado
1. Selecciona **Añadir producto a la tienda** cuando tengas listas las variantes y los precios.
2. Espera el mensaje **Publicado. Puedes seleccionar otro mercado para publicar este producto allí.** También aparece un mensaje **Cambios guardados** con **Ver tienda**.
3. Abre **Productos** y revisa el producto, sus variantes, precios, imágenes y descripción. Allí puedes editar el título, la descripción y las imágenes.
4. Previsualiza la tienda y confirma que el producto aparece en el mercado que elegiste.
Los productos de dropshipping no llevan control de inventario en Runner; las existencias del proveedor se comprueban en el pago. La columna **Inventario** de Productos muestra un guion para ellos.
Si ves **El resultado no está confirmado. Reintenta la misma solicitud antes de cambiar la selección.**, vuelve a seleccionar la misma acción sin cambiar tus selecciones y luego revisa **Productos**.
Las tiendas más antiguas pueden mostrar otra página de producto con **Enviar desde**, **Enviar a**, una lista de métodos de envío y **Agregar a la tienda**. Se aplican las mismas reglas: elige una ruta y una cotización, fija un precio para cada variante seleccionada y luego añade el producto.
## 4. Completar los pedidos
Cuando un cliente compra un producto de dropshipping, el cumplimiento tiene dos partes. Runner crea el pedido al proveedor por ti. **Después tienes que confirmarlo y pagarlo en tu cuenta de proveedor.** El proveedor no envía nada hasta que lo hagas.
### Qué hace Runner automáticamente
- Después del pago del cliente, Runner crea un pedido al proveedor en tu cuenta conectada de CJ o AliExpress. No tienes que hacer clic en nada en Runner para enviarlo.
- Un pedido de la tienda puede generar varios pedidos al proveedor, uno por cada proveedor, almacén o método de envío.
- Cada pedido al proveedor aparece en la sección **Cumplimiento Dropshipping** del pedido de la tienda, con su estado, **Método de envío**, **Almacén**, **Artículos** y hora de **Última actualización**. Los datos de seguimiento aparecen cuando el proveedor hace el envío.
- Si un pedido al proveedor no se puede crear al primer intento, Runner sigue reintentándolo y mientras tanto muestra **Creación pendiente**.
- Runner actualiza el estado del proveedor cuando abres el pedido, cuando seleccionas **Actualizar estado** y en una comprobación diaria en segundo plano para los pedidos realizados en los últimos 90 días. Para pedidos abiertos más antiguos, selecciona **Actualizar estado** o contacta con soporte.
Runner **no** paga al proveedor y **no** marca el pedido de la tienda como enviado por ti.
### Completar un pedido paso a paso
1. Abre **Operaciones de la tienda → Pedidos** y selecciona el pedido.
2. Busca **Cumplimiento Dropshipping**. Espera a que el pedido al proveedor muestre **Creado** o **No pagado**. Si todavía muestra **Creación pendiente**, vuelve a mirarlo más tarde; Runner lo está reintentando.
3. **Paga el pedido al proveedor en tu cuenta de proveedor:**
- **CJ Dropshipping:** inicia sesión en CJ, abre tus pedidos y busca el pedido cuyo número contiene tu número de pedido de Runner (por ejemplo, `…-1042-0` para el pedido 1042). Confirma los datos de envío y págalo con tu saldo de CJ o tu método de pago.
- **AliExpress:** Runner muestra **Se requiere pago manual** y los **ID de pedidos de proveedor de AliExpress**. Inicia sesión en la cuenta de comprador de AliExpress conectada y paga cada pedido de la lista.
4. Vuelve al pedido en Runner y selecciona **Actualizar estado**. Después del pago, el estado pasa a **En proceso** y luego a **Enviado** cuando el proveedor lo despacha.
5. Cuando **todos** los pedidos al proveedor de **Cumplimiento Dropshipping** muestren **Enviado**, selecciona **Marcar como preparado** en el pedido de la tienda y luego **Marcar como enviado**. Introduce el **Transportista** y un **Número de seguimiento** de la sección Cumplimiento Dropshipping. Así queda registrado el envío en el pedido de la tienda que ve tu cliente.
6. Cuando todos los pedidos al proveedor muestren **Entregado**, selecciona **Marcar como entregado**.
**Marcar como preparado** y **Marcar como enviado** se aplican a todo el pedido de la tienda, incluidos los artículos que envías tú mismo, y solo puedes marcar un pedido como enviado una vez. Si un pedido tiene varios pedidos al proveedor, espera a que todos se hayan enviado y luego envía directamente a tu cliente los demás números de seguimiento.
:::warning
No vuelvas a crear tú mismo el mismo pedido en CJ o AliExpress. Runner ya lo creó. Un segundo pedido significa que el proveedor envía y te cobra dos veces.
:::
### Estados de los pedidos al proveedor
| Estado | Qué significa | Qué hacer |
| --- | --- | --- |
| **Creación pendiente** | Runner todavía está creando el pedido al proveedor. | Espera. Runner lo reintenta automáticamente. **Actualizar estado** todavía no sirve. |
| **Creado**, **En carrito**, **No pagado** | El proveedor tiene el pedido, pero no está pagado. | Págalo en tu cuenta de CJ o AliExpress. |
| **En proceso**, **Otro** | Pagado; el proveedor lo está preparando. Los pedidos de AliExpress en esta etapa muestran **Otro**. | Espera el seguimiento. Selecciona **Actualizar estado** para comprobarlo. Si un pedido de AliExpress se queda en **Otro**, ábrelo en tu cuenta de AliExpress para ver si necesita algo, como una dirección completa. |
| **Enviado** | El proveedor lo despachó. | Selecciona **Rastrear pedido** para seguirlo. Cuando todos los pedidos al proveedor del pedido de la tienda se hayan enviado, registra el envío con **Marcar como enviado**. |
| **Entregado** | El proveedor indica que se entregó. | Selecciona **Marcar como entregado** en el pedido de la tienda. |
| **Cancelación pendiente** | Runner pidió al proveedor que lo cancele. | Espera y luego selecciona **Actualizar estado**. |
| **Cancelado**, **Anulado** | El pedido al proveedor no se enviará. | Comprueba que el pedido de la tienda también esté cancelado o reembolsado. |
| **Fallido** | Runner no pudo crear el pedido al proveedor. | Busca el pedido en tu cuenta de proveedor. Si no está, contacta con soporte antes de crearlo manualmente. |
| **Revisión manual necesaria** | Runner no pudo confirmar si el proveedor recibió el pedido. | No lo vuelvas a enviar. Selecciona **Contactar con soporte** para que el pedido se pueda conciliar de forma segura. |
### Cancelar o reembolsar un pedido de dropshipping
Cuando seleccionas **Cancelar pedido** en un pedido de la tienda, Runner pide automáticamente al proveedor que cancele sus pedidos al proveedor. No necesitas ningún paso aparte en Runner.
- **CJ Dropshipping:** Runner envía la cancelación a CJ mientras el pedido al proveedor no se haya enviado. CJ decide si todavía se puede cancelar.
- **AliExpress:** Runner solo puede detener el pedido antes de que se cree en AliExpress; AliExpress no acepta cancelaciones desde Runner. A partir de ese momento, Runner muestra **Se requiere cancelación manual** y **No pagues. Cancela estos ID de pedidos de proveedor en la cuenta de comprador de AliExpress conectada.** Cancela esos pedidos en tu cuenta de AliExpress.
Después de cancelar, abre el pedido y revisa **Cumplimiento Dropshipping**. **Cancelación pendiente** significa que Runner está esperando al proveedor; **Cancelado** significa que ya está hecho. Si el estado no llega a **Cancelado**, cancela el pedido directamente en tu cuenta de CJ o AliExpress y no lo pagues.
- **Un reembolso no cancela el pedido al proveedor.** Si reembolsas a un cliente sin cancelar el pedido, el proveedor puede enviarlo igualmente y cobrártelo.
- **Runner no reembolsa los costes del proveedor.** Si ya pagaste al proveedor, solicita el reembolso a CJ o AliExpress.
## Desconectar un proveedor
Desconecta un proveedor solo cuando dejes de usarlo o necesites cambiar de cuenta de proveedor. Al desconectar se eliminan de la organización tu clave API de CJ o tu acceso a AliExpress. Esto afecta a todas las tiendas del espacio de trabajo.
:::warning
**Completa y cierra los pedidos en curso antes de desconectar.** Después de desconectar, Runner deja de actualizar esos pedidos al proveedor: el estado, el seguimiento, **Actualizar estado** y la cancelación dejan de funcionar en Runner, y tendrás que gestionarlos directamente en CJ o AliExpress.
:::
### Antes de desconectar
1. Abre **Operaciones de la tienda → Pedidos** y revisa cada pedido que tenga una sección **Cumplimiento Dropshipping** de este proveedor.
2. Paga o cancela cada pedido al proveedor en estado **Creado**, **En carrito** o **No pagado**.
3. Espera a que los pedidos en **Creación pendiente** y **En proceso** se creen, se envíen o se cancelen.
4. Registra el envío en cada pedido de la tienda con **Marcar como enviado** cuando todos sus pedidos al proveedor se hayan enviado.
5. Pasa los productos de este proveedor a **Borrador** en **Productos**, o elimínalos. Después de desconectar, los clientes no podrán completar el pago con ellos.
### Desconectar
1. Abre **Dropshipping** y selecciona **Gestionar proveedores**.
2. Selecciona **Desconectar** en CJ Dropshipping o AliExpress.
3. Lee **¿Desconectar CJ Dropshipping?** o **¿Desconectar AliExpress?**: **No podrás añadir productos nuevos ni recibir actualizaciones de este proveedor. Los productos y pedidos que ya están en Runner se conservan.**
4. Selecciona **Desconectar** para confirmar, o **Cancelar** para mantener la conexión.
5. Comprueba que el proveedor ya no aparece como conectado.
Si ves **No pudimos desconectar CJ; sigue conectado. Vuelve a intentarlo.** o **AliExpress sigue conectado. No se pudo desconectar. Vuelve a intentarlo.**, la conexión sigue activa. Vuelve a intentarlo y no des por hecho que se eliminó.
### Qué cambia después de desconectar
| Área | Resultado |
| --- | --- |
| Productos | Siguen en **Productos**, pero el pago se detiene para ellos hasta que vuelvas a conectar y, si hace falta, los importes de nuevo. |
| Pedidos nuevos | Los clientes no pueden comprar los productos de este proveedor, así que no se crean pedidos nuevos al proveedor. |
| Pedidos al proveedor existentes | Siguen en el pedido, pero dejan de actualizarse. Gestiónalos en CJ o AliExpress. |
| El otro proveedor | No se ve afectado. Desconectar CJ no desconecta AliExpress, ni al revés. |
## Solución de problemas
- **Buscar o Añadir producto a la tienda abre el diálogo de conexión:** conecta CJ o AliExpress. Los estantes de vista previa no cuentan como conexión.
- **Sin resultados:** borra la búsqueda y los filtros, confirma **Enviar a** o cambia de proveedor.
- **No se puede seleccionar un país en Enviar a:** añade un mercado para ese país y vuelve a elegirlo.
- **Un pedido se queda en No pagado:** Runner nunca paga a los proveedores. Paga el pedido en tu cuenta de CJ o AliExpress.
- **El cliente no ha recibido el seguimiento:** Runner no copia el seguimiento del proveedor en el pedido de la tienda. Usa **Marcar como enviado** con el número de seguimiento.
- **Actualizar estado falla con "Ocurrió un error":** es posible que la conexión con el proveedor haya cambiado desde que se hizo el pedido. Revisa **Gestionar proveedores** y luego gestiona el pedido en tu cuenta de proveedor.
- **El pago se detiene para un producto de dropshipping:** cambió la conexión con el proveedor, las existencias, el precio o el envío. Vuelve a conectar el proveedor o importa el producto de nuevo.
- **Un producto muestra un resultado incorrecto después de Añadir producto a la tienda:** revisa **Productos** antes de reintentar. Un estado de carga no demuestra que la importación haya terminado.
- Para ver los mensajes de error exactos, consulta la [guía de errores del catálogo de Dropshipping](/es/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products).
## Guías relacionadas
- [Pedidos](./orders)
- [Productos](./products)
- [Envío](./shipping)
- [Inventario y variantes](./inventory-and-variants)
- [Conectar CJ Dropshipping](/es/guides/apps-and-integrations/cj-dropshipping)
- [Descripción general de Operaciones de la tienda](/es/guides/store-operations)
---
# Importar productos
Source: https://www.runnerai.com/docs/es/guides/store-operations/import-products
Las capturas y grabaciones muestran la interfaz en inglés.
Importa productos desde un CSV preparado cuando ingresar la misma información de catálogo estructurada uno a uno sería ineficiente.
## Por qué y cuándo usar importación
Usa Importar cuando ya tienes datos de producto en una hoja de cálculo u otro sistema y puedes asignarlos a la plantilla CSV de Runner. Usa el formulario manual [Productos](./products) para un catálogo pequeño o cuando necesites aprender los campos primero.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Abre **Operaciones de la tienda → Productos** en una tienda lista.
- Completa la configuración de publicación/preparación de la tienda que crea su canal de catálogo de tienda en vivo; la tarea de importación no puede continuar sin ese canal.
- La lista de productos de escritorio poblada muestra **Importar**. En un catálogo vacío, primero usa **Añadir primer producto**; la vista móvil enfatiza la creación manual.
- Importar acepta solo archivos CSV.
- Usa la Plantilla actual de Runner. Las columnas requeridas son `Product Handle` y `Product Title`; las filas de variantes deben incluir el `Variant SKU` requerido y los valores de opción mostrados por la plantilla.
- Iniciar una importación cambia el catálogo de la tienda. Revisa el archivo antes de enviarlo.
## Abrir Importar productos
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Productos → Importar**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRTPhrLOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Importar** | Abre el flujo de trabajo de importación masiva | Abre el diálogo Importar productos sin iniciar una tarea. |
| **Plantilla** | Comienza con las columnas esperadas de Runner | Descarga el archivo `product-import-template.csv` actual. |
| **Historial** | Verifica tareas de importación anteriores | Cambia a una lista de archivos de importación y sus estados más recientes. |
| Área de carga | Elige el CSV preparado | Lee el archivo localmente y lo muestra como listo cuando el contenido está disponible. |
| Control de eliminar archivo | Corrige una selección incorrecta | Limpia el archivo seleccionado para que puedas elegir otro. |
| **Iniciar importación** | Envía el CSV seleccionado | Inicia una tarea de importación, luego se mueve al Historial cuando Runner la acepta. |
| **Cancelar** | Sal sin enviar | Cierra el diálogo y limpia el archivo seleccionado. |
| **Actualizar** en Historial | Solicita el estado de tarea más reciente | Recarga el historial de importación visible. |
| **Volver a importar** | Prepara otro archivo | Vuelve de Historial a la vista de carga. |
| **Cerrar** | Sal de Historial | Cierra el diálogo sin cambiar la tarea ya enviada. |
## Prepara y envía un CSV
1. Selecciona **Importar**, luego **Plantilla**.
2. Abre el CSV descargado en un editor de hojas de cálculo que preserve el formato CSV.
3. Mantén los encabezados de plantilla. Completa `Product Handle` y `Product Title` para productos, más el `Variant SKU` mostrado y valores de opción para variantes.
4. Revisa identificadores de producto, títulos, precios, variantes y cualquier fila repetida antes de exportar como CSV.
5. Vuelve al diálogo y elige o arrastra el CSV al área de carga.
6. Espera hasta que el archivo muestre **Listo para importar**.
7. Selecciona **Iniciar importación** una sola vez.
8. En **Historial**, sigue el archivo enviado hasta que alcance un estado terminal, luego actualiza la lista de Productos e inspecciona las filas resultantes.
Para aprender el flujo de trabajo sin cambiar el catálogo, descarga la **Plantilla**, revisa sus encabezados, luego abre el **Historial**. Regresa con **Volver a importar** y cierra el diálogo. Seleccionar un archivo lo prepara; solo **Iniciar importación** envía un cambio de catálogo.
La grabación inspecciona los requisitos de importación y el Historial vacío, luego regresa a los productos en borrador. No se envía ni importa ningún CSV.
## Comprende los estados del Historial
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| **Pendiente** | La tarea está esperando para comenzar | Déjala en su lugar y verifica más tarde; no envíes inmediatamente un duplicado. |
| **Procesando** | Runner está trabajando a través del archivo | Mantén el diálogo abierto o vuelve al Historial más tarde. |
| **Completada** | Runner terminó de entregar el archivo al importador de catálogo | El procesamiento de producto puede continuar después de este estado. Actualiza Productos e inspecciona nombres, variantes, precios, estado e inventario. |
| **Error** | Runner no pudo terminar la tarea de importación | La tarjeta de Historial actual registra el estado fallido pero no una causa detallada. Verifica los requisitos previos y CSV de origen antes de enviar un nuevo archivo. |
| **Cancelado** | La tarea no continuó | Confirma si se crearon productos antes de decidir qué enviar a continuación. |
El Historial también puede mostrar el tamaño del archivo, filas totales e ID de transacción cuando Runner tiene esos valores. Estos detalles identifican la tarea; no reemplazan la verificación de los registros de producto.
## Límites y solución de problemas
- **Iniciar importación está deshabilitado:** Selecciona un archivo `.csv` y espera a que Runner termine de leer contenido no vacío.
- **Tipo de archivo inválido:** Exporta la hoja de cálculo como CSV; renombrar otro formato de archivo no lo convierte.
- **Error de lectura de archivo:** Re-exporta el CSV, confirma que se abre normalmente en tu dispositivo y elige de nuevo.
- **Importación fallida:** Confirma que la configuración de publicación/preparación de la tienda creó el canal de catálogo de tienda en vivo, luego usa la plantilla proporcionada, restaura columnas requeridas y verifica variante `Variant SKU` y valores de opción.
- **La tarea parece atascada:** Abre Historial y selecciona **Actualizar**. Pendiente y Procesando no son prueba de finalización.
- **Aparecen filas de producto inesperadas:** No repitas la misma importación ciegamente. Compara los identificadores de CSV con la lista de Productos y corrige registros deliberadamente.
## Guías relacionadas
- [Productos](./products)
- [Inventario y variantes](./inventory-and-variants)
- [Incorporación y Configuración general](./onboarding-and-general-settings)
- [Descripción general de Operaciones de la tienda](/es/guides/store-operations)
---
# Inventario y variantes
Source: https://www.runnerai.com/docs/es/guides/store-operations/inventory-and-variants
Las capturas y grabaciones muestran la interfaz en inglés.
Usa variantes e inventario para representar las opciones que los clientes pueden comprar y la cantidad que la tienda puede vender.
## Por qué y cuándo usar variantes e inventario
Añade variantes cuando un producto tiene opciones de cliente como tamaño o color. Ingresa inventario cuando Runner debe rastrear cuántas unidades están disponibles en la ubicación de stock de la tienda.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Guarda una Ubicación de stock en **Operaciones de la tienda → General** antes de ingresar inventario rastreado.
- Guarda el Mercado y moneda apropiados antes de establecer precios.
- Abre un producto manual. Los productos de reserva y envío directo pueden usar reglas de disponibilidad diferentes y mostrar un guión en la lista en lugar de totales de inventario normales.
- Planifica nombres y valores de opción antes de editar un producto en vivo porque cambiarlos puede cambiar el conjunto de variantes comprables.
## Abrir variantes e inventario
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Productos → Añadir**, o selecciona una fila de producto existente, luego encuentra **Variación** y los campos de precio y stock en línea.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggCsEjzIC4NbwvYeKD2nM5xTZ76dBjp0auiyP)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Inspecciona cada precio de variación y valor de stock antes de guardar. No se guardó ninguna actualización de inventario o precio para esta captura de pantalla.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| Control de añadir opción en **Variación** | Añadir la primera opción del cliente | Crea campos para un nombre de opción y sus valores. |
| Control de añadir valor | Añadir otra opción dentro de una opción | Añade otro valor que se puede combinar en variantes. |
| Otra opción | Añadir una segunda dimensión como color | Crea otro grupo de opciones y expande las combinaciones de variantes. |
| **Eliminar** | Elimina una opción o valor | Elimina esa opción del formulario y puede cambiar las combinaciones generadas. |
| **Agrupar por** | Organiza una lista de variantes larga | En escritorio, cambia cómo se agrupan las variantes actuales para editar. |
| Precio de variante | Establece el precio de venta para una opción | Asocia la cantidad ingresada y moneda con esa variante. |
| **Fijar precio de oferta** | Añade un precio promocional más bajo | Abre campos de precio de venta y cronograma opcional para el artículo o variante seleccionada. |
| Cantidad **Disponible** | Establece inventario rastreado para una variante | Actualiza la cantidad de inventario sin guardar mostrada para esa variante y Ubicación de stock. |
| **Guardar** | Aplica la configuración de producto completa | Guarda cambios válidos de opción, variante, precio e inventario juntos. |
## Crea variantes de producto
1. Abre Añadir producto o el producto existente previsto.
2. En **Variación**, selecciona el control de añadir opción.
3. Ingresa un nombre de opción amigable para el cliente, luego añade cada valor de opción válido.
4. Añade otra opción solo cuando el producto tenga una segunda opción independiente.
5. Revisa cada variante generada. Elimina valores accidentales antes de ingresar precios o stock.
6. Establece el precio correcto y cantidad disponible para cada variante.
7. Selecciona **Guardar**, luego reabre la fila y confirma el número de variantes.
### Ejemplo: dos tamaños de vela
Usa una opción llamada `Size` con valores `Small` y `Large`. Espera dos variantes. Establece el precio y el stock disponible de cada variante, luego **Guardar** y vuelve a abrir el producto.
| Opciones que ingresas | Variantes a verificar |
| --- | --- |
| Tamaño: Pequeño, Grande | Pequeño; Grande — 2 variantes |
| Tamaño: Pequeño, Grande más Aroma: Cedro, Cítrico | Pequeño/Cedro; Pequeño/Cítrico; Grande/Cedro; Grande/Cítrico — 4 variantes |
Solo añade la segunda opción si vendes todas las cuatro combinaciones. Confirma el stock por variante en lugar de copiar el total en cada fila.
## Ingresa inventario
1. Confirma que el producto es un artículo con stock manual y se guarda una Ubicación de stock.
2. Abre el producto y encuentra **Stock**.
3. Ingresa la cantidad disponible para cada variante relevante.
4. Revisa el valor **Inventario total en ubicación Tienda**.
5. Selecciona **Guardar**.
6. Vuelve a Productos y confirma que la columna Inventario refleja el total guardado.
## Estados y límites
- Sin una ubicación de stock guardada, Runner muestra **Inventario no guardado** y evita que el producto reclame que el stock fue almacenado.
- Los valores de opción crean combinaciones. Añadir muchos valores en varias opciones puede producir una lista de variantes grande que debe verificarse individualmente.
- Un Precio de venta debe ser menor que el Precio regular. Los productos de proveedor pueden aplicar un precio minorista mínimo adicional.
- Una moneda de producto fuera de las regiones guardadas de la tienda produce una advertencia de desajuste e impide que los precios se muestren correctamente en la tienda.
- Eliminar una opción o valor cambia las opciones del cliente. Inspecciona las variantes resultantes antes de guardar.
- Los productos de reserva y proveedor pueden gestionar la disponibilidad fuera de los campos de Inventario normales.
## Solución de problemas
- **Inventario no guardado:** Añade y guarda una Ubicación de stock en General, luego re-ingresa la cantidad de producto.
- **El número de variantes es inesperado:** Verifica valores duplicados o en blanco y revisa cada combinación de opción.
- **Un precio de venta es rechazado:** Ingresa un valor por debajo del precio regular y dentro de cualquier mínimo de proveedor.
- **Los precios no aparecen para los clientes:** Alinea la moneda del producto con un Mercado guardado, luego verifica visibilidad de producto y tienda.
- **El inventario muestra un guión en Productos:** Verifica si el artículo es un producto de reserva o envío directo; esos tipos no usan el total de inventario estándar en esta lista.
## Guías relacionadas
- [Productos](./products)
- [Envío](./shipping)
- [Importar productos](./import-products)
- [Incorporación y Configuración general](./onboarding-and-general-settings)
---
# Incorporación y configuración general
Source: https://www.runnerai.com/docs/es/guides/store-operations/onboarding-and-general-settings
Las capturas y grabaciones muestran la interfaz en inglés.
Completa la configuración guiada cuando aparezca, luego usa General para mantener precisos los detalles operativos principales de la tienda.
## Por qué y cuándo usar esta página
Usa las tarjetas de configuración la primera vez que Runner solicite detalles de la tienda, un primer producto y envío. Regresa a General siempre que cambien los detalles de tu tienda pública, regiones de venta, moneda, ubicación de stock, configuración de envío o disponibilidad de revisión.
## Disponibilidad y requisitos previos
- Abre un proyecto de Runner con un backend de tienda.
- Si el backend aún se está preparando, Runner muestra **Estamos preparando el panel de gestión de tu tienda; espera un momento.**.
- El asistente de configuración aparece solo para tiendas que no lo han completado y puede variar según Runner implementa la incorporación actualizada.
- La conexión de pago es una tarea separada en **Apps**. Terminar la configuración no habilita el pago ni publica el escaparate.
## Abre General
**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → General**
Si Runner abre primero las tarjetas de configuración, completa los detalles requeridos de la tienda y resuelve los otros hitos. Después de la configuración, la página General se convierte en el destino normal.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este detalle muestra campos de ejemplo o predeterminados. No confirma un Mercado guardado, Ubicación de Stock o configuración de envío.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Configurar** | Abre el hito de detalles de la tienda | Abre el formulario requerido de detalles de la tienda. |
| **Añadir un producto** | Inicia el hito del primer producto | Abre el flujo de configuración del producto. |
| **Omitir la configuración de productos** / **Omitir la configuración de envíos** | Difere un hito opcional | Resuelve esa tarjeta de configuración sin configurar la capacidad omitida. |
| **Configurar envíos** | Configura el hito de envío | Abre la configuración de envíos. |
| **Abrir Operaciones de la tienda** | Deja la pantalla de configuración completada | Abre la administración normal de la tienda después de que todos los hitos estén resueltos. |
| **Visible para clientes** / **Ocultar la tienda: los visitantes verán 'Próximamente'.** | Cambia la visibilidad más tarde en General | El **Guardar** a nivel de página almacena el estado visible u oculto seleccionado. |
| **Añadir** en Mercados o Ubicaciones de stock | Agrega otra fila editable | Crea una fila de región o ubicación sin guardar para que la completes. |
| Interruptor **Reseñas de productos** | Permite la funcionalidad de reseñas cuando sea compatible | Guarda esta configuración inmediatamente. Si la solicitud falla, el interruptor vuelve a su valor anterior; el **Guardar** a nivel de página no se usa para este interruptor. |
| **Guardar** | Aplica cambios en General | Se vuelve disponible después de cambios en el ámbito de la página, los valida cuando se selecciona y persiste ediciones válidas de visibilidad, identidad, mercado, ubicación y envío. |
| **Configurar** en una alerta de configuración | Resuelve un requisito previo de pago faltante | Se mueve a la sección General relevante u abre la vista de integraciones de pago en **Apps**. |
Comienza con los detalles de la tienda. **Guardar y continuar** envía los campos requeridos; **Cancelar** deja el hito sin terminar.
## Completa los tres hitos de configuración
1. Abre **Operaciones de la tienda**. Una nueva tienda muestra **Configurar datos de la tienda**, **Añade tu primer producto** y **Configuración básica de envío** en lugar del menú de administración normal.
2. En **Configurar datos de la tienda**, selecciona **Configurar**. Completa los campos de nombre de la tienda, contacto y dirección solicitados por **Completa los datos de tu tienda**, luego selecciona **Guardar y continuar**. Este hito requerido no se puede omitir.
3. En **Añade tu primer producto**, selecciona **Añadir un producto** y completa el flujo del producto. Elige **Omitir la configuración de productos** solo si planeas añadir el catálogo más tarde.
4. En **Configuración básica de envío**, selecciona **Configurar envíos** y completa los campos solicitados. Elige **Omitir la configuración de envíos** solo si configurarás la entrega más tarde.
5. Espera a que aparezca **Configuración de la tienda completada**, luego selecciona **Abrir Operaciones de la tienda**.
6. Confirma que el menú de administración normal está disponible. Si omitiste productos o envíos, sigue la guía correspondiente antes de esperar una tienda vendible.
Un enlace directo a Productos no evita una configuración incompleta. Si una tienda más antigua muestra un asistente diferente, sigue sus campos requeridos visibles y las acciones opcionales de Omitir; no busques pago o Ir en vivo dentro del flujo de tres tarjetas anterior.
La grabación abre el formulario de detalles de la tienda, luego lo cierra y regresa a las tarjetas de configuración. Muestra la entrada y los campos requeridos, no la configuración completada, publicación o una conexión de pago.
## Actualiza la configuración General más tarde
1. Abre **Operaciones de la tienda → General**.
2. Elige la visibilidad de tienda deseada.
3. Revisa el nombre de la tienda, correo electrónico de contacto y dirección comercial.
4. Revisa Mercados, incluidos países de venta, moneda y configuración de impuestos.
5. Revisa Ubicaciones de stock antes de configurar envío o inventario.
6. Revisa Envío, luego selecciona **Guardar** y espera el estado guardado para esas configuraciones de página.
7. Cierra y vuelve a abrir General para confirmar el Mercado guardado, la Ubicación de Stock y los detalles de la tienda.
8. Cambia el interruptor condicional **Reseñas de productos** por separado si es necesario, y espera a que su actualización inmediata termine.
## Estados y límites
- El nombre de la tienda es obligatorio y el formulario de configuración lo limita a 30 caracteres.
- El correo electrónico de contacto debe ser una dirección de correo electrónico válida.
- La moneda del mercado afecta la visualización del precio del producto. Un producto con una moneda fuera de las regiones guardadas muestra una advertencia y puede no mostrar precios en la tienda.
- **Visible para clientes** controla la visibilidad de la tienda. Publicar código de tienda y conectar un dominio son tareas separadas.
- Habilitar reseñas no agrega componentes de reseña faltantes a una tienda más antigua. Runner puede mostrar orientación para pedir al agente que agregue la capacidad y publique esos cambios de tienda.
- El **Guardar** a nivel de página cubre visibilidad, detalles de tienda, Mercados, Ubicaciones de stock y Envío. El interruptor **Reseñas de productos** se guarda por separado e inmediatamente.
## Solución de problemas
- **Guardar está deshabilitado:** Realiza un cambio en el ámbito de la página; cambiar solo **Reseñas de productos** no usa este botón.
- **Guardar reporta un error:** Completa los campos nombrados por el mensaje de validación, luego intenta una vez más.
- **Una alerta de configuración permanece:** Completa su requisito previo nombrado, guárdalo y luego actualiza. Stock, envío y pago se verifican por separado.
- **El pago sigue faltando después de la conexión:** Vuelve de la pestaña del proveedor, espera a que Runner muestre la integración como habilitada y actualiza si es necesario.
- **Las reseñas no aparecen en el menú:** El interruptor, soporte de backend o capacidad de tienda pueden no estar listos. Consulta la guía de reseña condicional antes de intentar una URL directa.
- **La página advierte sobre cambios sin guardar:** Quédate y guarda, o elige explícitamente salir sin guardar. La navegación del navegador sola no aplica las ediciones.
## Guías relacionadas
- [Envío](./shipping)
- [Productos](./products)
- [Reseñas](./reviews-and-advanced-admin)
- [Descripción general de Operaciones de la tienda](/es/guides/store-operations)
---
# Pedidos
Source: https://www.runnerai.com/docs/es/guides/store-operations/orders
Las capturas y grabaciones muestran la interfaz en inglés.
Usa Pedidos para seguir cada compra desde su colocación hasta el pago, cumplimiento, envío, entrega, reembolso o cancelación.
## Por qué y cuándo usar Pedidos
Abre un pedido cuando necesites confirmar qué compró el cliente, verificar direcciones y totales, entender el progreso del pago o cumplimiento, o realizar una acción siguiente disponible. Los controles visibles dependen del pedido, servicios conectados y acciones anteriores.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Los pedidos aparecen después de que los clientes los colocan. **Aún no hay pedidos** es normal para una tienda nueva.
- Los controles de pago requieren un estado de pago compatible y un proveedor conectado.
- Los controles de cumplimiento requieren artículos cumplibles y pueden depender de servicios de envío o proveedor.
- Las secciones de reserva aparecen solo en pedidos que incluyen artículos de reserva compatibles.
- El estado de dropshipping, actualización y seguimiento aparecen solo cuando el pedido tiene registros de cumplimiento de proveedor vinculados.
## Abre Pedidos
**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Pedidos**
Selecciona una fila de pedido para abrir su registro completo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw69RBMGkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Aún no hay pedidos es un estado inicial normal. Las acciones condicionales a continuación requieren un pedido real; este ejemplo no muestra un reembolso o cumplimiento.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Buscar pedidos...** | Encuentra un pedido específico | Filtra la lista usando la información de pedido o cliente ingresada. |
| **Actualizar** en la lista de pedidos | Solicita datos de pedido actuales | Recarga la lista y datos de estado de reserva o dropshipping disponibles. |
| Fila de pedido | Inspecciona una compra | Abre Resumen, cliente, dirección, artículo, pago, cumplimiento, actividad y secciones condicionales. |
| **Copiar dirección** | Reutiliza una dirección mostrada con precisión | Copia esa dirección al portapapeles. |
| **Capturar pago** | Captura un pago autorizado | Abre una confirmación; confirmar solicita al servicio conectado que lo capture. |
| **Reembolso** (diálogo: **Reembolsar pago**) | Devuelve un monto elegible | Abre campos de monto de reembolso y nota opcional; el éxito actualiza el estado de pago. |
| **Marcar como cumplido** | Cumple todos los artículos actualmente no cumplidos | Envía el cumplimiento inmediatamente y actualiza el pedido después del éxito. |
| **Marcar como enviado** | Registra el progreso del envío | Solicita información del transportista y seguimiento opcional, luego actualiza el cumplimiento después del éxito. |
| **Marcar como entregado** | Registra la finalización de la entrega | Confirma el cumplimiento elegible como entregado después del éxito. |
| **Cancelar cumplimiento** | Detiene un cumplimiento elegible | Abre una confirmación y actualiza ese cumplimiento si la solicitud tiene éxito. |
| **Cancelar pedido** | Cancela permanentemente un pedido elegible | En escritorio, abre una confirmación irreversible; todos los cumplimientos deben cancelarse primero. |
| **Actualizar estado** | Verifica un pedido de dropshipping vinculado | Solicita el estado de proveedor más reciente para ese registro. |
| **Rastrear pedido** | Abre el seguimiento de proveedor disponible | Abre el seguimiento solo cuando hay un destino de seguimiento utilizable presente. |
| Acciones de reserva | Actualiza una reserva confirmada compatible | **Marcar como completada** o **Marcar como no asistió** aparece solo para un estado de reserva elegible. |
## Revisa un pedido de forma segura
1. Busca el pedido o selecciónalo de la lista.
2. Confirma el ID de visualización, fecha, cliente, artículos, totales, dirección de envío y dirección de facturación.
3. Lee Pago y Cumplimiento como estados separados; uno puede progresar sin el otro.
4. Revisa Actividad para cambios anteriores.
5. Si hay una sección de reserva o dropshipping presente, revisa su estado y detalles separados.
6. Cuando otra persona o servicio externo puede haber cambiado el pedido, vuelve a la lista, selecciona **Actualizar** y reabre el registro antes de actuar.
Para una nueva tienda con **Aún no hay pedidos**, borra la búsqueda y selecciona **Actualizar** para confirmar la lista vacía. Puedes aprender la navegación de la lista sin crear una compra. Las acciones a continuación son condicionales a un pedido existente y sus estados de pago y cumplimiento.
## Realiza una acción que cambie el estado
1. Elige solo una acción mostrada para el estado actual. **Marcar como cumplido** se aplica inmediatamente a todos los artículos no cumplidos; otras acciones pueden abrir una confirmación o campos requeridos.
2. Cuando aparece un diálogo, verifica el pedido, cantidades de artículos, monto, transportista o información de seguimiento que muestra.
3. Envía o confirma una vez.
4. Espera el mensaje de éxito y el estado actualizado.
5. Actualiza antes de reintentar. Un tiempo de espera o indicador de carga no es prueba de que la primera solicitud falló.
## Comprende estados comunes
| Área | Estados de ejemplo | Cómo leerlos |
| --- | --- | --- |
| Pago | Esperando pago, Autorizado, Pagado, Parcialmente pagado, Reembolsado, Parcialmente reembolsado, Cancelado, Requiere acción | Describe movimiento de dinero, no progreso de envío. |
| Cumplimiento | No cumplido, Parcialmente cumplido, Cumplido, Enviado, Parcialmente enviado, Entregado, Parcialmente entregado, Cancelado | Describe preparación y entrega, no si el pago se liquidó. |
| Reserva | Confirmado, Completado, No presentado, Cancelado | Aparece solo para artículos de reserva compatibles. |
| Dropshipping | Creación pendiente, Creado, Procesando, Enviado, Entregado, Fallido, Cancelado u otros estados de proveedor | Proviene de un registro de proveedor vinculado y puede actualizarse por separado del pedido de tienda. |
## Límites y solución de problemas
- **Falta una acción:** El estado del pedido, tipo de artículo, proveedor o tu acceso actualmente no lo permite. No uses una URL directa para eludir el control faltante.
- **Cancelar pedido no está disponible:** Este control es solo para escritorio y requiere que todos los cumplimientos se cancelen primero.
- **Un reembolso de artículo no está disponible:** Usa solo el método de reembolso que Runner expone para el pedido actual; no asumas que cada artículo admite reembolso directo.
- **El estado no cambió:** Espera la confirmación, vuelve a la lista de pedidos, selecciona **Actualizar**, reabre el registro y verifica Actividad antes de reintentar.
- **Dropshipping dice Fallido o no tiene pedido:** Revisa los detalles del proveedor vinculado y la conexión antes de cambiar el pedido de tienda.
- **Pedido no encontrado:** Borra la búsqueda, verifica el proyecto y comprueba el identificador del pedido.
## Guías relacionadas
- [Clientes](./customers)
- [Envío](./shipping)
- [Dropshipping](./dropshipping)
- [Descripción general de Operaciones de la tienda](/es/guides/store-operations)
---
# Impresión bajo demanda con Printful
Source: https://www.runnerai.com/docs/es/guides/store-operations/print-on-demand
Usa Impresión bajo demanda para vender productos personalizados, como camisetas, sudaderas, tazas y pósteres, sin tener stock. Diseñas sobre un producto base de Printful en Runner, lo publicas en tu tienda y Printful imprime y envía cada pedido después de que lo confirmes en Printful.
## Cómo funciona
1. **Conectar Printful.** Autoriza tu propia cuenta de Printful una sola vez para tu organización.
2. **Elige un producto base y diséñalo.** Elige un producto, colores, tallas y técnica de impresión, y luego añade tu diseño.
3. **Revisa y publica.** Elige maquetas, redacta la ficha, establece precios, mercados y envío, y luego publica.
4. **Gestiona los pedidos.** Cada pedido pagado crea un pedido en borrador en Printful. Confirma el borrador en Printful para iniciar la producción.
Si más adelante necesitas dejar de usar Printful, consulta [Desconectar Printful](#desconectar-printful).
## Antes de empezar
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Impresión bajo demanda**
**Impresión bajo demanda** aparece en el grupo **Crear** de la navegación del proyecto, junto a **Operaciones de la tienda** y **Dropshipping**. Si no lo ves, la función aún no está habilitada para tu cuenta. Contacta con el [soporte de Runner](/es/guides/help-and-reference/support-and-community) para solicitar acceso.
Necesitas:
- un proyecto de Runner con una tienda;
- una cuenta de [Printful](https://www.printful.com) con la facturación configurada, porque Printful cobra a tu cuenta de Printful cada pedido que confirmas;
- el rol de **Administrador** o **Propietario** en la organización de Runner para conectar o desconectar Printful;
- al menos un mercado y una moneda de la tienda en **Operaciones de la tienda → General**; y
- una ubicación de stock y la configuración de envío antes de publicar. Consulta [Envío](/es/guides/store-operations/shipping).
## 1. Conecta Printful
Puedes explorar el catálogo antes de conectar. La página muestra **Modo de vista previa** hasta que Printful esté conectado. Debes conectar Printful antes de poder diseñar, guardar o publicar.
1. Abre **Impresión bajo demanda**.
2. Selecciona **Conectar Printful**. También puedes abrir un producto base y seleccionar **Conecta tu propia cuenta de Printful**.
3. Inicia sesión en Printful si te lo pide y revisa los permisos que solicita Runner.
4. En el selector de tiendas de Printful, elige la tienda que quieres que use Runner. El selector tiene seleccionada por defecto la opción **Create a new Printful store**; cámbiala si quieres usar una tienda existente.
5. Aprueba el acceso. Printful te devuelve a **Impresión bajo demanda** y la página muestra **Conectado**.
La conexión pertenece a tu **organización** de Runner, así que todas las tiendas de esa organización usan la misma tienda de Printful. Una organización puede tener una sola conexión de Printful, y una tienda de Printful solo puede estar conectada a una organización de Runner.
Para comprobar qué tienda de Printful está conectada, abre el menú **Gestionar tienda** y elige **Gestionar conexión**. El cuadro de diálogo muestra el nombre de la tienda conectada y el ID de la tienda de Printful.
### Vuelve a conectar Printful
Si Printful deja de aceptar la autorización de Runner, Runner muestra **Vuelve a conectar Printful para que los pedidos sigan avanzando**. Normalmente significa que la tienda se eliminó en Printful o que la app de Runner se desinstaló de ella. Selecciona **Volver a conectar Printful** y elige **la misma tienda de Printful** en el selector de tiendas de Printful. Runner rechaza una reconexión que elija otra tienda mientras la conexión sigue activa.
## 2. Elige un producto base y empieza a diseñar
### Elige un producto base
1. Explora **Todos los productos base**, filtra por **Tipos de producto** o busca por producto, marca, método de impresión o SKU.
2. Abre un producto para ver sus imágenes, colores disponibles, tallas, ubicaciones de impresión, técnicas, coste base, envío estimado y plazo de entrega estimado para tus mercados.
3. Elige una **Técnica**: **Impresión** o **Bordado**, cuando se ofrecen ambas. En **Impresión**, elige el **Tipo de impresión** que Printful ofrece para ese producto, como DTG, DTF, sublimación o impresión integral.
4. Elige uno o más **colores** y **tallas**. Puedes seleccionar hasta **20 variantes** (combinaciones de color y talla) para un producto.
5. Usa el control deslizante **Recargo** para previsualizar el precio de venta y la ganancia. El precio empieza en el precio sugerido, un margen del 35 % sobre el punto de equilibrio: el coste base de Printful más el envío estimado. La ganancia es el precio menos ambos y aparece cuando llega la estimación de envío. Puedes volver a cambiar los precios durante la revisión.
6. Selecciona **Empezar a diseñar**. El diseñador se abre con las opciones que elegiste.
Si Runner cambia tu selección (por ejemplo, con el mensaje "La talla cambió para coincidir con este color."), Printful no ofrece esa combinación exacta. Revisa las opciones ajustadas antes de continuar.
### Añade tu diseño
Cada ubicación de impresión, como la parte delantera, la trasera o la manga, tiene su propia pestaña en el diseñador. Añade un diseño a cada ubicación que quieras imprimir.
| Origen del diseño | Qué hace |
| --- | --- |
| **Subir un archivo** | Sube archivos JPEG, PNG, WebP o SVG de hasta 18 MB. Los archivos SVG se convierten a PNG. Se recomiendan 300 DPI. |
| **Desde la galería multimedia** | Reutiliza imágenes que ya creaste o subiste en Runner. |
| **Diseñar con Runner AI** | Describe tu idea. **Crear imagen** genera un diseño nuevo; **Editar diseño actual** cambia el diseño que ya está en el producto. |
| **Inspiración → Texto** | Elige un estilo de letra, como Bold varsity, Classic serif o Light script. Runner AI convierte tus palabras en un diseño de texto listo para imprimir. |
| **Inspiración → Etiquetas e insignias** | Elige una forma, como una insignia circular, un escudo o una etiqueta tipo ticket. Runner AI crea la insignia con tu texto. |
| **Inspiración → Arte** | Coloca directamente en tu producto una obra seleccionada y de uso libre (CC0) del Art Institute of Chicago. |
Selecciona una capa de diseño para editarla en el inspector:
- mueve, cambia el tamaño, gira y cambia la opacidad;
- **Recortar** el diseño sin cambiar la imagen original;
- **Eliminar fondo** para que solo se imprima tu diseño;
- **Repetir patrón** en un diseño de bloque, ladrillo o medio salto, con espaciado y desplazamiento ajustables;
- **Duplicar**, **Bloquear** y reordenar capas; y
- **Deshacer** y **Rehacer** cambios.
### Comprueba la calidad de impresión
Antes de guardar, revisa los indicadores de calidad de cada capa:
- **Calidad de impresión** compara la resolución del diseño a su tamaño actual con los DPI que exige Printful. Si indica que el diseño se imprimirá borroso, hazlo más pequeño o sube un archivo más nítido.
- Las advertencias de **área de impresión** y **zona segura** significan que parte del diseño puede quedar cortada o recortada. Muévelo o cambia su tamaño hasta que el diseño quede dentro de ambas.
### Guarda tu diseño
El diseñador no guarda automáticamente. Selecciona **Guardar diseño** cuando termines. El estado muestra **Cambios sin guardar** hasta que guardes. Si sales con cambios sin guardar, Runner te pregunta si quieres guardarlos o descartarlos.
Los diseños guardados aparecen en **Diseños guardados** en la página de Impresión bajo demanda. Abre uno para seguir editándolo o para convertirlo en un producto. Eliminar un diseño guardado no elimina imágenes de tu biblioteca multimedia.
## 3. Revisa y publica el producto
Cuando tu diseño esté listo, selecciona **Publicar** en el diseñador. Runner guarda el diseño y abre **Publicar producto**.
### Configura el producto
| Sección | Qué hacer |
| --- | --- |
| **Maquetas del producto** | Selecciona **Generar maquetas** para crear fotos de tu diseño sobre el producto. Selecciona al menos una maqueta y hasta ocho. Arrástralas para reordenarlas; la primera imagen es la imagen de tu ficha. |
| **Detalles** | Revisa el **Título del producto** y la **Descripción del producto** que redactó Runner. Usa **Crear con IA** para obtener una descripción nueva y luego revisa cada palabra. |
| **Mercados** | Selecciona **Elegir mercados** para elegir los países y monedas en los que vendes este producto. Solo aparecen los mercados a los que Printful puede enviar. Elige al menos un mercado. |
| **Precios** | Cada variante empieza en el precio sugerido, un margen del 35 % sobre su punto de equilibrio: el coste base de Printful más el envío que pagas tú. Usa **Recargo** para fijar otro recargo sobre el punto de equilibrio, o introduce un precio para cada variante. Las ganancias son el precio menos el coste base de Printful y el envío que pagas, y un precio por debajo del punto de equilibrio aparece como pérdida. Para cada mercado, la tabla muestra el precio de venta, el envío, los impuestos y las ganancias estimadas de la variante que menos gana. |
| **Gastos de envío para el cliente** | Elige **Usar las tarifas de envío de la tienda** para que los compradores paguen las tarifas de envío de tu tienda, o **Cobrar las tarifas de envío de Printful** para que los compradores paguen en el pago la tarifa que Printful cotiza para su dirección. |
La estimación de envío de esta página es una referencia para fijar precios: la tarifa estándar más barata de Printful, no la exprés ni la prioritaria. El coste real de envío de Printful depende de la dirección de entrega de cada cliente. Con **Usar las tarifas de envío de la tienda**, los compradores pagan las tarifas de tu tienda y Printful te cobra el envío a ti, así que la estimación cuenta para el punto de equilibrio, el precio sugerido y tus ganancias. Con **Cobrar las tarifas de envío de Printful**, los compradores pagan la tarifa de Printful al finalizar la compra, así que solo cuenta el coste base de Printful.
Printful gestiona el cumplimiento de este producto, así que se aplica la política de devoluciones de Printful. Revísala desde el enlace de la página de revisión.
### Crea el borrador
1. Selecciona **Crear producto**.
2. Espera mientras Runner prepara los archivos de producción y crea el producto. Puedes consultar el estado en cualquier momento.
3. Espera el mensaje **Tu producto ya es un borrador en tu tienda. Publícalo cuando quieras empezar a vender.** Después, selecciona **Ver producto**.
El producto ahora es un **Borrador** en **Productos**. Los compradores aún no pueden verlo. Puedes editar su URL y su ficha en buscadores en Productos.
### Publica
1. Abre el producto en borrador en **Productos**.
2. Revisa **Envío al finalizar la compra** y asegúrate de que haya un modo de envío seleccionado.
3. Selecciona **Publicar producto**.
4. Espera a ver **Sincronizado con Printful.** El producto ya está disponible en tu tienda y sincronizado con tu tienda de Printful.
Para publicar, la tienda necesita una conexión activa con Printful, una ubicación de stock, una opción de envío y un modo de envío para el producto. Si falta alguno, Runner muestra qué debes corregir antes de volver a intentarlo.
Cuando un diseño se convierte en producto, queda bloqueado para ese producto. Si vuelves a editarlo, Runner crea una copia, y guardar la copia no cambia el producto existente.
## 4. Gestiona los pedidos
Runner **no** envía los pedidos a producción automáticamente. Cada pedido pagado crea un **pedido en borrador** en tu tienda de Printful, y tú lo confirmas en Printful para iniciar la producción.
1. Un comprador paga un pedido que contiene un producto de impresión bajo demanda.
2. Runner crea un pedido en borrador equivalente en tu tienda de Printful. Esto ocurre automáticamente para los pedidos con el pago capturado.
3. Abre **Operaciones de la tienda → Pedidos** y selecciona el pedido. La sección **Gestión de Printful** muestra el estado del borrador y el coste de producción de Printful cuando Printful lo haya calculado.
4. Cuando el estado sea **Borrador listo**, selecciona **Realizar pedido en Printful**. Printful abre el pedido en una pestaña nueva.
5. Revisa el pedido en Printful y confírmalo. Printful cobra a tu cuenta de Printful e inicia la producción.
6. Vuelve al pedido en Runner y selecciona **Actualizar estado**. Runner también actualiza el estado automáticamente cuando Printful envía actualizaciones.
| Estado | Significado |
| --- | --- |
| **Preparando borrador** | Runner está creando el borrador en Printful. |
| **Borrador listo** | El borrador está en Printful y espera que lo confirmes allí. |
| **Enviado** / **En producción** | Confirmaste el pedido y Printful lo está produciendo. |
| **Parcialmente completado** / **Completado** | Printful envió algunos o todos los artículos. |
| **Acción requerida** | Printful necesita una actualización antes de poder continuar. Abre el pedido en Printful. |
| **Requiere atención** | Runner no pudo confirmar el estado de la gestión de Printful. Actualiza el estado o contacta con soporte. |
| **Cancelado** / **Eliminado** | El pedido de Printful se canceló o el borrador se eliminó. |
Ten en cuenta estas reglas:
- **Confirma solo los pedidos que quieras completar.** Confirmar en Printful inicia una producción irreversible y cobra a tu cuenta de Printful.
- **Los reembolsos y cancelaciones no cambian el borrador de Printful.** Si reembolsas o cancelas un pedido de cliente, elimina o cancela tú mismo el borrador en Printful y no lo confirmes.
- **Eliminar un borrador de Printful no cancela ni reembolsa el pedido del cliente.** Gestiona el pedido del cliente por separado en Runner.
- Si Runner muestra **Reintentar borrador**, Printful no creó el borrador y puedes reintentarlo con seguridad.
- Si Runner indica que Printful creó el pedido pero Runner no pudo leerlo de vuelta, **no lo vuelvas a enviar**. Runner lo concilia automáticamente, así que vuelve a comprobarlo más tarde.
## Desconectar Printful
Al desconectar, Runner deja de usar tu tienda de Printful de inmediato. **Termina o cierra todos los pedidos en curso antes de desconectar.** Los pedidos que no estén completos se desactivan en Runner y no se reintentan, aunque más adelante conectes otra tienda de Printful.
### Antes de desconectar
1. En **Operaciones de la tienda → Pedidos**, busca todos los pedidos con una sección **Gestión de Printful** que no esté en **Completado**, **Cancelado** o **Eliminado**.
2. Para cada pedido en **Borrador listo**, confírmalo en Printful, o bien cancela y reembolsa el pedido del cliente en Runner y elimina el borrador de Printful.
3. Espera a que los pedidos confirmados muestren **Completado**, o sigue su seguimiento directamente en Printful.
4. Despublica o elimina los productos de impresión bajo demanda que ya no quieras que vean los compradores.
### Desconecta
1. Abre **Impresión bajo demanda**.
2. Abre el menú **Gestionar tienda** y elige **Gestionar conexión**.
3. Selecciona **Desconectar**.
4. Lee el impacto y luego selecciona **Desconectar Printful**.
Después de desconectar:
- tus productos y borradores de impresión bajo demanda siguen visibles en **Productos**, pero los compradores no pueden añadirlos al carrito ni pagarlos;
- esos productos muestran **Este producto POD no está disponible** y no se pueden vender ni editar a través de Printful;
- las gestiones de Printful en curso se desactivan en Runner; y
- tu tienda de Printful y sus pedidos permanecen en tu cuenta de Printful.
**Volver a conectar no restaura los productos.** Si más adelante vuelves a conectar Printful, los productos de la conexión anterior siguen sin estar disponibles. Crea productos nuevos a partir de tus diseños guardados.
## Límites
| Elemento | Límite |
| --- | --- |
| Variantes por producto | 1–20 combinaciones de color y talla |
| Imágenes de la ficha por producto | Hasta 8 maquetas |
| Mercados por producto | Hasta 51 |
| Recargo | 0–500% |
| Título del producto | Hasta 255 caracteres |
| Tamaño del archivo subido | 18 MB (JPEG, PNG, WebP o SVG) |
| Conexiones de Printful | Una por organización |
Tu plan también puede limitar cuántos productos puedes crear. Si alcanzas el límite, Runner muestra **Has alcanzado el límite de productos de impresión bajo demanda de tu plan. Mejora tu plan para añadir más.**
## Solución de problemas
- **Impresión bajo demanda no aparece en la navegación:** la función no está habilitada para tu cuenta. Contacta con soporte.
- **Conectar Printful falla o no tienes permiso para conectar:** pide a un administrador o propietario de la organización que conecte Printful.
- **La entrega de eventos de Printful está pendiente de la configuración de Runner:** Runner debe completar una configuración única. No necesitas cambiar nada en tu tienda.
- **Una maqueta, un precio o una estimación de envío no se carga:** vuelve a intentarlo desde la misma página. Tu diseño guardado no se ve afectado.
Para ver los mensajes de error exactos y los pasos de recuperación, consulta:
- [Conexión y catálogo de Printful](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog) (en inglés)
- [Conflictos de diseño de Printful y diseños no disponibles](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork) (en inglés)
- [Revisión de productos, maquetas y publicación de Printful](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication) (en inglés)
- [Errores de pedidos y cumplimiento](/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment) (en inglés)
## Guías relacionadas
- [Operaciones de la tienda](/es/guides/store-operations)
- [Productos](/es/guides/store-operations/products)
- [Pedidos](/es/guides/store-operations/orders)
- [Envío](/es/guides/store-operations/shipping)
- [Dropshipping](/es/guides/store-operations/dropshipping)
---
# Productos
Source: https://www.runnerai.com/docs/es/guides/store-operations/products
Las capturas y grabaciones muestran la interfaz en inglés.
Usa Productos para convertir un artículo en un listado de tienda completo con información visible para el cliente, precios, medios y estado.
## Por qué y cuándo usar Productos
Crea un producto cuando quieras vender un artículo directamente, luego vuelve para ajustar su nombre, descripción, categoría, imágenes, precios, variantes, inventario, listado de búsqueda o estado Borrador/Publicado.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Abre un proyecto de Runner con un backend de tienda listo.
- Guarda al menos un Mercado para que la moneda del producto pueda coincidir con una región de venta.
- Guarda una Ubicación de stock antes de esperar que los cambios de inventario se almacenen.
- **Importar** aparece en la lista de escritorio poblada; un catálogo nuevo vacío comienza con **Agregar primer producto**.
- Los productos de dropshipping pueden mostrar comportamiento de costo e inventario diferente de los productos administrados manualmente.
## Abre Productos
**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Productos**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Las filas de borrador muestran registros de catálogo disponibles para editar. No prueban que los artículos estén publicados o sean comprables.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Actualizar** | Recarga datos del catálogo actual | Vuelve a obtener productos e información de mercado; no crea ni publica nada. |
| **Añadir** / **Agregar primer producto** | Crea un producto manual | Abre un formulario Agregar producto en blanco. |
| **Importar** | Agrega productos desde un CSV compatible | Abre el diálogo de importación con Plantilla e Historial. |
| Fila de producto | Revisa o cambia un artículo | Abre Editar producto para ese producto. |
| Icono de lápiz | Edita un producto sin seleccionar su fila | Abre el mismo formulario Editar producto. |
| Icono de eliminar | Elimina un producto | Abre una confirmación destructiva; confirmar elimina el producto y no puede asumirse reversible. |
| **Borrador** | Mantén el listado fuera del catálogo publicado | Guarda el producto con estado Borrador. |
| **Publicado** | Haz que el listado sea elegible para aparecer en el catálogo | Guarda el estado Publicado; la visibilidad real de la tienda aún depende del estado de la tienda y la tienda. |
| **Guardar** | Almacena cambios de producto válidos | Guarda el producto y vuelve a la lista actualizada después del éxito. |
| **Cancelar** o control atrás | Sal del formulario | Vuelve hacia la lista; los cambios de formulario sin guardar no se aplican. |
## Crea un producto
1. Selecciona **Añadir** o **Agregar primer producto**.
2. Elige una Categoría de producto e ingresa un Nombre y Descripción claros.
3. Agrega imágenes y elige la miniatura deseada.
4. Elige **Borrador** mientras preparas el listado o **Publicado** cuando esté listo para el catálogo.
5. Ingresa el Precio regular. Agrega un Precio de venta más bajo y fechas de inicio/fin válidas solo cuando quieras una venta programada.
6. Configura [variantes e inventario](./inventory-and-variants) si el artículo tiene opciones o stock rastreado.
7. Revisa el título de página SEO, meta descripción, identificador y URL de tienda mostrada.
8. Selecciona **Guardar** y espera hasta que la lista de Productos vuelva con la fila actualizada.
### Practica con un borrador
Para una lista manual de velas, ingresa un nombre claro como `Cedar Candle`, añade la descripción real del producto y mantén **Borrador** seleccionado. Usa un precio en la moneda del Mercado guardado de la tienda. Si Runner pide primero un tipo de producto, elige la ruta de producto manual antes de ingresar estos detalles.
Después de **Guardar**, vuelve a abrir la fila y compara su nombre, precio y estado de Borrador con tu entrada. Esto verifica el guardado del catálogo; la publicación y un pago funcional necesitan verificaciones separadas.
## Edita o elimina un producto
1. Selecciona la fila del producto o su icono de lápiz. **Editar producto** muestra el Tipo de Producto existente como de solo lectura.
2. Cambia solo los campos que deben afectar el listado.
3. Selecciona **Guardar** y confirma que la fila refleja el nuevo estado o información.
4. Para eliminar el producto, vuelve a la lista y selecciona su icono de eliminar.
5. Lee el nombre del producto en la confirmación. Continúa solo si la eliminación permanente es intencional.
## Estados y límites
- Los distintivos **Borrador** y **En vivo** en la lista resumen el estado del producto. El formulario usa **Borrador** y **Publicado**.
- Una advertencia de desajuste de moneda significa que la moneda del producto está fuera de las regiones guardadas de la tienda; sus precios no se mostrarán en la tienda hasta que se corrija.
- El Precio de venta debe ser menor que el Precio regular. Los artículos del proveedor también pueden aplicar un precio minorista mínimo.
- Las imágenes aceptan solo los formatos y tamaño mostrados por el formulario. La compresión o carga fallida deja la imagen del producto sin cambios.
- Las filas de reserva y dropshipping pueden mostrar un guión en lugar de totales de inventario o variante normales.
- Guardar el estado Publicado no es lo mismo que publicar o implementar la tienda.
## Solución de problemas
- **Inventario no guardado:** Agrega y guarda una Ubicación de stock, luego reabre el producto e ingresa stock nuevamente.
- **El precio no se muestra:** Haz que la moneda del producto coincida con una región de Mercado guardada.
- **Guardar permanece deshabilitado o falla:** Realiza un cambio, luego completa el Nombre requerido y el estado y corrige cualquier error en línea. Agrega una categoría y precio adecuados antes de esperar un listado completo visible para el cliente, pero no son requisitos previos para habilitar **Guardar**.
- **La carga de imagen falla:** Usa JPEG, PNG, GIF o WebP dentro del tamaño mostrado en la sugerencia de imagen, luego reintenta.
- **El producto falta en la tienda:** Verifica el estado Publicado, visibilidad de tienda, publicación de tienda y el mercado relevante. Una fila de administrador guardada sola no es prueba de visibilidad del cliente.
## Guías relacionadas
- [Importar productos](./import-products)
- [Inventario y variantes](./inventory-and-variants)
- [Dropshipping](./dropshipping)
- [Incorporación y configuración general](./onboarding-and-general-settings)
---
# Promociones
Source: https://www.runnerai.com/docs/es/guides/store-operations/promotions
Las capturas y grabaciones muestran la interfaz en inglés.
Usa Promociones para definir un descuento, su experiencia del cliente, sus reglas de elegibilidad y si está activo o aún es un borrador.
## Por qué y cuándo usar Promociones
Crea una promoción para una campaña planificada, incentivo del cliente, oferta de envío gratis o oferta de compra y obtén. Comienza en Borrador mientras verificas los detalles; usa Activo solo cuando el descuento debe ser elegible en el pago.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Abre un proyecto de Runner con un backend de tienda listo.
- Crea los productos referenciados por una regla Compra X Obtén Y antes de construir esa promoción.
- Confirma la moneda de mercado relevante y la configuración de envío antes de ofrecer descuentos basados en cantidad o envío gratis.
- Prueba el comportamiento del pago con un pedido de prueba apropiado antes de compartir un código públicamente.
## Abre Promociones
**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → Promociones**
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Crear** / **Agregar primera promoción** | Elige un nuevo tipo de descuento | Abre un menú para Cantidad de descuento del pedido, Porcentaje de descuento del pedido, Compra X Obtén Y o Envío gratis. La lista vacía usa **Agregar primera promoción**. |
| **Descuento fijo en el pedido** | Descuenta el total del pedido por una cantidad fija | Abre un formulario con cantidad, método, estado y configuraciones de elegibilidad. |
| **Descuento porcentual en el pedido** | Descuenta el total del pedido por un porcentaje | Abre un formulario con un valor de porcentaje y la configuración compartida. |
| **Compra X, lleva Y** | Da productos seleccionados después de una compra calificada | Abre selectores de cantidad y producto para lo que el cliente compra y obtiene. |
| **Envío gratuito** | Elimina tarifas de envío elegibles | Abre una promoción cuyo descuento se aplica al envío. |
| **Descuento automático** | Aplica la promoción sin pedir al cliente un código | El pago evalúa las reglas automáticamente, pero el formulario aún requiere un valor de código para identificar la promoción. |
| **Código de promoción** | Requiere un código ingresado por el cliente | Los clientes deben ingresar el código requerido en el pago. |
| **Activa** / **Borrador** | Controla si la promoción es utilizable | Guarda el estado operativo elegido con la promoción. |
| **Agregar condición** | Limita quién puede usar la promoción | Agrega campos de atributo del cliente, operador y valor. |
| **Guardar** | Aplica un formulario de creación o edición válido | Crea o actualiza la promoción y vuelve a la lista de promociones después del éxito. |
| Fila de promoción | Inspecciona una promoción | Abre tipo, método, estado, código, uso y acciones disponibles. |
| **Editar** | Cambia la promoción seleccionada | Abre el formulario de edición para ese tipo de promoción existente. |
| **Eliminar** | Elimina permanentemente la promoción | Desde la lista de escritorio, abre una confirmación irreversible nombrando el código de promoción. La vista móvil actual no muestra esta acción. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBOjWz1xmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este detalle muestra el estado de Borrador, código versus descuento automático, valor y elegibilidad. No se muestra el guardado y la activación.
## Crea una promoción
1. Selecciona **Crear**, o **Agregar primera promoción** cuando la lista esté vacía.
2. Elige el tipo que coincida con la oferta.
3. Elige **Descuento automático** o **Código de promoción**.
4. Ingresa el valor de código requerido. Para **Código de promoción**, ingresa el código exacto que los clientes deben usar; para **Descuento automático**, los clientes no lo ingresan.
5. Elige **Borrador** mientras preparas o **Activa** cuando debe ser elegible.
6. Ingresa el valor de Descuento, o selecciona los productos Compra y Obtén y cantidades.
7. Deja la elegibilidad como todos los clientes o selecciona **Agregar condición** y completa cada campo de condición.
8. Revisa el resumen, luego selecciona **Guardar**.
9. Vuelve a la lista y confirma el Tipo, Método, Estado, Código y valores Usados.
### Ejemplo: preparar un código del 10%
Elige **Descuento porcentual en el pedido**, **Código de promoción**, código `WELCOME10`, **Borrador**, y valor `10`. Revisa la elegibilidad antes de guardar. Si solo estás aprendiendo el formulario, sal sin guardar; un formulario no guardado no crea una promoción.
Después de guardar un borrador intencionado, vuelve a abrir su fila y verifica Código, Método y estado de Borrador. Mantenlo en Borrador hasta que hayas verificado por separado el comportamiento de pago previsto. Un descuento automático también necesita un código interno, pero los clientes no escriben ese código.
## Edita o elimina una promoción
1. Selecciona una fila de promoción.
2. Elige **Editar**, cambia los campos deseados y selecciona **Guardar**.
3. Prueba la regla actualizada antes de compartirla con los clientes.
4. Para eliminarla, vuelve a la lista de escritorio, selecciona **Eliminar** y lee el código en la confirmación.
5. Continúa solo si la eliminación permanente es intencional.
## Estados y límites
- **Borrador** se almacena pero no está destinado a ser utilizable en el pago.
- **Activa** es elegible para aplicar cuando su método y condiciones coinciden.
- **Inactivo** puede aparecer en la lista cuando una promoción existente no está actualmente activa.
- Un valor de porcentaje debe estar entre 1 y 100.
- El formulario requiere un valor de código para ambos métodos. Los clientes lo ingresan solo cuando se selecciona **Código de promoción**.
- Compra X Obtén Y requiere tanto el producto calificado como el producto gratuito.
- Cada condición agregada necesita un atributo, operador y valor.
- Con un descuento automático, el pago decide si sus reglas coinciden; el cliente no ingresa el valor de código del formulario.
## Solución de problemas
- **Guardar está deshabilitado o muestra un error:** Completa el valor, código, producto, cantidad o campos de condición nombrados por el formulario.
- **Un código no funciona en el pago:** Confirma ortografía exacta, estado Activo, elegibilidad del cliente, requisitos de producto, mercado y el pago actual.
- **Un descuento automático no se aplica:** Verifica que el pedido cumpla con cada condición y que otra promoción no esté cambiando el resultado esperado.
- **Una promoción de envío gratis no tiene efecto visible:** Confirma que el pedido tiene una opción de envío guardada elegible y que la promoción está Activa.
- **La lista de promociones no se carga:** Actualiza la página y confirma el proyecto correcto antes de intentar crear un duplicado.
## Guías relacionadas
- [Productos](./products)
- [Clientes](./customers)
- [Envío](./shipping)
- [Pedidos](./orders)
---
# Reseñas
Source: https://www.runnerai.com/docs/es/guides/store-operations/reviews-and-advanced-admin
Las capturas y grabaciones muestran la interfaz en inglés.
Usa Reseñas para moderar comentarios de clientes cuando la capacidad está habilitada.
## Por qué y cuándo usar Reseñas
Habilita Reseñas cuando tu tienda esté lista para recopilar comentarios de productos y alguien los moderará.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
### Reseñas
- Abre **Operaciones de la tienda → General** y busca **Reseñas de productos**.
- La entrada de Reseñas y sus controles disponibles dependen del soporte de la tienda y el diseño actual. Si falta o está bloqueada, inspecciona Reseñas de productos en General en lugar de forzar una ruta directa.
- Una tienda más antigua puede carecer de componentes de reseña incluso después de que el interruptor esté habilitado. Cuando Runner muestra la sugerencia de capacidad, pide al agente que agregue la capacidad de reseña de productos y publique los cambios resultantes de la tienda.
- Las reseñas aparecen solo después de que los clientes las envíen a través de una tienda compatible.
## Rutas de entrada
**Ruta de entrada de Reseñas:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → General → Reseñas de productos**, activa el interruptor, luego selecciona **Operaciones de la tienda → Reseñas** cuando ese elemento de menú aparezca.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglTicdyefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El recorte anotado destaca los filtros de moderación. Abre General para gestionar la configuración de recopilación; no se aprobó ninguna reseña en este ejemplo.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| Interruptor **Reseñas de productos** | Solicita la recopilación de reseñas para la tienda | Guarda la configuración inmediatamente. Si la solicitud falla, el interruptor vuelve a su valor anterior; no se necesita un **Guardar** a nivel de página para este interruptor. |
| **Todo** | Revisa cada estado de moderación cargado | Borra el filtro de estado. |
| **Aprobado** | Revisa envíos aceptados | Filtra la lista a Aprobadas. |
| **Rechazado** | Revisa envíos rechazados | Filtra la lista a Rechazadas. |
| **Pendiente** | Encuentra reseñas que esperan una decisión | Filtra la lista a Pendientes. |
| Casilla de verificación de fila | Selecciona reseñas para una decisión en lote | Agrega o quita esa reseña de la selección actual. |
| **Aprobar** | Acepta una reseña | Actualiza su estado a Aprobada después del éxito. |
| **Rechazar** | Rechaza una reseña | Actualiza su estado a Rechazada después del éxito. |
| **Aprobar seleccionadas** | Acepta todas las reseñas marcadas | Aplica Aprobada a la selección actual después del éxito. |
| **Rechazar seleccionadas** | Rechaza todas las reseñas marcadas | Aplica Rechazada a la selección actual después del éxito. |
## Habilitar reseñas y moderar envíos existentes
1. Abre **Operaciones de la tienda → General**.
2. Activa **Reseñas de productos**.
3. Espera a que la configuración termine de guardarse. Si el interruptor vuelve a apagarse, la solicitud falló; reinténtalo después de verificar la preparación de la tienda.
4. Si Runner dice que la tienda carece de componentes de reseña, pide al agente de Runner que agregue la capacidad de reseña de productos, revisa el cambio de la tienda y publícalo.
5. Vuelve a Operaciones de la tienda y abre **Reseñas** después de que el menú aparezca.
6. Selecciona **Pendiente**.
7. Lee el producto, revisor, calificación, contenido y fecha de cada envío.
8. Selecciona **Aprobar** o **Rechazar**, o marca varias filas y usa la acción seleccionada correspondiente.
9. Espera el mensaje de éxito y verifica la columna Estado.
## Estados y límites
- **Pendiente** necesita una decisión de moderación; **Aprobado** y **Rechazado** registran la decisión actual.
- **Aún no hay reseñas** es válido hasta que existan envíos de clientes compatibles.
- Activar la configuración no fabrica reseñas ni prueba que la tienda contenga un formulario de reseña.
## Solución de problemas
- **El menú Reseñas falta:** Confirma el interruptor en General, la preparación del backend y la sugerencia de capacidad de la tienda. Actualiza después de que la configuración se confirme.
- **Los clientes no pueden dejar reseñas:** Verifica que la tienda incluya los componentes de reseña y que esos cambios de tienda se hayan publicado.
- **Una acción de moderación falla:** Mantén la reseña seleccionada, actualiza una vez y reinténtalo solo después de verificar su estado actual.
## Guías relacionadas
- [Incorporación y configuración general](./onboarding-and-general-settings)
- [Productos](./products)
- [Pedidos](./orders)
- [Descripción general de Operaciones de la tienda](/es/guides/store-operations)
---
# Envío
Source: https://www.runnerai.com/docs/es/guides/store-operations/shipping
Las capturas y grabaciones muestran la interfaz en inglés.
Configura desde dónde se envían los pedidos, dónde los clientes pueden recibirlos y cómo el checkout calcula los cargos de envío.
## Por qué y cuándo usar la configuración de envío
Configura el envío antes de probar el checkout o poner un producto físico a disposición de los clientes. Vuelve cuando agregues una ubicación de cumplimiento, vendas a un nuevo país o cambies la cantidad que los clientes pagan por la entrega.
## Disponibilidad y requisitos previos
Si aparecen tarjetas de configuración en lugar del menú de administración, [completa la configuración de la tienda](/es/guides/store-operations/onboarding-and-general-settings) primero, luego selecciona **Abrir Operaciones de la tienda**.
- Crea y guarda primero una Ubicación de stock.
- Mantén al menos una región de Mercado guardada. Cuando existe una región predeterminada, Runner puede agregar un destino de envío recién seleccionado a ella cuando guardes; sin una región predeterminada, guardar falla.
- Las opciones de envío mostradas aquí son reglas de tienda. Los servicios específicos de transportista o aplicación pueden requerir una conexión separada en **Apps**.
- Los flujos de productos digitales, reserva, proveedor u otros especiales pueden seguir reglas de cumplimiento diferentes.
## Abre Envío
**Ruta de entrada:** **Espacio de trabajo → elige una tienda → Operaciones de la tienda → General → Envío**
Si Runner muestra una alerta de configuración de envío, selecciona **Configurar**. Te lleva a la sección Envío en General. El envío no es un elemento permanente en la barra lateral de Operaciones de la tienda.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Usa el Mercado y la Ubicación de Stock guardados antes de agregar una opción de envío. Esta vista de campo de ejemplo no muestra un guardado completo o tarifa de pago.
## Controles principales
| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Añadir** | Crea una opción de envío | Agrega una fila **Envío gratuito** sin guardar con un destino **Enviar a** vacío y un costo de envío gratuito. |
| **Nombre** | Dale a los clientes una opción de entrega reconocible | Establece la etiqueta utilizada para la opción de envío. |
| **Enviar a** | Elige el país de destino del cliente | Limita la opción a ese destino. |
| **Costo de envío** | Define cómo el checkout calcula el cargo | Abre el diálogo Envío para **Tarifa fija** o **Tarifa por precio**. |
| **Tarifa fija** | Cobra una cantidad | Muestra un único campo de precio de envío. |
| **Tarifa por precio** | Varía el envío por el total de artículos del carrito | Muestra filas de precio mínimo, máximo y de envío. |
| **Añadir** en el diálogo de tarifa | Agrega otra banda de precio | Agrega un rango de total de carrito sin guardar. |
| **Guardar** en el diálogo de tarifa | Acepta el borrador de tarifa | Cierra el diálogo y devuelve la tarifa configurada a la página General. |
| **Cancelar** en el diálogo de tarifa | Descarta ediciones del diálogo | Cierra el diálogo sin aplicar esas ediciones de tarifa. |
| **Guardar** en General | Persiste la opción de envío | Guarda el envío completado y los cambios generales relacionados en la tienda. |
## Agrega una opción de tarifa plana o gratuita
1. En General, confirma que una región de Mercado y una Ubicación de stock estén guardadas.
2. Desplázate a Envío y selecciona **Añadir**.
3. Ingresa un Nombre claro, como la velocidad de entrega o el método que los clientes reconocerán.
4. Elige **Enviar a**. Las opciones de envío usan la Ubicación de stock guardada en General; no hay un selector **Enviar desde** separado en cada fila.
5. Abre **Costo de envío**.
6. Elige **Tarifa fija** e ingresa un precio de envío. Ingresa `0` cuando la entrega debe mostrarse como **Free**.
7. Selecciona **Guardar** en el diálogo.
8. Selecciona el **Guardar** a nivel de página y espera el estado guardado.
**Ejemplo:** nombra una opción `Standard shipping`, elige un destino en tu Mercado guardado y establece **Tarifa fija** en `0` para entrega gratuita. Selecciona el diálogo **Guardar**, luego General **Guardar**. Reabre General y verifica el destino y la tarifa guardada. El primer Guardar solo cierra el editor de tarifas; no persiste la configuración de envío. El servicio de transporte y el monto mostrado en el pago requieren una verificación separada.
## Agrega tarifas basadas en precio
1. Abre **Costo de envío** para la opción prevista.
2. Elige **Tarifa por precio**.
3. Ingresa un total mínimo o máximo de artículos del carrito y el precio de envío para ese rango.
4. Selecciona **Añadir** para cada rango adicional.
5. Asegúrate de que los rangos no se superpongan y que cada fila tenga un precio de envío.
6. Selecciona **Guardar** en el diálogo, luego **Guardar** en General.
## Estados y límites
- Cada rango de precio necesita al menos un total mínimo o máximo de artículos del carrito.
- Los rangos de precio superpuestos se rechazan.
- Se requiere un precio de envío para métodos planos y basados en precio.
- Un destino sin una región guardada muestra **Todavía no vendes a este país: añádelo primero en «Mercados».**.
- Cuando existe una región de Mercado predeterminada, guardar puede agregar automáticamente el país de destino seleccionado a esa región.
- El **Guardar** del diálogo prepara la opción en la página; usa el **Guardar** de la página General para persistir el cambio de configuración completo.
## Solución de problemas
- **Por favor, agrega primero una ubicación de stock:** Agrega y guarda una en General, luego vuelve a Envío.
- **No hay región predeterminada disponible:** Crea y guarda una región de Mercado, luego reinténtalo en el **Guardar** de la página General.
- **Por favor, guarda primero la ubicación de stock:** Usa el **Guardar** de la página General, luego reabre la fila de envío.
- **Rangos de precio superpuestos detectados:** Ajusta los valores mínimo y máximo para que cada total de carrito coincida con solo una fila.
- **El envío falta en el checkout:** Confirma que el destino coincida con un mercado guardado, la fila de envío esté guardada, el producto requiera envío y cualquier servicio conectado esté listo.
## Guías relacionadas
- [Incorporación y configuración general](./onboarding-and-general-settings)
- [Inventario y variantes](./inventory-and-variants)
- [Pedidos](./orders)
- [Descripción general de Operaciones de la tienda](/es/guides/store-operations)
---
# Tienda y publicación
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing
Las capturas y grabaciones muestran la interfaz en inglés.
Usa esta sección para mover una tienda desde una vista previa en la aplicación a una tienda en vivo verificada. Cada página cubre una tarea y explica qué hace cada control importante.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Comienza revisando la vista previa actual, luego sigue la guía para el cambio o paso de lanzamiento que necesites.
## Qué cubre esta guía
Elige la guía que coincida con tu tarea actual de tienda, sin confundir una vista previa editable con una tienda en vivo y comprable.
## Comprende los cuatro estados de la tienda
| Estado | Qué significa | Qué no prueba |
| --- | --- | --- |
| **Vista previa** | Runner está mostrando una copia de trabajo dentro de tu proyecto. Puedes revisar páginas y diseños. | La tienda no es necesariamente pública. |
| **Publicar** | Runner verifica y envía la versión actual a una URL de tienda pública por primera vez. | Los productos, stock, envío, pagos y checkout no se verifican automáticamente. |
| **Publicar cambios** | Una tienda en vivo ya existe y Runner puede enviar cambios más nuevos a ella. | Los cambios no guardados o incompletos aún no están en vivo. |
| **Republicar** | Runner puede reintentar después de una publicación fallida o una publicación completada que no devolvió una URL utilizable. | No es la etiqueta normal para publicar nuevos cambios en una tienda en vivo saludable. |
## Elige una tarea
| Qué quieres hacer | Guía | Resultado |
| --- | --- | --- |
| Revisa la tienda actual | [Vista previa de tu tienda](/es/guides/storefront-and-publishing/preview-your-store) | Verifica páginas, rutas, comportamiento de actualización y diseños responsivos. |
| Realiza cambios visuales | [Usa modo de diseño](/es/guides/storefront-and-publishing/design-mode) | Selecciona un elemento y abre los controles de edición. |
| Cambia texto, espaciado, tipo o imágenes | [Editar contenido, páginas y medios](/es/guides/storefront-and-publishing/edit-content-pages-and-media) | Actualiza una página visible y guarda el resultado. |
| Inspecciona o cambia un archivo de tienda | [Inspecciona y edita el código de la tienda](/es/guides/storefront-and-publishing/inspect-and-edit-code) | Abre el editor de código condicional, guarda un cambio de archivo enfocado y revisa su estado de Git. |
| Compara o recupera un estado anterior | [Usar el historial de versiones](/es/guides/storefront-and-publishing/version-history) | Obtén una vista previa de una versión o restáurala como una nueva versión actual. |
| Verifica si la tienda está lista | [Prepararse para publicar](/es/guides/storefront-and-publishing/prepare-to-publish) | Resuelve o reconoce explícitamente las verificaciones mostradas por Runner. |
| Pon los cambios en línea | [Publicar y republicar](/es/guides/storefront-and-publishing/publish-and-republish) | Inicia el flujo de publicación correcto para el estado actual. |
| Prueba que el viaje del cliente funciona | [Verifica la tienda en vivo y el checkout](/es/guides/storefront-and-publishing/live-store-and-checkout) | Confirma el catálogo público, carrito y checkout por separado. |
| Usa tu propia dirección web | [Conecta un dominio personalizado](/es/guides/storefront-and-publishing/custom-domains) | Añade, compra, transfiere, renueva o diagnostica un dominio elegible. |
| Recupérate de un estado bloqueado | [Solucionar problemas de vista previa y publicación](/es/guides/storefront-and-publishing/troubleshoot-preview-and-publishing) | Relaciona el mensaje en pantalla con la siguiente acción más segura. |
## Orden recomendado para un primer lanzamiento
1. Revisa la última versión en [Vista previa](/es/guides/storefront-and-publishing/preview-your-store).
2. Realiza y guarda cualquier edición visual en [Modo de diseño](/es/guides/storefront-and-publishing/design-mode).
3. Verifica los [requisitos previos de publicación](/es/guides/storefront-and-publishing/prepare-to-publish).
4. Selecciona **Publicar** y sigue el flujo de confirmación.
5. Abre la URL pública y [verifica el catálogo y checkout](/es/guides/storefront-and-publishing/live-store-and-checkout).
6. Añade un [dominio personalizado](/es/guides/storefront-and-publishing/custom-domains) solo después de la primera publicación exitosa.
## Disponibilidad y seguridad
- **Modo Diseño** es condicional. Está diseñado para una versión lista más reciente en un diseño de escritorio y puede no estar disponible mientras Runner está trabajando.
- **Abrir editor de código** es condicional. Guardar, confirmar, enviar, publicar y verificar la tienda en vivo son resultados separados.
- La publicación puede estar limitada por plan o estado de tienda. Sigue el mensaje mostrado en tu workspace en lugar de asumir que cada cuenta tiene el mismo acceso.
- Una confirmación de publicación puede permitirte reconocer una configuración incompleta. Esa opción puede poner una tienda navegable en línea mientras el checkout permanece pausado o incompleto.
## Guías relacionadas
- [Te damos la bienvenida a Runner AI](/es/guides/product-guide)
- [Inspecciona y edita el código de la tienda](/es/guides/storefront-and-publishing/inspect-and-edit-code)
- [Solucionar problemas de vista previa y publicación](/es/guides/storefront-and-publishing/troubleshoot-preview-and-publishing)
---
# Conecta un dominio personalizado
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/custom-domains
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Barra lateral **Configuración** → **Tienda: _nombre de la tienda_** → **Dominio**. En el escritorio, el menú del sitio publicado **Tienda online** también puede ofrecer **Configuración del dominio**.
## Qué cubre esta guía
Abre Configuración de dominio para una tienda publicada, elige el flujo de trabajo de dominio correcto y comprende qué cambia cada acción de alto impacto antes de continuar.
## Por qué y cuándo usar un dominio personalizado
Un dominio personalizado le da a los clientes una dirección de marca para la tienda publicada. Conecta uno después de la primera publicación exitosa y después de que la tienda funcione en su URL pública existente. Esto aísla los problemas de dominio de los problemas de tienda, catálogo y checkout.
## Disponibilidad y requisitos previos
- El acceso a **Dominio personalizado** depende del plan.
- La tienda debe tener una publicación exitosa antes de que los controles de dominio estén disponibles.
- Necesitas acceso a la configuración del proyecto.
- Agregar un dominio que ya posees requiere permiso para cambiar sus registros DNS en tu proveedor de DNS.
- Comprar o renovar un dominio inicia un flujo de pago externo.
- Transferir un dominio entre tiendas en el mismo espacio de trabajo se limita a propietarios y administradores del espacio de trabajo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgj47Uwq6IQ3D84warl6z9RO5sLdoxCUgTn1v2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una tienda no publicada muestra este requisito previo. Publica y verifica su URL pública antes de seguir los pasos de conexión DNS a continuación.
## Abre Configuración de dominio
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Después de publicar, abre el menú desplegable junto a **Publicar cambios**: 1. Menú del sitio publicado. 2. **Ver sitio** abre la tienda en vivo; **Copiar URL** copia su dirección. 3. **Configuración de dominio** abre la gestión de direcciones. Esta imagen no verifica el proceso de pago. Selecciona la imagen para ampliarla. Las anotaciones usan la interfaz de escritorio en inglés.
1. Confirma el nombre actual de la tienda.
2. Abre la **Configuración** de la barra lateral.
3. Bajo **Tienda: _nombre de la tienda_**, selecciona **Dominio**.
4. Si la página te pide publicar primero, completa y verifica la primera publicación antes de agregar un dominio.
## Controles de dominio
| Control | Por qué lo usas | Qué sucede cuando lo seleccionas |
| --- | --- | --- |
| **¿Cómo conectar dominio personalizado?** | Abre la ayuda de conexión actual. | La página de ayuda se abre en una nueva pestaña. |
| Escribe tu dominio + **Continuar** | Adjunta un dominio que ya posees. | Runner valida y adjunta la dirección, luego verifica el proveedor de DNS. **Dominio agregado exitosamente** confirma solo la adjunción; DNS y propiedad se verifican por separado. El control no está disponible antes de la primera publicación exitosa. |
| **Continuar a Cloudflare** | Permite que Runner agregue los registros requeridos para un dominio compatible administrado por Cloudflare. | Runner abre la página de autorización de Cloudflare. Elige la cuenta que contiene el dominio y autoriza el acceso DNS de Runner. Al volver, Runner escribe los registros exactos requeridos e inicia una nueva comprobación de conexión. Esta opción solo aparece cuando la configuración automática está disponible. |
| **Usar registros manuales** | Cambia de un flujo automático ofrecido a la configuración manual de DNS. | Selecciona esta opción para mostrar los registros exactos de **Tipo / Host / Valor**. Si la configuración automática no está disponible, Runner muestra esos registros directamente. Agrega todos los registros mostrados en tu proveedor de DNS y luego vuelve a Runner. |
| **He añadido los registros** | Comprueba el DNS de inmediato después de guardar los registros manuales. | Runner comprueba automáticamente; al seleccionar este botón, omites la espera inicial y compruebas de inmediato tanto los registros de enrutamiento como cualquier desafío de propiedad. Una autorización exitosa del proveedor por sí sola no marca el dominio como conectado. |
| Icono de borrar en el campo de dominio | Elimina el valor escrito. | La entrada se borra; ningún dominio se cambia. |
| búsqueda **Comprar un dominio** + **Buscar** | Encuentra dominios ofrecidos para compra. | Runner enumera los resultados disponibles o explica que el dominio solicitado no está disponible. |
| **Comprar** | Comienza a comprar un dominio disponible seleccionado. | Runner abre **Información de contacto** con el dominio y precio mostrados. Aún no ocurre ninguna compra. |
| **Proceder al pago** | Continúa una compra o renovación de dominio. | Runner redirige a un checkout externo. Esto puede crear un cargo si lo completas. Revisa los detalles mostrados primero. |
| **Transferir un dominio** / **Elige un dominio para transferir** | Mueve un dominio elegible de otra tienda en el mismo espacio de trabajo. | Seleccionar un dominio abre una confirmación que nombra las tiendas de origen y destino. Confirmar inicia la transferencia; la tienda de origen pierde ese dominio. |
| Dirección de dominio bajo **Tus dominios** | Abre el sitio en esa dirección. | El dominio se abre en una nueva pestaña del navegador. |
| Copiar junto a **Host** o **Valor** | Usa el registro DNS exacto que Runner recomienda. | El **Host** o **Valor** seleccionado se copia para usar en tu proveedor de DNS. Ingresa el **Tipo** mostrado por separado. |
| Eliminar dominio | Desadjunta un dominio personalizado. | Runner abre **Eliminar dominio**. Seleccionar **Eliminar** confirma un cambio que el diálogo describe como irreversible. |
| **Renovar** | Extiende un dominio comprado elegible que se muestra cerca del vencimiento. | Runner abre opciones de renovación y un total antes de **Proceder al pago**. |
| **Reintentar** en una transferencia fallida | Inicia otro intento de transferencia. | Runner inicia un intento nuevo para el mismo dominio seleccionado. |
| **Cerrar** en una transferencia fallida | Deja el diálogo de transferencia fallida. | El diálogo se cierra sin iniciar el reintento. |
| Cerrar o X durante **Transferencia en progreso** | Descarta el diálogo de progreso | La transferencia del lado del servidor continúa; cerrar el diálogo no la cancela. Vuelve más tarde para inspeccionar el estado y no inicies otra transferencia. |
## Conecta un dominio que ya posees
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Este ejemplo muestra que la tienda está publicada y los controles de dominio están desbloqueados. 1. Introduce un dominio que posees. 2. Selecciona **Continuar**. 3. Si lo deseas, busca en **Comprar un dominio**. 4. Abre la dirección publicada en **Tus dominios**. **Transferir un dominio** es una opción separada. La dirección está oculta; no se añadió ningún dominio. Selecciona la imagen para ampliarla. Las anotaciones usan la interfaz de escritorio en inglés.
1. Confirma que la tienda funciona en su URL publicada actual.
2. Abre **Configuración de dominio**.
3. Ingresa el dominio completo que controlas y selecciona **Continuar**.
4. **Dominio agregado exitosamente** significa que Runner aceptó y adjuntó la dirección. No confirma que el DNS esté configurado o que el sitio esté en vivo.
5. Elige un método de configuración:
- Si Runner detecta una configuración compatible de Cloudflare, selecciona **Continuar a Cloudflare**, elige la cuenta de Cloudflare que contiene el dominio y autoriza el acceso DNS de Runner. Al volver, Runner escribe los registros exactos que aparecen en Configuración de dominio.
- Si se ofrece un flujo automático y prefieres la configuración manual, selecciona **Usar registros manuales**. Si la configuración automática no está disponible, los registros ya aparecen en pantalla. Agrega todos los registros mostrados de **Tipo / Host / Valor** en tu proveedor de DNS.
6. Después de guardar los registros manuales, selecciona **He añadido los registros** para omitir la espera inicial y comprobar de inmediato. Runner también comprueba automáticamente mientras la conexión está pendiente y cuando regresas de Cloudflare.
7. Espera el estado conectado. Runner requiere que pasen tanto los registros de enrutamiento como la verificación de propiedad del dominio; completar la autorización de Cloudflare por sí sola no demuestra que exista conexión.
8. Abre el dominio desde **Tus dominios**, luego vuelve a verificar la tienda pública, el producto, el carrito y el checkout en la dirección personalizada.
## Compra, transfiere, renueva o elimina con cuidado
- **Comprar:** Busca, selecciona **Comprar**, revisa el dominio y el precio actual, ingresa información de contacto precisa, luego continúa al pago solo cuando tengas la intención de comprarlo.
- **Transferir:** Lee el origen y destino nombrados. La confirmación dice que la tienda de origen pierde el dominio y que la reversión inmediata no está disponible. No confirmes mientras esa tienda de origen aún necesite la dirección. Cerrar el diálogo de progreso no cancela una transferencia activa.
- **Renovar:** Revisa el período de renovación y el total antes de continuar al pago.
- **Eliminar:** Asegúrate de que exista otro dominio funcional y registra la configuración actual antes de seleccionar **Eliminar**. La confirmación advierte que la eliminación no se puede deshacer.
## Estados, límites y solución de problemas
| Lo que ves | Significado | Qué hacer |
| --- | --- | --- |
| **Por favor, publica primero** | El proyecto aún no tiene una publicación exitosa. | Publica y verifica la URL pública existente antes de agregar un dominio personalizado. |
| **No se encontraron dominios** | Actualmente no hay dominio adjunto. | Agrega un dominio que poseas o busca uno para comprar. |
| **Por favor, ingresa un dominio válido** | Runner rechazó el formato de dirección. | Corrige la dirección e inténtalo de nuevo. |
| **El dominio ya está adjunto a otra tienda** | Otra tienda en este espacio de trabajo lo usa. | Un propietario o administrador puede seleccionar **¿Transferirlo en su lugar?**; otros miembros deben contactar a un administrador. |
| **Dominio agregado exitosamente** | Runner aceptó y adjuntó la dirección. La configuración de DNS se verifica por separado. | Lee la fila del dominio antes de tratar la dirección como lista. |
| No se muestra **Continuar a Cloudflare** | La configuración automática no está disponible actualmente para este dominio o el servicio de conexión de Cloudflare no está listo. | Usa los registros DNS manuales que se muestran en la fila del dominio. No esperes a que aparezca una opción automática. |
| Registros DNS manuales y **He añadido los registros** | El dominio propio está adjunto, pero aún no ha pasado el enrutamiento o la verificación de propiedad. | Agrega exactamente todos los registros mostrados, espera la propagación de DNS y selecciona **He añadido los registros** para comprobar de inmediato. Runner continúa comprobando automáticamente. |
| Estado de comprobación o verificación después de volver de Cloudflare | Runner está leyendo el estado real del DNS y de la propiedad. | Mantén la página abierta o vuelve más tarde. Si no se conecta, usa los registros manuales y vuelve a comprobar. |
| Marca azul y desaparecen los controles DNS del dominio | Han pasado tanto la configuración DNS actual como la verificación de propiedad. | Abre el dominio y verifica todo el recorrido del cliente; la marca por sí sola no demuestra que la tienda o el checkout funcionen. |
| Indicador de carga con **Configurando dominio — disponible en unos minutos** | Un dominio comprado mediante Runner todavía se está configurando. | No apliques a este estado las instrucciones DNS manuales para dominios propios. Vuelve más tarde; no se garantiza un tiempo de finalización fijo. |
| **Transferencia en progreso** | Un movimiento de dominio del espacio de trabajo ha comenzado. | Evita iniciar otro movimiento para el mismo dominio. Cerrar el diálogo solo lo descarta; la transferencia continúa en el servidor. Vuelve más tarde para inspeccionar el resultado. |
| Transferencia fallida | El movimiento no se completó. | Lee el error, luego selecciona **Reintentar** o **Cerrar**. Confirma qué tienda aún tiene el dominio antes de otra acción. |
| Compra o renovación fallida | El pago externo no se completó. | Sigue el estado mostrado por Runner y confirma cualquier estado de reembolso antes de intentar otro pago. |
## Guías relacionadas
- [Publica y republica](./publish-and-republish)
- [Verifica la tienda en vivo y el checkout](./live-store-and-checkout)
- [Soluciona problemas de vista previa y publicación](./troubleshoot-preview-and-publishing)
---
# Usa modo de diseño
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/design-mode
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Tienda online** → **Modo Diseño**
## Qué cubre esta guía
Abre Modo de diseño en la última versión de la tienda, selecciona un elemento visible, realiza un cambio controlado y guárdalo como parte del proyecto actual.
## Por qué y cuándo usar Modo de diseño
Usa Modo de diseño para cambios visuales enfocados que son más fáciles de señalar que describir desde cero: reescribe un encabezado, reemplaza una imagen, ajusta el espaciado, cambia la tipografía o elimina un elemento visible.
Usa el chat de Runner para trabajo más amplio que abarque varias páginas, cambie el comportamiento de la tienda o requiera nueva funcionalidad.
## Disponibilidad y requisitos previos
Modo de diseño es condicional. Está disponible cuando:
- usas un diseño de escritorio;
- la última versión de la tienda está lista y seleccionada;
- no estás viendo una versión anterior;
- Runner no está procesando actualmente otra solicitud; y
- la función Modo de diseño está habilitada para el espacio de trabajo.
Si la vista previa aún se está preparando, se selecciona una versión histórica o Runner está trabajando, el botón puede estar oculto o deshabilitado.
## Abre Modo de diseño
1. Abre tu proyecto.
2. Selecciona **Tienda online**.
3. Asegúrate de que la etiqueta de versión diga **Actual** y que la vista previa esté lista.
4. Selecciona **Modo Diseño** en la barra de herramientas de la tienda.
5. Si aparece una barra de edición en la parte inferior con otro control **Modo Diseño**, selecciónalo para habilitar la selección de elementos.
6. Muévete sobre la tienda y selecciona el elemento que deseas cambiar.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El Modo de Diseño está abierto, pero aún no se ha seleccionado ningún elemento. Selecciona el elemento que deseas cambiar para revelar sus controles disponibles; la captura de pantalla no muestra una edición o guardado.
## Controles de Modo de diseño
| Control | Por qué lo usas | Qué sucede cuando lo seleccionas |
| --- | --- | --- |
| **Modo Diseño** en la barra de herramientas de la tienda | Entra en la vista de edición dedicada. | Runner abre la tienda actual en el panel de diseño. |
| **Modo Diseño** en la barra inferior | Activa o desactiva la inspección de elementos. | Cuando está activado, los elementos seleccionables se delinean y seleccionar uno abre su barra de edición. Desactivarlo borra la sesión de edición actual. |
| Campo **Pregúntale a Runner** y flecha de envío | Describe un cambio para el elemento seleccionado. | Runner recibe la instrucción con el elemento seleccionado. Cuando Runner comienza, borra la selección y reinicia las ediciones directas sin guardar y su historial de deshacer/rehacer, así que guarda cualquier edición directa pendiente antes de enviar. |
| **Espaciado** | Cambia el espacio dentro o alrededor del elemento. | Se abre un panel para margen y relleno horizontal y vertical. |
| **Imagen** | Reemplaza una imagen seleccionada o imagen de fondo. | Se abre un panel con opciones **Subir** e **Generado por IA** cuando ese elemento admite edición de medios. |
| **Texto** | Cambia el estilo de tipo. | Se abre un panel para tamaño de fuente, peso, familia, color, opacidad y alineación cuando sea compatible. |
| **Eliminar elemento** | Elimina el elemento seleccionado de la edición actual. | El elemento desaparece inmediatamente en el editor. Usa **Deshacer** si fue accidental y revisa antes de guardar. |
| **Deshacer** | Revierte la última edición visual sin guardar. | Runner retrocede a través del historial de edición de Modo de diseño actual. |
| **Rehacer** | Reaplicar una edición que acabas de deshacer. | Runner avanza a través del historial de edición de Modo de diseño actual. |
| **Guardar** | Mantén las ediciones visuales actuales. | Runner escribe los cambios pendientes, registra una nueva instantánea de versión cuando es posible, borra el historial de deshacer/rehacer de esta sesión y recarga la vista previa. El botón está deshabilitado cuando no hay nada que guardar. |
| **Cerrar** | Deja el panel de diseño dedicado. | Runner vuelve a la vista previa normal de la tienda y borra ediciones sin guardar e historial de comandos. Guarda primero si deseas mantener los cambios. |
## Realiza un cambio visual seguro
1. Navega a la página de destino en Vista previa normal antes de abrir Modo de diseño.
2. Entra en Modo de diseño y selecciona un elemento.
3. Elige una ruta para este cambio:
- Para una edición directa, usa **Espaciado**, **Imagen**, **Texto** o **Eliminar elemento**, luego revísalo con **Deshacer** o **Rehacer** y selecciona **Guardar**.
- Para una solicitud de IA, guarda primero cualquier edición directa pendiente, reselecciona el elemento si es necesario, ingresa la instrucción en **Pregúntale a Runner** y envíala. Cuando Runner comienza, la selección y el historial de edición directa sin guardar se borran.
4. Espera a que se complete la guardación o solicitud de Runner elegida, luego revisa la página en Vista previa normal.
5. Verifica la página nuevamente en los diseños de **PC**, **Tablet** y **Teléfono**. Confirma que el encabezado, imagen o espaciado guardado aún está presente después de que se recargue la vista previa.
6. Publica solo después de que la vista previa guardada pase tu revisión.
## Estados, límites y solución de problemas
| Lo que ves | Significado | Qué hacer |
| --- | --- | --- |
| **Iniciando el modo de diseño…** | Runner está preparando la vista previa editable. | Mantén la última versión seleccionada. |
| **El modo de diseño no se inició** | La vista previa editable no se hizo lista. | Selecciona **Intentar de nuevo**. Si se repite, vuelve a Vista previa normal y actualiza. |
| **Tu vista previa aún se está cargando.** | La inspección de elementos no está lista. | Espera a que la tienda online termine de cargarse. |
| **Podrás volver a editar visualmente cuando Runner termine de procesar.** | Runner está manejando otra solicitud. | Espera a que la solicitud termine, luego selecciona el elemento nuevamente. |
| Runner comienza después de una solicitud **Pregúntale a Runner** | El editor visual se reinicia para la nueva tarea. | Cualquier edición directa sin guardar y su historial de deshacer/rehacer se descartan. Guarda ediciones directas antes de enviar la solicitud. |
| **Edición de IA no disponible para contenido dinámico** | El contenido seleccionado no se puede cambiar a través de ese control. | Describe la página y el resultado deseado en el chat regular de Runner. |
| **Nada que deshacer / rehacer / guardar** | La sesión actual de Modo de diseño no tiene la acción correspondiente. | Selecciona un elemento editable y realiza un cambio primero. |
| **Cambios guardados en archivos de origen** | Runner completó la guardación de Modo de diseño. | Espera a que se recargue la vista previa, luego revisa la página cambiada de nuevo. |
| **No pudimos guardar tus cambios de diseño** | Runner no pudo escribir una o más ediciones en los archivos de tu tienda. Esas ediciones permanecen en el editor y **Guardar** sigue disponible. Las ediciones que sí se guardaron siguen guardadas. | Selecciona **Guardar** de nuevo. Si sigue fallando, deshaz esa edición o describe el cambio en el chat de Runner. |
| La edición se guarda pero no está en vivo | Guardar cambios actualiza el proyecto, no la tienda publicada. | Revisa la versión actual, luego selecciona **Publicar cambios**. |
## Guías relacionadas
- [Edita contenido, páginas y medios](./edit-content-pages-and-media)
- [Vista previa de tu tienda](./preview-your-store)
- [Usa historial de versiones](./version-history)
---
# Editar contenido, páginas y medios
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/edit-content-pages-and-media
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Tienda online** → abre la página de la tienda de destino → **Modo Diseño** → selecciona un elemento
## Qué cubre esta guía
Abre la página exacta de la tienda que deseas cambiar, edita un elemento de texto, diseño o medios compatible, y verifica el resultado guardado antes de publicar.
## Por qué y cuándo usar este flujo de trabajo
Usa este flujo de trabajo para pulir a nivel de página: corrige el texto, cambia la tipografía, ajusta el espaciado, reemplaza una foto, genera una imagen alternativa o elimina un elemento innecesario. Mantiene clara la página de destino y el elemento seleccionado.
Para cambios en el comportamiento de navegación, datos de productos, checkout o varias páginas a la vez, envía una solicitud regular a Runner en lugar de depender solo de los controles visuales.
## Disponibilidad y requisitos previos
- [Usa modo de diseño](./design-mode) explica cómo abrir el editor, el requisito de diseño de escritorio y cuándo el control no está disponible.
- Algunos elementos generados o dinámicos no se pueden editar en línea. Runner muestra menos controles para esos elementos.
- La generación de imágenes con IA puede usar créditos. Runner muestra el aviso aplicable en el panel de imágenes antes de ejecutarla.
## Abre la página y el editor
1. Abre tu proyecto y selecciona **Tienda online**.
2. En la vista previa normal, selecciona enlaces de la tienda para llegar a la página que deseas.
3. Si conoces la ruta, selecciona el campo de ruta, ingresa una ruta del mismo sitio como `/about` y presiona **Enter**.
4. Confirma que la página correcta es visible.
5. Selecciona **Modo Diseño** y luego selecciona el elemento de destino.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Comienza seleccionando el elemento objetivo en esta vista. Los controles específicos de imagen aparecen solo después de seleccionar medios compatibles; aquí no se muestra reemplazo ni guardado.
## Controles de medios
[Usa modo de diseño](./design-mode) documenta los controles compartidos **Pregúntale a Runner**, **Espaciado**, **Texto**, **Eliminar elemento**, **Deshacer**, **Rehacer** y **Guardar**. Los controles siguientes aparecen solo cuando el elemento seleccionado admite medios.
| Control | Qué cambia | Qué sucede cuando lo usas |
| --- | --- | --- |
| **Imagen → Subir** | Una imagen seleccionada o una imagen de fondo compatible. | Selecciona **Subir imagen**, elige un archivo de imagen y Runner reemplaza el medio seleccionado después de que la carga sea exitosa. El límite actual mostrado por el producto es 5 MB por imagen. |
| **Imagen → Generado por IA** | Una imagen de reemplazo generada. | Ingresa un prompt y selecciona **Ejecutar**. Después del primer resultado, **Ejecutar de nuevo** solicita otro resultado e **Historial** abre los resultados de esta sesión de edición. |
| **Historial** | Imágenes generadas de la sesión actual de edición de imágenes. | Selecciona un elemento para inspeccionarlo. **Restaurar esta versión** aplica esa imagen y su prompt; el icono de descarga descarga un resultado individual. |
## Edita una página de forma segura
1. Registra la ruta de página actual para poder volver a ella.
2. Selecciona el elemento y verifica qué controles aparecen. Los controles varían según el elemento.
3. Realiza un cambio a la vez, luego usa **Deshacer**, **Rehacer** o **Historial** de imagen para comparar el resultado antes de seleccionar **Guardar**.
4. Espera a que se complete la acción de guardado o solicitud de Runner elegida.
5. Cierra el Modo de Diseño y vuelve a abrir la misma página. Confirma que la nueva imagen o contenido permanece después de recargar, luego revísalo en los diseños de **PC**, **Tablet** y **Teléfono**.
6. Repite para la siguiente página solo después de que la primera página sea correcta.
## Estados, límites y solución de problemas
| Qué ves | Significado | Qué hacer |
| --- | --- | --- |
| Un elemento seleccionado tiene solo algunos controles | Runner expone los controles compatibles con ese elemento. | Usa el control disponible o pide a Runner en el chat un cambio más amplio. |
| Carga rechazada | El archivo falta, no es una imagen, excede el límite mostrado o la carga falló. | Elige otra imagen e intenta de nuevo. |
| **Generando…** | Runner está creando la imagen solicitada. | Mantén el panel abierto hasta que termine o reporte un fallo. |
| **Historial** está ausente | No existe ninguna imagen generada por IA en esta sesión de edición. | Genera la primera imagen o carga la tuya propia en su lugar. |
| La ruta no se abre | La ruta es inválida, externa o no forma parte de la vista previa. | Vuelve a `/`, usa un enlace visible de la tienda o pide a Runner que cree o repare la página. |
| La página guardada difiere en móvil | La edición afectó un diseño responsivo. | Reabre el Modo Diseño o pide a Runner una corrección específica del dispositivo antes de publicar. |
## Guías relacionadas
- [Usa modo de diseño](./design-mode)
- [Vista previa de tu tienda](./preview-your-store)
- [Publicar y republicar](./publish-and-republish)
---
# Inspecciona y edita el código de la tienda
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/inspect-and-edit-code
El editor de código te permite inspeccionar o realizar un cambio enfocado en los archivos de la tienda detrás de la vista previa actual. Úsalo solo cuando una edición visual o solicitud de Runner no sea la mejor opción.
## Qué cubre esta guía
Abre el editor de código condicional, guarda un cambio de archivo enfocado, vuelve a la vista previa para verificarlo y mantén commit, push y publicación como acciones deliberadas separadas.
## Ruta de acceso
Abre un proyecto de tienda → **Tienda online** → **Abrir editor de código**.
## Antes de empezar
- Espera hasta que el workspace del proyecto y la vista previa de la tienda estén conectados.
- Usa el editor de código solo si entiendes el archivo que tienes la intención de cambiar.
- Guarda cada archivo cambiado antes de cerrar su pestaña o el diálogo. Cerrar un archivo no guardado no muestra una confirmación.
- Un archivo guardado cambia el workspace del proyecto, pero no se confirma, envía, publica ni se prueba automáticamente en la vista previa.
- Usa **Confirmar** y **Enviar** solo cuando estés autorizado a cambiar el Git remoto configurado del proyecto.
## Controles del editor y resultados de clic
| Control o estado | Qué sucede después de usarlo |
| --- | --- |
| **Abrir editor de código** | Abre el diálogo **Editor de código** de altura completa. Cerrar el diálogo devuelve el panel del escaparate a la vista previa. |
| Icono de archivos | Muestra el árbol de archivos de la tienda que se puede buscar. Expandir una carpeta carga su contenido; seleccionar un archivo lo abre en una pestaña. |
| Pestaña de archivo | Cambia el editor a ese archivo abierto. Un punto naranja significa que la pestaña contiene cambios no guardados. |
| Icono de cierre en una pestaña de archivo | Cierra esa pestaña. Runner no pregunta sobre cambios no guardados, así que guarda primero. |
| Editor de código | Te permite cambiar el archivo activo. Escribir cambia la pestaña abierta pero no guarda el archivo por sí solo. |
| **Command-S** en macOS o **Control-S** en Windows/Linux | Guarda el archivo activo en el workspace del proyecto conectado. El indicador de no guardado naranja se limpia después del éxito. |
| Icono de rama de Git | Abre la rama actual, listas de archivos cambiados, formulario de commit y controles de push. Seleccionar un archivo cambiado abre su diff. |
| **Preparar** / **Deshacer preparación** | Añade o elimina un archivo del próximo commit. No guarda una pestaña del editor no guardada. |
| **Preparar todo** / **Deshacer preparación** | Aplica la misma opción de staging a cada archivo en la lista correspondiente. Revisa la lista antes de usar cualquiera de las acciones. |
| **Mensaje de commit** | Registra la explicación que se adjuntará al próximo commit. |
| **Confirmar** | Crea un commit a partir de archivos staged cuando el mensaje no está vacío. Los cambios unstaged y no guardados permanecen fuera de ese commit. |
| **Enviar** | Envía inmediatamente los commits que están adelante del remoto configurado. No hay una segunda confirmación en este panel. |
| **Actualizar** | Solicita el estado de Git más reciente para el workspace del proyecto conectado. |
## Realiza y verifica una edición enfocada
1. Confirma el nombre del proyecto y la tienda actual en la vista previa.
2. Selecciona **Abrir editor de código**.
3. Mantén la vista de Archivos abierta, expande la carpeta requerida y selecciona un archivo.
4. Lee el contenido existente antes de cambiarlo.
5. Realiza la edición más pequeña prevista.
6. Presiona **Command-S** o **Control-S** y confirma que el punto naranja desaparece.
7. Reabre el archivo para confirmar el contenido guardado, luego cierra el editor de código y revisa la página afectada en Vista previa.
8. Verifica los diseños de escritorio y móvil cuando el cambio puede afectar a cualquiera de ellos.
9. Si el resultado es incorrecto, vuelve al editor y corrígelo, o pide a Runner que repare el archivo específico y el problema visible.
Guardar solo prueba que Runner escribió el archivo. La vista previa solo prueba que el proyecto actual puede mostrarlo. La publicación y el viaje del cliente en vivo permanecen como verificaciones separadas.
## Confirma y envía solo cuando sea necesario
1. Guarda cada archivo que tengas la intención de incluir.
2. Abre la vista de rama de Git.
3. Selecciona cada archivo cambiado y revisa su diff.
4. Usa **Preparar** para los archivos previstos. Evita **Preparar todo** cuando hay cambios no relacionados presentes.
5. Ingresa un **Mensaje de commit** claro.
6. Selecciona **Confirmar** y espera a que se actualice el estado de Git.
7. Usa **Enviar** solo después de confirmar la rama y el flujo de trabajo remoto. La acción comienza inmediatamente.
8. Vuelve a la vista previa y verifica el resultado visible. Un commit o push exitoso no publica la tienda.
## Solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| **Abrir editor de código** está ausente | La función no está habilitada para este proyecto. | Usa el Modo Diseño o pide a Runner que realice el cambio. No confíes en una ruta interna copiada. |
| **Conectando al sandbox...** | El workspace del proyecto aún no está conectado. | Mantén el proyecto abierto e intenta de nuevo después de que el workspace se reconecte. |
| Spinner del árbol de archivos | Runner está cargando la carpeta actual. | Espera antes de seleccionar otra carpeta repetidamente. |
| Seleccionar un archivo no hace nada | El archivo no se pudo leer o el workspace se desconectó. | Verifica la conexión, luego selecciona el archivo una vez más. |
| El punto naranja permanece después de guardar | El archivo no se guardó correctamente. | Mantén la pestaña abierta, lee el mensaje de error e intenta de nuevo después de reconectar si es necesario. |
| **Abrir un archivo del árbol** | Ningún archivo está activo. | Selecciona un archivo en la vista de Archivos. |
| **Sin cambios** | Git no reporta cambios de archivo guardados. | Guarda la pestaña del editor, luego selecciona **Actualizar**. |
| **Confirmar** está deshabilitado | No hay archivo staged o no hay mensaje de commit. | Realiza el staging del archivo guardado previsto e ingresa un mensaje. |
| **Enviar** está deshabilitado | La rama no tiene commit local adelante del remoto, o un push está en ejecución. | Confirma el cambio previsto o espera al push actual. |
| **Error al cargar el estado de git** | Runner no pudo leer el estado del repositorio. | Selecciona **Reintentar**. No realices staging o push hasta que se cargue el estado. |
| El contador de flecha hacia abajo muestra que la rama está atrás | El remoto contiene commits no presentes en el workspace. | Detente antes de enviar y pide al propietario del proyecto cómo actualizar la rama de forma segura. |
| Error de guardado, staging, commit o push | La acción no se completó. | Mantén el estado actual, lee el error e intenta de nuevo solo después de verificar la conexión y el permiso. |
## Guías relacionadas
- [Vista previa de tu tienda](./preview-your-store)
- [Usa modo de diseño](./design-mode)
- [Usar el historial de versiones](./version-history)
- [Publicar y republicar](./publish-and-republish)
- [Solucionar problemas de vista previa y publicación](./troubleshoot-preview-and-publishing)
---
# Verifica la tienda en vivo y el checkout
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/live-store-and-checkout
**Ruta de entrada:** Después de una publicación exitosa, usa la URL pública o **Ver tienda** cuando la entrega lo ofrezca. En escritorio, cuando se muestre el menú del sitio publicado, abre **Tienda online** → menú del sitio publicado → **Ver sitio**. La barra de herramientas actual del escaparate en móvil oculta este menú.
## Qué cubre esta guía
Prueba que un cliente puede abrir la tienda pública, encontrar un producto real, añadir una opción disponible al carrito y llegar a un checkout utilizable, sin tratar un mensaje de publicación exitosa como prueba de todo el viaje.
## Por qué y cuándo verificar el viaje en vivo
Ejecuta esta verificación después de la primera publicación y después de cambios en productos, navegación, precios, inventario, envío, pagos o checkout. Los cuatro resultados son independientes:
1. la tienda puede ser pública;
2. el catálogo previsto puede estar faltante o desactualizado;
3. el carrito puede fallar incluso cuando se carga una página de producto; y
4. el checkout puede estar pausado incluso cuando la tienda está en vivo.
## Disponibilidad y requisitos previos
- Una publicación completada debe proporcionar una URL pública.
- Al menos un producto previsto debe estar activo, visible, con precio y disponible para la región que estás probando.
- La configuración de envío o entrega debe cubrir el destino de prueba cuando sea necesario.
- Para una tienda Runner nativa, Stripe debe estar conectado si esperas que los clientes paguen. Las tiendas Shopify usan el pago de Shopify y su configuración de pago.
- No completes una compra real a menos que tengas la intención de realizar ese pedido y entiendas el impacto del cargo y cumplimiento.
## Abre la tienda en vivo
Usa cualquiera de estas rutas:
1. Después de la publicación, selecciona **Ver tienda** en la entrega; o
2. En escritorio cuando se muestre, selecciona el menú del sitio publicado en **Tienda online**, luego selecciona **Ver sitio**; o
3. Abre la barra lateral **Configuración → Tienda: _nombre de la tienda_ → Dominio** y selecciona la dirección publicada, incluso en móvil cuando el menú de Tienda online está oculto.
El menú del sitio publicado de escritorio también ofrece **Copiar URL** cuando se muestra, para que puedas probar la misma dirección en otra sesión del navegador.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Después de publicar, abre el menú desplegable junto a **Publicar cambios**: 1. Menú del sitio publicado. 2. **Ver sitio** abre la tienda en vivo; **Copiar URL** copia su dirección. 3. **Configuración de dominio** abre la gestión de direcciones. Esta imagen no verifica el proceso de pago. Selecciona la imagen para ampliarla. Las anotaciones usan la interfaz de escritorio en inglés.
## Controles y resultados de la tienda en vivo
Las etiquetas de estado de Stripe a continuación se aplican a las tiendas Runner nativas. Para una tienda Shopify conectada, verifica el pago de Shopify por separado.
| Control o estado | Qué sucede |
| --- | --- |
| URL publicada | Abre la tienda pública. Confirma que la dirección es la que tienes la intención de compartir. |
| **Ver tienda** / **Ver sitio** | Abre la URL pública en una pestaña nueva. Esto es diferente de **Abrir en nueva pestaña** dentro de la vista previa. |
| **Copiar** / **Copiar URL** | Copia la URL pública para compartir o una prueba de navegador independiente. |
| **Tienda online activa** | Runner encontró una URL de tienda pública que los clientes pueden navegar y compartir. No confirma el checkout. |
| **Comprobando el pago** | Runner está verificando si la tienda puede aceptar pagos. |
| **Pago activo** | Runner encontró una conexión de Stripe habilitada. No prueba el producto seleccionado, destino de envío, campos de checkout o paso de pago; verifica esos por separado. |
| **Pago pausado** | La tienda pública es navegable, pero los pagos no están disponibles hasta que Stripe esté conectado. |
| **Estado de pago no disponible** | Runner no pudo determinar el estado del pago. Selecciona **Volver a comprobar el pago** antes de afirmar que el checkout está listo. |
| **Conectar Stripe** | Abre la ruta de conexión de pago. Solo un propietario o administrador de workspace elegible puede completarla. |
| **Omitir por ahora** | Cierra el aviso sin habilitar pagos. |
## Prueba el viaje del cliente
1. Abre la URL pública en una pestaña nueva. Para una verificación más fuerte, usa una sesión sin sesión iniciada o de navegación privada.
2. Confirma que la página de inicio esperada se carga sin controles del proyecto de Runner.
3. Sigue la navegación pública a una página de colección o producto.
4. Confirma que el producto previsto es visible con el título, medios, precio y opciones disponibles correctos.
5. Elige cualquier opción requerida, como tamaño o color.
6. Selecciona el control de añadir al carrito de la tienda y confirma que el recuento del carrito o el contenido del carrito cambia.
7. Abre el carrito. Confirma que el producto, opción, cantidad, precio y totales coinciden con lo que seleccionaste.
8. Inicia el checkout y confirma que la página de checkout acepta la información requerida del cliente y entrega.
9. Confirma que el paso de pago está disponible si Runner reporta **Pago activo**.
10. Detente antes de la acción de compra final a menos que una orden de prueba real esté autorizada.
11. Repite los pasos principales de navegación y carrito en una vista de tamaño de teléfono o navegador móvil real.
## Registra cada resultado por separado
| Verificación | Condición de aprobación |
| --- | --- |
| URL pública | Se abre sin una puerta de acceso o estado de página faltante. |
| Navegación | Los enlaces importantes llegan a las páginas públicas previstas. |
| Catálogo | El producto en vivo previsto y sus datos actuales son visibles. |
| Carrito | Añadir una opción disponible produce el estado correcto del carrito. |
| Envío | El destino previsto tiene una ruta de entrega esperada cuando sea aplicable. |
| Checkout | El pago previsto llega a su paso de pago. El estado de pago de Runner nativo o la configuración de Shopify también confirma un proveedor habilitado. |
| Móvil | El contenido importante y los controles de compra permanecen utilizables en una pantalla pequeña. |
## Estados, límites y solución de problemas
| Qué ves | Significado | Qué hacer |
| --- | --- | --- |
| La vista previa funciona pero la URL pública falla | La vista previa y la publicación son entornos o versiones diferentes. | Vuelve a Runner, verifica el estado de publicación y usa **Republicar** solo después de corregir el problema nombrado. |
| El sitio público se carga pero el producto está faltante | La tienda está en vivo, pero el catálogo previsto no es visible allí. | Verifica el estado del producto, mercado, inventario y si los últimos cambios fueron publicados. |
| Añadir al carrito está faltante o deshabilitado | El producto o opción elegida puede no ser vendible en este contexto. | Verifica disponibilidad, opciones, precio, stock y configuración de mercado en Operaciones de la tienda. |
| **Pago pausado** | Los pagos no están conectados. | Selecciona **Conectar Stripe**; no anuncies la tienda como lista para pedidos aún. |
| **Estado de pago no disponible** | Runner no puede confirmar el estado del pago. | Selecciona **Volver a comprobar el pago** y abre independientemente la ruta de checkout. |
| El checkout se abre pero no puede continuar | El producto, envío, mercado, campos del cliente o configuración de pago pueden estar incompletos. | Registra el paso exacto y el mensaje, corrige esa configuración, publica cambios si es necesario y vuelve a probar desde la URL pública. |
## Guías relacionadas
- [Publicar y republicar](./publish-and-republish)
- [Prepararse para publicar](./prepare-to-publish)
- [Solucionar problemas de vista previa y publicación](./troubleshoot-preview-and-publishing)
---
# Prepararse para publicar
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/prepare-to-publish
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Tienda online** → **Publicar**, **Publicar cambios** o **Republicar** (la etiqueta depende del estado de publicación) → **Confirmar Implementación**
Cuando las tarjetas de versión de conversación condicional están habilitadas, **Publicar** en una tarjeta de trabajo **Versión actual** sin publicar abre las mismas comprobaciones de publicación. Las tarjetas de versión histórica no se publican directamente.
## Qué cubre esta guía
Alcanza una comprobación de publicación exitosa con los detalles de la tienda que tienes la intención de lanzar, o toma una decisión informada sobre cualquier configuración incompleta que Runner te pida que reconozcas.
## Por qué y cuándo prepararse
Usa esta lista de verificación antes del primer **Publicar** y antes de **Publicar cambios** importantes. Reduce el riesgo de lanzar una página pulida sin producto vendible, envío incompleto, pagos pausados o una compilación fallida.
Runner a veces puede permitirte publicar después de reconocer una configuración incompleta. Esa es una excepción deliberada, no una prueba de que la tienda está lista para recibir pedidos.
Las comprobaciones exactas y la entrega dependen de la experiencia de publicación habilitada para el workspace. Algunos workspaces muestran una advertencia de pago antes de la publicación y un aviso de éxito después; otros muestran comprobaciones de Operaciones de la tienda antes de la publicación y el estado del pago después de la publicación. Sigue las etiquetas que se muestran en tu flujo.
## Disponibilidad y requisitos previos
- Necesitas un proyecto con una vista previa de tienda lista.
- La publicación depende de la elegibilidad del plan y el acceso al proyecto. Si Runner abre una puerta de plan, compara los [planes públicos](https://www.runnerai.com/pricing) y elige el plan elegible antes de volver a este flujo.
- El workspace de la tienda debe estar conectado y Runner debe estar inactivo.
- La disponibilidad de la tienda varía según el negocio. Runner puede verificar conceptos básicos de la tienda, productos, detalles de envío o stock, conexión de pago, cambios detectados y si la tienda se compila.
## Abre el flujo de disponibilidad
1. Abre tu proyecto y selecciona **Tienda online**.
2. Revisa la versión **Actual** más reciente.
3. Selecciona **Publicar**, **Publicar cambios**, o **Republicar**, según la etiqueta que se muestre.
4. Runner verifica el acceso, actualiza los cambios detectados y el estado de configuración, luego abre **Confirmar Implementación**.
## Controles de preparación
| Control | Cuándo aparece | Qué sucede cuando lo seleccionas |
| --- | --- | --- |
| **Abrir Operaciones de la tienda** | La confirmación dice que la configuración de la tienda está incompleta. | Runner cierra la confirmación y abre Operaciones de la tienda. |
| **Volver a comprobar la configuración** | Runner no pudo verificar Operaciones de la tienda. | Runner verifica el estado de configuración nuevamente. |
| **Reintentar comprobación** | Runner no pudo alcanzar el workspace de la tienda. | Runner vuelve a ejecutar la comprobación de compilación de publicación. |
| **Corregir con IA** | La comprobación de compilación de la tienda falla y Runner puede repararla. | Runner cierra la confirmación y envía el error de compilación a la conversación para reparación. No comienza la publicación. |
| Casilla de advertencia | Dependiendo del flujo de publicación, las Operaciones de Tienda incompletas o no disponibles, o la falta de conexión de pago necesitan reconocimiento explícito. Las verificaciones sin cambios no se pueden reconocer y descartar. | Seleccionar la casilla confirma que entiendes el riesgo nombrado; puede habilitar **Confirmar** después de que la verificación de creación tenga éxito. |
| **Cancelar** | No estás listo para continuar. | Runner cierra la confirmación sin publicar. |
| **Confirmar** | La comprobación de compilación tuvo éxito y las advertencias requeridas se han resuelto o reconocido. | Runner inicia la publicación. El botón permanece deshabilitado mientras las comprobaciones estén incompletas o Runner esté trabajando. |
## Completa la lista de verificación de lanzamiento
1. En la vista previa, verifica la página de inicio, navegación, página de producto, entrada de carrito y diseño de teléfono.
2. Abre Operaciones de la tienda y confirma que los detalles comerciales y de tienda que se muestran allí son correctos.
3. Confirma que al menos un producto previsto es visible, vendible y utiliza el precio, opciones y medios correctos.
4. Confirma la ubicación del stock y la configuración de envío necesaria para ese producto.
5. Decide si el pago debe aceptar pagos al lanzamiento. Para una tienda Runner nativa, conecta Stripe si se deben aceptar pagos. Las tiendas Shopify mantienen el pago en Shopify; revisa la configuración de pago de esa tienda. Algunos espacios de trabajo muestran esta advertencia antes de la publicación y otros informan el estado del pago después; ninguno es un sustituto para probar el pago.
6. Vuelve a **Tienda online** y selecciona el botón de publicación.
7. Espera **¡Tu tienda está lista para publicar!**
8. Resuelve cada advertencia. Usa un reconocimiento solo cuando aceptes su impacto exacto en el cliente.
9. Si solo querías inspeccionar la preparación, selecciona **Cancelar**. Selecciona **Confirmar** solo cuando tengas la intención de poner esta versión en línea.
10. Después de la publicación, verifica la tienda en vivo, catálogo, carrito y checkout por separado.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
La creación pasa en este ejemplo, pero la configuración de la tienda aún necesita atención. Un reconocimiento no completa esa configuración.
### Ver: revisar verificaciones y cancelar
La grabación revisa el resultado de la creación y la advertencia de configuración, luego selecciona **Cancelar**. No publica la tienda de ejemplo.
## Estados de disponibilidad y solución de problemas
| Lo que ves | Significado | Qué hacer |
| --- | --- | --- |
| **Verificando que tu tienda esté lista para publicar…** | Runner está verificando la compilación actual de la tienda. | Espera el éxito o una falla nombrada. |
| **¡Tu tienda está lista para publicar!** | La comprobación de compilación pasó. | Resuelve advertencias, luego selecciona **Confirmar**. |
| **Tu tienda todavía no se puede compilar, así que no puede publicarse. Deja que Runner corrija los errores y luego publica.** | La tienda online no se puede publicar en su forma actual. | Selecciona **Corregir con IA**, revisa la reparación y comienza el flujo de preparación nuevamente. |
| **No pudimos acceder a tu espacio de trabajo. Vuelve a comprobarlo para continuar.** | La comprobación no pudo acceder al espacio de trabajo actual. | Selecciona **Reintentar comprobación**. Si se repite, vuelve a conectar el espacio de trabajo. |
| **Haz un cambio visible en tu tienda antes de publicarla.** | Runner no encontró un cambio desde la última publicación. | Cancela y realiza el cambio previsto en la tienda. **Confirmar** permanece deshabilitado cuando no hay cambios para publicar. |
| **Aún quedan algunos detalles operativos por revisar. Puedes publicar ahora y terminarlos en Operaciones de la tienda.** | Quedan detalles operativos importantes sin terminar. | Selecciona **Abrir Operaciones de la tienda**. Publica con reconocimiento solo si aceptas las limitaciones. |
| **No pudimos verificar Operaciones de la tienda. Vuelve a intentarlo o confírmalo y publica de todos modos.** | El estado de la configuración no está disponible, no necesariamente completo. | Selecciona **Volver a comprobar la configuración** antes de considerar el reconocimiento. |
| **Los compradores pueden navegar, pero aún no pueden pagar; conecta Stripe en Configuración para recibir pedidos.** | En los flujos de publicación que muestran esta advertencia antes del lanzamiento, Runner no encontró una conexión de pago habilitada. | Conecta Stripe, o reconoce solo si un lanzamiento solo de navegación es intencional. Otros flujos informan el estado de pago después de la publicación. |
## Guías relacionadas
- [Vista previa de tu tienda](./preview-your-store)
- [Publicar y republicar](./publish-and-republish)
- [Verifica la tienda en vivo y el checkout](./live-store-and-checkout)
---
# Vista previa de tu tienda
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/preview-your-store
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Tienda online**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
## Qué cubre esta guía
Revisa la tienda actual dentro de Runner, muévete entre sus páginas y verifica cómo se ve en diseños de escritorio, tableta y teléfono sin publicarla.
## Por qué y cuándo usar Vista previa
Usa Vista previa después de que Runner cree o cambie la tienda. Es el lugar más seguro para detectar textos faltantes, rutas rotas, diseños móviles deficientes o secciones incompletas antes de que los clientes las vean.
La vista previa es independiente de la tienda publicada. Que una página se vea correcta aquí no demuestra que funcionen la URL pública, los datos del catálogo, el inventario, la conexión de pagos o el proceso de compra.
## Disponibilidad y requisitos previos
- Abre un proyecto con actividad de tienda existente o una versión previsualizable.
- Si la página dice **Dile a Runner cómo quieres que sea tu tienda online.**, usa la entrada en esa página para pedir a Runner que cree la primera versión.
- Si dice **Construyendo la primera versión de tu tienda…** o **Preparando la vista previa…**, la vista previa aún no está lista.
- Algunos espacios de trabajo usan la tienda más nueva basada en puntos de control. Los controles de versión exactos pueden variar con disponibilidad por etapas.
Cuando las tarjetas de versión de conversación condicional están habilitadas, seleccionar la imagen de tienda o **Vista previa** de la tarjeta de trabajo completada abre la versión exacta lista creada por esa tarea. Puede ser histórica en lugar de la más reciente. Para un proyecto más antiguo sin historial de versión guardado, **Vista previa** en la tarjeta de trabajo de tienda más reciente abre la vista previa en vivo actual en su lugar. Verifica las etiquetas **v…**, **Versión actual** y **Publicado** cuando estén disponibles antes de editar o iniciar publicación.
Que una tarea se complete o que la compilación del código fuente tenga éxito no significa por sí solo que la vista previa se haya actualizado. Runner promueve la tienda terminada después de que se completa la tarea. Si esa promoción falla, la vista previa conserva la versión anterior que se completó correctamente —o no muestra ninguna vista previa compilada si aún no existe una—; por eso, confirma la versión visible y el resultado de la vista previa.
## Abre Vista previa
1. Abre tu espacio de trabajo de Runner.
2. Selecciona la tienda que quieres revisar.
3. Selecciona **Tienda online** en la navegación del proyecto.
4. Espera hasta que la versión actual aparezca en el área de vista previa.
### Observa el control del dispositivo
Esta grabación silenciosa muestra la vista previa original v1 en la interfaz en inglés. Selecciona **PC**, luego **Tablet**, luego **Teléfono** para cambiar el marco de vista previa. Selecciona **Teléfono** nuevamente para volver a escritorio. La tienda permanece sin publicar durante este ejemplo.
Si el proyecto aún no tiene tienda:
1. Ingresa lo que deseas en la entrada de descripción de la tienda. Describe el aspecto, el diseño, los productos y el contenido que deseas.
2. Selecciona la flecha de enviar (**Enviar mensaje**), o **Empezar a construir** si esa acción aparece en tu espacio de trabajo.
3. Runner crea una conversación y envía esa descripción como la primera solicitud.
4. Si la creación falla, la descripción permanece en el campo para que puedas reintentar.
## Controles de vista previa
| Control | Por qué lo usas | Lo que sucede cuando lo seleccionas |
| --- | --- | --- |
| **Atrás** | Regresa a la página anterior visitada dentro de la vista previa. | La vista previa se mueve hacia atrás en su propio historial de páginas. No sale de tu proyecto de Runner. |
| **Adelante** | Revisa una página después de ir atrás. | La vista previa se mueve hacia adelante cuando existe una entrada de historial posterior. |
| **PC / Tableta / Teléfono** | Verifica diseños responsivos. | Cada selección cambia el marco de vista previa al siguiente tamaño de dispositivo. No cambia la tienda en vivo. |
| Campo de ruta, como `/` | Abre una ruta de tienda conocida. | Selecciona la ruta, ingresa otra ruta en el mismo sitio de vista previa y presiona **Enter**. Las direcciones inválidas o externas se ignoran. |
| **Actualizar** | Recarga la vista previa actual después de un cambio o representación atascada. | Runner recarga la página visible y borra la selección de Modo de diseño activo y la sesión de deshacer/rehacer. Guarda primero los cambios de diseño pendientes. |
| **Abrir en nueva pestaña** | Revisa la vista previa con más espacio. | Runner abre esta URL de vista previa en otra pestaña del navegador. Esto sigue siendo una vista previa, no prueba de una tienda publicada. |
| Etiqueta de versión, como **v1 · Actual** | Identifica qué estás revisando. | La etiqueta distingue la versión actual más reciente de una vista previa histórica. |
| **Modo Diseño** | Comienza la edición visual. | Runner abre el espacio de trabajo de diseño cuando la versión más reciente es elegible. |
| **Historial de versiones** | Compara versiones anteriores de tienda. | Runner abre la lista de versiones sin cambiar la tienda actual. |
| **Abrir editor de código** | Inspecciona o edita la fuente de tienda cuando este control avanzado está disponible. | Runner abre el diálogo **Editor de código** de altura completa. Cerrarlo devuelve el panel Tienda a Vista previa; verifica el resultado visible allí. |
| Moneda / **Invitar a amigos** | Abre la oferta de referencia. | Runner abre el diálogo de referencia; no se ganan créditos simplemente por abrirlo. |
| Recuento de créditos / **Mejorar** | Revisa opciones de créditos, plan o uso. | Runner abre un menú emergente cuyas acciones disponibles pueden llevar a Facturación o Uso del espacio de trabajo. |
| **Publicar**, **Publicar cambios** o **Republicar** | Inicia el flujo de publicación apropiado para el estado actual. | Runner ejecuta verificaciones de acceso y disponibilidad antes de que comience cualquier publicación. |
## Revisa una página de tienda por página
1. Comienza en `/` y escanea el encabezado, área de anuncio, héroe, productos destacados, secciones y pie de página.
2. Selecciona cada enlace de navegación visible. Confirma que el destino aparece y la ruta de vista previa cambia como se esperaba.
3. Abre una página de producto desde la tienda. Confirma que su título, medios, precio, opciones, disponibilidad y control de compra sean visibles.
4. Usa el campo de ruta para rutas importantes que no están vinculadas desde la página actual.
5. Cambia entre **PC**, **Tablet** y **Teléfono**. Busca contenido recortado, controles superpuestos, texto ilegible y desplazamiento horizontal.
6. Selecciona **Actualizar** solo después de guardar cualquier cambio de Modo de diseño.
7. Registra cualquier problema en el chat de Runner con la ruta de página, tamaño de dispositivo y resultado esperado.
## Estados, límites y solución de problemas
| Lo que ves | Significado | Qué hacer |
| --- | --- | --- |
| **Dile a Runner cómo quieres que sea tu tienda online.** | Runner no tiene una tienda lista para mostrar. | Ingresa una solicitud para crear la primera versión. |
| **Construyendo la primera versión…** | La primera versión aún se está preparando. | Sigue el progreso de la tarea y espera un resultado terminal. |
| **Preparando la vista previa…** | Runner está iniciando la vista previa seleccionada. | Mantén la página abierta; usa **Actualizar** solo si el estado deja de progresar. |
| **Error al cargar la vista previa para esta versión** | La versión seleccionada no pudo mostrarse. | Regresa a la versión actual, actualiza o reporta la versión y error a Runner. |
| **Reconectando vista previa** | Runner perdió la conexión de vista previa e intenta nuevamente. | Mantén el proyecto abierto y sigue el recuento de reintentos. Si no puede recuperarse, reconecta el espacio de trabajo. |
| Barra de error de vista previa con **Corrección** | La vista previa reportó un error que Runner puede inspeccionar. | Selecciona **Corrección** o **Arreglar error** para enviar el diagnóstico mostrado a Runner. Usa **Mostrar más** para expandir detalles y **Descartar** solo para ocultar el mensaje. |
| Un control está deshabilitado | La vista previa actualmente no admite esa acción, el espacio de trabajo está desconectado o Runner está trabajando. | Espera a Runner, reconecta el espacio de trabajo si se solicita, o regresa a la versión lista más reciente. |
| La vista previa se ve correcta pero la tienda en vivo no | Los cambios no han sido publicados o estás viendo versiones diferentes. | Verifica la etiqueta de versión, luego usa [Publicar cambios](./publish-and-republish). |
## Guías relacionadas
- [Crea tu primera tienda, paso a paso](../start-here/first-store-quickstart)
- [Usa Modo de diseño](./design-mode)
- [Editar contenido, páginas y medios](./edit-content-pages-and-media)
- [Inspecciona y edita código de tienda](./inspect-and-edit-code)
- [Usa historial de versiones](./version-history)
- [Prepárate para publicar](./prepare-to-publish)
---
# Publicar y republicar
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/publish-and-republish
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Tienda online** → **Publicar**, **Publicar cambios** o **Republicar** (la etiqueta depende del estado de publicación)
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
## Qué cubre esta guía
Usa la acción de publicación que Runner muestra para el estado actual de la tienda, sigue la confirmación a un resultado terminal y abre o copia la URL pública cuando una esté disponible.
## Por qué y cuándo publicar
La publicación hace que la versión actual del proyecto esté disponible en una URL pública de la tienda. Usa **Publicar** para el primer lanzamiento, **Publicar cambios** para una tienda que ya tiene una URL pública operativa y **Republicar** para reintentar una publicación fallida o incompleta.
Guardar una edición del **Modo Diseño**, restaurar una versión o ver una **Vista Previa** correcta no actualiza la tienda pública por sí solo.
El flujo posterior a la publicación varía según el despliegue del espacio de trabajo. Algunos espacios de trabajo muestran una advertencia de pago antes de publicar y solo una notificación de éxito después; otros muestran comprobaciones de **Operaciones de la tienda** antes de publicar y abren una pantalla con el estado del pago después de completarse.
## Disponibilidad y requisitos previos
- Completa la [lista de verificación de disponibilidad de publicación](./prepare-to-publish).
- Usa la versión **Actual** más reciente de la tienda.
- Espera a que Runner termine cualquier solicitud activa.
- Reconecta el espacio de trabajo del escaparate si el botón indica que no está disponible.
- La publicación puede estar restringida por tu plan o elegibilidad del proyecto.
- Cuando la publicación requiere un plan superior, **Actualizar** abre la confirmación mensual de Plus. Puedes volver desde esa confirmación a la lista completa de planes antes de comprar.
## Abre el flujo de publicación
1. Abre tu proyecto.
2. Selecciona **Tienda online**.
3. Selecciona el botón de publicación en el lado derecho de la barra de herramientas.
4. Lee **¿Confirmar Implementación?** y espera la verificación de creación.
5. Resuelve los elementos bloqueantes. Reconoce una advertencia solo cuando el diálogo ofrece esa opción y entiendes su efecto.
6. Selecciona **Confirmar** solo cuando esté habilitado y tengas la intención de hacer pública esta versión. Selecciona **Cancelar** para salir sin publicar.
### Ver: revisar las verificaciones sin publicar
Esta grabación en inglés sin sonido muestra el resultado de la creación y la advertencia de configuración restante. Seleccionar **Cancelar** regresa a Vista previa. Una verificación de creación aprobada no completa la configuración operativa de la tienda ni habilita el pago.
## Elige la acción correcta
| Etiqueta | Cuándo Runner la muestra | Qué hace seleccionarla |
| --- | --- | --- |
| **Publicar** | La tienda no ha completado su primera publicación. | Abre comprobaciones de acceso, configuración, cambios y compilación para la versión actual. |
| **Publicar cambios** | Una publicación completada tiene una URL pública utilizable. | Abre las mismas comprobaciones para que puedas enviar la versión actual a la tienda publicada. |
| **Republicar** | La última publicación falló o se completó sin una URL utilizable. | Inicia un nuevo intento de publicación con las comprobaciones necesarias. |
| **Iniciando… / Preparando… / Compilando… / Guardando punto de control… / Publicando…** | Hay un paso de publicación en curso. | El botón está deshabilitado e informa del progreso. Espera a que termine correctamente o con un error. |
## Controles de publicación y entrega
| Control | Qué sucede cuando lo seleccionas |
| --- | --- |
| **Cancelar** en **¿Confirmar Implementación?** | Cierra el diálogo sin publicar esta versión. |
| **Corregir con IA** | Envía un error de compilación a Runner para que lo repare, sin publicar. |
| **Reintentar comprobación** | Vuelve a ejecutar la comprobación de compilación después de un error de acceso al espacio de trabajo. |
| **Confirmar** | Inicia la publicación cuando la comprobación de compilación y las confirmaciones requeridas estén completas. |
| **Publicar de todos modos; terminaré la configuración más tarde.**, cuando se ofrece | Reconoce la configuración incompleta listada. No completa esas tareas ni publica la tienda hasta que también selecciones Confirmar. |
| URL publicada | Abre la tienda pública en una pestaña nueva. |
| **Copiar** o **Copiar URL** | Copia la dirección de la tienda pública al portapapeles. |
| **Ver tienda** | En la pantalla de estado del pago, abre la tienda pública después de una publicación correcta. |
| **Conectar Stripe** | En los flujos que muestran el estado del pago, inicia la conexión cuando el pago aún no está listo. El acceso puede depender de tu rol en el espacio de trabajo. |
| **Omitir por ahora** | Cierra el aviso de pago posterior a la publicación cuando se muestra. La tienda puede seguir disponible para navegar mientras el pago permanece pausado. |
| **Volver a comprobar el pago** | En la pantalla posterior a la publicación, vuelve a comprobar si hay una conexión de Stripe habilitada cuando el estado no estaba disponible. |
| **Cerrar** | Cierra la pantalla de estado del pago cuando se muestra y el pago ya está conectado. |
| Menú del sitio publicado | En la versión de escritorio, cuando se muestra, abre **Ver sitio**, **Copiar URL**, **Configuración del dominio** y la información de la última publicación. |
## Publica a un resultado terminal
1. Confirma que la etiqueta del botón coincida con tu intención.
2. Selecciónalo y espera a que la comprobación de compilación termine.
3. Si aparece **Corregir con IA**, úsalo, revisa la vista previa resultante e inicia la publicación nuevamente.
4. Si aparecen advertencias, corrige la configuración subyacente siempre que el checkout o las operaciones normales de la tienda sean importantes.
5. Selecciona **Confirmar**.
6. Mantén el proyecto abierto hasta que Runner informe éxito o fracaso.
7. En caso de éxito, abre la URL pública. Usa **Ver tienda** cuando aparezca la pantalla de estado del pago; otro despliegue puede mostrar solo una notificación de éxito antes de volver a **Tienda online**.
8. Si la URL no está disponible, cierra la pantalla y usa **Republicar** cuando el espacio de trabajo esté listo.
9. Si la publicación falla, lee el error, repáralo y selecciona **Republicar**. No des por hecho que los cambios se publicaron.
## Estados de publicación y solución de problemas
| Lo que ves | Significado | Qué hacer |
| --- | --- | --- |
| **Tienda publicada** / **Tu tienda está activa** | Runner completó la publicación y tiene una URL pública. | Abre la URL y verifica el recorrido del cliente. |
| **Publicación completada** con **Enlace de la tienda no disponible** | La publicación terminó sin un enlace utilizable en la pantalla posterior. | Cierra el diálogo, asegúrate de que el espacio de trabajo esté listo y usa **Republicar**. |
| **Error al publicar la tienda** | La publicación no se completó. | Revisa el error o pide a Runner que lo corrija y usa **Republicar**. |
| **No se pudo compilar tu tienda** | El proyecto actual falló antes de la publicación. | Selecciona **Corregir con IA** y no vuelvas a intentar el mismo trabajo sin cambios. |
| El botón indica **Tu entorno de trabajo está desconectado; vuelve a conectarlo para publicar.** | Runner no puede acceder al espacio de trabajo del escaparate. | Vuelve a conectarlo y ejecuta de nuevo las comprobaciones. |
| El botón indica **Espera a que Runner termine** | Todavía hay una solicitud activa. | Espera a que alcance un resultado final antes de publicar. |
| **Sin cambios** o **Confirmar** deshabilitado | No hay un nuevo cambio guardado, una creación está incompleta, una tarea de IA está activa o una verificación requerida no está resuelta. | Completa el elemento mostrado. Sin cambios es un estado de bloqueo, no una advertencia que puedas reconocer y descartar. |
| La tienda pública muestra una versión anterior | Los cambios más recientes del proyecto no se publicaron correctamente. | Comprueba la versión actual, usa **Publicar cambios** y vuelve a verificarla. |
## Guías relacionadas
- [Crea tu primera tienda, paso a paso](../start-here/first-store-quickstart)
- [Prepárate para publicar](./prepare-to-publish)
- [Verifica la tienda en vivo y el checkout](./live-store-and-checkout)
- [Conecta un dominio personalizado](./custom-domains)
---
# Solucionar problemas de vista previa y publicación
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/troubleshoot-preview-and-publishing
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Tienda online** → reproduce el estado de vista previa o publicación que se muestra en pantalla
## Qué cubre esta guía
Identifica qué capa está fallando—versión del proyecto, vista previa, comprobación de compilación, publicación, catálogo público, checkout o dominio—y toma la acción de recuperación más pequeña y segura.
## Por qué esta distinción es importante
El viaje de la tienda tiene varias capas independientes. Repetir **Publicar** no puede corregir datos de producto faltantes, y actualizar la vista previa no puede reparar una conexión de pago. Comienza con el mensaje exacto y la superficie que falló.
## Disponibilidad y requisitos previos
- Mantén el proyecto abierto y anota la etiqueta de versión actual.
- Registra el mensaje exacto, la ruta de página y si falló en la vista previa o en la URL pública.
- Espera a que el trabajo activo de Runner alcance **Completado**, **Fallido** o **Detenido** antes de iniciar una acción de recuperación conflictiva.
- No elimines dominios, restaures versiones o repitas acciones pagadas solo para probar una teoría.
## Encuentra la capa que falla
1. En **Tienda online**, verifica si existe una versión actual.
2. Confirma si la vista previa normal se abre.
3. Si estás publicando, lee el resultado de la comprobación de compilación antes de seleccionar otra acción.
4. Si la publicación tiene éxito, abre la URL pública en lugar de la URL de vista previa.
5. En la tienda pública, prueba el catálogo y el carrito.
6. Verifica el estado de checkout de Runner y la ruta de checkout real.
7. Si solo la dirección personalizada falla, verifica la Configuración de Dominio al final.
## Controles de recuperación importantes
| Control | Qué sucede cuando se selecciona |
| --- | --- |
| **Actualizar** en la vista previa | Recarga la vista previa actual y borra la selección activa del Modo Diseño y la sesión de deshacer/rehacer. Guarda las ediciones directas pendientes primero. |
| **Corregir** / **Corregir error** | Envía el diagnóstico de vista previa mostrado a Runner como una solicitud de reparación. **Descartar** solo oculta el mensaje. |
| **Corregir con IA** | Cierra la confirmación de publicación y envía su falla de compilación a Runner para reparación; la publicación no comienza. |
| **Reintentar comprobación** | Ejecuta la comprobación de compilación de la tienda nuevamente después de que Runner no pudo alcanzar el workspace. |
| **Abrir Operaciones de la tienda** | Cierra la confirmación de publicación y abre Operaciones de la tienda para que puedas completar la configuración nombrada. |
| **Volver a comprobar la configuración** | Verifica nuevamente la disponibilidad de Operaciones de la tienda después de que su estado no estaba disponible. |
| **Republicar** | Inicia un intento de publicación verificado nuevo después de un resultado fallido o sin enlace. Corrige la causa nombrada primero. |
| **Volver a comprobar el pago** | Verifica nuevamente una conexión de pago habilitada; no prueba un producto, envío o el formulario de checkout. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Una comprobación de compilación aprobada puede aparecer junto a una advertencia de configuración. Lee ambos antes de decidir si la tienda está lista.
## Referencia de estado a acción
| Mensaje o síntoma | Capa | Qué significa | Acción más segura |
| --- | --- | --- | --- |
| No hay versión de tienda lista | Versión del proyecto | No existe una versión previsualizable. | Pide a Runner que cree la primera tienda. |
| **Construyendo la primera versión…** | Versión del proyecto | Runner aún la está creando. | Sigue el progreso de la tarea; no publiques aún. |
| **Error de compilación** en una versión | Versión del proyecto | Esa versión no está lista. | Abre los detalles de la tarea y pídele a Runner que repare la falla. |
| **Preparando la vista previa…** | Vista previa | Runner está iniciando la vista previa seleccionada. | Mantén la versión más reciente seleccionada; actualiza solo si el progreso se detiene. |
| **No se pudo cargar la vista previa de esta versión** | Vista previa | La versión seleccionada no se pudo mostrar. | Vuelve a la actual, actualiza o intenta otra versión lista. |
| **Reconectando la vista previa** | Vista previa | Runner perdió la conexión de vista previa e intenta nuevamente. | Sigue el recuento de reintentos; reconecta el workspace si la recuperación falla. |
| Barra de error de vista previa con **Corregir** | Vista previa | La página en ejecución reportó un diagnóstico que Runner puede usar. | Selecciona **Mostrar más** para inspeccionarlo, **Corregir** o **Corregir error** para enviarlo a Runner, o **Descartar** solo para ocultar la barra. |
| **Página no encontrada** | Ruta de vista previa o pública | La ruta no existe en esa versión. | Vuelve a `/`, usa navegación visible y pídele a Runner que cree o repare la ruta. |
| **El modo de diseño no se inició** | Modo Diseño | La vista previa editable no se volvió lista. | Selecciona **Intentar de nuevo**, o vuelve a la vista previa actual y actualiza. |
| **Podrás volver a editar visualmente cuando Runner termine de procesar.** | Modo de diseño | Runner está manejando otra solicitud. | Espera a que Runner termine. |
| **No se pudieron cargar tus versiones; vuelve a intentarlo.** | Historial de versiones | La solicitud de lista de versiones falló. | Selecciona **Intentar de nuevo**. |
| La restauración está bloqueada | Historial de versiones | Runner está activo o la versión no está lista. | Espera a Runner, luego elige una versión lista. |
| **No pudimos acceder a tu espacio de trabajo. Vuelve a comprobarlo para continuar.** | Comprobación de publicación | Runner no pudo ejecutar la comprobación de compilación. | Selecciona **Reintentar comprobación**; vuelve a conectar el espacio de trabajo si se repite. |
| **Tu tienda todavía no se puede compilar, así que no puede publicarse. Deja que Runner corrija los errores y luego publica.** | Comprobación de publicación | La tienda actual no puede pasar la compilación. | Selecciona **Corregir con IA**, revisa la reparación, luego vuelve a ejecutar las comprobaciones. |
| **Aún quedan algunos detalles operativos por revisar. Puedes publicar ahora y terminarlos en Operaciones de la tienda.** | Configuración de publicación | Quedan operaciones importantes de la tienda sin terminar. | Selecciona **Abrir Operaciones de la tienda**. Reconoce solo si la limitación es intencional. |
| **No pudimos verificar Operaciones de la tienda. Vuelve a intentarlo o confírmalo y publica de todos modos.** | Configuración de publicación | El estado de la configuración es desconocido. | Selecciona **Volver a comprobar la configuración** antes de considerar un reconocimiento. |
| **Haz un cambio visible en tu tienda antes de publicarla.** | Cambios de publicación | Runner no encontró nada nuevo desde la última publicación. | Cancela y realiza el cambio previsto primero. **Confirmar** está deshabilitado cuando no hay cambios para publicar. |
| **Los compradores pueden navegar, pero aún no pueden pagar; conecta Stripe en Configuración para recibir pedidos.** | Configuración de pago | Algunos flujos de publicación muestran esto antes del lanzamiento cuando no se encuentra una conexión de pago habilitada. | Para una tienda nativa de Runner, conecta Stripe; usa el reconocimiento solo para un lanzamiento intencional solo de navegación. Otros flujos informan el estado de pago después de la publicación. |
| **Error al publicar la tienda** | Publicación | El intento no se completó. | Repara el problema nombrado, luego selecciona **Republicar**. |
| **Enlace de la tienda no disponible** | Entrega de publicación | El intento terminó sin una URL pública utilizable en Runner. | Cierra el diálogo, confirma que el workspace esté listo, luego selecciona **Republicar**. |
| La tienda pública muestra contenido antiguo | Publicación o versión | Los cambios del proyecto más reciente no están en vivo. | Confirma la versión actual más reciente, selecciona **Publicar cambios** y reabre la URL pública. |
| Producto faltante en tienda pública | Catálogo | La publicación tuvo éxito, pero el producto previsto no es visible. | Verifica el estado del producto, mercado, precio e inventario; publica cambios si es necesario. |
| Acción de carrito faltante o deshabilitada | Catálogo o disponibilidad | El elemento seleccionado actualmente no se puede agregar. | Verifica opciones requeridas, disponibilidad, stock, precio y región. |
| **Pago pausado** | Pago | El flujo posterior a la publicación no encontró una conexión de Stripe habilitada. | Selecciona **Conectar Stripe**, luego prueba nuevamente la ruta de checkout real. |
| **Estado de pago no disponible** | Estado de pago | Runner no puede confirmar la disponibilidad de pago. | Selecciona **Volver a comprobar el pago** y prueba el checkout público independientemente. |
| El dominio personalizado propio muestra una advertencia roja y una tabla **Tipo / Host / Valor** | Dominio | La comprobación de configuración actual del proveedor aún no ha pasado. | Copia exactamente los valores mostrados a tu proveedor. Runner vuelve a comprobar automáticamente mientras la Configuración de dominio permanezca abierta; no hay un botón de verificación manual. |
| **Transferencia en curso** | Dominio | Un dominio se está moviendo entre tiendas. | No inicies otra transferencia; sigue el estado mostrado. |
## Confirma la recuperación
Vuelve a la misma página, versión y tamaño de dispositivo que falló. Repite el paso fallido más pequeño una vez. Verifica su resultado visible: una vista previa lista, una publicación exitosa con la página esperada en la URL pública, un carrito correcto o un dominio funcional. Registra cualquier paso que aún falle por separado.
## Reporta un problema a Runner
Incluye estos detalles en un mensaje:
1. la ruta de página exacta o URL pública;
2. si falló en la vista previa o en la tienda en vivo;
3. la etiqueta de versión actual;
4. el texto de error o estado exacto;
5. el último botón que seleccionaste;
6. el resultado esperado; y
7. si el problema se reproduce después de la acción de reintento documentada.
Para un problema visual, incluye el diseño del dispositivo y una captura de pantalla. Para checkout, detente antes de un cargo real e informa el último paso exitoso.
## Límites de recuperación
- No reanudes ni republiques repetidamente un estado fallido sin cambios. Corrige la causa nombrada primero.
- No restaures una versión anterior mientras Runner está trabajando.
- No elimines un dominio para corregir un problema de tienda o checkout.
- No reclames éxito de lanzamiento hasta que la URL pública, catálogo previsto, carrito y paso de checkout requerido hayan sido verificados cada uno.
## Guías relacionadas
- [Vista previa de tu tienda](./preview-your-store)
- [Prepararse para publicar](./prepare-to-publish)
- [Publicar y republicar](./publish-and-republish)
- [Verifica la tienda en vivo y el checkout](./live-store-and-checkout)
- [Conecta un dominio personalizado](./custom-domains)
---
# Usar el historial de versiones
Source: https://www.runnerai.com/docs/es/guides/storefront-and-publishing/version-history
Las capturas y grabaciones muestran la interfaz en inglés.
**Ruta de acceso:** Espacio de trabajo → selecciona una tienda → **Tienda online** → **Historial de versiones** (icono de reloj con flecha)
## Qué cubre esta guía
Compara versiones del escaparate, obtén una vista previa de una versión anterior lista y, cuando sea necesario, restaura su contenido como una nueva versión actual mientras mantienes el historial existente.
## Por qué y cuándo usar el historial de versiones
Usa el historial de versiones cuando necesites entender qué cambió, revisar un diseño anterior o recuperar contenido que era mejor antes de una solicitud reciente. La vista previa es de solo lectura. Restaurar cambia el proyecto, así que revisa la confirmación primero.
## Disponibilidad y requisitos previos
- Abre un proyecto con al menos una versión del escaparate.
- La vista previa histórica y la restauración solo están disponibles para versiones que Runner puede cargar correctamente.
- Espera a que Runner termine una solicitud activa antes de restaurar.
- El historial de versiones es condicional en espacios de trabajo que utilizan la experiencia del escaparate basada en puntos de control.
- Algunas tarjetas de trabajo de conversación completadas también muestran una etiqueta de versión condicional, vista previa de versión exacta y acción **Publicar** para una versión actual no publicada. Esas tarjetas son una entrada rápida; esta página sigue siendo la vista completa de comparación y restauración.
## Abre el historial de versiones
Abre la tienda que quieres revisar y sigue las indicaciones numeradas de la imagen.
1. **Selecciona Tienda online en la barra lateral izquierda.** Se abrirá la vista previa de tu tienda. Si la barra lateral solo muestra iconos, expándela con el botón de la esquina superior izquierda.
2. **Haz clic en el icono de reloj con flecha situado encima de la vista previa, cerca de la esquina superior derecha.** Es **Historial de versiones**. Pasa el cursor por encima para ver su nombre. En el ejemplo, está justo a la izquierda de la dirección del sitio publicado y de **Publicar cambios**.
3. **Comprueba que el panel Historial de Versiones se abre a la derecha.** La versión más reciente aparece bajo **Versión actual**. Desplázate hacia abajo para ver versiones anteriores, si tu tienda las tiene. Selecciona **Atrás** (la flecha izquierda junto al título del panel) para cerrarlo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsx1z1nuaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Selecciona la imagen para ampliarla. Las vistas de escritorio con anotaciones muestran dónde hacer clic. Abrir el historial no restaura ni publica nada. Si la tienda solo tiene una versión registrada, únicamente aparece **Versión actual**.
**En un teléfono:** abre **Tienda online**, toca **Más acciones** (**…**) junto al botón de publicación en la parte inferior y luego toca **Historial de versiones**.
Si no ves el control del historial, sal de **Modo Diseño** o vuelve primero a la vista previa más reciente. Espera a que termine la compilación inicial. La disponibilidad también puede depender de la experiencia de tienda online de tu espacio de trabajo.
### Ejemplo con una versión anterior
Compara las etiquetas antes de elegir una versión. Este ejemplo solo abre el historial; no restaura ni publica una versión.
## Controles del historial de versiones
| Control | Por qué lo usas | Qué sucede cuando lo seleccionas |
| --- | --- | --- |
| **Atrás** | Sal de la lista de versiones. | Runner regresa a la vista del escaparate. |
| Captura de pantalla de versión | Inspecciona la apariencia capturada. | La captura de pantalla se abre en un visor de imagen más grande cuando está disponible. |
| **Ver diff completo** | Ve un registro detallado de qué cambió. | Runner abre los detalles del cambio para esa versión en una pestaña nueva. |
| **Vista previa** / **Ver vista previa de esta versión** | Revisa una versión anterior lista sin restaurarla. | El escaparate cambia a una vista previa histórica temporal etiquetada como **Vista previa de v…**. La versión del proyecto más reciente y la tienda en vivo no cambian. |
| **Volver a lo más reciente** / **Volver a la versión actual** | Termina una vista previa histórica. | Runner recarga la versión del escaparate actual más reciente. |
| **Restaurar** | Reutiliza el contenido de una versión anterior. | Runner abre **¿Restaurar a v…?**. Confirmar crea una nueva versión más reciente con ese contenido; la versión seleccionada, las versiones más recientes y el historial permanecen. |
| **Más acciones** | Accede a acciones de tarjeta en diseños compactos. | Se abre un menú con las acciones disponibles para esa versión, como Vista previa, Restaurar o Ver diff completo. |
| **Publicar** en la versión actual | Comienza a publicar la versión más reciente. | Runner abre las comprobaciones de publicación. No publica una vista previa histórica directamente. |
## Lee las tarjetas de versión
| Etiqueta o estado | Significado |
| --- | --- |
| **Más reciente** o **Versión actual** | Esta es la versión del proyecto más reciente. |
| **Publicado** | Esta versión está asociada con una publicación completada. No prueba que el pago esté funcionando ahora. |
| **Compilando…** | Runner aún está creando la versión. La vista previa y la restauración pueden no estar disponibles. |
| **Compilación fallida** | Esta versión no alcanzó un estado listo. Usa su contexto de error para pedirle a Runner que lo corrija. |
| Recuentos de cambios de archivo | Un resumen de archivos agregados, cambiados o eliminados para esa versión. |
| Hora | Cuándo se registró la versión. |
| Descripción | El resumen registrado de la versión cuando está disponible. |
## Vista previa y restauración seguras
1. Selecciona **Vista previa** en la versión que deseas inspeccionar.
2. Confirma que la barra de herramientas diga **Vista previa de v…** para que no la confundas con la versión más reciente.
3. Verifica las páginas relevantes y los diseños de dispositivos.
4. Selecciona **Volver a lo más reciente** si solo necesitabas comparar.
5. Para recuperar el contenido anterior, selecciona **Restaurar**.
6. Lee la confirmación: Runner agregará una nueva versión y mantendrá el historial existente.
7. Confirma la restauración solo cuando Runner esté inactivo.
8. Confirma que aparece una nueva **Versión actual**, luego revisa el contenido restaurado en Vista previa antes de publicarlo. El historial más antiguo debería seguir disponible.
## Estados, límites y solución de problemas
| Lo que ves | Significado | Qué hacer |
| --- | --- | --- |
| **Cada cambio que hace Runner aparece aquí como una versión a la que puedes volver.** | Solo existe el estado inicial actual, o no hay historial disponible. | Continúa trabajando; regresa después de que Runner registre otra versión. |
| **Cargando historial de versiones…** | Runner está recuperando las tarjetas. | Mantén el panel abierto hasta que termine. |
| **No se pudieron cargar tus versiones; vuelve a intentarlo.** | La solicitud de lista falló. | Selecciona **Intentar de nuevo**. |
| **No se pudo cargar la vista previa de esta versión** | Esa vista previa histórica no pudo iniciarse. | Regresa a la versión actual e intenta otra versión lista. |
| La restauración está deshabilitada | Runner está activo o la versión no es restaurable. | Espera a que Runner termine o selecciona una versión lista. |
| **No se puede restaurar mientras el agente está trabajando** | Restaurar entraría en conflicto con la tarea activa. | Deja que la tarea alcance un estado terminal y luego reinténtalo. |
| El contenido restaurado no está en vivo | Restaurar creó una versión del proyecto, no una publicación. | Revísalo y luego selecciona **Publicar cambios**. |
## Guías relacionadas
- [Vista previa de tu tienda](./preview-your-store)
- [Publicar y republicar](./publish-and-republish)
- [Solucionar problemas de vista previa y publicación](./troubleshoot-preview-and-publishing)
---
# Casos de uso
Source: https://www.runnerai.com/docs/es/guides/use-cases
¿Nuevo en Runner? Sigue [Crear tu primera tienda](/es/guides/start-here/first-store-quickstart) primero, luego elige el resultado que necesitas a continuación.
## Explorar por objetivo
- [Tienda y publicación](/es/guides/storefront-and-publishing)
Obtén una vista previa, edita, versiona, publica y verifica tu tienda Runner.
- [Operaciones de Tienda](/es/guides/store-operations)
Configura y ejecuta el catálogo, pedidos, clientes, promociones, abastecimiento y reseñas de tu tienda.
- [Aplicaciones e integraciones](/es/guides/apps-and-integrations)
Encuentra, conecta y gestiona los servicios que tu tienda de Runner y Agente pueden usar.
- [Analytics y SEO](/es/guides/analytics-and-seo)
Lee el rendimiento de la tienda, diagnostica la conversión y mejora cómo las personas y las herramientas de búsqueda de IA encuentran tu tienda.
- [Automatizar, probar y crear](/es/guides/automate-test-and-create)
Usa las herramientas condicionales de Runner para trabajo recurrente, pruebas de compradores, experimentos, generación de medios y publicidad.
- [Personalización del Agente](/es/guides/agent)
Añade Habilidades reutilizables y Memoria confiable para que Runner pueda trabajar de una manera que se ajuste a tu tienda.
---
# Trabaja con Runner
Source: https://www.runnerai.com/docs/es/guides/work-with-runner
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Sabrás dónde comenzar una solicitud, cómo guiar el trabajo y dónde revisar el resultado.
Usa esta sección después de haber abierto un proyecto de tienda. Runner mantiene juntos la solicitud, el progreso,
la vista previa y las herramientas de proyecto relacionadas para que puedas pasar de una idea a un resultado revisable.
**Ruta de entrada:** Abre la tienda deseada desde el menú del nombre de la tienda → abre su tarea actual o selecciona **Nueva tarea**.
## El bucle diario
1. Abre la tienda que quieres cambiar.
2. Inicia una **Nueva tarea** cuando el trabajo necesita una conversación separada.
3. Describe un resultado claro en el cuadro de mensaje.
4. Añade una imagen de referencia, elige un perfil o añade una habilidad cuando ayude.
5. Selecciona **Enviar mensaje** y sigue el estado de la tarea.
6. Responde cualquier pregunta que Runner haga para que pueda continuar con la opción correcta.
7. Abre **Detalles**, la vista previa u otra pestaña del lienzo de trabajo para revisar el resultado.
8. Envía un seguimiento enfocado si algo necesita ajuste. Termina verificando que la acción solicitada por el cliente funcione en la página o herramienta resultante.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Cuando una tarea necesita tu decisión, responde a su tarjeta activa antes de esperar más trabajo. La [guía de preguntas](/es/guides/work-with-runner/answer-runner-questions) incluye la grabación correspondiente.
## Elige una guía
| Qué quieres hacer | Guía |
| --- | --- |
| Comienza una solicitud y entiende el compositor | [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner) |
| Reabre, renombra o elimina una conversación | [Chats e historial](/es/guides/work-with-runner/chats-and-history) |
| Encuentra una herramienta de proyecto o chat reciente | [Navegación y búsqueda del proyecto](/es/guides/work-with-runner/project-navigation-and-search) |
| Dale a Runner una dirección más clara | [Escribe solicitudes efectivas](/es/guides/work-with-runner/write-effective-requests) |
| Añade contexto o cambia cómo Runner aborda una tarea | [Imágenes, modelos y habilidades](/es/guides/work-with-runner/attachments-profiles-and-skills) |
| Responde cuando Runner necesita una decisión | [Cuando Runner hace una pregunta](/es/guides/work-with-runner/answer-runner-questions) |
| Entiende el progreso e inspecciona el trabajo completado | [Estados de tareas y detalles](/es/guides/work-with-runner/task-states-and-details) |
| Añade rápidamente una habilidad o memoria | [Paleta de comandos del Agente](/es/guides/agent/command-palette) |
## Antes de empezar
- Debes estar conectado y tener acceso a un proyecto de tienda.
- Un chat recién creado está en blanco hasta que envíes un mensaje.
- Algunas herramientas, perfiles, habilidades y destinos de navegación son condicionales. Runner muestra solo
lo que está disponible para la cuenta y proyecto actual.
- La publicación, facturación y acciones destructivas requieren sus propias rutas de confirmación. Una tarea de chat completada
no significa por sí sola que una tienda fue publicada o que ocurrió una acción externa.
## Guías relacionadas
- [Construye tu primera tienda](/es/guides/start-here/first-store-quickstart)
- [Gestiona tiendas](/es/guides/workspace/manage-stores)
- [Entiende los estados de las tiendas](/es/guides/workspace/store-statuses)
---
# Cuando Runner hace una pregunta
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/answer-runner-questions
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Responderás o saltarás intencionalmente las preguntas de Runner sin perder el contexto de la tarea.
Runner hace una pregunta cuando tu decisión puede cambiar materialmente el resultado. Las preguntas pueden usar una opción única, opciones múltiples o una respuesta de forma libre.
**Ruta de acceso:** Abre una conversación cuyo estado de tarea está esperando entrada → tarjeta de pregunta.
## Antes de empezar
- Responde la pregunta activa más reciente; las tarjetas más antiguas pueden ser de solo lectura.
- Revisa cuidadosamente el efecto cuando una opción implica acceso, dinero, publicación, datos de clientes o un servicio externo.
- Usa **Omitir** solo cuando Runner pueda elegir de forma segura sin tu preferencia.
## Controles de preguntas
| Control o estado | Qué sucede |
| --- | --- |
| Opción de elección única | Selecciona la respuesta y puede avanzar a la siguiente pregunta. La elección final puede enviar las respuestas automáticamente. |
| Opciones de opción múltiple | Te permite seleccionar más de una respuesta permitida. |
| **Otro…** | Abre un campo para una respuesta que no está en la lista. |
| Acción de enviar o continuar, cuando se muestra | Avanza la tarjeta o envía las respuestas completadas. |
| **Omitir**, cuando se ofrece | Indica a Runner que proceda usando su mejor criterio. |
| Tarjeta deshabilitada | La tarea está ocupada, expirada, detenida, o la pregunta ya no puede aceptar una respuesta. |
## Responde una pregunta
1. Lee la pregunta y cualquier explicación encima de las opciones.
2. Lee cada opción antes de seleccionarla: una sola opción puede avanzar inmediatamente, y la respuesta final puede enviarse automáticamente.
3. Selecciona la opción u opciones que coincidan con tu intención.
4. Elige **Otro…** e ingresa una respuesta concisa cuando ninguna de las opciones enumeradas se ajuste.
5. Usa la acción de continuar o enviar solo si la tarjeta muestra una.
6. Espera mientras Runner entrega las respuestas.
7. Confirma que Runner reanuda la tarea y registra tu respuesta en la conversación.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Lee cada opción antes de seleccionarla; la respuesta final puede enviarse automáticamente.
### Ver: responder preguntas de seguimiento
El ejemplo selecciona un precio de vela y una dirección de fotografía. **Respondido** confirma las elecciones, luego Runner reanuda la tarea.
## Salta cuando Runner pueda decidir
1. Lee lo que Runner está preguntando.
2. Si la tarjeta ofrece **Omitir**, selecciónalo solo cuando te sientas cómodo con que Runner use su mejor criterio.
3. Observa que la tarea se reanude.
4. Revisa el resultado de cerca, porque no proporcionaste la preferencia faltante.
Saltar es útil para opciones de presentación de bajo riesgo. Da una respuesta explícita cuando la decisión afecta el acceso, dinero, publicación, datos de clientes o una acción destructiva.
## Solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| Esperando entrada | Runner no puede continuar con confianza sin una respuesta. | Responde o salta intencionalmente la pregunta activa. |
| La pregunta anterior es de solo lectura | Un mensaje más nuevo o estado de tarea la ha reemplazado. | Responde la pregunta activa más reciente en su lugar. |
| **El usuario interrumpió esta pregunta** | La tarea se detuvo antes de que se completara la pregunta. | Inicia un nuevo mensaje de seguimiento si aún deseas que Runner continúe. |
| El envío no está disponible | Una o más respuestas requeridas están incompletas, o la tarjeta ya no está activa. | Completa cada pregunta actual o muévete a la tarjeta de pregunta más reciente. |
| Error de respuesta | Runner no pudo aceptar la respuesta. | La tarjeta puede volver a su estado sin responder. Mantén la conversación abierta, verifica el estado más reciente de la tarea y responde nuevamente solo cuando la tarjeta acepte la entrada. |
## Guías relacionadas
- [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner)
- [Escribe solicitudes efectivas](/es/guides/work-with-runner/write-effective-requests)
- [Estados de tareas y detalles](/es/guides/work-with-runner/task-states-and-details)
---
# Adjuntos, Modelos y Habilidades
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/attachments-profiles-and-skills
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Le darás a Runner el contexto correcto y las herramientas adecuadas antes de enviar una solicitud.
Las imágenes le muestran a Runner lo que quieres decir. Los modelos y las habilidades cambian las capacidades disponibles para
la siguiente solicitud. Cuando aparece **Adjuntar**, también puedes proporcionar a Runner documentos soportados como contexto. Úsalos deliberadamente; una solicitud clara sigue siendo la entrada más importante.
**Ruta de entrada:** Abre un proyecto de tienda → compositor de conversación.
## Antes de empezar
- Usa solo imágenes que estés autorizado a compartir con el espacio de trabajo actual.
- Elimina secretos, datos de pago e información innecesaria del cliente.
- Verifica el acceso al plan y navegador cuando falte un modelo, Habilidad o acción de captura de pantalla.
## Controles del compositor
| Control | Qué sucede cuando lo seleccionas |
| --- | --- |
| **Añadir** | En escritorio, abre **Subir imagen** o **Adjuntar** cuando los adjuntos de documentos están habilitados, además de **Tomar captura de pantalla** cuando se soporta. |
| **Adjuntar**, cuando se ofrece | Abre el selector para documentos e imágenes soportados. |
| **Subir imagen** | Abre el selector de imágenes para archivos JPG/JPEG, PNG, GIF, WebP, BMP o TIFF. |
| **Desde la biblioteca de medios**, cuando se ofrece | Abre los medios del proyecto existente para que puedas elegir una referencia para el borrador. |
| **Tomar captura de pantalla** | Inicia la captura de pantalla cuando el navegador y la cuenta lo permiten. El navegador puede solicitar permiso. |
| **Imagen** en móvil | Abre el selector de imágenes móviles. Un flujo de adjuntos de documentos habilitado muestra **Adjuntar** en su lugar. |
| Selector de modelo | Enumera los modelos de Runner disponibles para la cuenta. Un modelo bloqueado abre la ruta **Plan y Facturación** correspondiente en lugar de seleccionarlo. |
| **Comandos rápidos** o **Habilidades** | Abre los atajos disponibles que se pueden añadir a la solicitud. |
| **Más acciones** | Revela herramientas del compositor que no caben en el diseño actual. |
En el selector solo de imágenes, Runner ignora una imagen con el mismo nombre y tamaño que una ya en el borrador y muestra
**Imagen duplicada ignorada**. Los archivos no compatibles se ignoran con **Usa una imagen JPG, PNG, GIF, WebP, BMP
o imagen TIFF**. En una selección mixta, las imágenes soportadas permanecen disponibles. Runner acepta hasta 10 adjuntos por mensaje. Las imágenes pueden tener hasta 32 MB cada una. Cuando los adjuntos de documentos están habilitados, los documentos pueden tener hasta 10 MB cada uno.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Este espacio de trabajo tiene habilitados los adjuntos de documentos, por lo que el menú muestra **Adjuntar**. Abrir el menú no sube un archivo ni envía la solicitud.
## Añadir una imagen
1. Redacta lo suficiente de la solicitud para explicar por qué el archivo es importante.
2. Selecciona **Añadir** en escritorio, o el botón de carga en móvil.
3. Elige **Subir imagen**, **Imagen** o **Tomar captura de pantalla**, según lo que se muestre.
4. Elige o captura la imagen relevante.
5. Confirma que la miniatura de imagen correcta aparece con el borrador y que cualquier progreso de carga ha terminado.
6. Elimínala antes de enviar si es la referencia incorrecta.
7. Selecciona **Enviar mensaje**.
Si la captura de pantalla no está disponible o se deniega el permiso, toma una captura de pantalla con tu dispositivo y
carga la imagen guardada en su lugar.
## Adjuntar un documento cuando esté disponible
1. Abre **Añadir** y selecciona **Adjuntar**. Si solo aparece **Subir imagen** o **Imagen**, este espacio de trabajo no soporta documentos en este compositor.
2. Elige un archivo soportado, como un PDF, documento de Word, presentación, hoja de cálculo o CSV.
3. Confirma que el adjunto aparece junto a tu borrador.
4. Indica a Runner qué usar de él, por ejemplo “Usa los nombres y descripciones de productos en este CSV para redactar la copia de la colección; no cambies los precios.”
5. Selecciona **Enviar mensaje** y espera a que termine la preparación del documento.
6. Verifica que la respuesta de Runner refleje el documento deseado antes de pedir un cambio de tienda.
Si el archivo no se puede leer, sigue el error mostrado. Los documentos protegidos con contraseña, dañados, demasiado complejos o vacíos pueden fallar. Usa una exportación más pequeña y desbloqueada o pega el texto relevante; mantén tu borrador hasta que se acepte el reemplazo. Los videos no son soportados por este flujo de adjuntos.
## Elige un modelo
1. Selecciona el modelo actual en el compositor.
2. Revisa los modelos que Runner pone a disposición. La interfaz grabada muestra **Runner 2.0 Pro**; usa la etiqueta en tu propio selector porque los perfiles disponibles pueden cambiar.
3. Elige el modelo que coincida con la tarea.
4. Confirma que el modelo seleccionado se muestra antes de enviar.
Si un modelo está bloqueado, mantén el modelo actual o sigue la información del plan que Runner abre. Una
elección bloqueada no se aplica al borrador.
## Añadir una habilidad
1. Abre los **Comandos rápidos** o el control de **Habilidades** del compositor cuando se muestre.
2. Busca u hojea la capacidad que necesitas.
3. Selecciona una habilidad disponible para esta solicitud. **Comandos rápidos** puede colocar su comando de barra en el compositor, como `/store-seo`; seleccionarlo no ejecuta el comando.
4. Regresa al compositor y confirma que la habilidad o comando de barra deseado esté presente. Añade las instrucciones específicas de la tarea antes de enviar.
5. Envía la solicitud.
La [paleta de comandos del Agente](../agent/command-palette) separada gestiona el estado de las capacidades: elegir una fila puede instalar, activar o pausar una Habilidad. No es lo mismo que seleccionar una Habilidad en el compositor.
Cuando el plan actual no incluye una habilidad, Runner puede abrir la ruta del **Agente** o de actualización
en su lugar. Las opciones de memoria aparecen solo cuando la memoria está habilitada para la cuenta.
Seleccionar un comando prepara el borrador. Añade tu solicitud y revísala antes de enviar.
### Ver: preparar un comando rápido
La grabación selecciona **store-seo** en el compositor y lo deja sin enviar. No se inicia ningún análisis SEO.
## Solución de problemas
| Problema | Qué hacer |
| --- | --- |
| La imagen no se añade | Usa un formato de imagen compatible, mantenlo por debajo de 32 MB y mantén el mensaje en 10 imágenes o menos. |
| **Imagen duplicada ignorada** | La misma imagen con el mismo nombre y tamaño ya está en el borrador. Mantén la copia existente o elimínala antes de seleccionar la imagen de nuevo. |
| Advertencia de archivo no compatible | Elige una imagen JPG/JPEG, PNG, GIF, WebP, BMP o TIFF. Si **Adjuntar** está disponible, elige un documento compatible en su lugar. De lo contrario, usa una imagen o pega el texto relevante. |
| **Tomar captura de pantalla** falta | Usa una imagen guardada; la captura en vivo es condicional. |
| La captura de pantalla se detiene | Permite el permiso del navegador cuando sea apropiado, o adjunta una captura de pantalla normal. |
| Una habilidad no se activa/desactiva | Termina cualquier acción del compositor en conflicto y confirma que el plan incluye la habilidad. |
| Un modelo bloqueado abre facturación | Cierra la pantalla del plan para mantener el modelo actual, o revisa el acceso con el propietario del espacio de trabajo. |
## Guías relacionadas
- [Escribe solicitudes efectivas](/es/guides/work-with-runner/write-effective-requests)
- [Paleta de comandos del Agente](../agent/command-palette)
- [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner)
- [Configuración del espacio de trabajo](/es/guides/workspace/settings)
---
# Chatea con Runner
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/chat-with-runner
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Enviarás una solicitud enfocada en el proyecto de tienda correcto y sabrás qué hace cada control de chat.
El chat es el lugar principal para pedirle a Runner que construya, cambie, inspeccione o explique algo sobre tu
tienda. Mantén un resultado principal en cada solicitud para que el resultado sea más fácil de revisar.
**Ruta de entrada:** Abre la tienda deseada desde el menú del nombre de la tienda → usa la tarea actual, o selecciona **Nueva tarea** en la barra lateral.
## Antes de empezar
- Confirma la tienda y la conversación antes de enviar una solicitud.
- Mantén un resultado principal en el borrador y elimina secretos o datos innecesarios del cliente.
- Espera a que termine una acción de compositor en conflicto antes de seleccionar **Enviar mensaje**.
## Controles de chat
| Control | Por qué es útil | Qué sucede cuando lo seleccionas |
| --- | --- | --- |
| **Nueva tarea** | Separa una nueva tarea de la discusión anterior. | Runner crea y abre una conversación en blanco. No se inicia ningún trabajo hasta que envíes un mensaje. |
| Cuadro de mensaje | Contiene la solicitud y cualquier instrucción de seguimiento. | Tu texto permanece como borrador hasta que lo envíes. |
| **Añadir** | Proporciona contexto visual a Runner. | Abre **Subir imagen** o, cuando los adjuntos de documentos están habilitados, **Adjuntar**. **Tomar captura de pantalla** es condicional. En móvil, el selector solo de imágenes está etiquetado como **Imagen**. Consulta la guía de adjuntos para formatos y límites soportados. |
| Selector de perfil | Cambia el perfil de trabajo de Runner disponible. | El perfil seleccionado se usa para la siguiente solicitud; las opciones bloqueadas abren la ruta del plan correspondiente. |
| **Entrada de voz** | Convierte el habla en texto de borrador. | Solicita acceso al micrófono, muestra **Escuchando…**, luego **Procesando…**, y añade la transcripción al borrador actual. No envía la solicitud. |
| **Más acciones** | Mantiene las herramientas menos frecuentes disponibles en diseños más pequeños. | Abre acciones como **Entrada de voz** o **Mejorar prompt** cuando no caben en la barra de herramientas. |
| **Enviar mensaje** | Inicia la solicitud. | Tu mensaje se añade a la conversación y la tarea comienza. |
| **Detener** | Interrumpe una tarea en ejecución. | Runner detiene el turno actual y preserva la conversación para que puedas revisar o continuar más tarde. |
| **Útil** / **No es útil** | Envía comentarios sobre una respuesta de Runner. | Abre comentarios editables. **No es útil** requiere un motivo o una descripción. No se guarda nada hasta **Enviar**; compartir el contexto de la conversación es opcional. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Usa **Añadir** cuando la solicitud necesita una referencia. El menú mostrado está abierto antes de que se suba cualquier archivo o se envíe un mensaje.
## Envía una solicitud
1. Confirma que el nombre del proyecto en la barra lateral o encabezado es la tienda que tienes la intención de cambiar.
2. Elige **Nueva tarea** si la solicitud es independiente de la conversación actual.
3. Ingresa el resultado que deseas en el cuadro de mensaje.
4. Añade contexto importante, restricciones e imágenes de referencia.
5. Selecciona un perfil o habilidad solo cuando ayude a esta tarea.
6. Selecciona **Enviar mensaje**.
7. Mantén la conversación abierta mientras Runner trabaja, o vuelve a ella desde **Chats recientes** más tarde.
8. Si Runner hace una pregunta, respóndela para que la tarea continúe.
9. Cuando la tarea termine, abre la página o herramienta afectada y verifica el resultado que solicitaste. Un mensaje final por sí solo no verifica el resultado.
## Redacta con entrada de voz
1. Selecciona **Entrada de voz**. Si el navegador lo solicita, permite el acceso al micrófono solo en un dispositivo de confianza.
2. Espera a **Escuchando…**, luego habla una instrucción enfocada.
3. Selecciona **Detener entrada de voz** cuando termines.
4. Mantén el compositor abierto mientras Runner muestra **Procesando…**.
5. Revisa el texto añadido al borrador. Runner lo añade después del texto que ya estaba presente.
6. Corrige nombres, números, URLs y detalles del producto antes de seleccionar **Enviar mensaje**.
La entrada de voz prepara solo texto. No se inicia ninguna solicitud hasta que selecciones **Enviar mensaje**.
## Mientras Runner está trabajando
- Una tarea en ejecución muestra progreso activo en la conversación.
- **Detalles** abre el registro de tareas paso a paso cuando está disponible.
- **Detener** está disponible durante el trabajo que se puede interrumpir.
- La vista previa u otras pestañas del lienzo pueden actualizarse mientras Runner produce resultados.
- Una tarea esperando entrada necesita tu respuesta antes de que Runner pueda proceder con confianza.
## Solución de problemas
| Qué ves | Qué significa | Qué hacer |
| --- | --- | --- |
| **Enviar mensaje** no está disponible | El borrador está vacío, falta entrada requerida, o se está preparando otra acción. | Añade una solicitud clara y espera a que termine la acción actual del compositor. |
| Un perfil está bloqueado | No está incluido en el plan actual o acceso a la cuenta. | Mantén el perfil actual o sigue la ruta **Plan y Facturación** que Runner abre. |
| **Entrada de voz no disponible** | El navegador o dispositivo no puede grabar a través de este control. | Escribe la solicitud o usa un navegador y dispositivo compatible. |
| Permiso de micrófono denegado | El navegador bloqueó la grabación. | Permite el acceso solo si es apropiado, luego comienza la entrada de voz de nuevo; de lo contrario, escribe la solicitud. |
| **No se detectó habla** o la transcripción falló | Runner no añadió texto utilizable al borrador. | Mantén el borrador existente, verifica el micrófono e intenta de nuevo una vez o escribe el texto faltante. |
| La tarea está esperando | Runner necesita una decisión o más información. | Responde a la pregunta visible, o elige **Omitir**, cuando se ofrezca, si Runner debe usar su mejor juicio. |
| La tarea falló | Runner no pudo completar el turno. | Lee el error y **Detalles**, luego usa **Intentar de nuevo** cuando se ofrezca o envía una solicitud más estrecha. |
| Abriste la tienda incorrecta | La conversación pertenece a otro proyecto. | Vuelve al espacio de trabajo, abre la tienda deseada y comienza la solicitud allí. |
## Guías relacionadas
- [Escribe solicitudes efectivas](/es/guides/work-with-runner/write-effective-requests)
- [Imágenes, modelos y habilidades](/es/guides/work-with-runner/attachments-profiles-and-skills)
- [Cuando Runner hace una pregunta](/es/guides/work-with-runner/answer-runner-questions)
- [Estados de tareas y detalles](/es/guides/work-with-runner/task-states-and-details)
---
# Chats e Historial
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/chats-and-history
**Qué cubre esta guía:** Mantendrás las conversaciones del proyecto organizadas y reabrirás el contexto correcto cuando lo necesites.
Cada tienda tiene su propio historial de conversación. Usa chats separados para resultados distintos y mantén el trabajo de seguimiento en el mismo chat cuando dependa de decisiones anteriores.
**Ruta de entrada:** Abre una tienda → expande su historial de tareas en la barra lateral. Dependiendo del espacio de trabajo, la lista puede estar etiquetada como **Tareas de tienda** o **Chats recientes**. Buscar mantiene el encabezado de resultado **Chats recientes**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Busca en tu tienda; 2. Inicia una tarea nueva; 3. Abre una herramienta del espacio de trabajo; 4. Vuelve a abrir una tarea guardada. Selecciona la imagen para ampliarla. Las indicaciones numeradas corresponden a la interfaz de escritorio en inglés.
## Antes de empezar
- Confirma la tienda actual porque cada proyecto tiene su propio historial de conversación.
- Deja que una acción de renombramiento o tarea activa termine antes de cambiar conversaciones.
- Mantén un chat cuando no estés seguro; la eliminación elimina el contexto y requiere confirmación.
## Controles de conversación
| Control o estado | Qué sucede |
| --- | --- |
| **Nueva tarea** | Abre una conversación en blanco. No inicia una tarea hasta que envíes un mensaje. |
| Una fila en el historial de tareas de la tienda | Abre esa conversación y su historial de tareas guardado. |
| Indicador de actividad | Indica que la conversación actualmente tiene trabajo en progreso. |
| Punto inactivo | Indica que la conversación no está ejecutándose actualmente. |
| Opciones de chat → **Cambiar nombre** | Abre un diálogo donde puedes ingresar y guardar un nombre de chat más claro. |
| Opciones de chat → **Eliminar** | Abre una confirmación antes de que se elimine la conversación. |
## Inicia o reabre un chat
1. Abre el proyecto de tienda correcto.
2. Expande la barra lateral y abre la lista de tareas de la tienda cuando se muestre.
3. Elige **Nueva tarea** para una tarea no relacionada, o selecciona un chat existente para continuar su contexto.
4. Revisa el título de la conversación y los últimos mensajes antes de enviar nuevas instrucciones.
5. Confirma que los mensajes reabiertos pertenecen a la tarea deseada. Ingresa la siguiente solicitud y selecciona **Enviar mensaje**.
## Renombra un chat
1. Encuentra la conversación en el historial de tareas de la tienda actual.
2. Abre su menú de opciones.
3. Elige **Cambiar nombre**.
4. Ingresa un nombre que describa el resultado, como "Update summer collection homepage".
5. Guarda el cambio. El nuevo nombre aparece en la lista de chats recientes.
## Elimina un chat con cuidado
1. Abre el menú de opciones de la conversación.
2. Elige **Eliminar**.
3. Lee la confirmación y verifica el nombre del chat.
4. Cancela si aún necesitas sus instrucciones o resultados. Confirma solo cuando tengas la intención de eliminarlo.
## Solución de problemas
| Estado | Qué hacer |
| --- | --- |
| El historial de tareas está vacío o ausente | Envía una solicitud en un nuevo chat. La sección aparece cuando el proyecto tiene historial de conversaciones. |
| Un chat en ejecución no se abre instantáneamente | Espera a que la navegación termine; Runner puede proteger el trabajo inacabado antes de cambiar vistas. |
| No puedes encontrar un chat escaneando la lista | Abre la búsqueda del proyecto con `Command/Control + K` y busca **Chats recientes**. |
| Un título renombrado no se actualizó | Reabre la lista de chats e intenta el renombramiento una vez más después de que la tarea actual se estabilice. |
| No estás seguro de si debes eliminar | Mantén el chat. Renombrarlo es la forma más segura de reducir la confusión. |
## Guías relacionadas
- [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner)
- [Navegación y búsqueda de proyectos](/es/guides/work-with-runner/project-navigation-and-search)
- [Estados de tareas y detalles](/es/guides/work-with-runner/task-states-and-details)
---
# Navegación y búsqueda de proyectos
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/project-navigation-and-search
Las capturas y grabaciones muestran la interfaz en inglés.
La barra lateral agrupa herramientas según el trabajo que deseas realizar. Buscar encuentra un destino disponible o una conversación en la tienda actual.
**Ruta de entrada:** Abre la tienda deseada → expande la barra lateral → **Crear**, **Crecer**, **Medir** o **Buscar**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Busca en tu tienda; 2. Inicia una tarea nueva; 3. Abre una herramienta del espacio de trabajo; 4. Vuelve a abrir una tarea guardada. Selecciona la imagen para ampliarla. Las indicaciones numeradas corresponden a la interfaz de escritorio en inglés.
## Antes de empezar
- Confirma el nombre de la tienda antes de navegar o iniciar una tarea.
- Guarda una copia de un borrador no enviado antes de salir de su conversación.
- La disponibilidad de herramientas varía según el tipo de tienda, plan, rol y características habilitadas. Una entrada visible aún puede abrir una pantalla de requisito previo o plan.
## Encuentra un destino
| Área | Los destinos disponibles pueden incluir | Úsalo para |
| --- | --- | --- |
| **Tienda online** | Vista previa, edición, historial de versiones, publicación | Revisar y actualizar lo que ven los clientes. |
| **Crear** | **Operaciones de la tienda**, **Dropshipping**, **Impresión bajo demanda**, **Apps**, **Webhooks** | Configurar la tienda, el catálogo y las conexiones. |
| **Crecer** | **Anuncios**, **SEO**, **Correo**, **Automatizaciones**, **Estudio**, **Biblioteca** | Crear y gestionar trabajo de crecimiento y medios reutilizables. |
| **Medir** | **Análisis**, **Experimentos**, **Simulación**, **Investigación** | Revisar el rendimiento o investigar una pregunta de negocio. |
| **Agente** | **Habilidades**, **Memoria** cuando está habilitado | Gestionar instrucciones reutilizables y hechos retenidos. |
| **Fly**, cuando se muestra | Misiones de negocio guiadas | Sigue el flujo de trabajo de la misión disponible. |
1. Expande el grupo que coincide con tu objetivo.
2. Selecciona el destino.
3. Confirma su encabezado de página y la tienda actual.
4. Sigue cualquier mensaje de configuración o plan antes de intentar la función.
Por ejemplo, **Dropshipping** puede abrir una experiencia de abastecimiento dedicada o la sección relacionada de Operaciones de la tienda, dependiendo de la tienda. Sigue la página que realmente ves. La navegación agrupada reemplaza el antiguo menú de desbordamiento **Más**.
## Buscar destinos y tareas
**Atajo:** `Command + K` en macOS o `Control + K` en Windows y Linux.
1. Selecciona **Buscar** o usa el atajo.
2. Ingresa parte de un título de destino o tarea.
3. Revisa los resultados bajo **Centro de control** y **Chats recientes**.
4. Selecciona un resultado de **Centro de control** para abrir una herramienta, o un resultado de **Chats recientes** para reabrir una conversación.
5. Confirma que la página o los mensajes deseados sean visibles antes de continuar.
6. Presiona `Escape` para cerrar Buscar sin navegar.
El encabezado **Centro de control** pertenece a los resultados de Buscar; no es un área de barra lateral separada que necesites encontrar.
## Cambiar a otra tienda
1. Abre el menú del nombre de la tienda actual en la parte superior de la barra lateral.
2. Selecciona la tienda deseada.
3. Confirma el nuevo nombre de la tienda después de la navegación.
El menú también ofrece **Crear tienda** y **Configuración del espacio de trabajo**. No muestra una vista previa de la lista de tiendas de otro espacio de trabajo. Consulta [Navegación del Espacio de Trabajo](/es/guides/workspace/navigation-and-search) para configuraciones y navegación de cuenta.
Buscar muestra los destinos disponibles bajo **Centro de control**. Selecciona un resultado para navegar, o presiona Escape para mantener la página actual.
### Ver: filtrar búsqueda de navegación
La grabación escribe **Análisis** e inspecciona el destino coincidente. Se detiene antes de abrir el resultado; selecciona un resultado tú mismo para navegar.
## Solución de problemas
| Lo que ves | Qué hacer |
| --- | --- |
| Cargando resultados | Espera a que Buscar termine de cargar antes de seleccionar una fila. |
| **Sin resultados** | Acorta la consulta o usa el nombre visible de la herramienta. Borra la consulta para inspeccionar los resultados disponibles. |
| **Búsqueda fallida** | Selecciona **Intentar de nuevo** cuando se muestre. |
| La herramienta está ausente de su grupo | Verifica Buscar, luego lee los requisitos previos de esa función. La disponibilidad puede diferir según la tienda. |
| La navegación se detiene | Mantén la tarea abierta y sigue cualquier mensaje sobre trabajo sin terminar. |
| Se abre un selector de Habilidades en su lugar | Ciérralo y usa la barra lateral **Buscar**. El [paleta de comandos del Agente](/es/guides/agent/command-palette) gestiona capacidades en lugar de navegación. |
## Guías relacionadas
- [Chats e historial](/es/guides/work-with-runner/chats-and-history)
- [Navegación y búsqueda del espacio de trabajo](/es/guides/workspace/navigation-and-search)
- [Paleta de comandos del Agente](/es/guides/agent/command-palette)
- [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner)
---
# Estados de Tareas y Detalles
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/task-states-and-details
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Sabrás si una tarea está funcionando, esperando, terminada, interrumpida o necesita otro intento.
Los estados de tareas te dicen qué necesita Runner a continuación. La vista de detalles y el lienzo del proyecto te ayudan a revisar
el trabajo sin adivinar solo desde el último mensaje de chat.
**Ruta de entrada:** Abre un proyecto de tienda → selecciona una conversación → inspecciona la tarjeta de tarea actual y
elige **Detalles** cuando esté disponible.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgDROEIVBmoeRbFHcSPrynU5Il76xY2q981Nj4)
1. Comprueba el estado de la tarea. 2. Selecciona Detalles para revisar el trabajo. Esta tarjeta de ejemplo muestra una tarea completada; eso por sí solo no demuestra que la tienda esté publicada ni que el pago funcione. Selecciona la imagen para ampliarla.
## Antes de empezar
- Confirma la conversación actual y la tarea más reciente antes de actuar sobre un estado.
- Mantén el error visible o la pregunta de espera disponible hasta que la recuperación tenga éxito.
- No trates una tarea completada como prueba de que la vista previa, la publicación o un proveedor externo tuvieron éxito.
## Estados de tareas
| Estado | Significado | Qué hacer a continuación |
| --- | --- | --- |
| En ejecución | Runner está trabajando activamente en la solicitud. | Sigue el progreso, abre **Detalles**, o elige **Detener** si la tarea no debe continuar. |
| Esperando entrada | Runner necesita tu elección o información faltante. | Responde la pregunta activa o elige **Omitir**, cuando se ofrezca, para que Runner pueda usar su mejor juicio. |
| Completada | Runner terminó el turno actual. | Revisa el mensaje, los detalles, la vista previa y cualquier área del proyecto que haya cambiado. |
| Falló | Runner no pudo terminar el turno. | Lee el error y detalles, luego elige **Intentar de nuevo** cuando se ofrezca o envía una solicitud más estrecha. |
| Detenida | Tú o Runner interrumpieron el turno. | Revisa el trabajo parcial, luego envía una nueva instrucción si la tarea debe continuar. |
Una tarea completada significa que el turno de conversación terminó exitosamente. No prueba por sí sola
que una tienda fue publicada, que ocurrió un pago o que un servicio externo aceptó un cambio.
## Revisa el trabajo
1. Selecciona **Detalles** en la tarea.
2. Sigue las entradas paso a paso para entender qué intentó Runner.
3. Abre **Uso** cuando se muestre para revisar los créditos mostrados, llamadas de herramientas y actividad del agente.
4. Revisa el plan de trabajo cuando la tarea incluya uno.
5. Usa **Vista previa** o **Tienda** para inspeccionar el resultado visible para el cliente.
6. Abre otras pestañas del lienzo relevantes, como un archivo o resultado que Runner mostró.
7. Usa **Añadir pestaña** para abrir otra vista disponible, y **Cerrar pestaña** para eliminar una vista del lienzo.
8. Revisa **Historial de versiones** cuando necesites comparar o ubicar un estado de proyecto anterior.
9. Compara la página o resultado de herramienta real con el resultado solicitado. Envía un seguimiento enfocado que nombre cualquier problema restante.
Solo abre las vistas de tareas que Runner realmente ofrece. Los detalles disponibles y las vistas de lienzo varían con la solicitud.
## Revisa una versión de tienda desde una tarjeta de trabajo completada
> **Condicional:** Las etiquetas de versión y las vistas previas históricas requieren versiones de tienda guardadas y acceso a tarjetas de versión. Los proyectos más antiguos sin historial de versiones guardado aún pueden mostrar **Vista previa** en la tarjeta de trabajo de la tienda más reciente; esa acción abre la vista previa en vivo actual en lugar de una versión histórica exacta. Si no aparece ninguna acción de tarjeta de trabajo, abre [Vista previa](/es/guides/storefront-and-publishing/preview-your-store) directamente.
| Control o estado | Qué significa o hace |
| --- | --- |
| **v…** | Identifica la versión de tienda mostrada en la tarjeta de trabajo completada. |
| **Versión actual** | Marca la versión más reciente del proyecto. |
| **Publicada** | Marca una versión asociada con una publicación completada; no prueba que el checkout aún funcione. |
| **Construyendo…** | La versión aún no está lista para la vista previa. |
| **Construcción fallida** | La versión no pudo alcanzar un estado listo para la vista previa. Abre **Detalles** y mantén visible el contexto del fallo antes de pedirle a Runner que lo corrija. |
| Imagen de tienda o **Vista previa** | Abre la versión lista exacta cuando existen datos de versión. En la tarjeta más reciente de un proyecto más antiguo sin historial de versiones, abre la vista previa actual de la tienda. Las tarjetas antiguas sin coincidencia no muestran **Vista previa**. |
| **Publicar** | Aparece solo para una versión actual no publicada y abre comprobaciones de publicación. No se muestra para una versión histórica o ya publicada. |
| La información de versión se está actualizando | La imagen de tienda, **Vista previa** y **Publicar** de la versión actual permanecen en su lugar, pero están temporalmente deshabilitados. Seleccionarlos no hace nada hasta que la actualización termine. |
Usa la etiqueta de versión antes de juzgar una captura de pantalla o seleccionar **Publicar**. Una vista previa histórica lista sigue siendo de solo lectura hasta que restaures o publiques deliberadamente una versión actual mediante el flujo disponible.
Usa las etiquetas de versión para distinguir el resultado actual del trabajo anterior. Esta imagen muestra el Historial de versiones, no el panel de Detalles de la tarea, y no se restauró ni publicó ninguna versión.
## Controles de conversación
| Control | Qué sucede |
| --- | --- |
| **Detalles** / **Ocultar Detalles** | Abre el registro de tareas paso a paso en el lienzo, o devuelve el lienzo a **Tienda**. Ocultarlo no elimina el registro de tareas. |
| **Intentar de nuevo** | Comienza otro intento para una tarea fallida cuando la acción se ofrece. |
| **Ir al mensaje más reciente** | Mueve la conversación a la entrada más nueva. |
| Esquema de transcripción | Te permite moverte a una sección visible de un registro de tareas más largo. |
| **Vista previa** o **Tienda** | Abre la vista del trabajo del proyecto que ve el cliente. |
| **Añadir pestaña** | Abre la lista de vistas del lienzo disponibles para este proyecto y tarea. |
| **Cerrar pestaña** | Elimina la vista seleccionada del lienzo; no elimina el contenido del proyecto subyacente. |
## Si el progreso parece estancado
- Verifica si una pregunta sin respuesta está esperando más abajo en la conversación.
- Abre **Detalles** para identificar el último paso completado.
- Usa **Ir al mensaje más reciente** si la conversación se desplazó lejos del estado activo.
- No selecciones repetidamente **Intentar de nuevo** mientras otro intento ya está en ejecución.
- Si detienes una tarea, revisa los resultados parciales antes de pedirle a Runner que continúe.
## Guías relacionadas
- [Cuando Runner hace una pregunta](/es/guides/work-with-runner/answer-runner-questions)
- [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner)
- [Chats e historial](/es/guides/work-with-runner/chats-and-history)
- [Entiende los estados de las tiendas](/es/guides/workspace/store-statuses)
- [Historial de versiones](/es/guides/storefront-and-publishing/version-history)
---
# Escribe Solicitudes Efectivas
Source: https://www.runnerai.com/docs/es/guides/work-with-runner/write-effective-requests
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Escribirás solicitudes que sean más fáciles para Runner actuar y más fáciles para ti revisar.
Una solicitud útil describe el resultado, no solo el tema. Proporciona suficiente contexto para que la siguiente
decisión sea clara, luego usa mensajes de seguimiento para refinamientos enfocados.
**Ruta de entrada:** Abre una tienda → **Nueva tarea** o la tarea actual → cuadro de mensaje.
## Antes de empezar
- Confirma la tienda y la página o flujo de trabajo que quieres cambiar.
- Decide un resultado visible y cualquier límite que Runner debe preservar.
- Elimina contraseñas, secretos, detalles de pago e información innecesaria del cliente.
## Controles del compositor y resultados
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Más acciones** | Abre herramientas del compositor menos frecuentes cuando no caben en la barra de herramientas. |
| **Mejorar prompt** | Genera un borrador refinado; no envía la solicitud ni cambia la tienda. |
| **Aceptar** | Reemplaza el borrador del compositor con el refinamiento mostrado. |
| **Descartar** | Cierra el refinamiento y mantiene el borrador existente. |
| **Regenerate** | Solicita otra versión refinada. |
| **Volver al original** | Restaura la redacción anterior después de aceptar un refinamiento. |
| **Enviar mensaje** | Agrega el borrador final a la conversación y comienza la tarea. |
## Una estructura de solicitud simple
Incluye estas cinco partes cuando sean relevantes:
1. **Objetivo:** ¿Qué debería ser diferente cuando el trabajo esté hecho?
2. **Contexto de tienda:** ¿Qué vendes y quién es el cliente?
3. **Problema actual:** ¿Qué es confuso, falta o tiene bajo rendimiento ahora?
4. **Resultado deseado:** ¿Qué debería un cliente poder ver o hacer?
5. **Límites:** ¿Qué debe permanecer sin cambios y qué debe Runner verificar?
**Por ejemplo:**
> Actualiza el héroe de la página de inicio para nuestra tienda minimalista de bolsas de viaje. Haz que la colección de equipaje de mano sea el enfoque principal, mantén la navegación y datos de productos existentes, y haz que la acción principal lleve a esa colección. Verifica el resultado en móvil y escritorio antes de terminar.
## Envía una solicitud bien delimitada
1. Comienza con un resultado coherente.
2. Nombra la página, sección, producto o flujo de trabajo involucrado.
3. Describe la acción del cliente que quieres mejorar.
4. Añade una imagen de referencia cuando la apariencia o el contenido existente sea importante.
5. Establece cualquier cosa que Runner no debe cambiar.
6. Pide las comprobaciones que te importan, como diseño móvil o una ruta de clic específica.
7. Selecciona **Enviar mensaje**.
8. Revisa el resultado, luego envía una corrección enfocada a la vez.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Verifica el resultado con tu solicitud: el ejemplo pide un titular de mañana más lenta mientras mantiene el diseño y los productos. Esta imagen muestra la vista previa resultante, no el diálogo de **Mejorar prompt**.
## Usa Mejorar solicitud cuando esté disponible
1. Redacta la solicitud en el cuadro de mensaje.
2. Abre **Más acciones** si **Mejorar prompt** no es visible.
3. Selecciona **Mejorar prompt**.
4. Espera mientras el control muestra **Mejorando…**.
5. Revisa el **Prompt refinado**. Verifica que preserve la página prevista, la acción del cliente y cualquier cosa que hayas pedido a Runner que deje sin cambios.
6. Elige **Aceptar** para usarla, **Descartar** para mantener tu borrador, o **Regenerate** para otra versión.
7. Usa **Volver al original** si aceptaste el refinamiento y quieres tu redacción anterior de vuelta.
8. Selecciona **Enviar mensaje** solo después de que la solicitud aún coincida con tu intención.
## Evita solicitudes ambiguas
| En lugar de | Intenta |
| --- | --- |
| "Hazlo mejor." | "Haz que las tarjetas de colección sean más fáciles de escanear en móvil, mientras mantienes sus enlaces de producto actuales." |
| "Arregla el checkout." | "Traza la ruta Añadir al carrito → Carrito → Checkout y dime dónde se detiene antes de cambiar nada." |
| "Copia este sitio." | "Usa esto como referencia para espaciado y tono, pero mantén nuestra propia marca, productos y navegación." |
| Una larga lista de cambios no relacionados | Comienza un chat para el resultado principal, luego crea otro para trabajo separado. |
## Recuperación cuando el resultado pierde el objetivo
- Señala la parte exacta que está mal.
- Describe el resultado de clic esperado o el estado visible.
- Añade una imagen de referencia más clara si la anterior era poco clara.
- Responde las preguntas de Runner en lugar de repetir la solicitud completa.
- Para una tarea fallida, lee **Detalles** antes de elegir **Intentar de nuevo**.
## Guías relacionadas
- [Chatea con Runner](/es/guides/work-with-runner/chat-with-runner)
- [Imágenes, modelos y habilidades](/es/guides/work-with-runner/attachments-profiles-and-skills)
- [Cuando Runner hace una pregunta](/es/guides/work-with-runner/answer-runner-questions)
- [Estados de tareas y detalles](/es/guides/work-with-runner/task-states-and-details)
---
# Espacio de trabajo
Source: https://www.runnerai.com/docs/es/guides/workspace
Las capturas y grabaciones muestran la interfaz en inglés.
Un espacio de trabajo agrupa tiendas y compañeros de equipo. Después de iniciar sesión, Runner puede abrir tu tienda actual directamente. Verifica su nombre antes de pedirle a Runner que cambie algo.
**Ruta de entrada:** Iniciar sesión → tienda actual → menú de nombre de la tienda o **Configuración del espacio de trabajo**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Comienza con el menú de nombre de la tienda para confirmar dónde estás trabajando.
## Elige tu próxima tarea
| Lo que necesitas | Guía |
| --- | --- |
| Cambiar de tienda, crear otra tienda o revisar la eliminación | [Gestionar tiendas](/es/guides/workspace/manage-stores) |
| Entender **En vivo** y **Borrador sin publicar** | [Estados de la tienda](/es/guides/workspace/store-statuses) |
| Encontrar una herramienta, tarea o área de configuración | [Navegación y búsqueda](/es/guides/workspace/navigation-and-search) |
| Agregar un compañero de equipo o cambiar el acceso de un miembro | [Miembros e invitaciones](/es/guides/workspace/members-and-invitations) |
| Compartir una referencia sin otorgar acceso al espacio de trabajo | [Invitar Amigos](/es/guides/workspace/invite-friends) |
| Leer actualizaciones de productos y cuentas | [Bandeja de entrada y notificaciones](/es/guides/workspace/inbox-and-notifications) |
| Cambiar las preferencias del espacio de trabajo, la tienda o tu cuenta | [Configuración del espacio de trabajo](/es/guides/workspace/settings) |
## Oriéntate después de iniciar sesión
1. Lee el nombre de la tienda en la parte superior de la barra lateral.
2. Abre su menú si necesitas otra tienda o **Configuración del espacio de trabajo**.
3. Expande **Crear**, **Crecer** o **Medir** para encontrar herramientas para la tienda actual.
4. Usa **Buscar** para encontrar una herramienta o conversación reciente.
5. Verifica **Tienda online** cuando necesites confirmar lo que está actualmente en Vista previa o en vivo.
Si el espacio de trabajo está vacío, sigue primero su aviso de crear tienda. Completar una tarea, preparar una vista previa y publicar la tienda son resultados separados.
## Acceso y configuraciones
- Tu rol determina qué cambios de miembro y espacio de trabajo puedes hacer.
- Los límites de tienda y asiento pueden reemplazar los controles de creación o invitación con un mensaje de plan.
- Las configuraciones del espacio de trabajo afectan al equipo; la **Configuración** de la barra lateral comienza con la tienda en contexto; **Mi configuración** pertenecen a tu cuenta.
- **Invitar Amigos** es una referencia. Usa **Miembros** para dar acceso a alguien a este espacio de trabajo.
## Guías relacionadas
- [Construye tu primera tienda](/es/guides/start-here/first-store-quickstart)
- [Chatear con Runner](/es/guides/work-with-runner/chat-with-runner)
- [Usa el Tour de Bienvenida y Créditos Diarios](/es/guides/start-here/welcome-tour-and-daily-credits)
---
# Bandeja de entrada y notificaciones
Source: https://www.runnerai.com/docs/es/guides/workspace/inbox-and-notifications
**Qué cubre esta guía:** Encontrarás actualizaciones no leídas y sabrás qué puede suceder cuando selecciones una notificación.
La **Bandeja de entrada** combina notificaciones en todos los workspaces a los que puedes acceder. Es diferente de las notificaciones opcionales del navegador que anuncian cuando se completa una tarea de Runner.
**Ruta de entrada:** Barra superior de escritorio → icono de campana. En móvil, abre el menú de cuenta o navegación y selecciona **Bandeja de entrada** cuando se muestre.
En escritorio, la campana abre un panel junto al workspace. En dispositivos móviles, abre un cajón inferior. Un punto azul en la campana indica que existen notificaciones no leídas.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1IjV7HprvDHKGRP0BUIpjksTZQ9oN4rSwzeq)
Empieza con **All** en Inbox o elige una categoría como **Release**. La imagen muestra solo los controles de categorías.
Selecciona la imagen para ampliarla. Las anotaciones están en inglés.
## Antes de empezar
- Confirma el workspace y el proyecto afectado antes de seguir una notificación.
- Guarda cualquier borrador sin enviar porque una notificación puede navegar a otra página o proyecto.
- Evita notificaciones de tareas del navegador en una pantalla compartida cuando su texto pueda revelar detalles del trabajo.
## Controles de la Bandeja de entrada
| Control o estado | Qué sucede |
| --- | --- |
| **Todo** | Muestra cada categoría de notificación disponible. |
| **Suscripción** | Filtra a actualizaciones relacionadas con planes y facturación. |
| **Lanzamiento** | Filtra a actualizaciones de lanzamiento de productos. |
| **Evento** | Filtra a notificaciones de eventos. |
| Fila de notificación | Realiza la acción asignada a esa notificación, si tiene una. |
| Cerrar la Bandeja de entrada o cambiar pestañas | Marca las notificaciones que fueron suficientemente visibles como leídas. No marca cada elemento a la vez. |
| Desplazarse hasta el final | Carga más notificaciones cuando hay más disponibles. |
La Bandeja de entrada no tiene control **Marcar todo como leído** ni pantalla de reintento separada para una solicitud fallida.
## Leer notificaciones
1. Selecciona el icono de campana.
2. Comienza con **Todo**, o elige una categoría.
3. Lee el título, mensaje, tiempo relativo y punto no leído.
4. Desplázate cuando desees cargar elementos más antiguos.
5. Selecciona una fila solo después de leer qué acción representa.
6. Cierra la Bandeja de entrada o cambia de pestañas cuando termines; los elementos no leídos visibles se marcarán entonces como leídos. Reabre la misma categoría para verificar que esos elementos ya no muestran un punto no leído.
## Qué puede hacer un clic de notificación
El comportamiento del clic depende de la notificación:
- Abre una página relacionada dentro de Runner.
- Abre un elemento externo, como una factura, en una nueva pestaña del navegador.
- Copia un error de compilación o verificación previa para que puedas pegarlo en una solicitud de soporte o chat de Runner.
- Abre una ruta de gestión de facturación para un problema de pago.
- No hace nada cuando la notificación es informativa y no tiene acción.
Lee la notificación antes de seleccionarla. Una fila no tiene un destino universal.
## Estados vacíos y de carga
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| Marcadores de posición de carga | Runner está recuperando notificaciones. | Mantén la Bandeja de entrada abierta hasta que la lista se estabilice. |
| **Aún no hay notificaciones** | La categoría seleccionada no tiene elementos. | Regresa más tarde o intenta **Todo**. |
| **Te avisaremos cuando suceda algo.** | No hay ninguna actualización que requiera una acción. | Cierra la Bandeja de entrada y continúa trabajando. |
| Cargando más | Los elementos más antiguos se están recuperando después de desplazarse. | Espera antes de desplazarte de nuevo. |
## Notificaciones de finalización de tareas del navegador
Algunos navegadores de escritorio muestran una tarjeta separada en la barra lateral de Agent expandida:
1. Elige **Activar** para permitir que el navegador solicite permiso de notificación.
2. Permite el permiso solo si deseas notificaciones del sistema para tareas completadas.
3. Elige **Ahora no** para posponer el aviso.
4. Seleccionar una notificación del sistema enfoca Runner y regresa a la conversación relacionada.
Esta función depende de la compatibilidad del navegador de escritorio. No esperes el mismo comportamiento en dispositivos móviles o en cada configuración de aplicación instalada. Los mensajes de finalización de flujo de trabajo y tienda lista del workspace también pueden aparecer como avisos temporales en pantalla; **Previsualizar tienda** en un aviso de tienda lista abre su vista previa.
## Guías relacionadas
- [Navegación y búsqueda](/es/guides/workspace/navigation-and-search)
- [Miembros e invitaciones](/es/guides/workspace/members-and-invitations)
- [Estados de tareas y detalles](/es/guides/work-with-runner/task-states-and-details)
---
# Invita amigos
Source: https://www.runnerai.com/docs/es/guides/workspace/invite-friends
**Invitar a amigos** crea un enlace de referencia personal que puedes copiar o compartir. Es diferente de invitar a un compañero de equipo a un workspace.
## Qué cubre esta guía
Compartirás el enlace de referencia correcto, entenderás qué ve el destinatario y evitarás confundir una referencia con acceso al workspace.
## Disponibilidad y requisitos previos
- Debes estar conectado a un workspace.
- Espera a que Runner genere el enlace de referencia antes de seleccionar una acción de compartir.
- La elegibilidad de referencia y cualquier recompensa se rigen por los términos mostrados en el panel en el momento en que compartes. No confíes en una cantidad anterior o captura de pantalla.
- Un enlace de referencia no agrega su destinatario a tu workspace, tiendas o proyectos.
## Ruta de acceso
Abre **Ganar créditos** y elige la acción de referencia. Si tu diseño aún muestra **Invitar Amigos** en la barra lateral, abre el mismo flujo de referencia. Runner abre un panel de escritorio o un cajón inferior móvil con tu enlace de referencia y los términos actualmente disponibles.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRvFfxwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Abre **Ganar créditos**, desplázate hasta **Más formas de ganar** y elige **Invitar a amigos**. En la imagen: 1. Encuentra tu enlace de invitación. 2. Selecciona **Copiar enlace** (**Copiar** en diseños anteriores). 3. Usa una opción de compartir en redes si lo necesitas. El enlace personal está oculto; no se envió ninguna invitación. Selecciona la imagen para ampliarla. Las anotaciones usan la interfaz de escritorio en inglés.
## Controles de compartir
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Copiar enlace** / **Copiar** | Copia el enlace de referencia al portapapeles. La etiqueta muestra brevemente **¡Copiado!** y luego vuelve al texto original. |
| **X** | Abre el flujo de compartir de X con el enlace de referencia preparado. |
| **Facebook** | Abre el flujo de compartir de Facebook con el enlace de referencia preparado. |
| **LinkedIn** | Abre el flujo de compartir de LinkedIn con el enlace de referencia preparado. |
| Cerrar | Cierra el panel sin cambiar o invalidar el enlace de referencia. |
Los botones sociales abren la ventana o pestaña de compartir del proveedor. Revisa la audiencia y el mensaje allí antes de publicar; abrir un flujo de compartir no publica por sí solo.
## Comparte una referencia
1. Abre **Ganar créditos**, desplázate hasta **Más formas de ganar** y selecciona **Invitar a amigos**.
2. Lee los términos de elegibilidad y recompensa actuales.
3. Espera hasta que el enlace de referencia y los botones de compartir estén listos.
4. Selecciona **Copiar enlace** para enviar el enlace de forma privada, o elige un proveedor social.
5. Si lo copiaste, pega el enlace completo en el mensaje deseado y verifica que su código de invitación permanezca presente.
6. Dile al destinatario que el enlace es para registrarse en Runner, no para unirse a tu workspace existente.
Cuando un destinatario abre el enlace, Runner registra el contexto de referencia y lo envía a iniciar sesión o crear una cuenta. El contexto de referencia se preserva a través de ese paso de inicio de sesión. Cualquier elegibilidad o crédito resultante aún sigue los términos mostrados por Runner; simplemente abrir el enlace no garantiza una recompensa.
## Invita a un compañero de equipo en su lugar
Para dar acceso a alguien al espacio de trabajo actual, abre el menú del nombre de la tienda → **Configuración del espacio de trabajo** → **Miembros** → **Invitar personas**. Una invitación de miembro tiene sus propios estados de pendiente, cancelación y aceptación. No sustituyas un enlace de referencia por ese flujo de acceso.
## Solución de problemas
| Estado | Significado y próximo paso |
| --- | --- |
| Las acciones de compartir no están disponibles | Runner aún está generando el enlace. Espera a que termine. |
| **¡Copiado!** | El enlace está en el portapapeles. Pégalo una vez y verifica la URL completa. |
| La ventana social no se abre | El navegador puede haber bloqueado una ventana emergente. Permite la ventana de compartir para Runner o usa **Copiar** en su lugar. |
| El enlace no se carga | Reabre **Invitar a amigos** y copia el enlace actual. Si aún falla, incluye el error visible en un informe de soporte. |
| El destinatario llega al inicio de sesión | Esto es esperado. Runner mantiene el contexto de referencia mientras el destinatario inicia sesión o crea una cuenta. |
## Guías relacionadas
- [Miembros e invitaciones](/es/guides/workspace/members-and-invitations)
- [Créditos y uso](/es/guides/plans-and-billing/credits-and-usage)
- [Soporte y comunidad](/es/guides/help-and-reference/support-and-community)
---
# Gestionar tiendas
Source: https://www.runnerai.com/docs/es/guides/workspace/manage-stores
Las capturas y grabaciones muestran la interfaz en inglés.
Usa el menú de nombre de la tienda para elegir en qué tienda debe trabajar Runner. Cada tienda tiene sus propias tareas, tienda online y configuraciones.
**Ruta de entrada:** Nombre de la tienda actual en la parte superior de la barra lateral → menú de la tienda.
## Antes de empezar
- Confirma el espacio de trabajo y la tienda actuales antes de crear o eliminar algo.
- Guarda una copia de una solicitud no enviada antes de cambiar de tienda.
- Tu plan de espacio de trabajo controla cuántas tiendas puedes crear.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Abre este menú para elegir una tienda o comenzar **Crear tienda**. Verifica el nombre nuevamente después de cambiar.
## Controles de tienda
| Control | Qué sucede |
| --- | --- |
| Nombre de la tienda actual | Abre el menú de la tienda. |
| Nombre de otra tienda | Abre esa tienda y sus tareas. |
| **Crear tienda** | Abre el diálogo de creación; puede aparecer un mensaje de plan si has alcanzado el límite de tiendas. |
| **Configuración del espacio de trabajo** | Abre configuraciones para el espacio de trabajo, en lugar de la tienda. |
| **Configuración** de la barra lateral | Abre configuraciones para la tienda actual. |
| **General** → **Eliminar tienda** | Abre la confirmación de eliminación. Revisa la tienda nombrada antes de proceder. |
## Abre una tienda existente
1. Selecciona el nombre de la tienda actual en la parte superior de la barra lateral.
2. Encuentra la tienda en la que pretendes trabajar.
3. Selecciona su nombre y espera a que la navegación termine.
4. Confirma el nuevo nombre de la tienda en la barra lateral.
5. Abre su tarea actual o **Tienda online** para verificar que estás en el proyecto correcto antes de enviar instrucciones.
Si tu cuenta abre un espacio de trabajo vacío en su lugar, usa su aviso de creación. Un espacio de trabajo sin tiendas no tiene nada a lo que cambiar todavía.
## Crea otra tienda
1. Abre el menú de nombre de la tienda y selecciona **Crear tienda**.
2. Elige el tipo de tienda disponible. Usa la ruta de creación de Runner para una nueva tienda, o **Conectar Shopify** para una tienda Shopify existente cuando se ofrezca.
3. Ingresa el **Nombre de la tienda** requerido y completa esa ruta.
4. Espera a que Runner abra el proyecto.
5. Confirma que el nuevo nombre aparece en el menú de la tienda. La creación no publica la tienda.
Sigue [Crear una tienda Runner](/es/guides/start-here/create-runner-store) o [Conectar Shopify](/es/guides/start-here/connect-shopify) para el recorrido completo.
## Revisar la eliminación de una tienda
1. Cambia a la tienda que deseas eliminar.
2. Abre la **Configuración** de la barra lateral y la sección **General** de la tienda.
3. Encuentra **Eliminar tienda** y lee la confirmación.
4. Verifica el nombre de la tienda y las consecuencias listadas.
5. Cancela si necesitas conservar la tienda. Ingresa el nombre de la tienda requerido y confirma solo cuando tengas la intención de eliminarla.
6. Después de una eliminación confirmada, verifica que la tienda ya no esté disponible en la lista de tiendas activas.
La eliminación es destructiva. Usa una tienda diferente del menú si solo querías cambiar de proyecto.
## Solución de problemas
| Lo que ves | Qué hacer |
| --- | --- |
| La lista de tiendas se está cargando | Espera antes de seleccionar o crear otra tienda. |
| Falta una tienda | Confirma tu membresía en el espacio de trabajo y el espacio de trabajo que abriste. No crees un duplicado solo porque la lista no se ha cargado. |
| La creación abre un camino de actualización | Revisa los [planes públicos](https://www.runnerai.com/pricing) actuales o pregunta al propietario del espacio de trabajo sobre la capacidad. |
| La creación devolvió un error | Verifica si ya aparece una nueva tienda antes de intentar nuevamente. |
| La configuración de la tienda no está disponible | Confirma la tienda seleccionada y tu rol. Pide acceso a un propietario o administrador del espacio de trabajo. |
| Pantalla de renovación | Reactiva el espacio de trabajo si estás autorizado, o usa otro espacio de trabajo al que puedas acceder. |
## Guías relacionadas
- [Estados de tienda](/es/guides/workspace/store-statuses)
- [Navegación y búsqueda](/es/guides/workspace/navigation-and-search)
- [Configuración del espacio de trabajo](/es/guides/workspace/settings)
- [Chatear con Runner](/es/guides/work-with-runner/chat-with-runner)
---
# Miembros e invitaciones
Source: https://www.runnerai.com/docs/es/guides/workspace/members-and-invitations
Las capturas y grabaciones muestran la interfaz en inglés.
**Lo que cubre:** Invitarás al compañero de equipo adecuado y entenderás qué acciones de miembro permite tu rol.
La página **Miembros** muestra miembros activos e invitaciones pendientes para el espacio de trabajo seleccionado.
Las invitaciones de equipo son independientes del enlace de referencia **Invitar amigos** disponible a través de **Ganar créditos**.
**Ruta de entrada:** Menú del nombre de la tienda → **Configuración del espacio de trabajo** → **Miembros**.
## Antes de empezar
- Confirma el espacio de trabajo y la dirección de correo electrónico deseada.
- Revisa la capacidad de asientos y busca primero un miembro existente o una invitación pendiente.
- Necesitas permisos de propietario o administrador para acciones de gestión de miembros. La gestión de invitaciones también requiere un plan con plazas para el equipo: **Max** o AppSumo License Tier 2, 3 o 4. AppSumo License Tier 1 es un plan de una sola plaza. Sigue la puerta del plan cuando se muestre.
## Controles de la página de miembros
| Control o valor | Qué significa o hace |
| --- | --- |
| **Buscar miembros** | Filtra las filas visibles por el nombre o correo electrónico de un miembro. |
| Asientos utilizados | Muestra los miembros actuales contra la capacidad del espacio de trabajo. Las invitaciones pendientes también afectan si se permite otra invitación. |
| **Invitar personas** | Abre el formulario de invitación para propietarios y administradores de espacios de trabajo elegibles. |
| Campo de correo electrónico | Acepta la dirección de correo electrónico del compañero de equipo. No hay selector de rol en el formulario de invitación. |
| **Enviar invitación** | Envía la invitación después de que el correo electrónico sea válido y haya un asiento disponible. |
| **Activa** | La persona se ha unido al espacio de trabajo. |
| **Pendiente** / **Aún no se ha unido** | La invitación no ha sido aceptada. |
| **Cancelar** | Cancela inmediatamente una invitación pendiente sin otra confirmación. |
| **Eliminar** | Abre una confirmación antes de que un propietario o administrador autorizado elimine a otro miembro. |
| **Salir** | Abre una confirmación antes de que salgas del espacio de trabajo. |
## Invita a un compañero de equipo
1. Confirma el nombre del espacio de trabajo en la configuración.
2. Abre **Miembros**.
3. Revisa los asientos utilizados y busca el correo electrónico para evitar una invitación duplicada.
4. Si tu rol y plan lo permiten, selecciona **Invitar personas**.
5. Ingresa una dirección de correo electrónico válida.
6. Selecciona **Enviar invitación**.
7. Busca **Invitación enviada** o **Invitación reenviada**.
8. Confirma que la persona aparece como **Pendiente**.
La invitación no agrega a la persona hasta que abra el enlace con la cuenta correcta y
elija **Unirse**. Los enlaces de invitación pueden mostrar ya aceptados, cancelados, expirados, cuenta incorrecta,
asiento lleno u otros estados de error. Runner no promete una duración fija de invitación aquí.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgXczT28QoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Ingresa el correo electrónico de tu compañero de equipo en este formulario. La captura de pantalla muestra una invitación en blanco; no se ha enviado ninguna invitación.
## Acepta una invitación
1. Abre el enlace de invitación del correo electrónico dirigido a ti.
2. Inicia sesión con la misma dirección de correo electrónico que recibió la invitación.
3. Confirma el nombre del invitador y del espacio de trabajo que se muestra en la página.
4. Selecciona **Unirse a _nombre del espacio de trabajo_**.
5. Espera a **Unido a _nombre del espacio de trabajo_** y confirma que Runner abre ese espacio de trabajo.
Seleccionar **Unirse** agrega tu cuenta al espacio de trabajo; no crea una tienda separada ni
cambia el rol de otro miembro. Si Runner muestra **Cuenta incorrecta**, selecciona **Iniciar sesión como** seguido de la dirección
invitada y termina de iniciar sesión con esa dirección. Si muestra **El espacio de trabajo está lleno**, selecciona **Entendido** y pide al invitador
que libere un asiento o actualice el plan antes de usar el mismo enlace nuevamente.
## Cambiar el rol de un miembro
1. Encuentra al miembro deseado en **Miembros**.
2. Abre el menú **Rol** de la fila cuando tus permisos lo permitan.
3. Selecciona el rol deseado y espera la actualización.
4. Confirma que la fila muestra el nuevo rol.
Los propietarios pueden asignar roles de propietario, administrador o miembro. Los administradores pueden gestionar administradores y miembros, pero no pueden cambiar a un propietario o otorgar propiedad. El formulario de invitación no tiene selector de roles; revisa los roles después de que el compañero de equipo se una.
## Administra el acceso con cuidado
### Cancela una invitación pendiente
1. Busca el correo electrónico pendiente.
2. Selecciona **Cancelar** solo cuando tengas la intención de invalidar esa invitación.
3. Verifica que la fila pendiente ya no aparezca.
**Cancelar** invalida la invitación pendiente sin una segunda confirmación.
### Elimina un miembro o sal
1. Encuentra la fila de miembro correcta.
2. Selecciona **Eliminar**, o selecciona **Salir** en tu propia fila.
3. Lee la confirmación, incluida la pérdida de acceso a los proyectos del espacio de trabajo.
4. Cancela si el acceso debe permanecer.
5. Confirma solo cuando el espacio de trabajo y la persona sean correctos.
Un propietario no puede ser eliminado de la fila de propietario en la interfaz. Las acciones de administración de miembros
también siguen la jerarquía de roles, por lo que una acción visible o intentada aún puede ser rechazada cuando tu rol
no lo permite.
## Solución de problemas
| Estado | Qué hacer |
| --- | --- |
| **Invitar personas** está ausente | Verifica que el espacio de trabajo esté en Max o AppSumo License Tier 2-4 y pide a un propietario o administrador del espacio de trabajo que envíe la invitación. |
| La capacidad de asientos se ha alcanzado | Resuelve una invitación pendiente no utilizada o pide al propietario que revise el plan del espacio de trabajo. |
| El correo electrónico es rechazado | Verifica la dirección completa y corrige cualquier error de formato. |
| La invitación pertenece a otra cuenta | Inicia sesión con el correo electrónico invitado antes de elegir **Unirse**. |
| La invitación ha expirado o ha sido cancelada | Pide a un propietario o administrador del espacio de trabajo que envíe una nueva invitación. |
| **El espacio de trabajo está lleno** | Pide al invitador que libere un asiento o actualice el plan del espacio de trabajo, luego intenta el enlace nuevamente. |
| **Invitación ya aceptada** | Selecciona **Ir a Runner AI** y abre el espacio de trabajo desde tu selector de espacio de trabajo. |
| La búsqueda no muestra resultado | Borra o acorta la búsqueda, luego verifica el espacio de trabajo seleccionado. |
## Guías relacionadas
- [Configuración del espacio de trabajo](/es/guides/workspace/settings)
- [Navegación y búsqueda](/es/guides/workspace/navigation-and-search)
- [Bandeja de entrada y notificaciones](/es/guides/workspace/inbox-and-notifications)
---
# Navegación y búsqueda
Source: https://www.runnerai.com/docs/es/guides/workspace/navigation-and-search
Las capturas y grabaciones muestran la interfaz en inglés.
Comienza revisando el nombre de la tienda. Las herramientas de la barra lateral actúan sobre esa tienda; el espacio de trabajo y las configuraciones personales tienen entradas separadas.
**Ruta de entrada:** Abre una tienda → expande la barra lateral, o abre el menú de navegación en móvil.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Busca en tu tienda; 2. Inicia una tarea nueva; 3. Abre una herramienta del espacio de trabajo; 4. Vuelve a abrir una tarea guardada. Selecciona la imagen para ampliarla. Las indicaciones numeradas corresponden a la interfaz de escritorio en inglés.
## Antes de empezar
- Guarda una copia de una solicitud no enviada antes de cambiar de tienda o tarea.
- Los destinos disponibles dependen del tipo de tienda, rol, plan y características habilitadas.
## Encuentra el alcance correcto
| Dónde buscar | Qué puedes hacer |
| --- | --- |
| Nombre de la tienda en la parte superior de la barra lateral | Cambiar de tienda, abrir **Crear tienda**, o abrir **Configuración del espacio de trabajo**. |
| **Tienda online** | Revisa las páginas actuales de la tienda y el estado de publicación. |
| **Crear**, **Crecer** y **Medir** | Expande las herramientas agrupadas para operaciones de tienda, crecimiento e informes. |
| **Agente** | Administra las Habilidades y Memoria disponibles de la tienda. |
| **Configuración** de la barra lateral | Abre configuraciones con la tienda actual en contexto. |
| Campana en la parte superior derecha | Abre **Bandeja de entrada** en escritorio. En móvil, usa la entrada **Bandeja de entrada** cuando se ofrezca en el menú. |
| Avatar en la parte superior derecha → **Mi configuración** | Abre las preferencias de cuenta personal. |
| **Ganar créditos** | Revisa las acciones de recompensa y referencia disponibles. |
## Cambiar de tienda
1. Selecciona el nombre de la tienda en la parte superior de la barra lateral.
2. Selecciona la tienda que necesitas de la lista.
3. Espera a que se abra su página.
4. Confirma el nuevo nombre de la tienda antes de seleccionar **Nueva tarea** o cambiar configuraciones.
El menú de la tienda lista las tiendas en su espacio de trabajo. La barra lateral de Configuración actual no expone **Espacios de trabajo**. Usa una entrada de cambio de espacio de trabajo solo cuando Runner presente una, luego abre **Configuración → General del espacio de trabajo** y confirma el nombre del espacio de trabajo. Consulta [Configuración](/es/guides/workspace/settings) para los controles de alcance.
## Encuentra una herramienta o tarea
1. Selecciona **Buscar** en la barra lateral del proyecto, o presiona `Command/Control + K`.
2. Escribe un nombre de destino visible, como `Storefront`, o parte de un título de tarea.
3. Elige un resultado bajo **Centro de control** para una herramienta, o **Chats recientes** para una conversación.
4. Confirma que la página o tarea seleccionada se abre en la tienda deseada.
5. Presiona `Escape` para cerrar la búsqueda si no deseas navegar.
[Navegación y búsqueda de proyectos](/es/guides/work-with-runner/project-navigation-and-search) lista los grupos de herramientas y los estados de recuperación de búsqueda. La búsqueda navega; no inicia el trabajo en la herramienta seleccionada.
Buscar muestra los destinos disponibles bajo **Centro de control**. Selecciona un resultado para navegar, o presiona Escape para mantener la página actual.
### Ver: filtrar búsqueda de navegación
La grabación escribe **Análisis** e inspecciona el destino coincidente. Se detiene antes de abrir el resultado; selecciona un resultado tú mismo para navegar.
## Solución de problemas
| Problema | Qué hacer |
| --- | --- |
| Las etiquetas de la barra lateral están ocultas | Expándela, o abre el menú de navegación móvil. |
| Falta un destino | Expande el grupo relevante, intenta Buscar, luego verifica los requisitos previos de la función. |
| Falta una tienda | Confirma el espacio de trabajo y tu membresía antes de crear otra tienda. |
| La búsqueda no encuentra nada | Borra la consulta y usa la etiqueta de herramienta visible actual. |
| Un enlace abre otra pestaña del navegador | Regresa a Runner después de leerlo; abrir un recurso no cambia de tienda. |
## Guías relacionadas
- [Administrar tiendas](/es/guides/workspace/manage-stores)
- [Navegación y búsqueda del proyecto](/es/guides/work-with-runner/project-navigation-and-search)
- [Bandeja de entrada y notificaciones](/es/guides/workspace/inbox-and-notifications)
- [Configuración del espacio de trabajo](/es/guides/workspace/settings)
---
# Configuración del Espacio de Trabajo
Source: https://www.runnerai.com/docs/es/guides/workspace/settings
Las capturas y grabaciones muestran la interfaz en inglés.
**Qué cubre esta guía:** Abrirás el área de configuración correcta y sabrás qué cambios afectan a un espacio de trabajo, tienda o solo tu cuenta.
La configuración se agrupa por alcance. Confirma los nombres del espacio de trabajo y la tienda antes de cambiar el acceso,
facturación, dominios, scripts o controles de eliminación.
**Rutas de entrada:**
- Menú de nombre de la tienda → **Configuración del espacio de trabajo** abre configuraciones del espacio de trabajo.
- Avatar de usuario en la parte superior derecha → **Mi configuración** abre configuraciones personales.
- Barra lateral → **Configuración** abre configuraciones con la tienda actual en contexto.
## Antes de empezar
- Confirma el espacio de trabajo y, para configuraciones de tienda, el grupo **Tienda: _nombre de la tienda_**.
- Espera a que desaparezca cualquier estado **Guardando** antes de salir de la página.
- Lee la confirmación final antes de cambios de acceso, facturación, dominio, script o eliminación.
## Controles y resultados importantes
| Control | Qué sucede después de seleccionarlo |
| --- | --- |
| **Nombre** o **Descripción** | Guarda automáticamente un cambio válido del espacio de trabajo después de que se detiene la edición. |
| **General del espacio de trabajo** | Abre detalles para el espacio de trabajo nombrado en la barra lateral de configuraciones. |
| **Eliminar espacio de trabajo** | Abre una confirmación destructiva que requiere el nombre completo del espacio de trabajo. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
El grupo de espacio de trabajo y el grupo **Tienda** tienen configuraciones separadas. Confirma el alcance nombrado antes de editar.
## Secciones de configuración
| Alcance | Secciones mostradas actualmente | Notas |
| --- | --- | --- |
| Espacio de trabajo | **General del espacio de trabajo**, **Miembros**, **Plan y Facturación**, **Uso y créditos** | Los roles de miembro controlan qué cambios tienen éxito. |
| Proyecto de tienda | **General de la tienda**, **Dominio**, **Scripts personalizados**, **Agente** | **Experimentos** aparece solo cuando está habilitado. Las secciones del proyecto aparecen solo con una tienda en contexto. |
| Personal | **Mi configuración**, y **Claves API** cuando están habilitadas | Los cambios personales y las claves API pertenecen a tu cuenta. |
## Actualizar detalles del espacio de trabajo
1. Abre **Configuración → General del espacio de trabajo**.
2. Confirma el nombre del espacio de trabajo en la parte superior del panel de configuración.
3. Edita **Nombre** o **Descripción**.
4. Observa el cambio del estado de guardado de **Guardando** a **Guardado**.
5. Mantén el panel abierto hasta que se complete el guardado.
Estos campos se guardan automáticamente. Un nombre vacío o inválido no se guarda. Si el guardado falla, Runner
puede restaurar el último valor del servidor y mostrar un error. La descripción del espacio de trabajo acepta hasta el
límite mostrado por el campo, actualmente 500 caracteres.
Actualizar los detalles del espacio de trabajo requiere permiso suficiente del espacio de trabajo. Eliminar un espacio de trabajo es una
acción del propietario incluso si otro rol puede ver parte de la interfaz de configuración.
## Cambiar contexto de configuración
1. Abre **Configuración** y lee los nombres del espacio de trabajo y la tienda en su barra lateral.
2. Selecciona **General del espacio de trabajo** para detalles del espacio de trabajo o **General de la tienda** para la tienda actual.
3. Selecciona **Mi configuración** para preferencias personales.
La barra lateral actual no expone una lista de **Espacios de trabajo**. Usa una entrada de cambio o creación de espacio de trabajo solo cuando Runner presente una; no la busques bajo **Mi configuración**. Para salir de un espacio de trabajo, sigue [Miembros e invitaciones](/es/guides/workspace/members-and-invitations).
## Eliminar un espacio de trabajo con cuidado
1. Abre **Configuración → General del espacio de trabajo**.
2. Encuentra **Eliminar espacio de trabajo**.
3. Lee la confirmación y el nombre del espacio de trabajo afectado.
4. Ingresa el nombre completo del espacio de trabajo solo cuando sea el objetivo previsto.
5. Cancela si alguna tienda, conversación, acceso de miembro o datos del espacio de trabajo deben permanecer disponibles.
El único espacio de trabajo no puede ser eliminado desde la interfaz.
## Estados de acceso y solución de problemas
| Estado | Significado | Qué hacer |
| --- | --- | --- |
| **Guardando** | Runner está almacenando un cambio automático. | Mantén el panel de configuración abierto. |
| **Guardado** | El último cambio de campo válido fue aceptado. | Continúa o cierra la configuración. |
| Error de guardado y valor anterior se restaura | El cambio no fue aceptado. | Corrige el valor, confirma tu permiso e intenta una vez más. |
| **Crea tu primer espacio de trabajo** | Tu cuenta no tiene ningún espacio de trabajo disponible. | Usa la acción de creación para continuar. |
| **Acceso al espacio de trabajo denegado** | Tu cuenta no puede abrir ese espacio de trabajo. | Elige **Ir a tu espacio de trabajo**. |
| Pantalla de renovación | El espacio de trabajo no está activo. | Elige **Renovar plan** si estás autorizado, o cambia de espacios de trabajo. |
| Falta una sección | No está disponible para el rol actual, contexto del proyecto, plan o acceso a funciones. | Confirma el contexto y pregunta al propietario del espacio de trabajo cuando sea necesario. |
## Guías relacionadas
- [Miembros e invitaciones](/es/guides/workspace/members-and-invitations)
- [Administrar tiendas](/es/guides/workspace/manage-stores)
- [Navegación y búsqueda](/es/guides/workspace/navigation-and-search)
- [Imágenes, modelos y habilidades](/es/guides/work-with-runner/attachments-profiles-and-skills)
---
# Estados de la tienda
Source: https://www.runnerai.com/docs/es/guides/workspace/store-statuses
Las capturas y grabaciones muestran la interfaz en inglés.
El resumen de la tienda te dice si existe una versión pública. Abre **Tienda online** para verificar si tu último cambio es parte de esa versión.
**Ruta de entrada:** Nombre y resumen de la tienda actual → **Tienda online**.
## Lee el resumen
| Etiqueta | Qué te dice | Qué verificar a continuación |
| --- | --- | --- |
| **Borrador sin publicar** | La tienda no tiene una versión publicada para usar como su tienda online en vivo. | Revisa la vista previa actual y prepara su primera publicación. |
| **En vivo** | Existe una tienda online pública. | Abre la URL pública y confirma que los cambios deseados son visibles. |
| **Versión actual** en la tienda online | Esta es la última versión del proyecto. | Compárala con la versión publicada antes de asumir que está en vivo. |
| **Publicado** en una versión | Esa versión está asociada con una publicación completada. | Verifica la página pública y el proceso de pago por separado. |
Los diseños más antiguos de tarjetas de tienda pueden usar **Borrador**, **Desplegando** y **Publicado**. Lee **Desplegando** como una operación en progreso y espera su resultado. Una etiqueta en vivo o publicada aún puede referirse a una versión exitosa anterior después de que un intento posterior falle.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Esta es la vista previa actual del proyecto. Usa sus controles de versión y publicación para compararla con la tienda en vivo; una vista previa visible por sí sola no la hace pública.
## Verifica un cambio reciente
1. Confirma el nombre actual de la tienda.
2. Abre la tarea que solicitó el cambio y revisa su estado más reciente y **Detalles**.
3. Abre la **Tienda online** y confirma el cambio esperado en la vista previa actual lista.
4. Verifica si esa versión fue publicada.
5. Si lo fue, abre la URL pública y repite la acción relevante del cliente.
Has verificado el cambio solo cuando la versión prevista y su resultado visible coinciden. Completar la tarea por sí solo no prueba que una vista previa, publicación, pago o acción del proveedor haya tenido éxito.
## Si el resumen parece incorrecto
- Deja que cualquier publicación activa termine antes de comenzar otro intento.
- Actualiza la vista actual una vez y lee el resultado de la publicación más reciente.
- Compara las versiones actual y publicada en [Historial de versiones](/es/guides/storefront-and-publishing/version-history).
- Si la tienda pública aún muestra contenido antiguo, revisa la vista previa más reciente antes de usar **Publicar cambios**.
- Si la publicación falló, sigue el error nombrado en lugar de repetir la misma acción.
## Guías relacionadas
- [Administrar tiendas](/es/guides/workspace/manage-stores)
- [Estados de tarea y detalles](/es/guides/work-with-runner/task-states-and-details)
- [Publicar y republicar](/es/guides/storefront-and-publishing/publish-and-republish)
- [Verificar la tienda en vivo y el pago](/es/guides/storefront-and-publishing/live-store-and-checkout)
---
# Política de Uso Aceptable
Source: https://www.runnerai.com/docs/es/legal/aup
## Política de Uso Aceptable de Runner AI
Esta Política de Uso Aceptable ("PUA") es emitida por Adaptive Machines, Inc. ("Runner AI", "nosotros", "nos") y rige su uso de los servicios de Runner AI.
**La regla principal para usar Runner AI es: Usted es responsable de cumplir con la ley, las reglas de sus socios y sus acuerdos con nosotros.**
Estos son los principios detrás de nuestras expectativas con más detalle:
## No puede usar Runner AI para hacer nada que sea ilegal donde realiza negocios
Entendemos que las leyes y los marcos regulatorios pueden ser complejos, pero al elegir un mercado para ingresar y productos para vender, usted, el comerciante, está asumiendo el compromiso de tomar ese mercado en serio, y confiamos y esperamos que comprenda los límites aplicables. Asimismo, debe respetar que ciertas actividades comerciales no están respaldadas por nuestra plataforma, como cargar Información de Salud Protegida sujeta a HIPAA.
## Debe Mantener la Integridad y Seguridad de la Plataforma
Estamos comprometidos a mantener un entorno comercial seguro y confiable. Las actividades que dañan la integridad de nuestra plataforma o la seguridad de nuestros usuarios están estrictamente prohibidas. Esto incluye, pero no se limita a:
### Bienes Ilegales y Regulados
Vender productos falsificados, drogas ilegales, armas o cualquier otro producto que sea ilegal en su jurisdicción o la de sus clientes.
### Infracción de Propiedad Intelectual
Violar los derechos de propiedad intelectual de otros, incluidos derechos de autor y marcas registradas.
### Odio, Violencia y Contenido Dañino
Vender productos o publicar contenido que promueva el odio, la discriminación, la violencia o facilite la autolesión intencionada.
### Fraude y Engaño
Participar en marketing engañoso, estafas financieras o cualquier otra actividad fraudulenta.
### Abuso de la Plataforma
Enviar spam, distribuir malware o intentar interrumpir nuestros servicios.
## Reglas Específicas Relacionadas con las Funciones de IA
Su uso de cualquier función de inteligencia artificial dentro de Runner AI ("Funciones de IA") está sujeto a los siguientes términos adicionales:
### a. Responsabilidad por la Entrada
Usted es el único responsable de todo el texto, datos e información que proporcione a las Funciones de IA ("Entrada"). Usted acepta no proporcionar ninguna Entrada que sea ilegal, infrinja los derechos de terceros o contenga información personal sensible.
### b. Precisión y Responsabilidad por la Salida
El contenido generado por las Funciones de IA ("Salida") puede contener errores. Debe revisar y verificar de forma independiente toda la Salida antes de publicarla o depender de ella. Runner AI no es responsable de ningún daño resultante de su uso de la Salida.
### c. Usos Prohibidos de las Funciones de IA
No puede usar las Funciones de IA para generar contenido engañoso, crear contenido de odio o acoso, o producir spam.
## Debe seguir nuestros acuerdos con usted
Si bien no queremos agobiarlo con mucho papeleo, nuestros Términos de Servicio son importantes para cómo operamos. Nuestros acuerdos lo vinculan como comerciante y explican las reglas de la plataforma que debe seguir.
Runner AI ofrece una gama de productos y servicios que aprovechan asociaciones con otras organizaciones. Cuando usa uno de estos productos, está interactuando con toda una cadena de suministro de negocios. Runner AI involucra un ecosistema de procesadores que trabajan juntos. Si usa estos servicios, debe respetar cómo funciona la cadena de suministro y qué términos se le solicitan.
## Las disputas más comunes sobre elegibilidad de productos se originan fuera de Runner AI
Somos una plataforma de comercio: la mayoría de las disputas sobre elegibilidad de productos o eliminación que los emprendedores puedan encontrar se originan fuera de Runner AI, incluidos los reguladores y los titulares de derechos de propiedad intelectual de terceros. En estas circunstancias, le daremos aviso y herramientas para autogestionar sus riesgos y disputas cuando sea apropiado.
## Esperamos que actúe de buena fe. Si no lo hace, la acción a nivel de cuenta puede ser apropiada
No nos gusta ver que las personas intenten "engañar" a los sistemas para evitar restricciones con las que no están de acuerdo. Tampoco toleramos a nadie que defraude a Runner AI, otros comerciantes o compradores, use nuestra plataforma para enviar spam o para otras prácticas maliciosas. En esos casos, aunque intentamos minimizar el impacto en el negocio como principio de primer orden, la acción a nivel de cuenta es a menudo más apropiada.
Cuando construye en Runner AI con estos principios en mente, le daremos aviso, le otorgaremos oportunidades para remediar conflictos por sí mismo, utilizaremos el cumplimiento a nivel de producto de forma predeterminada y tomaremos medidas a nivel de cuenta como último recurso cuando sea apropiado. Finalmente, como con todos los grandes productos, esperamos iterar y actualizar estos principios de vez en cuando.
Si cree que un usuario de Runner AI está violando esta Política de Uso Aceptable, puede contactar al Soporte de Runner AI por correo electrónico en support@adaptivemachines.ai.
---
# Política de Cookies
Source: https://www.runnerai.com/docs/es/legal/cookies
## Política de Cookies de Runner AI
Esta Política de Cookies explica cómo Adaptive Machines, Inc. ("Runner AI", "nosotros", "nos" o "nuestro") utiliza cookies y tecnologías similares en nuestro sitio web (runner.ai) y los servicios que proporcionamos a nuestros comerciantes (colectivamente, los "Servicios"). Explica qué son estas tecnologías y por qué las usamos, así como sus derechos para controlar nuestro uso de ellas. Esta política debe leerse junto con nuestra [Política de Privacidad](/es/legal/policies) principal.
## ¿Qué son las cookies?
Una cookie es una pequeña cantidad de información que se descarga en su computadora o dispositivo cuando visita ciertos sitios web. Utilizamos una serie de cookies diferentes en el sitio web de Runner AI, incluidas cookies estrictamente necesarias, de rendimiento, publicitarias y de redes sociales o contenido. Las cookies mejoran su experiencia de navegación al permitir que el sitio web recuerde sus acciones y preferencias (como inicio de sesión y selección de región). Esto significa que no tiene que volver a ingresar esta información cada vez que regrese al sitio o navegue de una página a otra. Las cookies también proporcionan información sobre cómo las personas usan el sitio web, por ejemplo, si es su primera vez visitando o si son visitantes frecuentes. Lea más sobre las cookies (y otras tecnologías de seguimiento similares) y cómo usamos los datos recopilados a través de estas tecnologías, en nuestra [Política de Privacidad](/es/legal/policies).
## Cookies en Tiendas de Comerciantes
Esta sección es importante tanto para los comerciantes que usan nuestra plataforma como para los visitantes de sus tiendas.
**Para Visitantes de Tiendas de Comerciantes:** Cuando visita la tienda de un comerciante impulsada por Runner AI, ese comerciante es el Controlador de Datos de su información. Esto significa que el comerciante decide qué cookies usar en su tienda, especialmente para análisis y publicidad (por ejemplo, Google Analytics, Facebook Pixel). Runner AI actúa como Procesador de Datos, colocando cookies que son estrictamente necesarias para la funcionalidad principal de la tienda (por ejemplo, carrito de compras, checkout). Cualquier pregunta sobre las prácticas de privacidad de un comerciante debe dirigirse al comerciante mismo.
**Para Comerciantes:** Como comerciante que usa Runner AI, usted es el Controlador de Datos de los datos de sus clientes. Usted es responsable de cumplir con todas las leyes de privacidad aplicables, incluida la información a sus clientes sobre las cookies que usa (incluidas las de aplicaciones de terceros que instala) y la obtención del consentimiento válido cuando sea requerido. Si bien Runner AI proporciona la plataforma, usted es responsable de la configuración específica de la configuración de privacidad y las políticas de su tienda.
## ¿Qué cookies usamos y por qué?
### Cookies Necesarias
Algunas cookies son necesarias para permitirle navegar por nuestro sitio web, usar sus funciones y acceder a áreas seguras. El uso de estas cookies es esencial para que el sitio web funcione. Por ejemplo, usamos cookies de entrada de usuario durante la duración de una sesión para realizar un seguimiento de su entrada al completar formularios que abarcan varias páginas.
### Cookies Funcionales
También usamos cookies funcionales para recordar las elecciones que ha hecho o la información que ha proporcionado, como su nombre de usuario, idioma o la región en la que se encuentra. Esto nos permite adaptar su experiencia en el sitio web específicamente a sus preferencias. Por ejemplo, las cookies de autenticación son cookies funcionales que se usan durante la duración de una sesión (o persistentes, si acepta la función "recordarme") para permitir que los usuarios se autentiquen en visitas posteriores o para obtener acceso a contenido autorizado en todas las páginas. Las cookies funcionales que usamos incluyen:
- **Cookies de seguridad centradas en el usuario:** Para detectar abusos de autenticación durante una duración persistente limitada, como intentos de inicio de sesión fallidos repetidos.
- **Cookies de sesión del reproductor de contenido multimedia (cookies flash):** Utilizadas durante la duración de una sesión para almacenar datos técnicos necesarios para reproducir contenido de video o audio.
- **Cookies de sesión de equilibrio de carga:** Utilizadas durante la duración de la sesión para identificar el mismo servidor en el grupo para que el equilibrador de carga redirija las solicitudes de manera apropiada.
- **Cookies persistentes de personalización de interfaz de usuario:** Utilizadas para almacenar la preferencia de un usuario con respecto a un servicio en páginas web.
### Cookies de Rendimiento
Runner AI se dedica a optimizar la experiencia del usuario y utilizamos muchas herramientas para ayudarnos a mejorar nuestro sitio web y nuestra plataforma de comercio. Con este fin, utilizamos cookies de informes y análisis para recopilar información sobre cómo usa nuestro sitio web o las tiendas de nuestros comerciantes, y con qué frecuencia. Las cookies de rendimiento que usamos incluyen:
- **Cookies de análisis de primera parte:** Usamos estas cookies para estimar el número de visitantes únicos, mejorar nuestros sitios web y los sitios web de nuestros comerciantes, y detectar las palabras más buscadas en motores de búsqueda que conducen a una página web.
- **Cookies de análisis de terceros:** También usamos Google Analytics y otros proveedores de análisis de terceros que se enumeran a continuación para ayudar a medir cómo los usuarios interactúan con el contenido de nuestro sitio web.
### Cookies Publicitarias
Las cookies publicitarias se utilizan en nuestro sitio web para adaptar el marketing a usted y sus intereses y brindarle un servicio más personalizado en el futuro. Estas cookies recuerdan que visitó nuestro sitio web y podemos compartir esta información con terceros, como anunciantes. Sin estas cookies, los anuncios que vea pueden ser menos relevantes e interesantes para usted.
### Cookies de Redes Sociales y Contenido
Las cookies de redes sociales y contenido son colocadas por muchos complementos de redes sociales (por ejemplo, el botón "me gusta" de Facebook) y otras herramientas destinadas a proporcionar o mejorar el contenido en un sitio web (por ejemplo, servicios que permiten la reproducción de archivos de video o que crean secciones de comentarios). Integramos estos módulos en nuestra plataforma para mejorar la experiencia de navegación e interacción con nuestros sitios web.
## Tiendas de Comerciantes
Cuando los comerciantes usan nuestra plataforma para impulsar sus tiendas en línea, colocamos las siguientes cookies para los visitantes de sus tiendas.
### Cookies Necesarias para el Funcionamiento de la Tienda
| Nombre | Descripción | Duración |
|------|-------------|----------|
| \_medusa\_jwt | Credencial de inicio de sesión del visitante | 7d |
## Cookies de Terceros
Además, usamos píxeles y etiquetas de los siguientes terceros, que a su vez pueden colocar cookies.
### Cookies Necesarias para el Funcionamiento de los Sitios
| Tercero | Descripción | Política de Privacidad |
|-------------|-------------|----------------|
| Vercel | Usamos Vercel para enrutamiento de borde. | [https://vercel.com/legal/privacy-policy](https://vercel.com/legal/privacy-policy) |
| Intercom | Usamos Intercom para servicio al cliente. | [https://www.intercom.com/legal/privacy](https://www.intercom.com/legal/privacy) |
| Chatwoot | Usamos Chatwoot, que alojamos nosotros mismos en support.runnerai.com, para servicio al cliente. Establece `cw_conversation` para mantener su conversación de chat entre páginas y visitas, `cw_user_` para recordar a qué contacto de chat pertenece su navegador cuando ha iniciado sesión, y `cw_snooze_campaigns_till` para retener los mensajes de campañas de chat durante una hora después de que lea uno. `cw_conversation` y `cw_user_` duran un año. | [Política de Privacidad](/es/legal/policies) |
### Informes y Análisis
| Tercero | Descripción | Política de Privacidad |
|-------------|-------------|----------------|
| Google Analytics | Usamos Google Analytics para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Google Tag Manager | Usamos Google Tag Manager para ayudar a administrar proveedores de análisis. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| PostHog | Usamos PostHog para análisis de datos. | [https://posthog.com/privacy](https://posthog.com/privacy) |
### Publicidad
| Tercero | Descripción | Política de Privacidad |
|-------------|-------------|----------------|
| Facebook Pixel | Usamos Facebook Pixel para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://www.facebook.com/privacy/explanation](https://www.facebook.com/privacy/explanation) |
| Google Ads | Usamos Google Ads para entregar anuncios dirigidos a personas que visitan nuestros sitios web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Instagram | Usamos Instagram para entregar anuncios dirigidos a personas que visitan nuestros sitios web. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| TikTok | Usamos TikTok para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Twitter | Usamos Twitter para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube | Usamos YouTube para entregar anuncios dirigidos a personas que visitan nuestros sitios web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Reddit | Usamos Reddit para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Pinterest | Usamos Pinterest para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Whatsapp | Usamos Whatsapp para ayudar a medir cómo los usuarios interactúan con nuestros sitios web. | [https://www.whatsapp.com/legal/privacy-policy](https://www.whatsapp.com/legal/privacy-policy) |
### Redes Sociales y Contenido
| Tercero | Descripción | Política de Privacidad |
|-------------|-------------|----------------|
| Facebook Connect | Usamos Facebook Connect para permitir que los visitantes de nuestro sitio web interactúen y compartan contenido a través de la plataforma de redes sociales de Facebook. | [https://www.facebook.com/policy.php](https://www.facebook.com/policy.php) |
| Instagram CDN | Usamos Instagram CDN para proporcionar contenido al usuario. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| Twitter CDN | Usamos Twitter para permitir que los visitantes de nuestro sitio web interactúen y compartan contenido a través de la plataforma de redes sociales de Twitter. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube CDN | Usamos YouTube CDN para proporcionar contenido al usuario. | [https://policies.google.com/privacy?hl=en](https://policies.google.com/privacy?hl=en) |
| Tiktok CDN | Usamos Tiktok CDN para proporcionar contenido al usuario. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Reddit CDN | Usamos Reddit CDN para proporcionar contenido al usuario. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Linkedin CDN | Usamos Linkedin CDN para proporcionar contenido al usuario. | [https://www.linkedin.com/legal/privacy-policy](https://www.linkedin.com/legal/privacy-policy) |
| Pinterest CDN | Usamos Pinterest CDN para proporcionar contenido al usuario. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Rednote CDN | Usamos Rednote CDN para proporcionar contenido al usuario. | [https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1](https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1) |
## ¿Cuánto tiempo permanecerán las cookies en mi computadora o dispositivo móvil?
El tiempo que una cookie permanece en su computadora o dispositivo móvil depende de si es una cookie "persistente" o de "sesión". Las cookies de sesión duran hasta que deja de navegar y las cookies persistentes duran hasta que caducan o se eliminan. La mayoría de las cookies que usamos son persistentes y caducarán entre 30 minutos y dos años desde la fecha en que se descargan en su dispositivo. Consulte la sección a continuación sobre cómo controlar las cookies para obtener más información sobre cómo eliminarlas antes de que caduquen.
## ¿Cómo controlar las cookies?
Puede controlar y administrar las cookies de varias maneras. Tenga en cuenta que eliminar o bloquear las cookies puede afectar negativamente su experiencia de usuario y es posible que partes de nuestro sitio web ya no sean completamente accesibles.
La mayoría de los navegadores aceptan cookies automáticamente, pero puede elegir si acepta o no las cookies a través de los controles de su navegador, que a menudo se encuentran en el menú "Herramientas" o "Preferencias" de su navegador. Para obtener más información sobre cómo modificar la configuración de su navegador o cómo bloquear, administrar o filtrar cookies, puede encontrarse en el archivo de ayuda de su navegador o a través de sitios como: [www.allaboutcookies.org](https://www.allaboutcookies.org).
Muchos de los servicios de publicidad y seguimiento de terceros enumerados anteriormente le ofrecen la oportunidad de optar por no participar en sus sistemas de seguimiento. Puede leer más sobre la información que recopilan y cómo optar por no participar a través de los enlaces de política de privacidad enumerados anteriormente.
---
# Anexo de Procesamiento de Datos
Source: https://www.runnerai.com/docs/es/legal/dpa
## Anexo de Procesamiento de Datos de Runner AI
### I. PROPÓSITO
Este Anexo de Procesamiento de Datos de Runner AI ("APD") complementa y se incorpora por referencia en los Términos de Servicio de Runner AI, junto con cualquier término aplicable a cualquier servicio adicional de Runner AI que elija utilizar (los "Términos") por y entre Usted (o "Comerciante"), y Adaptive Machines, Inc. ("Runner AI" "nosotros", "nos", "nuestro"), que describe los propósitos comerciales específicos y los servicios relacionados con este APD. En caso de conflicto entre los Términos y este APD, el APD prevalecerá con respecto al procesamiento de Sus Datos Personales de Clientes, según se define a continuación.
Usted y Runner AI (cada uno una "Parte", juntos las "Partes"), acuerdan que este APD establece las obligaciones de las Partes que rigen el procesamiento de Sus Datos Personales de Clientes. Usted actuará como Controlador de Datos y Runner AI actuará como Procesador de Datos con respecto al procesamiento de Sus Datos Personales de Clientes, en relación con Su uso de nuestros Servicios que dependen de nuestro procesamiento de Sus Datos Personales de Clientes, excepto por los servicios descritos en el Apéndice E.
Cuando el procesamiento de Datos Personales bajo este APD esté sujeto a requisitos de protección de datos en el Área Económica Europea (el "EEE"), el Reino Unido (el "RU") o Suiza, y Runner AI actúe como Procesador de Datos, el Apéndice C complementa este APD. En caso de conflicto entre el Apéndice C y otras secciones de este APD, el Apéndice C prevalecerá con respecto al procesamiento de Sus Datos Personales de Clientes sujetos a los requisitos de protección de datos del EEE, RU y Suiza. Para mayor claridad, el Apéndice C no se aplicará a las actividades de procesamiento descritas en el Apéndice E.
Cuando el procesamiento de Datos Personales bajo este APD esté sujeto a las Leyes de Protección de Datos de EE. UU., y Runner AI actúe como Procesador de Datos o Proveedor de Servicios, el Apéndice D complementa este APD. En caso de conflicto entre el Apéndice D y otras secciones de este APD, el Apéndice D prevalecerá con respecto al procesamiento de Sus Datos Personales de Clientes sujetos a las Leyes de Protección de Datos de EE. UU. Para mayor claridad, el Apéndice D no se aplicará a las actividades de procesamiento descritas en el Apéndice E.
Si recibe Servicios Mejorados de Runner AI (según se define en la Sección 9 de los Términos de Servicio), Runner AI procesará Sus Datos Personales de Clientes como Controlador de Datos o Empresa según se establece en el Apéndice E. En caso de conflicto entre el Apéndice E y otras secciones de este APD, el Apéndice E prevalecerá con respecto al procesamiento por parte de Runner AI de Sus Datos Personales de Clientes como Controlador de Datos o Empresa.
### II. DEFINICIONES
Los términos en mayúscula utilizados pero no definidos en este APD tendrán el mismo significado que se les da en los Términos:
**A. Ley(es) Aplicable(s) de Protección de Datos:** Cualquier ley de protección de datos o privacidad aplicable al procesamiento de Datos Personales por parte de Runner AI bajo los Términos, sus regulaciones de implementación y legislación secundaria, cada una según pueda ser enmendada, actualizada o reemplazada de vez en cuando, incluidas las leyes que se aplican en función de la ubicación o residencia del Comerciante y/o Su(s) Cliente(s).
**B. Cliente:** Una persona física o entidad que visita, interactúa con y/o compra un producto, bien o servicio de Su(s) Tienda(s).
**C. Solicitud de Derechos de Datos:** Una solicitud válida y legal de un individuo para ejercer los derechos disponibles relacionados con los Datos Personales bajo una Ley Aplicable de Protección de Datos.
**D. Controlador de Datos o Empresa:** La Parte que determina los propósitos y medios del procesamiento de Datos Personales, o según se defina de otro modo bajo cualquier Ley Aplicable de Protección de Datos.
**E. Procesador de Datos o Proveedor de Servicios:** La Parte u otra entidad o empresa que proporciona servicios en nombre de y procesa Datos Personales bajo la dirección y en nombre del Controlador de Datos o según se defina bajo cualquier Ley Aplicable de Protección de Datos.
**F. Datos Personales:** Información o datos definidos como 'datos personales', 'información personal' o 'información de identificación personal' (o término análogo) bajo las Leyes Aplicables de Protección de Datos.
**G. Violación de Datos Personales:** En relación con Sus Datos Personales de Clientes, se interpretará de acuerdo con las Leyes Aplicables de Protección de Datos.
**H. "Procesar", "procesa" o "procesamiento":** (a) Cualquier operación o conjunto de operaciones que se realiza sobre Datos Personales o sobre conjuntos de Datos Personales, ya sea por medios automatizados o no, como recopilación, registro, organización, estructuración, almacenamiento, adaptación o alteración, recuperación, consulta, uso, divulgación por transmisión, difusión o puesta a disposición de otro modo, alineación o combinación, restricción, borrado o destrucción; o (b) la definición dada a dicho(s) término(s) bajo la(s) Ley(es) Aplicable(s) de Protección de Datos.
**I. "Subprocesador(es)":** Empresas afiliadas o Procesadores de Datos o Proveedores de Servicios de terceros que pueden procesar Datos Personales bajo la dirección de Runner AI con el propósito de proporcionar los Servicios.
**J. "Usted", "Su" o "Comerciante":** Significa cada negocio que Usted opera y que usa o se beneficia de los Servicios, los Servicios Mejorados u otros Servicios Adicionales y es una Parte de los Términos con Runner AI.
**K. "Sus Datos Personales de Clientes":** Datos Personales de o sobre Sus Clientes excluyendo cualquier Dato Personal sobre Clientes que Runner AI recibe como resultado de la relación del Cliente con Runner AI, que se rige por la Política de Privacidad del Consumidor de Runner AI y no por este APD.
### III. NATURALEZA DEL PROCESAMIENTO Y ROLES DE LAS PARTES
**Runner AI como Procesador de Datos o Proveedor de Servicios.** Runner AI recibe y procesa Sus Datos Personales de Clientes para proporcionarle los Servicios y según se establece a continuación. Dependiendo de cuál de los Servicios solicite o use, Runner AI procesará las categorías de Datos Personales establecidas en el Apéndice A, de la manera y sobre las bases contenidas en el mismo.
Runner AI procesará Sus Datos Personales de Clientes como Procesador de Datos o Proveedor de Servicios solo para proporcionar los Servicios instruidos en los Términos y cualquier Término complementario y según sea necesario para proporcionar, desarrollar y mejorar sus Servicios y participar en cualquier otro propósito permitido por las Leyes Aplicables de Protección de Datos.
**Runner AI como Controlador de Datos o Empresa.** Runner AI procesará Sus Datos Personales de Clientes como Controlador de Datos o Empresa (a) en las circunstancias y de la manera establecida en el Apéndice E, y (b) para cualquier propósito adicional compatible con las instrucciones del Cliente y la Ley Aplicable de Protección de Datos.
### IV. OBLIGACIONES DE LAS PARTES
La siguiente sección describe las obligaciones respectivas de las Partes con respecto al procesamiento de Datos Personales cubiertos por este APD.
#### A. Cumplimiento General
1. Las Partes cumplirán con sus respectivas obligaciones bajo las Leyes Aplicables de Protección de Datos.
2. Runner AI no tendrá obligación de interpretar o asesorarle sobre Sus obligaciones bajo las Leyes Aplicables de Protección de Datos, incluido con respecto al procesamiento de Datos Personales cubiertos por este APD. Usted es el único responsable de determinar Sus obligaciones legales y regulatorias, incluida la evaluación de si las medidas técnicas y organizativas de los Servicios son consistentes con Sus obligaciones legales y regulatorias independientes.
#### B. Obligaciones de Runner AI
##### 1. Seguridad de Datos
Runner AI implementará y mantendrá medidas técnicas y organizativas apropiadas diseñadas para proteger Sus Datos Personales de Clientes contra procesamiento no autorizado o ilegal y contra pérdida, destrucción, daño, robo, alteración o divulgación accidentales, según se establece en el Apéndice B.
##### 2. Notificación e Investigación de Violación de Datos Personales
a) Según lo requerido por las Leyes Aplicables de Protección de Datos, Runner AI le proporcionará aviso al confirmar cualquier Violación de Datos Personales.
b) Dicho aviso incluirá la información requerida bajo las Leyes Aplicables de Protección de Datos en la medida en que dicha información esté razonablemente disponible para Runner AI. La respuesta de Runner AI a, o el aviso de, una Violación de Datos Personales no es un reconocimiento por parte de Runner AI de ninguna falta o responsabilidad.
c) Runner AI acepta investigar cualquier Violación de Datos Personales y usar esfuerzos comercialmente razonables para identificar, prevenir, mitigar y remediar los efectos.
#### C. Sus Obligaciones con Respecto a los Datos Personales
##### 1. Avisos de Privacidad y Transparencia
Usted declara y garantiza que está en cumplimiento con todas las obligaciones bajo las Leyes Aplicables de Protección de Datos para proporcionar aviso y transparencia con respecto a Su procesamiento de Sus Datos Personales de Clientes bajo los Términos y en relación con Su uso de los Servicios. De conformidad con las Leyes Aplicables de Protección de Datos, Usted comunicará a los individuos relevantes todas las divulgaciones necesarias para que Runner AI procese lícita y justamente Sus Datos Personales de Clientes en relación con este APD, incluido cuando reciba Servicios Mejorados u otros Servicios Adicionales, proporcionando un enlace a la Política de Privacidad del Consumidor de Runner AI y a Su Política de Privacidad y proporcionando otras divulgaciones según se establece en la Sección 9 de los Términos.
##### 2. Derechos y Permisos de Clientes
Usted declara y garantiza que tiene todos los derechos, permisos y consentimientos necesarios para poner a disposición Sus Datos Personales de Clientes a Runner AI, y para que Runner AI procese Sus Datos Personales de Clientes para que Usted reciba los Servicios, incluidos los Servicios Mejorados u otros Servicios Adicionales que reciba, de acuerdo con los Términos, este APD y las Leyes Aplicables de Protección de Datos.
##### 3. Solicitudes de Derechos de Datos
Usted declara y garantiza que proporciona la capacidad para que Sus Clientes ejerzan Solicitudes de Derechos de Datos, según lo requerido bajo las Leyes Aplicables de Protección de Datos, con respecto al procesamiento de Sus Datos Personales de Clientes por parte de Runner AI para los cuales Usted es el Controlador de Datos.
##### 4. Consultas Regulatorias
A menos que esté prohibido por la ley aplicable, Usted nos notificará prontamente de acuerdo con la disposición de Aviso en los Términos de cualquier consulta o queja gubernamental, regulatoria o de terceros con respecto a Su uso de los Servicios.
### V. VARIOS
#### A. Transferencias Globales de Datos
Usted reconoce que Sus Datos Personales de Clientes pueden ser transferidos y procesados en cualquier país en el que Runner AI, sus empresas afiliadas o proveedores de servicios de terceros estén ubicados. Cualquier transferencia de Sus Datos Personales de Clientes a estos destinatarios se realizará en cumplimiento con las Leyes Aplicables de Protección de Datos. Para obtener más información sobre transferencias internacionales de datos, cuando Runner AI esté sujeto a requisitos de protección de datos en el EEE, el RU o Suiza, consulte la Sección II(B)(8) del Apéndice C.
#### B. Respuesta a Solicitudes Legales
1. Usted reconoce que, en el curso de proporcionarle los Servicios, Runner AI puede compartir Sus Datos Personales de Clientes (i) para cumplir con requisitos legales o para responder a órdenes judiciales u otras demandas gubernamentales o regulatorias similares; o (ii) para prevenir o investigar presunto fraude, amenazas a la seguridad física, actividad ilegal o violaciones de un contrato (como los Términos de Servicio) o nuestras políticas (como nuestra Política de Uso Aceptable).
2. Runner AI hará esfuerzos razonables antes de producir Sus Datos Personales de Clientes para asegurar que dicha divulgación esté permitida bajo las Leyes Aplicables de Protección de Datos y será tratada como información confidencial bajo el marco legal aplicable.
#### C. Divulgación en Transacciones Corporativas
Usted reconoce que, en el curso de proporcionarle los Servicios, Runner AI puede ser requerido a compartir Sus Datos Personales de Clientes con posibles contrapartes de cualquier transacción corporativa o de reestructuración.
#### D. Uso de Proveedores de Servicios por parte de Runner AI
1. Usted reconoce y acepta que, en el curso de proporcionarle los Servicios, Runner AI puede usar proveedores de servicios para procesar Sus Datos Personales de Clientes. Runner AI mantiene una lista actualizada de todos los proveedores de servicios utilizados. Si las Leyes Aplicables de Protección de Datos le otorgan tales derechos, Usted puede objetar el uso de un proveedor de servicios por parte de Runner AI, y si Runner AI no puede o no está dispuesto a acomodar tales solicitudes, Usted puede, de acuerdo con dichas leyes, terminar Su uso de los Servicios impactados dentro de los 30 días de dicha notificación de acuerdo con los Términos.
2. El uso de proveedores de servicios por parte de Runner AI para procesar Sus Datos Personales de Clientes que Usted proporciona estará en cumplimiento con las Leyes Aplicables de Protección de Datos. Cuando Runner AI contrate a un proveedor de servicios, Runner AI celebrará un acuerdo por escrito con el proveedor de servicios que impone obligaciones contractuales que son sustancialmente las mismas que las establecidas en este APD.
#### E. Enmienda del APD
Usted reconoce y acepta que Runner AI puede enmendar este APD de vez en cuando publicando el APD enmendado y reestablecido relevante en el sitio web de Runner AI, disponible en https://www.runnerai.com/docs/es/legal/dpa y tales enmiendas al APD son efectivas a partir de la fecha de publicación. Su uso continuo de los Servicios después de que el APD enmendado se publique en el sitio web de Runner AI constituye Su acuerdo y aceptación del APD enmendado. Si no está de acuerdo con ningún cambio en el APD, no continúe usando los Servicios.
### VI. APÉNDICES
1. [Apéndice A - Categorías de Datos Personales](#apéndice-a-categorías-de-datos-personales)
2. [Apéndice B - Seguridad de Datos](#apéndice-b-seguridad-de-datos)
3. [Apéndice C - RGPD, RGPD del RU y Apéndice de Procesamiento de Datos de Suiza](#apéndice-c-rgpd-rgpd-del-ru-y-apéndice-de-procesamiento-de-datos-de-suiza)
4. [Apéndice D - Leyes de Protección de Datos de EE. UU.](#apéndice-d-leyes-de-protección-de-datos-de-ee-uu)
5. [Apéndice E - Runner AI como Controlador de Datos o Empresa para Servicios Mejorados](#apéndice-e-runner-ai-como-controlador-de-datos-o-empresa-para-servicios-mejorados)
---
## APÉNDICE A: CATEGORÍAS DE DATOS PERSONALES
Como parte de Su uso de los Servicios, y dependiendo de qué Servicios use, podemos recibir y procesar las siguientes categorías de Datos Personales para proporcionar los Servicios:
- Identificadores, incluidos nombre, dirección de correo electrónico, dirección postal, número de teléfono
- Categorías de información personal enumeradas en el estatuto de Registros de Clientes de California, incluidos nombre, dirección postal y de facturación, número de teléfono, información de tarjeta de crédito o débito
- Información comercial, incluidos productos que compra, coloca en su carrito de compras, favoritos o reseñas (si es un cliente) e información que nos proporciona sobre usted y su negocio (si es un comerciante)
- Fotos y videos, que pueden incluir imágenes faciales, si elige proporcionarlas
- Información de actividad de red electrónica o de Internet, incluida información sobre el dispositivo y navegador que usa, conexión de red, dirección IP y cómo navega por nuestros sitios
- Datos de geolocalización, incluida su dirección postal y de facturación
- Inferencias, o información derivada de otra información personal sobre usted, que podría incluir sus preferencias, intereses y otra información utilizada para personalizar su experiencia
- Información personal sensible, que puede incluir:
- Identificadores emitidos por el gobierno, incluidos número de seguro social, licencia de conducir, tarjeta de identificación estatal o número de pasaporte
- Sus credenciales de acceso a la cuenta (como inicio de sesión de cuenta, cuenta financiera, número de tarjeta de débito o crédito en combinación con cualquier código de acceso de seguridad requerido, contraseña o credenciales que permitan el acceso a una cuenta)
---
## APÉNDICE B: SEGURIDAD DE DATOS
Runner AI mantendrá un programa de seguridad de la información diseñado para (a) permitirle asegurar Sus Datos Personales de Clientes contra procesamiento no autorizado o ilegal y contra pérdida, destrucción, daño, robo, alteración o divulgación accidentales; (b) identificar riesgos razonablemente previsibles para la seguridad y disponibilidad de los Servicios que Usted recibe; y (c) minimizar los riesgos de seguridad para los Servicios.
### I. El programa de seguridad de la información de Runner AI incluirá las siguientes salvaguardas:
#### A. Seguridad Lógica
##### 1. Controles de Acceso
Runner AI hará que sus sistemas sean accesibles solo para el personal autorizado, y solo según sea necesario para mantener y proporcionar los Servicios. Runner AI mantendrá controles de acceso y políticas diseñadas para administrar autorizaciones para el acceso a sus sistemas, incluso mediante el uso de cortafuegos y/u otra tecnología y controles de autenticación.
##### 2. Acceso Restringido de Usuarios
Runner AI (i) aprovisionará y restringirá el acceso a sus sistemas de acuerdo con principios de mínimo privilegio basados en las funciones laborales del personal, y (ii) requerirá autenticación de dos factores (2FA) para el acceso a sus sistemas.
##### 3. Evaluaciones de Vulnerabilidad
Runner AI mantendrá un programa de evaluación de vulnerabilidad y pruebas de penetración, responsable de investigar y rastrear problemas identificados con los Servicios hasta su resolución cuando sea necesario.
##### 4. Seguridad de Aplicaciones
Runner AI mantiene un programa de seguridad de aplicaciones responsable de proteger los Servicios de amenazas de seguridad de aplicaciones.
##### 5. Gestión de Cambios
Runner AI mantendrá controles diseñados para registrar, autorizar, probar, aprobar y documentar cambios en los recursos de Servicios existentes, y documentará los detalles de cambios dentro de sus herramientas de gestión de cambios o implementación. Runner AI probará los cambios de acuerdo con sus estándares de gestión de cambios antes de la migración a producción.
##### 6. Integridad de Datos
Según corresponda, Runner AI mantendrá controles diseñados para proporcionar integridad de datos durante la transmisión, almacenamiento y procesamiento dentro de los Servicios.
##### 7. Disponibilidad
Runner AI (i) implementará redundancia cuando sea apropiado para los Servicios para minimizar el efecto de un mal funcionamiento en los Servicios, (ii) diseñará los Servicios para anticipar y tolerar fallas, y (iii) implementará procesos apropiados diseñados para mover el tráfico de Datos Personales lejos de las áreas afectadas cuando sea necesario para recuperarse de fallas.
##### 8. Continuidad del Negocio y Recuperación ante Desastres
Runner AI mantendrá un programa de gestión de riesgos diseñado para apoyar la continuidad de sus funciones comerciales críticas, incluidos procesos y procedimientos para la identificación, respuesta y recuperación de eventos que podrían prevenir o deteriorar materialmente la provisión por parte de Runner AI de los Servicios que Usted recibe.
##### 9. Gestión de Incidentes
Runner AI proporciona documentación para que Usted informe incidentes de seguridad o disponibilidad, haga preguntas de seguridad o disponibilidad y envíe información sobre posibles problemas de seguridad o disponibilidad. Runner AI mantendrá planes de acción correctiva y planes de respuesta a incidentes diseñados para detectar, mitigar, investigar y responder a posibles amenazas de seguridad para los Servicios.
#### B. Seguridad Física
Cuando sea necesario para proteger los Servicios, Runner AI (i) implementará medidas razonables diseñadas para prevenir el acceso físico no autorizado, daño o interferencia a los Servicios, (ii) usará dispositivos de control apropiados diseñados para restringir el acceso físico a los Servicios solo al personal autorizado que tenga una necesidad comercial legítima de dicho acceso, y (iii) realizará revisiones periódicas para validar el cumplimiento de estos estándares.
#### C. Empleados de Runner AI
Los empleados de Runner AI que están autorizados para acceder a Sus Datos Personales de Clientes están sujetos a obligaciones de confidencialidad como parte de sus términos de empleo. Runner AI implementará y mantendrá programas de capacitación de seguridad para empleados con respecto a los requisitos de seguridad de la información de Runner AI. Los programas de capacitación de conciencia de seguridad se revisarán y actualizarán periódicamente.
### II. Modificaciones a este Apéndice
Runner AI revisa sus medidas de seguridad de vez en cuando, y puede actualizar este Apéndice a su sola discreción. Cualquier actualización de este tipo reemplazará las versiones anteriores de este Apéndice a partir de la fecha en que Runner AI publique la versión actualizada.
---
## APÉNDICE C: RGPD, RGPD DEL RU Y APÉNDICE DE PROCESAMIENTO DE DATOS DE SUIZA
Cuando el procesamiento de Sus Datos Personales de Clientes bajo el APD esté sujeto a requisitos de protección de datos en el Área Económica Europea (el "EEE"), el Reino Unido (el "RU") o Suiza (colectivamente, "Leyes Europeas de Protección de Datos"), y Runner AI actúe como Procesador de Datos, el Apéndice C complementa este APD.
### I. Naturaleza del Procesamiento y Rol de las Partes
#### A. Datos Personales
Bajo este Apéndice, Usted actuará como Controlador de Datos y Runner AI actuará como Procesador de Datos con respecto al procesamiento de Sus Datos Personales de Clientes según se describe en el Anexo 1, según sea necesario para cumplir con los propósitos comerciales descritos en los Términos y proporcionarle los Servicios que elija usar.
### II. Obligaciones de las Partes
#### A. Sus Obligaciones
Usted cumplirá con:
- Las Leyes Europeas de Protección de Datos que le vinculan en relación con Su uso de los Servicios; y
- Sus obligaciones establecidas en el APD, incluidas Sus obligaciones establecidas en este Apéndice.
Usted declara y garantiza que tiene una base legal válida para procesar Sus Datos Personales de Clientes (incluida la puesta a disposición de dichos datos a Runner AI) y ha obtenido los consentimientos, derechos y autorizaciones necesarios y ha dado los avisos necesarios a los individuos para permitir el procesamiento por parte de Runner AI de Sus Datos Personales de Clientes para proporcionar los Servicios, según lo requerido por las Leyes Europeas de Protección de Datos.
#### B. Obligaciones de Runner AI
##### 1. Instrucciones del Controlador e Infracción de las Leyes Europeas de Protección de Datos
a) Las Partes acuerdan que los Términos junto con este APD constituyen Sus instrucciones documentadas con respecto al procesamiento por parte de Runner AI de Sus Datos Personales de Clientes ("Instrucciones documentadas").
b) Runner AI procesará Sus Datos Personales de Clientes como Procesador de Datos: (i) de acuerdo con Sus Instrucciones documentadas, o (ii) para cumplir con las obligaciones de Runner AI bajo las leyes aplicables, sujeto a cualquier requisito de aviso bajo la ley del EEE, estado miembro del EEE, RU o Suiza a la que Runner AI esté sujeto.
c) Runner AI le notificará si recibe una instrucción que razonablemente determina que infringe las Leyes Europeas de Protección de Datos (pero Runner AI no tiene obligación de monitorear activamente Su cumplimiento con las Leyes Europeas de Protección de Datos).
##### 2. Obligación de confidencialidad
Runner AI se asegurará de que las personas que autoriza para procesar Sus Datos Personales de Clientes celebren acuerdos de confidencialidad por escrito o estén sujetas a obligaciones estatutarias de confidencialidad.
##### 3. Medidas de seguridad
a) Runner AI implementará y mantendrá medidas técnicas y organizativas apropiadas diseñadas para proteger Sus Datos Personales de Clientes contra procesamiento no autorizado o ilegal y contra pérdida, destrucción, daño, robo, acceso no autorizado, alteración o divulgación accidentales, según se establece en el Anexo 2.
b) Teniendo en cuenta la naturaleza de Sus Datos Personales de Clientes y el procesamiento relacionado, Runner AI proporcionará la asistencia razonable que Usted pueda solicitar razonablemente para ayudarle a cumplir con Sus obligaciones de seguridad bajo las Leyes Europeas de Protección de Datos.
c) Runner AI le proporcionará aviso, sin demora indebida, al tener conocimiento de una violación de seguridad que conduzca a la destrucción, pérdida, alteración, divulgación no autorizada de, o acceso a, Sus Datos Personales de Clientes transmitidos, almacenados o procesados de otro modo accidentales o ilegales.
d) Runner AI acepta investigar cualquier violación de seguridad de este tipo y usar esfuerzos comercialmente razonables para mitigar los efectos.
##### 4. Subprocesadores
a) Usted autoriza generalmente a Runner AI a contratar Subprocesadores para procesar Sus Datos Personales de Clientes. Además, acepta que Runner AI puede contratar a sus afiliadas como Subprocesadores.
b) El uso de Subprocesadores por parte de Runner AI para procesar Sus Datos Personales de Clientes estará en cumplimiento con las Leyes Europeas de Protección de Datos.
c) Runner AI mantiene una lista actualizada de todos los Subprocesadores según se establece en el Anexo 3. Runner AI actualizará la lista de Subprocesadores según corresponda y le proporcionará un mecanismo para obtener aviso de la adición o reemplazo de un Subprocesador. Usted puede objetar el uso de un nuevo Subprocesador por parte de Runner AI.
d) En la medida en que objete el uso de un Subprocesador por parte de Runner AI, y Runner AI no pueda o no esté dispuesto a acomodar tales solicitudes, Usted puede terminar Su uso de los Servicios impactados dentro de los 30 días de dicha notificación de acuerdo con los Términos.
e) Cuando Runner AI contrate a un nuevo Subprocesador, Runner AI celebrará un acuerdo por escrito con el Subprocesador y Runner AI impondrá, al Subprocesador, obligaciones contractuales que son sustancialmente las mismas que las establecidas en este APD. Runner AI será totalmente responsable de los actos y omisiones de sus Subprocesadores en la misma medida en que Runner AI sería responsable si realizara los servicios de cada Subprocesador directamente bajo los términos de este APD. No obstante, la responsabilidad de Runner AI estará sujeta a las condiciones y limitación de responsabilidad establecidas en los Términos.
##### 5. Asistencia al Controlador
Teniendo en cuenta la naturaleza de Sus Datos Personales de Clientes y el procesamiento relacionado, Runner AI proporcionará la asistencia razonable que Usted pueda solicitar razonablemente para ayudarle a cumplir con Sus obligaciones:
- para responder a Solicitudes de Derechos de Datos bajo las Leyes Europeas de Protección de Datos, con respecto a todo el procesamiento de Sus Datos Personales de Clientes por parte de Runner AI;
- para notificar a las autoridades relevantes y/o sujetos de datos de una Violación de Datos Personales;
- para realizar evaluaciones de impacto de protección de datos y consultas previas;
- para asegurar la seguridad del procesamiento de acuerdo con la sección 3.
##### 6. Evaluación del cumplimiento
a) Runner AI puede cumplir con Su derecho de auditoría bajo las Leyes Europeas de Protección de Datos en relación con el procesamiento de Sus Datos Personales de Clientes proporcionándole - a Su solicitud por escrito y sujeto a confidencialidad - con:
(i) Los resultados del informe de auditoría más reciente de Runner AI, ya sea de las auto-auditorías de Runner AI o preparado por un auditor tercero independiente;
(ii) información adicional en el control de Runner AI si una autoridad de protección de datos o gubernamental lo solicita.
b) Siempre que y solo en la medida en que las Leyes Europeas de Protección de Datos le otorguen este derecho, Usted puede ejercer Su derecho de Auditoría: (i) en la medida en que un auditor independiente reconocido internacionalmente certifique que la provisión por parte de Runner AI de un informe de auditoría no proporciona información suficiente para que Usted verifique el cumplimiento de Runner AI con este APD y con las Leyes Europeas de Protección de Datos o (ii) según sea necesario para que Usted responda a una auditoría de autoridad gubernamental. Cada auditoría debe ajustarse a los siguientes parámetros: (i) ser realizada por un tercero independiente que celebrará un acuerdo de confidencialidad con Runner AI; (ii) estar limitada en alcance a asuntos razonablemente requeridos, y según se acuerde mutuamente, para que Usted evalúe el cumplimiento de Runner AI con este APD y el cumplimiento de las partes con las Leyes Europeas de Protección de Datos; (iii) ocurrir en una fecha y hora mutuamente acordadas y solo durante el horario comercial regular de Runner AI; (iv) ocurrir no más de una vez al año (a menos que sea requerido bajo las Leyes Europeas de Protección de Datos); (v) cubrir solo instalaciones controladas por Runner AI; (vi) restringir los hallazgos solo a Sus Datos Personales de Clientes; y (vii) tratar cualquier resultado como información confidencial en la mayor medida permitida por las Leyes Europeas de Protección de Datos. Para aclaración, Runner AI cumplirá con cualquiera de Sus derechos bajo esta sección 6 de acuerdo con sus obligaciones de confidencialidad con terceros.
##### 7. Fin del procesamiento
a) Durante Su uso de los Servicios, Usted puede aprovechar las herramientas de cuenta para acceder, devolver a sí mismo o eliminar Sus Datos Personales de Clientes.
b) Después de la terminación, Runner AI, a Su elección, eliminará o devolverá Sus Datos Personales de Clientes. No obstante lo anterior, Runner AI puede retener Sus Datos Personales de Clientes: (i) según lo requerido por ley, incluidas las Leyes Europeas de Protección de Datos; y (ii) de acuerdo con sus políticas estándar de respaldo o retención de registros, siempre que, en cualquier caso, Runner AI mantenga la confidencialidad de, y de otro modo cumpla con las disposiciones aplicables de este APD con respecto a, Sus Datos Personales de Clientes retenidos, y no Procese adicionalmente Sus Datos Personales de Clientes retenidos excepto para tal(es) propósito(s) y duración permitidos bajo tales leyes aplicables.
##### 8. Transferencias Internacionales
a) Usted reconoce que en el curso de proporcionar los Servicios, Adaptive Machines, Inc., una empresa con sede en los Estados Unidos, procesará Sus Datos Personales de Clientes en servidores ubicados en los Estados Unidos.
b) Cuando Runner AI participe en una Transferencia Internacional (es decir, una transferencia de Sus Datos Personales de Clientes desde el Área Económica Europea (EEE), el Reino Unido (RU) o Suiza a un país fuera de esas regiones que no esté reconocido como que proporciona un nivel adecuado de protección de datos), lo hará en cumplimiento con las Leyes Europeas de Protección de Datos.
c) En la medida en que Runner AI sea el destinatario de Sus Datos Personales de Clientes en un país que no asegure un nivel adecuado de protección de datos, las Partes acuerdan que tales transferencias estarán sujetas a salvaguardas apropiadas, específicamente los siguientes mecanismos de transferencia: (i) Las Cláusulas Contractuales Estándar para la transferencia de datos personales a terceros países de conformidad con el Reglamento (UE) 2016/679 del Parlamento Europeo y del Consejo, según lo aprobado por la Decisión de Implementación de la Comisión Europea (UE) 2021/914 del 4 de junio de 2021 (las "CCE de la UE"); y/o (ii) Para transferencias desde el Reino Unido, el Anexo Internacional de Transferencia de Datos a las cláusulas contractuales estándar de la Comisión Europea, emitido por la Oficina del Comisionado de Información del RU bajo S119A(1) de la Ley de Protección de Datos del RU de 2018 (el "Anexo del RU"); y/o (iii) Para transferencias desde Suiza, las CCE de la UE según se enmienden para satisfacer los requisitos de la Ley Federal Suiza de Protección de Datos.
d) Al aceptar este APD, se considera que ha firmado los mecanismos de transferencia aplicables, que se incorporan por referencia y forman parte integral de este APD.
### ANEXO 1 - DATOS PERSONALES
#### DESCRIPCIÓN DEL PROCESAMIENTO DE DATOS PERSONALES
**I. Objeto del Procesamiento**
Provisión de Servicios de Runner AI al Comerciante.
**II. Categorías de Sujetos de Datos**
Clientes del Comerciante.
**III. Categorías de Datos Personales Procesados**
Ver Apéndice A anterior.
**IV. Frecuencia de la transferencia**
Continua.
**V. Naturaleza del Procesamiento**
Recopilación, registro, alojamiento, acceso, uso, transferencia y eliminación de Datos Personales según se describe en los Términos.
**VI. Propósitos para los Cuales los Datos Personales se Procesan en Nombre del Controlador**
Para el desempeño y mejora de los Servicios según se describe en los Términos.
**VII. Duración del Procesamiento**
Duración de los Servicios bajo los Términos o acuerdo aplicable, más el período después de dicho vencimiento hasta la anonimización, devolución o eliminación de datos.
**VIII. Autoridad Supervisora Competente**
La autoridad supervisora competente se determinará de acuerdo con el RGPD.
### ANEXO 2 - MEDIDAS DE SEGURIDAD
La información sobre medidas de seguridad se proporciona en el Apéndice B del APD.
### ANEXO 3 - LISTA DE SUBPROCESADORES
Los Subprocesadores utilizados por Runner AI para el desempeño de los Servicios bajo los Términos se enumeran aquí.
Los Subprocesadores procesarán las categorías de Datos Personales descritas anteriormente en relación con los Servicios durante la duración de su acuerdo con Runner AI.
---
## APÉNDICE D: LEYES DE PROTECCIÓN DE DATOS DE EE. UU.
Esta sección se aplica solo en la medida en que: (i) las Leyes de Protección de Datos de EE. UU. se apliquen a Usted y/o Sus Datos Personales de Clientes en relación con Su uso de los Servicios; (ii) las siguientes disposiciones sean requeridas por las Leyes de Protección de Datos de EE. UU.; y (iii) Runner AI esté actuando como Procesador de Datos o Proveedor de Servicios. Para mayor claridad, este Apéndice D no se aplicará a las actividades de procesamiento descritas en el Apéndice E.
Las Partes acuerdan que los Términos junto con este APD constituyen Sus instrucciones documentadas con respecto al procesamiento por parte de Runner AI de Sus Datos Personales de Clientes ("Instrucciones documentadas").
Salvo lo establecido en el Apéndice E si recibe ciertos Servicios Mejorados, Runner AI no: (i) retendrá, usará o divulgará Sus Datos Personales de Clientes fuera de su relación comercial directa con Usted o para cualquier otro propósito que no sea para los propósitos limitados y específicos identificados en este APD y/o los Términos, incluido proporcionar, desarrollar y mejorar los Servicios o según lo permitido de otro modo por las Leyes Aplicables de Protección de Datos de EE. UU., o (ii) "venderá" o "compartirá" Sus Datos Personales de Clientes o participará en "publicidad dirigida" con Sus Datos Personales de Clientes dentro del significado de la CCPA u otras Leyes de Protección de Datos de EE. UU.; o (iii) combinará Sus Datos Personales de Clientes con Datos Personales que recibe de otras fuentes, en cada caso excepto según lo permitido bajo las Leyes de Protección de Datos de EE. UU.
Runner AI: (i) proporcionará el mismo nivel de protección de privacidad requerido de las Empresas o Controladores de Datos por las Leyes de Protección de Datos de EE. UU., e informará a Usted si determina que ya no puede cumplir con estas obligaciones, en cuyo caso Usted puede tomar medidas razonables y apropiadas para detener o remediar cualquier procesamiento no autorizado de Sus Datos Personales de Clientes, (ii) se asegurará de que el personal que autoriza para procesar Sus Datos Personales de Clientes celebre acuerdos de confidencialidad por escrito o esté sujeto a obligaciones estatutarias de confidencialidad, (iii) a solicitud razonable por escrito, y como parte de permitirle tomar medidas razonables y apropiadas para asegurar que Runner AI use Sus Datos Personales de Clientes de manera consistente con las Leyes de Protección de Datos de EE. UU., proporcionará el informe SOC2 que muestre una evaluación razonable del programa de seguridad de la información de Runner AI; y (iv) al terminar sus Servicios para Usted, Runner AI iniciará su proceso de purga para eliminar, devolver o desidentificar Sus Datos Personales de Clientes proporcionados a Runner AI para procesamiento únicamente como Procesador de Datos o Proveedor de Servicios.
Usted declara y garantiza que no compartirá con Runner AI ningún Dato Personal de un individuo que haya ejercido un derecho de exclusión que Usted se haya comprometido a honrar o cualquier dato personal sensible de un individuo que no haya consentido el procesamiento de dichos datos sensibles de acuerdo con los requisitos bajo las Leyes Aplicables de Protección de Datos.
---
## APÉNDICE E: RUNNER AI COMO CONTROLADOR DE DATOS O EMPRESA PARA SERVICIOS MEJORADOS
Runner AI actuará como Controlador de Datos o Empresa cuando Usted reciba los Servicios Mejorados según se define en la Sección 9 de los Términos de Servicio. Runner AI puede actualizar los servicios y productos para los cuales actúa como Controlador de Datos o Empresa de vez en cuando.
Como parte de la provisión por parte de Runner AI de los Servicios Mejorados, usted acepta que Runner AI procesará Sus Datos Personales de Clientes como Controlador de Datos o Empresa bajo las Leyes Aplicables de Protección de Datos para proporcionar, desarrollar y mejorar análisis, personalización de productos, publicidad y otros servicios a Usted y otros Comerciantes que incorporen las interacciones y transacciones de Sus Clientes con Su Tienda, con otros Comerciantes y con Runner AI. Cuando Runner AI procese Sus Datos Personales de Clientes de esta manera, se aplican la Política de Privacidad del Consumidor de Runner AI y este Apéndice E de este APD. Puede deshabilitar el uso por parte de Runner AI de Sus Datos Personales de Clientes de esta manera deshabilitando la Inteligencia de Red de Runner AI aquí.
### 1. Avisos de Privacidad, Transparencia y Derechos
De conformidad con las Leyes Aplicables de Protección de Datos, Usted comunicará a los individuos relevantes todas las divulgaciones necesarias para que Runner AI procese lícita y justamente Sus Datos Personales de Clientes para proporcionar Servicios Mejorados a Usted en relación con este Apéndice E del APD, incluido proporcionando un enlace a la Política de Privacidad del Consumidor de Runner AI en su política de privacidad y proporcionando las divulgaciones según se establece en la Sección 9.2.5 de los Términos de Servicio.
### 2. Requisitos Europeos
Si Usted tiene su sede en el EEE, Reino Unido o Suiza, o si Sus Clientes están en el EEE, Reino Unido o Suiza, Usted acepta, declara y garantiza que ha obtenido el consentimiento de los Clientes, y proporciona a los Clientes la capacidad de ejercer el derecho de retirar el consentimiento, objetar cierto procesamiento y optar por no participar en cierto procesamiento, cuando sea requerido por las Leyes Aplicables de Protección de Datos. Para mayor claridad, debe obtener consentimiento para publicidad dirigida como parte de los Servicios Mejorados, y el uso de cookies u otras tecnologías de almacenamiento local en la medida requerida por las Leyes Aplicables de Protección de Datos.
### 3. Responsabilidades del Controlador
Usted es un Controlador de Datos de Sus Datos Personales de Clientes y determinará individualmente los propósitos y medios de Su procesamiento de Sus Datos Personales de Clientes y cómo usar y procesar Sus Datos Personales de Clientes, incluida la determinación de la base legal para Su procesamiento bajo la Ley Aplicable de Protección de Datos. Runner AI es un Controlador de Datos de Sus Datos Personales de Clientes que procesa de acuerdo con este Apéndice E y determinará individualmente los propósitos y medios de su procesamiento de tales Datos Personales y cómo usar y procesar tales Datos Personales, incluida la determinación de la base legal para su procesamiento bajo la Ley Aplicable de Protección de Datos.
Cada Parte es individualmente responsable de responder a las Solicitudes de Derechos de Datos que recibe relacionadas con su procesamiento de Sus Datos Personales de Clientes como Controlador de Datos.
### 4. Sin Efecto en el Resto del APD
Este Apéndice E no afectará de otro modo ningún Término, incluido el resto de este APD, que refleje una relación de Controlador de Datos-Procesador de Datos entre Comerciantes y Runner AI.
---
# Política de Privacidad para todos
Source: https://www.runnerai.com/docs/es/legal/policies
## Tabla de Contenido
1. [Introducción](#introducción)
2. [Nuestros valores](#nuestros-valores)
3. [Por qué procesamos su información](#por-qué-procesamos-su-información)
4. [Sus derechos sobre su información](#sus-derechos-sobre-su-información)
5. [Dónde enviamos su información](#dónde-enviamos-su-información)
6. [Google user data and Google integrations](#google-user-data-and-google-integrations)
7. [Cuánto tiempo conservamos su información](#cuánto-tiempo-conservamos-su-información)
8. [Nuestro uso de Aprendizaje Automático](#nuestro-uso-de-aprendizaje-automático)
9. [Cómo protegemos su información](#cómo-protegemos-su-información)
10. [Cómo usamos "cookies" y otras tecnologías de seguimiento](#cómo-usamos-cookies-y-otras-tecnologías-de-seguimiento)
11. [Cómo puede contactarnos](#cómo-puede-contactarnos)
12. [Aviso de Privacidad Regional de Estados Unidos](#aviso-de-privacidad-regional-de-estados-unidos)
13. [Información Adicional para Usuarios en Ciertas Regiones](#información-adicional-para-usuarios-en-ciertas-regiones)
## Introducción
Esta Política de Privacidad describe cómo Adaptive Machines, Inc. ("Runner AI", "nosotros", "nos" o "nuestro") recopila, usa y divulga información personal cuando usted utiliza nuestro sitio web y servicios.
En nuestra misión de hacer que el comercio sea mejor para todos en Runner AI, recopilamos y utilizamos información sobre usted, nuestros:
- comerciantes que utilizan Runner AI para impulsar su negocio
- clientes que compran en un negocio impulsado por Runner AI
- visitantes de los sitios web de Runner AI, o cualquier persona que contacte al soporte de Runner AI
Si cambiamos nuestras prácticas de privacidad, podemos actualizar esta política de privacidad. Si algún cambio es significativo, se lo haremos saber (por ejemplo, a través del administrador de Runner AI o por correo electrónico).
## Nuestros valores
La confianza es la base de la plataforma Runner AI e incluye confiar en que hagamos lo correcto con su información. Tres valores principales nos guían mientras desarrollamos nuestros productos y servicios. Estos valores deberían ayudarle a comprender mejor cómo pensamos sobre su información y privacidad.
### Su información le pertenece
Analizamos cuidadosamente qué tipos de información necesitamos para proporcionar nuestros servicios, e intentamos limitar la información que recopilamos a solo lo que realmente necesitamos. Cuando es posible, eliminamos o anonimizamos esta información cuando ya no la necesitamos. Al construir y mejorar nuestros productos, nuestros ingenieros trabajan estrechamente con nuestros equipos de privacidad y seguridad para construir con la privacidad en mente. En todo este trabajo, nuestro principio rector es que su información le pertenece, y nuestro objetivo es usar su información solo para su beneficio.
### Protegemos su información de otros
Si un tercero solicita su información personal, nos negaremos a compartirla a menos que usted nos dé permiso o estemos legalmente obligados. Cuando estemos legalmente obligados a compartir su información personal, se lo informaremos con anticipación, a menos que estemos legalmente prohibidos.
### Ayudamos a los comerciantes a cumplir con sus obligaciones de privacidad
Muchos de los comerciantes que utilizan Runner AI no tienen el beneficio de un equipo de privacidad dedicado, y es importante para nosotros ayudarles a cumplir con sus obligaciones de privacidad. Para hacer esto, intentamos construir nuestros productos y servicios para que puedan usarse fácilmente de manera amigable con la privacidad. También proporcionamos preguntas frecuentes detalladas y documentación que cubre los temas de privacidad más importantes, y respondemos a las preguntas relacionadas con la privacidad que recibimos.
## Por qué procesamos su información
Generalmente procesamos su información cuando necesitamos hacerlo para cumplir con una obligación contractual (por ejemplo, para procesar los pagos de su suscripción para usar la plataforma Runner AI), o cuando nosotros o alguien con quien trabajamos necesita usar su información personal por una razón relacionada con su negocio (por ejemplo, para proporcionarle un servicio). Las leyes en el Espacio Económico Europeo ("EEE") y en el Reino Unido ("RU") llaman a estas razones "intereses legítimos". Estos "intereses legítimos" incluyen:
- prevenir riesgos y fraudes
- responder preguntas o proporcionar otros tipos de soporte
- proporcionar y mejorar nuestros productos y servicios
- proporcionar informes y análisis
- probar características o servicios adicionales
- asistir con marketing, publicidad u otras comunicaciones
Solo procesamos información personal para estos "intereses legítimos" después de considerar los riesgos potenciales para su privacidad y equilibrar cualquier riesgo con ciertas medidas, por ejemplo, proporcionando transparencia clara sobre nuestras prácticas de privacidad, ofreciéndole control sobre su información personal cuando sea apropiado, limitando la información que conservamos, limitando lo que hacemos con su información, a quién enviamos su información, cuánto tiempo conservamos su información, o las medidas técnicas que usamos para proteger su información.
También podemos procesar su información personal cuando usted haya proporcionado su consentimiento. En particular, cuando no podemos confiar en una base legal alternativa para el procesamiento, cuando usted nos ordena transferir información a un tercero, cuando recibimos sus datos de un tercero que ya viene con consentimiento, o cuando la ley nos exige que solicitemos su consentimiento (incluyendo en el contexto de algunas de nuestras actividades de ventas y marketing). En cualquier momento, tiene derecho a retirar su consentimiento cambiando sus opciones de comunicación, optando por no recibir nuestras comunicaciones o contactándonos.
Dependiendo de si usted es un comerciante, cliente o visitante, consulte nuestras políticas de privacidad complementarias, según corresponda, para comprender nuestros propósitos de procesamiento, categorías de destinatarios y base legal para el procesamiento de cada tipo de datos personales.
## Sus derechos sobre su información
Creemos que debería poder acceder y controlar su información personal sin importar dónde viva. Dependiendo de cómo use Runner AI, puede tener derecho a solicitar acceso, corregir, modificar, eliminar, transferir a otro proveedor de servicios, restringir u oponerse a ciertos usos de su información personal. No le cobraremos más ni le proporcionaremos un nivel diferente de servicio si ejerce alguno de estos derechos. Tenga en cuenta que varios de estos derechos se aplican solo en ciertas circunstancias, y todos estos derechos pueden estar limitados por ley.
Si compra algo o proporciona su información a una tienda impulsada por Runner AI y desea ejercer estos derechos sobre información sobre su compra o interacción, debe contactar directamente al comerciante con el que interactuó. Somos un procesador y procesamos información en su nombre. Por supuesto, ayudaremos a nuestros comerciantes a cumplir con estas solicitudes en la medida requerida por ley, como proporcionándoles las herramientas para hacerlo y respondiendo a sus preguntas.
Si usted es un comerciante, empleado de Runner AI, visitante del sitio web u otra persona con quien Runner AI tiene una relación directa, envíe una solicitud verificable enviándonos un correo electrónico a support@adaptivemachines.ai. Tenga en cuenta que si nos envía una solicitud relacionada con su información personal, tenemos que asegurarnos de que sea usted antes de poder responder. Para hacerlo, podemos utilizar un tercero para recopilar y verificar documentos de identificación. Puede encontrar más información sobre los derechos disponibles para los residentes de EE. UU. a continuación bajo el encabezado "Aviso de Privacidad Regional de Estados Unidos".
Finalmente, dado que no existe una comprensión común sobre lo que se supone que significa una señal de "No rastrear", no respondemos a esas señales de ninguna manera en particular.
## Dónde enviamos su información
Somos una empresa estadounidense, pero trabajamos con y procesamos datos sobre personas de todo el mundo. Para operar nuestro negocio, podemos enviar su información personal fuera de su estado, provincia o país. Estos datos pueden estar sujetos a las leyes de los países a los que los enviamos. Tomamos medidas para proteger su información cuando enviamos su información a través de fronteras.
Dependiendo de si usted es un comerciante, cliente, usuario o visitante, consulte nuestras políticas de privacidad complementarias, según corresponda.
Finalmente, aunque hacemos lo que podemos para proteger su información, podemos estar legalmente obligados a divulgar su información personal en algunas ocasiones (por ejemplo, si recibimos una orden judicial válida).
Cuando transferimos información personal desde el Espacio Económico Europeo (EEE), el Reino Unido o Suiza a países que no se considera que proporcionen un nivel adecuado de protección de datos, confiamos en mecanismos legales como las Cláusulas Contractuales Estándar aprobadas por la Comisión Europea para salvaguardar la transferencia.
## Google user data and Google integrations
This section applies when you use Google Sign-In or connect Google Ads, Google Merchant Center, or another Google service to Runner AI.
### What Google user data we access and store
For Google Sign-In, we access the Google account information you authorize, such as your name, email address, profile image, and Google account identifier, to create or log in to your Runner AI account.
For Google Ads and Google Merchant Center integrations, we request the Google OAuth scopes needed to provide the ads features you choose, including `https://www.googleapis.com/auth/adwords` and `https://www.googleapis.com/auth/content`. Depending on the features you use, we may store OAuth access tokens, refresh tokens, granted scopes, token expiration data, accessible Google Ads customer account identifiers, account names, manager-account status, and selected account bindings. We may also access and process Google Ads campaign, ad group, ad, creative, asset, budget, bidding, targeting, performance metric, conversion value, ROAS, and change-history data, including the user email associated with a Google Ads account change, as well as Google Merchant Center account identifiers and account names.
### How we use Google user data
We use Google user data only to provide or improve user-facing Runner AI features that you request, including signing you in, connecting and refreshing your Google integrations, listing selectable Google Ads and Merchant Center accounts, showing ads dashboards and reports, generating requested AI ads analysis or campaign drafts, publishing or updating campaigns you approve, syncing account access, and troubleshooting or securing those features.
We do not sell Google user data. We do not use Google user data for retargeting, personalized advertising unrelated to your requested Runner AI ads features, credit-worthiness, lending, or transfer to data brokers or information resellers.
### With whom we share, transfer, or disclose Google user data
We share, transfer, or disclose Google user data only in the following circumstances:
- **Google LLC.** We send authorization codes, OAuth tokens, developer-token-authenticated requests, campaign settings, Merchant Center identifiers, and related API request data to Google APIs so that we can authenticate your account, read the Google Ads or Merchant Center data you authorized, and perform the Google Ads or Merchant Center actions you request.
- **Your authorized Runner AI organization users.** Google Ads account metadata, reports, metrics, creatives, change history, Merchant Center account metadata, and campaign drafts may be visible to users in your Runner AI organization according to their workspace permissions.
- **Service providers and subprocessors.** We may share Google user data with service providers that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI, subject to confidentiality and data-processing obligations. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- **Legal, safety, and business-transfer recipients.** We may disclose Google user data when required by law, to protect rights, safety, and security, to investigate abuse, or in connection with a merger, acquisition, financing, reorganization, bankruptcy, or sale of assets, as described elsewhere in this Privacy Policy.
Except as described above or with your explicit direction, we do not share, transfer, or disclose Google user data to third-party advertising platforms, data brokers, information resellers, or other third parties.
### Retention and user control
We retain connected Google integration tokens and account metadata while the integration remains enabled or as needed to provide the Services, comply with law, resolve disputes, enforce agreements, maintain security, or keep backups. Disconnecting Google Ads in Runner AI deletes the active Google Ads integration record, including stored OAuth tokens and account metadata. You can also revoke Runner AI's Google access from your Google account settings.
Runner AI's use and transfer of information received from Google APIs will adhere to the [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy), including the Limited Use requirements.
## Cuánto tiempo conservamos su información
Conservaremos sus datos personales solo durante el tiempo necesario para cumplir con los propósitos para los que los hemos recopilado. Para determinar el período de retención apropiado, consideramos la cantidad, naturaleza y sensibilidad de sus datos personales, el riesgo potencial de daño por el uso no autorizado o divulgación de sus datos personales, los propósitos para los que procesamos sus datos personales y si podemos lograr esos propósitos a través de otros medios, y los requisitos legales aplicables. También conservaremos y usaremos su información personal en la medida necesaria para cumplir con nuestras obligaciones legales, resolver disputas y hacer cumplir nuestras políticas. Si deja de usar nuestros servicios o si elimina su cuenta con nosotros, eliminaremos su información o almacenaremos su información en formato agregado y anonimizado.
Dependiendo de si usted es un comerciante, cliente, usuario o visitante, consulte nuestras políticas de privacidad complementarias, según corresponda, para obtener más detalles sobre la retención de su información personal.
## Nuestro uso de Aprendizaje Automático
Para proporcionar nuestras funciones avanzadas impulsadas por IA para operaciones automatizadas y crecimiento, nuestra plataforma utiliza aprendizaje automático. Utilizamos estas tecnologías para proporcionar servicios como análisis predictivos, sugerencias de campañas de marketing y recomendaciones de optimización de conversión.
Nuestras funciones de IA están diseñadas como herramientas de apoyo a la decisión. Generan sugerencias basadas en datos para su consideración. Estas no son decisiones automatizadas. Usted, el comerciante, retiene el control total y es el único responsable de revisar, aprobar e implementar cualquier sugerencia proporcionada por nuestra IA. El Servicio solo ejecutará acciones con su aprobación explícita o según la configuración que haya preconfigurado. Nuestra base legal para usar sus datos para estos propósitos se detalla más en nuestros Términos de Servicio bajo la cláusula "Uso de Datos para Mejora de IA".
## Cómo protegemos su información
Nuestros equipos trabajan incansablemente para proteger su información y para garantizar la seguridad e integridad de nuestra plataforma. También tenemos auditores independientes que evalúan la seguridad de nuestro almacenamiento de datos y sistemas que procesan información financiera. Sin embargo, todos sabemos que ningún método de transmisión por Internet, y ningún método de almacenamiento electrónico, puede ser 100% seguro. Esto significa que no podemos garantizar la seguridad absoluta de su información personal.
## Cómo usamos "cookies" y otras tecnologías de seguimiento
Utilizamos cookies y tecnologías de seguimiento similares en nuestro sitio web y al proporcionar nuestros servicios. Para obtener más información sobre cómo usamos estas tecnologías, incluida una lista de otras empresas que colocan cookies en nuestros sitios, una lista de cookies que colocamos cuando impulsamos la tienda de un comerciante, y una explicación de cómo puede optar por no usar ciertos tipos de cookies, consulte nuestra Política de Cookies.
## Cómo puede contactarnos
Si desea preguntar sobre, hacer una solicitud relacionada con, o quejarse sobre cómo procesamos su información personal, comuníquese con el Soporte de Runner AI por correo electrónico a support@adaptivemachines.ai, o envíenos correo postal a las direcciones a continuación:
Adaptive Machines, Inc.
2911 Noyce Place, 189, Santa Clara, CA 95051, USA
Si compra algo o proporciona su información a una tienda impulsada por Runner AI, el comerciante es su controlador de datos y nosotros actuamos como procesador en su nombre.
Si tiene preguntas sobre cómo un comerciante o tienda procesa su información personal, debe contactar al comerciante o visitar su política de privacidad.
## Aviso de Privacidad Regional de Estados Unidos
Este Aviso de Privacidad Regional de Estados Unidos ("Aviso de EE. UU.") complementa nuestra Política de Privacidad y todas las políticas de privacidad complementarias en /es/legal/policies (en conjunto, las "Políticas de Privacidad de Runner AI").
Este Aviso de EE. UU. es para personas que residen en ciertos estados de EE. UU. y está diseñado para ayudarle a comprender mejor cómo recopilamos, usamos y divulgamos su información personal y, dependiendo de cómo use Runner AI y dónde resida, cómo ejercer los derechos disponibles bajo varias leyes de privacidad aplicables en EE. UU., específicamente la Ley de Privacidad del Consumidor de California, la Ley de Privacidad de Colorado, la Ley de Connecticut Concerniente a la Privacidad de Datos Personales y Monitoreo en Línea, la Ley de Privacidad del Consumidor de Utah y la Ley de Protección de Datos del Consumidor de Virginia (colectivamente, las "Leyes de Privacidad de EE. UU.").
### 11.1 Qué información recopilamos y compartimos sobre usted
Para proporcionarle nuestros servicios, debemos procesar información sobre usted, incluida información personal.
No "vendemos" su información personal según la definición de ese término bajo las Leyes de Privacidad de EE. UU.
Aquí hay un resumen de las categorías de información personal que podemos recopilar sobre usted en el futuro y con quién podemos haber divulgado esa información, dependiendo de cómo use Runner AI.
| Categorías de Información Personal Recopilada | Destinatarios de la Información Personal |
|----------------------------------------------|------------------------------------------|
| Identificadores, incluidos nombre, dirección de correo electrónico, dirección postal, número de teléfono; | Empresas que nos ayudan a proporcionarle nuestros servicios, incluidos proveedores de almacenamiento en la nube, procesadores de pagos, socios de cumplimiento, proveedores de seguridad, proveedores de correo electrónico, mercados y proveedores de análisis de datos; |
| Categorías de información personal enumeradas en el estatuto de Registros de Clientes de California, incluidos nombre, dirección postal y de facturación, número de teléfono, información de tarjeta de crédito o débito; | Anunciantes y proveedores de marketing; |
| Información comercial, incluidos los productos que compra, coloca en su carrito de compras, favoritos o reseñas (si es cliente) e información que nos proporciona sobre usted y su negocio (si es comerciante); | Comerciantes cuyas tiendas visita o de las que realiza compras; |
| Fotos y videos, que pueden incluir imágenes faciales, si elige proporcionarlas. | Socios que le ayudan a usar nuestros Servicios, como proveedores de pago o logística que elige integrar con su Tienda. |
| Información de actividad de red electrónica o de Internet, incluida información sobre el dispositivo y navegador que usa, conexión de red, dirección IP y cómo navega por nuestros sitios; | Fuerzas del orden u otros terceros en relación con solicitudes legales, para cumplir con la ley aplicable o para prevenir daños. |
| Datos de geolocalización, incluida su dirección postal y de facturación; | |
| Inferencias o información derivada de otra información personal sobre usted, que podría incluir sus preferencias, intereses y otra información utilizada para personalizar su experiencia; | |
| Otra información que proporcione; y | |
| Información personal sensible, que puede incluir: Identificadores emitidos por el gobierno, incluido el número de seguro social, licencia de conducir, tarjeta de identificación estatal o pasaporte; Sus credenciales de acceso a la cuenta (como inicio de sesión de cuenta, cuenta financiera, número de tarjeta de débito o crédito en combinación con cualquier código de acceso de seguridad requerido, contraseña o credenciales que permitan el acceso a una cuenta); | |
### 11.2 Por qué recopilamos y compartimos su Información Personal
Usamos y compartimos su información personal para los propósitos establecidos en las Políticas de Privacidad de Runner AI. Para las categorías de información personal sensible que recopilamos, solo usamos o divulgamos dicha información con su consentimiento específico cuando sea requerido, o según lo permita la ley.
### 11.3 Fuentes de Información Personal
Para hacer que el comercio sea mejor para todos en Runner AI, recopilamos y utilizamos información personal proporcionada por:
**Usted:** Recopilamos la información que proporciona cuando usa nuestra plataforma, incluso cuando se registra en Runner AI como comerciante, visita una tienda impulsada por Runner AI, completa información de pedido, visita uno de los sitios web de Runner AI o contacta al Soporte de Runner AI. Recopilamos información de cuenta y pago que nos proporciona (incluida información sobre su negocio si es comerciante), tiendas o artículos de Runner AI que guarda en favoritos, compras que realiza, reseñas que publica, y cómo interactúa o se comunica con tiendas u otros usuarios en nuestros servicios. También recopilamos información sobre cómo navega por nuestros sitios, incluidos los términos de búsqueda que puede ingresar.
**Su(s) dispositivo(s):** Recopilamos información de y sobre los dispositivos que usa, incluidas computadoras, teléfonos y otros dispositivos conectados a la web que usa para acceder a nuestros servicios, y combinamos esta información entre diferentes dispositivos que usa.
**Terceros:** Recibimos información de socios que nos ayudan a proporcionarle nuestros servicios, incluidos los siguientes:
- **Proveedores de servicios.** Recibimos información de nuestros proveedores de servicios, que nos ayudan a proporcionar servicios a nuestros comerciantes, como revisar cuentas por fraude u otras preocupaciones.
- **Subprocesadores.** Trabajamos con subprocesadores de terceros para alojamiento en la nube, entrega de contenido, análisis de datos, registro interno, servicios de cumplimiento y transmisión de correo electrónico, entre otros, para proporcionarle nuestros servicios. Para obtener más información, consulte los subprocesadores de Runner AI.
- **Proveedores de análisis y cookies.** Recibimos información a través de nuestro uso de cookies, complementos sociales (como el botón "me gusta" de Facebook), píxeles y etiquetas para fines comerciales, como proporcionar información para ayudar a medir cómo los usuarios interactúan con el contenido de nuestro sitio web. Para obtener más información sobre cómo usamos estas tecnologías, consulte nuestra Política de Cookies.
### 11.4 Cuánto tiempo conservamos su información
Debido a que necesitamos su información personal para proporcionar servicios de Runner AI, generalmente conservamos su información personal, incluida información personal sensible, mientras use productos o servicios de Runner AI o hasta que nos indique que eliminemos su información. También podemos conservar información personal para cumplir con obligaciones legales o proteger nuestros intereses o los de otros.
Si usted es un comerciante que opera una tienda impulsada por Runner AI, y cierra la tienda, deja de pagar sus tarifas de suscripción, o cancelamos su cuenta, retenemos la información de la tienda durante dos años antes de comenzar el proceso de eliminación.
Cuando visita o realiza una compra en la tienda impulsada por Runner AI de un comerciante, actuamos como proveedor de servicios o procesador para el comerciante, y el comerciante, no Runner AI, decide cuánto tiempo se retiene su información.
### 11.5 Sus derechos sobre su información
Dependiendo de dónde viva, cómo use Runner AI y sujeto a ciertas excepciones, puede tener algunos o todos los siguientes derechos:
- **Derecho a Saber:** El derecho a solicitar que le divulguemos la información personal que recopilamos, usamos o divulgamos sobre usted, las fuentes de las que recopilamos su información personal e información sobre nuestras prácticas de datos.
- **Derecho a Solicitar Corrección:** El derecho a solicitar que corrijamos información personal inexacta que mantenemos sobre usted.
- **Derecho a Solicitar Eliminación:** El derecho a solicitar que eliminemos cualquier información personal que hayamos recopilado sobre usted.
Para ejercer sus derechos, incluido el "derecho a saber" y el "derecho a eliminar", envíe una solicitud a través de support@adaptivemachines.ai.
Si ha visitado o realizado una compra en la tienda impulsada por Runner AI de un comerciante, comuníquese directamente con el comerciante específico. Si nos hace una solicitud, reenviaremos su solicitud al comerciante relevante.
Tenga en cuenta que para proteger su información y la integridad de nuestros productos y servicios, es posible que necesitemos verificar su identidad antes de procesar su solicitud. En algunos casos, es posible que necesitemos recopilar información adicional para verificar su identidad, como su dirección de correo electrónico o una identificación emitida por el gobierno.
Bajo las Leyes de Privacidad de EE. UU., también puede designar a un agente autorizado para realizar estas solicitudes en su nombre. Si usa un agente autorizado para enviar una solicitud, es posible que necesitemos recopilar información adicional, como una identificación emitida por el gobierno, para verificar su identidad antes de procesar su solicitud para proteger su información.
En ciertos estados, puede tener derecho a apelar nuestra decisión con respecto a una solicitud relacionada con estos derechos. Si desea apelar una decisión, comuníquese con el Soporte de Runner AI.
No discriminaremos en su contra por ejercer alguno de estos derechos.
## Información Adicional para Usuarios en Ciertas Regiones
### Para Usuarios en el Espacio Económico Europeo (EEE), Reino Unido y Suiza:
Si se encuentra en el EEE, Reino Unido o Suiza, solo procesamos sus datos personales cuando tenemos una base legal válida. Para información donde somos el Controlador de Datos (por ejemplo, para nuestros Comerciantes y Visitantes del Sitio Web), nuestras bases legales incluyen:
- **Ejecución de un Contrato:** Para proporcionarle nuestros Servicios como se describe en nuestros Términos de Servicio.
- **Interés Legítimo:** Para propósitos como seguridad, mejora de la plataforma y marketing, donde nuestros intereses no sean anulados por sus derechos de protección de datos.
- **Consentimiento:** Para usos específicos, como el envío de correos electrónicos de marketing o la colocación de cookies no esenciales, donde solicitamos su consentimiento.
- **Obligación Legal:** Para cumplir con nuestras obligaciones legales.
### Para Usuarios en California:
Si es residente de California, tiene derechos bajo la CCPA/CPRA, incluido el derecho a saber, eliminar, corregir y el Derecho a Optar por No Participar en la Venta o Compartir su Información Personal con fines de publicidad conductual entre contextos. Puede ejercer este derecho en cualquier momento haciendo clic en el enlace "No vender ni compartir mi información personal" en el pie de página de nuestro sitio web o administrando sus preferencias de cookies.
---
# Política de Privacidad para consumidores
Source: https://www.runnerai.com/docs/es/legal/policies/consumers
## Tabla de Contenido
1. [Introducción](#introducción)
2. [Qué Datos Personales Recibimos](#qué-datos-personales-recibimos)
3. [Cómo Usamos Sus Datos Personales](#cómo-usamos-sus-datos-personales)
4. [Cómo Procesamos Sus Datos Personales en Nombre de los Comerciantes de Runner AI](#cómo-procesamos-sus-datos-personales-en-nombre-de-los-comerciantes-de-runner-ai)
5. [Terceros Que Pueden Recibir Datos Personales](#terceros-que-pueden-recibir-datos-personales)
6. [Socios Terceros e Integraciones](#socios-terceros-e-integraciones)
7. [Sus Derechos y Opciones de Privacidad](#sus-derechos-y-opciones-de-privacidad)
8. [Retención](#retención)
9. [Cómo Contactarnos](#cómo-contactarnos)
10. [Cambios a esta Política de Privacidad](#cambios-a-esta-política-de-privacidad)
## Introducción
Esta política de privacidad describe los datos personales que Runner AI recibe y/o procesa (lo que puede incluir recopilar, organizar, estructurar, almacenar, usar o divulgar) cuando interactúa con Runner AI o usa los Servicios para Consumidores de Runner AI, como se definen en los Términos de Servicio para Consumidores, incluido mientras compra con un comerciante que usa o está impulsado por la plataforma de Runner AI ("Comerciantes de Runner AI" o "Comerciantes"). Además, revise nuestra [política de privacidad general](/es/legal/policies) que se aplica a todas las personas cuya información procesamos. Si alguna disposición en esta política entra en conflicto con las disposiciones de la política de privacidad general, se aplicarán las disposiciones de esta política.
## Qué Datos Personales Recibimos
Los Datos Personales son cualquier información de o sobre una persona identificada o identificable, pero no incluye información agregada o anonimizada. Recibimos Datos Personales cuando usa o interactúa con Runner AI o los servicios de Runner AI, que pueden incluir las siguientes categorías:
### 1. Información de Perfil y Contacto
Recibimos información de contacto u otra información de perfil cuando se registra o interactúa con los Servicios para Consumidores de Runner AI, que puede incluir número de teléfono, dirección de correo electrónico u otra información que elija proporcionarnos. Podemos vincular esta información a los diferentes dispositivos o cuentas que usa cuando interactúa con Runner AI o usa los Servicios para Consumidores de Runner AI.
### 2. Información del Dispositivo
Recibimos información sobre las computadoras, teléfonos y otros dispositivos que usa o con los que interactúa con Runner AI o los Servicios para Consumidores de Runner AI, incluida la dirección IP (que puede usarse para determinar la ubicación general), identificadores de dispositivo, ID de cookies, el navegador que usa, su conexión de red u otros identificadores únicos o información del dispositivo.
### 3. Información de Pago
Recibimos información de pago cuando realiza una compra a través de Runner AI o los Comerciantes de Runner AI, como el número de su tarjeta de pago y la fecha de vencimiento.
### 4. Uso de los Servicios para Consumidores de Runner AI
Recibimos información sobre su uso de o interacciones con los Servicios para Consumidores de Runner AI, ya sea que haya iniciado sesión en Runner AI o no, como sus interacciones con los Comerciantes de Runner AI, las Tiendas que visita, los productos que ve y visita, las reseñas y calificaciones de productos que publica y comparte, su historial de pedidos, otras actividades de marketing relacionadas con los Servicios para Consumidores de Runner AI y las Tiendas favoritas.
### 5. Configuración y Preferencias de Privacidad
Recibimos información sobre su configuración y preferencias en Runner AI y nuestros Comerciantes, así como información sobre la configuración de privacidad de su navegador y dispositivo.
### 6. Comunicaciones con Runner AI
Recibimos información, incluido el contenido de mensajes y correos electrónicos, cuando se comunica con Runner AI (como para consultas de atención al cliente, al participar en encuestas, participar en promociones o investigaciones).
### 7. Cuentas de Redes Sociales
Si elige vincular, conectar o iniciar sesión en los Servicios para Consumidores de Runner AI a través de un servicio en línea de terceros, usted ordena al servicio que nos envíe cierta información sobre usted controlada por ese servicio, como información de perfil. Este intercambio está sujeto a los avisos de privacidad aplicables y la configuración de privacidad de ese servicio.
## Cómo Usamos Sus Datos Personales
Runner AI usa los Datos Personales para los siguientes propósitos dependiendo de cómo interactúe con nosotros o qué servicios de Runner AI use y en función de su actividad en todos los dispositivos donde inicia sesión o interactúa con Runner AI o los servicios de Runner AI:
### 1. Proporcionar, Mejorar y Personalizar los Servicios de Runner AI
Para proporcionarle servicios personalizados de Runner AI, incluso mostrando su historial de compras y estado de pedidos en un solo lugar, proporcionando opciones de pago fáciles cuando compra, recomendando productos, Comerciantes y Tienda(s) y personalizando los productos destacados para usted, y para mejorar los servicios de Runner AI, incluso según su uso de los Servicios para Consumidores de Runner AI y actividad con nuestro(s) Comerciante(s).
### 2. Rastrear e Implementar Sus Preferencias y Configuración de Privacidad
Para rastrear e implementar su configuración y preferencias de privacidad con Runner AI y nuestros Comerciantes.
### 3. Realizar Investigación y Desarrollo de Productos
Para desarrollar, probar y mejorar los servicios de Runner AI, incluida la solución de problemas de nuestros productos y servicios, el desarrollo de servicios de Runner AI nuevos o mejorados, y el análisis de su uso e interacciones con los servicios de Runner AI.
### 4. Publicitar, Comercializar y Promover Runner AI
Para comercializar, publicitar y promover los servicios de Runner AI dentro y fuera de Runner AI, incluidas las comunicaciones o anuncios personalizados relacionados con los servicios de Runner AI en servicios de terceros.
### 5. Proporcionar Publicidad Personalizada para nuestros Comerciantes
Para proporcionar servicios de publicidad a nuestros Comerciantes, que pueden incluir publicidad personalizada.
### 6. Comunicarnos con Usted
Para comunicarnos con usted sobre los servicios de Runner AI, incluidas las actualizaciones de productos, su cuenta y los cambios en nuestras políticas y términos. También usamos su información para responderle cuando nos contacta.
### 7. Autenticación, Integridad, Seguridad y Protección
Para autenticar su cuenta, proporcionar una experiencia de pago y compra segura, y detectar, investigar y prevenir conductas maliciosas, actividades fraudulentas o experiencias inseguras, abordar amenazas de seguridad, proteger la seguridad pública y asegurar los Servicios de Runner AI para usted y nuestros Comerciantes.
### 8. Razones Legales
Para cumplir con la ley aplicable o responder a procesos legales válidos, incluidas solicitudes de agencias gubernamentales o fuerzas del orden, investigar o participar en descubrimientos civiles, litigios u otros procedimientos legales adversos, y hacer cumplir o investigar posibles violaciones de nuestros términos o políticas.
Runner AI también puede agregar, desidentificar y/o anonimizar cualquier información recopilada a través de los servicios de Runner AI de tal manera que no podamos vincular razonablemente la información a usted o su dispositivo. Podemos usar dicha información agregada, desidentificada o anónima para cualquier propósito, incluso, por ejemplo, para mejorar el servicio de Runner AI.
## Cómo Procesamos Sus Datos Personales en Nombre de los Comerciantes de Runner AI
Runner AI también procesa sus Datos Personales de los Comerciantes con los que interactúa o compra para ayudar a los Comerciantes a administrar sus Tienda(s) y proporcionar servicios comerciales a nuestros Comerciantes. Cuando Runner AI procesa Datos Personales de esta manera, actuamos bajo la dirección del Comerciante, y se aplican los términos de servicio y la política de privacidad de los Comerciantes, no los de Runner AI. Para obtener más información sobre cómo los Comerciantes recopilan y usan información personal cuando visita y realiza compras en sus Tienda(s), revise los términos y la política de privacidad del Comerciante.
Además, algunos Comerciantes pueden indicarnos que usemos los Datos Personales que comparten con nosotros para publicidad dirigida para estos y otros Comerciantes que usan estos servicios en sitios de terceros. Puede tener la capacidad de optar por no permitir que un Comerciante comparta su información con nosotros para estos propósitos directamente en el sitio de ese Comerciante.
## Terceros Que Pueden Recibir Datos Personales
Dependiendo de qué servicios de Runner AI use o con los que interactúe, Runner AI puede proporcionar Datos Personales a las siguientes categorías de terceros:
### 1. Proveedores
Runner AI trabaja con proveedores de servicios de terceros para proporcionar, apoyar y mejorar los servicios de Runner AI y la infraestructura técnica, para servicios comerciales como el procesamiento de pagos, incluido en relación con las compras realizadas cuando usa los Servicios de Runner AI, y para marketing y análisis comercial.
### 2. Socios de Marketing, Publicidad y Análisis
Podemos usar socios de marketing, publicidad y análisis comercial de terceros para entregar publicidad personalizada y para ayudarnos a comprender cómo las personas usan o interactúan con los servicios de Runner AI y nuestros Comerciantes. Estos socios pueden recibir información sobre su uso de, o interacciones con, los servicios de Runner AI, incluso a través de cookies de terceros u otras tecnologías.
### 3. Cambio de Control
Podemos compartir Datos Personales con adquirentes reales o potenciales, sus representantes y otros participantes relevantes en, o durante negociaciones de, cualquier venta, fusión, adquisición, reestructuración o cambio en el control que involucre la totalidad o una parte del negocio o activos de Runner AI, incluido en relación con procedimientos de quiebra o similares.
### 4. Razones Legales
Podemos compartir Datos Personales según sea necesario para: (1) hacer cumplir o investigar posibles violaciones de sus Términos de Servicio o políticas; (2) cumplir con la ley aplicable o responder, investigar o participar en procesos y procedimientos legales válidos, incluidos de agencias gubernamentales o fuerzas del orden; (3) proteger nuestros derechos y propiedades y los de nuestros Comerciantes y usuarios; (4) cumplir con nuestros compromisos de responsabilidad corporativa y social; (5) detectar, prevenir o investigar posible fraude, abuso o problemas de seguridad y protección, incluidas amenazas al público; y (6) resolver disputas y hacer cumplir acuerdos.
### 5. Compartir a Su Discreción
Cuando proporciona consentimiento, compartimos su información según lo descrito en el momento del consentimiento, como cuando se conecta con una aplicación o sitio web de terceros.
## Socios Terceros e Integraciones
Partes de los servicios de Runner AI pueden vincularse a servicios de terceros. Runner AI no posee ni controla a estos terceros. Cuando interactúa con estos terceros y elige usar sus servicios, su uso está sujeto a las políticas de privacidad de esos proveedores.
## Sus Derechos y Opciones de Privacidad
Puede tener ciertos derechos para administrar sus Datos Personales dependiendo de dónde viva. Dependiendo de su jurisdicción, los siguientes derechos pueden aplicarse, sujetos a ciertas excepciones:
### 1. Acceso y Portabilidad
Derecho a solicitar acceso a sus Datos Personales.
### 2. Corrección / Rectificación
Derecho a corregir Datos Personales inexactos o incompletos en ciertas circunstancias.
### 3. Eliminación / Supresión
Derecho a eliminar Datos Personales sobre usted.
### 4. Derecho a optar por no participar en el "intercambio" para publicidad conductual entre contextos o publicidad dirigida
Derecho a optar por no participar en el "intercambio" de sus Datos Personales para publicidad conductual entre contextos o publicidad dirigida (como se describe más en la sección Terceros Que Pueden Recibir Datos Personales).
También puede actualizar la información de su cuenta en la configuración de la aplicación. Para desactivar o eliminar su cuenta, envíe un correo electrónico a support@adaptivemachines.ai. Puede tener derechos adicionales disponibles para usted. La solicitud se puede enviar por correo electrónico a support@adaptivemachines.ai. Además, consulte nuestra [política de privacidad general](/es/legal/policies) para obtener más información.
## Retención
Retenemos los Datos Personales mientras tengamos una necesidad comercial continua de hacerlo (por ejemplo, para proporcionar los servicios de Runner AI, para cumplir con requisitos legales, fiscales o contables aplicables, para seguridad y detección o prevención de fraude, o en relación con procesos de respaldo o recuperación ante desastres), a menos que la ley aplicable permita o requiera un período de retención diferente.
Los criterios utilizados para determinar nuestros períodos de retención incluyen lo siguiente:
1. El tiempo que tenemos una relación continua con usted y le proporcionamos servicios de Runner AI (por ejemplo, mientras tenga una cuenta con nosotros o siga usando nuestros servicios);
2. Si modifica o elimina su información a través de sus cuentas;
3. Si Runner AI tiene una obligación legal de conservar los datos (por ejemplo, ciertas leyes requieren que Runner AI conserve registros de sus transacciones durante un cierto período de tiempo); o
4. Si la retención es aconsejable a la luz de nuestra posición legal (como en relación con la aplicación de nuestros acuerdos, la resolución de disputas, los plazos de prescripción aplicables, litigios o investigaciones regulatorias).
## Cómo Contactarnos
Si desea ejercer sus derechos, o si tiene alguna pregunta o inquietud relacionada con esta Política de Privacidad, puede contactarnos por support@adaptivemachines.ai.
## Cambios a esta Política de Privacidad
Podemos actualizar esta Política de Privacidad periódicamente para tener en cuenta los cambios en nuestra recopilación y/o procesamiento de Datos Personales, y publicaremos la Política de Privacidad actualizada en nuestro sitio web, con una fecha de "Última actualización" en la parte superior.
---
# Política de Privacidad para comerciantes
Source: https://www.runnerai.com/docs/es/legal/policies/merchants
## Tabla de Contenido
1. [Introducción](#introducción)
2. [Qué información recopilamos sobre usted y por qué](#qué-información-recopilamos-sobre-usted-y-por-qué)
3. [Cuándo y Por Qué Compartimos Su Información con Otros](#cuándo-y-por-qué-compartimos-su-información-con-otros)
4. [Google Ads and Google Merchant Center integrations](#google-ads-and-google-merchant-center-integrations)
5. [Sus Derechos Respecto a Su Información](#sus-derechos-respecto-a-su-información)
6. [Cuánto Tiempo Conservamos Su Información](#cuánto-tiempo-conservamos-su-información)
7. [La Información de Sus Clientes](#la-información-de-sus-clientes)
## Introducción
Si usted es un comerciante que utiliza Runner AI para apoyar su negocio, recopilamos y usamos su información personal para proporcionarle acceso a nuestra plataforma y sus servicios, y generalmente para ayudarle a administrar mejor su negocio y relaciones con los clientes.
Cuando procesamos información personal de sus clientes ("Usuarios Finales"), lo hacemos como Procesador de Datos en su nombre. Usted, el Comerciante, es el Controlador de Datos para la información de sus Usuarios Finales. Esto significa que usted es responsable del cumplimiento legal con las leyes de protección de datos aplicables, incluida la provisión de su propia política de privacidad y la obtención de los consentimientos necesarios de sus Usuarios Finales.
Además, revise nuestra [política de privacidad general](/es/legal/policies), que se aplica a todas las personas cuya información procesamos.
## Qué información recopilamos sobre usted y por qué
Recopilamos información personal cuando se registra en Runner AI, cuando usa nuestra plataforma o cuando nos proporciona información de otra manera. También podemos usar proveedores de servicios de terceros para ayudarnos a revisar cuentas por fraude u otros problemas. Generalmente, necesitamos información sobre usted para permitirle usar nuestra plataforma. Procesamos sus datos personales para cumplir con nuestro contrato con usted, o porque mantener nuestra relación comercial, prevenir riesgos y fraudes, proporcionarle servicios eficientes, mejorar nuestros productos y servicios, y responder a sus solicitudes de servicio se alinean con nuestros intereses legítimos. En algunos casos, solo procesaremos su información personal con su consentimiento.
| Qué recopilamos | Cómo lo Usamos |
|-----------------|----------------|
| Información que nos proporciona sobre usted y su negocio, como su nombre, el nombre de su personal u otras personas asociadas con su negocio, nombre de la empresa, dirección, dirección de correo electrónico y número de teléfono. | Para proporcionarle el uso de nuestra plataforma y otros servicios relacionados (por ejemplo, para confirmar su identidad, para contactarle sobre problemas con la plataforma, para facturarle) Para publicitar y comercializar productos o funciones para usted Para cumplir con requisitos legales Para prevenir el uso fraudulento de nuestros servicios |
| Información de pago que nos proporciona, como el número de su tarjeta de crédito o débito o el número de su cuenta bancaria. | Para proporcionarle el uso de nuestra plataforma y otros servicios relacionados Para cobrar por nuestros servicios |
| Información sobre cómo accede a los sitios web de Runner AI, su cuenta y nuestra plataforma, incluida información sobre el dispositivo y navegador que usa, su conexión de red, su dirección IP y detalles sobre cómo navega por nuestros sitios web y plataforma. Recopilamos parte de esta información utilizando "cookies" u otras tecnologías similares directamente desde su dispositivo. Para obtener más información sobre cómo usamos estas tecnologías, consulte nuestra Política de Cookies. | Para proporcionarle el uso de, y mejorar, nuestra plataforma y otros servicios relacionados (por ejemplo, identificando formas de hacer que nuestra plataforma sea más fácil de usar o navegar) Para publicitar y comercializar productos o funciones para usted Para prevenir el uso fraudulento de nuestros servicios |
| Copias de documentos de identificación emitidos por el gobierno y/o una fotografía suya sosteniendo su identificación que nos proporcione | Si necesitamos verificar su identidad (por ejemplo, para protegerle contra el robo de identidad o fraude) Para verificar que estamos hablando con usted si nos contacta Para ayudarnos a determinar o verificar la propiedad de la cuenta Para cumplir con requisitos legales |
| Google account, Google Ads, and Google Merchant Center information you authorize Runner AI to access, such as Google sign-in profile information, OAuth tokens and granted scopes, accessible Google Ads customer accounts, account names, manager-account status, selected account bindings, campaign and creative data, performance metrics, change history, and Merchant Center account identifiers and names. | To sign you in, connect and refresh your Google integrations, list selectable ad and Merchant Center accounts, show ads dashboards and reports, generate requested AI ads analysis or campaign drafts, publish or update campaigns you approve, sync account access, troubleshoot issues, and secure the integration. |
También trabajamos con empresas que nos proporcionan información sobre comerciantes o posibles comerciantes (por ejemplo, para proteger contra el fraude o si estamos patrocinando un evento).
## Cuándo y Por Qué Compartimos Su Información con Otros
Administrar un negocio es difícil, y trabajamos con múltiples empresas para ayudarnos a proporcionarle una gama de servicios para apoyar su negocio. A veces compartimos su información personal con estas empresas para ayudarnos a proporcionarle los servicios de Runner AI.
También compartimos su información personal con otros:
- Para prevenir o investigar presunto fraude, amenazas a la seguridad física, actividades ilegales o violaciones de contrato o nuestros otros acuerdos del sitio web.
- Para ayudarnos con marketing y publicidad.
- Para cumplir con requisitos legales, o responder a órdenes judiciales o solicitudes gubernamentales similares.
- Para ventas o compras de activos, ventas de acciones, compras o fusiones, quiebra u otras transacciones comerciales o reorganizaciones, compartiremos sus datos personales con compradores, vendedores, nuevos propietarios u otros terceros relevantes potenciales según sea necesario durante las negociaciones o en relación con un cambio en el control de la empresa (como una reorganización, fusión o venta de nuestros activos).
Además, casi todos los comerciantes que usan la plataforma Runner AI también usan servicios que no son de Runner AI para apoyar su negocio (canales de ventas, pasarelas de pago o proveedores de envío).
Runner AI no tiene control sobre cómo estos servicios usan su información personal, y debe verificar cualquier otro servicio que use para asegurarse de que cumplan con sus expectativas de privacidad.
## Google Ads and Google Merchant Center integrations
If you connect Google Ads or Google Merchant Center to Runner AI, we use the Google user data you authorize only to provide the connected ads features you request. We share, transfer, or disclose that Google user data only with:
- Google LLC, to exchange OAuth codes and tokens, call Google Ads and Merchant Center APIs, read the data you authorized, and perform the Google Ads or Merchant Center actions you request.
- Authorized users in your Runner AI organization, according to their workspace permissions.
- Service providers and subprocessors that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- Legal, safety, and business-transfer recipients when required by law or as described in our overall Privacy Policy.
We do not sell Google user data, and we do not share it with third-party advertising platforms, data brokers, or information resellers except as described above or with your explicit direction. For more detail, see [Google user data and Google integrations](/es/legal/policies#google-user-data-and-google-integrations) in our overall Privacy Policy.
## Sus Derechos Respecto a Su Información
Puede acceder y corregir gran parte de su información personal directamente a través de su administrador de Runner AI. Para información que no puede acceder o corregir directamente en su administrador de Runner AI, envíe una solicitud de interesado a través de nuestro support@adaptivemachines.ai. Para obtener más información, consulte nuestra [política de privacidad general](/es/legal/policies). Tenga en cuenta que ciertos derechos del interesado solo se aplican en circunstancias específicas, y todos estos derechos pueden estar limitados por ley.
## Cuánto Tiempo Conservamos Su Información
Dado que necesitamos su información personal para proporcionar los servicios de Runner AI, generalmente retenemos su información personal mientras use productos o servicios de Runner AI. Si cierra su tienda, deja de pagar las tarifas de suscripción o cancelamos su cuenta, retendremos la información de la tienda durante dos años antes de comenzar a eliminar o anonimizar la información personal. No haremos esto inmediatamente si reactiva su cuenta o si hay quejas legales o auditorías relacionadas con su negocio. Si nos contacta para solicitar la eliminación de la información de su tienda, comenzaremos el proceso de eliminar o anonimizar la información personal después de 90 días, a menos que la ley nos exija retener información específica. Si tiene alguna pregunta sobre este proceso, comuníquese con nuestro equipo de soporte por support@adaptivemachines.ai. Recuerde que después de anonimizar su información personal, podemos continuar usando información no identificable para mejorar nuestros servicios.
## La Información de Sus Clientes
Para ayudar a hacer crecer su negocio, recopilamos y usamos información personal sobre sus clientes. Típicamente, recopilamos y usamos esta información personal según sus instrucciones. Legalmente, somos un "procesador de datos" y "proveedor de servicios", tal como se utilizan estos términos en ciertas leyes de privacidad aplicables, incluidas las de Estados Unidos, Canadá, Europa y el Reino Unido.
Dado que usted decide cómo usar la información personal de sus clientes, debe asegurarse de que sus clientes comprendan cómo usted (y cómo nosotros en su nombre) recopilamos y procesamos su información personal. Para hacer esto, debe al menos publicar una política de privacidad en su tienda que describa la información que recopila, cómo la usa y con quién la comparte.
Si recopila cualquier información personal "sensible" de los clientes (por ejemplo, información sobre el número de Seguro Social, licencia de conducir, identificación estatal o pasaporte de un consumidor; información de inicio de sesión de cuenta, información de cuenta financiera, números de tarjetas de débito o crédito y cualquier código de seguridad o contraseña requeridos; información de geolocalización precisa; datos de salud o genéticos, origen racial o étnico, creencias religiosas o filosóficas o membresía sindical; el contenido del correo postal, correo electrónico o mensajes de texto de un consumidor; o datos de delitos penales), debe obtener el consentimiento explícito del cliente para usar y procesar esta información.
---
# Política de Privacidad para visitantes
Source: https://www.runnerai.com/docs/es/legal/policies/visitors
## Tabla de Contenido
1. [Introducción](#introducción)
2. [Información Que Recopilamos Sobre Usted y Por Qué](#información-que-recopilamos-sobre-usted-y-por-qué)
3. [Cuándo y Por Qué Compartimos Su Información con Otros](#cuándo-y-por-qué-compartimos-su-información-con-otros)
4. [Sus Derechos Respecto a Su Información](#sus-derechos-respecto-a-su-información)
## Introducción
Si visita un sitio web de Runner AI o contacta al soporte al cliente de Runner AI, generalmente usamos su información personal para proporcionarle el servicio específico que está utilizando. Además, revise nuestra [Política de Privacidad general](/es/legal/policies), que se aplica a todas las personas cuya información procesamos.
## Información Que Recopilamos Sobre Usted y Por Qué
Cuando visita nuestros sitios web o contacta al soporte de Runner AI, recopilamos la siguiente información personal sobre usted. Procesamos sus datos personales para cumplir con nuestras obligaciones contractuales con usted, para mantener nuestra relación comercial, prevenir riesgos y fraudes, proporcionar servicios eficientes, mejorar nuestros productos y servicios, y responder a sus solicitudes de acuerdo con nuestros intereses legítimos. En algunos casos, procesamos su información personal solo con su consentimiento.
| Qué recopilamos | Cómo lo Usamos |
|-----------------|----------------|
| Información sobre usted que nos proporciona sobre sí mismo, como su nombre, dirección, dirección de correo electrónico y número de teléfono. | Para proporcionarle el uso de, y mejorar, la aplicación o servicio que está tratando de usar (por ejemplo, para confirmar su identidad, para contactarle sobre problemas con la plataforma, para facturarle) Para verificar que estamos hablando con usted Para publicitar y comercializar productos o funciones para usted Para cumplir con requisitos legales |
| Información de pago que nos proporciona, como el número de su tarjeta de pago o número de cuenta bancaria. | Para permitirle realizar un pago |
| Información sobre cómo accede y usa los sitios web de Runner AI y otros servicios, incluida información sobre el dispositivo y navegador que usa, su conexión de red, su dirección IP y detalles sobre cómo navega por nuestros sitios, incluidos los términos de búsqueda que puede ingresar. Recopilamos parte de esta información utilizando "cookies" u otras tecnologías similares directamente desde su dispositivo. Para obtener más información sobre cómo usamos estas tecnologías, consulte nuestra Política de Cookies. | Para proporcionarle el uso de, y mejorar, nuestros sitios web y servicios relacionados (por ejemplo, identificando formas de hacer que nuestra plataforma sea más fácil de usar o navegar) Para personalizar su experiencia usando nuestros sitios web (por ejemplo, cambiando el diseño de nuestras páginas web) Para publicitar y comercializar productos o funciones para usted |
## Cuándo y Por Qué Compartimos Su Información con Otros
Compartimos su información personal con empresas que nos ayudan a proporcionarle servicios. También podemos compartir su información:
- Para prevenir o investigar fraude, amenazas a la seguridad, actividad ilegal o violaciones de contratos (por ejemplo, nuestros Términos de Servicio).
- Para apoyar esfuerzos de marketing y publicidad.
- Para cumplir con obligaciones legales o responder a órdenes judiciales, solicitudes gubernamentales.
- Durante transacciones comerciales (por ejemplo, fusiones, adquisiciones, ventas de activos, quiebra), compartimos datos con compradores, vendedores o terceros relevantes potenciales involucrados en negociaciones o reestructuración.
## Sus Derechos Respecto a Su Información
Envíe una solicitud de interesado a través de support@adaptivemachines.ai si desea acceder o solicitar que eliminemos su información personal. Tenga en cuenta que después de anonimizar su información, continuaremos usando información no identificable para mejorar nuestros servicios. Tenga en cuenta que algunos derechos del interesado solo se aplican en ciertas circunstancias, y todos estos derechos pueden estar limitados por ley.
---
# Lista de Subprocesadores
Source: https://www.runnerai.com/docs/es/legal/subprocessors
## Lista de Subprocesadores
Para respaldar la prestación de nuestros Servicios, Adaptive Machines, Inc. ("Runner AI", "nosotros" o "nos") utiliza proveedores de servicios de terceros como subprocesadores para procesar datos personales. Las entidades afiliadas de Runner AI y los subprocesadores de terceros ayudan a Runner AI a procesar datos personales para los comerciantes de acuerdo con nuestro [Anexo de Procesamiento de Datos](/es/legal/dpa).
Los Subprocesadores utilizados por Runner AI para el desempeño de los Servicios bajo los Términos se enumeran a continuación.
## Subprocesadores de terceros
| Subprocesador | Servicio proporcionado | Sede corporativa | Datos que pueden procesarse |
|--------------|------------------|------------------------|----------------------------|
| Vercel Inc. | Servicios de alojamiento y despliegue | EE. UU. | Datos de plataforma necesarios para alojar y servir la aplicación |
| Google LLC | Alojamiento en la nube y procesamiento de datos | EE. UU. | Todos los datos de la plataforma |
| Google DeepMind | Servicios de inteligencia artificial conversacional | EE. UU. | Datos personales si se ingresan en el chatbox de Runner AI |
| OpenRouter, Inc. | Servicios de inteligencia artificial conversacional | EE. UU. | Datos personales si se ingresan en el chatbox de Runner AI |
| Klaviyo, Inc. | Transmisión de correo electrónico | EE. UU. | Datos personales necesarios para proporcionar el Correo Electrónico de Runner AI |
---
# Términos de Servicio
Source: https://www.runnerai.com/docs/es/legal/tos
## Términos de Servicio
### Tabla de Contenidos
1. [Términos de Cuenta](#1-términos-de-cuenta)
2. [Activación de Cuenta](#2-activación-de-cuenta)
3. [Derechos de Runner AI](#3-derechos-de-runner-ai)
4. [Sus Responsabilidades](#4-sus-responsabilidades)
5. [Pago de Tarifas e Impuestos](#5-pago-de-tarifas-e-impuestos)
6. [Confidencialidad](#6-confidencialidad)
7. [Limitación de Responsabilidad e Indemnización](#7-limitación-de-responsabilidad-e-indemnización)
8. [Propiedad Intelectual y Sus Materiales](#8-propiedad-intelectual-y-sus-materiales)
9. [Servicios Adicionales](#9-servicios-adicionales)
10. [Comentarios y Reseñas](#10-comentarios-y-reseñas)
11. [Aviso DMCA y Procedimiento de Retiro](#11-aviso-dmca-y-procedimiento-de-retiro)
12. [Privacidad y Protección de Datos](#12-privacidad-y-protección-de-datos)
13. [Parte Contratante de Runner AI](#13-parte-contratante-de-runner-ai)
14. [Plazo y Terminación](#14-plazo-y-terminación)
15. [Modificaciones](#15-modificaciones)
16. [Condiciones Generales](#16-condiciones-generales)
**Última actualización: 15 de octubre de 2025**
¡Bienvenido a Runner AI! Al registrarse para obtener una Cuenta de Runner AI (como se define en la Sección 1) o al utilizar cualquier Servicio de Runner AI (como se define a continuación), usted acepta estar sujeto a los siguientes términos y condiciones (los "Términos de Servicio").
Como se utiliza en estos Términos de Servicio, "Compañía", "nosotros", "nos" y "nuestro" se refieren a Adaptive Machines, Inc. (como se define en la Sección 13). "Usted" significa el Usuario de Runner AI (si se registra o utiliza un Servicio de Runner AI como individuo), o la empresa que emplea al Usuario de Runner AI (si se registra o utiliza un Servicio de Runner AI como empresa) y cualquiera de sus afiliados.
Runner AI proporciona una plataforma de comercio completa que permite a los comerciantes unificar sus actividades comerciales. Entre otras características, esta plataforma incluye una variedad de herramientas para que los comerciantes construyan y personalicen tiendas en línea, vendan en múltiples lugares (incluyendo web, móvil, redes sociales, mercados en línea y otras ubicaciones en línea ("Servicios en Línea"), gestionen productos, inventario, pagos, cumplimiento, envío, operaciones comerciales, marketing y publicidad, e interactúen con clientes existentes y potenciales. Cualquier servicio o servicios ofrecidos por Runner AI se denominan en estos Términos de Servicio como el/los "Servicio(s)". Cualquier nueva característica o herramienta que se agregue a los Servicios actuales también estará sujeta a los Términos de Servicio. Puede revisar la versión actual de los Términos de Servicio en cualquier momento en https://www.runnerai.com/docs/es/legal/tos.
Debe leer, aceptar y estar de acuerdo con todos los términos y condiciones contenidos o expresamente referenciados en estos Términos de Servicio, incluida la [Política de Uso Aceptable](/es/legal/aup) ("PUA") de Runner AI, la [Política de Privacidad](/es/legal/policies) y el [Addendum de Procesamiento de Datos](/es/legal/dpa) ("APD") antes de poder registrarse para obtener una Cuenta de Runner AI o utilizar cualquier Servicio de Runner AI.
Lea los Términos de Servicio, incluido cualquier documento al que se haga referencia en estos Términos de Servicio, para obtener una imagen completa de sus requisitos legales. Al utilizar Runner AI o cualquier servicio de Runner AI, está aceptando estos términos. Asegúrese de consultar ocasionalmente para ver actualizaciones.
## 1. Términos de Cuenta
### Lo que esto significa
Usted es responsable de su Cuenta, los Materiales que carga en el Servicio de Runner AI y la operación de su Tienda de Runner AI. Si viola los términos de servicio de Runner AI, podemos cancelar su acceso al servicio. Si necesitamos comunicarnos con usted, lo haremos a través de la Dirección de Correo Electrónico Principal.
(1) Para acceder y utilizar los Servicios, debe registrarse para obtener una cuenta de Runner AI ("Cuenta"). Para completar el registro de su Cuenta, debe proporcionarnos su nombre legal completo, dirección comercial, número de teléfono, una dirección de correo electrónico válida y cualquier otra información indicada como requerida. Runner AI puede rechazar su solicitud de una Cuenta, o cancelar una Cuenta existente, por cualquier motivo, a nuestra entera discreción.
(2) Debe tener la mayor de: (i) 18 años, o (ii) al menos la mayoría de edad en la jurisdicción donde reside y desde donde utiliza los Servicios para abrir una Cuenta.
(3) Usted confirma que está recibiendo cualquier Servicio proporcionado por Runner AI con el propósito de llevar a cabo una actividad comercial y no para ningún propósito personal, doméstico o familiar.
(4) Usted reconoce que Runner AI utilizará la dirección de correo electrónico que proporcione al abrir una Cuenta o según la actualice de vez en cuando como el método principal de comunicación con usted ("Dirección de Correo Electrónico Principal"). Debe monitorear la Dirección de Correo Electrónico Principal que proporciona a Runner AI y su Dirección de Correo Electrónico Principal debe ser capaz tanto de enviar como de recibir mensajes. Sus comunicaciones por correo electrónico con Runner AI solo pueden ser autenticadas si provienen de su Dirección de Correo Electrónico Principal.
(5) Usted es responsable de mantener su contraseña segura. Runner AI no puede y no será responsable de ninguna pérdida o daño por su falta de mantener la seguridad de su Cuenta y contraseña. Podemos solicitar medidas de seguridad adicionales en cualquier momento y nos reservamos el derecho de ajustar estos requisitos a nuestra discreción.
(6) El soporte técnico con respecto a los Servicios solo se proporciona a los Usuarios de Runner AI. Las preguntas sobre los Términos de Servicio deben enviarse al Soporte de Runner AI.
(7) Usted acepta no reproducir, duplicar, copiar, vender, revender o explotar ninguna porción del Servicio, uso de los Servicios o acceso a los Servicios sin el permiso expreso por escrito de Runner AI.
(8) Usted acepta no eludir, evitar o sortear ninguna de las limitaciones técnicas de los Servicios, usar cualquier herramienta para habilitar características o funcionalidades que de otro modo están deshabilitadas en los Servicios, o descompilar, desensamblar o de otro modo aplicar ingeniería inversa a los Servicios.
(9) Usted acepta no acceder a los Servicios o monitorear ningún material o información de los Servicios utilizando cualquier robot, araña, raspador u otros medios automatizados.
(10) Usted entiende que sus Materiales pueden ser transferidos sin cifrar e implicar (a) transmisiones a través de varias redes; y (b) cambios para conformarse y adaptarse a los requisitos técnicos de las redes o dispositivos de conexión. "Materiales" significa Sus Marcas Comerciales, contenido protegido por derechos de autor, cualquier producto o servicio que venda a través de los Servicios (incluida la descripción y el precio), y cualquier foto, imagen, video, gráfico, contenido escrito, archivo de audio, código, información u otros datos proporcionados o puestos a disposición por usted o sus afiliados a Runner AI o sus afiliados.
## 2. Activación de Cuenta
### Lo que esto significa
Solo una persona puede ser el "Propietario de la Tienda", generalmente la persona que se registra en el Servicio de Runner AI. El Propietario de la Tienda es responsable de la Cuenta, está sujeto a estos Términos de Servicio y es responsable de las acciones de otros que acceden a la Cuenta. Si se registra en nombre de su empleador, su empleador es el Propietario de la Tienda responsable de su Cuenta.
### 2.1 Propietario de la Tienda
(1) Sujeto a la Sección 2.1.2, la persona que se registra en el Servicio al abrir una Cuenta será la parte contratante ("Propietario de la Tienda") a los efectos de nuestros Términos de Servicio y será la persona autorizada para usar cualquier Cuenta correspondiente que podamos proporcionar al Propietario de la Tienda en relación con el Servicio. Usted es responsable de asegurar que el nombre del Propietario de la Tienda (incluido el nombre legal de la empresa que posee la Tienda, si corresponde) sea claramente visible en el sitio web de la Tienda.
(2) Si se está registrando en los Servicios en nombre de su empleador, su empleador será el Propietario de la Tienda. Si se está registrando en los Servicios en nombre de su empleador, entonces debe usar su dirección de correo electrónico emitida por el empleador y declara y garantiza que tiene la autoridad para vincular a su empleador con nuestros Términos de Servicio.
(3) Su Tienda de Runner AI solo puede estar asociada con un Propietario de la Tienda. Un Propietario de la Tienda puede tener múltiples Tiendas de Runner AI. "Tienda" significa la tienda en línea (ya sea alojada por Runner AI o en un sitio web de terceros), o ubicación(es) minorista(s) física(s) asociada(s) con la Cuenta.
### 2.2 Cuentas de Personal
(1) Según su plan de precios de Runner AI, puede crear una o más cuentas de personal ("Cuentas de Personal") que permitan a otras personas acceder a la Cuenta. Cada Cuenta de Personal debe incluir un nombre legal completo y una cuenta de correo electrónico válida. Con las Cuentas de Personal, el Propietario de la Tienda puede establecer permisos y permitir que otras personas trabajen en su Cuenta mientras determina el nivel de acceso de las Cuentas de Personal a información comercial específica (por ejemplo, puede limitar el acceso de la Cuenta de Personal a información de ventas en la página de Informes o evitar que las Cuentas de Personal cambien la configuración general de la tienda).
(2) El Propietario de la Tienda es responsable de: (a) asegurar que sus empleados, agentes y subcontratistas, incluidos a través de las Cuentas de Personal, cumplan con estos Términos de Servicio; y (b) cualquier incumplimiento de estos Términos de Servicio por parte de los empleados, agentes o subcontratistas del Propietario de la Tienda. El Propietario de la Tienda reconoce y acepta que el Propietario de la Tienda será responsable del cumplimiento de todas sus obligaciones bajo el Acuerdo, independientemente de si sublicencia o subcontrata cualquiera de dichas obligaciones a cualquier tercero, incluidos, entre otros, cualquier afiliado o subsidiaria del Propietario de la Tienda.
(3) El Propietario de la Tienda y los usuarios bajo las Cuentas de Personal se denominan cada uno como "Usuario de Runner AI".
### 2.3 Proveedores de Pago de Terceros
Nuestros Servicios se integran con varios proveedores de pago de terceros para permitirle procesar pagos para sus transacciones. Su relación con dichos proveedores de pago se rige por sus respectivos términos y condiciones. Usted es el único responsable de crear y mantener sus cuentas con estos proveedores y de todas las actividades relacionadas con su procesamiento de pagos.
## 3. Derechos de Runner AI
### Lo que esto significa
Runner AI tiene el derecho de controlar a quién hacemos disponibles nuestros Servicios y podemos modificarlos en cualquier momento. También tenemos el derecho de rechazar o eliminar Materiales de cualquier parte de los Servicios, incluida su Tienda. Podemos ofrecer nuestros servicios a sus competidores, pero nunca compartiremos su información confidencial con ellos al hacerlo. En caso de una disputa de propiedad sobre una Cuenta de Runner AI, podemos congelar una Cuenta de Runner AI o transferirla al propietario legítimo, según lo determinemos nosotros.
(1) Los Servicios tienen una variedad de características y funcionalidades. No todos los Servicios o características estarán disponibles para todos los Comerciantes en todo momento y no estamos obligados a hacer que ningún Servicio o característica esté disponible en cualquier jurisdicción. Excepto donde esté prohibido en estos Términos de Servicio o por la ley aplicable, nos reservamos el derecho de modificar los Servicios o cualquier parte de los mismos por cualquier motivo.
(2) Runner AI no examina previamente los Materiales y está en nuestra exclusiva discreción rechazar o eliminar cualquier Material de cualquier parte de los Servicios, incluso si determinamos a nuestra exclusiva discreción que los bienes o servicios que ofrece a través de los Servicios, o los Materiales cargados o publicados en los Servicios, violan estos Términos de Servicio.
(3) El abuso verbal o escrito de cualquier tipo (incluidas las amenazas de abuso o represalias) de cualquier empleado, miembro o funcionario de Runner AI resultará en la terminación inmediata de la Cuenta.
(4) Nos reservamos el derecho de proporcionar nuestros Servicios a sus competidores y no prometemos exclusividad. Además, usted reconoce y acepta que los empleados y contratistas de Runner AI también pueden ser clientes o comerciantes de Runner AI y que pueden competir con usted, aunque no pueden usar su Información Confidencial (como se define en la Sección 6) al hacerlo.
(5) En caso de una disputa con respecto a la propiedad de la Cuenta, nos reservamos el derecho de solicitar documentación para determinar o confirmar la propiedad de la Cuenta. La documentación puede incluir, entre otros, una copia escaneada de su licencia comercial, identificación con foto emitida por el gobierno, los últimos cuatro dígitos de la tarjeta de crédito en el archivo o confirmación de su estado como empleado de una entidad.
(6) Runner AI se reserva el derecho de determinar, a nuestra exclusiva discreción, la propiedad legítima de la Cuenta y transferir una Cuenta al Propietario de la Tienda legítimo. Si no podemos determinar razonablemente el Propietario de la Tienda legítimo, sin perjuicio de nuestros otros derechos y recursos, Runner AI se reserva el derecho de suspender o deshabilitar temporalmente una Cuenta hasta que se haya determinado la resolución entre las partes en disputa.
## 4. Sus Responsabilidades
### Lo que esto significa
Usted es responsable de su Tienda de Runner AI, los bienes o servicios que vende y su relación con sus clientes, no nosotros.
(1) Usted reconoce y acepta proporcionar información de contacto pública, una política de reembolso y plazos de cumplimiento de pedidos en su Tienda de Runner AI.
(2) Usted reconoce y acepta que los Servicios no son un mercado, y cualquier contrato de venta realizado a través de los Servicios es directamente entre usted y el cliente. Usted es el vendedor registrado de todos los artículos que vende a través de los Servicios. Usted es responsable de la creación y operación de su Tienda de Runner AI, sus Materiales, los bienes y servicios que puede vender a través de los Servicios y todos los aspectos de las transacciones entre usted y su(s) cliente(s). Esto incluye, entre otros, autorizar el cargo al cliente con respecto a la compra del cliente, reembolsos, devoluciones, cumplir con cualquier venta o servicio al cliente, transacciones fraudulentas, divulgaciones legales requeridas, cumplimiento regulatorio, violación alegada o real de las leyes aplicables (incluidas, entre otras, las leyes de protección al consumidor en cualquier jurisdicción donde ofrezca productos o servicios para la venta), o su incumplimiento de estos Términos de Servicio. Usted declara y garantiza que su Tienda, sus Materiales y los bienes y servicios que vende a través de los Servicios serán verdaderos, precisos y completos, y no violarán ninguna ley, regulación o derechos de terceros aplicables. Para evitar dudas, Runner AI no será el vendedor o comerciante registrado y no tendrá ninguna responsabilidad por su Tienda o artículos vendidos a clientes a través de los Servicios.
(3) Usted es el único responsable de los bienes o servicios que puede vender a través de los Servicios (incluida la descripción, precio, tarifas, impuestos que calcule, defectos, divulgaciones legales requeridas, cumplimiento regulatorio, ofertas o contenido promocional), incluido el cumplimiento de cualquier ley o regulación aplicable.
(4) No puede usar los Servicios de Runner AI para ningún propósito ilegal o no autorizado, ni puede, en el uso del Servicio, violar ninguna ley en su jurisdicción (incluidas, entre otras, las leyes de derechos de autor), las leyes aplicables a usted en la jurisdicción de su cliente o las leyes del Estado de Delaware. Cumplirá con todas las leyes, reglas y regulaciones aplicables (incluidas, entre otras, obtener y cumplir con los requisitos de cualquier licencia o permiso que pueda ser necesario para operar su tienda o que pueda ser poseído por usted) en su uso del Servicio y su cumplimiento de las obligaciones bajo los Términos de Servicio.
## 5. Pago de Tarifas e Impuestos
### Lo que esto significa
Un método de pago válido (como una tarjeta de crédito) debe permanecer en archivo para pagar todas las tarifas de servicio, incluidas las tarifas de suscripción, transacción y adicionales requeridas para todas las tiendas. Se le facturará por sus Tarifas de Suscripción cada 30 días. Cualquier Tarifa de Transacción o Tarifa Adicional se cargará a su método de pago. Si no podemos procesar el pago de las Tarifas utilizando su método de pago, podemos hacer intentos posteriores para procesar el pago de las Tarifas utilizando su método de pago. Si el pago de las Tarifas no tiene éxito dentro de los 30 días de nuestro intento inicial de procesar el pago, Runner AI puede congelar su tienda. Usted es responsable de todos los impuestos relacionados con su Tienda o uso de los Servicios. Es posible que deba remitir Impuestos a Runner AI o auto-remitir a su autoridad fiscal local. No hay reembolsos.
(1) Pagará las Tarifas aplicables a su suscripción al Servicio en Línea y ("Tarifas de Suscripción") y cualquier otra tarifa aplicable, incluidas, entre otras, las tarifas aplicables relacionadas con el valor de las ventas realizadas a través de su Tienda cuando utilice un proveedor de pago de terceros para procesar los pagos de los clientes ("Tarifas de Transacción"), y cualquier tarifa relacionada con su compra o uso de cualquier producto o servicio, como envío, Paquete de Impulso de Crédito o Servicios de Terceros ("Tarifas Adicionales"). Juntas, las Tarifas de Suscripción, las Tarifas de Transacción y las Tarifas Adicionales se denominan las "Tarifas".
(2) Debe mantener un método de pago válido en archivo con nosotros para pagar todas las Tarifas incurridas y recurrentes. Runner AI cargará las Tarifas aplicables a cualquier método de pago válido que autorice ("Método de Pago Autorizado"), y Runner AI continuará cargando al Método de Pago Autorizado las Tarifas aplicables hasta que se terminen los Servicios y se hayan pagado todas las Tarifas pendientes en su totalidad. A menos que se indique lo contrario, todas las Tarifas y otros cargos están en dólares estadounidenses y todos los pagos serán en moneda estadounidense.
(3) Las Tarifas de Suscripción se pagan por adelantado y se facturarán en intervalos de 30 días (cada una de esas fechas, una "Fecha de Facturación"). Las Tarifas de Transacción y las Tarifas Adicionales se cobrarán de vez en cuando a discreción de Runner AI. Se le cobrará en cada Fecha de Facturación por todas las Tarifas pendientes que no se hayan cobrado previamente. Las Tarifas aparecerán en una factura, que se enviará al Propietario de la Tienda a través de la Dirección de Correo Electrónico Principal proporcionada. Además, aparecerá una factura en la página de Cuenta de la consola administrativa de su Tienda. Los usuarios tienen aproximadamente dos semanas para plantear y resolver cualquier problema con la facturación de las Tarifas de Suscripción.
(4) Si no podemos procesar el pago de las Tarifas utilizando un Método de Pago Autorizado, podemos hacer intentos posteriores para procesar el pago utilizando cualquier Método de Pago Autorizado. Si no podemos procesar con éxito el pago de las Tarifas utilizando un Método de Pago Autorizado dentro de los 30 días de nuestro intento inicial, podemos suspender y revocar el acceso a su Cuenta y a los Servicios. Su Cuenta se reactivará tras su pago de cualquier Tarifa pendiente, más las Tarifas aplicables a su próximo ciclo de facturación. Es posible que no pueda acceder a su Cuenta o a su tienda durante cualquier período de suspensión.
(5) Todas las Tarifas son exclusivas de impuestos federales, estatales, locales u otros impuestos gubernamentales sobre ventas, bienes y servicios, armonizados u otros impuestos, tarifas o cargos ahora en vigor o promulgados en el futuro ("Impuestos").
(6) Usted es responsable de todos los Impuestos aplicables que surjan de o como resultado de su suscripción a o compra de los productos y servicios de Runner AI. En la medida en que Runner AI cobre estos Impuestos, se calculan utilizando las tasas impositivas que se aplican según la dirección de facturación que nos proporcione. Tales montos son adicionales a las Tarifas por dichos productos y servicios y se facturarán a su Método de Pago Autorizado. Si está exento del pago de tales Impuestos, debe proporcionarnos evidencia de su exención, que en algunas jurisdicciones incluye un certificado original que satisface los requisitos legales aplicables que atestiguan el estado de exención de impuestos. La exención de impuestos solo se aplicará a partir de la fecha en que recibamos evidencia satisfactoria para Runner AI de su exención. Si Runner AI no le cobra Impuestos, usted es responsable de determinar si los Impuestos son pagaderos y, de ser así, auto-remitir los Impuestos a las autoridades fiscales apropiadas en su jurisdicción.
(7) Para evitar dudas, todas las sumas pagaderas por usted a Runner AI bajo estos Términos de Servicio se pagarán libres y limpias de cualquier deducción o retención. Aparte de los Impuestos cobrados por Runner AI a usted y remitidos a las autoridades fiscales apropiadas en su nombre, cualquier deducción o retención que sea requerida por ley será asumida por usted y pagada por separado a la autoridad tributaria relevante. Runner AI tendrá derecho a cobrar el monto total de las Tarifas estipuladas bajo estos Términos de Servicio a su Método de Pago Autorizado ignorando cualquier deducción o retención que pueda ser requerida.
(8) Usted es el único responsable de determinar, recaudar, retener, informar y remitir los impuestos, aranceles, tarifas, recargos y cargos adicionales aplicables que surjan de o como resultado de cualquier venta en su Tienda de Runner AI o su uso de los Servicios. Los Servicios no son un mercado. Cualquier contrato de venta realizado a través de los Servicios es directamente entre usted y el cliente.
(9) Debe mantener una ubicación precisa en la consola administrativa de su Tienda de Runner AI. Si cambia de jurisdicción, debe actualizar inmediatamente su ubicación en la consola administrativa.
(10) Runner AI no proporciona reembolsos.
## 6. Confidencialidad
### Lo que esto significa
Tanto usted como Runner AI aceptan usar la Información Confidencial del otro solo para cumplir con las obligaciones en estos Términos de Servicio. La Información Confidencial debe ser protegida y respetada.
(1) "Información Confidencial" incluirá, pero no se limitará a, toda la información asociada con el negocio de una parte y no conocida públicamente, incluida información comercial específica, procesos técnicos y fórmulas, software, listas de clientes, listas de clientes potenciales, nombres, direcciones y otra información sobre clientes y clientes potenciales, diseños de productos, ventas, costos (incluidas las tarifas de procesamiento relevantes), listas de precios y otra información financiera no publicada, planes de negocios y datos de marketing, y cualquier otra información confidencial y propietaria, ya sea marcada o no como confidencial o propietaria. La Información Confidencial de Runner AI incluye toda la información que reciba relacionada con nosotros, o con los Servicios, que no sea conocida por el público en general, incluida información relacionada con nuestro programa y prácticas de seguridad.
(2) Cada parte acepta usar la Información Confidencial de la otra parte únicamente según sea necesario para cumplir con sus obligaciones bajo estos Términos de Servicio y de acuerdo con cualquier otra obligación en estos Términos de Servicio, incluida esta Sección 6. Cada parte acepta que tomará todas las medidas razonables, al menos sustancialmente equivalentes a las medidas que toma para proteger su propia información propietaria, para evitar la duplicación, divulgación o uso de dicha Información Confidencial, aparte de (i) por o para sus empleados, agentes y subcontratistas que deben tener acceso a dicha Información Confidencial para cumplir con las obligaciones de dicha parte en virtud del presente, quienes cada uno tratará dicha Información Confidencial según lo dispuesto en este documento, y quienes cada uno están sujetos a obligaciones de confidencialidad para dicha parte que son al menos tan estrictas como las contenidas en este documento; o (ii) según lo requiera cualquier ley, regulación u orden de cualquier tribunal de jurisdicción apropiada sobre las partes y el asunto contenido en estos Términos de Servicio, siempre que, si está legalmente permitido, la parte receptora dará a la parte divulgadora aviso por escrito inmediato y utilizará esfuerzos comercialmente razonables para garantizar que dicha divulgación reciba tratamiento confidencial. La Información Confidencial no incluirá ninguna información que la parte receptora pueda probar: (A) ya estaba en el dominio público, o ya era conocida por o estaba en posesión de la parte receptora, en el momento de la divulgación de dicha información; (B) es desarrollada independientemente por la parte receptora sin uso de o referencia a la Información Confidencial de la otra parte, y sin incumplir ninguna disposición de estos Términos de Servicio; o (C) es posteriormente obtenida legítimamente por la parte receptora de una fuente distinta a la parte divulgadora sin incumplir ninguna disposición de estos Términos de Servicio.
## 7. Limitación de Responsabilidad e Indemnización
### Lo que esto significa
No somos responsables de daños o demandas que surjan si usted infringe la ley, incumple este acuerdo o va en contra de los derechos de un tercero. El Servicio se proporciona "tal cual" y "según disponibilidad". No proporcionamos garantías y nuestra responsabilidad es limitada en caso de errores o interrupciones.
(1) Usted entiende y acepta expresamente que, en la medida permitida por las leyes aplicables, Runner AI y sus proveedores no serán responsables de ningún daño directo, indirecto, incidental, especial, consecuente o ejemplar, incluidos, entre otros, daños por pérdida de beneficios, buena voluntad, uso, datos u otras pérdidas intangibles que surjan de o se relacionen con el uso de o la imposibilidad de usar el Servicio o estos Términos de Servicio (sin importar cómo surjan, incluida negligencia).
EN LA MÁXIMA MEDIDA PERMITIDA POR LA LEY, SIN PERJUICIO DE CUALQUIER DISPOSICIÓN EN CONTRARIO CONTENIDA EN EL PRESENTE, NUESTRA RESPONSABILIDAD HACIA USTED POR CUALQUIER DAÑO QUE SURJA DE O SE RELACIONE CON ESTOS TÉRMINOS (POR CUALQUIER CAUSA Y INDEPENDIENTEMENTE DE LA FORMA DE LA ACCIÓN), ESTARÁ EN TODO MOMENTO LIMITADA AL MONTO DE LAS TARIFAS QUE USTED NOS PAGÓ EN LOS SEIS (6) MESES ANTERIORES (O, SI NO SE HAN PAGADO TARIFAS, A UN MÁXIMO DE CINCUENTA DÓLARES ESTADOUNIDENSES ($50)). LA EXISTENCIA DE MÁS DE UN RECLAMO NO AMPLIARÁ ESTE LÍMITE.
(2) Usted acepta indemnizar y mantener indemnes a nosotros y (según corresponda) a nuestra empresa matriz, subsidiarias, afiliados, socios de Runner AI, funcionarios, directores, agentes, empleados y proveedores de cualquier reclamo o demanda, incluidos los honorarios razonables de abogados, realizados por cualquier tercero debido a o que surjan de (a) su incumplimiento de estos Términos de Servicio o los documentos que incorpora por referencia (incluida la PUA); (b) o su violación de cualquier ley o los derechos de un tercero; o (c) cualquier aspecto de la transacción entre usted y su Cliente, incluidos, entre otros, reembolsos, transacciones fraudulentas, violación alegada o real de las leyes aplicables (incluidas, entre otras, las leyes federales y estatales de protección al consumidor), o su incumplimiento de los Términos de Servicio.
(3) Usted será responsable de cualquier incumplimiento de los Términos de Servicio por parte de sus afiliados, agentes o subcontratistas y será responsable como si fuera su propio incumplimiento.
(4) Su uso de los Servicios es bajo su propio riesgo. Los Servicios se proporcionan "tal cual" y "según disponibilidad" sin ninguna garantía o condición, expresa, implícita o estatutaria.
(5) Runner AI no garantiza que los Servicios sean ininterrumpidos, oportunos, seguros o libres de errores.
(6) Runner AI no garantiza que los resultados que se puedan obtener del uso de los Servicios sean precisos o confiables.
Específicamente, usted reconoce que los Servicios utilizan inteligencia artificial y algoritmos de aprendizaje automático para proporcionar características como operaciones automatizadas y sugerencias de crecimiento. Usted entiende que estos son sistemas probabilísticos y Runner AI no ofrece ninguna garantía con respecto a la rentabilidad, el éxito o los resultados específicos de cualquier acción tomada en función de las salidas o sugerencias de estos sistemas de IA.
(7) Runner AI no es responsable de ninguna de sus obligaciones o responsabilidades fiscales relacionadas con el uso de los Servicios de Runner AI.
(8) Runner AI no garantiza que la calidad de cualquier producto, servicio, información u otros materiales comprados u obtenidos por usted a través de los Servicios cumplirá con sus expectativas, o que se corregirán los errores en los Servicios.
(9) En ningún caso Runner AI será responsable por cualquier pérdida de ingresos, datos o buena voluntad del cliente que resulte del uso de Experimentos o del rendimiento de cualquier experimento generado por IA.
## 8. Propiedad Intelectual y Sus Materiales
### Lo que esto significa
Cualquier cosa que cargue sigue siendo suya (si era suya) y es su responsabilidad, pero Runner AI puede usar y publicar las cosas que cargue. Cualquier cosa cargada a Runner AI sigue siendo propiedad y responsabilidad de su propietario inicial. Sin embargo, Runner AI recibirá una licencia de los materiales publicados a través de nuestra plataforma que podemos usar para operar y promover nuestros Servicios.
### 8.1 Sus Materiales
(1) No reclamamos propiedad de los Materiales que proporciona a Runner AI; sin embargo, sí requerimos una licencia para esos Materiales. Usted otorga a la compañía un derecho y licencia no exclusivos, transferibles, sublicenciables, libres de regalías y mundiales para alojar, usar, distribuir, exponer, modificar, ejecutar, copiar, almacenar, realizar públicamente, comunicar al público (incluso por telecomunicación), transmitir, reproducir, poner a disposición, mostrar y traducir, y crear obras derivadas de cualquier Material proporcionado por usted en relación con los Servicios. Podemos usar nuestros derechos bajo esta licencia para operar, proporcionar y promover los Servicios y para cumplir con nuestras obligaciones y ejercer nuestros derechos bajo los Términos de Servicio. Usted declara, garantiza y acepta que tiene todos los derechos necesarios en los Materiales para otorgar esta licencia. Usted renuncia irrevocablemente a cualquier y todos los derechos morales que pueda tener en los Materiales a favor de Runner AI y acepta que esta renuncia puede ser invocada por cualquier persona que obtenga derechos en los materiales a través de Runner AI, incluida cualquier persona a quien Runner AI pueda transferir u otorgar (incluso mediante licencia o sublicencia) cualquier derecho en los Materiales.
(2) Si usted era propietario de los Materiales antes de proporcionarlos a Runner AI, entonces, a pesar de cargarlos en su Tienda de Runner AI, siguen siendo suyos, sujetos a cualquier derecho o licencia otorgados en los Términos de Servicio o en otro lugar. Puede eliminar su Tienda de Runner AI en cualquier momento eliminando su Cuenta. La eliminación de su Tienda de Runner AI no termina ningún derecho o licencia otorgados a los Materiales que Runner AI requiere para ejercer cualquier derecho o cumplir con cualquier obligación que surgió durante el Plazo.
(3) Usted acepta que Runner AI puede, en cualquier momento, revisar y eliminar cualquiera o todos los Materiales enviados a los Servicios, aunque Runner AI no está obligado a hacerlo.
(4) Usted otorga a Runner AI un derecho y licencia no exclusivos, transferibles, sublicenciables, libres de regalías y mundiales para usar los nombres, marcas comerciales, marcas de servicio y logotipos asociados con su Tienda ("Sus Marcas Comerciales") para operar, proporcionar y promover los Servicios y para cumplir con nuestras obligaciones y ejercer nuestros derechos bajo los Términos de Servicio. Esta licencia sobrevivirá a cualquier terminación de los Términos de Servicio únicamente en la medida en que Runner AI requiera la licencia para ejercer cualquier derecho o cumplir con cualquier obligación que surgió durante el Plazo.
### 8.2 Propiedad Intelectual de Runner AI
(1) Usted acepta que no puede usar ninguna marca comercial, logotipo o marca de servicio de Runner AI, ya sea registrada o no registrada, incluidas, entre otras, la marca denominativa Runner AI y la marca gráfica Runner AI ("Marcas Comerciales de Runner AI") a menos que esté autorizado para hacerlo por Runner AI por escrito. Usted acepta no usar ni adoptar ninguna marca que pueda considerarse confusa con las Marcas Comerciales de Runner AI. Usted acepta que cualquier variación o error ortográfico de las Marcas Comerciales de Runner AI se consideraría confuso con las Marcas Comerciales de Runner AI.
(2) Usted acepta no comprar, registrar o usar motores de búsqueda u otras palabras clave de pago por clic (como Google Ads), marcas comerciales, direcciones de correo electrónico, nombres de redes sociales o nombres de dominio (incluidos, entre otros, dominios de nivel superior, subdominios y URL de página) que usen o incluyan Runner AI o las Marcas Comerciales de Runner AI o que usen o incluyan cualquier término que pueda ser confuso con las Marcas Comerciales de Runner AI.
(3) Usted reconoce y acepta que los Términos de Servicio no le otorgan ningún derecho a implementar patentes de Runner AI.
### 8.3 Uso de Datos para Mejora de IA
Para monitorear, mejorar y proteger nuestros Servicios, y para optimizar nuestros algoritmos y modelos de inteligencia artificial, usted nos otorga un derecho perpetuo, irrevocable, mundial y libre de regalías para usar sus 'Materiales' y datos operativos asociados en forma anónima y agregada. Nos comprometemos a que cualquier uso de este tipo no identificará a ningún individuo, comerciante o sus clientes específicos, y se utilizará únicamente con el propósito de mejorar la calidad general del servicio y las capacidades técnicas de nuestra plataforma.
## 9. Servicios Adicionales
### 9.1 Integraciones de Envío de Terceros
Nuestros Servicios pueden integrarse con varios transportistas y servicios de envío de terceros para gestionar su cumplimiento. Su uso de dichos servicios de terceros está sujeto a sus respectivos términos y condiciones, y usted es el único responsable de su relación con ellos.
### 9.2 Servicios Beta
#### Lo que esto significa
Los Servicios Beta pueden ofrecerse de vez en cuando. No son parte de los Servicios regulares y pueden tener errores o cambiar en cualquier momento. Utiliza los Servicios Beta bajo su propio riesgo, y no somos responsables de ninguna pérdida o daño que pueda surgir del uso de un Servicio Beta. Es posible que se le solicite mantener su participación en los Servicios Beta confidencial.
De vez en cuando, Runner AI puede, a su exclusiva discreción, invitarlo a usar, de forma provisional, características previas al lanzamiento o beta que están en desarrollo y aún no están disponibles para todos los comerciantes ("Servicios Beta"). Los Servicios Beta no son parte de los Servicios, y los Servicios Beta pueden estar sujetos a términos y condiciones adicionales, que Runner AI le proporcionará antes de su uso de los Servicios Beta. Dichos Servicios Beta y todas las conversaciones y materiales asociados relacionados con los mismos se considerarán Información Confidencial de Runner AI y estarán sujetos a las disposiciones de confidencialidad de este acuerdo. Sin limitar la generalidad de lo anterior, usted acepta que no hará ninguna declaración pública ni divulgará de otro modo su participación en los Servicios Beta sin el consentimiento previo por escrito de Runner AI. Runner AI no hace ninguna representación o garantía de que los Servicios Beta funcionarán. Runner AI puede descontinuar los Servicios Beta en cualquier momento a su exclusiva discreción. Runner AI no tendrá ninguna responsabilidad por ningún daño o perjuicio que surja de o en conexión con un Servicio Beta. Los Servicios Beta pueden no funcionar de la misma manera que una versión final. Runner AI puede cambiar o no lanzar una versión final o comercial de un Servicio Beta a nuestra exclusiva discreción.
### 9.3 Administrador de Píxeles de Runner AI
#### Lo que esto significa
El Administrador de Píxeles de Runner AI le permite a usted o a un tercero rastrear eventos de clientes agregando píxeles a su Tienda de Runner AI. Si usa el Administrador de Píxeles de Runner AI, es responsable de obtener todos los consentimientos necesarios de los visitantes de la tienda y clientes cuyos eventos rastree.
Runner AI le permite agregar píxeles a su Tienda de Runner AI para permitirle a usted o a un tercero rastrear eventos de clientes (el "Administrador de Píxeles de Runner AI"). Puede administrar sus píxeles desde la interfaz de usuario en la consola administrativa de su Tienda de Runner AI.
(1) Además de los términos aplicables a su uso de los Servicios en general (incluidos estos Términos de Servicio, la Política de Uso Aceptable de Runner AI y la Política de Privacidad), los siguientes términos se aplican a su acceso y uso del Administrador de Píxeles de Runner AI:
- a. Cumplirá con todas las leyes aplicables y obtendrá todos los consentimientos necesarios de cada visitante del sitio y cliente cuyos eventos rastree;
- b. Si proporciona a Runner AI cualquier dato recopilado mediante píxeles, incluidos nombres, direcciones de correo electrónico, números de teléfono u otros datos que identifiquen personalmente a un individuo, obtendrá todos los derechos y consentimientos necesarios antes de proporcionar a Runner AI la información anterior;
- c. Usted acepta que Runner AI puede deshabilitar cualquier píxel que Runner AI identifique como malicioso, a exclusiva discreción de Runner AI; y
- d. Usted no permitirá, ni permitirá que terceros, usen píxeles:
- i. para participar o promover cualquier actividad ilegal, infractora, difamatoria o de otro modo dañina; o
- ii. para deshabilitar, interferir o eludir cualquier aspecto de los Servicios.
(2) Runner AI puede recopilar información asociada con el Administrador de Píxeles de Runner AI, como la forma en que se usan los píxeles y cómo y qué scripts se agregan. Runner AI puede usar estos datos para mejorar, mantener, proteger y desarrollar el Administrador de Píxeles de Runner AI.
### 9.4 Experimentos (Beta) y Experimentos Automatizados
#### Lo que esto significa
Experimentos es una función experimental que utiliza IA para probar diferentes versiones de su tienda. Al activarla, nos permite mostrar variaciones generadas por IA de su tienda a algunos de sus visitantes, incluyendo pero no limitado a diseños, precios y reglas de envío.
Solo el Administrador de su tienda puede habilitar esto y decidir cuánto tráfico probar (comenzando en 10% por defecto). Debido a que esta es una función Beta, no hay garantía de que aumente sus ventas o funcione perfectamente cada vez. Usted la usa bajo su propio riesgo.
(1) **Autorización para Tráfico Experimental**: Al habilitar activamente Experimentos dentro de los Servicios, usted autoriza expresamente a Runner AI a realizar experimentos automatizados en su Tienda. Usted reconoce y acepta que:
- **Asignación de Tráfico**: Tras la activación, el Sistema asignará automáticamente el diez por ciento (10%) o la proporción de tráfico acordada del tráfico web de su Tienda a un grupo experimental (el "Grupo Experimental").
- **Control del Usuario**: Usted conserva el derecho de aumentar, disminuir o deshabilitar manualmente esta asignación de tráfico en cualquier momento a través del panel de administración.
- **Variaciones Experimentales**: Los visitantes en el Grupo Experimental pueden ver variaciones, incluyendo pero no limitado a diseños de tienda, precios de productos, tarifas de envío y otro contenido o lógica de la tienda, que difieren de su versión principal de la Tienda. Usted es responsable del cumplimiento de las leyes locales con respecto a precios dinámicos y divulgación al consumidor.
(2) **Control Administrativo**: El acceso a la configuración de Experimentos está restringido a Usuarios con permisos de "Admin". Solo un Administrador autorizado tiene la autoridad para:
- Habilitar o deshabilitar la función Experimentos;
- Ajustar la configuración experimental, incluidos los porcentajes de asignación de tráfico.
Runner AI no será responsable por ninguna configuración modificada por personas a quienes usted haya otorgado acceso administrativo.
(3) **Descargo de Responsabilidad Beta y Limitación de Responsabilidad**: Experimentos se proporciona como una función "Beta" y no forma parte de los Servicios estándar. Sin perjuicio de cualquier disposición en contrario en estos Términos de Servicio:
- **Evolución del Servicio**: La funcionalidad, el rendimiento y los diseños de interfaz de usuario de Experimentos pueden cambiar, suspenderse o descontinuarse por Runner AI en cualquier momento sin previo aviso.
- **Sin Garantía de Resultados**: Runner AI no hace representaciones ni garantías con respecto al resultado de cualquier experimento. No garantizamos tasas de conversión específicas, aumentos de ingresos, clasificaciones en motores de búsqueda u otros resultados comerciales.
- **Asunción de Riesgo**: Usted reconoce que el contenido experimental generado por IA puede contener errores. Su uso de Experimentos es bajo su propio riesgo, y Runner AI no es responsable de ningún impacto negativo en el rendimiento de su Tienda, incluyendo pero no limitado a pérdida de ingresos, errores de precios o disputas con clientes, resultantes de dichos experimentos.
## 10. Comentarios y Reseñas
### Lo que esto significa
Damos la bienvenida a los comentarios de los clientes, pero no estamos obligados a garantizar que las ideas y sugerencias sobre nuestros Servicios o los servicios de terceros permanezcan confidenciales y podemos usar los comentarios de cualquier manera que queramos.
Runner AI da la bienvenida a cualquier idea y/o sugerencia sobre mejoras o adiciones a los Servicios. Bajo ninguna circunstancia cualquier divulgación de cualquier idea, sugerencia o material relacionado o cualquier revisión de los Servicios, Servicios de Terceros o cualquier Proveedor de Terceros (colectivamente, "Comentarios") a Runner AI estará sujeta a ninguna obligación de confidencialidad o expectativa de compensación. Al enviar Comentarios a Runner AI (ya sea enviados directamente a Runner AI o publicados en cualquier foro o página alojada por Runner AI), usted renuncia a todos y cada uno de los derechos en los Comentarios y que Runner AI es libre de implementar y usar los Comentarios si lo desea, según lo proporcionado por usted o según lo modificado por Runner AI, sin obtener permiso o licencia de usted o de cualquier tercero. Cualquier revisión de un Servicio de Terceros o Proveedor de Terceros que envíe a Runner AI debe ser precisa según su leal saber y entender, y no debe ser ilegal, obscena, amenazante, difamatoria, invasiva de la privacidad, infractora de derechos de propiedad intelectual, o de otro modo perjudicial para terceros u objetable. Runner AI se reserva el derecho (pero no la obligación) de eliminar o editar Comentarios de Servicios de Terceros o Proveedores de Terceros, pero no inspecciona regularmente los Comentarios publicados.
## 11. Aviso DMCA y Procedimiento de Retiro
### Lo que esto significa
Runner AI respeta los derechos de propiedad intelectual y usted también debería hacerlo. Si recibimos un Aviso DMCA, podemos deshabilitar el acceso o eliminar el contenido supuestamente infractor de su Tienda. Si no cree que el reclamo sea válido, puede enviar una contranotificación. Si cree que uno de nuestros comerciantes está infringiendo sus derechos de propiedad intelectual, puede enviar a Runner AI un Aviso DMCA. Deshabilitaremos rápidamente el acceso o eliminaremos el contenido y notificaremos al comerciante.
Runner AI apoya la protección de la propiedad intelectual y solicita a los comerciantes de Runner AI que hagan lo mismo. Es nuestra política responder a todos los avisos de presunta infracción de derechos de autor. Si alguien cree que uno de nuestros comerciantes está infringiendo sus derechos de propiedad intelectual, pueden enviar un Aviso DMCA al agente designado de Runner AI usando support@adaptivemachines.ai. Al recibir un Aviso DMCA, podemos eliminar o deshabilitar el acceso a los Materiales que se alega que son una infracción de derechos de autor. Una vez que se proporcione un aviso de retiro, el comerciante puede responder con una contranotificación usando el correo electrónico si se opone a la queja. El denunciante original tiene 14 días hábiles después de que recibamos una contranotificación para solicitar una orden judicial que impida que el comerciante participe en la actividad infractora, de lo contrario restauramos el material.
## 12. Privacidad y Protección de Datos
### Lo que esto significa
El uso y la recopilación de información personal por parte de Runner AI se rige por nuestra Política de Privacidad. El uso y la recopilación de información personal del cliente por parte de Runner AI se rige además por nuestro Addendum de Procesamiento de Datos.
Runner AI está firmemente comprometido con la protección de la privacidad de su información personal y la información personal de sus clientes. Al utilizar el Servicio, usted reconoce y acepta que la recopilación, el uso y la divulgación de esta información personal por parte de Runner AI se rige por nuestra [Política de Privacidad](/es/legal/policies).
En la medida en que Runner AI procese información personal de sus clientes como un "procesador de datos" o "proveedor de servicios" bajo ciertas leyes de privacidad o protección de datos, incluido el Reglamento General de Protección de Datos de la UE o el Reino Unido y la Ley de Privacidad del Consumidor de California, la recopilación y el uso de información personal por parte de Runner AI también está sujeto a nuestro [Addendum de Procesamiento de Datos](/es/legal/dpa).
## 13. Parte Contratante de Runner AI
"Parte Contratante" significa Adaptive Machines, Inc., una corporación de Delaware, con su lugar principal de negocios en 131 Continental Dr Suite 305 Newark, DE, 19713 US
Las partes se someten irrevocable e incondicionalmente a la jurisdicción exclusiva de los tribunales estatales y federales ubicados en el Estado de Delaware con respecto a cualquier disputa o reclamo que surja de o en conexión con los Términos de Servicio. La Convención de las Naciones Unidas sobre los Contratos de Compraventa Internacional de Mercaderías no se aplicará a estos Términos de Servicio y queda expresamente excluida.
## 14. Plazo y Terminación
### Lo que esto significa
Puede cancelar su suscripción en cualquier momento desde la configuración de su cuenta. Podemos terminar su cuenta en cualquier momento. Para las Tiendas con un plan gratuito, Runner AI se reserva el derecho de eliminar permanentemente la Tienda y todos los datos asociados si la Tienda permanece inactiva durante un período de catorce (14) días consecutivos.
(1) El plazo de estos Términos de Servicio comenzará en la fecha de su registro completado para el uso de un Servicio y continuará hasta que sea terminado por nosotros o por usted, según se dispone a continuación (el "Plazo").
(2) Puede cancelar su Cuenta y terminar los Términos de Servicio en cualquier momento accediendo a la configuración de su cuenta.
(3) Sin limitar ningún otro recurso, podemos suspender o terminar su Cuenta o los Términos de Servicio por cualquier motivo, sin previo aviso y en cualquier momento (a menos que la ley exija lo contrario), incluso si sospechamos que usted (por condena, acuerdo, investigación de seguro o depósito en garantía, o de otro modo) ha participado en actividades fraudulentas en conexión con el uso de los Servicios. La terminación de los Términos de Servicio será sin perjuicio de ningún derecho u obligación que surgió antes de la fecha de terminación.
(4) Tras la terminación de los Servicios por cualquiera de las partes por cualquier motivo:
- Runner AI dejará de proporcionarle los Servicios y ya no podrá acceder a su Cuenta;
- a menos que se disponga lo contrario en los Términos de Servicio, no tendrá derecho a ningún reembolso de ninguna Tarifa, prorrateada o de otro tipo;
- cualquier saldo pendiente adeudado a Runner AI por su uso de los Servicios hasta la fecha efectiva de dicha terminación se vencerá y será pagadero en su totalidad inmediatamente; y
- su Tienda de Runner AI se desconectará.
(5) Si hay Tarifas pendientes adeudadas por usted en la fecha de terminación del Servicio, recibirá una factura final por correo electrónico. Una vez que esa factura se haya pagado en su totalidad, no se le cobrará nuevamente.
(6) Cuentas Gratuitas Inactivas: Para las Tiendas con un plan de suscripción gratuito (excluyendo las "pruebas gratuitas" temporales de un plan de pago), Runner AI se reserva el derecho de eliminar permanentemente la Tienda y todos los datos asociados si la Tienda permanece inactiva durante un período de catorce (14) días consecutivos. Runner AI proporcionará un aviso a través de la Dirección de Correo Electrónico Principal antes de dicha eliminación. Usted reconoce que Runner AI no tendrá ninguna responsabilidad por cualquier pérdida de datos resultante de la eliminación de una Tienda inactiva bajo esta Sección.
## 15. Modificaciones
### Lo que esto significa
Si realizamos un cambio material a los Términos de Servicio que afecte negativamente sus derechos bajo los Términos de Servicio o su uso de nuestros Servicios de manera material, se lo notificaremos con anticipación (a menos que el cambio se relacione con requisitos legales o para prevenir el abuso de nuestros Servicios, entre otras cosas).
(1) Nos reservamos el derecho, a nuestra exclusiva y absoluta discreción, de actualizar o cambiar cualquier porción de los Términos de Servicio en cualquier momento. Le proporcionaremos un aviso previo razonable de los cambios a los Términos de Servicio que afecten materialmente de manera adversa su uso de los Servicios o sus derechos bajo los Términos de Servicio al enviar un correo electrónico a la Dirección de Correo Electrónico Principal, proporcionar un aviso a través de la consola administrativa de Runner AI, o por medios similares. Sin embargo, Runner AI puede hacer cambios que afecten materialmente de manera adversa su uso de los Servicios o sus derechos bajo los Términos de Servicio en cualquier momento y con efecto inmediato (i) por razones legales, regulatorias, de prevención de fraude y abuso, o de seguridad; o (ii) para restringir productos o actividades que consideremos inseguros, inapropiados u ofensivos. A menos que indiquemos lo contrario en nuestro aviso (si corresponde), cualquier cambio a los Términos de Servicio será efectivo inmediatamente tras la publicación de dichos términos actualizados en esta ubicación. Su acceso continuo o uso de los Servicios después de que proporcionemos dicho aviso, si corresponde, o después de que publiquemos dichos términos actualizados, constituye su aceptación de los cambios y consentimiento para estar sujeto a los Términos de Servicio según se modificaron. Si no está de acuerdo con los Términos de Servicio modificados, debe dejar de acceder y usar los Servicios.
(2) Runner AI puede cambiar las Tarifas para los Servicios de vez en cuando. Le proporcionaremos un aviso previo de 30 días antes de cualquier cambio en las Tarifas al enviar un correo electrónico a la Cuenta de Correo Electrónico Principal, proporcionar un aviso a través de la consola administrativa de Runner AI, o por medios similares. Runner AI no será responsable ante usted o ante ningún tercero por cualquier modificación, cambio de precio, suspensión o discontinuación de los Servicios (o cualquier parte de los mismos).
## 16. Condiciones Generales
(1) Los Términos de Servicio, incluidos los documentos que incorpora por referencia, constituyen el acuerdo completo entre usted y Runner AI y rigen su uso de los Servicios y su Cuenta, reemplazando cualquier acuerdo previo entre usted y la compañía (incluidas, entre otras, las versiones anteriores de los Términos de Servicio).
(2) El hecho de que Runner AI no ejerza o haga cumplir ningún derecho o disposición de los Términos de Servicio no constituirá una renuncia a dicho derecho o disposición. Si alguna disposición de los Términos de Servicio, incluidos todos los términos y condiciones y otros documentos que incorpora por referencia, es considerada contraria a la ley por un tribunal de jurisdicción competente, dicha disposición se cambiará e interpretará de manera que logre mejor los objetivos de la disposición original en la máxima medida permitida por la ley, y las disposiciones restantes de los Términos de Servicio permanecerán en pleno vigor y efecto.
(3) Excepto por Runner AI y sus afiliados, usted o cualquier persona que acceda a los Servicios de Runner AI de conformidad con estos Términos de Servicio, a menos que se disponga lo contrario en estos Términos de Servicio, ninguna persona o entidad que no sea parte de estos Términos de Servicio tendrá ningún derecho a hacer cumplir ningún término de estos Términos de Servicio, independientemente de si dicha persona o entidad ha sido identificada por nombre, como miembro de una clase o como respuesta a una descripción particular. Para evitar dudas, esto no afectará los derechos de ningún cesionario o transferente permitido de estos Términos.
(4) Estos Términos de Servicio y cualquier disputa o reclamo que surja de o en conexión con ellos se regirán e interpretarán de acuerdo con las leyes del Estado de Delaware, sin tener en cuenta sus principios de conflictos de leyes.
(5) Los Términos de Servicio pueden estar disponibles en idiomas distintos del inglés. En caso de cualquier inconsistencia o conflicto entre estos Términos de Servicio en inglés y los Términos de Servicio de Runner AI disponibles en otro idioma, prevalecerá la versión en inglés más reciente de los Términos de Servicio. Cualquier disputa que surja de estos Términos de Servicio se resolverá en inglés a menos que Runner AI (actuando a su exclusiva discreción) determine lo contrario o según lo requiera la ley aplicable.
(6) Todos los términos y disposiciones de los Términos de Servicio serán vinculantes y redundarán en beneficio de las partes de los Términos de Servicio y de sus respectivos herederos, sucesores, cesionarios permitidos y representantes legales. La compañía podrá ceder estos Términos de Servicio sin previo aviso ni consentimiento de usted. Usted no tendrá derecho a ceder o transferir de otro modo los Términos de Servicio, o cualquiera de sus derechos u obligaciones en virtud del presente, a ningún tercero sin el consentimiento previo por escrito de Runner AI, que se otorgará o retendrá a exclusiva discreción de Runner AI.
(7) Si alguna disposición, o parte de la disposición, en estos Términos de Servicio es, por cualquier razón, considerada inválida, ilegal o inaplicable en cualquier aspecto, entonces dicha invalidez, ilegalidad o inaplicabilidad no afectará ninguna otra disposición (o la parte no afectada de la disposición) de los Términos de Servicio, y los Términos de Servicio se interpretarán como si dicha disposición inválida, ilegal o inaplicable, o parte de la disposición, nunca hubiera estado contenida dentro de los Términos de Servicio.
(8) Tras la terminación, todos los derechos y obligaciones relacionados bajo los Términos de Servicio terminan inmediatamente, excepto que (a) usted seguirá siendo responsable de cumplir con todas sus obligaciones en relación con las transacciones realizadas antes de la terminación y por cualquier responsabilidad que se haya acumulado antes o como resultado de la terminación; y las Secciones 1 (Términos de Cuenta), 5 (Pago de Tarifas), 6 (Confidencialidad), 7 (Limitación de Responsabilidad e Indemnización), 8.1 (Propiedad Intelectual y Sus Materiales), 10 (Comentarios y Reseñas), 12 (Privacidad y Protección de Datos), 13 (Parte Contratante de Runner AI), 14 (Cancelación y Terminación), 15 (Modificaciones) y 16 (Condiciones Generales) sobrevivirán a la terminación o expiración de estos Términos de Servicio.
---
Adaptive Machines, Inc.
131 Continental Dr Suite 305 Newark, DE, 19713 US
---
# Compte et paramètres
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings
Runner regroupe les paramètres par qui ou ce qu'ils affectent : l'espace de travail, le magasin actuel ou vous. Cela maintient la facturation partagée et les membres séparés des domaines spécifiques au magasin et de votre profil personnel.
## Ce que couvre ce guide
Vous saurez où se trouve chaque groupe de paramètres et quelles pages nécessitent un rôle, un plan, un magasin publié ou une fonctionnalité intermédiaire.
## Disponibilité et conditions préalables
- Vous devez être connecté.
- Ouvrez **Paramètres** à partir de l'espace de travail ou du menu projet.
- Les paramètres du magasin n'apparaissent que lorsque vous ouvrez Paramètres depuis un projet.
- Faites correspondre le nom de l'espace de travail ou du magasin dans la barre latérale des paramètres avant de procéder à la modification. Les contrôles personnels apparaissent sous le nom de votre compte.
- Pour fermer des sessions sur d'autres appareils ou supprimer votre compte, contactez le support Runner. Consultez [Sécurité et sessions](/fr/guides/account-and-settings/security-and-sessions).
- Certains contrôles nécessitent une permission de propriétaire d'espace de travail ou d'administrateur.
- Les pages Domaine, Clé API et Expériences peuvent être masquées ou limitées par plan, état de publication ou disponibilité intermédiaire.
## Ouvrir les paramètres
1. Dans l'espace de travail ou le projet prévu, ouvrez son menu.
2. Sélectionnez **Paramètres**.
3. Confirmez le sélecteur **Espace de travail : _nom de l’espace de travail_**, puis choisissez une page sous ce groupe, **Store : _nom du magasin_** ou le nom de votre compte. L’ouverture des paramètres dans un magasin peut commencer sur Général du store.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Faites correspondre les en-têtes de l’espace de travail et du magasin avant de choisir une page. Les contrôles de compte se situent en dessous de ces groupes.
## Carte des paramètres
| Groupe et page | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| Espace de travail → **Général** | Renommez ou décrivez l'espace de travail. | Les modifications valides s'enregistrent automatiquement. La zone de danger contient également Supprimer l'espace de travail. |
| Espace de travail → **Membres** | Invitez des personnes et gérez l'accès actif ou en attente. | Les propriétaires peuvent inviter, annuler les invitations ou supprimer des membres ; les membres éligibles peuvent partir. |
| Espace de travail → **Plan et Facturation** | Vérifiez le plan actuel et les actions de facturation disponibles. | Les cartes de plan, la confirmation, le paiement, la gestion de la facturation et les options de crédit supplémentaire apparaissent selon l'état du compte. |
| Espace de travail → **Utilisation et crédits** | Comprenez le solde, les sources et les dépenses. | Un contrôle de plage de dates met à jour le résumé, le graphique, les cartes de catégorie et le flux d'activité. |
| Magasin → **Général** | Gérez l'identité du magasin actuel et son apparence de recherche. | Le nom, le titre de la page, la description, la favicon, le filigrane et les contrôles Supprimer le magasin apparaissent. |
| Magasin → **Domaine** | Connectez, achetez, renouvelez ou transférez un domaine. | La disponibilité dépend du plan, de la publication, de la permission et de l'état du domaine. |
| Magasin → **Scripts personnalisés** | Ajoutez du JavaScript à la vitrine. | Les modifications restent non enregistrées jusqu'à ce que vous sélectionniez **Enregistrer les modifications**. |
| Magasin → **Agent** | Choisissez les compétences disponibles dans ce projet. | Vous pouvez ajouter ou désactiver les compétences configurables pour ce magasin. |
| Magasin → **Expériences** | Configurez les objectifs d'expérience automatisée et le trafic. | Cette page Bêta n'apparaît que si elle est activée et nécessite un magasin publié. |
| Votre nom de compte → **Mes paramètres** | Choisissez la langue, les e-mails hebdomadaires sur les performances et les sons de l'interface. | Sauvegarde des préférences ; les changements de langue rechargent la page actuellement localisée. |
| Votre nom de compte → **Clés API** | Créez des informations d’identification pour l’accès par programmation. | Le secret complet apparaît une fois ; la révocation est destructrice. Cette page est conditionnelle. |
## Choisir la bonne portée
1. Utilisez **Espace de travail** pour les membres, les crédits partagés, le plan et la facturation.
2. Utilisez **Magasin** pour la vitrine actuelle, le domaine, les scripts et les paramètres de l'agent du projet.
3. Utilisez **Personnel** pour votre propre profil, langue et clés API.
4. Avant une action sensible, confirmez les noms d'espace de travail et de magasin affichés dans la boîte de dialogue.
## États et limites courants
- **Enregistrement…** suivi de **Enregistré** confirme qu'un champ d'enregistrement automatique s'est terminé.
- Un contrôle désactivé peut indiquer une permission manquante, une porte de plan, une condition préalable au magasin ou une opération déjà en cours.
- Les pages de facturation et de domaine affichent les conditions et le montant actuels. Ne vous fiez pas à une ancienne capture d'écran ou à un prix copié.
- Les actions destructives nécessitent une confirmation, mais la confirmation exacte diffère selon l'action.
- Les pages masquées ne doivent pas être ouvertes via des liens copiés sauf si l'interface actuelle les expose pour votre compte.
## Dépannage
- Si le groupe Magasin est manquant, fermez Paramètres, entrez le projet prévu et ouvrez Paramètres à nouveau.
- Si une page affiche une mise à niveau ou un état de publication d'abord, terminez ce préalable uniquement s'il correspond à votre flux de travail prévu.
- Si un enregistrement automatique échoue, la valeur précédente reste ou revient ; corrigez le champ et réessayez.
- Si vous ne savez pas quel espace de travail est modifié, fermez la boîte de dialogue et rouvrez Paramètres à partir de cet espace de travail.
- Si vous avez besoin d'aide en matière de sécurité du compte mais qu'aucune entrée approuvée n'est visible, contactez le support Runner au lieu de deviner un itinéraire direct.
## Guides connexes
- [Espace de travail général](/fr/guides/account-and-settings/workspace-general)
- [Membres et invitations](/fr/guides/workspace/members-and-invitations)
- [Forfaits d'abonnement](/fr/guides/plans-and-billing/subscription-plans)
- [Magasin général](/fr/guides/account-and-settings/store-general)
- [Sécurité et sessions](/fr/guides/account-and-settings/security-and-sessions)
---
# Paramètres d'Expériences
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/ai-lab
Les paramètres d'Expériences configurent les expériences automatisées de la vitrine pour un magasin publié éligible. Utilisez-les lorsque vous souhaitez intentionnellement que Runner optimise un objectif commercial sélectionné avec une partie de votre trafic en direct.
## Ce que couvre ce guide
Vous saurez comment activer le paramètre Bêta, choisir un objectif et une allocation de trafic, l'enregistrer et reconnaître les états de démarrage ou d'arrêt.
## Disponibilité et conditions préalables
- La fonctionnalité **Expériences** est une page Bêta conditionnelle et est masquée sauf si elle est activée pour le compte.
- Le magasin doit être publié. Un brouillon affiche un état non disponible de publication d'abord.
- L'activation d'Expériences nécessite l'accord aux **conditions d’utilisation des Expériences** liées.
- La modification des paramètres d'expérience en direct peut affecter les visiteurs de la vitrine. Vérifiez l'objectif sélectionné et le trafic avant d'enregistrer.
## Chemin d'accès
Dans un projet éligible, sélectionnez **Paramètres → Store : _nom du magasin_ → Expériences**.
## Contrôles
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| Commutateur **Activer les Expériences** | Révélez ou arrêtez la configuration Expériences du magasin. | L'activation révèle les contrôles d'objectif et de trafic ; Enregistrer soumet la configuration activée. L'arrêt d'une configuration active commence à l'arrêter. |
| **conditions d’utilisation des Expériences** | Vérifiez les conditions attachées à l'activation de la Bêta. | La section juridique s'ouvre dans un nouvel onglet. |
| **Définir votre objectif** | Dites à Runner quelle métrique l'expérience doit améliorer. | La sélection d'un objectif marque cette carte comme active. |
| Curseur/entrée **Trafic** | Choisissez la part du trafic de la vitrine allouée aux expériences. | La valeur reste dans le minimum affiché et 100 %. |
| Boutons de pourcentage rapide | Choisissez une valeur de trafic courante. | Le curseur et la valeur numérique se mettent à jour ensemble. |
| **Enregistrer** | Appliquez les paramètres d'objectif et de trafic activés. | Runner démarre l'opération de configuration et désactive les contrôles jusqu'à ce qu'elle se termine. |
Les objectifs disponibles incluent Taux de conversion, Taux d'ajout au panier, Taux de paiement initié, Taux d'engagement de bannière, Taux de clics sur bouton et Valeur moyenne de commande.
Les étapes de configuration ci-dessous s'appliquent après la publication requise du magasin. Si un sélecteur de modèle s'affiche, examinez les modèles disponibles avant d'enregistrer ; les choix dépendent de votre compte. Consultez la [publication](/fr/guides/storefront-and-publishing) si le magasin est encore un brouillon.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La boutique non publiée montre un prérequis au lieu de contrôles expérimentaux. Aucune expérience n'a été lancée ni mesurée.
## Configurer Expériences
1. Publiez le magasin, puis ouvrez **Magasin → Expériences**.
2. Lisez la description Bêta et les **conditions d’utilisation des Expériences**.
3. Activez **Activer les Expériences**.
4. Sélectionnez un objectif.
5. Choisissez une allocation de trafic au-dessus ou égale au minimum affiché.
6. Vérifiez l'objectif sélectionné et le pourcentage.
7. Sélectionnez **Enregistrer**.
8. Attendez que le statut de démarrage se termine et confirmez l'état enregistré avant de partir.
## Arrêter Expériences
1. Retournez aux paramètres d'Expériences du même magasin.
2. Désactivez **Activer les Expériences**.
3. Attendez **Arrêt de l'expérience, veuillez patienter…**.
4. Confirmez l'état désactivé après la fin de l'opération.
Ne répétez pas le basculement pendant qu'une opération est en cours.
## États et limites
- Un magasin non publié affiche que la fonctionnalité n'est actuellement pas disponible et vous demande de publier d'abord.
- **Démarrage de l'expérience, veuillez patienter…** bloque les modifications simultanées.
- **Arrêt de l'expérience, veuillez patienter…** bloque les modifications simultanées.
- L'objectif est requis avant Enregistrer.
- Le trafic est limité au minimum affiché jusqu'à 100 %.
- L'entrée de paramètres entière peut être absente pour les comptes sans la fonctionnalité.
## Dépannage
- Si Expériences est manquant, ne vous fiez pas à un lien direct copié ; la fonctionnalité n'est pas activée pour le compte.
- Si la page vous demande de publier, terminez la publication avant de configurer une expérience en direct.
- Si Enregistrer signale qu'un objectif est requis, sélectionnez une carte d'objectif et réessayez.
- Si les contrôles sont désactivés, attendez que l'opération de démarrage ou d'arrêt actuelle se termine.
- Si l'état enregistré n'est pas clair, rouvrez la page avant de basculer à nouveau.
## Guides connexes
- [Magasin général](./store-general)
- [Forfaits d'abonnement](../plans-and-billing/subscription-plans)
- [Aperçu des comptes et paramètres](/fr/guides/account-and-settings)
---
# Clés API
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/api-keys
Les clés API sont des secrets personnels pour l'accès programmatique à Runner. Créez-en une uniquement pour une application de confiance, stockez-la de manière sécurisée et révoquez-la lorsqu'elle n'est plus nécessaire.
## Ce que couvre ce guide
Vous saurez comment créer et enregistrer le secret unique, identifier les clés existantes sans les exposer et révoquer une clé avec confirmation.
## Disponibilité et conditions préalables
- **Clés API** est conditionnelle et n'apparaît que si elle est activée pour votre compte.
- La page indique **Chaque clé agit comme vous**. Les clés appartiennent à votre compte personnel et non à un seul magasin.
- Ne confondez pas ces clés avec les **clés API Analytics** en lecture seule dans [Général de l’espace de travail](/fr/guides/account-and-settings/workspace-general).
- Ne mettez jamais une clé complète dans un chat, une mémoire d'agent, une compétence, une capture d'écran, un contrôle de source ou une documentation produit.
## Chemin d'accès
Sélectionnez **Paramètres → nom de votre compte → Clés API**. Si l'entrée est absente, la fonctionnalité n'est pas disponible pour le compte actuel.
## Contrôles
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Générer une nouvelle clé** | Créez une nouvelle identifiant. | Une boîte de dialogue s'ouvre avec un champ Nom facultatif. |
| **Nom** | Identifiez l'application plus tard sans exposer le secret. | Le nom apparaît dans le tableau des clés ; vide crée une clé sans titre. |
| **Créer la clé** | Générez l'identifiant. | Runner ouvre **Clé API générée** et affiche le secret complet une seule fois. |
| Icône d'œil | Vérifiez la valeur nouvellement générée complète avant de la stocker. | La valeur unique est affichée ou masquée dans la boîte de dialogue de succès. |
| Icône de copie | Copiez la nouvelle clé avec précision. | Runner la copie dans le presse-papiers et affiche une confirmation. |
| **Je l’ai enregistrée** | Fermez la vue du secret unique. | La valeur complète est effacée de la boîte de dialogue et ne peut pas être affichée à nouveau là. |
| Tableau des clés existantes | Identifiez les clés en toute sécurité. | Runner affiche Nom, Préfixe, Créé et Dernière utilisation, pas le secret complet. |
| Icône de suppression | Révoquez une clé existante. | Une confirmation explique que la révocation ne peut pas être annulée. |
| **Révoquer** | Désactivez la clé sélectionnée. | Après succès, la clé est supprimée de la liste et ne peut plus s'authentifier. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg0z7QP9dmUDVzwn9xNJv4t2isec7IFkOaWAro)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La liste vide est l'état de départ. Aucun secret n'a été généré ou affiché dans cet exemple.
## Inspectez la boîte de dialogue avant de créer un identifiant
1. Sélectionnez **Générer une nouvelle clé**.
2. Recherchez le champ facultatif **Nom** ; une étiquette telle que `Reporting integration` permet d'identifier l'application ultérieurement.
3. Sélectionnez **Annuler** si vous explorez uniquement. Aucune clé n'est créée tant que vous n'avez pas sélectionné **Créer la clé**.
Le flux de travail ci-dessous s'applique lorsque les clés API sont disponibles et que vous êtes prêt à stocker un nouveau secret.
## Générer et stocker une clé
1. Ouvrez **nom de votre compte → Clés API**.
2. Sélectionnez **Générer une nouvelle clé**.
3. Entrez un nom descriptif, tel que l'application ou l'environnement. Ne mettez pas de secret dans le nom.
4. Sélectionnez **Créer la clé**.
5. Dans **Clé API générée**, révélez la clé uniquement si nécessaire et sélectionnez Copier.
6. Stockez-la dans un gestionnaire de secrets de confiance.
7. Confirmez la valeur stockée avant de sélectionner **Je l’ai enregistrée**.
8. Utilisez le préfixe du tableau pour identifier la clé plus tard sans exposer la valeur complète.
Runner avertit que la clé complète ne sera pas affichée à nouveau. Si vous fermez la boîte de dialogue sans l'enregistrer, révoquez cette clé et créez un remplacement plutôt que d'essayer de récupérer le secret.
## Révoquer une clé
1. Faites correspondre la clé prévue par Nom et Préfixe.
2. Sélectionnez son icône de suppression.
3. Vérifiez la confirmation **Révoquer**.
4. Sélectionnez **Révoquer** uniquement lorsque l'application dépendante est prête à arrêter de l'utiliser.
5. Confirmez **Clé API révoquée** et supprimez l'ancien secret de l'application.
La révocation est destructive et ne peut pas être annulée. Créez une nouvelle clé si l'accès est nécessaire à nouveau.
## États et limites
- **Aucune clé API pour le moment** est l'état vide normal.
- La valeur complète d'une nouvelle clé n'apparaît que dans sa boîte de dialogue de succès.
- Les lignes existantes affichent un préfixe et les dates d'utilisation, pas une clé récupérable.
- **Jamais** sous Dernière utilisation signifie que Runner n'a pas enregistré de demande pour cette clé.
- Les boutons Créer et Révoquer affichent la progression et ne doivent pas être soumis à plusieurs reprises.
## Dépannage
- Si les clés API sont manquantes, n'utilisez pas un lien direct copié ; la fonctionnalité est désactivée pour ce compte.
- Si la copie du presse-papiers échoue, révélez la nouvelle valeur et copiez-la manuellement dans un gestionnaire de secrets sécurisé, puis masquez-la à nouveau.
- Si vous avez perdu une clé complète, révoquez sa ligne et générez un remplacement.
- Si une application cesse de fonctionner après la révocation, mettez-la à jour avec une clé nouvellement créée ; l'ancienne clé ne peut pas être restaurée.
- Si la mauvaise clé a été sélectionnée, annulez la confirmation et comparez à nouveau Nom et Préfixe.
## Guides connexes
- [Sécurité et sessions](./security-and-sessions)
- [Paramètres personnels et espaces de travail](./personal-settings-and-workspaces)
- [Sécurité de la mémoire](../agent/memory)
---
# Scripts personnalisés et agent de magasin
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/custom-scripts-and-store-agent
Les scripts personnalisés modifient le comportement de la vitrine, tandis que l'agent de magasin modifie les compétences que Runner peut utiliser pour le projet actuel. Les deux sont des paramètres spécifiques au magasin et doivent être examinés avec soin supplémentaire.
## Ce que couvre ce guide
Vous pourrez ajouter et enregistrer un script, le mettre en pause sans le supprimer, et ajouter ou désactiver une compétence pour le projet actuel uniquement.
## Disponibilité et conditions préalables
- Ouvrez Paramètres depuis le projet prévu.
- Le JavaScript personnalisé peut modifier le comportement de la vitrine. Ajoutez uniquement le code que vous comprenez et en lequel vous avez confiance.
- Les actions de compétence dépendent des compétences d'espace de travail disponibles et de la possibilité de configurer une compétence système.
- La page Agent complète et la porte du plan contrôlent toujours la disponibilité plus large des compétences.
## Chemins d'accès
- Scripts : **Paramètres → Store : _nom du magasin_ → Scripts Personnalisés**
- Compétences du projet : **Paramètres → Store : _nom du magasin_ → Agent**
## Contrôles des scripts personnalisés
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Ajouter un script** | Créez une entrée de script de vitrine. | Une nouvelle ligne de script activée s'ouvre avec du code JavaScript vide. |
| Ligne de script | Développez ou réduisez son éditeur. | **Nom du script** et **Code JavaScript** deviennent visibles. |
| Icône d'œil / d'œil caché | Activez ou désactivez un script. | La ligne locale change d'état ; sélectionnez Enregistrer les modifications pour l'appliquer. |
| Icône de suppression | Supprimez un script de la liste en attente. | La ligne disparaît sans deuxième boîte de dialogue ; Enregistrer les modifications applique la suppression. |
| **Enregistrer les modifications** | Appliquez chaque modification de script en attente. | Runner enregistre la liste complète des scripts et affiche un message de succès ou d'erreur. |
Runner permet jusqu'à dix entrées de script. Le bouton Enregistrer les modifications reste désactivé lorsque rien n'a changé.
Les captures de cette page montrent l'interface en anglais.
L'éditeur vierge vous permet de consulter les champs du script avant l'installation. Aucun script de suivi n'a été enregistré dans cet exemple.
## Ajouter ou modifier un script
1. Ouvrez **Magasin → Scripts Personnalisés**.
2. Sélectionnez **Ajouter un script**.
3. Entrez un **Nom du script** clair et un **Code JavaScript** de confiance.
4. Laissez le script activé uniquement s'il doit s'exécuter sur la vitrine.
5. Vérifiez toutes les autres lignes car **Enregistrer les modifications** applique la liste entière.
6. Sélectionnez **Enregistrer les modifications** et attendez **Enregistré**.
7. Vérifiez la vitrine en toute sécurité après l'enregistrement.
Runner essaie d'empêcher une erreur de script de bloquer la page, mais cela ne rend pas le code inconnu sûr. Un script peut toujours affecter la confidentialité, les performances, le suivi et l'expérience client.
### Inspectez d'abord un brouillon de script
Pour un premier aperçu, sélectionnez **Ajouter un script**, nommez-le `Store analytics` et désactivez son contrôle visuel. Laissez le code vide et ne sélectionnez pas **Enregistrer les modifications**. Cela vous permet d'identifier l'éditeur et l'état désactivé avant d'ajouter du code provenant d'un fournisseur de confiance. Lorsque vous enregistrez un vrai script, rouvrez la liste et vérifiez à la fois son code et son état activé.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Pour les compétences du projet, choisissez **Agent** sous l'en-tête du magasin. Cette image montre son entrée ; il ne montre pas qu'une compétence est ajoutée ou désactivée.
## Contrôles de l'agent de magasin
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| Ligne de compétence active | Voyez quelle compétence est disponible dans ce projet. | La ligne affiche le nom, la description et le type Système ou Personnalisé. |
| **Désactiver** | Supprimez une compétence configurable de ce projet uniquement. | La compétence quitte la liste active de ce projet ; elle n'est pas supprimée globalement. |
| **Ajouter une compétence** | Ajoutez une compétence d'espace de travail disponible à ce projet. | La sélection d'une compétence listée l'active pour le projet actuel. |
| **Créer une compétence personnalisée…** | Créez une nouvelle capacité personnalisée. | L'éditeur de compétence s'ouvre, puis la liste du projet s'actualise après succès. |
## Configurer les compétences du projet
1. Ouvrez **Magasin → Agent**.
2. Vérifiez les compétences actuellement actives.
3. Sélectionnez **Ajouter une compétence**, puis choisissez une compétence disponible ou **Créer une compétence personnalisée…**.
4. Attendez le message de succès et confirmez que la compétence apparaît.
5. Utilisez **Désactiver** lorsqu'une compétence configurable doit cesser de s'appliquer à ce projet.
6. Ouvrez **Agent** dans la navigation du projet pour obtenir des détails complets sur les compétences, mettre en pause, modifier, importer ou supprimer des actions.
## États et limites
- Les modifications de script restent locales jusqu'à ce que **Enregistrer les modifications** réussisse.
- La suppression d'une ligne de script n'a pas de confirmation séparée avant Enregistrer les modifications.
- L'atteinte de dix scripts désactive **Ajouter un script**.
- L'agent de magasin peut afficher le chargement, une erreur, **Aucune compétence activée** ou la liste active.
- Les compétences système fixes n'affichent pas **Désactiver**.
- La désactivation dans l'agent de magasin modifie la portée de ce projet ; elle ne supprime pas ou ne met pas en pause globalement la compétence.
## Dépannage
- Si un script s'exécute toujours, confirmez que son état désactivé a été suivi par **Enregistrer les modifications**.
- Si l'enregistrement échoue, la liste précédemment enregistrée reste inchangée ; corrigez le code ou réessayez après l'erreur.
- Si **Ajouter une compétence** n'a pas l'entrée attendue, vérifiez la page Agent complète et le plan actuel.
- Si **Désactiver** est absent, la compétence système n'est pas configurable pour ce projet.
- Si une nouvelle compétence apparaît globalement mais pas ici, ajoutez-la au projet à partir de l'agent de magasin.
## Guides connexes
- [Magasin général](./store-general)
- [Compétences de l'agent](../agent/skills)
- [Créer, importer et gérer les compétences](../agent/create-import-manage-skills)
- [Sécurité des clés API](./api-keys)
---
# Supprimer, récupérer et partir
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/delete-recover-and-leave
Runner utilise différents flux de confirmation pour supprimer un magasin, supprimer un espace de travail, quitter un espace de travail et demander la suppression du compte. Vérifiez la portée exacte avant toute action destructive.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Avant d’ouvrir une action de suppression, vérifiez dans **Settings** si elle concerne l’espace de travail ou la boutique. Cette image montre uniquement la navigation ; aucune suppression ni restauration n’a été effectuée.
Les annotations sont en anglais. Sélectionnez l’image pour l’agrandir.
## Ce que couvre ce guide
Vous saurez ce que chaque action supprime, quelle confirmation elle nécessite et quand la récupération conditionnelle du magasin peut apparaître.
## Disponibilité et conditions préalables
- Vous avez besoin d'une permission pour l'élément que vous modifiez.
- Le dernier espace de travail ne peut pas être supprimé.
- La récupération Store est une fonctionnalité héritée conditionnelle. Utilisez-le uniquement si Runner expose **Supprimés récemment** et y répertorie le magasin. La navigation actuelle du magasin ne promet pas cette destination.
- Ne traitez pas la récupération conditionnelle comme une garantie lors de l'approbation de la suppression.
- Le menu avatar global actuel et les paramètres n'exposent pas la page de sécurité du compte protégée. Utilisez la suppression du compte uniquement lorsque Runner ou le support Runner vous donne une entrée approuvée.
## Chemins d'accès et carte d'action
| Action et chemin d'accès | Confirmation | Ce qui se passe après succès |
| --- | --- | --- |
| Paramètres → Store : _nom du magasin_ → **Général → Supprimer** | Tapez le nom exact du magasin, puis sélectionnez **Supprimer**. | Le magasin est supprimé. Si vous supprimez le magasin actuel, Runner ouvre un autre magasin disponible ou l'entrée du nouveau magasin. |
| Sélection multiple conditionnelle → **Supprimer la sélection** | Tapez `DELETE`, puis sélectionnez **Tout supprimer**. | Les magasins sélectionnés quittent la grille active après la réussite de l'opération. |
| Liste de magasins hérités conditionnels → **Supprimés récemment → Récupérer le projet** | Aucune confirmation destructrice ; sélectionnez Récupérer le projet. | Le magasin revient à la liste des projets actifs et ses ressources d'espace de travail recommencent à se préparer. |
| Paramètres → Espace de travail → Général → **Supprimer l'espace de travail** | Le propriétaire tape le nom exact de l'espace de travail, puis sélectionne **Supprimer**. | Runner supprime l'espace de travail et bascule vers un autre espace de travail disponible. |
| Paramètres → Espace de travail → Membres → votre ligne → **Quitter** | Vérifiez la boîte de dialogue de l'espace de travail nommé, puis sélectionnez **Quitter**. | Vous perdez l'accès à ses projets et Runner vous redirige vers un autre espace de travail disponible ou un sélecteur. |
| Suppression du compte → e-mail à support@adaptivemachines.ai | Envoyez la demande depuis l'adresse e-mail de votre compte Runner. | Le support Runner répond avec l'étape suivante. |
## Supprimer un magasin
1. Dans le magasin souhaité, ouvrez **Paramètres → Store : _nom du magasin_ → Général** et confirmez les noms de l'espace de travail et du magasin.
2. Sélectionnez **Supprimer**.
3. Lisez l'avertissement concernant les données du magasin.
4. Tapez le nom exact du magasin.
5. Sélectionnez le bouton destructif **Supprimer**.
6. Attendez le résultat de la suppression. Confirmez que Runner a ouvert un autre magasin ou l'entrée d'un nouveau magasin, puis vérifiez que le magasin supprimé n'est plus disponible.
La confirmation avertit que l'action ne peut pas être annulée. Bien que certains comptes affichent une fonctionnalité de récupération séparée, elle peut être absente ou indisponible ; ne supprimez jamais en supposant que Récupérer apparaîtra.
## Récupérer un magasin à partir d'une vue héritée lorsqu'elle est disponible
1. Continuez uniquement si votre espace de travail expose la liste de magasins héritée et son entrée **Supprimés récemment**.
2. Ouvert **Supprimés récemment** ; ne le cherchez pas dans la navigation actuelle du magasin et ne devinez pas un lien direct.
3. Faites correspondre le magasin par nom et date de suppression.
4. Sélectionnez **Récupérer le projet** une seule fois.
5. Attendez **Projet récupéré** et confirmez que le magasin revient à la liste active.
6. Ouvrez-le uniquement après que ses ressources d'espace de travail requises deviennent disponibles.
Si **Supprimés récemment** est absent, aucun chemin de récupération n'est exposé dans cette vue. Contactez l'assistance si vous avez besoin d'aide ; ce guide ne promet pas de disponibilité ni de fenêtre de récupération.
## Supprimer un espace de travail
1. En tant que propriétaire de l'espace de travail, ouvrez **Paramètres → Espace de travail → Général** pour l'espace de travail exact.
2. Sélectionnez **Supprimer l'espace de travail**.
3. Lisez l'avertissement de suppression permanente.
4. Tapez le nom exact de l'espace de travail.
5. Sélectionnez **Supprimer**.
6. Confirmez que Runner bascule vers un autre espace de travail.
Le seul espace de travail ne peut pas être supprimé. La suppression d'un espace de travail est présentée comme permanente et non récupérable.
## Quitter un espace de travail
1. Ouvrez **Paramètres → Espace de travail → Membres**.
2. Trouvez votre ligne marquée **(vous)**.
3. Sélectionnez **Quitter** si disponible.
4. Confirmez le nom de l'espace de travail et sélectionnez **Quitter** dans la boîte de dialogue.
5. Confirmez que vous êtes redirigé et que vous n'avez plus accès à ses projets.
Partir ne supprime pas l'espace de travail pour ses membres restants. La ligne Propriétaire n'offre pas cette action Partir sur la page Membres.
## Demander la suppression du compte
1. Écrivez à support@adaptivemachines.ai depuis l'adresse e-mail de votre compte Runner.
2. Demandez la suppression du compte.
3. Suivez les instructions de la réponse du support Runner.
Cette demande est plus large que la suppression d'un magasin ou d'un espace de travail. Vérifiez [Sécurité et sessions](./security-and-sessions) avant de continuer.
## Dépannage
- Un bouton final désactivé signifie que le texte de confirmation ne correspond pas exactement ou que l'action est toujours en cours.
- L'erreur de suppression A ne prouve pas que rien n'a changé. Actualisez la liste active et vérifiez l'élément avant de réessayer.
- **Récupération…** verrouille les autres boutons Récupérer jusqu'à la fin de la demande actuelle.
- Si la récupération signale une erreur, vérifiez les listes actives et récemment supprimées avant de réessayer.
- Si Leave signale une erreur, vérifiez votre accès et votre espace de travail actuels avant de réessayer.
- Si vous n'avez pas de réponse au sujet de la suppression du compte, n'envoyez pas plusieurs demandes. Répondez plutôt dans le même fil d'e-mails.
## Guides connexes
- [Magasin général](./store-general)
- [Espace de travail général](./workspace-general)
- [Membres et invitations](../workspace/members-and-invitations)
- [Sécurité et sessions](./security-and-sessions)
---
# Paramètres personnels et espaces de travail
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/personal-settings-and-workspaces
Mes paramètres modifient vos préférences Runner dans tous les projets. Utilisez le sélecteur d'espace de travail séparément lorsque vous souhaitez travailler dans une autre équipe.
## Ce que couvre ce guide
Choisissez la langue de l'interface, les e-mails de performances hebdomadaires et les sons de l'interface sans modifier les paramètres de l'espace de travail.
## Disponibilité et conditions préalables
- Vous devez être connecté.
- La vue **Mes paramètres** cochée affiche la langue, les e-mails de performances hebdomadaires et les sons de l'interface. Les contrôles de profil peuvent différer selon le compte ou la surface.
- Les actions de création d'espace de travail et d'appartenance peuvent être limitées par la permission du compte ou l'état actuel de l'espace de travail.
## Chemins d'accès
- Préférences : **Paramètres → nom de votre compte → Mes Paramètres**
- Changement d'espace de travail : suivez [navigation dans l'espace de travail](/fr/guides/workspace).
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBH6DLmxmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Sélectionnez **Mes paramètres** pour les préférences d'interface. **Clés API** ouvre la page d'identification personnelle distincte.
## Contrôles Mes paramètres
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Langue** | Modifiez la langue de l'interface de Runner. | Runner enregistre le choix et recharge la page actuelle dans cette langue. |
| **E-mails de performance hebdomadaires** | Recevez une fois par semaine le rapport de performance de votre magasin dans votre boîte de réception. | Le commutateur enregistre si Runner envoie le rapport ; il est activé par défaut. |
| **Sons de l'interface** | Entendez un léger clic lorsque vous appuyez, basculez une option ou recevez une alerte. | Le commutateur enregistre la préférence ; désactivez-le pour couper les sons. |
## Modifier la langue ou les e-mails de rapport
1. Ouvrez **Mes paramètres** sous votre nom de compte.
2. Choisissez **Langue** lorsque vous êtes prêt à recharger la page.
3. Confirmez que l'interface utilise la langue sélectionnée après le rechargement.
4. Modifiez **E-mails de performance hebdomadaires** uniquement lorsque vous souhaitez modifier la livraison des rapports de votre magasin.
5. Attendez que la préférence soit enregistrée, puis rouvrez la page pour la vérifier.
## Vérifier une préférence sans modifier votre profil
1. Ouvrez **Mes paramètres** et recherchez **Sons de l'interface**.
2. Choisissez si les clics et les alertes doivent émettre un son.
3. Attendez que le paramètre soit enregistré, puis fermez et rouvrez **Mes paramètres**.
4. Confirmez que le commutateur correspond toujours à votre choix.
Pour changer ou créer des espaces de travail, utilisez le [guide de l'espace de travail](/fr/guides/workspace). Il n’y a pas de destination publique **Espaces de travail** dans la barre latérale Paramètres actuelle. Pour quitter un espace de travail, suivez [Membres et invitations](/fr/guides/workspace/members-and-invitations).
## États et limites
- Une mise à jour de langue garde le contrôle occupé jusqu'à ce que la persistance et la navigation se terminent.
- Mes paramètres n'expose pas les contrôles de sessions, de suppression de compte ou de clé API. Consultez [Sécurité et sessions](./security-and-sessions) et [Clés API](./api-keys).
## Dépannage
- Si la langue ne change pas, attendez que la mise à jour actuelle se termine, puis sélectionnez-la à nouveau une fois.
- Si vous avez ouvert les paramètres d'un espace de travail incorrect, fermez la boîte de dialogue, changez d'espace de travail, puis rouvrez les paramètres.
- Si vous devez quitter, ouvrez plutôt la page Membres de cet espace de travail au lieu de chercher Quitter ici.
## Guides connexes
- [Membres et invitations](../workspace/members-and-invitations)
- [Général de l’espace de travail](./workspace-general)
- [Sécurité et sessions](./security-and-sessions)
- [Supprimer, récupérer et quitter](./delete-recover-and-leave)
---
# Sécurité et sessions
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/security-and-sessions
Runner n'a pas de page dans l'application qui liste vos sessions ou supprime votre compte. Vous vous déconnectez depuis le menu de l'avatar. Le support Runner traite les demandes pour fermer des sessions sur d'autres appareils et pour supprimer votre compte.
## Ce que couvre ce guide
Vous saurez comment vous déconnecter sur l'appareil que vous utilisez, et comment demander au support Runner de fermer d'autres sessions ou de supprimer votre compte.
## Disponibilité et conditions préalables
- Vous devez être connecté pour vous déconnecter.
- Envoyez vos demandes au support depuis l'adresse e-mail de votre compte Runner, pour que le support puisse confirmer que le compte vous appartient.
- La suppression du compte est définitive. Elle supprime toutes les données qui appartiennent au compte.
## Se déconnecter sur cet appareil
1. Sélectionnez votre avatar dans la navigation supérieure.
2. Sélectionnez **Se déconnecter**.
3. Vérifiez que Runner affiche la page d'accueil déconnectée.
## Fermer les sessions sur d'autres appareils
1. Déconnectez-vous sur chaque appareil auquel vous avez encore accès.
2. Si vous ne pouvez pas accéder à un appareil, ou si vous ne reconnaissez pas une connexion, écrivez à support@adaptivemachines.ai.
3. Indiquez le compte concerné et ce que vous avez vu.
## Demandez la suppression du compte
1. Écrivez à support@adaptivemachines.ai depuis l'adresse e-mail de votre compte Runner.
2. Demandez la suppression du compte.
3. Suivez les instructions de la réponse du support Runner.
Supprimer un magasin ou un espace de travail ne supprime pas votre compte. Consultez [Supprimer, récupérer et quitter](./delete-recover-and-leave) pour ces actions.
## Dépannage
- Si Runner vous affiche toujours comme connecté après **Se déconnecter**, rechargez la page.
- Si le support ne peut pas associer votre demande à un compte, renvoyez-la depuis l'adresse e-mail que vous utilisez pour vous connecter.
## Guides connexes
- [Clés API](./api-keys)
- [Paramètres personnels et espaces de travail](./personal-settings-and-workspaces)
- [Supprimer, récupérer et quitter](./delete-recover-and-leave)
---
# Magasin Général
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/store-general
Le magasin Général contrôle la vitrine actuelle plutôt que l'espace de travail entier. Utilisez-le pour renommer le magasin, mettre à jour son apparence dans le navigateur et la recherche, ou consulter sa limite de suppression.
## Ce que couvre ce guide
Vous pourrez mettre à jour les champs d'identité du magasin, enregistrer une favicon, comprendre le contrôle du filigrane limité par le plan et éviter de supprimer le mauvais magasin.
## Disponibilité et conditions préalables
- Ouvrez Paramètres depuis l'intérieur du projet prévu ; sinon le groupe Magasin n'est pas affiché.
- Les champs de recherche nécessitent le chargement des paramètres du service de boutique.
- La suppression du filigrane Runner nécessite le plan affiché à côté de ce contrôle.
- Supprimer le magasin est destructif et nécessite le nom exact du magasin.
## Chemin d'accès
Dans le projet prévu, sélectionnez **Paramètres → Store : _nom du magasin_ → Général**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Sélectionnez **Général** sous l’en-tête du magasin, et non sous l’en-tête de l’espace de travail. Ce détail de navigation n'affiche pas les champs de magasin modifiés ou enregistrés.
## Contrôles
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| Espace de travail associé, Créateur, Heure de création | Confirmez quel magasin et contexte de propriété vous consultez. | Ces détails sont en lecture seule. |
| **Nom** | Renommez le magasin dans Runner. | Une modification valide s'enregistre automatiquement. |
| **Titre de la page** | Définissez le titre affiché dans les onglets du navigateur et les résultats de recherche. | Une modification valide s'enregistre automatiquement et met à jour l'aperçu. |
| **Description** | Définissez la courte description de recherche du magasin. | Une modification valide s'enregistre automatiquement. |
| Bouton Favicon | Modifiez l'icône de l'onglet du navigateur. | Une fenêtre contextuelle s'ouvre avec les choix **Télécharger** et **Généré par IA**. |
| **Télécharger l'image** | Utilisez votre propre fichier favicon. | Runner valide le fichier et affiche un aperçu avant **Enregistrer**. |
| **Exécuter** | Générez une favicon à partir de l'invite. | Runner affiche un aperçu généré ; il n'est pas appliqué jusqu'à **Enregistrer**. |
| Commutateur Supprimer le filigrane | Contrôlez le filigrane de la vitrine Runner. | La modification est disponible uniquement sur le plan affiché à côté du contrôle. |
| **Chat acheteur** | Permettez aux acheteurs d'obtenir des réponses instantanées dans le magasin. | Le commutateur enregistre la préférence du magasin et actualise un aperçu ouvert. Il est activé par défaut. |
| **Supprimer** | Supprimez le magasin actuel. | **Supprimer le magasin** s'ouvre et nécessite le nom exact du magasin. |
## Mettez à jour l'identité du magasin
1. Ouvrez **Magasin → Général** et confirmez l'espace de travail associé et le nom du magasin.
2. Modifiez **Nom**, **Titre de la page** ou **Description**.
3. Attendez **Enregistré** après chaque champ d'enregistrement automatique.
4. Vérifiez l'aperçu de style navigateur à côté de la section favicon.
Le titre de la page et la description appliquent les limites de caractères actuelles affichées par leurs champs. Si un champ cesse d'accepter plus de texte, raccourcissez-le plutôt que de coller autour de la limite.
### Exemple : séparez le nom du magasin du titre de recherche
Pour un magasin de bougies, le Runner **Nom** peut être `Candle Studio`, tandis que le **Titre de la page** est `Candle Studio | Hand-poured candles`. Écrivez un court **Description** des produits que vous vendez réellement. Après chaque message **Enregistré**, rouvrez Général et vérifiez la valeur. Les moteurs de recherche peuvent prendre du temps à se mettre à jour et peuvent choisir un texte de résultat de recherche différent.
## Modifiez la favicon
1. Sélectionnez le bouton favicon actuel.
2. Choisissez **Télécharger** ou **Généré par IA**.
3. Pour Télécharger, sélectionnez un fichier ICO, PNG ou SVG sous la limite de taille de fichier affichée.
4. Pour Généré par IA, entrez une invite optionnelle et sélectionnez **Exécuter**.
5. Consultez l'aperçu.
6. Sélectionnez **Enregistrer** pour l'appliquer. Fermer la fenêtre contextuelle abandonne un aperçu non enregistré.
## États et limites
- Les champs d'enregistrement automatique affichent les commentaires d'enregistrement, de succès ou d'erreur.
- Le téléchargement de favicon rejette les formats non pris en charge et les fichiers surdimensionnés.
- **Génération…** et **Importation…** sont des états de progression ; attendez un aperçu.
- Le contrôle du filigrane peut afficher un badge de plan et bloquer la modification.
- Supprimer le magasin reste indisponible jusqu'à ce que le projet et son nom soient chargés.
## Zone de danger
La sélection de **Supprimer** ouvre une confirmation qui avertit que toutes les données du magasin seront perdues. Le bouton final reste désactivé jusqu'à ce que vous tapiez le nom exact du magasin. Certains comptes exposent séparément la récupération conditionnelle, mais vous ne devez pas compter sur la récupération lorsque vous décidez de supprimer.
## Dépannage
- Si le groupe Magasin est absent, rouvrez Paramètres depuis l'intérieur du projet.
- Si un titre ou une description revient, corrigez son problème de validation et attendez Enregistré.
- Si le téléchargement de favicon échoue, vérifiez le type et la taille, puis choisissez le fichier à nouveau.
- Si la création de favicon générée par IA échoue, révisez l'invite et réessayez uniquement après la fin de la tentative précédente.
- Si Supprimer le filigrane est bloqué, utilisez le badge de plan pour consulter la disponibilité.
## Guides connexes
- [Connectez un domaine personnalisé](../storefront-and-publishing/custom-domains)
- [Scripts personnalisés et agent de magasin](./custom-scripts-and-store-agent)
- [Supprimer, récupérer et quitter](./delete-recover-and-leave)
---
# Général de l’espace de travail
Source: https://www.runnerai.com/docs/fr/guides/account-and-settings/workspace-general
Général de l’espace de travail contrôle l'identité partagée d'un espace de travail Runner. Utilisez-le lorsque le nom ou la description de l'équipe change, ou lorsque vous devez consulter la zone de danger de l'espace de travail.
## Ce que couvre ce guide
Vous pourrez mettre à jour les détails de l'espace de travail et reconnaître quand une modification a été enregistrée avec succès.
## Disponibilité et conditions préalables
- Un administrateur ou propriétaire d'espace de travail est requis pour modifier le nom ou la description partagés.
- Seul le propriétaire de l'espace de travail peut terminer la suppression de l'espace de travail.
- Runner ne permet pas la suppression du dernier espace de travail restant.
## Chemin d'accès
Ouvrez **Paramètres**, confirmez **Espace de travail : _nom de l’espace de travail_** dans la barre latérale, puis sélectionnez la page **Général** de ce groupe.
## Contrôles
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Nom** | Définissez le nom complet de l'espace de travail visible par les autres membres. | Une modification valide s'enregistre automatiquement après édition. |
| **Description** | Expliquez à quoi sert l'espace de travail ou l'équipe. | Une modification valide s'enregistre automatiquement. |
| **Supprimer l'espace de travail** | Supprimez un espace de travail dont vous n'avez plus besoin. | Une fenêtre contextuelle de confirmation du nom s'ouvre. Le bouton est désactivé pour le dernier espace de travail. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTBoRI6D7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Cet exemple d'espace de travail ne comporte aucune clé d'analyse répertoriée. La modification de l'identité de l'espace de travail et la création d'informations d'identification analytiques sont des actions distinctes.
## Mettez à jour les détails de l'espace de travail
1. Ouvrez **Paramètres → Espace de travail → Général**.
2. Modifiez **Nom** ou **Description**.
3. Quittez le champ et regardez le statut.
4. Attendez **Enregistré** avant de fermer Paramètres ou de changer d'espace de travail.
5. Rouvrez la page si vous devez vérifier la valeur persistante.
**Point de contrôle :** fermez les paramètres, rouvrez Général pour le même espace de travail et confirmez le nom ou la description enregistré. Un champ modifié affichant toujours **Enregistrement…** n'est pas ce point de contrôle.
## États et limites
- Le nom ne peut pas être vide et doit rester dans les limites de validation affichées.
- La description accepte un court résumé de l'espace de travail et a une limite de caractères affichée.
- **Enregistrement…** signifie que la modification est toujours en cours.
- **Enregistré** confirme que la valeur actuelle a été acceptée.
- Une erreur d'enregistrement restaure ou conserve la valeur enregistrée précédente.
- **Supprimer l'espace de travail** est désactivé lorsque c'est votre dernier espace de travail.
## Les clés API Analytics constituent une portée distincte
Général de l’espace de travail peut inclure des **clés API Analytics** pour les outils de reporting externes avec accès aux analyses en lecture seule. Celles-ci sont différentes des [clés API personnelles](/fr/guides/account-and-settings/api-keys), qui agissent avec les droits de votre compte connecté. Vérifiez la portée avant de créer ou de partager des informations d'identification. Une liste de clés d'analyse vide signifie qu'aucune clé n'est répertoriée ici ; ce n'est pas la liste de clés personnelles.
## Limite de suppression
La sélection de **Supprimer l'espace de travail** ne supprime pas immédiatement. Runner demande à un propriétaire de taper le nom exact de l'espace de travail, puis active le bouton destructif **Supprimer**. La suppression ne peut pas être restaurée à partir de cet écran et supprime les données et paramètres de l'espace de travail.
## Dépannage
- Si un nom vide revient à sa valeur antérieure, entrez un nom valide non vide.
- Si **Enregistré** n'apparaît jamais, gardez la boîte de dialogue ouverte, vérifiez l'erreur et réessayez.
- Si Supprimer l'espace de travail est désactivé, c'est probablement le dernier espace de travail ou l'espace de travail n'a pas chargé.
- Si vous avez ouvert les paramètres du mauvais espace de travail, fermez la boîte de dialogue et rouvrez-la à partir de l'espace de travail prévu.
## Guides connexes
- [Membres et invitations](../workspace/members-and-invitations)
- [Paramètres personnels et espaces de travail](./personal-settings-and-workspaces)
- [Supprimer, récupérer et quitter](./delete-recover-and-leave)
---
# Fonctionnalités avancées
Source: https://www.runnerai.com/docs/fr/guides/advanced
Runner inclut des moyens avancés de rechercher des clients, de planifier le travail, de créer des flux de travail réutilisables et de recevoir des événements. Ces pages sont intentionnellement séparées du parcours de magasin principal car la disponibilité et les points d'entrée peuvent différer selon l'espace de travail.
> **Disponibilité :** **Recherche** peut apparaître sous **Mesurer**, **Fly** dans la navigation principale et **Webhooks** sous **Créer**. **Workflow** reste conditionnel : utilisez-le uniquement lorsque Runner affiche une entrée pour votre espace de travail ou que le support Runner en fournit une. Ne devinez pas et ne modifiez pas une URL pour accéder à une page cachée. Si une entrée attendue est manquante, voir [Disponibilité des fonctionnalités](/fr/guides/advanced/feature-availability).
| Fonctionnalité | Utilisez-la pour | Guide |
| --- | --- | --- |
| Recherche | Transformer une question commerciale en étude structurée et rapport. | [Recherche](/fr/guides/advanced/research) |
| Fly | Définir une mission et suivre un espace de travail de planification commerciale guidée. | [Fly](/fr/guides/advanced/fly) |
| Flux de travail | Afficher et exécuter des flux multi-étapes réutilisables quand Runner fournit une entrée. | [Flux de travail](/fr/guides/advanced/workflows) |
| Webhooks | Configurer les livraisons d'événements prises en charge quand Runner fournit une entrée. | [Webhooks](/fr/guides/advanced/webhooks) |
Pour les outils regroupés sous **Développer** et **Mesurer**, voir [Automatiser, tester et créer](/fr/guides/automate-test-and-create).
---
# Disponibilité des fonctionnalités
Source: https://www.runnerai.com/docs/fr/guides/advanced/feature-availability
Runner peut afficher différentes fonctionnalités selon l'espace de travail, le rôle, le plan, le type de magasin, l'état de publication, les services connectés, les données et l'accès aux versions progressives.
**Chemin d'accès :** Documentation Runner → **Fonctionnalités avancées** → **Disponibilité des fonctionnalités**.
## Restrictions de disponibilité courantes
| Ce que vous voyez | Exigence probable | Que faire |
| --- | --- | --- |
| L'entrée est manquante | La fonctionnalité est en version progressive, désactivée ou non disponible pour cet espace de travail. | Vérifiez l'espace de travail et demandez à un propriétaire ou au support. N'utilisez pas une URL devinée. |
| Message de mise à niveau | Le plan actuel n'inclut pas l'action ou sa limite a été atteinte. | Ouvrez **Plan et Facturation** et consultez l'offre actuelle affichée à l'écran. |
| Exigence de publication | L'outil a besoin d'un magasin en direct ou de données de site publiées. | Complétez la liste de contrôle de publication, puis revenez après une publication réussie. |
| Bouton Connecter | Un fournisseur ou un compte doit d'abord être connecté. | Ouvrez l'application nommée et complétez son flux de connexion officiel. |
| Tableau de bord vide | La fonctionnalité est disponible mais n'a pas de données pour le magasin, le filtre ou la période sélectionnés. | Confirmez le magasin, la plage de dates, la publication et la collecte d'événements. |
| Message de permission | Votre rôle dans l'espace de travail ne peut pas effectuer l'action. | Demandez à un propriétaire de la compléter ou de modifier l'accès. |
| Page non trouvée | L'itinéraire est indisponible, retiré ou non valide pour ce contexte. | Revenez par la navigation visible et contactez le support si l'entrée elle-même est cassée. |
## Vérifier dans l'ordre
1. Confirmez l'espace de travail et le magasin sélectionnés.
2. Développez **Créer**, **Développer** et **Mesurer** dans la navigation du projet avant de décider qu'une entrée est manquante. Sur mobile, ouvrez d’abord le menu du projet.
3. Vérifiez si la page nomme un prérequis.
4. Vérifiez votre rôle et le plan actuel dans les paramètres de l'espace de travail.
5. Confirmez la publication, les données ou la connexion d'application requises.
6. Rechargez une fois après un changement d'accès ou de connexion récent.
7. Contactez le support avec la page exacte, l'état visible, l'espace de travail et le nom du magasin.
### What not to assume
- Une entrée masquée ne prouve pas que la fonctionnalité a été supprimée de tous les comptes.
- Une page vide ne prouve pas que la collecte est cassée.
- Un itinéraire source ne prouve pas que votre espace de travail peut utiliser la fonctionnalité.
- Une connexion réussie ne prouve pas le paiement, l'exécution ou la création de rapports de bout en bout sans un résultat de bout en bout.
## Lorsque la page n'est qu'un aperçu
Un aperçu des fonctionnalités peut afficher des exemples de cartes tandis qu'un avis de mise à niveau bloque les actions réelles. Lisez cet avis avant d'interpréter les cartes comme les données de votre magasin. Pour le dictionnaire d'état complet, voir [États et disponibilité](../help-and-reference/states-and-availability).
## Guides connexes
- [États et disponibilité](../help-and-reference/states-and-availability)
- [Forfaits d'abonnement](../plans-and-billing/subscription-plans)
- [Dépannage de la publication, du paiement et des applications](../help-and-reference/troubleshoot-publishing-checkout-apps)
- [Support et communauté](../help-and-reference/support-and-community)
---
# Fly
Source: https://www.runnerai.com/docs/fr/guides/advanced/fly
Fly est un espace de travail guidé pour transformer un objectif de magasin en mission, examiner le travail proposé et suivre la progression depuis un seul tableau de bord.
## Chemin d'accès
Ouvrez un projet de magasin et sélectionnez **Fly** quand il est disponible. Si l'entrée est manquante, consultez [Disponibilité des fonctionnalités](./feature-availability).
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOvxtCXuJCcW62zHrU8smjSnqvixd1twlAf4u)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Passez en revue la première mission et ses étapes de lancement avant de choisir Démarrer cette mission. Cette vue est une configuration, pas une mission active.
## Avant de commencer
- Fly doit être activé pour le projet actuel.
- Examinez le magasin, la mission et les tâches de proposition affectées avant d'approuver le travail.
- Les actions de proposition, d'abandon et de mission suivante peuvent modifier le travail réel du projet ; utilisez le texte de confirmation comme autorité finale.
## Démarrer la première mission
Les projets sans mission ouvrent l'intégration automatiquement.
1. Ouvrez **Fly** et lisez l'objectif du magasin proposé.
2. Si un tableau de bord affiche déjà une mission, examinez cette mission au lieu d'en démarrer une autre.
3. Examinez la mission suggérée et ses étapes. L'introduction du **Obtenez votre première commande payée** présente cinq étapes et une action **Démarrer cette mission**. Sélectionnez-le uniquement lorsque vous avez l'intention de commencer cette mission ; sinon, fermez l'intégration.
4. Confirmez que le tableau de bord affiche la mission prévue avant d'examiner les propositions.
**Point de contrôle :** L'ouverture de l'intégration affiche uniquement la proposition de mission. La mission existe après que vous l'ayez confirmée et le tableau de bord l'affiche.
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Démarrer votre première mission** | Rouvre l'intégration quand le projet n'a toujours pas de mission. |
| **Démarrer cette mission** | Commence la mission décrite par l'introduction. Vérifiez sa cible et ses étapes avant de confirmer. |
| **Définissez cette mission**, lorsqu'elle est affichée dans la configuration de la mission | Crée la mission proposée pour le projet en cours et ouvre le tableau de bord Fly. Vérifiez le magasin et l'objectif avant de confirmer. |
Clôturer l'intégration sans confirmer la mission laisse le projet sans nouvelle mission. Vous pouvez revenir avec **Commencez votre première mission**.
Après l'intégration, **Obtenir votre première proposition** peut ouvrir une liste de contrôle de lancement en lecture seule. Quand **Afficher les détails** apparaît sur **Créer la vitrine**, il ouvre la première conversation Runner du projet. Le bouton est absent quand aucune première conversation n'est enregistrée.
## Lire le tableau de bord
Le tableau de bord réunit la mission actuelle et l'activité du magasin. Sur les petits écrans, les mêmes sections sont empilées verticalement.
| Section | Ce qu'elle affiche |
| --- | --- |
| Progression de la mission | L'objectif actif et la progression vers celui-ci. |
| Commandes, Revenus et Sessions | Les signaux de magasin principaux d'aujourd'hui. Ce sont des résumés en lecture seule. |
| **Flux** | Signaux récents et observations actuelles de Fly. Sélectionnez une histoire pour ouvrir son lecteur. |
| **Travail en cours** | Propositions approuvées qui s'exécutent ou attendent votre action. Sélectionnez une carte pour ouvrir ses détails de proposition. |
| **Travail passé** | Propositions complétées ou échouées. Sélectionnez une carte pour l'examiner ; **Afficher plus** charge les entrées plus anciennes. |
| **Vos tâches** | Tâches qui nécessitent votre attention. **Précédent** et **Suivant** parcourent plus d'une page d'éléments. |
| Aperçu du magasin | Affiche l'état de publication actuel quand disponible. Sélectionnez-le pour ouvrir **Magasin**. |
| **Ouvrir le chat** | Ouvre le chat Fly pour que vous puissiez poser des questions sur la mission ou le travail visible. **Fermer le chat** le ferme. |
| **Tout est à jour** | Apparaît quand aucune tâche ou proposition ne nécessite une décision. Cela confirme que Fly surveille toujours le magasin ; cela ne signifie pas que chaque tâche en cours est terminée. |
| **Explorer Runner** | Quand la file d'attente est vide, propose **Ouvrir le Studio Créatif** quand activé, **Parcourir les compétences** et **Explorer les automatisations**. Chaque bouton ouvre cet outil de projet sans démarrer le travail par lui-même. |
Une section **Travail en cours** ou **Travail passé** vide peut être masquée. Cela signifie qu'il n'y a rien dans cet état, pas que l'historique du projet a été effacé.
Dans le chat Fly, **Nouvelle conversation** démarre un nouveau fil, tandis que l'historique rouvre un fil antérieur. Le premier message crée la conversation. Si l'envoi échoue, le brouillon reste dans le compositeur pour que vous puissiez réessayer sans le réécrire.
### Lire une histoire Fly
Le lecteur d'histoire affiche **élément actuel sur total** dans son en-tête. Utilisez les flèches précédente et suivante pour vous déplacer entre les éléments, ou fermez le lecteur pour revenir au tableau de bord. Quand une histoire inclut une puce de source liée, la sélectionner ouvre cette source exacte dans un nouvel onglet du navigateur. Si l'histoire ne peut pas se charger, sélectionnez **Réessayer** sans quitter Fly. Les cartes d'actualités du marché peuvent disparaître après qu'elles ne soient plus récentes.
## Examiner une proposition
Ouvrez une proposition depuis le tableau de bord avant de permettre au travail de commencer. Une proposition peut contenir plusieurs tâches ; la sélection d'une tâche peut également inclure les conditions préalables dont elle dépend.
| Contrôle ou état | Ce qui se passe ensuite |
| --- | --- |
| Sélection de tâche | Choisit les tâches à approuver. Les tâches de condition préalable requises sont incluses pour que le travail sélectionné puisse s'exécuter dans l'ordre. |
| **Approuver et exécuter** | Approuve les tâches sélectionnées et démarre l'exécution. Elle n'est pas disponible quand aucune tâche n'est sélectionnée. Les actions connectées peuvent avoir des effets réels. |
| **Rejeter** | Ouvre une confirmation. La confirmation ferme la proposition et n'exécute aucune de ses tâches ; cela ne peut pas être annulé. |
| **Abandonner** | Ouvre **Abandonner cette proposition ?** pendant que le travail s'exécute. **Confirmer l'abandon** arrête les tâches inachevées ; le travail complété est conservé. **Continuer** ferme la confirmation. |
| **Aperçu** | Ouvre le résultat du flux de travail complété quand un aperçu est disponible. |
| **Afficher les détails** | Sur une tâche de première proposition prise en charge, ouvre la conversation Runner associée pour que vous puissiez examiner le contexte du travail. |
| En attente de votre action | L'exécution est suspendue jusqu'à ce que vous complétiez l'action manuelle demandée et sélectionniez **Résoudre**. |
| **Utile** / **Pas utile** | **Utile** est enregistré immédiatement. **Pas utile** ouvre des motifs et des détails modifiables ; la fermeture conserve l'avis existant et les modifications ne sont enregistrées qu'après **Envoyer**. |
Certaines pages de proposition au stade de l'examen affichent également un panneau de chat de proposition. Utilisez-le pour poser des questions sur cette proposition ; il ne remplace pas **Approuver et exécuter**, **Rejeter**, **Abandonner** ou **Résoudre** quand l'action applicable est affichée.
La section **Résultats** reste masquée pendant qu'une proposition est en examen, en cours d'exécution ou en cours de vérification. Elle peut n'apparaître qu'après la réussite ou l'échec quand les données de résultat sont prêtes. Une section Résultats manquante pendant le travail actif n'est pas une preuve que la proposition a échoué.
Pour les résultats de documents et de médias, **Télécharger** enregistre le livrable disponible, **Restaurer les médias** tente de récupérer les médias indisponibles et **Continuer dans le chat** ouvre des instructions de suivi modifiables. Ces actions ne changent pas l'état d'acceptation ou d'examen de la proposition.
Quand une proposition inclut la génération de vidéo Fly, la tâche actuelle produit une vidéo de 6 secondes en 720p avec audio. Demander une autre durée dans l'invite de tâche ne change pas cette longueur de sortie.
## Résoudre une tâche appartenant à l'utilisateur
Quand une tâche marquée **Votre tâche** s'interrompt pour une action que seul vous pouvez compléter, lisez ses instructions, complétez l'action en dehors de la carte, puis sélectionnez **Résoudre**.
**Résoudre** est votre confirmation que vous avez complété l'action demandée ; Runner ne vérifie pas indépendamment ce résultat externe. Pendant que Runner vérifie l'état, la carte affiche **Chargement de l'action de tâche**. Pendant qu'il soumet, le bouton affiche **Résolution en cours…**. **Cette tâche n'attend plus votre action.** signifie qu'elle ne peut pas être résolue depuis la carte actuelle. Si vous voyez **Impossible de résoudre cette tâche. Veuillez réessayer.**, vérifiez la connexion et réessayez une fois de plus. Ne marquez pas une tâche comme résolue avant que l'action demandée soit réellement complète.
## Résoudre les tâches
Sélectionnez **Résoudre** uniquement sur une tâche en un clic admissible. Runner enregistre alors votre confirmation depuis le tableau de bord. Les tâches plus détaillées, y compris les tâches avec des sorties de fichiers, restent en lecture seule dans la liste des tâches ; ouvrez la proposition associée pour examiner leurs instructions et l'état actuel.
Si la résolution échoue, gardez la tâche ouverte et réessayez une fois après avoir vérifié la connexion. Ne supposez pas que la tâche est complétée jusqu'à ce que son statut change.
## Suivre le travail en cours et passé
1. Ouvrez une carte dans **Travail en cours** pour voir ses états de proposition et de tâche actuels.
2. Si elle dit **En attente de votre action**, complétez l'action manuelle demandée et sélectionnez **Résoudre** au lieu d'approuver la proposition à nouveau.
3. Utilisez Abandonner uniquement quand le travail inachevé doit s'arrêter. Le travail déjà complété n'est pas annulé.
4. Ouvrez **Travail passé** pour examiner les résultats et les propositions échouées.
5. Pour un échec, conservez le titre de la proposition et l'erreur de tâche visible avant de demander de l'aide.
## Compléter une mission et choisir la suivante
Quand Runner reconnaît qu'une mission est réalisée, **Mission complétée** ouvre un flux guidé. Si vous le fermez avant de choisir un autre objectif, **Choisir votre mission suivante** peut rouvrir le flux.
1. Sélectionnez **Examiner le parcours** pour voir le récapitulatif de la mission, les moments importants et le travail que Fly a complété avec vous.
2. Sélectionnez **Voir ce qui vient ensuite** pour examiner la mission suivante suggérée.
3. Ajustez la cible avec le préréglage disponible ou les contrôles d'augmentation/diminution, puis sélectionnez **Continuer**.
4. Lisez attentivement le résumé du déploiement.
5. Sélectionnez **Commencer la mission** uniquement quand la nouvelle cible est correcte.
6. Quand la mission suivante est en direct, sélectionnez **Aller au contrôle de mission** pour revenir au tableau de bord.
**Commencer la mission** a des effets réels sur le projet : les tâches déjà en cours continuent, la génération de proposition reprend par rapport au nouvel objectif, et les propositions sur lesquelles vous n'avez pas agi sont fermées pour que Fly puisse les régénérer pour la nouvelle cible. La progression actuelle est conservée.
## Dépannage
| État | Étape suivante |
| --- | --- |
| L'intégration s'ouvre automatiquement | Définissez la mission ou fermez l'intégration et revenez plus tard. |
| Le tableau de bord apparaît | Une mission existe ; utilisez le tableau de bord plutôt que de créer un doublon. |
| **En attente de votre action** | Ouvrez la proposition, complétez l'action manuelle spécifique, puis sélectionnez **Résoudre**. |
| Conflit d'abandon ou statut modifié ailleurs | Actualisez la proposition et utilisez son état actuel. |
| L'aperçu complété ne se charge pas | Sélectionnez **Réessayer** dans l'aperçu du flux de travail, ou rouvrez la proposition complétée pour le dernier résultat. |
| La proposition a échoué | Ouvrez-la depuis **Travail passé** et conservez l'erreur de tâche visible. |
| La vérification finale ne peut pas récupérer | La proposition se règle comme échouée au lieu de rester dans le travail en cours. Ouvrez-la depuis **Travail passé** et conservez l'erreur visible avant de réessayer. |
| La mission suivante ne peut pas démarrer | Réessayez une fois de plus. Si une autre session l'a déjà démarrée, le tableau de bord s'actualise à la mission en direct. |
| Entrée manquante ou page non trouvée | Fly n'est pas disponible dans ce contexte. Consultez [Disponibilité des fonctionnalités](./feature-availability). |
## Guides connexes
- [Disponibilité des fonctionnalités](./feature-availability)
- [États et détails des tâches](../work-with-runner/task-states-and-details)
- [Dépanner les tâches Runner](../help-and-reference/troubleshoot-runner-tasks)
---
# Recherche
Source: https://www.runnerai.com/docs/fr/guides/advanced/research
La recherche offre un lieu limité au projet pour enquêter sur les besoins des acheteurs, les concepts, le positionnement et d'autres décisions commerciales.
## Chemin d'accès
Ouvrez un projet de magasin, développez **Mesurer** et sélectionnez **Recherche** lorsque la fonctionnalité est disponible. Sur mobile, ouvrez d’abord le menu du projet. Si **Recherche** est absent, cet espace de travail n'expose pas actuellement la fonctionnalité ; voir [Disponibilité des fonctionnalités](./feature-availability).
## Avant de commencer
- La recherche doit être activée pour le projet actuel.
- Préparez une question commerciale avec au moins cinq caractères et supprimez les données client inutiles.
- L'exploration en direct, les panneaux et les rapports peuvent utiliser des données externes ou des crédits ; examinez chaque action disponible avant de la démarrer.
## Démarrer ou rouvrir une étude
La page d'accueil de la recherche a deux modes : **Nouvelle étude** et **Panneaux enregistrés**.
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Nouvelle étude** | Ouvre le formulaire de question et les études récentes du projet. |
| Champ de questions | Accepte la décision commerciale sur laquelle vous souhaitez enquêter. **Démarrer l'étude** reste indisponible jusqu'à ce que la question soit valide. |
| Carte de scénario | Place une direction de recherche suggérée dans le champ de question pour que vous puissiez la modifier. |
| **Commencer l'étude** | Crée une étude en direct à partir de la question actuelle et ouvre son espace de travail guidé. |
| **Voir d'abord un exemple terminé** | Ouvre un exemple d’aperçu en lecture seule. Cela ne crée pas d’étude en direct et les actions qui nécessitent une étude en direct peuvent ne pas être disponibles. |
| Carte d'étude récente | Rouvre l'étude existante de ce projet. |
| **Panneaux enregistrés** | Ouvre les panneaux enregistrés pour réutilisation. |
| **Lancement de l'étude** | Sélectionne ce panneau enregistré et revient à **Nouvelle étude**. Saisissez une nouvelle question de recherche, puis sélectionnez **Démarrer l'étude** pour créer l'étude. |
| **Charger plus** | Charge des études ou des panneaux enregistrés supplémentaires. |
| **Réessayer** | Demande la bibliothèque actuelle ou l'étape échouée à nouveau. |
Utilisez une décision unique et ciblée comme question. Une question telle que « Quelle affirmation de produit devrions-nous mettre en avant pour les nouveaux acheteurs ? » donne à l'étude un travail plus clair qu'un sujet large tel que « marketing ».
## Parcourir les étapes guidées
Le côté gauche d'une étude pose des questions et offre des choix. Sélectionnez les choix pertinents, ajoutez une réponse personnalisée si nécessaire, puis utilisez l'action principale pour l'étape actuelle.
| Action | Ce que Runner démarre |
| --- | --- |
| **Créer un plan de recherche** | Transforme votre question et vos réponses en plan d'étude. |
| **Modifier les entrées** | Rouvre les entrées de planification avant que l'exploration ne commence. |
| **Recréer le plan de recherche** | Remplace le plan actuel par un nouveau plan basé sur les entrées modifiées. |
| **Commencer l'exploration [source]** (par exemple, **Commencer l'exploration X**) | Démarre l'exploration sur la source nommée par le plan approuvé. |
| **Créer le panneau de validation** | Crée le panneau d'audience utilisé pour contester et valider les résultats. |
| **Commencer la discussion de panneau** | Commence la conversation du panneau. |
| **Générer un résumé, des minutes et un rapport** | Produit les artefacts écrits finaux à partir de la discussion complétée. |
| **Réessayer** suivi d'un nom d'étape | Répète l'étape échouée. Examinez d'abord l'échec pour ne pas répéter aveuglément la même entrée. |
L'action principale exacte change à mesure que chaque étape devient prête. Ne sélectionnez pas une action d'étape ultérieure jusqu'à ce que vous soyez satisfait du plan, des résultats ou du panneau actuel.
## Examiner les artefacts d'étude
Sur le bureau, le chat guidé et le canevas d'artefact sont côte à côte et peuvent être redimensionnés. Sur mobile, utilisez **Chat d'étude** et **Artefacts** pour basculer entre eux.
| Onglet d'artefact | Ce qu'il contient |
| --- | --- |
| **Vue d’ensemble** | La chronologie de l'étude et les étapes qui sont prêtes ou en attente. La sélection d'un élément prêt ouvre son artefact. |
| **Plan** | L'approche de recherche approuvée. Il reste vide jusqu'à ce que la planification soit terminée. |
| **[Source] Exploration** (par exemple, **Exploration X**) | La progression de l'exploration et les sources pour la source actuelle de l'étude. |
| **Résultats** | Les thèmes et les preuves produits après l'exploration. |
| **Panneau** | L'audience de validation construite à partir des résultats. |
| **Discussion** | La conversation du panneau et les réponses de suivi. |
| **Rapport** | L'espace de travail du rapport final après la fin de la discussion. |
Un onglet en attente n'est pas une erreur : son état vide explique quelle étape antérieure doit d'abord être terminée. La chronologie Aperçu marque également les étapes indisponibles comme en attente.
## Enregistrer un panneau utile
Ouvrez **Panneau** et sélectionnez **Enregistrer le panneau** quand son audience est utile pour les études futures. Entrez le nom du panneau et la description optionnelle dans le formulaire d'enregistrement, puis confirmez. Runner rapporte **Panneau enregistré pour les études futures**, et le panneau apparaît sous **Panneaux enregistrés**.
L'enregistrement préserve le panneau pour réutilisation ; il ne démarre pas une autre étude. Dans un aperçu d'exemple, l'enregistrement est indisponible car l'exemple n'est pas des données de projet en direct.
## Lire et partager le rapport
L'espace de travail du rapport final sépare trois vues :
- **Rapport** présente le résultat de recherche complet.
- **Résumé** donne la version plus courte axée sur la décision.
- **Minutes** enregistre la discussion du panneau.
Sélectionnez **Partager** pour partager le lien d'étude actuel avec le panneau de partage de l'appareil quand pris en charge. Si le partage natif est indisponible, Runner copie le lien et affiche **Lien d'étude copié**. Le partage envoie un lien, pas un rapport statique téléchargé ; le destinataire a toujours besoin d'un accès approprié.
## Continuer la discussion du panneau
Pendant l'étape Discussion, utilisez le compositeur de suivi pour demander une réponse plus claire ou tester un angle différent.
| Contrôle | Résultat |
| --- | --- |
| **Contester un résultat** | Remplit le compositeur avec une invite de défi que vous pouvez modifier. |
| **Poser une question au panneau** | Remplit le compositeur avec une question directe au panneau. |
| **Changer l'audience** | Remplit le compositeur avec une demande de considérer une audience différente. |
| **Envoyer un suivi** | Envoie le message actuel dans la discussion du panneau en direct. |
Les puces de suggestion préparent le texte ; elles n'envoient rien jusqu'à ce que vous sélectionniez **Envoyer un suivi**. Si le compositeur dépasse sa limite ou l'étude n'est pas prête, l'action d'envoi reste indisponible.
## Dépannage
| État | Signification et étape suivante |
| --- | --- |
| Exemple | Une démonstration complétée, pas une recherche de projet en direct. Revenez à **Nouvelle étude** pour créer la vôtre. |
| Artefact en attente | Une étape antérieure n'a pas été terminée. Revenez à Aperçu ou Chat d'étude et continuez l'étape disponible. |
| L'étape s'exécute | Runner prépare l'artefact suivant. Vous pouvez revenir par les études récentes plus tard. |
| Échec réessayable | Lisez l'erreur visible, puis utilisez le **Réessayer** spécifique à l'étape une fois. |
| La récupération est bloquée | Sélectionnez **Actualiser l'étude** pour charger l'état du serveur actuel avant de continuer. |
| Le suivi échoue | Conservez le message, utilisez Réessayer quand proposé, ou actualisez l'étude avant de renvoyer. |
| La bibliothèque d'étude ou de panneau échoue | Sélectionnez **Réessayer**. Préservez la question et l'erreur visible si elle se répète. |
| Historique d'étude vide | Ce projet n'a pas encore d'étude. Commencez par une question ciblée sur la décision. |
## Chemin recommandé
1. Ouvrez **Nouvelle étude** et entrez une question ciblée sur la décision.
2. Sélectionnez **Commencer l'étude** et répondez aux choix guidés.
3. Examinez le Plan ; utilisez **Modifier les entrées** avant l'exploration si la portée est incorrecte.
4. Parcourez Scout, Résultats, Panneau et Discussion, en examinant chaque artefact prêt.
5. Enregistrez le panneau uniquement quand son audience sera utile à nouveau.
6. Générez et lisez le Rapport, le Résumé et les Minutes.
7. Partagez le lien d'étude uniquement avec les personnes qui doivent y avoir accès.
8. Utilisez les suivis pour les lacunes spécifiques au lieu de démarrer une étude en doublon.
## Essayer l'exemple avant une étude réelle
1. Ouvrir **Mesurer** → **Recherche** → **Nouvelle étude**.
2. Sélectionnez **Voir d'abord un exemple terminé**.
3. Lisez l'exemple de plan et de rapport à l'aide des onglets d'artefact disponibles.
4. Revenez à **Nouvelle étude** et rédigez une décision sur laquelle vous souhaitez enquêter.
5. Sélectionnez **Démarrer l'étude** uniquement lorsque vous êtes prêt à créer une étude en direct.
**Point de contrôle :** L'exemple vous permet d'inspecter le format de sortie sans créer d'étude. Pour votre propre étude, confirmez que votre question apparaît dans son espace de travail ; Les actions de repérage et de rapport ultérieures ont leurs propres progrès et résultats.
## Guides connexes
- [Disponibilité des fonctionnalités](./feature-availability)
- [Expériences](../automate-test-and-create/experiments)
- [Aperçu de l'analyse](../analytics-and-seo/analytics-overview)
- [Support et communauté](../help-and-reference/support-and-community)
---
# Webhooks
Source: https://www.runnerai.com/docs/fr/guides/advanced/webhooks
Les webhooks permettent à un autre service de recevoir les événements sélectionnés d'un projet Runner. C'est une fonctionnalité avancée et sensible à la sécurité : utilisez-la uniquement quand vous savez quel service doit recevoir les événements et comment ce service les vérifie.
## Chemin d'accès
Ouvrez **Créer** → **Webhooks** lorsque Runner rend l'entrée disponible dans votre espace de travail. S'il n'y a aucune entrée, ne devinez pas une URL ; consultez [Disponibilité de la fonctionnalité](./feature-availability) ou demandez à l'assistance si la fonctionnalité est activée.
## Avant de commencer
- Utilisez Webhooks uniquement quand Runner ou le support expose une entrée approuvée.
- Connaissez le service destinataire prévu et comment il vérifie les événements.
- Traitez les adresses de point de terminaison, les secrets de signature et les données livrées comme sensibles.
## Ce que Runner affiche
Votre espace de travail peut afficher l'atelier de webhook de Runner ou un portail de fournisseur intégré. Suivez la section qui correspond à votre écran.
### Examiner l'interface d'analyse de Runner
**Conditionnel :** Lorsque l’interface de gestion du propriétaire est activé, utilisez ces onglets :
| Onglet | Que réviser |
| --- | --- |
| **Points de terminaison** | Destinations de réception configurées et leur statut. |
| **Catalogue** | Types d'événements disponibles avant de choisir ce qu'une destination reçoit. |
| **Journaux** | Livraisons enregistrées et leur statut de retour. |
| **Activité** | Activité récente du webhook. |
1. Ouvrez **Points de terminaison** et identifiez la destination que vous avez l'intention d'inspecter.
2. Lisez **Catalogue** pour vérifier le type d'événement pertinent.
3. Ouvrez **Journaux** et inspectez une livraison disponible pour cette destination.
4. Comparez son statut avec le propre enregistrement du service de réception avant d'appeler la livraison avec succès.
**Point de contrôle :** Un point de terminaison enregistré confirme la configuration ; un enregistrement de livraison réussie et un enregistrement de destinataire correspondant confirment cet événement particulier. Un journal vide ne prouve pas que la livraison fonctionne. Tester, renvoyer et rejouer les actions envoyer des événements ; utilisez-les uniquement pour un test prévu.
### Portail des fournisseurs intégré
Runner prépare le service webhook avant d'afficher le portail de gestion intégré.
| État de la page ou contrôle | Ce qu'il signifie ou fait |
| --- | --- |
| **Chargement…** | Runner vérifie si le service webhook est prêt. |
| **La plateforme webhook s'initialise** | La configuration est toujours en cours. Attendez et gardez la page ouverte, ou revenez plus tard. |
| **L'initialisation prend plus de temps que prévu** | La configuration n'a pas été complétée après l'attente normale. **Réessayer** demande à Runner de provisionner le service à nouveau. |
| **Nouvelle tentative…** | La nouvelle tentative est en cours ; le bouton reste indisponible jusqu'à ce que la demande soit terminée. |
| Message d'erreur | Runner n'a pas pu préparer le service. Conservez le message visible pour le support. |
| Portail webhook intégré | Le service est prêt. Les étiquettes et contrôles exacts à l'intérieur de ce portail géré par le fournisseur peuvent changer, alors suivez les instructions affichées là plutôt que de vous fier à des noms de boutons fixes dans ce guide. |
| **Reconnecter Shopify** | Ouvre la page d'intégration Shopify quand une connexion Shopify plus ancienne a besoin de nouvelles permissions de webhook. Reconnectez avant de vous attendre à ce que les événements Shopify arrivent. |
## Récupérer d'une initialisation longue
1. Attendez que le message d'initialisation soit terminé.
2. Si **L'initialisation prend plus de temps que prévu** apparaît, sélectionnez **Réessayer** une fois.
3. Attendez que le portail intégré remplace l'écran d'initialisation.
4. Si une erreur apparaît à nouveau, enregistrez le nom du projet et le message exact, puis contactez le support au lieu de réessayer à plusieurs reprises.
## Reconnecter Shopify quand demandé
1. Lisez l'avis **Reconnectez votre boutique Shopify**.
2. Sélectionnez **Reconnecter Shopify**.
3. Complétez le flux de connexion sur la page d'intégration Shopify.
4. Revenez à Webhooks et confirmez que l'avis de reconnexion est parti avant de compter sur la livraison d'événements.
La reconnexion modifie l'autorisation d'intégration du magasin. Seule une personne autorisée à gérer cette connexion de magasin doit continuer.
## Notes de sécurité
- Traitez les adresses de point de terminaison, les secrets de signature et les contenus d'événements comme sensibles.
- Ajoutez ou modifiez une destination uniquement quand son propriétaire a fourni l'adresse sécurisée correcte.
- Examinez chaque confirmation affichée à l'intérieur du portail intégré ; ses actions peuvent affecter les livraisons futures.
- Si une valeur de signature est exposée, remplacez-la dans le service webhook de Runner et le système de réception avant d'envoyer plus d'événements.
## Dépannage
| Problème | Étape suivante |
| --- | --- |
| Aucune entrée Webhooks | La fonctionnalité n'est pas exposée dans cet espace de travail. Vérifiez [Disponibilité des fonctionnalités](./feature-availability). |
| L'initialisation ne se termine pas | Utilisez **Réessayer** une fois, puis signalez l'état exact s'il se répète. |
| Un message d'erreur apparaît | Conservez le message complet et le nom du projet pour le support. |
| L'avis de reconnexion Shopify persiste | Terminez la reconnexion à partir de la page d'intégration, puis rechargez Webhooks une fois. |
| Le portail intégré est vide ou se comporte différemment | Rechargez une fois. S'il persiste, capturez ce qui est visible ; l'interface du fournisseur intégré peut différer selon le compte ou la version. |
## Guides connexes
- [Disponibilité des fonctionnalités](./feature-availability)
- [Sécurité et sessions](../account-and-settings/security-and-sessions)
- [Dépannage des applications](../apps-and-integrations/troubleshooting)
- [Support et communauté](../help-and-reference/support-and-community)
---
# Flux de travail
Source: https://www.runnerai.com/docs/fr/guides/advanced/workflows
Le flux de travail transforme un processus répétable en étapes connectées que Runner peut exécuter avec les mêmes entrées et règles à nouveau.
> **Conditionnel :** L'interface Flux de travail existe, mais la navigation standard du projet actuel n'expose pas d'entrée Flux de travail. Utilisez-la uniquement lorsque Runner affiche une entrée Flux de travail approuvée pour votre espace de travail ou que le support Runner fournit un chemin approuvé. Ne devinez pas et ne modifiez pas une URL pour y accéder. Si votre plan n'autorise qu'un aperçu, Runner peut afficher la page tout en gardant ses contrôles bloqués.
## Chemin d'accès
Ouvrez l'entrée **Workflow** uniquement lorsque Runner la présente dans votre espace de travail. La page répertorie les flux de travail du projet actuel. Si aucune entrée n'est présente, utilisez [Disponibilité des fonctionnalités](./feature-availability) ou contactez le support au lieu de tenter une URL directe.
## Avant de commencer
- L'accès au flux de travail dépend du déploiement de fonctionnalités actuel et du plan.
- Confirmez le projet et les services connectés avant de tester ou de déployer un flux de travail.
- Un aperçu ou un brouillon enregistré n'est pas actif ; le déploiement et l'activation sont des actions distinctes.
## Liste des flux de travail
Quand il n'y a pas de flux de travail, sélectionnez **Créer un workflow**. Lorsque la liste contient déjà des éléments, utilisez **Nouveau workflow**.
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Créer un workflow** ou **Nouveau workflow** | Ouvre **Créer un workflow**. |
| **Workflow vierge** | Crée un **Workflow sans titre** et ouvre son générateur. |
| Carte de modèle | Crée un flux de travail à partir de ce modèle et ouvre son générateur. Si les modèles ne se chargent pas, **Réessayer** les demande à nouveau. |
| Nom du flux de travail | Ouvre ce flux de travail dans le générateur. |
| **Renommer** | Rend le nom modifiable. Appuyer sur Entrée ou cliquer ailleurs l'enregistre ; Échap annule la modification. |
| **Épingler en haut** / **Désépingler** | Déplace le flux de travail dans ou hors du groupe épinglé. Il n'exécute pas le flux de travail. |
| **Dupliquer** | Crée une copie et ouvre la copie dans le générateur. |
| **Exporter** | Télécharge le flux de travail en tant que fichier JSON. Il ne déploie ni n'exécute rien. |
| **Supprimer** | Ouvre une confirmation. La confirmation supprime définitivement ce flux de travail et ne peut pas être annulée. |
Utilisez le menu Plus de chaque ligne pour trouver **Renommer**, **Épingler en haut** ou **Désépingler**, **Dupliquer**, **Exporter** et **Supprimer**.
Les étiquettes de ligne peuvent également indiquer si une version est **En ligne**, a un **Brouillon plus récent**, expose un point de terminaison ou est liée à un calendrier ou un événement. Une étiquette en pause ou bloquée par le plan signifie que le déclenchement automatique n'est pas actuellement actif.
### Travailler avec plusieurs flux de travail
Sélectionnez la case à cocher à côté d'une ou plusieurs lignes. La barre de sélection indique le nombre sélectionné et propose :
- **Exporter** pour télécharger les flux de travail sélectionnés.
- **Supprimer** pour ouvrir une confirmation en masse. La confirmation supprime définitivement tous les flux de travail sélectionnés.
- **Effacer** pour supprimer la sélection sans modifier les flux de travail.
**Tout sélectionner** sélectionne les flux de travail affichés dans la liste actuelle. Revérifiez toujours le nombre avant la suppression en masse.
## Construire et enregistrer
Le canevas du générateur est l'endroit où vous ajoutez des étapes, les connectez et configurez ce que chaque étape reçoit et fait. **Ajouter un composant** ouvre la bibliothèque de composants consultable. Les contrôles du canevas effectuent un zoom avant, un zoom arrière, ajustent le flux de travail à l'écran et arrangent automatiquement les étapes connectées.
Les modifications s'enregistrent automatiquement ; il n'y a pas de bouton Enregistrer séparé. La flèche Retour termine un enregistrement en attente avant de revenir à la liste des flux de travail.
| État d'enregistrement | Ce qu'il faut faire |
| --- | --- |
| **Enregistrement en cours…** | Attendez avant de fermer la page ou de déployer. |
| **Enregistré** | La dernière modification du canevas est stockée. |
| **Échec de l'enregistrement** | Sélectionnez **Réessayer** après avoir vérifié la connexion. |
| **Conflit — vos modifications n’ont pas été enregistrées** | Une version enregistrée est plus récente. **Recharger** abandonne les modifications locales conflictuelles et charge la version enregistrée. |
Le panneau inférieur contient **Bac à sable** et **Exécutions**. Dans Bac à sable, complétez les entrées de texte, de produit ou de média requises avant d'exécuter. Le contrôle d'exécution reste indisponible tant que les entrées requises manquent. Les résultats apparaissent dans la zone de sortie.
Le menu Plus du générateur fournit également **Exporter en JSON** et **Importer un fichier JSON…**. L'exportation télécharge le canevas actuel. L'importation remplace immédiatement le canevas actuel et déclenche l'enregistrement automatique sans confirmation, donc exportez une sauvegarde et vérifiez le fichier sélectionné avant d'importer.
## Choisir le bon test
Les tests peuvent avoir des conséquences très différentes.
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Simuler** | Ouvre une boîte de dialogue de simulation. Utilisez les données d'exemple générées ou collez JSON, puis sélectionnez **Exécuter la simulation**. Les actions côté écriture telles que les e-mails, les publications Slack et les modifications de magasin sont simulées. |
| **Test en direct** | Ouvre une boîte de dialogue de test en direct. Utilisez les données générées, JSON collé ou un événement récent si disponible. **Exécuter le test en direct** effectue des appels API réels et peut envoyer des messages ou modifier les services connectés. L'exécution est marquée comme un test dans l'historique. |
| **Ignorer les attentes** | Lors d'un test en direct, ignore les périodes d'attente configurées pour que le test puisse continuer plus tôt. Il ne supprime pas les autres effets réels. |
| **Exécuter le workflow** | Démarre immédiatement le flux de travail configuré et ouvre Exécutions. Ses étapes peuvent avoir des effets réels ; examinez chaque étape et entrée en premier. |
| **Arrêt** | Demande l'arrêt de l'exécution actuelle. Le travail déjà effectué n'est pas annulé. |
| **Cache** | Lors d'une réexécution, ignore les nœuds éligibles dont les entrées n'ont pas changé pour que vous puissiez vous concentrer sur le travail en aval modifié. |
Utilisez la simulation pour vérifier la ramification et le flux de données. Utilisez le test en direct uniquement lorsque les effets secondaires réels sont acceptables dans les comptes connectés.
Les deux tests utilisent le déclencheur choisi, même avant le déploiement. Pour un déclencheur **Planification** ou **Une fois**, le test lance l'exécution comme si le déclencheur se déclenchait à cet instant, ce qui permet de tester un workflow ponctuel avant sa date prévue.
## Examiner l'historique des exécutions
Ouvrez **Exécutions** dans le panneau inférieur pour voir les exécutions précédentes. Filtrez la liste avec **Réelles**, **Test** ou **Toutes les exécutions**, puis sélectionnez une exécution pour inspecter ses résultats de nœud, sa sortie, son minutage et ses erreurs. Les statuts incluent Terminé, Échec, En cours et Annulé.
Si la liste indique **Pas encore d’exécution**, le flux de travail actuel n'a pas d'exécution enregistrée. Démarrer une autre exécution n'est pas une solution pour une exécution échouée ; ouvrez d'abord l'exécution échouée et lisez son erreur.
Certains nœuds échoués éligibles offrent **Réessayer depuis « nœud »**. Cela démarre une nouvelle tentative immédiatement, sans autre confirmation. Les actions en aval peuvent s'exécuter à nouveau, donc vérifiez d'abord les messages ou les modifications de magasin déjà produits par l'exécution échouée.
## Déployer et activer
Sélectionnez **Déployer** pour ouvrir **Déployer le workflow**. Examinez le résumé des modifications, la compatibilité des contrats API, les résultats de validation et le journal des modifications facultatif avant de continuer.
Vous pouvez éventuellement lier le flux de travail déployé à un événement, à une planification récurrente ou à une exécution unique. Un seul de ces types de déclenchement peut être sélectionné à la fois. Une exécution unique nécessite une date et une heure futures, saisies dans votre propre fuseau horaire.
- **Déployer le workflow** publie une version avec les paramètres sélectionnés.
- **Activer et déployer** apparaît lorsqu'une nouvelle liaison d'événement, de planification ou d'exécution unique rendrait l'automatisation active. La confirmation la publie et permet aux déclencheurs futurs de s'exécuter automatiquement avec des effets réels.
Une erreur d'enregistrement, un conflit non résolu ou un problème de validation peut bloquer le déploiement. Résolvez-le au lieu de sélectionner à plusieurs reprises Déployer.
L'état de production affiche **Non déployé**, **Brouillon plus récent** ou **En ligne**, ainsi que le déclencheur. Avant le premier déploiement, il s'agit du déclencheur choisi (**Événement**, **Planification**, **Une fois** ou **Manuel**) ou de **Aucun déclencheur**. Après un déploiement, il affiche **Manuel** si aucun déclencheur n'est lié, sinon l'état de la liaison, par exemple **Actif**, **Planifié**, **Terminé** ou **En pause**. L'ouverture d'une liaison existante offre des contrôles importants :
- **Mettre en pause** arrête les déclencheurs automatiques mais conserve le flux de travail et la liaison.
- **Reprendre le déclencheur** permet à la liaison conservée de se déclencher à nouveau.
- **Supprimer le déclencheur** supprime définitivement la liaison mais ne supprime pas le flux de travail.
Chaque action ouvre une confirmation et peut inclure une raison. La suppression de la case à cocher d'une liaison existante lors du déploiement met en pause cette liaison plutôt que de la supprimer définitivement.
## Historique des versions et restauration
Sélectionnez **Historique des versions** pour ouvrir le panneau **Historique des versions**.
| Action | Résultat |
| --- | --- |
| **Vérifier le retour en arrière** | Ouvre **Revenir à cette version ?**. **Confirmer la rétrogradation** fait en sorte que la version déployée sélectionnée remplace la version déployée actuelle. Cela peut modifier ce que les exécutions futures font, mais cela ne remplace pas le canevas de brouillon actuel. |
| **Restaurer** dans l'historique des brouillons | Remplace le canevas actuel par le brouillon enregistré sélectionné après confirmation. Les modifications du canevas non enregistrées ou plus récentes peuvent être perdues. |
Ajoutez une raison de restauration facultative pour que les autres membres de l'espace de travail comprennent la modification. Examinez le canevas restauré et l'état du déploiement avant de démarrer une autre exécution.
## Liste de contrôle de fonctionnement sûr
1. Confirmez que vous êtes dans le projet et le flux de travail corrects.
2. Attendez **Enregistré** avant de tester ou de déployer.
3. Complétez et examinez chaque entrée requise.
4. Commencez par **Exécuter la simulation** si possible.
5. Utilisez le test en direct ou le flux de travail d'exécution uniquement lorsque leurs effets de service connecté sont acceptables.
6. Inspectez **Exécutions** et les sorties avant de déployer.
7. Traitez **Activer et déployer**, la restauration, la restauration et la suppression comme des actions importantes qui nécessitent un examen final.
## Dépannage
| Problème | Étape suivante |
| --- | --- |
| Aucune entrée **Workflow** n'est visible | C'est attendu dans la navigation standard. Ne devinez pas une URL ; consultez [Disponibilité des fonctionnalités](./feature-availability) ou demandez au support Runner si votre espace de travail a une entrée approuvée. |
| Les contrôles sont bloqués par un aperçu du plan | Suivez le message du plan à l'écran ou demandez à un propriétaire de l'espace de travail l'accès. |
| La liste des modèles échoue | Sélectionnez **Réessayer** ou créez un **Workflow vierge**. |
| Le bouton d'exécution est indisponible | Complétez chaque entrée requise et corrigez toute valeur invalide. |
| Un conflit d'enregistrement apparaît | Décidez si la version enregistrée doit gagner avant de sélectionner **Recharger**, car les modifications locales conflictuelles sont abandonnées. |
| L'exécution échoue | Ouvrez-la dans **Exécutions**, conservez l'erreur visible et les entrées, et évitez de démarrer des exécutions identiques à plusieurs reprises. |
| Le déploiement est bloqué | Résolvez les messages d'enregistrement, de conflit, de contrat ou de validation affichés dans la boîte de dialogue de déploiement. |
## Vérifiez le résultat avant la prochaine étape
Après avoir enregistré, rouvrez le même flux de travail et confirmez que ses étapes et entrées sont présentes. Un flux de travail enregistré est prêt à être révisé, mais n'a pas nécessairement été exécuté. Lorsque votre espace de travail expose des contrôles de test ou de déploiement, inspectez l'état d'exécution et le résultat qui en résultent avant de passer au déploiement. Une exécution échouée nécessite que son entrée ou son étape défaillante soit corrigée avant une autre tentative.
## Guides connexes
- [Automatisations](../automate-test-and-create/automations)
- [États et détails des tâches](../work-with-runner/task-states-and-details)
- [Dépanner les tâches Runner](../help-and-reference/troubleshoot-runner-tasks)
- [Disponibilité des fonctionnalités](./feature-availability)
---
# Personnalisation de l'agent
Source: https://www.runnerai.com/docs/fr/guides/agent
La page **Agent**, intitulée **Enseignez à Runner comment vous travaillez**, rassemble les compétences et la mémoire dans un seul endroit consultable. Utilisez-le lorsque vous souhaitez que le Runner répète une méthode utile, se souvienne d'un fait stable ou cesse d'utiliser une fonctionnalité dont vous n'avez plus besoin.
## Ce que couvre ce guide
Vous saurez comment ouvrir la personnalisation de l'agent, trouver une capacité existante et choisir si une compétence ou une mémoire est le bon outil.
## Disponibilité et conditions préalables
- Vous avez besoin d'accès à un projet de magasin.
- Les compétences peuvent dépendre de votre plan actuel. Si votre plan n'inclut pas les compétences, Runner affiche le chemin de mise à niveau disponible au lieu d'activer l'action.
- La mémoire n'apparaît que lorsque la fonctionnalité de mémoire unifiée est activée pour votre compte.
- Les anciens liens **Compétences**, **Mémoire** et **Personnaliser** redirigent vers cette page de l'agent.
## Ouvrir la personnalisation de l'agent
À partir d'un projet, sélectionnez **Agent** dans la barre latérale. Utilisez les filtres **Tout**, **Compétences** et **Mémoire** pour affiner la page. **Recommandé pour vous**, **Ajoutée** et **Découvrir** sont des sections de cette page, et non des onglets de navigation séparés.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Utilisez les filtres de page pour vous concentrer sur les compétences ou la mémoire. Les compétences actives existantes apparaissent dans **Ajoutée** ; parcourir une recommandation ne l’installe pas.
## Contrôles principaux
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Compétences de recherche et mémoire** | Trouvez une fonctionnalité sans analyser chaque section. | La page filtre les compétences et la mémoire correspondant. Le bouton Effacer restaure la liste complète. |
| Onglet en anglais **Tout** | Examinez tout ce qui est disponible pour la page de l'agent. | Runner affiche la zone Compétences et, le cas échéant, Mémoire. |
| Onglet en anglais **Compétences** | Concentrez-vous sur les instructions et les capacités réutilisables. | Runner affiche les compétences recommandées, ajoutées, en pause et découvrables. |
| Onglet en anglais **Mémoire** | Concentrez-vous sur les faits que Runner doit retenir. | Runner affiche les mémoires regroupées par portée. Cet onglet est masqué lorsque la mémoire est indisponible. |
| **Ajouter** | Installez ou réactivez une compétence. | La compétence se déplace vers **Ajoutée** après que Runner ait terminé l'action. |
| **Ajoutée** | Voyez qu'une compétence est active. | Pour les compétences configurables, la sélectionner met en pause cette compétence. |
| **Importer** | Apportez une compétence compatible à partir d'une URL. | Runner vérifie la source, puis ouvre une importation modifiable ou un sélecteur multi-compétences. |
| **Créer une compétence** | Écrivez une instruction réutilisable personnalisée. | L'éditeur de compétences s'ouvre. Les champs obligatoires doivent être complets avant de pouvoir être enregistrés. |
| **Ajouter une mémoire** | Enregistrez un fait stable ou une préférence. | La boîte de dialogue **Nouvelle mémoire** s'ouvre. |
## Choisir entre une compétence et une mémoire
1. Utilisez une **Compétence** lorsque Runner doit suivre un processus répétable, un format ou un ensemble d'instructions.
2. Utilisez **Mémoire** lorsque Runner doit retenir un fait concis, une préférence, une correction, une convention ou une décision.
3. Gardez les secrets hors des deux. Ne stockez jamais les mots de passe, les clés API, les détails de paiement ou les identifiants privés.
4. Retournez à l'onglet en anglais **Tout** et recherchez un terme pour confirmer que le nouvel élément apparaît.
## États et limites
- **Recommandé pour vous** affiche un petit ensemble de compétences tendance.
- **Ajoutée** contient les compétences actives ; **En pause** contient les compétences inactives.
- **Découvrir** peut afficher des lignes de chargement, des résultats de recherche ou un message sans résultats.
- Une compétence système peut être en lecture seule ou fixe. Une compétence personnalisée peut offrir des actions de modification et de suppression.
- Une zone de mémoire vide offre **Ajouter une mémoire**. Une recherche sans correspondance offre **Effacer la recherche** sans rien supprimer.
- Les états de chargement, de plan et d'indisponibilité ne signifient pas qu'une capacité a été ajoutée.
## Dépannage
- Si l'onglet en anglais **Mémoire** est absent, la fonctionnalité n'est pas activée pour le compte actuel. Continuez à utiliser les compétences ou vérifiez à nouveau à partir de la navigation visible plus tard.
- Si **Ajouter** ouvre un écran de mise à niveau, comparez les plans avant de prendre une décision de facturation.
- Si la recherche ne trouve rien, effacez la requête et vérifiez séparément les onglets en anglais **Tout**, **Compétences** et **Mémoire**.
- Si une modification échoue, gardez la boîte de dialogue ouverte, corrigez le problème affiché et réessayez. Ne supposez pas qu'une notification ou un état de chargement signifie que la modification s'est terminée.
## Guides connexes
- [Utiliser et mettre en pause les compétences](/fr/guides/agent/skills)
- [Créer, importer et gérer les compétences](/fr/guides/agent/create-import-manage-skills)
- [Ajouter et modifier la mémoire](/fr/guides/agent/memory)
- [Utiliser la palette de commandes de l'agent](/fr/guides/agent/command-palette)
---
# Palette de commandes de l'agent
Source: https://www.runnerai.com/docs/fr/guides/agent/command-palette
La palette de commandes de l'agent est un raccourci orienté clavier pour les capacités de l'agent. C'est utile lorsque vous savez ce dont vous avez besoin et que vous ne voulez pas parcourir la page complète de l'agent.
## Ce que couvre ce guide
Vous serez capable d'ouvrir la palette, de rechercher ses trois groupes de capacités, d'utiliser le clavier et de comprendre ce que fait la sélection de chaque résultat.
## Disponibilité et conditions préalables
- Vous devez être à l'intérieur d'un projet.
- Les compétences restent soumises à l'accès au plan et à l'état configurable de chaque compétence.
- Les résultats de mémoire n'apparaissent que lorsque la mémoire unifiée est activée.
- Cette palette est différente de la recherche de navigation de projet : **Commande/Ctrl + K** recherche les destinations et les conversations, tandis que **Commande/Ctrl + Maj + K** ouvre les capacités de l'agent.
## Chemin d'accès
Dans un projet où la palette est disponible, appuyez sur **Command + Shift + K** sur macOS ou **Ctrl + Shift + K** sur Windows et Linux. Vérifiez que la boîte de dialogue affiche les filtres **Compétences** et **Mémoire** avant de sélectionner un résultat. S'il ouvre la recherche de navigation, fermez-la et utilisez la barre latérale **Agent**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Si le raccourci clavier n'ouvre pas la palette de fonctionnalités, utilisez cette page **Agent** pour rechercher les mêmes compétences. Cette image montre la page de secours, pas la palette de commandes.
## Contrôles
| Entrée ou clé | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| Champ de recherche | Trouvez les compétences par nom, description, catégorie ou type, et les mémoires par contenu, balises, type ou portée. | Les résultats se mettent à jour sous Ajouté, Découvrir et Mémoire. |
| Onglet en anglais **Tout** | Recherchez tous les types de capacités disponibles. | Les compétences et, le cas échéant, la mémoire apparaissent ensemble. |
| Onglet en anglais **Compétences** | Limitez les résultats aux compétences installées et découvrables. | Les lignes de mémoire sont masquées. |
| Onglet en anglais **Mémoire** | Limitez les résultats aux mémoires enregistrées. | Cet onglet est masqué lorsque la mémoire est indisponible. |
| Flèches haut/bas | Parcourez les résultats sans souris. | La ligne en surbrillance change. |
| Entrée | Sélectionnez la ligne en surbrillance. | Le résultat effectue son action spécifique au type. |
| Échap | Partez sans rien changer. | La palette se ferme. |
## Ce que la sélection fait
| Type de résultat | Ce qui se passe lors de la sélection |
| --- | --- |
| Compétence configurable ajoutée | Runner bascule l'état actif de la compétence lorsque votre plan le permet. |
| Compétence système fixe | La ligne reste inchangée si cette compétence ne peut pas être basculée. |
| Découvrir une compétence | Runner commence à ajouter la compétence ; la ligne peut afficher **Ajout en cours…**. |
| Mémoire | La palette se ferme et ouvre **Agent → Mémoire** avec une recherche basée sur cette mémoire. |
| Compétence sans accès au plan | Runner ouvre **Agent → Compétences**, où la porte du plan explique l'étape suivante disponible. |
## Utiliser la palette
1. Appuyez sur **Commande/Ctrl + Maj + K**.
2. Tapez un mot distinctif du nom de la compétence, de la source ou du contenu de la mémoire.
3. Si nécessaire, sélectionnez les onglets en anglais **Compétences** ou **Mémoire** pour affiner la liste.
4. Utilisez les touches fléchées pour mettre en surbrillance une ligne.
5. Examinez le texte d'action sur la droite, tel que **Ajouter** ou **Ouvrir**.
6. Appuyez sur Entrée uniquement lorsque c'est l'action que vous souhaitez.
7. Confirmez le résultat sur la page de l'agent ou dans l'état de palette mis à jour.
## États et limites
- **Rien à afficher** signifie que l'onglet actuel et la requête n'ont renvoyé aucune ligne.
- **Ajout en cours…** est un état de progression, pas une confirmation que l'installation s'est terminée.
- La palette est optimisée pour la sélection rapide ; créer, modifier, supprimer, portée de mémoire et les paramètres détaillés de compétence restent sur la page complète de l'agent.
- La sélection d'une compétence active peut la mettre en pause. Lisez l'état de la ligne avant d'appuyer sur Entrée.
## Dépannage
- Si le raccourci ouvre la recherche du projet ou plusieurs boîtes de dialogue, appuyez sur Échap pour le fermer et utilisez la barre latérale **Agent** pour gérer les mêmes fonctionnalités.
- Si la mémoire est absente, le compte n'a pas actuellement la surface de mémoire unifiée.
- Si Entrée ouvre la page de l'agent au lieu de basculer une compétence, suivez la porte du plan affichée.
- S'il n'y a pas de résultats, effacez la recherche ou sélectionnez l'onglet en anglais **Tout**.
- Si une compétence reste inchangée, il peut s'agir d'une compétence système fixe.
## Guides connexes
- [Aperçu de la personnalisation de l'agent](/fr/guides/agent)
- [Compétences](./skills)
- [Mémoire](./memory)
- [Forfaits d'abonnement](../plans-and-billing/subscription-plans)
---
# Créer, importer et gérer les compétences
Source: https://www.runnerai.com/docs/fr/guides/agent/create-import-manage-skills
Les compétences personnalisées vous permettent de regrouper vos propres instructions pour une utilisation répétée. L'importation est utile lorsqu'une compétence compatible existe déjà et que vous souhaitez l'examiner avant de l'ajouter à Runner.
## Ce que couvre ce guide
Vous saurez comment créer ou importer une compétence, comprendre chaque contrôle d'éditeur et distinguer la pause réversible de la suppression permanente.
## Disponibilité et conditions préalables
- Ouvrez un projet avec accès à **Agent → Compétences**.
- Les compétences nécessitent un accès au plan.
- L'importation nécessite une URL source compatible que Runner peut lire.
- N'importez pas les instructions en lesquelles vous n'avez pas confiance. Examinez le nom, la description, le contenu, les paramètres et les fichiers inclus avant d'enregistrer.
## Chemins d'accès
- Créer : Barre latérale **Agent** → Filtre **Compétences** → **Créer une compétence** dans la section **Découvrir**.
- Import : Barre latérale **Agent** → Filtre **Compétences** → **Importer** dans **Découvrir**.
- Modifier ou supprimer : Barre latérale **Agent** → Filtre **Compétences** → une ligne dans **Ajoutée** → **Plus d’actions**.
## Contrôles de l'éditeur de compétences
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Nom** | Donne à la compétence son identité dans les listes et les commandes. | Runner valide qu'un nom est présent avant d'enregistrer. |
| **Description** | Explique quand la compétence doit être utilisée. | La description apparaît dans les listes de compétences et les sélecteurs. |
| **Contenu** | Stocke les instructions réutilisables. | Écrivez **Modifier** et utilisez **Aperçu** pour vérifier les instructions formatées. |
| **Configuration avancée** | Révèle les paramètres facultatifs d’invocation et d’organisation. | Développez-le uniquement lorsque vous devez modifier ces paramètres. |
| **Passer à Markdown** / **Passer au formulaire** | Modifie la façon dont vous modifiez la compétence. | Ouvre l'éditeur Markdown ou basé sur des champs ; changer de vue ne sauvegarde pas la compétence. |
| **Catégorie** | Regroupe les compétences connexes. | Cette étiquette facultative affecte la façon dont les compétences sont organisées. |
| **Libellé du raccourci** | Donne à la compétence une étiquette de commande plus claire. | L'étiquette facultative apparaît avec les contrôles orientés commande. |
| **Activé** | Choisissez si la compétence nouvelle ou modifiée commence à être active. | Cela commence pour une nouvelle compétence. Désactivez-le avant de créer la compétence si elle doit démarrer en pause. |
| **Désactiver l'invocation automatique de l'IA** | Empêche Runner de choisir la compétence automatiquement. | La compétence reste disponible pour une utilisation manuelle. |
| **Invocable par l'utilisateur** | Permet l'utilisation manuelle de la commande slash. | La désactiver supprime l'invocation manuelle tout en conservant les autres utilisations autorisées. |
| **Indice d'argument** | Affiche l'entrée attendue après une commande. | L'indice peut afficher des exemples tels qu'une URL ou un numéro de problème. |
| Zone de fichiers | Ajoutez du texte de support ou des ressources nécessaires à la compétence. | Runner valide les limites de fichiers individuels et totaux avant d'enregistrer. |
| **Annuler** | Partez sans appliquer la modification actuelle. | La boîte de dialogue se ferme ; les modifications non enregistrées sont abandonnées. |
| **Créer** / **Enregistrer** | Conservez une compétence valide. | Runner ferme l'éditeur après succès et actualise la liste des compétences. |
## Créer une compétence personnalisée
1. Ouvrez la barre latérale **Agent** et sélectionnez le filtre **Compétences**.
2. Dans **Découvrir**, sélectionnez **Créer une compétence**.
3. Entrez un **Nom** minuscule et avec trait d'union, tel que `homepage-copy-review`, un **Description** concis et la compétence **Contenu**. Ces champs sont obligatoires.
4. Sélectionnez **Aperçu** dans Contenu pour vérifier les instructions. Développez **Configuration avancée** pour les paramètres facultatifs uniquement lorsque vous en avez besoin.
5. Examinez **Activé** et tous les paramètres d'appel avancés que vous avez modifiés. Ces contrôles déterminent comment Runner peut utiliser la compétence.
6. Sélectionnez **Créer**.
7. Confirmez que la compétence apparaît sous **Ajoutée** ou **En pause**, selon le paramètre Activé.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4coukNWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Cet exemple présente un aperçu des instructions avant **Créer**. Le brouillon n'a pas été enregistré.
### Vidéo : réviser un brouillon de compétences
L'enregistrement fait basculer l'exemple entre Markdown et Form Preview, puis s'annule. Pour conserver votre propre compétence, sélectionnez **Créer** et confirmez qu'elle apparaît dans la liste.
## Importer une compétence
1. Ouvrez **Agent**, sélectionnez le filtre **Compétences** et recherchez **Importer** dans **Découvrir**.
2. Collez l'URL source compatible.
3. Sélectionnez **Importer**.
4. Pour une compétence découverte, Runner ouvre l'éditeur avec les champs importés remplis. Pour une source contenant plusieurs compétences, Runner ouvre un sélecteur.
5. Examinez chaque champ importé et tout avertissement de fichier exclu ou de taille.
6. Apportez les modifications nécessaires, puis sélectionnez **Créer**.
7. Confirmez que la compétence apparaît sur la page de l'agent avant de fermer votre flux de travail.
L'importation ne rend pas le contenu non examiné digne de confiance. Traitez les instructions importées comme tout autre contenu qui peut influencer le travail de Runner.
## Modifier, mettre en pause ou supprimer
1. Sélectionnez une ligne de compétence personnalisée ou ouvrez **Plus d’actions → Modifier**.
2. Modifiez les champs dont vous avez besoin et sélectionnez **Enregistrer**. Rouvrez la compétence pour confirmer les instructions mises à jour.
3. Pour arrêter de l'utiliser sans la perdre, sélectionnez **Ajoutée** pour la déplacer vers **En pause**.
4. Pour la supprimer, ouvrez **Plus d’actions → Supprimer**.
5. Examinez la boîte de dialogue de confirmation nommée et sélectionnez **Supprimer** uniquement lorsque vous avez l'intention de supprimer la compétence.
**La suppression est destructrice.** Ce n'est pas la même chose que de mettre en pause, et la page ne la présente pas comme une action annulable. Les compétences système n'offrent pas de suppression.
## États et limites
- Le nom, la description ou le contenu manquant bloque l'enregistrement et affiche un message de validation.
- Un nom de compétence importée en double peut être rejeté ou marqué comme déjà présent.
- Les fichiers qui dépassent les limites acceptées peuvent être ignorés ; un avertissement de taille totale peut bloquer l'enregistrement jusqu'à ce que le contenu soit réduit.
- Pendant que l'enregistrement, l'importation ou la suppression s'exécute, attendez le message de succès ou d'erreur avant de prendre une autre action.
- Les compétences système en lecture seule peuvent afficher les détails mais n'exposent pas les contrôles d'édition de compétence personnalisée.
## Dépannage
- Si **Importer** reste indisponible, attendez que la vérification de compétence existante se termine et confirmez que le champ URL n'est pas vide.
- Si l'importation ouvre un sélecteur par lot, sélectionnez uniquement les compétences que vous reconnaissez et dont vous avez besoin.
- Si l'enregistrement est bloqué, vérifiez les champs obligatoires et tout avertissement de fichier en haut de l'éditeur.
- Si une compétence a disparu après avoir sélectionné **Ajoutée**, vérifiez **En pause** avant de la recréer.
- Si la suppression échoue, la compétence reste ; fermez l'erreur et réessayez après avoir vérifié vos autorisations.
## Guides connexes
- [Compétences](./skills)
- [Aperçu de la personnalisation de l'agent](/fr/guides/agent)
- [Utiliser la palette de commandes de l'agent](./command-palette)
- [Stocker les paramètres de l'agent](../account-and-settings/custom-scripts-and-store-agent)
---
# Mémoire
Source: https://www.runnerai.com/docs/fr/guides/agent/memory
La Mémoire est destinée aux faits concis que Runner doit retenir, comme une préférence d'écriture, une règle commerciale corrigée ou une décision approuvée. Elle réduit les explications répétées entre les tâches.
## Ce que couvre ce guide
Vous pourrez ajouter, trouver, modifier et supprimer en toute sécurité une mémoire.
## Disponibilité et conditions préalables
- Vous avez besoin d'un projet de magasin.
- L'onglet **Mémoire** n'apparaît que lorsque la Mémoire unifiée est activée pour votre compte.
- La Mémoire est séparée de la limite du forfait Compétences.
- Ne sauvegardez jamais les mots de passe, les clés API, les détails de paiement, les informations d'identification privées ou autres secrets dans la Mémoire.
## Chemin d'accès
Sélectionnez **Agent** dans la barre latérale, puis le filtre **Mémoire**.
## Contrôles de mémoire
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Ajouter une mémoire** | Enregistrez un nouveau fait pour Runner. | La boîte de dialogue **Nouvelle mémoire** s'ouvre. |
| **Contenu** | Énoncez le fait que Runner doit retenir. | Ce texte devient la mémoire visible. |
| **Portée** | Choisissez où le fait doit s'appliquer. | Sélectionnez **Ce magasin**, **Personnel** ou **Organisation**. |
| **Type** | Expliquez quel type de fait c'est. | Sélectionnez Préférence, Correction, Convention, Connaissance ou Décision. |
| **Étiquettes** | Facilitez la recherche et le regroupement de la mémoire. | Entrez une ou plusieurs étiquettes séparées par des virgules. Au moins une étiquette est requise pour enregistrer. |
| **Importance** | Dites à Runner avec quelle force peser le fait. | Sélectionnez Faible, Moyen ou Élevé. |
| **Ajouter une mémoire** | Enregistrez une nouvelle mémoire valide. | La boîte de dialogue se ferme après le succès et la mémoire apparaît dans son groupe de portée. |
| Icône de modification | Corrigez ou affinez une mémoire. | **Modifier la mémoire** s'ouvre avec les valeurs actuelles. |
| **Enregistrer** | Appliquez une modification. | La ligne s'actualise après la réussite de la mise à jour. |
| Icône de suppression ou **Supprimer** | Supprimez une mémoire. | Runner ouvre une boîte de dialogue de confirmation destructive. |
## Ajouter une mémoire
1. Ouvrez la barre latérale **Agent**, puis sélectionnez le filtre **Mémoire**.
2. Sélectionnez **Ajouter une mémoire**.
3. Écrivez un fait clair dans **Contenu**, tel que « Utiliser la casse des phrases pour les titres de ce magasin ».
4. Choisissez la **Portée** la plus étroite correcte.
5. Choisissez le **Type** le plus proche.
6. Ajoutez un **Étiquettes** utile séparé par des virgules, tel que `copy, headings`.
7. Définissez **Importance**. Utilisez Élevé avec parcimonie pour les faits que Runner doit prioriser quand les informations entrent en concurrence.
8. Sélectionnez **Ajouter une mémoire**.
9. Confirmez que la nouvelle ligne apparaît sous la portée prévue.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
L'exemple est une préférence non enregistrée. Choisissez la portée la plus étroite avant de sélectionner **Ajouter de la mémoire**.
### Vidéo : choisissez une étendue de mémoire
L'enregistrement inspecte les choix de portée pour un exemple de préférence, puis s'annule. Cela ne sauvegarde pas de mémoire. Suivez les étapes ci-dessus et vérifiez la nouvelle ligne pour confirmer votre propre sauvegarde.
## Modifier ou supprimer une mémoire
1. Trouvez la mémoire en parcourant son groupe de portée ou en utilisant la recherche.
2. Sélectionnez l'icône d'édition, mettez à jour les champs et sélectionnez **Enregistrer**. Rouvrez la ligne pour vérifier le nouveau contenu et la nouvelle portée.
3. Pour la supprimer, sélectionnez l'icône de suppression ou **Supprimer** dans la boîte de dialogue de modification.
4. Examinez **Supprimer la mémoire** et sélectionnez **Supprimer** pour confirmer.
La suppression d'une mémoire ne peut pas être annulée à partir de cette boîte de dialogue. Annuler ferme la confirmation sans la supprimer.
## États et limites
- Un nouveau compte peut afficher **Aucune mémoire pour le moment** avec une action **Ajouter une mémoire**.
- Une recherche sans correspondance indique combien de mémoires sont masquées et propose **Effacer la recherche**.
- Le Contenu et au moins une étiquette sont requis avant que le bouton d'enregistrement devienne disponible.
- Les mémoires sont groupées par portée et affichent leur type, portée, nombre d'utilisations et heure d'utilisation récente.
- La Mémoire rend un fait disponible pour Runner ; ce n'est pas une garantie que le fait remplacera chaque instruction ou limite de sécurité.
## Dépannage
- Si l'onglet **Mémoire** est absent, utilisez la navigation visible plutôt qu'un ancien lien direct. La fonctionnalité n'est pas activée pour le compte actuel.
- Si **Ajouter une mémoire** est désactivé, ajoutez du Contenu et au moins une étiquette séparée par des virgules.
- Si la liste semble vide après la recherche, sélectionnez **Effacer la recherche**.
- Si une modification échoue, la mémoire précédente reste. Corrigez le problème affiché et réessayez.
- Si une mémoire est appliquée trop largement, modifiez-la et choisissez une portée plus étroite.
## Guides connexes
- [Types et portées de la mémoire](./memory-types-and-scopes)
- [Aperçu de la personnalisation de l'Agent](/fr/guides/agent)
- [Utiliser la palette de commandes de l'Agent](./command-palette)
- [Sécurité des clés API](../account-and-settings/api-keys)
---
# Types et portées de la mémoire
Source: https://www.runnerai.com/docs/fr/guides/agent/memory-types-and-scopes
La portée empêche un fait de s'appliquer au mauvais travail, tandis que le Type et l'Importance aident Runner à l'interpréter. Utilisez cette page quand une mémoire doit s'appliquer à plus d'une tâche, mais pas nécessairement à chaque magasin ou personne.
**Chemin d'entrée :** **barre latérale → Agent → Mémoire → Ajouter une mémoire**, ou ouvrez une mémoire existante pour la modifier.
## Ce que couvre ce guide
Vous pourrez choisir la portée la plus étroite correcte, classer une mémoire et utiliser des étiquettes et l'importance sans stocker de données sensibles.
## Disponibilité et conditions préalables
- La Mémoire unifiée doit être activée pour le compte.
- Ouvrez **barre latérale → Agent → Mémoire → Ajouter une mémoire** ou modifiez une mémoire existante.
- N'utilisez aucune portée pour les mots de passe, les clés API, les données de carte, les codes d'authentification ou autres secrets.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Utilisez **Scope** pour savoir où le fait s'applique et **Type** pour ce qu'il représente. Il s'agit d'un exemple non enregistré ; [Ajouter et modifier de la mémoire](/fr/guides/agent/memory) comprend la procédure pas à pas complète et l'enregistrement.
## Choix de portée
| Portée | À utiliser quand | Ce qui se passe ensuite |
| --- | --- | --- |
| **Ce magasin** | Le fait est spécifique à la vitrine actuelle, au catalogue, à la marque ou au flux de travail. | Runner groupe la mémoire sous la portée du magasin et peut l'appliquer au travail pour ce magasin. Par défaut, une nouvelle mémoire utilise cette portée, le type **Préférence** et l'importance **Moyenne**. |
| **Personnel** | Le fait décrit votre propre préférence de travail. | Runner le groupe comme Personnel plutôt que de le partager comme règle à l'échelle de l'espace de travail. |
| **Organisation** | Le fait est une règle approuvée ou une convention partagée dans l'espace de travail. | Runner le groupe sous Organisation pour qu'il puisse éclairer le travail au-delà d'un seul magasin. |
Choisissez la portée la plus étroite qui reste utile. Par exemple, une règle d'expédition spécifique à un magasin ne doit pas être une mémoire d'Organisation à moins qu'elle ne s'applique vraiment partout.
## Choix de type
| Type | Bon usage | Exemple |
| --- | --- | --- |
| **Préférence** | Un style souhaité ou un choix de travail | « Utilisez des descriptions de produits concises et éditoriales. » |
| **Correction** | Un fait que Runner a mal compris auparavant | « La fenêtre de retour est indiquée dans le document de politique approuvé. » |
| **Convention** | Une règle de nommage ou de formatage répétable | « Utilisez la casse de phrase pour les titres de collection. » |
| **Connaissance** | Un fait commercial ou produit stable | « La collection phare s'appelle Studio Essentials. » |
| **Décision** | Un choix approuvé que les travaux futurs doivent respecter | « Gardez le paiement en tant qu'invité activé. » |
N'incluez pas de secret dans un exemple ou une mémoire. Référencez l'emplacement d'une information d'identification protégée au lieu de stocker sa valeur.
## Importance et étiquettes
| Contrôle | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Faible** | Gardez un fait utile mais facultatif disponible. | Runner lui donne moins de poids quand les informations entrent en concurrence. |
| **Moyenne** | Utilisez la priorité normale pour les faits de travail stables. | Runner lui donne le poids moyen par défaut. |
| **Élevé** | Marquez une règle approuvée importante ou une décision. | Runner lui donne plus de poids quand il choisit entre les mémoires pertinentes. |
| **Étiquettes** | Facilitez la recherche et le regroupement. | Les étiquettes séparées par des virgules sont enregistrées avec la mémoire ; au moins une est requise. |
L'importance est un indice de priorité, pas une instruction d'ignorer la demande actuelle, les autorisations de compte ou les restrictions de sécurité.
## Classer une mémoire
1. Écrivez le fait en une phrase claire.
2. Demandez-vous où il doit s'appliquer : uniquement ce magasin, uniquement à vous ou dans toute l'organisation.
3. Sélectionnez le Type le plus proche en fonction de la raison de l'existence du fait.
4. Ajoutez un petit ensemble d'étiquettes spécifiques.
5. Commencez par l'importance Moyen à moins qu'il y ait une raison claire de choisir Faible ou Élevé.
6. Enregistrez et confirmez que la ligne apparaît sous le titre de portée attendu.
## États et limites
- La liste affiche le Type, la Portée, le nombre de fois où la mémoire a été utilisée et une heure d'utilisation récente relative.
- La modification de la Portée déplace la mémoire vers un groupe différent après la réussite de l'enregistrement.
- La sélection de la mémoire dépend de la pertinence et de la priorité ; une mémoire Élevée n'est pas garantie d'apparaître dans chaque réponse.
## Dépannage
- Si une mémoire influence le mauvais magasin, changez sa Portée en **Ce magasin** dans le projet correct.
- Si deux mémoires entrent en conflit, modifiez ou supprimez celle qui est obsolète au lieu de les élever toutes les deux à Élevé.
- Si la recherche manque une mémoire, essayez les mots de son Contenu ou ses Étiquettes, puis effacez le filtre.
- Si une convention partagée n'est pas visible pour les collaborateurs, confirmez qu'elle a été enregistrée comme **Organisation**, pas Personnel.
## Guides connexes
- [Ajouter et modifier la Mémoire](./memory)
- [Aperçu de la personnalisation de l'Agent](/fr/guides/agent)
- [Sécurité et sessions](../account-and-settings/security-and-sessions)
---
# Compétences
Source: https://www.runnerai.com/docs/fr/guides/agent/skills
Les Compétences donnent à Runner un ensemble d'instructions répétable pour un type de travail. Elles sont utiles quand vous voulez qu'un processus fiable soit disponible dans les conversations futures au lieu de réécrire la même invite à chaque fois.
## Ce que couvre ce guide
Vous pourrez ajouter une Compétence, déterminer si elle est active, la mettre en pause et comprendre quelles actions sont disponibles pour les Compétences Système et Personnalisées.
## Disponibilité et conditions préalables
- Ouvrez un projet de magasin où vous avez la permission de gérer les capacités de l'Agent.
- L'utilisation de Compétences est limitée par le plan. Runner affiche un chemin de mise à niveau quand le plan actuel ne l'inclut pas.
- Certaines Compétences Système ne peuvent pas être mises en pause, modifiées ou supprimées.
## Chemin d'accès
Sélectionnez **Agent** dans la barre latérale, puis le filtre **Compétences**. Faites défiler jusqu'à **Recommandé pour vous**, **Ajoutée** ou **Découvrir** sur la même page.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Lisez la source de la compétence et l'état actuel avant de sélectionner **Ajouter** ou **Ajoutée**. La capture d'écran montre les compétences existantes, et non le résultat de l'installation d'une nouvelle.
## Sections et contrôles de compétence
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Recommandé pour vous** | Examinez rapidement un petit ensemble de Compétences tendance. | Sélectionner **Ajouter** commence l'installation. |
| **Ajoutée** | Voyez quelles Compétences sont actives. | Chaque ligne affiche le nom de la Compétence, la description, le type et les actions disponibles. |
| **En pause** | Trouvez les Compétences actuellement désactivées. | Sélectionner **Ajouter** réactive une Compétence configurable. |
| **Découvrir** | Parcourez ou recherchez des Compétences supplémentaires. | Un nom de Compétence peut ouvrir sa source dans un nouvel onglet ; **Ajouter** l'installe dans votre espace de travail. |
| Ligne de compétence | Lisez les détails de la Compétence. | Une Compétence Personnalisée s'ouvre en mode édition. Une Compétence Système s'ouvre en mode affichage. |
| Bouton **Ajoutée** | Mettez en pause une Compétence configurable active. | La Compétence se déplace vers **En pause** après la réussite de la mise à jour. |
| Bouton **Ajouter** | Installez ou réactivez une Compétence. | Le bouton affiche la progression, puis la Compétence apparaît sous **Ajoutée**. |
| Plus d'actions | Trouvez les actions de modification, d'affichage ou de suppression. | Les actions disponibles dépendent de si la Compétence est Système ou Personnalisée. |
## Ajouter une Compétence découverte
1. Sélectionnez **Agent** dans la barre latérale, puis le filtre **Compétences**. Faites défiler jusqu'à **Recommandé pour vous**, **Ajoutée** ou **Découvrir** sur la même page.
2. Recherchez la tâche ou le format dont vous avez besoin.
3. Examinez le nom de la Compétence, la source et la description.
4. Sélectionnez **Ajouter**.
5. Attendez que l'état de progression se termine.
6. Confirmez que la Compétence apparaît sous **Ajoutée** avant de vous y fier dans le chat.
## Mettre en pause ou réactiver une Compétence
1. Trouvez la Compétence sous **Ajoutée**.
2. Sélectionnez son bouton **Ajoutée**.
3. Confirmez qu'elle se déplace vers **En pause**.
4. Pour la réactiver, sélectionnez **Ajouter** dans la section En pause.
La mise en pause est réversible. Elle arrête la Compétence d'être active sans supprimer sa définition.
## Compétences Système et Personnalisées
| Type de compétence | Actions typiques | Limite importante |
| --- | --- | --- |
| **Système** | Afficher les détails ; mettre en pause uniquement quand la Compétence le permet | Les Compétences Système fixes n'offrent pas de suppression et peuvent ne pas offrir de pause. |
| **Personnalisé** | Modifier, mettre en pause, réactiver ou supprimer | La suppression nécessite une confirmation et supprime la Compétence plutôt que de simplement la mettre en pause. |
## États et limites
- **Ajout en cours...** signifie que l'installation est toujours en cours. Attendez **Ajoutée**.
- Les résultats de recherche peuvent provenir du répertoire public de Compétences ainsi que des Compétences déjà dans votre espace de travail.
- Une limite de plan bloque l'activation ; elle ne supprime pas les définitions de Compétences existantes.
- Le contenu importé peut omettre les fichiers qui dépassent les limites acceptées. Examinez tout avertissement avant d'enregistrer.
- **Aucun résultat skills.sh pour cette recherche** signifie qu'aucun résultat de découverte compatible n'a été renvoyé ; cela n'affecte pas les Compétences ajoutées.
## Dépannage
- Si **Ajouter** ne se termine pas, réessayez une fois après avoir vérifié l'erreur affichée. Évitez de cliquer à plusieurs reprises pendant que le bouton est occupé.
- Si une Compétence ne peut pas être mise en pause, c'est probablement une Compétence Système fixe. Ouvrez ses détails pour confirmer.
- Si la Compétence attendue est absente, effacez la recherche et vérifiez à la fois **Ajoutée** et **En pause**.
- Si une Compétence nouvellement ajoutée n'est pas disponible dans un projet, vérifiez **Paramètres → Magasin → Agent** pour la sélection de Compétences de ce projet.
## Guides connexes
- [Créer, importer et gérer les Compétences](./create-import-manage-skills)
- [Aperçu de la personnalisation de l'Agent](/fr/guides/agent)
- [Utiliser la palette de commandes de l'Agent](./command-palette)
- [Paramètres de l'Agent du magasin](../account-and-settings/custom-scripts-and-store-agent)
---
# Analyses et SEO
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo
Commencez par **Mesurer** → **Analyses** pour le comportement du magasin enregistré, ou **Développer** → **SEO** pour la présentation de **SEO & GEO**. Choisissez un guide ci-dessous pour la question à laquelle vous devez répondre.
> **Disponibilité :** **Analyses** dépend de votre plan et des données de magasin enregistrées. **SEO** nécessite un plan payant : **Plus** ou supérieur, ou AppSumo License Tier 2, 3 ou 4. Il peut aussi dépendre d'une vitrine publiée, de l'accès au fournisseur et de suffisamment de données publiques à analyser.
| Objectif | Commencez ici |
| --- | --- |
| Comprendre la page de performance complète | [Aperçu des analyses](/fr/guides/analytics-and-seo/analytics-overview) |
| Modifier la fenêtre de rapport | [Métriques et filtres](/fr/guides/analytics-and-seo/metrics-filters) |
| Trouver les frictions d'entonnoir ou de panier | [Trafic et conversion](/fr/guides/analytics-and-seo/traffic-and-conversion) |
| Démarrer un examen de visibilité de vitrine | [Aperçu SEO](/fr/guides/analytics-and-seo/seo-overview) |
| Lire les estimations de recherche organique | [Performance de recherche](/fr/guides/analytics-and-seo/search-performance) |
| Inspecter les liens et les problèmes techniques | [Liens entrants et audit du site](/fr/guides/analytics-and-seo/backlinks-and-site-audit) |
| Comprendre la visibilité dans les réponses IA | [Visibilité de l'IA](/fr/guides/analytics-and-seo/ai-visibility) |
| Tester les invites et inspecter les sources | [Invites, mots-clés et citations](/fr/guides/analytics-and-seo/prompts-keywords-citations) |
| Récupérer à partir de pages vides ou bloquées | [Dépanner les données et la publication](/fr/guides/analytics-and-seo/troubleshoot-data-and-publication) |
Ces vues rapportent ou analysent les données disponibles. Ouvrir un rapport ne modifie pas la vitrine, et un écran de configuration n'est pas une preuve que le trafic, les classements ou les mentions IA se sont améliorés.
---
# Visibilité de l'IA
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/ai-visibility
La visibilité de l'IA vous aide à inspecter si les données de recherche IA disponibles mentionnent votre marque, vos concurrents ou des sources publiques.
> **Conditionnel :** La visibilité de l'IA peut dépendre de l'accès à l'espace de travail, du plan, de la disponibilité du fournisseur, d'une vitrine publique et de données suffisantes. Terminer la configuration ne crée pas de mentions ni n'améliore la visibilité par elle-même.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **SEO** → **Visibilité dans l’IA** → **Ouvrir**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un nouveau magasin doit remplir le prérequis de publication SEO avant d’utiliser les rapports. L’aperçu des exemples de données est illustratif ; aucun résultat d’analyse n’est affiché ici.
## Avant de commencer
Si SEO affiche la liste de contrôle de configuration du premier magasin, remplissez ses exigences de publication avant d'attendre les données du rapport. Les valeurs étiquetées **Aperçu · données d’exemple** sont des exemples et non les résultats de votre magasin. Les étapes ci-dessous sont conditionnelles à la disponibilité du rapport correspondant.
- Publiez la vitrine et complétez l'étape d'admissibilité SEO principale.
- Vérifiez que Runner détecte le domaine de vitrine publique que vous avez l'intention de suivre ; la configuration ne fournit pas de champ de marque éditable séparé.
- Ajoutez uniquement les concurrents pertinents pour que les comparaisons de part de voix restent utiles.
- Connectez Google Search Console uniquement si l'entrée facultative est disponible et que vous souhaitez l'autoriser.
## Contrôles et résultats de clic
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Vitrine détectée | Affiche le magasin public que la configuration utilisera comme cible de départ. |
| Champs de concurrents dans la configuration | Ajoute des marques de comparaison aux choix de configuration ; entrer un nom ne lance pas une recherche. |
| Aperçu de l'invite de démarrage | Affiche des idées d'invite d'exemple pour la configuration. Les prévisualiser ne lance pas ou n'enregistre pas les résultats de l'invite. |
| Google Search Console → **Connecter** | Ouvre **Apps** pour la connexion facultative à Google Search Console. |
| **Continuer** | Avance à l'étape de configuration suivante quand l'entrée actuelle est valide. |
| **Ignorer pour l’instant** | Ferme la configuration sans démarrer la Recherche de marque ou créer un instantané. |
| **Lancer Brand Lookup** | Ouvre la configuration de la visibilité AI en trois étapes pour la vitrine détectée. |
| **Terminer la configuration** | Soumet la vitrine détectée et les choix de concurrents, ferme la configuration et démarre la Recherche de marque. Les résultats restent en attente jusqu'à la fin de la recherche. |
| **Demander à Runner de corriger** | Ouvre une nouvelle conversation Runner avec la preuve de visibilité de l'IA enregistrée et son amélioration recommandée. Elle ne modifie pas ou ne publie pas le magasin par elle-même. |
| **Voir les lacunes de citation** | Ouvre une conversation Runner fondée sur les preuves axée sur les opportunités de citation manquantes ; examinez ses suggestions avant de faire des modifications. |
## Terminer la configuration
1. Ouvrez **Développer** → **SEO**, puis ouvrez la carte **Visibilité dans l’IA**.
2. Sélectionnez **Lancer Brand Lookup** pour ouvrir la configuration.
3. Confirmez que la vitrine publique détectée est le magasin que vous avez l'intention d'examiner.
4. Ajoutez un petit ensemble de concurrents pertinents, puis sélectionnez **Continuer**.
5. Examinez l'aperçu de l'invite de démarrage sans le traiter comme un test terminé, puis continuez.
6. Connectez Search Console uniquement si l'option est utile et que vous êtes autorisé à connecter le compte.
7. Sélectionnez **Terminer la configuration** pour soumettre et démarrer la Recherche de marque.
8. Attendez un état terminé ; ne démarrez pas une recherche en double pendant qu'elle est en attente.
9. Lisez les mentions, le volume de recherche IA estimé, la part de voix, les requêtes et les sources citées ensemble.
## Lire le tableau de bord
- **Mentions** compte les réponses disponibles ou les enregistrements qui font référence à la marque suivie.
- **Part de voix** compare les marques suivies dans l'ensemble de données disponible ; ce n'est pas l'intégralité d'Internet.
- **Requêtes** affichent les questions associées aux résultats collectés.
- **Sources citées** affichent les pages référencées dans les réponses disponibles et peuvent inclure des sites que vous ne contrôlez pas.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| En attente | La recherche a été acceptée mais n'est pas terminée. Attendez avant de la redémarrer. |
| Terminé sans mentions | Le résultat ne contient aucune mention de la marque. Examinez les requêtes et les sources plutôt que de supposer que la configuration a échoué. |
| Échoué | Ouvrez l'erreur visible, confirmez la cible publique et réessayez plus tard. |
| Fournisseur indisponible ou accès manquant | Le modèle ou la source de données demandée ne peut pas être utilisée maintenant. Utilisez les sections terminées et réessayez plus tard. |
| Données insuffisantes | Le fournisseur n'a pas pu produire une vue fiable pour la cible. Gardez le site public et revisitez après qu'il ait plus de contenu découvrable. |
## Vérifiez avant de lancer la recherche
La configuration d'ouverture vous permet d'examiner la vitrine détectée et les concurrents. **Terminer la configuration** démarre la recherche et peut utiliser la capacité payante. Pour consulter le formulaire sans exécution, utilisez **Ignorer pour l’instant**. Après une recherche terminée, confirmez la cible et les preuves renvoyées avant d'interpréter le tableau de bord.
## Guides connexes
- [Invites, mots-clés et citations](./prompts-keywords-citations)
- [Aperçu SEO](./seo-overview)
- [Performance de recherche](./search-performance)
---
# Aperçu des analyses
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/analytics-overview
Analytics vous aide à connecter les visites enregistrées, l'activité d'achat et les ventes pour le magasin sélectionné.
## Chemin d'accès
Ouvrez un projet de magasin → **Mesurer** → **Analyses**.
Les captures de cette page montrent l'interface en anglais.
## Avant de commencer
- Votre plan doit inclure la surface de reporting. Un aperçu du plan n'affiche pas les résultats mesurés de votre magasin.
- L'activité publiée du magasin et l'activité enregistrée des acheteurs A sont nécessaires pour obtenir des rapports de trafic et de ventes significatifs.
- Sélectionnez le même magasin, la même période et les mêmes filtres lors de la comparaison des rapports.
## Choisissez la mise en page que vous voyez
Si votre écran affiche **Ventes Nettes**, **GMV**, **Sessions** et **Taux de Conversion** au-dessus d'une seule page défilante, suivez [les instructions précédentes du tableau de bord](#if-you-see-the-earlier-dashboard) ci-dessous. S'il affiche une navigation dans les rapports groupés, utilisez les instructions du plan de travail qui suivent. Si **Rapport de la semaine** et **Plus de rapports** apparaissent au-dessus du graphique, suivez [les instructions de cette mise en page](#if-you-see-the-sections-layout). Les mises en page ont des contrôles différents.
## Choisir un rapport
**Conditionnel :** Si votre écran affiche **Analyses de la boutique**, utilisez l'atelier groupé ci-dessous. Certains espaces de travail affichent toujours le tableau de bord d'une seule page décrit plus loin.
| Contrôle | Ce qu'il ouvre |
| --- | --- |
| **Vue d’ensemble** | Un récapitulatif de l'activité du magasin sélectionné. Utilisez un lien **Voir les détails** disponible pour inspecter le rapport sous-jacent. |
| **Commerce** | Rapports sur le commerce, l'entonnoir, les produits, l'acquisition et les objectifs. |
| **Comportement** | Page, événement, parcours et autres rapports de navigation pris en charge. |
| **Audience** | Rapports sur les visiteurs, les utilisateurs, les segments et les caractéristiques. |
| **Page en direct** | La vue d’activité en direct disponible. |
| **Configurer** | Outils de suivi et autres outils de configuration d’analyse. L'ouvrir ne crée pas d'événements. |
| Sélecteur de dates | Actualise le rapport sélectionné pour la période choisie. |
| **Comparer**, lorsqu'il est affiché | Ajoute la période de comparaison prise en charge. |
## Examiner votre premier rapport
1. Ouvrez **Vue d’ensemble** et confirmez le magasin sélectionné.
2. Choisissez une période qui contient une activité connue du magasin, telle que **7d** ou **30 j**.
3. Lisez le résumé visible, puis ouvrez **Commerce** pour inspecter les données de vente et d'entonnoir.
4. Ouvrez le sous-rapport correspondant à la question à laquelle vous devez répondre. Par exemple, comparez les étapes de l'entonnoir avant d'inspecter un problème de paiement suspecté.
5. Ouvrez **Comportement** pour inspecter une page ou un parcours concerné lorsque ces rapports contiennent des données.
6. Revenez à **Vue d’ensemble** pour comparer les détails avec le résumé.
**Point de contrôle :** Vous pouvez identifier le rapport, la période active et les événements derrière un résultat. Un rapport vide ne confirme ni la collecte d'événements fonctionnels ni un magasin en panne.
## Si vous voyez Plus de rapports [#if-you-see-the-sections-layout]
La vue d’ensemble affiche **Visiteurs**, **Chiffre d’affaires**, **Commandes**, **Visiteurs ayant acheté**, **Chiffre d’affaires par visiteur** et **En ligne maintenant**, puis le graphique de tendance et des listes de canaux, produits et lieux. La période, **Par jour** / **Par semaine** et **Filtrer** se trouvent au-dessus.
Sélectionnez **Plus de rapports** pour ouvrir **Tous les rapports**, qui regroupe chaque rapport :
| Groupe | Rapports |
| --- | --- |
| **Ventes** | **Chiffre d’affaires**, **Produits**, **Entonnoirs**, **Canaux** et **Objectifs**. |
| **Clients** | **Visiteurs**, **Personnes**, **Segments**, **En direct** et **Carte** lorsqu’elle est disponible. |
| **Santé de la boutique** | **Pages**, **Événements**, **Vitesse et erreurs**, **Sessions**, **Enregistrements** et **État du suivi**. |
| **Configuration** | **Suivi**, **Indicateurs de fonctionnalité**, **Tableaux de bord personnalisés**, **API**, **Utilisation** et **Paramètres**. Les ouvrir ne crée aucun événement. |
Recherchez un rapport par son nom, comme **Entonnoirs** ou **Carte**. Dans un rapport, les onglets passent aux autres rapports de son groupe et la flèche retour ramène à la vue d’ensemble.
1. Vérifiez la période au-dessus du graphique.
2. Lisez ensemble les chiffres du haut. Un taux d’achat dit peu de choses sans le nombre de visiteurs à côté.
3. Sélectionnez **Rapport de la semaine** pour la dernière semaine complète : chiffre d’affaires par appareil, visites et jours avant l’achat, heures d’achat et principaux pays.
4. Sélectionnez **Plus de rapports** et ouvrez le rapport de votre question, par exemple **Canaux** pour savoir d’où viennent les acheteurs.
Une nouvelle boutique affiche **Nouvelle boutique** et un nombre de visites jusqu’à ce qu’assez de personnes soient venues pour tracer des graphiques. Le badge **Données d’exemple · pas votre boutique** signifie que les chiffres sont un exemple, pas vos résultats. Un panneau marqué **Bientôt disponible** n’a pas encore de source de données ; ce n’est pas un problème de votre boutique.
## Si vous voyez le tableau de bord précédent [#if-you-see-the-earlier-dashboard]
Utilisez son sélecteur de plage de temps, puis lisez **Ventes Nettes**, **GMV**, **Sessions** et **Taux de Conversion** ensemble. Faites défiler jusqu'aux sections produit, source, entonnoir, abandon et remboursement.
## Dépannage
| État | Étape suivante |
| --- | --- |
| Tiret, zéro ou graphique vide | Supprimez les filtres facultatifs, essayez une période plus longue et confirmez que les visites ou les commandes réelles existent. |
| Avis de mise à niveau ou aperçu du plan | Vérifiez l'accès dans Plan et facturation avant de diagnostiquer la collecte. |
| Le rapport est en cours de chargement | Attendez la fin de sa demande avant de changer à nouveau les filtres. |
| Un rapport contient des données et un autre non | Vérifiez l'événement dont chaque rapport a besoin. Des visites peuvent exister avant les commandes. |
| Le rapport ne peut pas se charger | Rechargez une fois et conservez le nom, la période et l'erreur du rapport en cas d'échec à nouveau. |
| **Ce panneau ne s’est pas chargé.** | Sélectionnez **Réessayer** s’il est affiché, ou rechargez la page. Les autres panneaux affichent toujours vos données. |
| Entrée de navigation manquante | Développez **Mesurer** et confirmez l'espace de travail sélectionné. Voir [Disponibilité des fonctionnalités](../advanced/feature-availability). |
## Guides connexes
- [Métriques et filtres](./metrics-filters)
- [Trafic et conversion](./traffic-and-conversion)
- [Dépanner les données et la publication](./troubleshoot-data-and-publication)
---
# Liens entrants et audit du site
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/backlinks-and-site-audit
Les vues **Liens entrants** et **Audit du site** vous aident à examiner les références externes et les problèmes techniques du site depuis le même espace de travail SEO.
> **Conditionnel :** Les deux sections nécessitent une cible analysée admissible. Les données de lien et d'exploration peuvent être incomplètes, et les résultats Lighthouse facultatifs dépendent d'une vérification de page réussie.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **SEO** → **Liens entrants** ou une carte **Santé du site** → **Ouvrir**. Le rapport technique peut utiliser **Audit du site** dans la vue ouverte.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un nouveau magasin doit remplir le prérequis de publication SEO avant d’utiliser les rapports. L’aperçu des exemples de données est illustratif ; aucun résultat d’analyse n’est affiché ici.
## Avant de commencer
Si SEO affiche la liste de contrôle de configuration du premier magasin, remplissez ses exigences de publication avant d'attendre les données du rapport. Les valeurs étiquetées **Aperçu · données d’exemple** sont des exemples et non les résultats de votre magasin. Les étapes ci-dessous sont conditionnelles à la disponibilité du rapport correspondant.
- Publiez et ouvrez la vitrine cible avec succès.
- Complétez l'analyse SEO initiale.
- Décidez si vous avez besoin du contexte des liens, d'une exploration technique ou des deux.
- Ne supprimez pas ou ne redirigez pas les pages uniquement à partir d'une étiquette de problème automatisée ; inspectez d'abord la page affectée.
## Contrôles et résultats des liens entrants
| Contrôle ou section | Ce qu'il affiche ou fait |
| --- | --- |
| **Liens entrants** | Ouvre le nombre total de liens, les domaines référents, les principaux domaines et les pages les plus citées. |
| Vue Suivi / Non suivi | Sépare les types de lien quand le fournisseur inclut cette information. |
| Historique Nouveau / Perdu | Affiche les changements de lien enregistrés par le fournisseur. |
| Liens entrants rompus | Répertorie les liens qui semblent mener à une destination indisponible. |
| Score de spam | Fournit un signal de fournisseur pour examen ; ce n'est pas une preuve qu'un domaine est nuisible. |
| **Demander à Runner d'auditer ceux-ci** | Ouvre une nouvelle conversation Runner avec les données de liens entrants enregistrées et une demande d'audit. Elle ne supprime pas les liens et ne modifie pas le magasin. |
## Contrôles et résultats d'audit du site
| Contrôle ou section | Ce qu'il affiche ou fait |
| --- | --- |
| **Démarrer un nouvel audit** | Ouvre la configuration de l'exploration. Elle ne modifie pas la vitrine. |
| Contrôle de pages maximales | Limite la partie du site public que l'audit tente d'explorer. |
| **Inclure Lighthouse** | Ajoute les vérifications de performance, d'accessibilité, de bonnes pratiques et de SEO prises en charge. |
| **Exécuter l'audit** | Démarre l'exploration configurée. |
| **Problèmes** | Liste les résultats groupés pour que vous puissiez ouvrir l'explication, la recommandation et les pages affectées. |
| **Pages** | Affiche chaque URL explorée avec le statut, le titre, H1, le nombre de mots, le nombre d'images et le temps de réponse. |
| **Corriger tout avec Runner** | Ouvre une nouvelle conversation Runner avec la preuve d'audit enregistrée et une demande de correction large. Elle ne modifie pas ou ne publie pas le magasin par elle-même. |
| Ligne de problème | Ouvre pourquoi le problème est important, la recommandation et les pages affectées. |
| **Corriger avec Runner** | Ouvre une nouvelle conversation Runner avec le problème sélectionné, les URL affectées et une demande de correction. Elle ne modifie pas ou ne publie pas le magasin par elle-même. |
## Exécuter un audit ciblé
1. Ouvrez **Audit du site**.
2. Sélectionnez **Démarrer un nouvel audit**.
3. Choisissez une limite de pages appropriée pour le magasin public.
4. Activez Lighthouse uniquement quand vous avez besoin des vérifications de qualité de page supplémentaires.
5. Sélectionnez **Exécuter l'audit** et attendez la fin.
6. Utilisez **Problèmes** pour commencer par les résultats à fort impact, puis utilisez **Pages** pour inspecter les URL affectées et les données au niveau de la page.
7. Ouvrez un problème et vérifiez manuellement ses pages affectées.
8. Utilisez **Corriger avec Runner** pour une conclusion appropriée, ou **Corriger tout avec Runner** pour une demande d'examen large ; les deux ouvrent une conversation Runner et nécessitent que vous examiniez tout travail proposé avant d'accepter ou de publier les modifications.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Aucun lien entrant | Le fournisseur n'a trouvé aucune donnée de lien pour la cible ; ce n'est pas une preuve qu'aucun lien n'existe. |
| Lien perdu | Le fournisseur ne voit plus un lien antérieur. Ouvrez la source et la destination avant d'agir. |
| Échec de l'exploration | Confirmez que l'URL publique est accessible et non bloquée, puis exécutez un audit plus petit. |
| Lighthouse indisponible | Utilisez les résultats de l'exploration qui ont été produits et réessayez la vérification facultative plus tard. |
| Le nombre de problèmes est zéro | Aucun problème correspondant n'a été renvoyé par cet audit ; continuez l'examen normal de la vitrine. |
## Examiner les résultats existants avant une autre analyse
1. Ouvrez **Liens entrants** pour inspecter les liens disponibles et les domaines référents.
2. Revenez à l'aperçu SEO et ouvrez **Santé du site**.
3. Si un audit existe, sélectionnez un problème et lisez sa recommandation et les URL concernées.
4. Ouvrez une page publique concernée et confirmez que le problème s'applique.
5. Si une file d'attente de correctifs s'affiche, examinez le correctif sélectionné avant de le transmettre à Runner.
**Point de contrôle :** Vous disposez d'une URL concernée, de preuves à l'appui et d'une proposition de correction. La sélection d'un résultat ou l'ouverture d'une conversation Runner ne signifie pas que la correction a été appliquée ou publiée.
## Guides connexes
- [Aperçu SEO](./seo-overview)
- [Performance de recherche](./search-performance)
- [Dépanner les données et la publication](./troubleshoot-data-and-publication)
---
# Métriques et filtres
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/metrics-filters
Utilisez la même période et les mêmes filtres pour effectuer une comparaison significative entre le trafic, les commandes et les ventes.
## Chemin d'accès
Ouvrez un projet de magasin → **Mesurer** → **Analyses** → contrôles de rapport.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEkGsXzhdR6T0uwqnz73letZimQpFvYfSrhLM)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Choisissez Dernières 24 heures, 7 derniers jours ou 30 derniers jours dans le menu de date Analytics sur une seule page.
## Avant de commencer
- Décidez à quelle question la période doit répondre : activité actuelle, semaine récente ou tendance plus large.
- La journée en cours partielle A n’est pas directement comparable à une journée passée complète.
- Les contrôles Filter varient selon le rapport et la présentation Analytics disponible dans votre espace de travail.
## Contrôles et résultats des clics
Vérifiez d’abord votre mise en page visible. Le tableau de bord d'une seule page propose **Dernières 24 heures**, **7 derniers jours** et **30 derniers jours**. Si votre espace de travail affiche à la place l'atelier **Analyses de la boutique**, utilisez les commandes ci-dessous :
| Contrôle | Résultat |
| --- | --- |
| **Aujourd’hui** / **Hier** | Sélectionne le jour actuel ou précédent. |
| **7j** / **30 j** | Sélectionne une fenêtre hebdomadaire ou mensuelle récente. |
| Dates personnalisées | Permet de choisir les dates de début et de fin du rapport. |
| **Comparer**, lorsqu'il est affiché | Ajoute ou supprime une période de comparaison. |
| **Segment**, lorsqu'il est affiché | Limite le rapport à l'audience sélectionnée. |
| Filtres supplémentaires | Restreint les événements ou les enregistrements correspondants. Utilisez uniquement les conditions nécessaires à votre question et respectez la limite indiquée par le formulaire. |
Si votre espace de travail affiche le tableau de bord précédent, son sélecteur propose à la place **Dernières 24 heures**, **7 derniers jours** et **30 derniers jours**.
### Contrôles à côté de Plus de rapports
Si votre page Analytique affiche **Rapport de la semaine** et **Plus de rapports** au-dessus du graphique, utilisez ces contrôles :
| Contrôle | Résultat |
| --- | --- |
| Période | Choisissez **Aujourd’hui**, **Hier**, **7 derniers jours**, **30 derniers jours**, **90 derniers jours**, **Ce mois-ci** ou **Personnalisée…**. Les flèches passent à la période précédente ou suivante. |
| Option de comparaison dans la période | Affiche chaque chiffre à côté de la période de même durée juste avant. Pour 30 jours, l’option s’intitule **Comparer aux 30 jours précédents**. |
| **Filtrer** | Restreint les rapports par **Source**, **Pays**, **Appareil** ou **Produit consulté**. Le bouton du bas indique combien de visiteurs correspondent, par exemple **Afficher 136 visiteurs** ; sélectionnez-le pour appliquer le filtre. |
| Puces de filtre | Chaque filtre actif apparaît au-dessus du rapport, à côté d’un nombre comme **40 visiteurs sur 136**. Retirez-le depuis sa puce ou sélectionnez **Tout effacer**. |
| **Par jour** / **Par semaine** | Change la façon dont le graphique de tendance regroupe les jours. |
**Produit consulté** garde les visiteurs qui ont vu ce produit ; chaque rapport décrit alors ces clients. Certains rapports, comme **Produits** et **En direct**, ignorent la période ou les filtres ; ces contrôles y sont masqués.
## Comparer une période
1. Ouvrez le rapport et choisissez **7 derniers jours** ou **30 derniers jours** dans le tableau de bord d'une seule page. Dans le plan de travail, choisissez **7d**, **30 j** ou des dates personnalisées.
2. Attendez que le rapport s'actualise et confirmez que l'étiquette de date correspond à votre choix.
3. EActivez **Comparer** si disponible et vérifiez quelle période il utilise.
4. Appliquez un segment ou un filtre uniquement lorsque la question concerne ce public ou cet événement.
5. Confirmez que la condition sélectionnée reste visible avant d'interpréter les chiffres.
6. Supprimez la condition et désactivez la comparaison pour revenir à la vue plus large.
**Point de contrôle :** Vous pouvez indiquer les dates et les conditions qui ont produit les chiffres affichés. La suppression des filtres devrait restaurer la requête plus large, même si les deux requêtes sont vides.
## Lire les métriques avec leurs décomptes
- Vérifiez les sessions enregistrées et les achats avant d'interpréter les pourcentages de conversion.
- Lisez séparément le GMV et les ventes nettes : ils décrivent différentes mesures des ventes.
- A Une forte variation en pourcentage avec un petit échantillon nécessite davantage de preuves.
- Faites correspondre les durées de période, les filtres et les définitions de métriques avant de comparer un autre service.
## Dépannage
| État | Étape suivante |
| --- | --- |
| La nouvelle période est encore vide | Effacez les filtres et confirmez que le magasin a eu une activité pertinente au cours de cette période. |
| Un filtre n'est pas disponible | Utilisez les contrôles pris en charge par ce rapport ; ne supposez pas que chaque vue a les mêmes champs. |
| Limite de filtre atteinte | Supprimez une condition inutile avant d’en ajouter une autre. |
| Les valeurs changent de manière inattendue | Revérifiez les dates personnalisées, le segment actif, la période de comparaison et les commandes ou remboursements inhabituels. |
| Le rapport ne parvient pas à s'actualiser | Rechargez une fois et conservez la période sélectionnée et l'erreur visible pour l'assistance. |
## Guides connexes
- [Aperçu des analyses](./analytics-overview)
- [Trafic et conversion](./traffic-and-conversion)
- [Dépanner les données et la publication](./troubleshoot-data-and-publication)
---
# Invites, mots-clés et citations
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/prompts-keywords-citations
Les sections de détail de visibilité IA vous aident à apprendre quelles questions font surface votre marque et quelles sources soutiennent les réponses disponibles.
> **Conditionnel :** L'Explorateur de prompts et ses modèles peuvent être limités par forfait ou fournisseur. L'exécution d'une invite demande une nouvelle sortie de modèle et peut utiliser une capacité payante ; consultez l'avis d'espace de travail actuel avant de l'exécuter.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **SEO** → **Visibilité dans l’IA** → **Ouvrir** → **Prompts**, **Mots-clés** ou **Citations**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un nouveau magasin doit remplir le prérequis de publication SEO avant d’utiliser les rapports. L’aperçu des exemples de données est illustratif ; aucun résultat d’analyse n’est affiché ici.
## Avant de commencer
Si SEO affiche la liste de contrôle de configuration du premier magasin, remplissez ses exigences de publication avant d'attendre les données du rapport. Les valeurs étiquetées **Aperçu · données d’exemple** sont des exemples et non les résultats de votre magasin. Les étapes ci-dessous sont conditionnelles à la disponibilité du rapport correspondant.
- Complétez la configuration de la visibilité IA.
- Écrivez une question d'acheteur ciblée.
- Sélectionnez au moins un modèle disponible.
- Utilisez la recherche Web uniquement lorsque vous souhaitez que le modèle consulte les sources publiques actuelles.
## Contrôles et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Champ d'invite | Accepte la question à tester et avertit lorsque l'entrée est trop longue. |
| Sélecteur de modèle | Choisit les réponses du modèle disponible à demander. |
| **Autoriser la recherche web** | Permet aux modèles pris en charge de consulter les sources Web publiques pour cette exécution. |
| Surbrillance de marque | Indique à la vue des résultats quelle mention de marque mettre en évidence. Cela ne force pas le modèle à mentionner la marque. |
| **Lancer l’Explorateur de prompts** | Démarre les demandes de modèle sélectionnées. Cela ne modifie pas le magasin ni n'enregistre une amélioration de visibilité. |
| **Prompts** | Affiche les questions suivies ou explorées et leurs résultats disponibles. |
| **Mots-clés** | Affiche les termes associés à l'ensemble de données de visibilité IA. |
| **Citations** | Affiche les sources citées dans les réponses du modèle disponible. |
| **Mentions** | Affiche les réponses ou les enregistrements où la marque suivie a été détectée. |
## Explorer une question d'acheteur
1. Ouvrez **Prompts**.
2. Entrez une question en langage naturel qu'un acheteur pourrait poser.
3. Sélectionnez le modèle ou les modèles disponibles dont vous avez besoin.
4. Décidez d'activer ou non **Autoriser la recherche web**.
5. Optionnellement, choisissez la marque suivie pour la mise en évidence.
6. Sélectionnez **Lancer l’Explorateur de prompts** une seule fois.
7. Attendez que chaque modèle demandé se termine ou échoue.
8. Comparez la réponse, l'état **Marque mentionnée** ou **Marque non mentionnée**, les citations et les requêtes connexes.
9. Ouvrez **Mots-clés** et **Citations** pour trouver les sujets et sources récurrents.
## Interpréter les résultats en toute sécurité
- Une réponse est un exemple, pas un classement stable.
- « Marque non mentionnée » décrit cette réponse, pas chaque réponse possible.
- Une citation signifie que le modèle a référencé une source ; cela ne signifie pas que Runner approuve la source.
- Les résultats avec recherche Web désactivée et avec recherche Web activée répondent à des questions différentes et ne doivent pas être traités comme des tests identiques.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Bouton Exécuter désactivé | Entrez une invite valide et sélectionnez au moins un modèle. |
| Un modèle échoue | Utilisez les résultats du modèle complété et réessayez le fournisseur défaillant plus tard. |
| Aucune citation | La réponse peut ne pas avoir utilisé ou retourné de sources publiques. Réessayez avec la recherche Web uniquement si cela correspond à votre objectif. |
| Résultats non connexes | Rendez l'invite plus spécifique sur le produit, le public ou le besoin d'achat. |
| Erreur d'accès au fournisseur | Choisissez un modèle disponible ou demandez à un propriétaire d'espace de travail l'accès. |
## Inspectez d'abord les preuves enregistrées
1. Ouvrez **Visibilité dans l’IA** dans l'aperçu SEO et choisissez **Citations**.
2. Inspectez une source disponible et sa réponse associée. Suivez le lien source lorsqu'il est fourni.
3. Revenez à Runner et comparez la source avec l'invite ou le mot-clé associé.
4. Démarrez une nouvelle exécution de **Explorateur de prompts** uniquement si la recherche enregistrée ne répond pas à votre question.
**Point de contrôle :** Vous pouvez identifier la réponse et la page citée derrière un résultat. Une recherche de marque enregistrée et une nouvelle exécution de Prompt Explorer sont des exemples distincts ; l'ouverture des preuves enregistrées n'exécute pas une autre invite.
## Guides connexes
- [Visibilité IA](./ai-visibility)
- [Performance de recherche](./search-performance)
- [Dépanner les données et la publication](./troubleshoot-data-and-publication)
---
# Performance de recherche
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/search-performance
La performance de recherche vous aide à identifier quelles requêtes et pages semblent les plus importantes dans les données disponibles pour Runner.
> **Conditionnel :** Ces estimations n'apparaissent qu'après qu'une analyse SEO éligible retourne les données du fournisseur. Un nouveau domaine ou un domaine à faible trafic peut avoir peu ou pas de données.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **SEO** → Carte **Performance de recherche** → **Ouvrir**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un nouveau magasin doit remplir le prérequis de publication SEO avant d’utiliser les rapports. L’aperçu des exemples de données est illustratif ; aucun résultat d’analyse n’est affiché ici.
## Avant de commencer
Si SEO affiche la liste de contrôle de configuration du premier magasin, remplissez ses exigences de publication avant d'attendre les données du rapport. Les valeurs étiquetées **Aperçu · données d’exemple** sont des exemples et non les résultats de votre magasin. Les étapes ci-dessous sont conditionnelles à la disponibilité du rapport correspondant.
- Complétez une analyse SEO réussie pour la cible publique.
- Utilisez le domaine analysé affiché par Runner, en particulier lorsque le projet a plus d'un domaine.
- Lisez les estimations du fournisseur comme des signaux directionnels ; elles peuvent ne pas correspondre exactement à l'analyse propriétaire.
## Sections principales
| Section | Ce que cela signifie |
| --- | --- |
| Trafic organique estimé | Une estimation du fournisseur des visites provenant de la recherche non payante. |
| Mots-clés organiques | Les termes de recherche pour lesquels le domaine dispose de données de visibilité disponibles. |
| Classement du domaine | Une mesure d'autorité ou de visibilité comparative du fournisseur disponible. |
| Top 3 mots-clés | Les mots-clés estimés pour se classer près du haut des résultats de recherche. |
| **Mots-clés principaux** | Les requêtes avec leurs informations de position ou de trafic disponibles. |
| **Pages principales** | Les pages publiques recevant la visibilité organique estimée la plus forte. |
| **Demander à Runner** | Crée une nouvelle conversation Runner avec les preuves du rapport enregistré et une demande d'amélioration suggérée. Cela ne modifie ni ne publie le magasin par lui-même. |
| **Voir 5 gains rapides** | Crée le même transfert fondé sur les preuves de Runner pour que vous puissiez demander des opportunités priorisées en chat. Examinez tout travail proposé avant de l'appliquer ou de le publier. |
| **Analyser à nouveau** | Demande un nouvel instantané ; cela ne change pas le contenu ou le classement. |
## Examiner les opportunités de recherche
1. Ouvrez **Performances de recherche** après la fin de l'analyse.
2. Confirmez que le domaine analysé est la vitrine publique que vous aviez l'intention.
3. Lisez les métriques de synthèse comme une ligne de base, pas une promesse.
4. Parcourez **Mots-clés principaux** pour les termes qui correspondent aux produits et au public.
5. Ouvrez ou notez les **Pages principales** correspondantes.
6. Comparez le contenu de la page avec la question de l'acheteur derrière chaque mot-clé utile.
7. Apportez des modifications à la vitrine via Runner ou l'éditeur de magasin, puis publiez-les séparément.
8. Revenez plus tard et sélectionnez **Analyser à nouveau** lorsque suffisamment de temps s'est écoulé pour que les sources publiques changent.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Aucune donnée organique | Le fournisseur peut ne pas avoir suffisamment d'informations pour le domaine. Confirmez la publication et réessayez plus tard. |
| Mot-clé mais pas de page correspondante | Ouvrez la liste des pages et le site public ; le fournisseur peut attribuer la requête à une URL différente. |
| L'estimation diffère des analyses | Les analyses enregistrent les événements du magasin ; SEO utilise des estimations de recherche externes. Alignez la question avant de les comparer. |
| Le contenu nouvellement publié est absent | La découverte de recherche n'est pas immédiate. Confirmez que la page est publique et attendez avant d'actualiser. |
## Choisir une amélioration dont vous pouvez vérifier le résultat
Utilisez **Mots-clés** et **Pages** dans le rapport ouvert pour connecter une requête utile à une page publique. Si **Ouvrir la file de corrections** s'affiche, inspectez le correctif proposé et la page concernée avant de commencer à travailler avec Runner.
**Point de contrôle :** Vous pouvez nommer la requête, la page et la modifier à réviser. Les chiffres de recherche externe sont des estimations. Une connexion facultative à la console de recherche Google peut fournir des clics de première partie lorsqu'elle est disponible ; il n'est pas connecté automatiquement et ne doit pas être confondu avec les devis.
## Guides connexes
- [Aperçu SEO](./seo-overview)
- [Liens entrants et audit du site](./backlinks-and-site-audit)
- [Trafic et conversion](./traffic-and-conversion)
---
# Aperçu SEO
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/seo-overview
SEO vous aide à inspecter comment une vitrine publique peut être découverte dans les résultats de recherche et les réponses générées par l'IA.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **SEO**. La présentation du **SEO & GEO** renvoie à des rapports individuels.
## S'il s'agit de votre première visite SEO
La visite introductive explique l'espace de travail ; **Passer la visite** ouvre la vue d'ensemble. Pour une nouvelle boutique, **Trouvons votre boutique** présente trois étapes de configuration : publication de la vitrine, vérifications automatiques par l'IA et suivi automatique des mots clés. Commencez par l’exigence de publication.
Les métriques étiquetées **Aperçu · données d’exemple** illustrent le format du rapport. Ce ne sont pas des mesures de votre magasin. Les instructions du rapport ci-dessous s'appliquent une fois la configuration requise terminée et les résultats réels disponibles.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un nouveau magasin doit remplir le prérequis de publication SEO avant d’utiliser les rapports. L’aperçu des exemples de données est illustratif ; aucun résultat d’analyse n’est affiché ici.
## Avant de commencer
- Publiez la vitrine sauf si Runner offre une cible personnalisée éligible dans votre espace de travail.
- Confirmez que la page publique se charge avant de démarrer l'analyse.
- Accordez du temps aux fournisseurs de recherche et d'IA pour avoir des données sur un site nouvellement publié.
- Traitez l'analyse comme un instantané des sources disponibles, pas une garantie de classement ou de mentions.
## Contrôles et résultats des clics principaux
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Aperçu des bulletins → **Ouvrir** | Ouvre **Performance de recherche**, **Visibilité dans l’IA**, **Liens entrants** ou **Santé du site**. |
| Correction de la file d'attente ou du tiroir de révision, lorsqu'ils sont affichés | Vous permet d'inspecter une correction proposée et ses pages concernées avant de commencer le travail. |
| **Performances de recherche** | Ouvre les estimations de trafic organique, de mot-clé, de classement, de mot-clé supérieur et de page supérieure. |
| **Liens entrants** | Ouvre les liens, les domaines référents, l'historique des liens et les vues sur leur qualité. |
| **Audit du site** | Ouvre les résultats d'exploration technique et de problèmes. |
| Sections de visibilité IA | Ouvre le tableau de bord, les invites, les mots-clés, les citations ou les mentions lorsqu'ils sont disponibles. |
| **Analyser** | Démarre l'analyse pour la cible éligible. Cela ne modifie ni ne publie la vitrine. |
| **Analyser à nouveau** | Demande une analyse actualisée et remplace les résultats obsolètes lorsque l'actualisation se termine. |
| **Publier** | Démarre le chemin de préparation à la publication séparé lorsque le magasin est toujours un brouillon. |
| Google Search Console → **Connecter** | Ouvre **Apps** filtrées pour Google Search Console lorsque cette connexion est disponible. |
## Démarrer un examen SEO
1. Ouvrez **Développer** → **SEO** et confirmez la cible sur l'aperçu.
2. Si vous voyez le portail de publication, utilisez le chemin de publication et revenez uniquement après que l'URL en direct fonctionne.
3. Lisez d'abord les rapports existants. Sélectionnez **Analyser** uniquement lorsqu'une nouvelle analyse est nécessaire, après avoir examiné son avis d'utilisation actuel.
4. Attendez que l'état d'analyse se termine ; ne démarrez pas à plusieurs reprises la même analyse.
5. Ouvrez les cartes **Performance de recherche**, **Liens entrants** et **Santé du site** pour inspecter les rapports disponibles.
6. Revenez à la présentation, ouvrez **Visibilité dans l’IA** et inspectez ses sections détaillées disponibles.
7. Réexécutez avec **Analyser à nouveau** après des modifications publiques significatives ou lorsque Runner marque le résultat comme obsolète.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Portail de publication | La vitrine actuelle n'est pas éligible pour l'analyse publique. Publiez et vérifiez d'abord l'URL en direct. |
| Analyse en cours | Runner collecte les données disponibles. Attendez la fin. |
| Mis à jour | L'instantané affiché s'est terminé avec succès. |
| Obsolète | Les données publiques peuvent avoir changé ; utilisez **Analyser à nouveau** lorsqu'une actualisation est utile. |
| Résultat partiel | Certains fournisseurs ont retourné des données et d'autres non. Utilisez les sections disponibles et réessayez plus tard. |
| Cible inaccessible | L'analyseur n'a pas pu charger la page publique. Ouvrez l'URL publique directement, résolvez les problèmes d'accès ou de publication, puis analysez à nouveau. |
## Guides connexes
- [Performance de recherche](./search-performance)
- [Liens entrants et audit du site](./backlinks-and-site-audit)
- [Visibilité IA](./ai-visibility)
- [Dépanner les données et la publication](./troubleshoot-data-and-publication)
---
# Trafic et conversion
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/traffic-and-conversion
Les vues de trafic et de conversion vous aident à voir où les acheteurs arrivent, jusqu'où ils progressent et où un parcours peut nécessiter une attention.
## Chemin d'accès
Ouvrez un projet de magasin → **Mesurer** → **Analyses** → **Vue d’ensemble**, **Commerce** ou **Comportement** dans l'interface d'analyse. Dans le tableau de bord précédent, faites défiler sous les cartes récapitulatives.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvR648EFhEHcK82Y0dyL6sSr9NUGjnQeMWZJk)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Présentation Analytics sur une seule page dans un magasin de didacticiels sans activité enregistrée. L'illustration des diagnostics Alpha ne constitue pas une preuve d'un problème de magasin.
## Avant de commencer
- Sélectionnez une plage horaire et gardez-la active lors de la comparaison des sections.
- Le magasin a besoin de sessions enregistrées pour l'analyse du trafic et de commandes pour l'analyse des ventes ou des remboursements.
- Utilisez l'entonnoir comme preuve de où inspecter, pas comme preuve de pourquoi les acheteurs sont partis.
## Ouvrez le rapport pour votre question
Sur le tableau de bord d'une seule page, conservez la même période sélectionnée et faites défiler jusqu'à **Sessions de Trafic**, les sources, les ventes au fil du temps, l'entonnoir, l'abandon et les remboursements. Les destinations regroupées ci-dessous s'appliquent uniquement lorsque votre espace de travail affiche l’interface d’analyse avec navigation par rapports.
| Question | Destination dans l'interface d'analyse |
| --- | --- |
| Où s’est arrêté le shopping ? | **Commerce** → rapport d'entonnoir |
| Quels produits ou sources ont contribué ? | **Commerce** → rapport de produit ou d'acquisition |
| Quelle page ou quel parcours doit être inspecté ? | **Comportement** → page ou rapport de trajet |
Utilisez **Voir les détails** dans l'aperçu lorsqu'il renvoie au rapport concerné. La disponibilité et les données varient selon le magasin.
Si votre page Analytique affiche **Rapport de la semaine** et **Plus de rapports** au-dessus du graphique, ouvrez plutôt ces rapports depuis **Plus de rapports** :
| Question | Rapport |
| --- | --- |
| Où l’achat s’est-il arrêté ? | **Entonnoirs** |
| Quels canaux et campagnes ont amené des acheteurs ? | **Canaux**. Passez de **Dernier clic** à **Première visite** pour comparer quelle visite reçoit le crédit. |
| Quels produits se vendent, et d’où ? | **Produits**, puis sélectionnez un produit pour voir ses sources, ses lieux et les produits achetés avec lui. |
| Quelles sources et pages d’entrée transforment les visites en commandes ? | **Visiteurs**. Lisez le taux d’achat de chaque source à côté de son nombre de visites. |
| Où vivent les acheteurs ? | **Carte** |
| Sur quelle page les visiteurs partent-ils ? | **Pages** → **Pages de sortie** |
## Sections et résultats des clics
| Section ou contrôle | Ce qu'il affiche ou fait |
| --- | --- |
| **Sessions de Trafic** | Affiche la tendance des visites dans la période sélectionnée. |
| Vue source de ventes | Ventile les ventes enregistrées par source lorsque les données de source sont disponibles. |
| Vue ventes nettes du produit | Compare la contribution du produit aux ventes nettes. |
| Entonnoir **Taux de Conversion** | Affiche la progression via **Trafic**, **Ajouter au Panier**, **Paiement** et **Achat**. |
| **Taux d'Abandon de Panier** | Résume les paniers qui n'ont pas atteint un achat complété. |
| **Taux de Remboursement** | Affiche l'activité remboursée pour la fenêtre de rapport. |
| Sélecteur de plage horaire | Recalcule chaque section pour la nouvelle période. |
## Diagnostiquer une baisse de conversion
1. Faites défiler jusqu'à l'entonnoir dans le tableau de bord d'une seule page ou ouvrez le rapport **Commerce** approprié dans l'interface d'analyse. Sélectionnez une période avec suffisamment de séances pour être utile. S'il n'y a pas de données, vérifiez la collecte et la période avant de diagnostiquer la conversion.
2. Vérifiez si le trafic a augmenté, diminué ou est resté stable.
3. Comparez les sources de trafic pour voir si le mélange a changé.
4. Trouvez la plus grande baisse entre les étapes d'entonnoir adjacentes.
5. Si **Trafic → Ajouter au Panier** baisse, inspectez les informations produit, les prix, la confiance et la clarté de la page produit.
6. Si **Ajouter au Panier → Paiement** baisse, inspectez les coûts du panier, la clarté de l'expédition et l'itinéraire vers le paiement.
7. Si **Paiement → Achat** baisse, testez le chemin de paiement et de paiement sans placer une commande réelle inutile.
8. Examinez les remboursements séparément afin que les problèmes post-achat ne soient pas cachés dans les ventes de haut niveau.
**Point de contrôle :** Précisez l'étape, la page, la période et le nombre d'événements qui étayent votre constat avant de proposer une modification. Ouvrez la page de vitrine concernée pour vérifier votre explication ; l'entonnoir indique où chercher, pas la cause de la baisse.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| L'étape d'entonnoir est zéro | Aucun événement correspondant n'a atteint cette étape dans la plage sélectionnée. Confirmez le suivi avec une promenade sécurisée dans la vitrine. |
| Le trafic existe mais les ventes ne le font pas | Le magasin a reçu des visites sans achat enregistré. Inspectez la première grande baisse d'entonnoir. |
| Les ventes existent mais la source est vide | L'attribution de source n'était pas disponible pour ces ventes ; n'attribuez pas une source par supposition. |
| Le taux de remboursement change considérablement | Vérifiez la période de commande sous-jacente et le nombre de commandes avant de tirer une conclusion. |
| Les graphiques ne sont pas d'accord avec un autre service | Alignez les plages de dates, les fuseaux horaires, les définitions d'événements et les filtres avant de comparer les totaux. |
## Guides connexes
- [Métriques et filtres](./metrics-filters)
- [Aperçu des analyses](./analytics-overview)
- [Performance de recherche](./search-performance)
---
# Dépanner les données et la publication
Source: https://www.runnerai.com/docs/fr/guides/analytics-and-seo/troubleshoot-data-and-publication
Utilisez cette page pour identifier si un résultat manquant provient de l'état du magasin, de la plage de dates, de l'accès au plan, de l'accès aux fonctionnalités ou d'une source de données externe.
## Chemins d'accès
- Projet Store → **Mesurer** → **Analyses** pour les données d'événement de magasin.
- Projet Store → **Développer** → **SEO** pour la recherche publique et les données de visibilité de l'IA.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Cette exigence de publication explique pourquoi une nouvelle boutique n’a pas de rapport SEO. Les exemples de données ne constituent pas une analyse complète.
## Avant de commencer
- Notez la page exacte, le magasin, la période sélectionnée et le message visible.
- Vérifiez si le problème affecte une section ou la page entière.
- Pour SEO, ouvrez la vitrine publique directement avant de démarrer une autre analyse.
- Pour les analyses, confirmez que la période sélectionnée peut contenir l'événement attendu.
## Contrôles et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Plage horaire des analyses | Actualise le rapport pour la période sélectionnée ; cela ne crée pas d'événements de trafic ou de commande manquants. |
| **Analyser** | Démarre l'analyse SEO ou de visibilité IA disponible pour la cible publique actuelle. |
| **Analyser à nouveau** | Demande un nouvel instantané après une modification significative du site public. |
| **Réessayer** | Répète la section ou la demande défaillante lorsqu'elle est proposée ; cela ne corrige pas la publication, l'accès ou les conditions préalables du fournisseur. |
## Dépannage
| Ce que vous voyez | Signification probable | Prochaine étape |
| --- | --- | --- |
| Écran de mise à niveau ou de plan | Le plan actuel n'inclut pas la page. | Examinez l'accès au plan ; les rechargements répétés ne le déverrouillent pas. |
| L'entrée de navigation est manquante | La fonctionnalité n'est pas activée pour cet espace de travail. | Traitez-la comme conditionnelle et demandez à un propriétaire d'espace de travail ou au support. |
| **Publiez votre vitrine pour commencer l'analyse** | SEO n'a pas de cible publique éligible. | Complétez la publication, ouvrez l'URL en direct, puis revenez à SEO. |
| Tableau de bord des analyses, zéro ou graphique vide | Aucun événement correspondant n'existe pour la période sélectionnée. | Essayez une période plus longue et vérifiez que le magasin a enregistré des visites ou des commandes. |
| **Nouvelle boutique** avec un nombre de visites | Les graphiques apparaissent quand assez de personnes sont venues pour que les chiffres aient un sens. | Partagez le lien de la boutique ; le nombre indique combien de visites il reste. |
| **Données d’exemple · pas votre boutique** | La page affiche des chiffres d’exemple, pas vos résultats. | Si vous avez sélectionné **Voir les données de démonstration**, sélectionnez **Revenir aux données du projet**. Si la page propose **Passer à Pro**, votre forfait n’inclut pas ces rapports ; les exemples restent jusqu’à la mise à niveau. |
| **Bientôt disponible** sur un panneau | Ce panneau n’a pas encore de source de données. | Utilisez les autres panneaux ; ce n’est ni un problème de boutique ni de suivi. |
| **Ce panneau ne s’est pas chargé.** | Une requête a échoué. | Sélectionnez **Réessayer** s’il est affiché, ou rechargez la page. Les autres panneaux affichent toujours vos données. |
| Cible inaccessible | L'analyseur n'a pas pu charger la page publique. | Ouvrez l'URL exacte directement et résolvez les problèmes de publication, de domaine ou d'accès. |
| Pas assez de données | Le fournisseur ne peut pas retourner une estimation utile pour le moment. | Gardez le site public et réessayez après plus d'activité ou de découverte publique. |
| Sections partielles | Certains fournisseurs ont terminé et d'autres ont échoué. | Utilisez les résultats complétés ; réessayez uniquement la section manquante plus tard. |
| Étiquette obsolète | L'instantané enregistré peut ne plus refléter le site public. | Sélectionnez **Analyser à nouveau** après des modifications significatives. |
## Vérifier les données d'analyse
1. Ouvrez **Analyses** et notez la période sélectionnée.
2. Choisissez **30 j** (ou **30 derniers jours** dans la présentation précédente), puis désactivez les filtres facultatifs pour exclure une requête étroite.
3. Confirmez que le magasin en direct a reçu des sessions réelles.
4. Confirmez que les commandes ou remboursements existent avant d'attendre les métriques de ventes ou de remboursement.
5. Comparez les étapes d'entonnoir pour voir quels événements sont présents.
6. Rechargez une fois. Si la page entière échoue toujours, enregistrez le magasin et l'heure pour le support.
## Vérifier la publication et l'analyse SEO
1. Ouvrez la vitrine publique dans un onglet séparé.
2. Confirmez qu'elle se charge sans aperçu privé ni exigence de connexion.
3. Revenez à **SEO** et confirmez le domaine ou la cible prévue.
4. Sélectionnez **Analyser** ou **Analyser à nouveau** une seule fois.
5. Attendez un résultat terminal au lieu de démarrer des tâches répétées.
6. Si une section échoue, conservez les sections réussies et réessayez plus tard.
## Ce qu'une configuration réussie ne prouve pas
- La publication ne garantit pas l'indexation de la recherche.
- L'indexation de la recherche ne garantit pas le trafic ou une position supérieure.
- La configuration de la visibilité IA ne garantit pas une mention.
- Une exécution d'invite réussie ne prédit pas chaque réponse de modèle future.
- Un événement d'analyse n'explique pas pourquoi un acheteur a agi.
## Distinguer l'accès aux rapports de la collecte de données
Développez **Mesurer** ou **Développer** avant de traiter une entrée comme manquante. Un aperçu de plan n'est pas un rapport en direct. Dans l'atelier d'analyse, **Configurer** contient des outils de suivi et de configuration ; son ouverture ne crée pas d'événements pour les acheteurs. Confirmez le magasin, la période, les filtres et l'activité réelle avant de modifier les paramètres de collecte.
**Point de contrôle :** Identifiez si l'accès est bloqué, si la requête est vide ou si une requête nommée a échoué. Un rapport vide à lui seul ne peut distinguer aucune activité d'une collecte manquante.
## Guides connexes
- [Aperçu des analyses](./analytics-overview)
- [Aperçu SEO](./seo-overview)
- [Visibilité IA](./ai-visibility)
- [Documentation Runner](../product-guide)
---
# Applications et intégrations
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations
La page **Apps** rassemble les services de votre magasin et les Apps Agent facultatives au même endroit. Utilisez-la lorsque vous
souhaitez que Runner accepte les paiements, envoie les e-mails du magasin, travaille avec les fournisseurs d'expédition ou d'exécution,
connecte Shopify ou laisse l'Agent utiliser un autre service.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Le hub affiche les états de connexion existants et les contrôles disponibles. L'ouverture de cette page ne crée pas de connexion.
## Ouvrir les Apps
Dans un magasin ouvert, sélectionnez **Apps** dans la navigation du projet.
**Chemin d'accès :** **Projet → Apps**
La page peut afficher deux sections :
- **Gérez votre boutique** contient les services utilisés par la vitrine et les opérations du magasin.
- **Connectez vos outils** contient des services que l'agent Runner peut utiliser lorsqu'il travaille pour vous.
Les Apps Agent et Shopify sont conditionnelles. Elles peuvent être masquées ou indisponibles pour certains
espaces de travail. Les exigences du fournisseur peuvent également empêcher une carte visible d'être connectée.
## Contrôles de la page
| Contrôle ou état | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| **Rechercher des outils** | Trouve un service sans scanner chaque carte. | Runner filtre le catalogue d'outils. Effacer le champ restaure la liste. |
| **Connecter** | Démarre une nouvelle connexion. | Runner ouvre la boîte de dialogue des identifiants spécifiques au fournisseur ou le flux d'autorisation. La connexion n'est pas complète jusqu'à ce que la carte change d'état. |
| **Connexion en cours...** | Indique que Runner traite la demande. | L'action reste indisponible jusqu'à ce que la demande réussisse, échoue ou soit annulée en dehors de Runner. |
| **Connecté** ou une action connectée | Confirme que Runner reconnaît la connexion. | Les cartes spécifiques au fournisseur peuvent exposer un lien de tableau de bord, un contrôle de déconnexion, un commutateur ou une boîte de dialogue de gestion. |
| **Gérer** | Ouvre la connexion d'une application Agent existante. | Vous pouvez examiner ses outils ou la déconnecter. |
| **Reconnecter** | Répare une connexion qui a besoin d'une autorisation à nouveau. | Runner redémarre le flux de connexion du fournisseur. |
| **En attente d'examen** | Indique que Stripe examine toujours le compte. | Attendez que le statut change ou suivez toute demande d'action affichée sur la carte. |
| Supprimer ou **Déconnecter** | Supprime une connexion après confirmation. | L'avertissement spécifique au fournisseur explique quels projets et actions futures seront affectés. |
## Rechercher une connexion existante ou demander un outil
Utilisez la bande **Connecté** pour ouvrir une application déjà connectée et revoir ses contrôles de gestion. Pour rechercher une nouvelle application d'agent, faites défiler jusqu'à **Connectez vos outils** et utilisez **Rechercher des outils**. Effacez la recherche avant de décider qu’une application est absente.
**Demander une app** ouvre un formulaire de demande. L'envoi d'une demande ne connecte pas un fournisseur et ne le rend pas immédiatement disponible. Les connexions des fournisseurs CJ commencent dans [Dropshipping](/fr/guides/apps-and-integrations/cj-dropshipping), pas dans une carte Apps.
## Connecter une application en toute sécurité
1. Ouvrez **Projet → Apps**.
2. Recherchez le service ou trouvez-le sous **Gérez votre boutique** ou **Connectez vos outils**.
3. Sélectionnez **Connecter**.
4. Lisez la boîte de dialogue avant d'entrer un domaine, une clé API, un secret ou des identifiants de fournisseur.
5. Complétez toute étape d'autorisation sur le site du fournisseur.
6. Retournez à Apps et vérifiez la carte. Traitez uniquement un état connecté confirmé, comme un badge connecté ou des contrôles connectés, comme une connexion terminée.
7. Si Runner affiche **Reconnecter**, **En attente d'examen** ou un avis d'action, suivez cet état au lieu de répéter aveuglément la configuration initiale.
:::warning
Ne collez jamais les clés API ou les secrets dans un chat Runner. Entrez-les uniquement dans la boîte de dialogue d'intégration qui les demande.
:::
## Choisir un guide
- [Connecter, gérer, reconnecter ou déconnecter une application](/fr/guides/apps-and-integrations/connect-manage-reconnect)
- [Connecter Stripe pour les paiements](/fr/guides/apps-and-integrations/stripe-payments)
- [Activer l'e-mail de la boutique](/fr/guides/apps-and-integrations/resend-email)
- [Connecter Shippo pour l'expédition](/fr/guides/apps-and-integrations/shippo-shipping)
- [Connecter Shopify](/fr/guides/apps-and-integrations/shopify)
- [Connect CJ from Dropshipping](/fr/guides/apps-and-integrations/cj-dropshipping)
- [Connecter l'exécution 4PX](/fr/guides/apps-and-integrations/4px-fulfillment)
- [Connecter et contrôler les Apps Agent](/fr/guides/apps-and-integrations/agent-apps)
- [Dépanner une connexion d'application](/fr/guides/apps-and-integrations/troubleshooting)
---
# Connecter l'exécution 4PX
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/4px-fulfillment
Connectez 4PX lorsque vous souhaitez que Runner utilise votre compte 4PX pour l'expédition transfrontalière et
l'exécution. Cette connexion nécessite à la fois une clé API et un secret API.
## Avant de commencer
**Chemin d'entrée :** **Projet → Apps → Gérez votre boutique → 4PX**
Vous avez besoin :
- d'un compte 4PX avec une clé API et un secret API actuels ;
- l'autorisation d'utiliser ces identifiants pour cette boutique Runner ; et
- la conscience que la déconnexion supprime les deux identifiants et désactive 4PX uniquement pour cette boutique. Les autres boutiques conservent leur propre connexion 4PX.
Traitez les deux champs comme des secrets. Ne les collez pas dans le chat Runner.
Sur mobile, sélectionnez d'abord la ligne du fournisseur **4PX** pour ouvrir ses détails, puis utilisez les commandes de cette boîte de dialogue. Un formulaire de configuration visible indique uniquement par où commencer ; les étapes de connexion et de fonctionnement du fournisseur ci-dessous s'appliquent une fois que vous avez autorisé le service.
## Contrôles et résultats 4PX
| Contrôle | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **Connecter** | Ouvre la configuration 4PX. | Runner demande **Clé API 4PX** et **Secret API 4PX**. |
| Champs de clé API et de secret | Identifient et autorisent le compte 4PX. | Runner ne soumet que si les deux champs contiennent une valeur. |
| Icônes d'œil | Aident à vérifier une erreur de frappe dans l'un ou l'autre champ. | Chaque icône bascule indépendamment ce champ entre le texte caché et visible. |
| Dialogue **Connecter** | Soumet les deux identifiants. | En cas de succès, Runner efface les deux champs, ferme le dialogue et marque 4PX connecté. |
| **Annuler** ou fermer | S'arrête avant la soumission. | Runner efface les deux champs du dialogue. |
| Supprimer ou **Déconnecter** | Démarre la suppression. | Runner ouvre **Déconnecter 4PX ?**. |
| Confirmation **Déconnecter** | Supprime les identifiants de cette boutique. | Runner désactive 4PX pour cette boutique. Les autres boutiques ne sont pas affectées. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGp76tmTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Vérifiez les deux champs d’informations d’identification avant de vous connecter. Cet exemple s'arrête avant la soumission ; il ne vérifie pas l'exécution ou l'expédition.
## Connecter 4PX
1. Ouvrez **Projet → Apps**.
2. Trouvez **4PX** et sélectionnez **Connecter**.
3. Copiez la clé API et le secret API du compte 4PX que vous avez l'intention d'utiliser.
4. Collez-les dans **Clé API 4PX** et **Secret API 4PX**.
5. Vérifiez que les deux valeurs se trouvent dans les champs corrects.
6. Sélectionnez **Connecter**.
7. Attendez **4PX connecté avec succès** et confirmez que la carte affiche son contrôle de déconnexion connecté.
8. Vérifiez un scénario d'expédition ou d'exécution transfrontalière sécurisé avant de l'utiliser pour une commande client en direct.
## Déconnecter ou remplacer les identifiants
Sélectionnez le contrôle de déconnexion et lisez **Déconnecter 4PX ?**. Ne confirmez que si la désactivation de 4PX pour cette boutique est acceptable. Les autres boutiques de l'espace de travail conservent leur propre connexion.
Pour faire pivoter les identifiants, déconnectez la connexion actuelle, confirmez que la carte n'est plus connectée, puis reconnectez-vous avec la clé et le secret de remplacement.
## Si 4PX ne se connecte pas
- Confirmez que la clé et le secret proviennent du même compte 4PX.
- Re-copiez les deux valeurs au lieu de modifier l'un ou l'autre secret par supposition.
- **Échec de la connexion 4PX** signifie que Runner n'a pas terminé la connexion du fournisseur. Vérifiez les identifiants dans 4PX et réessayez.
- Si la carte se connecte mais que l'exécution échoue, vérifiez l'accès au compte, le support de destination et les données de commande requises par 4PX.
- Si la déconnexion échoue, supposez que les identifiants actuels restent actifs.
## Guides connexes
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Connecter Shippo pour l'expédition](./shippo-shipping)
- [Dépanner une connexion d'application](./troubleshooting)
---
# Connecter et contrôler les Apps Agent
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/agent-apps
Les Apps Agent permettent à l'Agent Runner d'utiliser un service externe tout en travaillant sur votre projet. Vous
pouvez inspecter les outils de l'application et désactiver les outils que vous ne voulez pas que l'Agent utilise.
## Avant de commencer
**Chemin d'entrée :** **Projet → Apps → Connectez vos outils**
Les Apps Agent sont conditionnelles. La section peut être masquée, et une application individuelle peut être
indisponible, ou le catalogue peut ne pas charger. La disponibilité peut varier selon l'espace de travail, le projet,
le fournisseur et l'accès au produit par étapes.
Vous avez besoin :
- d'un accès au projet ;
- d'un compte ou d'un identifiant accepté par le fournisseur sélectionné ; et
- d'une permission pour laisser Runner utiliser les outils que vous laissez activés.
Examinez chaque outil avant de vous connecter. L'accès aux outils s'applique au projet actuel et peut
permettre à l'Agent de lire ou de modifier les données du service externe.
La connexion du compte externe appartient à votre compte Runner connecté, tandis que les commutateurs d'outils
sont enregistrés pour le projet actuel. La déconnexion peut donc supprimer la connexion utilisée par
d'autres projets même si leurs choix d'outils sont séparés.
Commencez sous **Connectez vos outils**. Ouvrez une application, lisez sa liste d'outils, puis fermez les détails si vous comparez uniquement les capacités. L'autorisation est une décision distincte ; les outils de révision ne connectent pas le compte externe.
## Trouver et inspecter une application
| Contrôle ou état | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| **Rechercher des outils** | Filtre le catalogue d'outils. | Le catalogue montre les noms et descriptions correspondants. |
| Sélecteur de catégorie | Réduit le catalogue des Apps Agent. | Choisissez **Tout** pour supprimer le filtre de catégorie. |
| **Précédent** et **Suivant** | Se déplace dans un long catalogue. | Runner affiche la page précédente ou suivante des applications correspondantes. |
| Carte d'application | Affiche le nom de l'application, la description et l'état de la connexion. | La sélectionner ouvre **Détails de l'app**. |
| **Aucune application trouvée** | Indique que les filtres actuels n'ont pas de correspondance. | **Effacer la recherche** réinitialise la recherche et la catégorie. |
| Espaces réservés de chargement | Indique que Runner récupère le catalogue. | Attendez les cartes avant de choisir une application. |
## Contrôles des détails de l'application
| Contrôle ou état | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| Description de l'application et catégorie | Aide à confirmer que vous avez ouvert le service prévu. | Aucun accès externe n'est accordé en visualisant les détails. |
| Commutateur d'outil | Limite ce que Runner peut demander à l'application connectée de faire. | Avant de vous connecter, Runner enregistre vos choix avec la connexion. Après la connexion, une modification est enregistrée immédiatement. |
| **Précédent** et **Suivant** dans la liste des outils | Examine les applications avec de nombreux outils. | Se déplace dans les outils sans fermer la boîte de dialogue. |
| Champs d'identifiants requis | Prend en charge les applications qui n'utilisent pas l'autorisation du navigateur. | **Connecter** reste indisponible jusqu'à ce que les champs requis soient remplis. Les champs de type secret sont masqués. |
| **Connecter** | Soumet les identifiants du fournisseur lorsque cette stratégie est requise. | Runner tente la connexion avec votre accès aux outils choisis. |
| **Connecter et autoriser** | Démarre l'autorisation du fournisseur. | Runner ouvre une fenêtre d'autorisation. |
| **Connexion en cours...** | Indique que l'autorisation est en cours. | L'action reste indisponible jusqu'à ce que Runner reçoive un résultat. |
| **Connecté** | Confirme que Runner reconnaît le compte. | Fermez la boîte de dialogue ou gérez l'accès aux outils. |
| **Gérer** | Rouvre une application connectée. | Examinez et modifiez ses outils activés ou déconnectez-la. |
| **Déconnecter** | Démarre la suppression. | Runner demande **Déconnecter ? Runner perd l’accès à cette app jusqu’à ce que vous la reconnectiez.** |
| **Annuler** ou **Confirmer** | Résout l'avertissement de déconnexion. | Annuler maintient l'accès ; Confirmer supprime la connexion de l'application Agent au niveau du compte Runner. Les paramètres d'outils du projet sont séparés. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgkttueHjXIfFwWx7Qu1lJBZMSPHcazYdR0voC)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Examinez les outils une page à la fois avec **Suivant**. L'ouverture de cette liste n'autorise pas Notion ; **Connecter et autoriser** démarre cette étape distincte.
## Connecter une application Agent
1. Ouvrez **Projet → Apps** et faites défiler jusqu'à **Connectez vos outils**.
2. Recherchez l'application ou choisissez une catégorie.
3. Sélectionnez la carte d'application pour ouvrir **Détails de l'app**.
4. Lisez sa description et inspectez chaque outil disponible.
5. Désactivez tout outil que Runner ne doit pas utiliser dans ce projet.
6. Entrez les identifiants du fournisseur requis ou sélectionnez **Connecter et autoriser**.
7. Complétez l'étape du fournisseur. Si votre navigateur bloque la fenêtre d'autorisation, autorisez la
fenêtre contextuelle pour Runner et recommencez.
8. Retournez à la boîte de dialogue et confirmez qu'elle indique **Connecté**.
9. Sélectionnez **Gérer** plus tard pour examiner l'accès aux outils ou déconnecter l'application.
La boîte de dialogue de connexion indique que les identifiants du fournisseur sont envoyés via le service de connexion
et ne sont pas stockés par Runner. Vous devriez quand même traiter chaque identifiant comme un secret
et l'entrer uniquement dans les champs d'identifiants de l'application.
## Modifier l'accès aux outils
1. Sélectionnez **Gérer** sur l'application connectée.
2. Trouvez l'outil que vous souhaitez modifier.
3. Activez ou désactivez son commutateur.
4. Attendez **Outil activé** ou **Outil désactivé**.
5. Si Runner affiche **Échec de la mise à jour de l'outil**, laissez la boîte de dialogue ouverte, vérifiez l'état actuel du
commutateur après son actualisation, et réessayez uniquement si l'état enregistré est clair.
Désactiver un outil limite l'utilisation de cet outil par Runner. Cela ne supprime pas les données précédemment
créées dans le service externe.
## Réparer ou déconnecter une connexion
Si le catalogue n'affiche plus une connexion utilisable, ouvrez l'application et commencez **Connecter** ou
**Connecter et autoriser** à nouveau, puis confirmez **Connecté**.
Pour supprimer l'accès, sélectionnez **Gérer → Déconnecter**, examinez la confirmation et sélectionnez
**Confirmer**. Cela supprime la connexion de l'application Agent du compte connecté, pas seulement l'accès aux outils du projet actuel. Si la déconnexion échoue, Runner maintient l'état connecté ; ne supposez pas que le compte externe a été supprimé.
## Si les Apps Agent sont manquantes
- La fonctionnalité peut ne pas être activée pour l'espace de travail.
- Effacez la recherche et définissez la catégorie sur **Tout**.
- Actualisez les Apps si le catalogue ne quitte jamais son état de chargement.
- Une application individuelle peut signaler qu'elle n'est pas encore disponible pour la connexion.
- Si la liste des outils échoue, sélectionnez **Réessayer** dans **Détails de l'app**.
- Aucune entrée de catalogue spécifique ne doit être promise jusqu'à ce qu'elle apparaisse dans l'espace de travail actuel.
## Guides connexes
- [Aperçu des applications et intégrations](../apps-and-integrations)
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Dépanner une connexion d'application](./troubleshooting)
---
# Connecter CJ Dropshipping
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/cj-dropshipping
Connectez CJ Dropshipping lorsque vous souhaitez rechercher, importer et exploiter les produits des fournisseurs CJ avec votre propre compte CJ.
## Avant de commencer
**Chemin d'entrée :** **Projet → Dropshipping → Connecter un fournisseur**
Si votre projet utilise l'ancienne navigation, ouvrez plutôt **Opérations de la boutique → Dropshipping**. La page actuelle des applications ne répertorie pas CJ ; utilisez la saisie du fournisseur.
Vous avez besoin :
- Compte a CJ Dropshipping et sa clé API actuelle ;
- autorité pour le connecter à l'organisation ; et
- Un échantillon de produit sûr pour vérifier la connexion avant de s'y fier.
Gardez la clé API privée et saisissez-la uniquement dans la boîte de dialogue de connexion CJ de Runner. La déconnexion supprime l'autorisation du fournisseur des importations CJ appartenant au commerçant jusqu'à ce que vous vous reconnectiez.
## Contrôles et résultats CJ
| Contrôle | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| **Connecter un fournisseur** | Ouvre les choix de fournisseurs de Dropshipping. | Choisissez CJ Dropshipping pour ouvrir la configuration de la clé API. |
| **CJ Dropshipping** choix du fournisseur | Ouvre la configuration CJ à partir de Dropshipping. | Runner demande **Clé API CJ**. |
| **Clé API CJ** | Connecte votre propre compte fournisseur. | La boîte de dialogue accepte une clé non vide pour la soumission. |
| Icône oeil | Aide à vérifier une erreur de frappe. | Bascule la visibilité des clés. Cachez-le avant de partager votre écran. |
| Boîte de dialogue **Connecter** | Soumet la clé. | En cas de succès, Runner efface le champ, ferme la boîte de dialogue et marque CJ connecté. |
| **Annuler** ou fermer | Part sans se connecter. | Runner efface la clé de la boîte de dialogue. |
| Supprimer ou **Déconnecter** | Commence la suppression. | Runner ouvre une confirmation avant de supprimer la connexion. |
| Confirmation **Déconnecter** | Supprime votre clé. | Les futures opérations de recherche, d'importation, de paiement et de fournisseur autorisées par le commerçant sont bloquées jusqu'à ce qu'une connexion valide soit rétablie. |
Pour inspecter la configuration sans autoriser CJ, ouvrez le choix du fournisseur et son formulaire de clé vide, puis sélectionnez **Annuler**. La connexion et l'importation ci-dessous nécessitent votre propre compte fournisseur valide ; un aperçu du catalogue ne vérifie aucune de ces actions.
## Connectez votre compte CJ
1. Ouvrir **Projet → Dropshipping** (ou l'ancienne entrée Opérations du magasin lorsqu'elle est affichée).
2. Sélectionnez **Connecter un fournisseur**, puis choisissez **CJ Dropshipping**.
3. Copiez la clé API du compte CJ que vous souhaitez utiliser par Runner.
4. Collez-le dans **Clé API CJ**.
5. Sélectionnez **Connecter** dans la boîte de dialogue.
6. Attendez que Runner confirme la connexion.
7. Soumettez une recherche sécurisée ou ouvrez un exemple de produit CJ dans Dropshipping pour vérifier que la connexion peut accéder au catalogue prévu.
Les connexions avec les fournisseurs sont partagées par l’organisation. Dans **Gérer les fournisseurs**, vérifiez CJ et AliExpress séparément ; connecter l’un ne connecte pas l’autre.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Cet exemple montre les fournisseurs connectés existants. Il montre où inspecter chaque connexion ; aucune connexion, importation ou déconnexion n'a été effectuée pour ce guide.
## Déconnecter ou remplacer la clé
Lisez attentivement la confirmation de déconnexion. La déconnexion supprime votre clé API CJ. Il ne transfère pas de manière transparente les importations appartenant aux commerçants vers un autre compte CJ.
Après une déconnexion, les futures recherches et importations CJ nécessitent une connexion. Le paiement et l'achèvement des commandes pour les importations appartenant au commerçant concernées échouent lorsque Runner ne peut pas vérifier la connexion en direct, le produit, la variante, l'inventaire, le prix ou le fret. Reconnectez le même compte CJ et revérifiez l'élément. Si l'identité du fournisseur ou les données actives ne correspondent plus, supprimez le produit concerné et importez-le à nouveau.
Pour remplacer la clé, déconnectez la clé actuelle, confirmez que Runner ne l'affiche plus comme connectée, puis connectez la clé de remplacement. Revérifier les produits CJ existants avant d'accepter de nouvelles commandes ; changer de compte peut rendre une importation existante indisponible.
## Si CJ ne se connecte pas
- Copiez à nouveau la clé API à partir du compte CJ prévu ; ne le modifiez pas par conjecture.
- **Échec de la connexion CJ Dropshipping** signifie que Runner n'a pas accepté la connexion du fournisseur. Vérifiez la clé dans CJ et réessayez.
- Si la boîte de dialogue se ferme sans état connecté, actualisez la page actuelle avant de la soumettre à nouveau.
- Si la recherche ou l'importation échoue après la connexion, confirmez que ce compte CJ peut accéder à cette opération de catalogue.
- Si la déconnexion échoue, supposez que la clé et le contexte de compte existants restent actifs jusqu'à ce que Runner confirme la suppression.
- Si le paiement s'arrête après la reconnexion, vérifiez que le produit et les variantes appartiennent au compte CJ connecté ; réimporter l'article lorsque ce n'est pas le cas.
## Guides connexes
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Connecter l'exécution 4PX](./4px-fulfillment)
- [Dépanner une connexion d'application](./troubleshooting)
---
# Connecter, gérer et reconnecter une application
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/connect-manage-reconnect
Utilisez ce guide pour faire passer une application par son cycle de vie de connexion : démarrez la connexion,
confirmez son état réel, réparez l'autorisation si nécessaire, et déconnectez-la en toute sécurité.
**Chemin d'accès :** **Projet → Apps**
## Avant de commencer
Utilisez-le quand :
- une application indique **Connecter**, **Connexion en cours...**, **Reconnecter** ou **Examen en cours** ;
- vous devez vérifier si un flux de fournisseur précédent s'est vraiment terminé ;
- une application Agent nécessite un accès aux outils différent ; ou
- vous avez l'intention de supprimer une connexion et devez d'abord comprendre l'avertissement.
Vous avez besoin d'un accès au projet et de tout compte, identifiant ou approbation demandé par le
fournisseur externe. Certaines applications sont conditionnelles et peuvent ne pas apparaître dans chaque espace de travail.
Sur mobile, appuyez sur la ligne du fournisseur pour ouvrir sa boîte de dialogue détaillée avant de choisir **Connecter**. Les applications d'agent sont disponibles sous **Connectez vos outils** ; les fournisseurs de magasins vivent sous **Gérez votre boutique**. Pour CJ, utilisez le [guide de connexion du fournisseur](/fr/guides/apps-and-integrations/cj-dropshipping).
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Identifiez le fournisseur et son état actuel avant d’ouvrir la configuration. Les contrôles connectés existants ne constituent pas la preuve d’une nouvelle autorisation.
## Lire la carte avant d'agir
| État ou contrôle de la carte | Signification | Que faire |
| --- | --- | --- |
| Indicateur de chargement | Runner vérifie la connexion enregistrée. | Attendez avant de sélectionner une autre action. |
| **Connecter** | Runner n'a pas de connexion utilisable pour cette application. | Ouvrez la boîte de dialogue de configuration ou le flux d'autorisation du fournisseur. |
| **Connexion en cours...** | Une demande de connexion est en cours. | Terminez le flux du fournisseur ou attendez que Runner retourne un résultat. |
| **Connecté** | Runner reconnaît une connexion utilisable. | Utilisez son contrôle de gestion ou de déconnexion si vous avez besoin d'une modification. |
| **Gérer** | L'application Agent connectée dispose d'outils configurables. | Ouvrez les détails de l'application et examinez l'accès aux outils. |
| **Reconnecter** | L'autorisation est manquante, expirée ou a besoin d'attention. | Redémarrez l'autorisation. Ne supposez pas que l'ancienne connexion fonctionne toujours. |
| **Examen en cours** | Stripe a le compte mais ne l'a pas rendu prêt. | Suivez le statut ou l'avis d'action ; l'étiquette n'est pas un bouton Connecter. |
| **Continuer l'intégration** | Stripe a toujours besoin d'informations. | Continuez la configuration existante au lieu de créer un autre compte. |
| Supprimer ou **Déconnecter** | Une connexion peut être supprimée. | Lisez et confirmez l'impact spécifique au fournisseur. |
## Connecter ou réparer une connexion
1. Ouvrez **Apps** et trouvez l'application.
2. Sélectionnez **Connecter**.
3. Fournissez uniquement les champs affichés dans la boîte de dialogue. Selon l'application, cela peut être un domaine de boutique,
une clé API, une clé et un secret, des identifiants de fournisseur ou une autorisation externe.
4. Complétez l'étape du fournisseur, puis retournez à Apps.
5. Confirmez que la carte affiche maintenant un badge connecté ou les contrôles connectés du fournisseur.
Une boîte de dialogue fermée ou une fenêtre de fournisseur n'est pas une preuve de succès.
6. Si la carte affiche **Reconnecter** ou **Continuer l'intégration**, sélectionnez cette action et
continuez la connexion existante.
## Déconnectez-vous uniquement lorsque vous souhaitez supprimer l'accès
1. Pour supprimer l'application, sélectionnez son contrôle de déconnexion, lisez la confirmation et choisissez
**Déconnecter** ou **Confirmer** uniquement lorsque l'impact à l'échelle de l'espace de travail indiqué est acceptable.
2. Rouvrez les applications et confirmez que la carte est revenue à son état déconnecté.
L'enregistrement ouvre les formulaires Shippo, 4PX et Shopify vierges, puis les ferme. Aucune information d'identification n'est saisie et aucun fournisseur n'est connecté.
## Les fournisseurs Store et les applications d'agent diffèrent
Les fournisseurs sous **Gérez votre boutique** utilisent des contrôles spécifiques au fournisseur :
- **E-mail** utilise un interrupteur marche/arrêt.
- **Stripe** peut afficher l'intégration, la révision, l'action requise, le tableau de bord et la déconnexion
contrôles.
- **Shippo**, **4PX** et **Shopify** demandent une configuration spécifique au fournisseur
données et afficher une confirmation de déconnexion destructive.
## Sécurité de la connexion
- Traitez les clés et les secrets du fournisseur comme des mots de passe.
- Indique si une connexion appartient à l'espace de travail ou uniquement au projet en cours.
- Le fait de remplir la fenêtre du fournisseur A ne garantit pas que Runner a reçu un résultat utilisable.
- Ne déconnectez pas un fournisseur d'expédition, de paiement, de courrier électronique ou de traitement des commandes pendant une période active
opérations en magasin sans vérifier l'avertissement et vos commandes en cours.
- Si une déconnexion signale une erreur, actualisez et inspectez l'état actuel avant de réessayer. Ne présumez pas que le fournisseur a été supprimé.
## Guides connexes
- [Aperçu des applications et intégrations](../apps-and-integrations)
- [Connecter et contrôler les Apps Agent](./agent-apps)
- [Dépanner une connexion d'application](./troubleshooting)
---
# Activer l'e-mail de la boutique
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/resend-email
L'**E-mail** active les messages transactionnels de votre boutique lorsque le service d'e-mail
est disponible pour l'espace de travail. Utilisez-la pour les événements de la boutique qui nécessitent un message client automatisé plutôt qu'une campagne manuelle.
## Avant de commencer
**Chemin d'entrée :** **Projet → Apps → Gérez votre boutique → E-mail**
La carte est intitulée **E-mail** dans Runner. Vous n'entrez pas de clé API Resend dans ce flux.
La disponibilité peut varier selon la configuration de l'espace de travail, la préparation de la boutique et la prise en charge des e-mails.
Avant de l'activer :
- confirmez que vous travaillez dans l'espace de travail prévu ;
- examinez le contenu des e-mails destinés aux clients de la boutique lorsque cet éditeur est disponible ; et
- prévoyez de vérifier le parcours complet des e-mails avec une adresse que vous contrôlez.
Sur mobile, sélectionnez d'abord la ligne du fournisseur **E-mail** pour ouvrir ses détails, puis utilisez les commandes de cette boîte de dialogue. Un formulaire de configuration visible indique uniquement par où commencer ; les étapes de connexion et de fonctionnement du fournisseur ci-dessous s'appliquent une fois que vous avez autorisé le service.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Localisez **E-mail** sous **Gérez votre boutique**. Cet aperçu montre l'entrée ; aucun paramètre de messagerie n'a été modifié et aucun message client n'a été envoyé.
## Contrôles et résultats des e-mails
| Contrôle ou état | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| Indicateur de chargement | Empêche les modifications avant que Runner connaisse l'état enregistré. | Le commutateur apparaît après le chargement du paramètre actuel. |
| Commutateur E-mail désactivé | Indique que les notifications par e-mail de la boutique sont désactivées. | L'activer crée ou active la connexion e-mail de l'espace de travail. |
| Commutateur E-mail activé | Indique que Runner a activé l'intégration des e-mails. | Le désactiver déconnecte l'intégration. |
| État de chargement du commutateur | Indique que la modification est en cours d'enregistrement. | Les modifications supplémentaires attendent que Runner réussisse ou échoue. |
| Message de succès | Confirme que Runner a accepté le changement de paramètre. | Le commutateur reste dans le nouvel état. |
| Message d'erreur | Indique que Runner n'a pas pu activer ou désactiver l'e-mail. | Le commutateur revient à l'état enregistré pour que vous puissiez réessayer. |
## Activer l'e-mail
1. Ouvrez **Projet → Apps**.
2. Recherchez **E-mail** sous **Gérez votre boutique**.
3. Activez le commutateur.
4. Attendez **Vos clients recevront désormais des nouvelles par e-mail de votre boutique.** et confirmez que le commutateur reste activé.
5. Si Runner vous indique qu'une nouvelle publication est requise ailleurs dans le produit, publiez
la dernière version du magasin avant de tester le résultat en direct.
6. Déclenchez un événement de magasin approprié avec des données de test sûres et confirmez que le message arrive.
## Désactiver l'e-mail
Désactivez le commutateur uniquement après avoir vérifié si d'autres magasins de l'espace de travail dépendent de la
même connexion. Runner affiche **Vos clients ne recevront plus de nouvelles par e-mail de votre boutique.** après le succès de la modification.
Si l'enregistrement échoue, Runner affiche une erreur et restaure l'état précédent.
Désactiver l'intégration ne décrit pas ce qui arrive aux messages déjà envoyés. Cela change uniquement
si Runner peut utiliser la connexion e-mail actuelle pour les événements futurs de la boutique.
## Si l'e-mail ne fonctionne pas
- Si la carte continue de charger, actualisez les Apps avant de modifier à nouveau le commutateur.
- Si l'activation échoue, vérifiez que l'e-mail est disponible pour l'espace de travail et réessayez une fois.
- Si le commutateur est activé mais aucun message n'arrive, vérifiez l'événement du magasin, l'adresse du destinataire,
la configuration du message et la dernière version publiée.
- Vérifiez le spam ou le filtrage en utilisant une adresse que vous contrôlez ; ne testez pas avec la commande d'un vrai client.
- Si la désactivation échoue, supposez que l'état précédent est toujours actif.
## Guides connexes
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Dépanner une connexion d'application](./troubleshooting)
- [Aperçu des applications et intégrations](../apps-and-integrations)
---
# Connecter Shippo pour l'expédition
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/shippo-shipping
Connectez Shippo lorsque vous souhaitez que Runner utilise votre compte Shippo pour l'expédition et
l'exécution. La connexion utilise une clé API fournie par Shippo.
## Avant de commencer
**Chemin d'entrée :** **Projet → Apps → Gérez votre boutique → Shippo**
Vous avez besoin :
- d'un compte Shippo et d'une clé API Shippo actuelle ;
- l'autorisation de connecter ce compte à cette boutique Runner ; et
- la conscience que déconnecter Shippo supprime sa clé et le désactive uniquement pour cette boutique. Les autres boutiques conservent leur propre connexion Shippo.
Ne collez pas la clé API dans le chat ou la documentation.
Sur mobile, sélectionnez d'abord la ligne du fournisseur **Shippo** pour ouvrir ses détails, puis utilisez les commandes de cette boîte de dialogue. Un formulaire de configuration visible indique uniquement par où commencer ; les étapes de connexion et de fonctionnement du fournisseur ci-dessous s'appliquent une fois que vous avez autorisé le service.
## Contrôles et résultats Shippo
| Contrôle | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| **Connecter** | Ouvre la configuration Shippo. | Runner demande **Clé API Shippo**. |
| **Clé API Shippo** | Identifie votre compte Shippo. | Runner vérifie le format de la clé et affiche une erreur tant que la valeur est invalide. |
| Icône d'œil | Vous permet d'inspecter la valeur pour les erreurs de frappe. | Bascule le champ entre le texte caché et visible. Masquez-le à nouveau avant de partager votre écran. |
| Boîte de dialogue **Connecter** | Soumet la clé. | En cas de succès, Runner ferme la boîte de dialogue, efface le champ et change la carte en connectée. |
| **Annuler** ou fermer | Quitte la configuration sans soumettre. | Runner efface la clé entrée de la boîte de dialogue. |
| Supprimer ou **Déconnecter** | Lance la suppression. | Runner ouvre **Déconnecter Shippo ?** pour cette boutique. |
| Confirmation **Déconnecter** | Supprime la connexion de cette boutique. | Runner supprime la clé API de cette boutique et y désactive Shippo. Les autres boutiques ne sont pas affectées. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg2lkPdDEah7FSPqAV903v8Lem6fdQJcxZEiXo)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Le formulaire vide indique à qui appartient une clé Shippo. Sélectionnez **Annuler** pour quitter sans soumettre les informations d'identification ; les opérations d'expédition nécessitent un contrôle séparé après la connexion.
## Connecter Shippo
1. Ouvrez **Projet → Apps**.
2. Trouvez **Shippo** et sélectionnez **Connecter**.
3. Copiez la clé API du compte Shippo que vous avez l'intention d'utiliser.
4. Collez-la dans **Clé API Shippo**.
5. Si Runner signale une clé invalide, retournez à Shippo et copiez-la à nouveau plutôt que d'éditer
le secret par supposition.
6. Sélectionnez **Connecter** dans la boîte de dialogue.
7. Attendez le message de succès et confirmez que la carte affiche son contrôle de déconnexion connecté.
8. Utilisez des données de test sûres pour vérifier le flux d'expédition avant de compter sur lui pour les commandes des clients.
## Déconnecter ou remplacer la clé
Sélectionnez le contrôle de déconnexion de la carte et lisez **Déconnecter Shippo ?**. Ne confirmez que s'il est acceptable de supprimer la clé et de désactiver Shippo pour cette boutique. Les autres boutiques de l'espace de travail conservent leur propre connexion.
Pour utiliser une clé différente, déconnectez l'intégration actuelle, confirmez que la carte n'est plus connectée,
puis complétez le flux de connexion avec la clé de remplacement.
## Si Shippo ne se connecte pas
- **Clé API invalide** signifie que la valeur ne correspond pas au format de clé Shippo accepté.
- **Impossible de connecter Shippo : vérifiez la clé API et réessayez.** signifie que Runner n'a pas terminé la connexion du fournisseur. Gardez
la clé privée, confirmez qu'elle est actuelle dans Shippo et réessayez à partir de la carte.
- Si la boîte de dialogue se ferme mais la carte ne se connecte pas, actualisez les Apps avant de soumettre à nouveau.
- Si la déconnexion échoue, supposez que la clé existante est toujours active.
- Une carte connectée ne prouve pas que les tarifs, les étiquettes, les transporteurs ou un envoi spécifique
fonctionnent. Vérifiez ces opérations séparément avec des données de test sûres.
## Guides connexes
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Connecter l'exécution 4PX](./4px-fulfillment)
- [Dépanner une connexion d'application](./troubleshooting)
---
# Connecter Shopify
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/shopify
Connectez Shopify lorsque votre vitrine ou votre flux de travail Runner a besoin d'accès à un
magasin Shopify existant. Runner démarre l'autorisation à partir du domaine `myshopify.com` du magasin et
Shopify vous demande d'installer et d'autoriser l'application Runner.
## Avant de commencer
**Chemin d'entrée :** **Projet → Apps → Gérez votre boutique → Shopify**
Vous pouvez également choisir **Connecter Shopify** lors de la création d'un magasin à partir de l'espace de travail. Ce
guide se concentre sur la carte de connexion sous Applications.
Vous avez besoin :
- de la disponibilité de l'intégration Shopify dans l'espace de travail ;
- d'un domaine de magasin Shopify au format `your-store.myshopify.com` ;
- de la permission d'installer et d'autoriser l'application Runner dans ce magasin Shopify ; et
- de l'autorité pour connecter le magasin à l'espace de travail Runner.
Un espace de travail qui a déjà un magasin Shopify connecté peut vous demander de le déconnecter
avant de connecter un autre.
Sur mobile, sélectionnez d'abord la ligne du fournisseur **Shopify** pour ouvrir ses détails, puis utilisez les commandes de cette boîte de dialogue. Un formulaire de configuration visible indique uniquement par où commencer ; les étapes de connexion et de fonctionnement du fournisseur ci-dessous s'appliquent une fois que vous avez autorisé le service.
## Contrôles et résultats Shopify
| Contrôle | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| **Connecter** | Ouvre la configuration Shopify. | Runner demande le **Domaine de la boutique**. |
| **Domaine de la boutique** | Identifie le magasin Shopify exact. | Runner accepte le format `your-store.myshopify.com` et affiche une erreur pour un domaine invalide. |
| **Continuer vers Shopify** | Démarre l'autorisation du fournisseur. | Runner redirige vers Shopify pour installer l'application Runner et autoriser l'accès. |
| **Annuler** ou fermer | S'arrête avant l'autorisation. | Runner ferme la boîte de dialogue et efface le domaine saisi. |
| **Connexion en cours...** | Indique que la redirection d'autorisation commence. | L'action reste indisponible pendant que Runner se rend vers Shopify. |
| Supprimer ou **Déconnecter** | Démarre la suppression. | Runner ouvre **Déconnecter Shopify ?**. |
| Confirmation **Déconnecter** | Supprime la connexion Shopify de Runner. | Runner supprime le jeton de vitrine Shopify de tous les projets de l'espace de travail. Le magasin Shopify et ses commandes ne sont pas supprimés. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgzy8MJHxvQbMAZ2hlg7w6ye8S5vnLIHkGPOqr)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Entrez le domaine permanent Shopify lorsque vous êtes prêt à autoriser l'accès. Cet exemple s'arrête avant **Continuer vers Shopify**.
## Connecter Shopify
1. Ouvrez **Projet → Apps** et trouvez **Shopify**.
2. Sélectionnez **Connecter**.
3. Entrez le domaine `myshopify.com` exact du magasin dans **Domaine de la boutique**.
4. Corrigez tout message de domaine invalide avant de continuer.
5. Sélectionnez **Continuer vers Shopify**.
6. Sur Shopify, vérifiez le nom du magasin et l'accès demandé avant d'autoriser l'application Runner.
7. Retournez à Runner et confirmez que la carte Shopify affiche son contrôle de déconnexion connecté.
8. Vérifiez les données du magasin prévues et le chemin de paiement avant d'apporter des modifications en direct.
## Déconnecter ou changer de magasin
Sélectionnez le contrôle de déconnexion et lisez **Déconnecter Shopify ?**. La confirmation supprime le
jeton de vitrine Shopify de tous les projets de l'espace de travail. Elle ne supprime pas le
magasin Shopify ou les commandes Shopify existantes.
Pour connecter un autre magasin Shopify, déconnectez d'abord la connexion de l'espace de travail existant,
confirmez que la carte n'est plus connectée, puis répétez la configuration avec le domaine de l'autre magasin.
## Si Shopify ne se connecte pas
- Utilisez le domaine permanent `myshopify.com`, pas un domaine de vitrine personnalisé.
- Si Runner indique que l'espace de travail a déjà un magasin connecté, examinez cette connexion
avant de la supprimer.
- Si Shopify rejette l'autorisation, recommencez à partir de la carte Shopify.
- Si le magasin retourné ne correspond pas au domaine que vous avez saisi, arrêtez et vérifiez quel
compte Shopify et quel magasin sont ouverts.
- Si le lien de connexion a expiré, recommencez à partir de **Connecter** plutôt que de réutiliser l'ancienne
page du fournisseur.
- Si Runner signale que l'accès requis est manquant, examinez les permissions de l'application dans Shopify.
- Si la déconnexion échoue, supposez que la connexion existante est toujours active.
## Guides connexes
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Dépanner une connexion d'application](./troubleshooting)
- [Aperçu des applications et intégrations](../apps-and-integrations)
---
# Connecter Stripe pour les paiements
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/stripe-payments
Connectez Stripe lorsque vous souhaitez qu'un magasin Runner publié accepte les paiements des clients. Runner
affiche l'état de la connexion, tandis que Stripe collecte et examine les informations commerciales
nécessaires pour l'accès aux paiements et aux versements.
## Avant de commencer
**Chemin d'entrée :** **Projet → Applications → Gérer votre boutique → Stripe**
Après la publication, Runner peut également afficher **Connecter Stripe** dans l'étape post-publication du magasin. Ce bouton
ouvre le même parcours de configuration des paiements.
Vous avez besoin :
- de la permission de gérer la connexion de l'espace de travail ;
- des informations commerciales et d'identité que Stripe demande ; et
- d'un navigateur qui permet à la fenêtre de configuration Stripe de s'ouvrir.
La vitrine peut être publiée tandis que le paiement est toujours en pause ou en cours de vérification. Une URL de magasin en direct
n'est pas la preuve que les paiements sont disponibles.
Sur mobile, sélectionnez d'abord la ligne du fournisseur **Stripe** pour ouvrir ses détails, puis utilisez les commandes de cette boîte de dialogue. Un formulaire de configuration visible indique uniquement par où commencer ; les étapes de connexion et de fonctionnement du fournisseur ci-dessous s'appliquent une fois que vous avez autorisé le service.
## Contrôles et résultats Stripe
| Contrôle ou état | Pourquoi c'est utile | Que se passe-t-il ensuite |
| --- | --- | --- |
| **Connecter** | Démarre l'intégration des paiements. | Runner ouvre un flux de configuration hébergé par Stripe dans une nouvelle fenêtre. |
| **Connexion en cours...** | Indique que Runner prépare le compte Stripe ou le lien de configuration. | L'action reste indisponible jusqu'à ce que Runner renvoie un résultat. |
| **Reconnecter** | Reprend un compte qui existe mais n'est pas prêt. | Runner ouvre un nouveau lien d'intégration pour le compte existant. |
| **Examen en cours** | Indique que Stripe examine les détails soumis. | L'étiquette est informative ; suivez tout avis d'action distinct. |
| **Actions Stripe requises** | Liste les informations ou vérifications qui nécessitent une attention. | Examinez les détails **À fournir maintenant**, **À fournir plus tard**, **Examen en cours**, **Paiements suspendus** ou **Versements suspendus**. |
| **Continuer l'intégration** | Complète les exigences Stripe en attente. | Runner ouvre Stripe pour le compte existant. |
| Icône **Ouvrir le tableau de bord Stripe** | Permet de gérer un compte Stripe activé. | Ouvre le tableau de bord du compte Stripe connecté dans un nouvel onglet. |
| Icône de suppression | Lance la déconnexion. | Ouvre **Déconnecter Stripe ?** au lieu de déconnecter immédiatement le compte. |
| **Déconnecter** | Confirme la déconnexion de Stripe dans Runner. | Runner déconnecte Stripe de l'espace de travail. Les commandes existantes ne sont pas affectées. |
## Connecter Stripe
1. Ouvrez **Projet → Apps**.
2. Recherchez **Stripe** sous **Gérez votre boutique**.
3. Sélectionnez **Connecter**. Runner ouvre Stripe dans une nouvelle fenêtre.
4. Effectuez uniquement les étapes indiquées par Stripe.
5. Revenez à Runner et rouvrez les applications.
6. Confirmez que la carte affiche ses commandes connectées et que Runner signale la configuration du paiement comme
prêt avant d'attendre le paiement pour accepter les paiements.
7. Si vous voyez **Reconnecter**, **Continuer l'intégration**, **Examen en cours** ou **Stripe
actions requises**, suivez cet état au lieu de recommencer.
8. Testez le paiement en direct uniquement après que Runner signale que la configuration du paiement est prête.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgdRbFueMh3McYFndyrWQxNbi4IRHOVuEC8JtX)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Une connexion existante peut afficher ces commandes de gestion. Cette capture ne vérifie ni le passage en caisse, ni les paiements, ni les virements ; elle montre où examiner la connexion.
## Comprendre le résultat
| État | Ce que cela signifie pour vous |
| --- | --- |
| Non connecté | Le passage en caisse nécessite encore un fournisseur de paiement. |
| Reconnexion requise | Un compte Stripe existe, mais son autorisation ou son intégration est incomplète. |
| Examen en cours | Stripe a reçu les informations, mais le compte n'est pas encore prêt. |
| Actions requises | Stripe a besoin de certaines informations ; les paiements ou les versements peuvent être suspendus. |
| Connecté | Runner reconnaît la connexion Stripe. Vérifiez le passage en caisse sur la boutique en ligne avant d'annoncer que les paiements sont disponibles. |
## Déconnecter ou reconnecter
Pour déconnecter, sélectionnez l'icône de suppression, lisez **Déconnecter Stripe ?**, puis choisissez
**Déconnecter**. La confirmation indique que les commandes existantes sont conservées. Les nouveaux paiements
peuvent rester indisponibles jusqu'à ce qu'une connexion de paiement utilisable soit rétablie.
Pour reconnecter, sélectionnez **Reconnecter** ou **Continuer l'intégration**. Runner réutilise le compte existant si possible ; ne créez pas de deuxième configuration simplement parce que la première fenêtre du fournisseur
a été fermée.
## Si Stripe ne se connecte pas
- Si la fenêtre de configuration se ferme prématurément, revenez dans **Applications** et utilisez **Reconnecter**.
- Si Runner affiche **Actions Stripe requises**, complétez les exigences du fournisseur listées.
- Si le compte reste **Examen en cours**, ne créez pas à plusieurs reprises de nouvelles tentatives d'intégration.
- Si Runner affiche une erreur de connexion ou de lien, réessayez à partir de la carte Stripe après avoir vérifié
que votre navigateur autorise l'ouverture de la nouvelle fenêtre.
- N'envoyez jamais de documents d'identité, d'identifiants de compte ni d'informations de paiement dans le chat Runner.
## Guides connexes
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Dépanner les connexions d'application](./troubleshooting)
- [Applications et intégrations](../apps-and-integrations)
---
# Dépanner les connexions d'application
Source: https://www.runnerai.com/docs/fr/guides/apps-and-integrations/troubleshooting
Utilisez ce guide lorsqu'une application ne se charge pas, ne se connecte pas, ne se reconnecte pas, n'enregistre pas son accès aux outils ou
ne se déconnecte pas comme prévu. Commencez par l'état que Runner affiche réellement plutôt que de répéter aveuglément un
flux de fournisseur.
**Chemin d'accès :** **Projet → Apps**
## Avant de commencer
1. Confirmez que vous avez ouvert les applications pour le projet et l'espace de travail prévus.
2. Effacer **Rechercher des outils** et tout filtre de catégorie d'applications d'agent.
3. Ractualisez la page une fois et attendez que les états de connexion se chargent.
4. Lire l'état exact de la carte : **Connecter**, **Connexion en cours...**, **Connecté**, **Reconnecter**,
**Examen en cours**, ou un avis d'action requise.
5. Ouvrez uniquement l'action de récupération qui correspond à cet état.
6. N’incluez jamais de clé API, de secret, de document d’identité, de détails de paiement ou de fournisseur complet
URL de rappel dans un message d'assistance ou une capture d'écran.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgJFpud5MziL9zFEdkGCVveD1jTZUlSay3IctK)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La recherche réduit le catalogue d'outils. Si votre outil est manquant, effacez la recherche et les filtres avant de demander une application ; un résultat de recherche n'est pas une connexion autorisée.
## Contrôles et résultats importants
| Contrôle | Que se passe-t-il après l'avoir sélectionné |
| --- | --- |
| **Effacer la recherche** | Supprime la recherche Apps Agent actuelle afin que le catalogue disponible puisse réapparaître. |
| **Connecter** / **Connecter et autoriser** | Ouvre le flux de configuration ou d'autorisation externe pour cette application. |
| **Reconnecter**, quand affiché | Redémarre l'autorisation pour une connexion de fournisseur existante. |
| **Réessayer** | Répète la demande de catalogue, de liste d'outils ou de connexion échouée affichée par le panneau actuel. |
| **Continuer l'intégration** | Retourne au flux d'intégration Stripe existant lorsqu'une action est requise. |
| **Déconnecter** | Ouvre une confirmation ou démarre le flux de suppression documenté ; vérifiez l'état enregistré avant de modifier les identifiants du côté du fournisseur. |
## Tableau des symptômes et récupération
| Ce que vous voyez | Signification probable | Action sûre suivante |
| --- | --- | --- |
| L'application est manquante | La recherche, une catégorie, l'accès à l'espace de travail ou une fonctionnalité conditionnelle la masque. | Effacez la recherche, choisissez **Tout**, puis confirmez que la fonctionnalité est disponible pour cet espace de travail. |
| La carte continue de se charger | Runner n'a pas résolu la connexion enregistrée. | Actualisez Applications une fois. Évitez de soumettre une autre connexion pendant que l'état est inconnu. |
| **Aucune application trouvée** | Aucune application Agent ne correspond aux filtres actuels. | Sélectionnez **Effacer la recherche**. |
| **Connecter** ne fait rien | Un champ obligatoire est vide ou invalide, ou le flux du fournisseur n'a pas pu démarrer. | Lisez les erreurs de champ, recopiez la valeur requise et autorisez les fenêtres contextuelles du fournisseur le cas échéant. |
| **Connexion en cours...** ne se termine pas | L'autorisation externe a été fermée, bloquée ou n'a jamais retourné de résultat. | Retournez à Applications, actualisez l'état, puis utilisez **Reconnecter** si Runner l'offre. |
| Le fournisseur dit succès mais Runner ne le dit pas | Runner n'a pas confirmé une connexion utilisable. | Rouvrez Applications. Traitez uniquement **Connecté** comme succès ; utilisez **Reconnecter** au lieu de créer des doublons. |
| **Reconnecter** | L'autorisation existante nécessite une attention. | Sélectionnez-la et complétez le flux du fournisseur à nouveau. |
| **Examen en cours** | Stripe examine les détails soumis. | Suivez les avis d'action ; ne démarrez pas un autre compte simplement pour supprimer l'étiquette. |
| **Actions Stripe requises** | Stripe a besoin d'informations ou a mis en pause une capacité. | Examinez les détails **À fournir maintenant**, **À fournir plus tard**, **Examen en cours**, paiement et versement, puis utilisez **Continuer l'intégration** quand affiché. |
| Clé API ou secret rejeté | La valeur est incorrecte, expirée, provient du mauvais compte ou n'est pas acceptée pour cette intégration. | Recopiez-la à partir du fournisseur. Ne modifiez pas les secrets par supposition. |
| Domaine Shopify invalide | La valeur n'est pas le domaine permanent du magasin Shopify. | Utilisez `your-store.myshopify.com`, pas un domaine de vitrine personnalisé. |
| La fenêtre d'autorisation de l'application Agent est bloquée | Le navigateur a empêché le flux externe. | Autorisez les fenêtres contextuelles pour Runner et démarrez **Connecter et autoriser** à nouveau. |
| Les outils de l'application Agent ne se chargent pas | Runner n'a pas pu récupérer la liste des outils de cette application. | Sélectionnez **Réessayer** dans **Détails de l'app**. |
| Le commutateur d'outil signale un échec | Le nouveau paramètre d'outil n'a pas été enregistré. | Attendez que le commutateur s'actualise, confirmez son état actuel, puis réessayez une fois. |
| La déconnexion signale un échec | Runner n'a pas confirmé la suppression. | Supposez que la connexion existante est toujours active et rouvrez Applications avant de réessayer. |
## Vérifications spécifiques au fournisseur
### Stripe
- Continuez une tentative d'intégration existante avec **Reconnecter** ou **Continuer l'intégration**.
- Lisez les exigences d'action au lieu de vous fier uniquement à la couleur de la carte.
- Une vitrine publiée peut toujours avoir des paiements en pause ou indisponibles.
- Utilisez l'action du tableau de bord Stripe uniquement après que Runner ait un compte associé.
### E-mail
- Un changement de commutateur échoué revient à l'état enregistré.
- Un commutateur activé ne prouve pas qu'un e-mail particulier a été livré.
- Vérifiez l'événement du magasin, le destinataire, la configuration de l'e-mail et la version actuellement publiée
avec des données de test sûres.
### Shippo
- Recopiez la clé API Shippo à partir du compte prévu.
- Une carte connectée ne vérifie pas les tarifs, les transporteurs, les étiquettes ou la création d'expédition.
### Shopify
- Utilisez le domaine permanent `myshopify.com`.
- Si un espace de travail a déjà un magasin connecté, examinez-le avant de déconnecter.
- Redémarrez l'autorisation lorsque le lien de connexion expire ou que le magasin retourné ne correspond pas au domaine que vous avez saisi.
### CJ Dropshipping
- Confirmez que la clé API appartient au compte CJ que vous avez l'intention d'utiliser.
- Après la déconnexion, les futures recherches, importations, commandes et opérations CJ avec votre compte marchand sont bloquées jusqu'au rétablissement d'une connexion valide.
- Reconnectez le même compte CJ et vérifiez les importations existantes. Si l'identité fournisseur ou les données en direct d'un article ne correspondent plus, supprimez-le et importez-le à nouveau.
### 4PX
- Confirmez que la clé API et le secret appartiennent au même compte et sont dans les champs corrects.
- Une carte connectée ne prouve pas qu'une destination ou une commande est admissible à l'exécution.
### Apps Agent
- La section entière ou une application individuelle peut être conditionnellement indisponible.
- Effacez les filtres avant de traiter une application comme absente.
- Examinez les commutateurs d'outils avant de reconnecter ; n'accordez pas plus d'accès simplement pour faciliter la configuration.
## La déconnexion a échoué ou a produit un résultat incertain
1. Gardez le compte du fournisseur et les opérations du magasin actuelles inchangés.
2. Rouvrez **Projet → Apps** et vérifiez l'état de la carte.
3. S'il affiche toujours connecté, traitez la connexion comme active.
4. Ne supprimez pas les identifiants du côté du fournisseur jusqu'à ce que vous compreniez si le paiement actif, l'e-mail, l'expédition, le fournisseur ou le travail d'exécution en dépend toujours.
5. Réessayez la déconnexion Runner uniquement après que l'état soit clair.
## Demander de l'aide en toute sécurité
Fournissez :
- le nom de l'application ;
- l'état visible exact et le texte d'erreur ;
- si le problème se produit lors de la connexion, du retour, de la gestion des outils ou de la déconnexion ;
- l'URL du projet sans valeurs de requête secrètes ; et
- une capture d'écran respectueuse de la vie privée si elle montre matériellement le problème.
Ne fournissez pas la clé API réelle, le secret, le mot de passe du fournisseur, le document d'identité, les détails de paiement,
les données client ou les paramètres d'autorisation masqués.
Si l'outil souhaité est toujours absent après avoir effacé la recherche et les filtres, utilisez **Demander une app** (ou **Demander cette app** dans le résultat vide). Le formulaire demande l'assistance d'un fournisseur ; il ne le connecte pas. Pour les problèmes de connexion CJ, ouvrez [Configuration du fournisseur Dropshipping](/fr/guides/apps-and-integrations/cj-dropshipping).
## Guides connexes
- [Aperçu des applications et intégrations](../apps-and-integrations)
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Connecter et contrôler les Apps Agent](./agent-apps)
---
# Automatiser, tester et créer
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create
Ouvrez **Développer** pour les automatisations, Creative Studio, la médiathèque et les publicités. Ouvrez **Mesurer** pour la simulation et les expériences. Ces guides vous guident de la configuration à l'examen du travail résultant.
> **Disponibilité :** Chaque fonctionnalité de cette section peut dépendre d'un plan, d'un accès à l'espace de travail, d'un rôle, d'un état de magasin, de crédits, de données ou d'une connexion de fournisseur. Une entrée manquante est un état de disponibilité, pas une preuve que le projet est cassé.
| Objectif | Commencez ici |
| --- | --- |
| Trouver et comprendre les travaux récurrents | [Automatisations](/fr/guides/automate-test-and-create/automations) |
| Activer une automatisation ou personnaliser son e-mail | [Créer et gérer les automatisations](/fr/guides/automate-test-and-create/create-and-manage-automations) |
| Configurer un test shopper ou, si disponible, une prédiction de campagne | [Simulation](/fr/guides/automate-test-and-create/simulations) |
| Lire les parcours, l'entonnoir, les résultats et les recommandations | [Exécutions et résultats de simulation](/fr/guides/automate-test-and-create/simulation-runs-and-results) |
| Démarrer une expérience de magasin contrôlée | [Expériences](/fr/guides/automate-test-and-create/experiments) |
| Lire la performance et décider ce qu'il faut appliquer | [Mesure des expériences](/fr/guides/automate-test-and-create/experiment-measurement) |
| Générer ou modifier des images et des vidéos | [Creative Studio](/fr/guides/automate-test-and-create/creative-studio) |
| Trouver et réutiliser les médias générés | [Bibliothèque de médias](/fr/guides/automate-test-and-create/media-library) |
| Connecter les comptes publicitaires et comprendre les campagnes | [Runner Ads](/fr/guides/automate-test-and-create/runner-ads) |
| Examiner la performance créative et enregistrer l'inspiration | [Créatifs publicitaires et tendances](/fr/guides/automate-test-and-create/ad-creatives-and-trending) |
---
# Créatifs publicitaires et tendances
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/ad-creatives-and-trending
Les Créatifs vous aident à comparer les médias des campagnes connectées, tandis que les Tendances vous aident à découvrir et organiser l'inspiration publicitaire publique.
> **Conditionnel :** Les deux pages se trouvent derrière la disponibilité des annonces Runner et l'accès au plan. Les performances des créations nécessitent un compte connecté pris en charge et des données de campagne renvoyées. **Tendances** peut rechercher dans la bibliothèque publique Meta ou TikTok sans connecter votre compte publicitaire ; ses résultats dépendent de la source de découverte externe.
## Chemins d'accès
- Projet Store → **Développer** → **Publicités** → **Créatifs**.
- Projet Store → **Développer** → **Publicités** → **Tendances**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEooJlJchdR6T0uwqnz73letZimQpFvYfSrhL)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Trending ouvre une recherche dans une bibliothèque publique. Les résultats de recherche et les performances des campagnes connectées sont des ensembles de données différents.
## Avant de commencer
- Confirmez que l'espace de travail et le plan peuvent ouvrir Runner Ads.
- Connectez un compte Google ou Meta autorisé avant de vous attendre à des données de performance créative.
- Choisissez une question de performance ou un thème d'inspiration pour que les filtres restent utiles.
- Traitez les données de tendances externes comme du matériel de référence, pas comme le résultat mesuré de votre magasin.
## Contrôles créatifs et résultats de clic
| Contrôle | Que se passe-t-il après l'avoir sélectionné |
| --- | --- |
| Plage de temps | Actualise les métriques créatives pour la semaine, le mois ou une période récente plus large. |
| Sélecteur de compte | Filtre les données créatives lorsque plusieurs comptes pris en charge sont connectés. |
| Trier | Ordonne les cartes par dépense, retour sur dépense publicitaire, clics, impressions, revenus, score de clic ou score de conversion. |
| Puces de métrique | Ajoute, supprime ou réordonne les métriques affichées sur les cartes créatives. |
| Carte créative | Ouvre l'aperçu créatif et les détails de performance disponibles. |
## Examiner les créatifs connectés
1. Ouvrez **Publicités** → **Créatifs**.
2. Si l'invite de connexion apparaît, connectez d'abord le compte Google ou Meta autorisé.
3. Sélectionnez la fenêtre de rapport et le compte.
4. Choisissez le tri qui correspond à votre question.
5. Gardez un petit ensemble de puces de métrique visibles pour que les comparaisons restent lisibles.
6. Ouvrez une carte créative pour inspecter l'actif et ses métriques disponibles.
7. Comparez plusieurs créatifs avant de décider qu'une image ou une vidéo a causé le résultat.
## Contrôles de tendances et résultats de clic
| Contrôle | Que se passe-t-il après l'avoir sélectionné |
| --- | --- |
| **Meta** / **TikTok** | Bascule la bibliothèque d'annonces externe en cours de navigation. |
| **Rechercher** par mot-clé | Demande des annonces correspondant au mot-clé soumis. |
| Pays, média, statut ou filtres de temps | Affine la bibliothèque actuelle lorsqu'elle est prise en charge par cette source. |
| Trier | Réordonne les résultats en utilisant le signal de récence, d'impression, de publication ou de portée disponible. |
| **Effacer** | Supprime les filtres actifs et revient à la requête de bibliothèque par défaut. |
| Carte d'annonce | Ouvre un aperçu plus grand avec les détails retournés par la source. |
| **Index des impressions** dans un détail Meta | Affiche l'index non négatif fourni pour cet instantané externe lorsqu'un est disponible. Ce n'est pas la performance de campagne mesurée de votre magasin. |
| Étoile / **Save to collection** | Ouvre les collections existantes pour l'instantané d'annonce. |
| **New collection** | Crée une collection nommée et enregistre l'annonce sélectionnée après succès. |
| **Collections** | Ouvre l'inspiration enregistrée ; sélectionner une collection affiche ses instantanés d'annonce enregistrés. |
| **Retour aux tendances** | Revient de la vue collections à la vue découverte. |
## Enregistrer l'inspiration publicitaire
1. Ouvrez **Publicités** → **Tendances**.
2. Choisissez **Meta** ou **TikTok**.
3. Recherchez un produit, un public ou un thème de message.
4. Affinez les résultats avec uniquement les filtres nécessaires pour la question.
5. Ouvrez une annonce pour l'inspecter.
6. Sélectionnez l'étoile pour ouvrir **Save to collection**.
7. Choisissez une collection existante ou créez-en une nouvelle clairement nommée.
8. Ouvrez **Collections** pour confirmer que l'instantané a été enregistré.
## Dépannage
| État | Signification et étape suivante |
| --- | --- |
| Invite de connexion dans Créatifs | Aucun compte de performance pris en charge n'est connecté. Complétez d'abord la connexion. |
| Grille créative vide | Le compte, la période ou le fournisseur sélectionné n'a retourné aucun créatif. Élargissez le filtre et confirmez que les campagnes existent. |
| Résultats de tendances vides | Effacez les filtres ou utilisez un mot-clé plus large ; la source peut ne pas avoir de données correspondantes. |
| Le détail Meta n'a pas d'**Index des impressions** | L'instantané externe actuel n'a pas de valeur utilisable. Manquant ne signifie pas zéro. |
| Collection vide | Aucun instantané enregistré n'est dans cette collection. Retournez aux Tendances et enregistrez une annonce. |
| L'enregistrement a échoué | L'instantané ou la collection n'a pas été confirmé. Réessayez après avoir rechargé la carte source. |
| Annonce de tendance forte | C'est une inspiration, pas la preuve que le même créatif fonctionnera pour votre magasin. Créez et mesurez votre propre campagne séparément. |
## Vérifiez ce que représente la carte
Dans **Créatifs**, confirmez le compte et la période sélectionnés avant de comparer les statistiques d'une carte. Dans **Tendances**, confirmez la bibliothèque externe et les filtres avant de traiter une annonce comme une source d'inspiration pertinente.
**Point de contrôle :** Un élément d'inspiration enregistré apparaît dans la collection sélectionnée après une sauvegarde réussie. Il s'agit d'un instantané de référence, pas d'une campagne que vous avez publiée ou d'un résultat mesuré pour votre boutique.
## Guides connexes
- [Runner Ads](./runner-ads)
- [Creative Studio](./creative-studio)
- [Bibliothèque de médias](./media-library)
---
# Automatisations
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/automations
Les automatisations vous aident à identifier les tâches récurrentes que Runner peut effectuer lorsqu'un déclencheur répertorié se produit.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **Automatisations**.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgUokxtnwmWbL01zqS4swQkOHahZevAM9fnVpR)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Les cartes d'automatisation affichent leur état configuré. Un badge Live à lui seul ne confirme pas une exécution ou une livraison par e-mail.
## Avant de commencer
- **Order Confirmation**, **Welcome Email** et **Account Closed Email** fonctionnent avec tous les forfaits. Les autres automatisations nécessitent un forfait qui les inclut ; sinon, les activer ouvre une invitation à passer à un forfait supérieur.
- Chaque carte d'automatisation a sa propre disponibilité et son propre statut.
- Activer une automatisation ne l'exécute pas immédiatement ; elle attend le déclencheur décrit par cette automatisation.
## Contrôles de bibliothèque et résultats de clic
| Contrôle | Que se passe-t-il après l'avoir sélectionné |
| --- | --- |
| **Recherche** | Filtre les cartes par mots dans le nom ou la description de l'automatisation. |
| **Tout** ou une catégorie | Affiche toutes les automatisations ou uniquement les cartes de catégories telles que **Gestion des clients**, **Opérations de la boutique** ou **Rapports et analyses**. Les catégories disponibles dépendent de la bibliothèque affichée. |
| Filtre d'état | Affiche les cartes **Tous les états**, **En direct**, **En pause**, **Bloqué par le plan** ou **À venir**. |
| Commutateur de carte | Demande **En direct** quand activé et **En pause** quand désactivé, si l'automatisation est disponible. |
| Bouton Info | Ouvre **Détails de l'automatisation** avec description, statut, catégorie et dernière exécution. |
| Bouton Modifier | Ouvre **Composer un e-mail** pour les automatisations qui prennent en charge un modèle d'e-mail. |
| **Réessayer** | Recharge la bibliothèque après un échec de chargement. |
> **Taille d'écran :** Les boutons d'information et de modification d'e-mail sont affichés sur les mises en page de bureau plus larges. Si vous ne les voyez pas sur un écran de la taille d'un téléphone, rouvrez **Automatisations** dans une fenêtre plus large.
## Trouver la bonne automatisation
1. Ouvrez **Automatisations**.
2. Recherchez le résultat dont vous avez besoin, comme un message client ou un rapport.
3. Affinez la liste avec une catégorie lorsque le résultat est large.
4. Utilisez le filtre d'état pour trouver les éléments en direct ou bloqués.
5. Sélectionnez le bouton info sur une carte.
6. Lisez la description, le statut, la catégorie et la dernière exécution avant de modifier le commutateur.
7. Si un bouton de modification d'e-mail apparaît, examinez le modèle avant d'activer l'automatisation.
## Significations du statut
| Statut | Signification et étape suivante |
| --- | --- |
| **En direct** | L'automatisation est activée et attend son déclencheur. Cela ne signifie pas qu'elle a déjà été exécutée. |
| **En pause** | L'automatisation est disponible mais ne démarrera pas de nouveau travail déclenché jusqu'à son activation. |
| **Bloqué par le plan** | Le forfait actuel empêche l'automatisation de s'exécuter. Examinez l'accès avant de vous y fier. |
| **À venir** | La carte est visible pour la découverte mais ne peut pas être activée. |
| **Jamais exécuté** ou **Dernière exécution —** | Aucune durée d'exécution terminée n'est disponible pour ce projet. |
## Dépannage
- Si aucune carte ne correspond, effacez **Recherche**, choisissez **Tous** et choisissez **Tous les états**.
- Si un commutateur est désactivé, lisez le statut de la carte et la raison de la disponibilité.
- Si un commutateur revient à son état antérieur, lisez le message d'erreur et rechargez la bibliothèque avant de réessayer.
- Si la bibliothèque ne se charge pas, sélectionnez **Réessayer** une fois et contactez le support si cela se répète.
## Point de contrôle avant activation
Le panneau de détails doit expliquer le déclencheur et l’état actuel de l’automatisation sélectionnée. Fermez-le pour revenir à la même carte. Un badge **En ligne** autorise les futurs déclenchements ; utilisez les informations de la dernière exécution et le message ou le rapport résultant réel pour vérifier l'exécution.
### Vidéo : inspecter une automatisation en pause
L'enregistrement passe en pause, ouvre les détails de la demande de révision, puis les ferme. Il n'active pas l'automatisation, ne modifie pas son e-mail ou n'envoie pas de message.
## Guides connexes
- [Créer et gérer les automatisations](./create-and-manage-automations)
- [Runner Ads](./runner-ads)
- [Aperçu des analyses](../analytics-and-seo/analytics-overview)
---
# Créer et gérer les automatisations
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/create-and-manage-automations
Utilisez les contrôles d'automatisation pour décider quels flux de travail disponibles peuvent s'exécuter et quel contenu d'e-mail client pris en charge doit contenir.
> **Conditionnel :** La page actuelle gère les cartes d'automatisation fournies par Runner ; elle ne présente pas un générateur de flux de travail vierge pour créer une automatisation arbitraire. L'édition d'e-mail n'apparaît que sur les cartes prises en charge.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **Automatisations** → choisissez une carte.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgu7RtXsbqHvBxClMcD3zm6P2XTVQw91N0sga5)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La demande de révision est suspendue et n'affiche aucune heure de dernière exécution. Inspectez ces détails avant d’activer l’automatisation.
## Avant de commencer
- Lisez la description et le déclencheur de l'automatisation avant de l'activer.
- Confirmez que le plan actuel permet l'automatisation.
- Pour l'e-mail client, vérifiez l'expéditeur, l'objet, les variables, les liens et les détails de la marque avant d'enregistrer.
- L'enregistrement d'un modèle modifie sa configuration stockée ; il n'envoie pas d'e-mail de test ou client par lui-même.
## Contrôles de carte et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Activer | Change le statut demandé en **En direct**. Les futurs déclencheurs correspondants peuvent démarrer l'automatisation. |
| Désactiver | Change le statut demandé en **En pause**. Les nouveaux déclencheurs correspondants ne doivent pas la démarrer. |
| Bouton Info | Ouvre la description de l'automatisation, le statut, la catégorie, la raison de la disponibilité et l'heure de la dernière exécution. |
| Bouton d'édition d'e-mail | Ouvre **Rédiger un e-mail** lorsque la carte a un modèle personnalisable. |
> **Taille d'écran :** Les boutons Info et d'édition d'e-mail sont affichés sur les mises en page de bureau plus larges. S'ils sont absents sur un écran de téléphone, utilisez une fenêtre plus large avant de suivre les étapes ci-dessous.
## Contrôles d'e-mail et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **De** | Change la valeur d'expéditeur stockée pour ce modèle. |
| **Objet** | Modifie l'objet de l'e-mail. |
| **Corps** | Modifie le contenu de l'e-mail. |
| **Insérer une variable** | Ouvre les espaces réservés pris en charge et insère celui sélectionné à la position actuelle. |
| **Aperçu** | Affiche un aperçu du brouillon actuel ; il n'envoie pas l'e-mail. |
| URL du logo et couleur d'accent | Met à jour les entrées de marque utilisées par le modèle. |
| **Enregistrer** | Stocke les paramètres d'e-mail actuels et change **Non enregistré** en **Enregistré** après succès. |
| **Réessayer** l'aperçu | Essaie de rendre le brouillon actuel à nouveau après un échec d'aperçu. |
## Activer et personnaliser en toute sécurité
1. Sélectionnez le bouton info et confirmez quand l'automatisation s'exécute.
2. Si un bouton d'édition d'e-mail est disponible, ouvrez **Rédiger un e-mail**.
3. Modifiez l'objet et le corps dans un langage clair destiné au client.
4. Insérez uniquement les variables proposées par le menu.
5. Sélectionnez **Aperçu** et vérifiez le contenu rendu.
6. Retournez à **Modifier** si quelque chose manque ou n'est pas clair.
7. Sélectionnez **Enregistrer** et attendez **Enregistré**.
8. Fermez le compositeur, puis activez le commutateur de la carte uniquement lorsque le déclencheur et le message sont prêts.
9. Revenez plus tard pour vérifier la valeur **Dernière exécution** ; un badge **En direct** seul ne prouve pas l'exécution.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| **Non enregistré** | Le brouillon diffère du modèle stocké. Enregistrez ou fermez sans compter sur le brouillon. |
| **Enregistré** | Les paramètres du modèle actuel ont été stockés. Aucun e-mail n'a été envoyé par l'action d'enregistrement. |
| Échec de l'aperçu | Sélectionnez **Réessayer**. S'il se répète, vérifiez la syntaxe des variables et conservez votre brouillon avant de recharger. |
| Modèle d'e-mail introuvable | Cette carte n'a pas de personnalisation récupérable. Fermez la boîte de dialogue et rechargez la bibliothèque. |
| Basculement bloqué | Vérifiez **Bloqué par le forfait**, **Bientôt disponible**, ou la raison de la disponibilité sur la carte. |
## Vérifiez l'e-mail avant de l'enregistrer
Dans **Aperçu**, vérifiez le sujet, la marque, les liens et le rendu variable. Revenez à **Modifier** pour corriger le brouillon. La fermeture sans enregistrer laisse le modèle stocké en place.
**Point de contrôle :** **Enregistré** confirme la configuration du modèle. La livraison nécessite un déclencheur correspondant et une exécution terminée ; les actions de prévisualisation et de sauvegarde n'envoient pas d'e-mail client.
### Vidéo : inspecter une automatisation en pause
L'enregistrement passe en pause, ouvre les détails de la demande de révision, puis les ferme. Il n'active pas l'automatisation, ne modifie pas son e-mail ou n'envoie pas de message.
## Guides connexes
- [Automatisations](./automations)
- [Bibliothèque de médias](./media-library)
- [Dépanner les données et la publication](../analytics-and-seo/troubleshoot-data-and-publication)
---
# Creative Studio
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/creative-studio
Creative Studio vous offre un canevas visuel pour créer des médias de campagne et de produit à partir d'une invite, d'images sélectionnées ou des deux.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **Studio Créatif**. La destination ouvre le canevas **Studio Créatif**.
Lorsque la fonctionnalité est activée, une vue de détail d'image générée dans le chat Runner peut également proposer **Ouvrir l'image générée dans Creative Studio**, qui ouvre le canevas avec cette sortie sélectionnée.
Les captures et vidéos de cette page montrent l'interface en anglais.
Le sélecteur de modèle image à image affiche les exigences du modèle et le financement avant l'exécution. L'ouverture du sélecteur ne démarre pas la génération.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggKevjc4IC4NbwvYeKD2nM5xTZ76dBjp0auiy)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un exemple d'image existant est sélectionné sur le canevas, avec les commandes d'invite, de modèle et d'exécution. Vérifiez ces entrées avant de commencer la génération.
## Avant de commencer
- Décidez si vous avez besoin d'une nouvelle image, d'une modification d'image, d'une nouvelle vidéo ou d'une animation à partir d'une image.
- Vérifiez l'entrée, la sortie, la qualité, les limites et l'étiquette de financement du modèle sélectionné. Le sélecteur peut afficher les **Crédits Runner** ou votre propre clé Fal comme source de financement ; choisissez la source que vous comptez utiliser.
- Pour une modification, ajoutez l'image source au canevas et sélectionnez-la d'abord.
- Gardez l'actif original disponible jusqu'à ce que vous approuviez le résultat.
## Contrôles de génération et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Invite | Décrit l'image, la modification, le mouvement ou la vidéo que vous souhaitez. |
| Bouton modèle | Ouvre le **Choisir un modèle**, avec quatre onglets de modalité : texte à image, image à image, texte à vidéo et image à vidéo. |
| Recherche et filtres de modèle | Affine les modèles par nom, type de génération ou cas d'utilisation. |
| Étoile sur un modèle | Ajoute ou supprime ce modèle de **Favoris**. |
| Télécharger des images | Ouvre le sélecteur de fichiers et ajoute les images prises en charge pour l'utilisation du canevas. |
| **Exécuter** | Démarre une tâche avec l'invite actuelle, le modèle sélectionné et les entrées du canevas sélectionnées. |
| **Générations** | Ouvre la file d'attente en arrière-plan avec les tâches en cours, terminées, échouées et interrompues. |
| **Effacer les tâches terminées** | Supprime les entrées de file d'attente terminées de la vue de file d'attente ; cela ne supprime pas les médias enregistrés. |
## Contrôles du canevas et des actifs
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Barre d'actifs | Ouvre les actifs générés à partir de la conversation actuelle ou tous les actifs du projet. |
| Recherche d'actifs | Filtre la barre d'actifs. |
| **Ajouter au canevas** | Place l'actif disponible sélectionné sur le canevas. |
| **Centrer sur le canevas** | Déplace la fenêtre d'affichage vers cet actif lorsqu'il est déjà présent. |
| **Bibliothèque multimédia** | Ouvre la page complète des médias enregistrés. |
| Annuler / Rétablir | Annule ou réapplique les modifications du canevas prises en charge. |
| Contrôles de zoom et minimap | Change la fenêtre d'affichage sans modifier les médias eux-mêmes. |
| Sélectionner un ou plusieurs éléments, puis clic droit | Ouvre le menu contextuel du canevas. Les actions disponibles changent selon le nombre et le type d'éléments sélectionnés. |
| **Outils de produit** | Pour les sélections d'images prises en charge, ouvre Photographie de produit, Scène de produit, Placement de produit, Tenue de produit, Essai virtuel, Supprimer ou remplacer l'arrière-plan, Rééclairer, Concept de matériau et Augmenter la résolution. Les outils à une image et deux images restent désactivés jusqu'à ce que le nombre requis soit sélectionné. |
| **Définir comme miniature du produit** | Avec une image sélectionnée, ouvre le sélecteur de produit. En choisissant **Utiliser comme miniature**, l'image est téléchargée et la miniature et la liste d'images de ce produit sont mises à jour. |
| **Étendre la vidéo** / **Supprimer l'arrière-plan de la vidéo** | Avec une vidéo sélectionnée, ouvre le flux de travail vidéo correspondant lorsqu'il est disponible. |
| **Exporter en GIF** | Convertit la vidéo sélectionnée en GIF téléchargeable ; une erreur de conversion laisse la vidéo originale inchangée. |
| Dupliquer / Recadrer / Combiner des images / Ordre des calques / Télécharger | Applique l'opération de canevas sélectionnée lorsque ses exigences de nombre d'images et de type de média sont respectées. |
| **Supprimer** | Supprime uniquement l'élément sélectionné du canevas. Cela ne supprime pas l'actif enregistré de la Bibliothèque de médias. |
## Créer des médias
1. Ouvrez **Studio Créatif**.
2. Choisissez un modèle et lisez ses exigences d'entrée.
3. Pour texte-vers-image ou texte-vers-vidéo, laissez la sélection du canevas vide et écrivez une invite spécifique.
4. Pour l'édition d'images, utilisez **Ajouter au canevas** sur l'image source, sélectionnez-la, puis choisissez un modèle **Image à image**. Par exemple, **Nano Banana 2 Edit** apparaît lorsqu'il est disponible ; inspectez ses exigences plutôt que de supposer que chaque modèle prend les mêmes entrées.
5. Pour image-vers-vidéo, sélectionnez l'image unique que le modèle animera.
6. Vérifiez l'étiquette de financement du modèle et l'avis de crédit actuel.
7. Sélectionnez **Exécuter** une seule fois.
8. Ouvrez **Générations** pour suivre la progression tout en continuant d'autres travaux du canevas.
9. Inspectez la sortie terminée sur le canevas. Les médias générés sont enregistrés dans la bibliothèque de médias après une génération réussie.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Rien en file d'attente | Aucune génération en arrière-plan actuelle n'est répertoriée. |
| En attente ou en cours | La tâche est toujours en traitement. Continuez à travailler et attendez la fin. |
| Réussi | La sortie générée est disponible sur le canevas et dans les médias enregistrés. Vérifiez-la avant réutilisation. |
| Échoué | La tâche n'a pas produit la sortie attendue. Lisez le message, corrigez les entrées et réessayez délibérément. |
| Interrompu | Le traitement s'est terminé avant le succès. Confirmez le financement et l'accès au fournisseur avant de réessayer. |
| Exécution indisponible | Vérifiez l'invite, les images sélectionnées, le nombre exact d'entrées, l'accès au modèle et les crédits. |
| Actif indisponible | Réessayez de charger la barre ou choisissez un autre actif enregistré ; ne comptez pas sur un aperçu cassé. |
## Examiner la configuration sans lancer de tâche
1. Ouvrez **Choisir un modèle** et comparez son type d'entrée pris en charge avec votre tâche.
2. Fermez le sélecteur après avoir sélectionné un modèle approprié.
3. Vérifiez l'invite et les images sélectionnées sur le canevas.
4. Lire l'avis de financement avant **Exécuter**.
**Point de contrôle :** Le modèle, l'invite et la sélection de source décrivent la tâche prévue. La génération ne commence qu'après **Exécuter** ; la file d'attente fournit ensuite l'état et une sortie terminée nécessite toujours votre examen visuel.
### Vidéo : examiner un modèle de retouche d'image
L'enregistrement inspecte les exigences d'image à image et revient à un exemple d'image existant sur le canevas. Cela ne démarre pas une génération.
## Guides connexes
- [Bibliothèque de médias](./media-library)
- [Créatifs publicitaires et tendances](./ad-creatives-and-trending)
- [Runner Ads](./runner-ads)
---
# Mesure des expériences
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/experiment-measurement
La mesure des expériences vous aide à comparer le contrôle avec la variation active avant de prendre une décision en direct sur le magasin.
## Chemin d'accès
Ouvrez un projet de magasin → **Mesurer** → **Expériences** → sélectionnez une expérience → **Performance**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La condition préalable à la publication doit être remplie avant qu’une véritable expérience puisse collecter des données. Aucune mesure expérimentale n’est présentée ici.
## Avant de commencer
- Confirmez l'objectif de l'expérience et l'allocation de trafic actuelle.
- Attendez un échantillon utile avant d'interpréter les petits changements de pourcentage.
- Examinez les modifications de variation dans l'onglet **Expériences** avant de considérer **Appliquer les modifications**.
- Demandez à un propriétaire de l'espace de travail avant une action qui déploie des modifications ou arrête les tests en direct.
## Contrôles et résultats de performance
| Contrôle ou section | Ce qui se passe ou apparaît |
| --- | --- |
| **Expériences** | Ouvre les messages de cycle, les plans, l'aperçu, les modifications et les demandes en attente. |
| **Performance** | Ouvre le temps d'exécution, la taille de l'échantillon, la répartition du trafic, le graphique et le tableau des métriques. |
| Sélecteur de métrique | Change le graphique en une mesure prise en charge telle que conversion, ajout au panier, passage à la caisse, achat, valeur de commande, revenu par visiteur, clics sur bannière, abandon de panier ou taux d'erreur. |
| Graphique Contrôle / Variation | Compare la série enregistrée pour la version originale et l'expérience. |
| Contrôle du trafic → **Mettre à jour** | Enregistre une nouvelle allocation d'expérience dans la plage autorisée. |
| **Aperçu IA** → **Autoriser** | Approuve la suggestion de trafic affichée. |
| **Aperçu IA** → **Annuler** | Rejette cette suggestion sans l'approuver. |
| **Demander à Runner** | Envoie un message dans l'espace de travail de l'expérience. |
| **Voir le plan** | Ouvre le plan de cycle actuel et la liste des tâches. |
## Examiner la mesure
1. Ouvrez **Performance**.
2. Confirmez le temps d'exécution, la taille de l'échantillon et la répartition du trafic avant de lire la tendance.
3. Sélectionnez la métrique qui correspond à l'objectif de l'expérience.
4. Comparez le contrôle et la variation sur la même période.
5. Vérifiez les métriques de support pour les compromis d'erreur, d'abandon ou de revenu.
6. Retournez au **Expériences** et examinez les modifications exactes qui ont produit la variation.
7. Lisez toute demande **Aperçu IA** avant d'autoriser un changement de trafic.
8. Choisissez de continuer à mesurer, d'ajuster le trafic, d'arrêter ou de préparer à appliquer uniquement après avoir examiné le comportement et l'implémentation.
## Actions à fort impact
| Action | Ce que le premier clic fait | Ce que la confirmation signifie |
| --- | --- | --- |
| **Appliquer les modifications** | Ouvre **Mettre cette version en ligne pour tout le monde ?**. | La confirmation applique les modifications de l'expérience au chemin principal du magasin et démarre le déploiement en production. Examinez d'abord l'expérience nommée. |
| **Arrêt** | Ouvre **Arrêter l'expérience** avec des avertissements. | La confirmation termine l'expérience actuelle. Si l'autorisation d'expérience reste activée, Runner peut en démarrer une autre ; utilisez les paramètres du projet lorsque vous avez l'intention de désactiver complètement les expériences. |
| Trafic **Mettre à jour** | Soumet la nouvelle allocation. | Le trafic éligible futur utilise la répartition mise à jour après succès. |
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Pas de données de cycle | La mesure n'a pas encore produit de résultat de cycle. Gardez l'expérience en cours ou inspectez son statut. |
| Impossible de charger les métriques | Rechargez **Performance** et réessayez plus tard ; n'appliquez pas les modifications à partir de données manquantes. |
| Résultat plat ou mixte | Les preuves disponibles ne montrent pas une amélioration claire. Continuez à mesurer ou arrêtez sans appliquer. |
| Échec de la mise à jour du trafic | La valeur actuelle n'a pas été stockée. Rechargez avant de réessayer une allocation valide. |
| Échec de l'application | Aucune application de production réussie n'a été confirmée. Conservez l'erreur et vérifiez le magasin en direct avant de réessayer. |
## Point de contrôle avant de modifier le trafic
Vous devriez être en mesure de nommer l'objectif, la taille de l'échantillon, la répartition active et la variation exacte avant de choisir une action. Si l’un ou l’autre des bras ne dispose d’aucune donnée utile, le résultat reste non concluant. L'ouverture de **Performance** ou d'une boîte de dialogue de confirmation n'arrête pas l'expérience ni n'applique les modifications ; ces changements nécessitent l’action correspondante pour réussir.
## Guides connexes
- [Expériences](./experiments)
- [Exécutions et résultats de simulation](./simulation-runs-and-results)
- [Métriques et filtres](../analytics-and-seo/metrics-filters)
---
# Expériences
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/experiments
Les expériences vous permettent de tester des variations de vitrine contrôlées par Runner par rapport à un objectif commercial sélectionné.
## Chemin d'accès
Ouvrez un projet de magasin → **Mesurer** → **Expériences**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Publiez la vitrine avant de commencer une expérience. Cet écran de prérequis ne montre pas une expérience lancée.
## Avant de commencer
- Publiez le magasin et confirmez qu'il peut recevoir du trafic réel.
- Choisissez un objectif principal qui correspond à la priorité actuelle du magasin.
- Choisissez une allocation de trafic que vous êtes à l'aise d'assigner aux variations d'expérience.
- Comprenez que le lancement démarre un processus d'expérience ; cela ne garantit pas un gain de performance.
## Contrôles de lancement et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Carte d'objectif | Sélectionne la métrique que Runner doit optimiser, telle que conversion, ajout au panier, passage à la caisse initié, engagement de bannière, clic sur bouton ou valeur moyenne de commande. |
| Curseur de trafic ou préréglage | Définit la part du trafic éligible assignée à l'expérience dans la plage autorisée. |
| **Lancer Expériences** | Autorise et démarre l'expérience pour le magasin, l'objectif et la valeur de trafic sélectionnés. |
| Titre de l'expérience ou **Voir l'expérience** | Ouvre l'espace de travail de détail de l'expérience. |
| **Toutes les expériences**, **En cours** ou **Arrêté** | Filtre la liste des expériences par statut. |
## Démarrer une expérience
1. Ouvrez **Expériences**.
2. Si le mur de publication apparaît, publiez et vérifiez d'abord le magasin.
3. Lisez chaque objectif et sélectionnez celui lié à la décision dont vous avez besoin.
4. Définissez l'allocation de trafic.
5. Examinez le magasin, l'objectif et le trafic une fois de plus.
6. Sélectionnez **Lancer Expériences** une seule fois.
7. Attendez que la carte d'expérience apparaisse.
8. Ouvrez l'expérience pour suivre la planification, les modifications, les cycles et les mesures.
## Contrôles de carte d'expérience
| Contrôle ou section | Ce qu'il affiche ou fait |
| --- | --- |
| Badge de statut | Affiche **En attente**, **En cours**, **Terminée**, **Échec** ou **Annulé**. Le filtre de liste **Arrêté** regroupe les expériences terminées, échouées et annulées. |
| Cycle et Trafic | Affiche le nombre de cycles actuel et l'allocation. |
| Aperçu | Affiche la variation de l'expérience lorsqu'un aperçu est disponible. |
| **Modifications** | Répertorie les modifications de vitrine associées au dernier cycle. |
| **Aperçu IA** | Ouvre une suggestion en attente telle qu'un ajustement du trafic. |
| **Autoriser** | Approuve la suggestion affichée avec sa valeur actuelle. |
| **Annuler** | Rejette cette suggestion en attente. |
| Menu Plus d'actions | Ouvre **Arrêt** et **Appliquer les modifications** lorsque ces actions sont disponibles. |
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Mur de publication | Le magasin n'a pas de déploiement en direct réussi. Publiez avant d'activer Expériences. |
| Écran de liste d'attente ou de mise à niveau | La fonctionnalité ou le plan n'est pas disponible pour cet espace de travail. |
| Préparation ou planification | Runner configure le prochain cycle. Attendez un plan ou une demande visible. |
| En attente d'approbation | Runner a besoin d'une décision avant de pouvoir continuer cette suggestion. Lisez-la avant de choisir **Autoriser**. |
| Pas de modifications encore | L'expérience actuelle n'a pas produit de modification de variation visible. |
| Échouée | Ouvrez l'expérience et conservez l'erreur visible pour le support avant de démarrer un remplacement. |
## Vérifier les accès avant de préparer un lancement
Si Runner affiche un aperçu lié au forfait, les cartes d'exemple illustrent la fonctionnalité ; elles ne montrent pas une expérience en cours sur votre magasin. Résolvez la condition d'accès affichée avant les étapes de lancement. L'obligation de publication est distincte et nécessite un magasin en ligne fonctionnel.
**Point de contrôle :** Après un lancement éligible, la véritable carte d'expérimentation doit identifier l'objectif et l'allocation prévus. Attendez le trafic enregistré avant d’interpréter les performances ; une carte créée à elle seule ne prouve ni mesure ni amélioration.
## Guides connexes
- [Mesure des expériences](./experiment-measurement)
- [Simulations](./simulations)
- [Trafic et conversion](../analytics-and-seo/traffic-and-conversion)
---
# Bibliothèque de médias
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/media-library
La Bibliothèque de médias vous offre un enregistrement visuel filtrable des images et vidéos de projet générées qui peuvent être réutilisées ultérieurement.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **Bibliothèque multimédia**. La destination ouvre la page **Bibliothèque multimédia**.
Vous pouvez également l'ouvrir à partir de la barre d'actifs dans [Creative Studio](./creative-studio).
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgPzvLcwpojWS3a1ps2R0mnEqK6T9PkBh7u5zQ)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Un exemple de bibliothèque d'images. Choisissez une image pour inspecter ses détails enregistrés ; l'ouverture de la bibliothèque ne génère pas de nouveaux médias.
Un exemple de vue détaillée de l’image montre ses contrôles d’invite, de modèle et de réutilisation. Aucune vignette de produit n'a été modifiée.
## Avant de commencer
- Générez ou enregistrez des médias dans un flux Runner pris en charge.
- Sachez si vous recherchez une image ou une vidéo.
- Pour les miniatures de produits, confirmez quel produit doit changer avant de terminer la boîte de dialogue de sélection.
## Contrôles de bibliothèque et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Tout** | Affiche chaque image et vidéo enregistrée disponible. |
| **Images** | Filtre la grille sur les images. |
| **Vidéos** | Filtre la grille sur les vidéos. |
| Carte de média | Ouvre **Détails de l'image** ou **Détails de la vidéo**. |
| **Charger plus** | Récupère des médias supplémentaires lorsque d'autres éléments sont disponibles. |
## Contrôles de détail et résultats des clics
| Contrôle ou champ | Ce qui se passe ou apparaît |
| --- | --- |
| Type, Source et Créé | Explique ce que l'élément est, d'où il provient et quand il a été enregistré. |
| Invite et Modèle | Affiche le contexte de génération lorsqu'il est disponible. |
| Titre | Vous permet d'entrer un nom réutilisable plus clair. |
| **Enregistrer** | Stocke un titre modifié ; il n'est pas disponible lorsque rien n'a changé. |
| **Fermer** | Ferme les détails sans enregistrer un titre non enregistré. |
| **Définir comme miniature du produit** | Ouvre le flux de sélection et de confirmation du produit pour une image. Cela ne s'applique pas aux vidéos. |
| **Supprimer** | Ouvre une confirmation irréversible ; seul le deuxième **Supprimer** supprime l'élément. |
| Supprimer **Annuler** | Retourne aux détails sans supprimer l'élément. |
## Trouver et examiner des médias
1. Ouvrez **Bibliothèque multimédia**.
2. Choisissez **Images** ou **Vidéos** lorsque la grille est grande.
3. Sélectionnez une carte pour ouvrir les détails.
4. Examinez la source, la date, l'invite et le modèle pour confirmer qu'il s'agit de l'actif prévu.
5. Fermez les détails pour revenir à la grille filtrée.
**Point de contrôle :** La vue détaillée affiche l'actif souhaité, avec son contexte de génération disponible. Si la grille est vide, revenez à **Tout** avant de supposer que le support est manquant.
## Renommer ou appliquer une image
1. Rouvrez l'actif souhaité, saisissez un titre utile et sélectionnez **Enregistrer**.
2. Pour une image qui doit devenir une vignette de produit, sélectionnez **Définir comme miniature du produit**.
3. Choisissez le produit souhaité et examinez la confirmation avant d'appliquer la modification.
4. Ouvrez ensuite le produit et confirmez que l'image correcte apparaît.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| **Pas de médias encore** | Aucun média pris en charge n'est disponible. Créez d'abord une image ou une vidéo dans Creative Studio. |
| Vue filtrée vide | La bibliothèque n'a pas d'élément de ce type. Retournez à **Tout**. |
| Pas de modifications à enregistrer | Le titre correspond à la valeur stockée. Fermez la boîte de dialogue ou modifiez-le. |
| Échec de l'enregistrement | Le nouveau titre n'a pas été confirmé. Conservez-le, rechargez et réessayez. |
| Action de miniature absente | Seules les images peuvent utiliser le flux de miniature de produit. |
| Confirmation de suppression | L'action ne peut pas être annulée. Choisissez **Annuler** sauf si la suppression permanente est prévue et autorisée. |
## Guides connexes
- [Creative Studio](./creative-studio)
- [Runner Ads](./runner-ads)
- [Automatisations](./automations)
---
# Runner Ads
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/runner-ads
Runner Ads apporte les rapports de compte publicitaire pris en charge et les contrôles de campagne dans le projet de magasin.
## Chemin d'accès
Ouvrez un projet de magasin → **Développer** → **Publicités** → **Vue d’ensemble**. Le sous-menu Annonces ouvre également **Créatifs** et **Trending** ; ce sont des vues distinctes.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglh1549efCuYB97EiQHRN3LVKtUonPdvTgIM4)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
L'aperçu des annonces non connectées propose les autorisations Google, Meta et TikTok. La sélection d'un fournisseur démarre la connexion ; cet écran ne confirme pas un compte connecté.
## Avant de commencer
- Confirmez que l'espace de travail a accès à **Publicités** et dispose d'un forfait éligible.
- Utilisez un compte autorisé à connecter le fournisseur publicitaire.
- Sachez quel fournisseur et quel compte publicitaire appartiennent à cette entreprise.
- La connexion démarre le flux d'autorisation du fournisseur ; elle n'est pas complète jusqu'à ce que Runner affiche le compte connecté.
## Contrôles de connexion et résultats des clics
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Connecter Google Ads** | Ouvre le flux d'autorisation sécurisé de Google. |
| **Connecter Facebook & Instagram** | Ouvre le flux d'autorisation Meta. |
| **Connecter TikTok Ads** | Ouvre l'autorisation TikTok lorsque ce canal est activé. |
| **Annuler la connexion** | Annule une tentative d'autorisation de fournisseur toujours en attente. |
| Paramètres de connexion | Ouvre l'état du canal connecté plus les contrôles pris en charge par ce fournisseur, tels que connecter, synchroniser, réautoriser ou déconnecter. |
| Synchroniser | Demande une liste de comptes actualisée pour cette connexion. Cela ne crée pas une campagne. |
| **Réautoriser** | Pour TikTok, démarre l'autorisation à nouveau lorsque ce contrôle apparaît et que la connexion l'exige. |
| Déconnecter | Ouvre une confirmation avant de supprimer la connexion du fournisseur de Runner. |
## Connecter un compte
1. Ouvrez **Publicités** → **Aperçu**.
2. Sélectionnez le bouton du fournisseur correct.
3. Complétez l'autorisation dans la fenêtre du fournisseur.
4. Retournez à Runner et attendez la synchronisation du compte.
5. Confirmez que le nom du fournisseur et du compte apparaissent dans les paramètres de connexion ou le sélecteur de compte.
6. Si la connexion reste en attente, attendez la synchronisation ou utilisez le chemin de nouvelle tentative visible.
7. Ne traitez pas le clic du bouton initial comme une connexion complétée.
## Contrôles et résultats du tableau de bord
| Contrôle ou section | Ce qui se passe ou apparaît |
| --- | --- |
| Plage de temps | Actualise les rapports pour la semaine passée, le mois ou une période récente plus large. |
| Sélecteur de compte | Filtre les résultats lorsque plus d'un compte connecté est disponible. |
| Cartes KPI | Résument les métriques publicitaires disponibles pour les comptes et la période sélectionnés. |
| Tableau de campagnes | Répertorie les métriques de campagne et les contrôles de statut pris en charge. |
| Campagne **Pause** / **Activer** | Pour les campagnes Google Ads ou TikTok prises en charge, demande le changement de statut externe correspondant. Les campagnes Meta n'affichent pas ce contrôle. Utilisez-le uniquement lorsqu'autorisé et confirmez l'état retourné. |
| Graphique de tendance | Compare la performance de la campagne et du compte sélectionnés au fil du temps. |
| Flux d'activité | Affiche l'activité de compte publicitaire récente disponible. |
| **Créer une campagne** | Ouvre un choix de fournisseur ou une destination de campagne uniquement lorsqu'un canal de création pris en charge est connecté. |
## Chemins de création de campagne
- Avec Google Ads connecté, **Créer une campagne** ouvre le flux en quatre étapes de Runner : **Canal et objectif**, **Plan**, **Modifier les campagnes** et **Examiner et publier**.
- Avec TikTok Ads connecté, la création ouvre TikTok Ads Manager dans un nouvel onglet plutôt qu'un assistant TikTok dans l'application.
- Avec les deux disponibles, le bouton ouvre un choix de fournisseur.
- Une connexion Meta uniquement peut fournir des rapports mais n'affiche pas une destination de création de campagne dans le flux actuel.
- Dans le flux Google, **Suivant** avance après que les champs obligatoires sont valides, **Retour** retourne à une étape complétée et **Publier la campagne** envoie la campagne examinée au fournisseur.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Liste d'attente | La section **Publicités** est désactivée pour l'espace de travail. Rejoindre ou consulter la liste d'attente ne déverrouille pas immédiatement la fonctionnalité. |
| Écran de mise à niveau | Le forfait actuel ne permet pas d'ouvrir la section **Publicités**. |
| Autorisation en attente | La fenêtre du fournisseur n'a pas été complétée ou retournée. Terminez-la ou annulez la tentative. |
| Réautorisation requise | Pour TikTok, ouvrez les paramètres de connexion et sélectionnez **Réautoriser** lorsqu'il est affiché avant d'attendre des données actualisées. |
| Données temporairement retardées | Gardez les données partielles disponibles et réessayez plus tard ; évitez les demandes répétées au fournisseur. |
| Rapports indisponibles pour un canal | Cette connexion ne peut pas fournir le rapport demandé. Utilisez les canaux pris en charge ou les rapports du fournisseur. |
| Bouton Créer absent | Aucun canal actuellement connecté ne prend en charge une destination de création. |
## Identifier l'écran avant de se connecter
Une liste d'attente signifie que les annonces ne sont pas disponibles dans cet espace de travail. Un aperçu du plan peut montrer des exemples de rapports tandis que les actions réelles restent bloquées. Un écran de connexion demande le compte fournisseur nécessaire pour utiliser le reporting. Suivez les étapes de connexion uniquement lorsque la page propose le flux de connexion utilisable.
**Point de contrôle :** Après autorisation, vérifiez le fournisseur exact et le compte sélectionnés dans Runner. Un tableau de campagne vide peut simplement signifier que le compte ne dispose d'aucune campagne ou donnée correspondante pour la période choisie.
## Guides connexes
- [Créatifs publicitaires et tendances](./ad-creatives-and-trending)
- [Creative Studio](./creative-studio)
- [Trafic et conversion](../analytics-and-seo/traffic-and-conversion)
---
# Exécutions de simulation et résultats
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/simulation-runs-and-results
La page d'exécution transforme l'activité des acheteurs générée en preuves que vous pouvez examiner avant de décider si le magasin doit changer.
> **Conditionnel :** Une page d'exécution n'existe que après le lancement d'une simulation admissible. Les résultats peuvent être partiels, indisponibles ou échoués, et les recommandations générées ne sont pas appliquées automatiquement.
## Chemin d'accès
Ouvrir un projet de magasin → **Mesurer** → **Simulation** → sélectionner une simulation récente.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Les simulations d'acheteur et de page nécessitent une publication avant une exécution. Cet écran de configuration ne contient pas les trajets terminés ni les résultats.
## Avant de commencer
- Attendez que l'exécution atteigne un état terminé ou échoué avant de traiter ses totaux comme définitifs.
- Gardez à l'esprit la page cible et le mode sélectionné lors de l'interprétation des résultats.
- Ne traitez pas le comportement des personas générés comme un comportement observé chez les vrais acheteurs.
## Contrôles d'exécution et résultats des clics
| Contrôle ou section | Ce qui se passe ou apparaît |
| --- | --- |
| Lien Retour | Revient à la page d'accueil Simulation et aux exécutions récentes. |
| **Parcours** | Ouvre les chemins individuels des personas, les décisions, les étapes et les captures d'écran disponibles. |
| **Tableau d'entonnoir** | Regroupe les sessions des acheteurs par l'étape de parcours la plus lointaine atteinte. |
| **Résultats** | Résume les sessions terminales, les sorties explicites, les limites de tours et les défaillances techniques. |
| Carte de persona ou de session | Ouvre ce parcours d'acheteur généré. |
| **Voir les détails de l’étape** | Ouvre l'action sélectionnée, la page, l'intention, la justification et la capture d'écran si disponible. |
| **Envoyer à Runner** | Crée un transfert de chat Runner contenant le contexte de la recommandation. Cela n'applique pas la modification. |
| **Valider les acheteurs** | Démarre une exécution de comparaison d'acheteurs identiques pour une recommandation admissible. |
## Lire une exécution de comportement d'acheteur
1. Confirmez que le statut est **Terminée** ou notez les parties qui s'exécutent encore.
2. Lisez les totaux de session et le résumé de portée de paiement.
3. Ouvrez **Tableau d'entonnoir** pour trouver la première chute commune.
4. Ouvrez **Parcours** et inspectez les sessions représentatives à ce stade.
5. Utilisez **Voir les détails de l’étape** pour examiner l'opération tentée et l'état visible de la page.
6. Ouvrez **Résultats** pour séparer les sorties des acheteurs des défaillances techniques ou des limites de tours.
7. Lisez chaque recommandation d'optimisation avec ses preuves, sa zone affectée, son risque et son plan de validation.
8. Utilisez **Envoyer à Runner** uniquement lorsque vous souhaitez une tâche de chat vérifiable ; inspectez la tâche avant d'accepter les modifications.
## Lire un audit de stimulus de page
1. Attendez le rapport agrégé.
2. Lisez le score d'intention et le nombre de perspectives d'acheteurs ensemble.
3. Examinez les différences de segment et la distribution des scores.
4. Lisez les thèmes de friction et les commentaires de soutien.
5. Utilisez le résultat pour former une hypothèse testable, pas une prédiction de conversion garantie.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Résultats en attente | Les sessions ne sont pas terminées. Attendez plus de sessions terminales. |
| Aucun rapport disponible | L'exécution s'est terminée sans le rapport agrégé attendu. Conservez l'ID d'exécution et contactez le support. |
| Relecture indisponible | Une relecture ou une capture d'écran signée n'a pas pu être chargée. Rechargez l'exécution pour demander un accès actualisé. |
| Défaillance technique | L'automatisation n'a pas pu terminer ce parcours ; excluez-le des conclusions comportementales. |
| Validation en attente ou en cours | La comparaison n'est pas prête. Attendez avant de juger la recommandation. |
| Amélioré, régressé ou non concluant | La comparaison d'acheteurs identiques favorise, nuit ou ne peut pas distinguer la modification suggérée dans ce test généré. |
## Faire correspondre le résultat à son mode
Les instructions de parcours et d’entonnoir ci-dessus s’appliquent aux courses des acheteurs. Une exécution **Prévision de campagne**, lorsqu'elle est disponible, expose à la place **Société**, **Chat** et **Rapport**. Lisez ses hypothèses d’audience et ses contributions à la campagne avant le rapport.
**Point de contrôle :** Identifiez si un résultat provient d'un parcours généré, d'une réaction sur une page ou d'une prédiction de campagne. Aucun n’est un achat enregistré par un vrai client. Séparez les échecs techniques des réactions du public.
## Guides connexes
- [Simulations](./simulations)
- [Expériences](./experiments)
- [Trafic et conversion](../analytics-and-seo/traffic-and-conversion)
---
# Simulations
Source: https://www.runnerai.com/docs/fr/guides/automate-test-and-create/simulations
La simulation vous permet d'envoyer des personas d'acheteurs générés à travers un parcours de magasin en direct ou de leur demander d'évaluer une page publique.
## Chemin d'accès
Ouvrez un projet de magasin → **Mesurer** → **Simulation**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Les simulations d'acheteur et de page nécessitent une publication avant une exécution. Cet écran de configuration ne contient pas les trajets terminés ni les résultats.
## Avant de commencer
- Pour **Comportement des acheteurs** et **Audit de relance de page**, publiez le magasin et confirmez le chargement de ses pages publiques.
- **Prévision de campagne**, lorsqu'il est disponible, utilise les entrées de campagne et ne nécessite pas de vitrine publiée.
- Examinez le plan actuel ou l'avis d'utilisation avant de lancer un travail payant.
- Choisissez une vraie question de vitrine et une page cible.
- Traitez les acheteurs générés comme des tests directionnels, pas une demande réelle de clients.
## Modes
| Mode | Quand l'utiliser | Ce que Runner fait après le lancement |
| --- | --- | --- |
| **Comportement des acheteurs** | Vous souhaitez observer la navigation, les décisions et la friction du parcours. | Démarre plusieurs parcours d'acheteurs sur la page en direct sélectionnée et prépare les vues d'entonnoir, de parcours, de résultats et de recommandations. |
| **Audit de stimulus de page** | Vous souhaitez des réactions ciblées à une page. | Collecte les évaluations d'acheteurs générés pour l'intention d'achat, les segments et la friction sur cette page. |
## Contrôles et résultats des clics
| Contrôle | Ce qui se passe après l'avoir sélectionné |
| --- | --- |
| Sélecteur de mode | Choisissez **Comportement des acheteurs**, **Audit de stimulus de page** ou **Prévision de campagne** lorsque ce mode est activé. |
| Orientation des personas | Ajoute une direction d'audience optionnelle, comme la sensibilité aux prix ou les préoccupations d'expédition. |
| **Page cible** | Ouvre les pages de vitrine publiques découvertes telles que Accueil, Collection, Produit, Panier, Paiement ou une page personnalisée. |
| Fenêtre d'affichage de l'appareil | Choisit mobile uniquement, bureau uniquement ou un mélange pondéré pour le comportement d'acheteur. |
| Taille du panneau | Change le nombre de parcours d'acheteurs générés que l'exécution demande dans la plage autorisée. |
| **Lancer la simulation** | Démarre l'exécution configurée et ouvre sa page d'exécution. Elle est désactivée jusqu'à ce qu'une page cible soit sélectionnée. |
| Carte de simulation récente | Ouvre une exécution antérieure et son statut ou ses résultats actuels. |
| **Tout afficher** | Développe la liste des exécutions récentes lorsque d'autres exécutions existent. |
| **Réessayer** | Recharge les pages cibles ou les exécutions après une défaillance visible. |
## Lancer une simulation ciblée
1. Ouvrez **Simulation**.
2. Sélectionnez **Comportement des acheteurs** ou **Audit de stimulus de page**.
3. Ajoutez une orientation de personas concise uniquement lorsqu'un public spécifique est important.
4. Sélectionnez **Page cible** et choisissez une page en direct découverte.
5. Pour le comportement d'acheteur, choisissez le mélange d'appareils et la taille du panneau.
6. Examinez l'avis d'utilisation actuel.
7. Sélectionnez **Lancer la simulation** une seule fois.
8. Suivez la page d'exécution jusqu'à ce qu'elle se termine ou échoue.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Mur de publication | Aucun déploiement en direct réussi n'est disponible. Publiez et vérifiez d'abord le magasin. |
| Aucune page cible | Runner n'a pas pu découvrir les pages publiques. Ouvrez le magasin en direct et réessayez le chargement des pages. |
| Aucune simulation encore | Configurez le panneau et la cible pour créer la première exécution. |
| En attente ou en cours | L'exécution a été acceptée mais n'a pas commencé tout le travail. Attendez plutôt que de lancer un doublon. |
| En cours | Le travail des acheteurs est toujours en cours ; les résultats peuvent rester incomplets. |
| Échoué | Ouvrez l'erreur affichée sur l'exécution et ne lancez une nouvelle exécution qu'après avoir corrigé la cible ou la défaillance temporaire. |
## Prévision de campagne, lorsqu'elle est disponible
Ce mode demande aux membres de l'audience générée d'évaluer une campagne plutôt que de naviguer dans une boutique publiée.
1. Ouvrez **Mesurer** → **Simulation** et choisissez **Prévision de campagne** si affiché.
2. Vérifiez les entrées de campagne demandées par le formulaire.
3. Ajoutez la campagne que vous souhaitez évaluer et lisez l'avis d'utilisation actuel.
4. Démarrez la prédiction uniquement lorsque les entrées et les dépenses demandées sont correctes.
5. Ouvrez l'espace de travail résultant et inspectez les vues **Société**, **Chat** et **Rapport** disponibles.
**Point de contrôle :** Un rapport terminé est une prédiction générée pour la campagne fournie. Il ne lance pas de publicité et ne mesure pas les performances réelles d'une campagne. Si le mode est absent, utilisez un mode disponible ou vérifiez [Disponibilité des fonctionnalités](../advanced/feature-availability).
## Guides connexes
- [Exécutions de simulation et résultats](./simulation-runs-and-results)
- [Expériences](./experiments)
- [Aperçu des analyses](../analytics-and-seo/analytics-overview)
---
# Aide et référence
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference
Commencez ici quand vous connaissez le résultat que vous voulez, mais que l'écran actuel n'y correspond pas.
| Situation | Guide |
| --- | --- |
| Un bouton est désactivé, une page est vide, une entrée est manquante ou Runner vous demande de charger la dernière version | [États et disponibilité](/fr/guides/help-and-reference/states-and-availability) |
| Une tâche de chat Runner attend, s'est arrêtée ou a échoué | [Dépanner les tâches Runner](/fr/guides/help-and-reference/troubleshoot-runner-tasks) |
| La construction ou l'aperçu du magasin est incorrect | [Dépanner les constructions de magasin](/fr/guides/help-and-reference/troubleshoot-storefront-builds) |
| La publication, le paiement ou une application ne fonctionne pas | [Dépanner la publication, le paiement et les applications](/fr/guides/help-and-reference/troubleshoot-publishing-checkout-apps) |
| Vous avez besoin d'une personne ou voulez signaler un problème | [Support et communauté](/fr/guides/help-and-reference/support-and-community) |
| Vous voulez consulter les mises à jour produit Runner | [Journal des modifications](/fr/guides/help-and-reference/changelog) |
| Vous avez une courte question produit | [FAQ](/fr/guides/help-and-reference/faq) |
| Un terme Runner vous est unfamilier | [Glossaire](/fr/guides/help-and-reference/glossary) |
## Choisissez l'itinéraire le plus court
Utilisez un guide de dépannage en cas d'échec, **Assistance et communauté** lorsque vous avez besoin d'aide concernant un compte privé ou un problème de projet, ainsi que la FAQ, le glossaire ou la référence aux états lorsque vous avez besoin d'une définition. Pour la procédure pas à pas de configuration initiale, commencez par [Créer votre premier magasin](/fr/guides/start-here/first-store-quickstart).
---
# Journal des modifications
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/changelog
Le journal des modifications conserve les versions du produit au même endroit afin que vous puissiez voir ce qui a changé sans quitter Runner.
## Lire le Changelog public
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRzXySfwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXk)
Dans le [Changelog public](https://www.runnerai.com/changelog), lisez le mois à côté de **Monthly Update** et la section **What’s New**, puis faites défiler la page pour lire les mises à jour précédentes. Aucune connexion n’est nécessaire. Le mois est une date, pas un filtre.
Sélectionnez l’image pour l’agrandir. Les annotations sont en anglais.
Les sections suivantes décrivent le Changelog de l’espace de travail lorsqu’il est disponible. Ses filtres, son indicateur de contenu non lu et ses commandes de retour appartiennent à cette version et ne figurent pas dans la chronologie publique ci-dessus.
## Ce que couvre ce guide
Vous ouvrirez les mises à jour récentes, les filtrerez par type, comprendrez le marqueur non lu et reviendrez au magasin ou à l'espace de travail correct.
## Disponibilité et conditions préalables
- Seul le Changelog de l’espace de travail ou du projet nécessite une connexion ; la page publique est accessible sans compte.
- Le point non lu n'apparaît que lorsque Runner a une mise à jour que vous n'avez pas ouverte.
- Un filtre change uniquement les versions affichées sur cette page ; il ne change aucune fonctionnalité du produit.
## Chemins d'accès
| Entrée | Ce qui se passe après l'avoir sélectionné |
| --- | --- |
| Barre latérale de l'espace de travail → **Nouveautés** | Ouvre toutes les mises à jour de produit disponibles dans l'espace de travail actuel. |
| Avatar du projet de bureau → **Nouveautés** | Ouvre le même journal des modifications tout en gardant le projet actuel comme destination de retour. |
| Avatar du projet mobile → **Nouveautés** | Ouvre le journal des modifications à partir de la feuille **Profil et paramètres**. |
| Barre latérale de l'espace de travail réduite → Aperçu de l'icône du journal des modifications → **Tout afficher** | Ouvre le journal des modifications complet après avoir prévisualisé la dernière version. |
L'ouverture du journal des modifications complet efface le point non lu. Cela marque les mises à jour comme vues ; cela n'exécute pas ou n'active pas les fonctionnalités décrites dans une version.
## Filtrer les versions
| Contrôle | Ce qui se passe après l'avoir sélectionné |
| --- | --- |
| **Tout** | Affiche chaque version disponible. |
| **Mettre en avant** | Affiche les versions catégorisées comme nouvelles fonctionnalités. |
| **Amélioration** | Affiche les versions catégorisées comme améliorations. |
| **Correction** | Affiche les versions catégorisées comme corrections. |
| Carte de version | Affiche le titre, la date, le type, la description et les médias disponibles de cette version. |
| **Retour au magasin** | Revient au projet actuel lorsque le journal des modifications a été ouvert là ; sinon, il revient à la liste des magasins de l'espace de travail. |
Sur mobile dans un projet, l'interpréteur de projet fournit le contrôle de retour, de sorte que l'action **Retour au magasin** au niveau de la page peut être masquée.
## Examiner une mise à jour
1. Ouvrez **Nouveautés** à partir de la barre latérale de l'espace de travail ou du menu avatar.
2. Commencez par **Tout** pour voir les versions dans l'ordre chronologique.
3. Sélectionnez **Mettre en avant**, **Amélioration** ou **Correction** lorsque vous avez besoin d'un type de modification.
4. Lisez le titre de la version, la date, la description et tout média inclus.
5. Utilisez le contrôle de retour pour revenir au magasin ou à l'espace de travail d'où vous venez.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Point rouge non lu | Une mise à jour plus récente n'a pas été ouverte. Ouvrez le journal des modifications pour l'effacer. |
| **Aujourd’hui** | La date de version correspond au jour actuel. |
| Aucun élément sous un filtre | Aucune version disponible n'a cette catégorie. Retournez à **Tout**. |
| Aperçu de la dernière version | Faire une pause sur l'icône de bureau réduit peut afficher la mise à jour la plus récente. Sélectionnez **Tout afficher** pour l'historique complet. |
| Le retour revient à une portée différente | Rouvrez l'espace de travail ou le projet prévu, puis ouvrez le journal des modifications à partir de là afin que Runner ait le contexte de retour correct. |
## Utilisez une note de version pour trouver l'étape suivante
1. Ouvrez **Nouveautés** et choisissez **Mettre en avant**, **Amélioration**, **Correction** ou **Tout**.
2. Lisez l'entrée datée qui correspond au comportement que vous souhaitez apprendre.
3. Revenez avec **Retour au magasin** et ouvrez l'outil approprié via la navigation du projet.
**Point de contrôle :** La liste filtrée affiche la catégorie de mise à jour sélectionnée. Les notes de version décrivent les modifications ; le plan actuel de votre espace de travail et l’accès aux fonctionnalités déterminent si vous pouvez les utiliser.
## Guides connexes
- [Support et communauté](/fr/guides/help-and-reference/support-and-community)
- [Navigation et recherche de l'espace de travail](/fr/guides/workspace/navigation-and-search)
- [Disponibilité des fonctionnalités](/fr/guides/advanced/feature-availability)
---
# Questions fréquemment posées
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/faq
**Chemin d'accès :** Documentation Runner → **Aide et référence** → **FAQ**.
### Puis-je commencer sans expérience technique ?
Oui. Décrivez l'entreprise et l'expérience client souhaitée en langage clair. Runner peut poser des questions de suivi avant de commencer le travail. Voir [Rédiger des demandes efficaces](../work-with-runner/write-effective-requests).
### Dois-je créer un nouveau magasin ou connecter Shopify ?
Choisissez **Partir de zéro** quand Runner doit créer le projet de magasin et sa configuration de commerce. Choisissez **Connecter Shopify** quand Shopify doit rester le système de magasin connecté et le chemin de paiement. Voir [Créer un magasin Runner](../start-here/create-runner-store) et [Connecter Shopify](../start-here/connect-shopify).
### Une tâche Runner complétée signifie-t-elle que mon magasin est en direct ?
Non. L'achèvement de la tâche, le succès de l'aperçu, la publication, la vitrine en direct, le catalogue et le paiement sont des résultats distincts. Vérifiez chaque couche pertinente.
### Quelle est la différence entre Publier et Republier ?
**Publier** crée la première version en direct après que les exigences soient complètes. **Republier** envoie les modifications de brouillon plus récentes à un magasin qui a déjà une version en direct. Voir [Publier et republier](../storefront-and-publishing/publish-and-republish).
### Pourquoi un bouton est-il désactivé ?
L'entrée requise, la permission, l'accès au plan, l'état du magasin, les données ou une connexion peuvent manquer. Lisez le texte à proximité et voir [États et disponibilité](./states-and-availability).
### Pourquoi une entrée de navigation manque-t-elle ?
Certaines fonctionnalités sont conditionnelles ou par étapes. Confirmez l'espace de travail, le magasin, le rôle, le plan, la publication et les connexions. Voir [Disponibilité des fonctionnalités](../advanced/feature-availability).
### Où puis-je gérer les produits et les commandes ?
Ouvrez le projet de magasin, sélectionnez **Opérations de la boutique**, puis choisissez **Produits** ou **Commandes**. Voir [Opérations de la boutique](../store-operations).
### Où puis-je connecter les paiements, les e-mails ou l'expédition ?
Ouvrez le projet et sélectionnez **Apps**. Choisissez le fournisseur et suivez son flux de connexion officiel. Voir [Apps et intégrations](../apps-and-integrations).
### Comment puis-je annuler une modification de vitrine ?
D'abord envoyez une correction ciblée ou utilisez [Historique des versions](../storefront-and-publishing/version-history). La restauration d'une version change l'état du projet, alors examinez la version sélectionnée avant de confirmer.
### Pourquoi les analyses ou le SEO sont-ils vides ?
Le magasin sélectionné, la plage de dates, la publication ou la collecte d'événements peuvent ne pas encore contenir de données. Un état vide diffère d'un état de chargement ou d'erreur. Voir [Analyse et SEO](../analytics-and-seo).
### Où puis-je voir les crédits et l'utilisation ?
Ouvrez les paramètres de l'espace de travail et sélectionnez la destination d'utilisation ou de facturation disponible pour votre rôle. Voir [Crédits et utilisation](../plans-and-billing/credits-and-usage).
### Comment puis-je obtenir de l'aide ?
Utilisez [Support et communauté](./support-and-community). Incluez la page exacte, l'action, l'état visible et une capture d'écran sûre pour la confidentialité.
## Par où dois-je commencer ?
Pour une première création guidée avec des captures d'écran et des enregistrements, suivez [Créez votre première boutique](../start-here/first-store-quickstart). Si le travail est déjà en cours, utilisez [Dépannage des tâches Runner](./troubleshoot-runner-tasks) avant de renvoyer la même demande.
---
# Glossaire
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/glossary
**Chemin d'accès :** Documentation Runner → **Aide et référence** → **Glossaire**.
| Terme | Signification dans Runner |
| --- | --- |
| Agent | Les capacités de Runner qui utilisent des Compétences réutilisables et la Mémoire du projet ou de l'espace de travail. |
| Application | Une connexion entre Runner et un autre service, ou une capacité au niveau de l'agent affichée sur la page Apps. |
| Artefact | Un résultat produit pendant une tâche ou un flux de travail, comme un rapport, un fichier, un aperçu ou le résultat d'une tâche antérieure. |
| Automatisation | Une action configurée qui s'exécute à partir d'un déclencheur ou d'un calendrier lorsqu'elle est disponible. |
| Chat | Une conversation de projet où vous demandez et examinez le travail. |
| Paiement | Le parcours client qui recueille les informations d'expédition et de paiement afin de créer une commande. |
| Crédits | Le quota d'utilisation de l'espace de travail affiché dans le produit actuel. La page de facturation en direct fait foi. |
| Mode de conception | Une vue d'édition de la vitrine qui permet de sélectionner et de modifier le contenu visible. |
| DNS | Les enregistrements Internet qui connectent un nom de domaine à la bonne vitrine. Runner affiche les valeurs à copier dans votre fournisseur de domaine. |
| Brouillon | Un magasin sans publication actuelle en ligne. |
| Point de terminaison | Une adresse de destination utilisée par une intégration, comme un récepteur de webhook. Traitez les adresses de point de terminaison et leurs identifiants comme des données sensibles. |
| Expérience | Une comparaison contrôlée utilisée pour mesurer un changement lorsque la fonctionnalité est disponible. |
| Fly | Un espace de travail de mission guidée conditionnelle. |
| Traitement des commandes | Le travail de préparation et d'envoi des articles d'une commande, y compris les étapes prises en charge par un fournisseur ou un transporteur. |
| Mémoire | Un contexte enregistré que Runner peut réutiliser dans la portée définie. |
| Bibliothèque de médias | L'espace du projet consacré aux ressources visuelles générées ou importées. |
| Aperçu | La vue actuelle de la vitrine du projet, avant la publication ou indépendamment de celle-ci. |
| Projet | L'espace de travail Runner propre à un magasin, qui contient le chat, la vitrine, les opérations, les applications et les outils. |
| Fournisseur | Un service externe connecté à Runner pour les paiements, l'expédition, les e-mails, l'approvisionnement, l'analyse ou une autre tâche prise en charge. |
| Publier | Créer la première version en ligne une fois les exigences satisfaites. |
| Republier | Envoyer les nouvelles modifications du brouillon vers un magasin qui dispose déjà d'une version en ligne. |
| Recherche | Un espace de travail conditionnel destiné aux études commerciales structurées et aux rapports. |
| Session (analyses) | Une visite enregistrée de la vitrine, utilisée dans les rapports de trafic et de conversion. Elle diffère d'une session de compte connecté. |
| Session (compte) | Une connexion authentifiée à Runner depuis un navigateur ou un appareil, qui peut être examinée ou révoquée dans les paramètres de sécurité. |
| Simulation | Un outil pour exécuter un scénario configuré et examiner son résultat quand disponible. |
| Compétence | Un ensemble réutilisable d'instructions ou de flux de travail que Runner peut appliquer à une tâche. |
| SKU | Un code défini par le magasin utilisé pour identifier un produit ou une variante pour l'inventaire et les opérations. |
| Opérations de la boutique | Pages de gestion des produits, commandes, clients, promotions, expédition, approvisionnement et paramètres du magasin. |
| Tâche | Une unité de travail que Runner suit dans une conversation. |
| Variante | Une version achetable d'un produit, comme une taille ou une couleur particulière, avec son propre prix ou inventaire. |
| Version | Un état de vitrine sauvegardé affiché dans l'historique des versions. |
| Webhook | Une livraison configurée d'un événement de projet pris en charge à un autre service. |
| Flux de travail | Un flux de projet réutilisable en plusieurs étapes lorsque la fonctionnalité est activée. |
| Espace de travail | Le périmètre d'équipe et de facturation qui contient les magasins, les membres, les paramètres, les crédits et les notifications. |
## Utilisez les termes dans un flux de travail réel
Suivez [Créez votre première boutique](../start-here/first-store-quickstart) pour voir une conversation, une tâche, un aperçu et une vérification de publication en contexte. Pour un message d'état, utilisez [États et disponibilité](./states-and-availability) pour choisir une action suivante.
## Guides connexes
- [Bienvenue dans Runner AI](../product-guide)
- [États et disponibilité](./states-and-availability)
- [Disponibilité des fonctionnalités](../advanced/feature-availability)
---
# États et disponibilité
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/states-and-availability
Runner utilise des états pour vous dire si une action est prête, en attente, complète, bloquée ou indisponible. Lisez l'état avant de réessayer ou de modifier les paramètres.
**Chemin d'entrée :** Documentation Runner → **Aide et référence** → **États et disponibilité**.
## États du magasin et de la publication
| État | Signification | Prochaine étape sûre |
| --- | --- | --- |
| Brouillon | Le projet n'a pas actuellement de version publiée en direct. | Continuez à construire et complétez les exigences de publication. |
| Déploiement | Runner prépare une publication. | Attendez que l'état se termine ; ne commencez pas de publications répétées. |
| Publié | Une version en direct existe. | Ouvrez l'URL en direct et vérifiez le changement prévu. |
| Publication bloquée | Un ou plusieurs éléments de configuration requis sont incomplets. | Ouvrez l'exigence nommée et terminez-la. |
| Republication disponible | Le brouillon contient des modifications plus récentes que la version en direct. | Examinez l'aperçu, puis republier quand vous êtes prêt. |
## États des tâches
| État | Signification | Prochaine étape sûre |
| --- | --- | --- |
| En attente de vous | Runner a besoin d'une réponse, d'un choix, d'une approbation ou d'un détail manquant. | Ouvrez la question et répondez une fois. |
| En cours | La tâche actuelle est toujours en cours d'exécution. | Suivez ses détails au lieu de commencer une demande dupliquée. |
| Complété | Runner a atteint l'état de succès terminal de la tâche. | Vérifiez le résultat visible dans la page affectée. |
| Arrêté | Le travail s'est terminé avant la fin. | Lisez pourquoi il s'est arrêté, corrigez la cause, puis continuez ou envoyez une demande de suivi ciblée. |
| Échoué | La tâche n'a pas pu se terminer. | Enregistrez l'erreur visible et réessayez uniquement après avoir vérifié la cause. |
## États de page et de contrôle
| Ce que vous voyez | Signification |
| --- | --- |
| Bouton désactivé | L'entrée, la permission, le plan ou l'état requis est manquant. Le texte à proximité le nomme généralement. |
| Squelette ou indicateur de chargement | Les données sont demandées. Un état de chargement persistant nécessite un rechargement ou une vérification du support. |
| État vide | La page est disponible mais le contexte sélectionné n'a pas encore d'éléments. Utilisez l'action de création ou de connexion proposée. |
| Message de mise à niveau | Le plan actuel ou la limite ne permet pas l'action. Examinez l'offre en direct dans **Plan et Facturation**. |
| Connecter ou reconnecter | Le service externe n'est pas connecté ou a besoin d'une autorisation à nouveau. |
| Page non trouvée | L'URL est indisponible dans le contexte actuel, a été retirée ou est soumise à disponibilité. Revenez en arrière à l'aide de la navigation visible. |
## Récupération de version Runner
Si Runner a été mis à jour alors que votre onglet était ouvert, une page de récupération plein écran peut remplacer la vue actuelle. Vous ne pouvez ni la fermer ni utiliser la page sous-jacente tant que Runner n'a pas chargé la version actuelle.
| Ce que vous voyez | Ce qui se passe ensuite |
| --- | --- |
| **Une version plus récente de Runner est prête** | Sélectionnez **Charger la dernière version** pour recharger l'onglet actuel avec la dernière version de Runner. |
| **Vous êtes hors ligne** | **Charger la dernière version** est désactivé. Reconnectez-vous à Internet ; l'action devient disponible sans quitter la page de récupération. |
| **Chargement de la dernière version…** | Runner recharge l'onglet. Gardez-le ouvert pendant que l'action se termine. |
| **Nous n'avons pas pu charger la dernière version** | Vérifiez la connexion, puis sélectionnez **Réessayer**. |
| **Détails techniques** | Affiche le code d'erreur, la raison et l'heure de détection pour faciliter le dépannage. Cette action ne relance pas le chargement et ne répare pas la page. |
## Diagnostiquer dans l'ordre
1. Confirmez l'espace de travail et le magasin sélectionnés.
2. Développez **Créer**, **Développer** ou **Mesurer** pour localiser l'outil, puis lisez l'état, l'avertissement ou la condition préalable le plus proche.
3. Vérifiez si la tâche pertinente est déjà en cours d'exécution.
4. Confirmez votre rôle, plan, état de publication et connexion d'application requise.
5. Rechargez une fois si l'état vient normalement de changer.
6. Utilisez le guide de dépannage pertinent avant de répéter une action à fort impact.
## Guides connexes
- [Disponibilité des fonctionnalités](../advanced/feature-availability)
- [États et détails des tâches](../work-with-runner/task-states-and-details)
- [Statuts des magasins](../workspace/store-statuses)
- [Support et communauté](./support-and-community)
---
# Support et communauté
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/support-and-community
Utilisez la documentation pour les flux de travail connus, la communauté pour l'apprentissage partagé et le support pour les problèmes spécifiques au compte ou les problèmes produits reproductibles.
## Ce que couvre ce guide
Vous saurez où chaque action d'aide s'ouvre, comment réserver une démo ou envoyer des commentaires, et ce qu'il faut inclure quand vous avez besoin du support.
## Disponibilité et conditions préalables
- Vous devez être connecté pour utiliser les menus d'avatar de l'espace de travail ou du projet.
- **Envoyer des commentaires** n'apparaît que dans les vues d'espace de travail ou de projet de bureau qui exposent l'action de commentaires.
- **Réserver une démo** utilise un service de planification externe dans Runner et a besoin d'une connexion réseau fonctionnelle.
- La feuille d'avatar mobile a un ensemble d'actions plus petit que le menu d'avatar de bureau.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgNbwG0GU2bm17vuEiZydJjwfYlOaXgBTsQ69k)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Le menu d’aide de Chat renvoie à l’aide contextuelle et au centre d’aide. La vignette du tutoriel est masquée dans cette illustration ; aucune vidéo n’a été lancée et aucun signalement n’a été envoyé à l’assistance.
## Chemins d'accès
| Entrée | Ce qui se passe après que vous la sélectionniez |
| --- | --- |
| Bouton d'aide de la page → **Centre d'aide** | Ouvre la documentation Runner. |
| Popover d'aide sur la page → **Sur cette page — Chat** | Ouvre l'aide pour la page de discussion actuelle lorsque ce contexte est affiché. |
| Page d'aide contextuelle → **Votre première boutique en cinq minutes** | Ouvre le didacticiel de démarrage lié. |
| Barre latérale de l'espace de travail → **Centre d'aide**, lorsqu'elle est affichée | Ouvre la documentation Runner. |
| Barre latérale de l'espace de travail → **Communauté** | Ouvre la communauté Runner à sa destination actuelle. |
| Barre latérale de l'espace de travail → **Blog** | Ouvre les articles éducatifs et de l'entreprise. |
| Barre latérale de l'espace de travail → **Nouveautés** | Ouvre les mises à jour récentes du produit Runner. |
| Menu d'avatar de bureau → **Réserver une démo** | Ouvre le panneau de planification dans Runner. |
| Menu d'avatar de bureau → **Envoyer des commentaires** | Ouvre le formulaire de commentaires quand cette action est disponible dans la vue actuelle. |
| Menu d'avatar de bureau → **Aide** | Ouvre la documentation Runner. |
| Menu d'avatar du projet → **Communauté**, **Blog** ou **Nouveautés** | Ouvre la ressource sélectionnée ; **Nouveautés** reste dans Runner, tandis que Communauté et Blog ouvrent leurs destinations actuelles. |
| Documentation → **Support** | Ouvre l'action d'e-mail de support configurée. |
## Démarrer avec l'aide pour la page actuelle
1. Ouvrez le bouton d'aide de la page.
2. Choisissez le guide **Sur cette page** lorsqu'il correspond à votre question, ou **Centre d'aide** pour parcourir la documentation.
3. Si vous démarrez un magasin, choisissez **Votre première boutique en cinq minutes** lorsqu'il est proposé.
**Point de contrôle :** Une destination d'aide s'ouvre ; aucun rapport de support ou réservation n'a été envoyé. Les liens spécifiques à une page varient en fonction de la vue actuelle.
## Réserver une démo
1. Sur le bureau, ouvrez le menu d'avatar et sélectionnez **Réserver une démo**.
2. Attendez que le planificateur se charge.
3. Choisissez une date et une heure disponibles, puis complétez les détails de contact demandés par le planificateur.
4. Confirmez la réservation dans le planificateur.
5. Attendez le message de succès de Runner et la fermeture du panneau.
Fermer le panneau avant que le planificateur confirme la réunion ne crée pas de réservation. Si le
planificateur reste vide ou signale qu'il est indisponible, fermez-le, vérifiez la connexion et réessayez
une fois. Utilisez l'action Support de la documentation si elle échoue à plusieurs reprises.
## Envoyer des commentaires
1. Sur le bureau, ouvrez le menu de l'avatar et choisissez **Envoyer des commentaires** lorsqu'il s'affiche.
2. Décrivez la page, l'action, le résultat attendu et le résultat réel.
3. Ajoutez une catégorie facultative et une capture d'écran après avoir supprimé les informations privées.
4. Examinez le rapport avant de sélectionner **Soumettre**. Fermez le formulaire si vous souhaitez uniquement l'inspecter.
5. Après la soumission, attendez la confirmation avant de supposer que le rapport a été envoyé.
| Contrôle | Ce qui se passe après que vous l'utilisiez |
| --- | --- |
| **Décrivez vos commentaires** | Enregistre l'explication requise. Soumettre reste indisponible jusqu'à ce que ce champ contienne du texte. |
| **Problèmes d'utilisabilité** / **Fonctionnalités manquantes** | Ajoute une catégorie optionnelle pour que le rapport soit plus facile à acheminer. |
| Téléchargement de capture d'écran | Joint une image optionnelle au rapport. Utilisez le contrôle de suppression pour rejeter la pièce jointe avant d'envoyer. |
| **Soumettre** | Envoie le rapport. Pendant qu'il s'envoie, l'action ne peut pas être soumise à nouveau. |
| Fermer | Ferme le formulaire sans envoyer un nouveau rapport. |
Décrivez un comportement, la page où il s'est produit et ce que vous attendiez. Ajoutez une capture d'écran uniquement
après avoir supprimé les informations client, les e-mails, les détails de paiement, les identifiants et autres données privées.
Après une soumission réussie, Runner affiche une confirmation et ferme le formulaire. Si la soumission
échoue, conservez la description, vérifiez la pièce jointe et la connexion, et réessayez une fois.
## Menu d'avatar mobile
Sur mobile, l'avatar du projet ouvre **Profil & Paramètres**. Il inclut **Langue**, **Boîte de réception**,
**Aide**, **Communauté**, **Blog**, **Nouveautés** et **Déconnexion**. **Réserver une démo** et **Envoyer des commentaires**
ne sont pas listés dans cette feuille mobile. Utilisez une vue de bureau plus large pour ces deux actions, ou utilisez l'action
Support de la documentation pour un problème privé.
## Envoyer un rapport de support utile
Incluez :
1. Le nom de l'espace de travail et du magasin, sans secrets.
2. La page et le chemin d'accès exact.
3. Ce que vous avez sélectionné et ce qui s'est passé.
4. Ce que vous attendiez à la place.
5. Le texte d'état ou d'erreur visible.
6. Si le problème se répète après un rechargement.
7. Une capture d'écran avec les données client, les e-mails, les détails de paiement et les secrets supprimés.
Pour une tâche Runner, incluez la conversation et l'état de la tâche. Pour la publication, incluez l'état d'aperçu, l'état de publication et si l'URL en direct a changé. Pour une app, incluez le fournisseur et l'état de connexion affiché, mais jamais les identifiants ou les clés API.
## Choisir le canal
| Besoin | Meilleur point de départ |
| --- | --- |
| Apprendre un flux de travail produit normal | Recherchez ces guides. |
| Comparer les approches avec d'autres utilisateurs | Communauté. |
| Suivre une modification publiée du produit | Nouveautés. |
| Résoudre l'accès, la facturation, les données, les erreurs répétées ou le comportement du projet privé | Support. |
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Le planificateur de démo se charge | Attendez ses contrôles de date et d'heure avant d'interagir. |
| Démo confirmée | Runner affiche un message de succès et ferme le panneau. Vérifiez les détails de confirmation envoyés par le planificateur. |
| Soumettre les commentaires est indisponible | Ajoutez la description requise ou attendez que la soumission actuelle se termine. |
| Le téléchargement de commentaires échoue | Supprimez la pièce jointe et réessayez avec une image prise en charge et sûre pour la confidentialité, ou envoyez le texte sans elle. |
| La soumission de commentaires échoue | Le rapport n'a pas été confirmé. Conservez le texte et réessayez une fois avant d'utiliser le Support. |
## Guides connexes
- [Dépanner les tâches Runner](./troubleshoot-runner-tasks)
- [Dépanner les constructions de vitrine](./troubleshoot-storefront-builds)
- [Dépanner la publication, le paiement et les apps](./troubleshoot-publishing-checkout-apps)
- [Journal des modifications](/fr/guides/help-and-reference/changelog)
---
# Dépanner la publication, le paiement et les apps
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/troubleshoot-publishing-checkout-apps
Une construction réussie ne prouve pas en elle-même la publication, les données de catalogue, le paiement ou un fournisseur externe. Vérifiez chaque couche séparément.
**Chemins d'entrée :** Magasin concerné → **Boutique en ligne** → **Publier** pour les contrôles de préparation ; **Construire** → **Apps** pour les connexions du fournisseur.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La vérification de compilation réussit, mais une configuration incomplète laisse Confirmer désactivé. Résolvez l’exigence nommée avant de réessayer la publication.
## Avant de commencer
- Enregistrez le magasin affecté, l'URL publique, le fournisseur et l'état visible exact.
- Arrêtez avant un vrai frais, une commande, une déconnexion de fournisseur ou une autre action conséquente à moins que le test soit autorisé.
- Vérifiez une couche à la fois ; un aperçu fonctionnant ne prouve pas la publication ou le comportement du paiement.
## Contrôles et résultats importants
| Contrôle | Ce qui se passe après que vous le sélectionniez |
| --- | --- |
| **Réessayer la vérification** | Exécute à nouveau la vérification de publication ou de disponibilité du paiement échouée. Cela ne corrige pas la cause nommée. |
| **Publier** / **Republier** | Commence la publication après que les vérifications requises passent ; cela ne prouve pas le comportement du catalogue ou du paiement. |
| **Connecter Stripe** | Ouvre le chemin de connexion de paiement. Aucun paiement n'est accepté jusqu'à ce que le fournisseur et le paiement en direct soient utilisables. |
| **Reconnecter** dans Apps | Redémarre le flux d'autorisation officiel du fournisseur pour la connexion existante. |
## Identifier la couche défaillante
| Couche | Preuve à chercher | Si elle manque |
| --- | --- | --- |
| Aperçu | La page et l'interaction prévues fonctionnent dans **Boutique en ligne**. | Corrigez la construction ou le contenu avant de publier. |
| Publication | Runner affiche un état de publication réussi et une URL en direct. | Ouvrez l'état de publication et résolvez l'exigence ou l'erreur nommée. |
| Vitrine en direct | L'URL en direct affiche la version prévue dans une visite fraîche. | Vérifiez si les changements plus récents nécessitent **Republier**. |
| Catalogue | Le produit attendu, le prix, la disponibilité et le choix d'expédition sont visibles. | Corrigez les données dans **Opérations de la boutique** et la disponibilité de la vitrine. |
| Paiement | Un test sûr peut atteindre le paiement attendu et les choix d'expédition. | Vérifiez le paiement, l'expédition, le mode de magasin et l'état du fournisseur. Ne placez pas une vraie commande à moins d'être autorisé. |
| Fournisseur | L'app affiche connectée et le fournisseur confirme le compte attendu. | Reconnectez via le flux d'app officiel et revérifiez les permissions. |
## Récupération de publication
1. Ouvrez **Boutique en ligne** → **Publier** et lisez les contrôles de préparation. Arrêtez-vous à un Stripe manquant, à une expédition ou à une autre exigence nommée ; résolvez-le à l'aide de [Préparer la publication](../storefront-and-publishing/prepare-to-publish) avant de réessayer.
2. Vérifiez si une autre publication est déjà en **Déploiement**.
3. Si la publication échoue, préservez l'erreur affichée.
4. Réessayez une seule fois après que la cause nommée soit résolue.
5. Ouvrez l'URL en direct après le succès et vérifiez la page prévue.
## Récupération du paiement
1. Confirmez qu'au moins un produit vendable est visible sur le magasin en direct.
2. Confirmez que l'expédition s'applique à la destination du test.
3. Confirmez que l'app de paiement est connectée au mode et au compte prévus.
4. Atteignez le paiement via la vitrine en direct plutôt qu'une URL devinée directe.
5. Arrêtez avant un vrai frais ou une commande à moins que le test soit explicitement autorisé.
## Récupération d'app
1. Ouvrez **Construire** → **Apps** et sélectionnez le fournisseur.
2. Lisez l'état affiché : non connecté, connecté, a besoin d'attention ou indisponible.
3. Reconnectez uniquement via la fenêtre d'autorisation officielle du fournisseur.
4. Confirmez le compte retourné et les permissions.
5. Vérifiez le résultat réel en aval ; un badge de connexion vert seul n'est pas une preuve de bout en bout.
### Vidéo : inspecter un bloqueur de publication
L’enregistrement passe en revue les contrôles de préparation, puis choisit Annuler. Aucune boutique n'est publiée et aucun paiement n'est effectué.
## Guides connexes
- [Publier et republier](../storefront-and-publishing/publish-and-republish)
- [Vitrine en direct et paiement](../storefront-and-publishing/live-store-and-checkout)
- [Connecter, gérer et reconnecter les apps](../apps-and-integrations/connect-manage-reconnect)
- [Dépannage des apps](../apps-and-integrations/troubleshooting)
---
# Dépanner les tâches Runner
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/troubleshoot-runner-tasks
Commencez le dépannage à partir des détails de la tâche actuelle. Répéter la même demande sans vérifier son état peut créer du travail en double et masquer la cause d'origine.
## Chemin d'accès
Ouvrez le magasin affecté, revenez à la conversation, puis ouvrez l'état ou les détails de la tâche actuelle.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Une question en attente nécessite une réponse avant que le travail puisse continuer. Vérifiez la dernière question avant de renvoyer la même demande.
## Avant de commencer
- Gardez la conversation d'origine ouverte pour ne pas perdre l'état visible ou l'erreur.
- Attendez que toute action active se termine avant de réessayer.
- N'incluez pas de secrets, de détails de paiement ou de données client dans les preuves copiées.
## Liste de contrôle de récupération
1. Confirmez que vous êtes dans la conversation où le travail a commencé.
2. Lisez le dernier message Runner et l'état de la tâche.
3. Si Runner a posé une question, répondez à cette question avant d'envoyer une nouvelle demande.
4. Si la tâche s'est arrêtée, identifiez si elle a besoin d'une entrée, d'un accès, de crédits ou d'une demande corrigée.
5. Si elle a échoué, copiez l'erreur visible sans inclure de secrets ou de données client.
6. Réessayez une seule fois lorsque la page offre un nouveau essai et que la cause est transitoire.
7. Sinon, envoyez un suivi ciblé qui indique le résultat souhaité et ce qui ne va pas actuellement.
8. Vérifiez la vitrine, le paramètre ou l'actif affecté après que Runner signale l'achèvement.
## Problèmes courants
| Problème | Que faire |
| --- | --- |
| Rien ne se passe après l'envoi | Confirmez que le message apparaît dans la conversation et vérifiez les détails de la tâche pour un état d'attente. |
| Runner pose des questions répétées | Répondez à chaque champ obligatoire directement et évitez de changer l'objectif dans la même réponse. |
| La tâche s'arrête pour les crédits | Ouvrez les paramètres d'utilisation ou de plan ; ne reprenez pas à plusieurs reprises le travail inchangé. |
| Le résultat est incomplet | Nommez le résultat visible manquant dans un suivi. Joignez une capture d'écran lorsqu'elle aide à localiser le problème. |
| La mauvaise page a changé | Utilisez l'historique des versions le cas échéant, puis identifiez la page ou la section exacte dans la correction. |
| Un nouveau essai échoue de la même manière | Arrêtez de réessayer et contactez le support avec la conversation, l'état de la tâche et l'erreur. |
## Boutons et résultats
| Contrôle | Résultat |
| --- | --- |
| Détails de la tâche | Ouvre l'état, la progression et toute information de résultat disponible. |
| Contrôle de réponse ou d'option | Envoie la décision demandée et permet à la tâche de continuer. |
| Arrêter, si disponible | Termine l'exécution actuelle ; le travail inachevé peut rester incomplet. |
| Réessayer ou continuer | Démarre une autre tentative à partir de l'état que Runner supporte. Utilisez-le uniquement après avoir vérifié la cause. |
| Nouvelle conversation | Démarre une conversation séparée ; elle ne répare pas automatiquement la tâche d'origine. |
## Confirmer la récupération avant une autre demande
Après avoir répondu à une question, confirmez que votre réponse apparaît et que la tâche sort de son état d'attente. Après une correction, répétez l'action concernée dans le magasin. Si Runner ne peut pas déterminer si une action externe s'est terminée, vérifiez son résultat avant de réessayer pour éviter les doublons. Voir [États et détails des tâches](../work-with-runner/task-states-and-details) pour les commandes disponibles dans la conversation en cours.
## Guides connexes
- [Discuter avec Runner](../work-with-runner/chat-with-runner)
- [Quand Runner pose une question](../work-with-runner/answer-runner-questions)
- [Rédiger des demandes efficaces](../work-with-runner/write-effective-requests)
- [Support et communauté](./support-and-community)
---
# Dépanner les constructions de vitrines
Source: https://www.runnerai.com/docs/fr/guides/help-and-reference/troubleshoot-storefront-builds
L'aperçu est l'endroit le plus sûr pour trouver les problèmes de vitrine. Ne publiez pas tant que les pages et interactions importantes ne fonctionnent pas.
**Chemin d'entrée :** Magasin concerné → **Boutique en ligne** → contrôles d'aperçu.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Utilisez l’aperçu actuel de Storefront et ses contrôles de périphérique pour reproduire la page concernée avant la publication.
## Avant de commencer
- Ouvrez le magasin affecté et identifiez la page et la largeur de l'appareil où le problème apparaît.
- Laissez la dernière tâche Runner se terminer avant de comparer son résultat avec l'aperçu.
- Utilisez d'abord l'aperçu ; ne publiez pas un résultat cassé ou incertain comme test.
## Commencer dans la vitrine
1. Ouvrez le magasin affecté et sélectionnez **Boutique en ligne**.
2. Confirmez que l'aperçu affiche le projet attendu et la dernière version.
3. Rechargez l'aperçu une fois.
4. Vérifiez les vues de bureau et d'appareil mobile.
5. Ouvrez la page affectée via la navigation d'aperçu.
6. Comparez le résultat avec la dernière tâche Runner et l'historique des versions.
## Problèmes courants
| Ce que vous voyez | Ce qu'il faut vérifier |
| --- | --- |
| Aperçu vierge ou erreur | Attendez que la construction active se termine, rechargez une fois et inspectez la tâche actuelle pour une défaillance. |
| Ancien contenu | Confirmez que la dernière tâche s'est terminée et que l'aperçu est sur la version la plus récente. |
| Les ruptures de mise en page à une largeur | Reproduisez-la avec les contrôles d'appareil et dites à Runner la page, la section et la largeur. |
| Image manquante | Vérifiez la bibliothèque de médias, la sélection d'actifs et si l'image elle-même se charge. |
| Le lien ouvre la mauvaise page | Nommez le bouton source et la destination prévue dans une correction ciblée. |
| Le produit est manquant | Vérifiez que le produit existe et est disponible pour la vitrine, pas seulement que la page semble soignée. |
| Le changement du mode de conception est absent | Confirmez que la modification a été enregistrée ou appliquée, puis rouvrez la même page en aperçu. |
## Contrôles utiles
| Contrôle | Résultat |
| --- | --- |
| Actualiser l'aperçu | Recharge l'aperçu actuel sans le publier. |
| Sélecteur d'appareil | Change la largeur d'aperçu pour que vous puissiez inspecter les mises en page réactives. |
| Ouvrir l'aperçu ou la vue externe | Ouvre un aperçu plus grand ; cela ne rend pas le magasin en direct. |
| Mode de conception | Vous permet de sélectionner et d'ajuster le contenu visible de la vitrine. |
| Historique des versions | Affiche les versions enregistrées et les contrôles de restauration. La restauration change l'état du projet, alors vérifiez d'abord. |
## Escalader avec des preuves utiles
Incluez le nom du projet, la page, la taille de l'appareil, le résultat attendu, le résultat visible, l'état de la dernière tâche et une capture d'écran sans données personnelles ou client.
## Vérifier la correction
Une fois la tâche de réparation terminée, rechargez la même page affectée et répétez l'interaction à la largeur d'origine du périphérique. Vérifiez une deuxième largeur avant de publier. Une page d'accueil fonctionnelle ne constitue pas à elle seule un point de contrôle de réparation pour une page de produit ou un panier cassé.
### Vidéo : comparer les largeurs des appareils en aperçu
La vidéo passe entre les aperçus PC, Tablette et Téléphone. Il montre comment comparer les largeurs, et non une réparation d'erreur ou une modification publiée.
## Guides connexes
- [Prévisualiser votre magasin](../storefront-and-publishing/preview-your-store)
- [Mode de conception](../storefront-and-publishing/design-mode)
- [Historique des versions](../storefront-and-publishing/version-history)
- [Dépanner les tâches Runner](./troubleshoot-runner-tasks)
---
# Ouvrez votre première boutique
Source: https://www.runnerai.com/docs/fr/guides/open-your-first-store
Ce guide est un parcours unique et ordonné, d'une idée d'entreprise à une boutique capable d'encaisser de l'argent. Il s'adresse aux personnes qui n'ont jamais rien vendu en ligne et explique les notions de e-commerce au fil des étapes.
Vous êtes nouveau sur Runner ? Suivez [Créez votre première boutique](./start-here/first-store-quickstart), avec des captures d'écran et de courtes vidéos, puis revenez ici pour connaître les produits, l'expédition, les paiements et la configuration de l'entreprise.
Pour commencer, il vous faut une idée et une adresse e-mail. L'immatriculation d'une entreprise, un domaine et un compte Stripe arrivent plus tard, aux étapes où ils sont réellement nécessaires.
Vous vendez déjà sur Shopify ? Utilisez plutôt [Connecter Shopify](./start-here/connect-shopify). Ce guide décrit la création d'une boutique à partir de zéro.
## Trois états, et pourquoi ils sont distincts
Une boutique passe par trois états, et ils ne surviennent pas en même temps. Savoir dans lequel vous êtes évite l'essentiel de la confusion de ce processus.
| État | Ce que cela signifie | Ce que cela ne signifie pas |
| --- | --- | --- |
| **Aperçu** | Runner a construit votre vitrine et vous pouvez la regarder. | Elle n'est pas publique. |
| **Publié** | Le magasin possède une adresse Web publique et tout le monde peut la visiter. | La publication à elle seule ne prouve pas que le paiement est prêt ; le paiement et la configuration du fournisseur doivent également être vérifiés. |
| **Paiement prêt** | Stripe est connecté et une commande peut être payée. | C'est le moment où la boutique est ouverte au commerce. |
La publication est l'étape 7. Les paiements sont l'étape 9. Une boutique en ligne n'est pas forcément une boutique qui fonctionne.
## Comment utiliser ce guide
Onze étapes en quatre groupes.
| Groupe | Étapes |
| --- | --- |
| **Créer** | 1. Décider quoi vendre · 2. Construire votre vitrine |
| **Configurer** | 3. Détails de la boutique · 4. Produits · 5. Expédition · 6. Politiques et confiance |
| **Mise en ligne** | 7. Vérifier et publier · 8. Domaine personnalisé (facultatif) · 9. Connecter les paiements |
| **Développer** | 10. Premiers visiteurs · 11. Exploitation hebdomadaire |
Suivez-les dans l'ordre. Plusieurs étapes ultérieures échouent silencieusement si une précédente est incomplète : l'expédition ne s'enregistre pas sans emplacement de stock, les produits n'affichent pas de prix sans marché, et l'étape du domaine exige une publication réussie au préalable. L'étape 8 fait exception : elle est facultative et réalisable à tout moment après la publication.
Chaque étape se termine par un élément que vous pouvez vérifier vous-même. La **Liste de lancement** à la fin de ce guide les rassemble en un seul endroit.
Runner ne fait pas que construire la vitrine. Il peut chercher quoi vendre, suggérer des produits, rédiger des descriptions, créer et mettre à jour des fiches catalogue, et rédiger vos pages de politiques. Chaque étape comporte des invites à copier dans le chat. Si quelque chose ne fonctionne pas, décrivez-le : Runner peut lire l'état actuel de votre boutique et identifier ce qui manque.
Les compétences donnent à Runner un ensemble d'instructions répétables pour un type de travail. Ouvrez **Agent** dans la barre latérale, sélectionnez le filtre **Compétences**, puis utilisez **Découvrir** et recherchez la tâche que vous effectuez, telle que `market research`, `product description`, `policy` ou `SEO`. Voir [Compétences](./agent/skills).
**Si un assistant de configuration apparaît d'abord.** Les nouvelles boutiques peuvent ouvrir une configuration guidée qui demande en une seule fois les informations de base, l'expédition, un premier produit, le paiement et la visibilité. Elle couvre des parties des étapes 3, 4, 5 et 9 dans un autre ordre. Remplissez ce que vous pouvez, choisissez **Ignorer** pour le reste, puis complétez proprement les points ignorés avec les étapes ci-dessous. Voir [Intégration et paramètres généraux](./store-operations/onboarding-and-general-settings).
## Étape 1 — Décider quoi vendre
Le reste du processus va plus vite une fois ce point réglé. Prévoyez un après-midi.
Il vous faut trois réponses : ce que vous vendez, qui l'achète et d'où cela vient. La troisième influence plusieurs étapes suivantes.
- **Détenir votre propre stock.** Vous achetez ou fabriquez les produits et expédiez chaque commande vous-même. Marge plus élevée, plus de travail, et de l'argent dépensé avant la première vente.
- **Dropshipping.** Un fournisseur détient le stock et expédie chaque commande en votre nom. Démarrage plus rapide et aucun stock à acheter, mais marges plus faibles et moins de contrôle sur les délais.
Runner prend en charge les deux, et vous pouvez changer plus tard. Voir [Dropshipping](./store-operations/dropshipping).
**Demander à Runner**
> Je veux lancer une boutique mais je n'ai pas décidé quoi vendre. Je m'intéresse à
> [sujet] et je peux investir environ [budget]. Qu'est-ce qui se vend bien, et quels
> sont les avantages et inconvénients de chaque option ?
> Dois-je faire du dropshipping pour [produit] ou détenir mon propre stock ?
> C'est ma première boutique.
> Qui achète [produit] ? Qu'est-ce qui compte pour ces personnes, et quel prix
> attendent-elles ?
**Terminé lorsque** vous pouvez dire ce que vous vendez, qui l'achète et d'où cela vient. Conservez cette description : vous la collerez dans le chat à l'étape 2.
**À laisser de côté pour l'instant :** domaine, logo et immatriculation. Chacun coûte moins cher à décider une fois le produit arrêté.
## Étape 2 — Construire votre vitrine
Utilisez le [tutoriel illustré du premier magasin](./start-here/first-store-quickstart) pour créer votre boutique, envoyez la description de l'étape 1, examinez l'aperçu et demandez une modification ciblée.
Avant de continuer, vérifiez que :
- Le nouveau magasin apparaît dans votre espace de travail.
- Les principales pages d'aperçu s'ouvrent sur ordinateur et mobile.
- La modification que vous avez demandée est visible dans l'aperçu.
Un aperçu fonctionnel ne publie pas votre boutique. Continuez avec la configuration de l'entreprise ci-dessous ; la publication est l’étape 7.
## Étape 3 — Configurer les détails de la boutique
L'identité publique de votre boutique et ses zones de vente. Environ 10 minutes, et plusieurs étapes suivantes en dépendent.
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Général**
1. Ouvrez **Opérations de la boutique → Général**.
2. Saisissez le nom de la boutique, un e-mail de contact et votre adresse professionnelle. Le nom est limité à 30 caractères et l'e-mail doit être une adresse valide.
3. Sous **Markets**, ajoutez les pays où vous vendez et définissez la devise.
4. Sous **Emplacements de stock**, ajoutez l'adresse d'où partent les commandes. Une adresse personnelle convient.
5. Sélectionnez **Enregistrer** et attendez la confirmation.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Détail complet : [Intégration et paramètres généraux](./store-operations/onboarding-and-general-settings).
**Demander à Runner**
> Je vends vers [pays]. Quels réglages de marché et de devise dois-je utiliser ?
**Terminé lorsque** Général est enregistré avec un nom de boutique, un e-mail de contact valide, au moins un marché et un emplacement de stock.
**Bon à savoir**
- La devise se définit par marché, pas par produit. Un produit dont le prix est dans une devise hors de vos marchés enregistrés affiche un avertissement et peut ne pas montrer de prix sur la vitrine.
- La visibilité de la boutique et la publication sont deux choses différentes. **Visible pour les clients** contrôle si la vitrine affiche la boutique. Cela ne met pas votre code de vitrine en ligne : c'est l'étape 7.
- C'est un bon moment pour lancer Stripe. Les paiements sont l'étape 9, mais l'examen de vos informations par Stripe peut prendre du temps. Commencer maintenant fait passer l'attente en arrière-plan plutôt que le jour du lancement.
## Étape 4 — Ajouter vos produits
Il vous faut au moins un produit complet et vendable. La durée dépend entièrement de votre mode d'approvisionnement.
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Produits**
Trois voies, que vous pouvez combiner.
| Voie | Quand l'utiliser | Où |
| --- | --- | --- |
| **Créer manuellement** | Vous avez vos propres produits | **Produits → Ajouter** |
| **Dropshipping** | Un fournisseur stocke et expédie pour vous | **Opérations de la boutique → Dropshipping** |
| **Import CSV** | Votre catalogue est déjà dans un tableur | **Produits → Importer** |
Un catalogue vide affiche **Ajouter le premier produit** au lieu de **Ajouter** et **Importer**.
Un produit complet a besoin d'un nom et d'une description, d'un prix dans une devise correspondant à un marché enregistré, d'au moins une image, d'un stock et du statut **Publié**. Un produit en **Brouillon** n'apparaît pas aux clients. Les biens physiques ont aussi besoin du poids et des dimensions, dont dépendent l'expédition et la logistique.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Détail : [Produits](./store-operations/products) · [Dropshipping](./store-operations/dropshipping) · [Importer des produits](./store-operations/import-products) · [Stock et variantes](./store-operations/inventory-and-variants)
**Demandez à Runner.** Vous n'avez pas à remplir ces formulaires vous-même. Runner peut créer et mettre à jour produits, stock et images depuis le chat, et vous aider à choisir par quoi commencer.
> Par lequel devrais-je commencer ? [liste] — tiens compte de la marge et de la
> facilité d'expédition.
> Rédige une description pour [produit]. Ce qui compte le plus pour les clients est
> [point clé].
> Mets le stock de [produit] à 50 et marque la variante bleue en rupture.
> Vérifie mon catalogue et dis-moi quels produits n'ont pas d'image, de prix ou de stock.
Nommez la fiche et le résultat exact souhaité, et autorisez explicitement les changements destructifs.
**Terminé lorsque** au moins un produit est **Publié**, au prix dans une devise de marché enregistrée, avec une image et du stock, et apparaît dans l'aperçu de la vitrine.
**Bon à savoir**
- Les modifications de stock ne sont conservées qu'une fois un emplacement de stock enregistré. Cela fait partie de l'étape 3 — ajoutez-le là si vous l'avez ignoré.
- Les produits en dropshipping peuvent se comporter différemment des produits gérés manuellement pour le coût et le stock. Avant d'ajouter un article, confirmez une destination, un mode d'expédition utilisable et un prix de vente pour chaque variante.
- L'import CSV nécessite le modèle actuel de Runner. `Product Handle` et `Product Title` sont obligatoires ; les lignes de variantes utilisent les champs d'options du modèle, tandis que `Variant SKU` est facultatif.
## Étape 5 — Configurer l'expédition
Runner doit savoir d'où partent les commandes et ce que vous facturez pour les livrer. Environ 15 minutes.
L'ordre compte ici. L'expédition ne s'enregistre pas sans l'emplacement de stock et le marché enregistrés à l'étape 3.
**Chemin d'accès :** **Opérations de la boutique → Général → Livraison**
1. Ouvrez **Opérations de la boutique → Général**.
2. Vérifiez que l'**Emplacement de stock** enregistré à l'étape 3 est toujours en place. C'est l'adresse d'où partent les commandes.
3. Vérifiez qu'au moins un pays est enregistré sous **Markets**.
4. Allez dans **Livraison** et sélectionnez **Ajouter**.
5. Donnez à l'option un nom que les clients reconnaîtront, comme la vitesse ou le mode de livraison.
6. Choisissez le pays de destination sous **Livrer vers**, puis ouvrez **Frais de livraison**. Un tarif forfaitaire est le plus simple. Saisissez `0` pour que la livraison s'affiche comme gratuite.
7. Sélectionnez **Enregistrer** dans la boîte de dialogue, puis **Enregistrer** sur la page, et attendez la confirmation.
Pour les paliers par prix et les autres types de tarifs, voir [Expédition](./store-operations/shipping). Si un transporteur ou un fournisseur assure la livraison, une connexion sous **Apps** peut aussi être nécessaire — voir [Shippo](./apps-and-integrations/shippo-shipping), [CJ Dropshipping](./apps-and-integrations/cj-dropshipping) ou [Logistique 4PX](./apps-and-integrations/4px-fulfillment).
**Demander à Runner**
> J'expédie depuis [lieu] vers [pays]. Quelles options d'expédition dois-je configurer ?
> La livraison gratuite vaut-elle le coup sur un produit à [prix], ou dois-je la facturer ?
**Terminé lorsque** une option de livraison avec un prix apparaît au paiement. Ajoutez un produit au panier et vérifiez là, pas sur la page des paramètres.
**Bon à savoir**
- Une boutique sans option d'expédition valide paraît normale partout sauf au paiement, où le client ne peut pas finaliser sa commande. C'est une cause fréquente d'absence de ventes sur une boutique qui semble terminée.
- Les options d'expédition utilisent l'emplacement de stock enregistré dans Général. Il n'y a pas de sélecteur **Expédier depuis** distinct par ligne.
- L'enregistrement échoue sans région de marché par défaut. Enregistrez les marchés avant l'expédition.
- Les produits numériques, les réservations et les articles expédiés par un fournisseur peuvent suivre d'autres règles.
## Étape 6 — Rendre la boutique conforme et digne de confiance
Ce sont les pages qui disent aux clients qui vous êtes et ce qui se passe en cas de problème. Runner peut toutes les rédiger. Votre travail est de vérifier qu'elles correspondent à votre fonctionnement réel.
La plupart des boutiques ont besoin d'une politique de remboursement et de retour, d'une politique d'expédition avec des délais réalistes, d'une politique de confidentialité, de conditions générales, d'un moyen de contact et d'une page à propos.
**Demander à Runner**
> Rédige une politique de remboursement et de retour. Je vends [quoi], j'expédie depuis
> [lieu], et je veux une fenêtre de retour de [nombre] jours.
> Rédige les pages de politique de confidentialité et de conditions générales et
> ajoute-les au pied de page de la vitrine.
> Écris une page à propos à partir de ce que je t'ai dit de mon activité.
Vérifiez ensuite les brouillons :
1. Lisez chaque page et corrigez ce qui ne correspond pas à vos conditions réelles : fenêtre de retour, qui paie le retour, et durée réelle de livraison.
2. Vérifiez que les pages s'affichent sur la vitrine et sont liées dans le pied de page. Voir [Modifier le contenu, les pages et les médias](./storefront-and-publishing/edit-content-pages-and-media).
3. Vérifiez que l'adresse de contact correspond à l'e-mail enregistré à l'étape 3.
**Terminé lorsque** chaque page de politique s'ouvre depuis le pied de page de la vitrine et reflète vos conditions réelles.
**Bon à savoir.** Les brouillons sont un point de départ, pas un conseil juridique. L'immatriculation fiscale, les règles de protection des consommateurs et les mentions obligatoires dépendent de votre lieu d'activité et de ce que vous vendez. En cas de doute, consultez un professionnel local avant le lancement.
Les avis produits sont un autre signal de confiance, configuré dans Général. Activer les avis n'ajoute pas les composants manquants à une vitrine plus ancienne : demandez à Runner d'ajouter la fonctionnalité, puis publiez ce changement. Voir [Avis](./store-operations/reviews-and-advanced-admin).
## Étape 7 — Vérifier et publier
La publication met votre boutique en ligne à une adresse publique. Les vérifications prennent quelques minutes. Corriger ce qu'elles révèlent peut prendre plus longtemps.
**Chemin d'accès :** **Espace de travail → sélectionner une boutique → Vitrine → Publier**
1. Parcourez d'abord la [liste de préparation à la publication](./storefront-and-publishing/prepare-to-publish).
2. Ouvrez **Boutique en ligne** et sélectionnez le bouton de publication. Il indique **Publier**, **Publier les modifications** ou **Republier** selon l'état de la boutique.
3. Lisez **Confirmer le Déploiement** et attendez la fin de la vérification de la construction.
4. Résolvez chaque avertissement affiché, ou acceptez-le délibérément.
5. Ne sélectionnez **Confirmer** qu'après la réussite de la vérification.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Détail : [Publier et republier](./storefront-and-publishing/publish-and-republish).
**Demander à Runner**
> Vérifie si ma boutique est prête à être publiée et liste ce qui manque encore.
> La vérification de publication est bloquée sur [élément]. Que dois-je faire ?
**Terminé lorsque** l'URL publique de la boutique s'ouvre dans une fenêtre de navigation privée.
**Bon à savoir.** Deux choses surprennent à cette étape. Votre boutique est publique mais ne peut pas encore encaisser de paiements : c'est l'étape 9, celle qui ouvre réellement la boutique au commerce. Et les modifications ultérieures ne sont en ligne qu'après une nouvelle publication : enregistrer une modification en mode de conception, restaurer une version ou voir un aperçu correct ne met pas à jour la boutique publique.
Les changements dans Opérations de la boutique se comportent autrement. Produits, prix, stock et expédition s'appliquent sans republier.
**Si une vérification vous bloque,** utilisez l'action affichée sur l'élément — **Ouvrir Opérations de la boutique**, **Corriger avec l'IA** ou **Relancer la vérification**. Si cela persiste, voir [Résoudre publication, paiement et applications](./help-and-reference/troubleshoot-publishing-checkout-apps) et [Résoudre les builds de vitrine](./help-and-reference/troubleshoot-storefront-builds).
## Étape 8 — Connecter un domaine personnalisé (facultatif)
**Cette étape est facultative.** Votre boutique fonctionne déjà à l'adresse que Runner a fournie lors de la publication. Un domaine personnalisé relève de la marque, pas de la fonction. L'ignorer ne bloque ni les paiements ni les étapes suivantes, et vous pouvez y revenir à tout moment.
La configuration prend environ 10 minutes, suivie d'une attente de propagation DNS. La boutique doit d'abord avoir été publiée avec succès, et l'accès dépend de votre offre.
**Chemin d'accès :** **Boutique en ligne** → menu du site publié → **Paramètres du domaine**. Sur mobile, ou si ce menu est masqué, utilisez **Paramètres → Store : _nom du magasin_ → Domaine** dans l'espace de travail.
1. Ouvrez **Paramètres du domaine** par l'un des chemins ci-dessus.
2. Achetez un domaine via Runner, ou ajoutez-en un que vous possédez déjà.
3. Si vous ajoutez le vôtre, copiez les enregistrements DNS affichés par Runner dans les paramètres de votre bureau d'enregistrement.
4. Attendez la vérification. La ligne du domaine affiche un avertissement tant que les enregistrements ne sont pas résolus.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Détail : [Connecter un domaine personnalisé](./storefront-and-publishing/custom-domains).
**Terminé lorsque** votre domaine ouvre la boutique — ou lorsque vous avez décidé d'y revenir plus tard.
**Bon à savoir**
- **Domaine ajouté avec succès** confirme seulement que le domaine est rattaché à votre boutique, pas que le DNS fonctionne. Les deux sont vérifiés séparément, et les changements DNS peuvent prendre plusieurs heures.
- Acheter ou renouveler un domaine lance un flux de paiement externe. Vérifiez les informations affichées avant de continuer.
- Si vous lancez bientôt, connectez d'abord les paiements. Une boutique à l'adresse par défaut qui encaisse vaut mieux qu'une boutique de marque qui n'encaisse pas.
## Étape 9 — Connecter les paiements
C'est l'étape qui ouvre la boutique au commerce. Tout ce qui précède était de la préparation.
Votre boutique peut déjà être en ligne et paraître terminée. Tant que cette étape n'est pas faite, un client qui veut acheter ne peut pas finaliser son achat.
**Chemin d'entrée :** **Apps → Gérez votre boutique → Stripe**. Après la publication, Runner peut également afficher **Connecter Stripe** dans le transfert du magasin, ce qui ouvre la même configuration.
Stripe collecte des informations sur l'entreprise, votre identité et vos coordonnées bancaires pour les versements. Préparez-les et utilisez un navigateur qui autorise l'ouverture de la fenêtre Stripe.
1. Ouvrez **Apps → Gérez votre boutique → Stripe** et sélectionnez **Connecter**.
2. Terminez la configuration Stripe dans la nouvelle fenêtre.
3. Revenez dans Runner et vérifiez que la connexion est indiquée comme activée.
| État | Signification |
| --- | --- |
| **Connexion en cours...** | Runner prépare le compte ou le lien de configuration. Attendez un résultat. |
| **Examen en cours** | Stripe examine vos informations. C'est le processus de Stripe, pas une erreur de Runner, et cela peut prendre du temps. |
| **Actions Stripe requises** | Un point précis reste à traiter. Ouvrez-le pour voir ce qui est **À fournir maintenant**, **À fournir plus tard** ou **Examen en cours**. |
| **Reconnecter** ou **Poursuivre l'intégration** | Un compte existe mais n'est pas terminé. La sélection reprend le même compte. |
Détail : [Connecter Stripe pour les paiements](./apps-and-integrations/stripe-payments).
Ouvrez votre boutique sur un téléphone. Vérifiez un produit, ajoutez-le au panier, saisissez une adresse de livraison et confirmez qu'une option d'expédition et l'étape de paiement apparaissent. Arrêtez-vous avant de soumettre le paiement.
Si vous choisissez de tester un paiement réel, passez une commande test délibérée et examinez-la dans [Commandes](./store-operations/orders). Une charge réelle et tout remboursement peuvent entraîner des frais ; ceci est facultatif et distinct de la procédure pas à pas de configuration.
**Demander à Runner**
> Stripe affiche [état]. Qu'est-ce que cela signifie et que dois-je faire ensuite ?
> Un client dit que le paiement ne fonctionne pas. Que dois-je vérifier ?
**Vous avez terminé lorsque** Stripe n'affiche aucune action de configuration bloquante et que votre produit, votre panier, votre option d'expédition et votre étape de paiement fonctionnent ensemble. Ces contrôles confirment la préparation au paiement ; seul un paiement effectué confirme une transaction réelle.
**Bon à savoir.** Une URL en ligne ne prouve pas que les paiements sont disponibles. La vitrine peut être publiée alors que le paiement est encore suspendu ou en cours de vérification. Voir [Boutique en ligne et paiement](./storefront-and-publishing/live-store-and-checkout).
## Étape 10 — Obtenir vos premiers visiteurs
Personne n'arrive tout seul. Commencez par ce qui ne coûte rien, et ne dépensez pas en publicité avant que l'étape 9 soit confirmée.
- **Recherche.** Les titres et descriptions de produits pèsent le plus pour une nouvelle boutique. Voir [Aperçu du SEO](./analytics-and-seo/seo-overview) et [Performance de recherche](./analytics-and-seo/search-performance).
- **Analyses.** Vérifiez que les visites sont enregistrées avant de juger quoi que ce soit. Voir [Aperçu des analyses](./analytics-and-seo/analytics-overview).
- **Visibilité IA.** Comment votre boutique apparaît quand des personnes demandent des recommandations à des assistants IA. Voir [Visibilité IA](./analytics-and-seo/ai-visibility).
- **Création.** Images et variantes publicitaires depuis le [Creative Studio](./automate-test-and-create/creative-studio), et campagnes via [Runner Ads](./automate-test-and-create/runner-ads).
**Demander à Runner**
> Améliore les titres et descriptions SEO de mes pages produit.
> Crée trois visuels publicitaires pour [produit] destinés à [audience].
> Ma boutique est en ligne depuis une semaine sans vente. Que dois-je vérifier d'abord ?
**Terminé lorsque** les analyses montrent des sessions provenant d'autres personnes que vous.
**Bon à savoir.** Un trafic faible et une conversion faible sont deux problèmes différents, aux solutions différentes. Vérifiez d'abord le trafic : la conversion ne se diagnostique pas sur dix visites. Voir [Trafic et conversion](./analytics-and-seo/traffic-and-conversion). Si les analyses n'affichent rien du tout, confirmez que la boutique est publiée et la source de données connectée avant de changer autre chose. Voir [Résoudre les données et la publication](./analytics-and-seo/troubleshoot-data-and-publication).
## Étape 11 — Exploiter votre boutique chaque semaine
Une courte routine garde la boutique en bonne santé une fois les commandes lancées.
1. Vérifiez les [Commandes](./store-operations/orders) et traitez ce qui est en attente.
2. Répondez aux messages clients et gérez les retours. Voir [Clients](./store-operations/customers).
3. Vérifiez les niveaux de stock dans [Stock et variantes](./store-operations/inventory-and-variants).
4. Consultez les [Analyses](./analytics-and-seo/analytics-overview) pour voir ce qui a changé depuis la semaine passée.
Quand vous avez assez de trafic, testez les changements plutôt que de deviner avec les [Expériences](./automate-test-and-create/experiments), confiez le travail répétitif aux [Automatisations](./automate-test-and-create/automations), et lancez des [Promotions](./store-operations/promotions) sur des produits ou des périodes précises.
**Demander à Runner**
> Résume les commandes de cette semaine et signale ce qui demande attention.
> Quels produits se sont le mieux vendus ce mois-ci, et lesquels ne bougent pas ?
**Bon à savoir.** Les modifications de vitrine doivent être republiées avant que les clients les voient. Les changements dans Opérations de la boutique s'appliquent sans republier. Avant d'autoriser depuis le chat une action destructive ou touchant au cycle de vie d'une commande, demandez à Runner d'inspecter l'état actuel, puis autorisez l'effet exact souhaité.
## Liste de lancement
Chaque élément est vérifiable par vous-même. Si vous confirmez les huit éléments requis, votre boutique est ouverte au commerce.
**Obligatoire**
- [ ] Vous pouvez dire ce que vous vendez, qui l'achète et d'où cela vient. (Étape 1)
- [ ] L'aperçu de la vitrine se charge et vos pages principales fonctionnent sur ordinateur et mobile. (Étape 2)
- [ ] Général est enregistré avec un nom de boutique, un e-mail de contact valide, au moins un marché et un emplacement de stock. (Étape 3)
- [ ] Au moins un produit est publié, au prix dans une devise de marché enregistrée, avec image et stock. (Étape 4)
- [ ] Une option de livraison avec un prix apparaît au paiement quand vous ajoutez un produit au panier. (Étape 5)
- [ ] Vos pages de politiques s'ouvrent depuis le pied de page et correspondent à vos conditions réelles. (Étape 6)
- [ ] L'URL publique de la boutique s'ouvre dans une fenêtre de navigation privée. (Étape 7)
- [ ] Stripe n'a aucune action de configuration bloquante et le panier atteint l'étape de paiement avec l'option d'expédition attendue. (Étape 9)
**Facultatif, à tout moment après la publication**
- [ ] Votre domaine personnalisé ouvre la boutique. (Étape 8)
**Après le lancement**
- [ ] Les analyses montrent des sessions provenant d'autres personnes que vous. (Étape 10)
- [ ] Vous avez une routine hebdomadaire pour commandes, stock et clients. (Étape 11)
Si un élément ne se confirme pas, décrivez ce que vous voyez dans le chat.
> Vérifie ma boutique par rapport à la liste de lancement et dis-moi ce qui est
> encore incomplet.
## Guides associés
- [Démarrer avec Runner](./start-here)
- [Discuter avec Runner](./work-with-runner/chat-with-runner)
- [Opérations de la boutique](./store-operations)
- [Applications et intégrations](./apps-and-integrations)
- [Aide et référence](./help-and-reference)
- [Glossaire](./help-and-reference/glossary)
---
# Forfaits et facturation
Source: https://www.runnerai.com/docs/fr/guides/plans-and-billing
Runner mesure le travail en crédits et vend la capacité sous forme d'abonnement. Ces deux pages séparent la décision du quotidien : sur l'une vous choisissez et gérez un forfait, sur l'autre vous lisez et optimisez le solde obtenu.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Cette capture montre Free, Plus et Pro. Faites défiler la page pour voir Max ; utilisez les montants actuels de votre compte et de la confirmation de paiement plutôt que les prix de cette capture.
| Votre objectif | Commencez ici |
| --- | --- |
| Comparer Gratuit, Plus, Pro et Max, ou changer un abonnement | [Forfaits d'abonnement](/fr/guides/plans-and-billing/subscription-plans) |
| Voir ce qu'un solde permet, lire l'utilisation ou gagner des crédits | [Crédits et utilisation](/fr/guides/plans-and-billing/credits-and-usage) |
Ouvrez le menu de l'espace de travail concerné → **Paramètres → Plan et Facturation** pour comparer les forfaits, ou **Utilisation et crédits** pour consulter les dépenses. La [page Tarifs](https://www.runnerai.com/pricing), votre compte et la confirmation avant paiement indiquent les valeurs applicables.
---
# Crédits et utilisation
Source: https://www.runnerai.com/docs/fr/guides/plans-and-billing/credits-and-usage
Les crédits sont l'unité d'utilisation universelle de Runner. Les opérations admissibles de LLM, d'image, de vidéo, d'automatisation, de workflow, de simulation, de compétence et de déploiement sont toutes déduites d'un seul solde affiché.
## Ce que couvre ce guide
Estimer ce qu'un solde permet, sélectionner une plage de rapport et lire chaque bloc par rapport à cette même plage, gagner des crédits bonus et comprendre comment l'utilisation est enregistrée.
## Disponibilité et conditions préalables
- L'utilisation est limitée à l'espace de travail actuel, pas un seul magasin.
- Les données peuvent être vides lorsque l'espace de travail n'a pas utilisé de crédits dans la plage sélectionnée.
- L'admissibilité des subventions de crédit, de l'expiration et de l'achat dépend de la subvention ou du plan affiché dans votre compte.
- Utilisez **Utilisation et crédits** pour votre solde et vos dépenses enregistrées ; utilisez la confirmation d'achat actuelle pour les prix.
## Chemin d'accès
Ouvrez l'[espace de travail souhaité](/fr/guides/workspace), puis sélectionnez **Paramètres → Utilisation et Crédits**. Confirmez le nom de l'espace de travail dans la barre latérale des paramètres.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Ouvrez **Utilisation et crédits** sous l'espace de travail prévu. Cette image montre l'entrée, pas un solde ou une utilisation enregistrée ; inspectez ces valeurs dans votre propre espace de travail.
## Ce qu'un solde permet
Utilisez vos propres tâches récentes pour estimer le prochain changement similaire. Commencez par une petite demande bien définie, puis vérifiez ses crédits enregistrés dans l'activité de l'espace de travail. Le choix du modèle, la taille du contexte, la longueur de la sortie, les médias, les nouvelles tentatives et la complexité des tâches modifient tous le total ; il n'y a pas de prix fixe par message ni de nombre garanti de créations de magasins par solde.
### Estimez votre prochaine construction de magasin
1. Ouvrez **Paramètres → Utilisation et Crédits** dans l'espace de travail où vous allez créer.
2. Faites une petite demande représentative, puis recherchez ses dépenses enregistrées dans **Activité de l’espace de travail**.
3. Comparez les tâches récentes de portée et de choix de modèle similaires. Estimez séparément la génération initiale et les révisions ultérieures.
4. Ajoutez le travail que vous prévoyez de répéter et prévoyez la génération de médias, les nouvelles tentatives et les modifications plus importantes. Vérifiez à nouveau les dépenses enregistrées après chaque étape.
Par exemple, **si votre propre activité** enregistre 200 crédits pour la génération et 20 crédits pour chacune des trois révisions similaires, ces tâches totalisent **260 crédits**. Ces chiffres illustrent le calcul ; ce ne sont pas des coûts typiques, une référence ou un devis pour votre prochain magasin.
**Vérifiez :** Votre estimation provient de tâches enregistrées comparables. Un solde de crédits ne garantit pas un nombre fixe de magasins ou de révisions.
Pour connaître l'allocation mensuelle incluse avec chaque forfait, voir [Forfaits d'abonnement](./subscription-plans).
## Contrôles et rapports
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| **7 jours** | Inspectez l'activité récente. | Chaque graphique, résumé, catégorie et bloc d'activité se mettent à jour à sept jours. |
| **Ce cycle** | Consultez la fenêtre du cycle de facturation actuel. | La page utilise le cycle actuel écoulé affiché pour l'espace de travail. |
| **90 jours** | Recherchez une tendance plus longue. | Chaque bloc d'utilisation se met à jour à la plage plus longue. |
| Carte Crédits restants | Voyez les crédits restants et totaux pour le plan/les subventions actuels. | La barre de progression et la date d'actualisation affichée expliquent l'état du solde actuel. |
| **Mettre à niveau** | Comparez les plans lorsque plus de capacité incluse est nécessaire. | Runner ouvre **Plan et Facturation**. |
| **Acheter des crédits** | Consultez un achat de crédit supplémentaire admissible. | Runner ouvre **Plan et Facturation** ; aucun achat n'a lieu jusqu'à ce que sa confirmation soit complétée. |
| Crédits par jour | Trouvez les dates chargées ou calmes. | Survoler une barre affiche l'utilisation de ce jour. |
| D'où venaient vos crédits | Comprenez les subventions de plan, quotidiennes, d'inscription, achetées et autres qui s'appliquent. | Chaque ligne affiche la source, la cadence, la note et les crédits. |
| Où vos crédits sont allés | Comparez les catégories de dépenses et les comptages d'exécution. | Les barres affichent la part de chaque catégorie pour la plage sélectionnée. |
| Activité de l'espace de travail | Inspectez les tâches récentes derrière les dépenses. | Les onglets de catégorie filtrent les mêmes colonnes Tâche, Projet, Type, Crédits et Heure. |
## Consultez l'utilisation
1. Ouvrez **Espace de travail → Utilisation et Crédits**.
2. Sélectionnez **7 jours**, **Ce cycle** ou **90 jours**.
3. Lisez **Crédits restants** avant d'interpréter les dépenses.
4. Comparez **Utilisé dans la plage**, **Moyenne quotidienne** et **Jour le plus actif**.
5. Utilisez **Crédits par jour** pour trouver quand l'utilisation a changé.
6. Comparez les sources avec les catégories de dépenses.
7. Filtrez **Activité de l'espace de travail** pour identifier les tâches impliquées.
8. Si vous avez besoin de plus de capacité, ouvrez **Mettre à niveau** ou **Acheter des crédits**, puis consultez la confirmation de facturation séparée.
## Gagnez des crédits bonus
Ouvrez la connexion quotidienne ou la quête affichée dans votre compte et lisez la récompense avant de la réclamer. Après l'avoir reçue, revenez à **Utilisation et crédits** et vérifiez la source et le solde.
Les connexions quotidiennes, les bonus de jours consécutifs et les quêtes d'introduction ont des conditions d'accès et des limites distinctes. Lisez le plafond et l'expiration de chaque attribution ; le plafond mensuel de gains diffère du solde maximal de bonus conservé. Les crédits bonus ne se reportent pas indéfiniment.
## Comment l'utilisation est enregistrée
- L'utilisation est enregistrée après la fin d'une opération et peut prendre un peu de temps à apparaître.
- Une seule demande peut produire plusieurs enregistrements lorsque Runner utilise plusieurs modèles, outils, opérations média, simulations ou déploiements.
- Si un total semble inattendu, comparez l'horodatage, le projet, le type d'action, le modèle ou le fournisseur et les éventuelles nouvelles tentatives avant de contacter le support.
## Comprenez les chiffres
- Le solde restant et les dépenses de plage sélectionnée répondent à des questions différentes ; ils n'ont pas besoin d'être égaux.
- Le graphique Crédits par jour signale les dépenses quotidiennes, tandis que la carte source signale les subventions et le solde restant.
- Une catégorie peut afficher des exécutions avec zéro dépense de crédit.
- Les lignes d'activité affichent les tâches récentes pour l'analyse, pas un journal d'audit permanent complet.
- Les dates utilisent le fuseau horaire de votre appareil actuel.
## Questions fréquentes
| Question | Réponse |
| --- | --- |
| Pourquoi deux invites similaires ont-elles consommé des montants différents ? | Elles ont pu utiliser des tailles de contexte, longueurs de sortie, outils, modèles, étapes d'agent, nouvelles tentatives, replis, médias, simulations ou déploiements différents. |
| L'envoi d'un message consomme-t-il un nombre fixe de crédits ? | Non. Les crédits suivent les opérations mesurées réellement effectuées pour la demande. |
| Les modifications manuelles consomment-elles des crédits ? | Modifier vous-même du contenu ou du code ne crée aucune utilisation de modèle. Demander à Runner de faire ou d'expliquer la modification le peut. |
| Les demandes échouées sont-elles toujours gratuites ? | Pas nécessairement. Un échec sans utilisation signalée par le fournisseur n'a aucun coût de modèle, mais l'utilisation signalée avant un échec, ou lors d'une autre tentative réussie, peut être enregistrée. |
| Une compétence est-elle facturée séparément ? | Non. Activer une compétence n'ajoute aucun frais fixe ; les opérations qu'elle effectue sont déduites du même solde. |
| Les crédits bonus sont-ils reportés ? | Lisez l'expiration de chaque attribution. Les plafonds des connexions quotidiennes, du solde conservé et des bonus de jours consécutifs peuvent suivre des règles différentes. |
| Comment fonctionne le bonus de la septième connexion ? | Chaque connexion quotidienne admissible attribue 10 crédits, et chaque septième réclamation consécutive ajoute un bonus de série. L'écran de réclamation affiche le montant actuel avant que vous le collectiez. |
| Un Pack Boost est-il un abonnement ? | Non. C'est un achat unique de 350 crédits pour 9,90 USD. |
## États et limites
- **Crédits épuisés** met en évidence un solde restant nul et garde les actions de facturation disponibles.
- L'activité vide indique qu'il n'y a pas de journaux pour le filtre ou la plage actuels.
- Une source peut afficher zéro lorsqu'elle est exploitable mais pas encore réclamée.
- Les types de subventions passives n'apparaissent que lorsqu'ils ont contribué des crédits.
- Le chargement couvre à la fois les données de solde et de consommation ; attendez que toutes les cartes se comparent.
## Dépannage
- Si deux chiffres semblent incohérents, confirmez que chaque bloc utilise la même plage sélectionnée.
- Si une tâche est manquante, effacez le filtre de catégorie d'activité et essayez une plage plus longue.
- Si le solde n'a pas changé après un achat, retournez à Plan & Facturation et confirmez que l'achat a atteint un état terminé avant d'actualiser.
- Si aucune utilisation n'apparaît, vérifiez que vous avez ouvert l'espace de travail où la tâche a été exécutée.
- Si vous avez besoin d'une décision de charge ou de plan, utilisez Plan & Facturation plutôt qu'une ancienne capture d'écran d'utilisation.
- Pour un débit inattendu ou une exigence de traitement des données, écrivez à team@adaptivemachines.ai en indiquant l'espace de travail, le projet, l'horodatage approximatif et les détails de l'événement d'utilisation.
## Guides connexes
- [Forfaits d'abonnement](./subscription-plans)
- [Général de l’espace de travail](../account-and-settings/workspace-general)
- [Personnalisation de l'agent](../agent)
---
# Forfaits d'abonnement
Source: https://www.runnerai.com/docs/fr/guides/plans-and-billing/subscription-plans
Plan & Facturation est l'endroit au niveau de l'espace de travail pour les abonnements, les changements de plan, la gestion de la facturation et les achats de crédits supplémentaires admissibles. Utilisez les valeurs affichées car les noms de plan, les limites et les prix peuvent changer.
## Ce que couvre ce guide
Comparer les forfaits Runner et ce que chacun inclut, examiner une action de plan avant le paiement, reconnaître les changements programmés ou en attente, et ouvrir la gestion de facturation sécurisée.
## Disponibilité et conditions préalables
- Ouvrez l'espace de travail dont vous avez l'intention de gérer le plan.
- Les actions de facturation peuvent nécessiter la permission de facturation de l'espace de travail.
- Les Packs Boost nécessitent un abonnement actif admissible.
- Un abonnement en retard ou hérité peut afficher des contrôles différents ou bloquer une nouvelle action.
## Chemin d'accès
Ouvrez l'espace de travail souhaité, puis sélectionnez **Paramètres → Plan et Facturation**. Confirmez le nom de l'espace de travail dans la barre latérale des paramètres.
La page publique des tarifs et Plan & Facturation s'ouvrent sur **Mensuel** par défaut. Un abonnement existant ou un lien explicite vers une période de facturation peut ouvrir la période correspondante à la place.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Free, Plus et Pro sont visibles dans cet instantané ; faites défiler pour Max. Les prix sont un exemple d’interface daté. Vérifiez la période de facturation en cours et le total avant tout paiement.
## Comparez les forfaits
Ce tableau résume les forfaits. La [page Tarifs](https://www.runnerai.com/pricing) actuelle et la confirmation affichée avant le paiement font foi.
| Forfait | Crédits inclus | Accès aux modèles et fonctionnalités | Idéal pour |
| --- | --- | --- | --- |
| Gratuit | 150 crédits à l'inscription, plus jusqu'à 250 via les quêtes d'introduction | Runner Lite, et des aperçus limités de certaines fonctionnalités avancées | Essayer Runner et générer une première boutique |
| Plus | 1 000 crédits rechargés chaque mois | Runner Lite, et des aperçus limités de certaines fonctionnalités avancées | Petites modifications régulières et itération continue sur une boutique |
| Pro | 2 500 crédits rechargés chaque mois | Runner Pro, plus Creative Studio, automatisations, workflows, simulations, Expériences et Ads | Construction complexe et ensemble de fonctionnalités avancées |
| Max | 10 000 crédits rechargés chaque mois | Runner Max, plus des limites de sortie plus élevées et un traitement prioritaire en période de forte affluence | Travail intensif ou urgent, selon disponibilité |
La disponibilité, la durée et les limites des aperçus peuvent varier pendant le déploiement et apparaissent dans votre compte. Pour savoir ce que ces crédits permettent concrètement, consultez [Crédits et utilisation](./credits-and-usage).
## Modèles Runner
Runner propose trois modèles pour choisir l'équilibre entre qualité, vitesse et crédits sans gérer les identifiants de modèle des fournisseurs.
| Modèle | Inclus avec | Compromis prévu |
| --- | --- | --- |
| Runner Lite | Gratuit et Plus | Travail rapide et économique pour les tâches simples |
| Runner Pro | Pro | Capacité équilibrée pour la construction complexe et les fonctionnalités avancées |
| Runner Max | Max | Capacité maximale, limites de sortie plus élevées et accès prioritaire en cas de forte affluence |
Utilisez le sélecteur de modèle pour voir les choix disponibles pour la tâche en cours. La disponibilité peut changer ; un plan ne promet pas une liste permanente de modèles de fournisseurs sous-jacents.
## Contrôles
| Entrée ou bouton | Pourquoi c'est utile | Ce qui se passe ensuite |
| --- | --- | --- |
| Banneau du plan actuel | Confirmez quel plan d'espace de travail est actif et son statut affiché. | Runner peut afficher les informations de renouvellement, de fin, de validité ou de changement en attente. |
| **Mensuel / Annuel · Économisez 20 %** | Comparez les forfaits dans la période de facturation souhaitée. | Mise à jour des cartes de forfait. Le mensuel peut être désactivé pour un engagement annuel actif. |
| Carte de plan | Comparez les fonctionnalités incluses et les limites. | La sélection d'une action disponible passe à une étape de confirmation de plan. |
| **Mettre à niveau** ou action de changement de période | Commencez un changement de plan. | Runner affiche une confirmation, programme le changement, demande le paiement ou ouvre le paiement selon l'état du compte. |
| **Gérer** / **Gérer la facturation** | Mettez à jour les méthodes de paiement, consultez les factures ou gérez l'annulation. | Runner ouvre le portail de facturation sécurisé. |
| **Annuler** à côté d'un changement en attente | Retirez un changement de plan programmé. | Runner actualise l'abonnement actuel après succès. |
| Pack de crédits supplémentaires | Achetez des crédits supplémentaires lorsque admissible. | La quantité et le total sont affichés avant **Confirmer l'achat**. |
## Examinez un changement de plan
1. Ouvrez **Espace de travail → Plan et Facturation**.
2. Confirmez l'espace de travail et le banneau du plan actuel.
3. Sélectionnez **Mensuel** ou **Annuel · Économisez 20 %** si les deux sont disponibles.
4. Consultez les cartes de plan actuelles, les limites de fonctionnalités et le montant affiché.
5. Sélectionnez l'action de plan prévue.
6. Lisez attentivement la confirmation. Pour Annuel, comparez le total annuel, et pas seulement un équivalent mensuel affiché. Fermez ou annulez la boîte de dialogue si vous comparez uniquement ; ne continuez pas si le plan, la période ou le montant est erroné.
7. Complétez le paiement uniquement sur la page de paiement sécurisée ou de facturation.
8. Retournez à Plan & Facturation et confirmez le statut résultant. Une redirection de chargement ou de paiement seule n'est pas la preuve que le plan a changé.
## Gérez la facturation ou l'annulation
1. Sélectionnez **Gérer** ou **Gérer la facturation** sur l'abonnement actuel.
2. Utilisez le portail de facturation sécurisé pour les méthodes de paiement, les factures et les options d'annulation présentées à votre compte.
3. Consultez la confirmation finale du portail avant de soumettre une action financière ou d'annulation.
4. Retournez à Runner et vérifiez le banneau du plan actuel, l'avis de fin/renouvellement ou le changement en attente.
## Achetez un Pack Boost
Un Pack Boost est un achat unique de 350 crédits pour 9,90 USD, hors taxes applicables. Ce n'est pas un abonnement, et ses crédits s'ajoutent au même solde universel.
1. Confirmez qu'un abonnement actif est affiché.
2. Ouvrez le Pack de crédits supplémentaires.
3. Choisissez la quantité.
4. Consultez le total des crédits et le prix total.
5. Sélectionnez **Confirmer l'achat** uniquement lorsque les deux sont corrects.
6. Attendez **Achat terminé** et vérifiez le solde dans [Crédits et utilisation](./credits-and-usage).
C'est une action financière. Fermer la confirmation laisse l'achat non soumis. Le paiement affiche le prix actuel, la quantité, l'expiration et les conditions de paiement avant l'achat.
## États et limites
- Les états **Active**, **Échu**, **Annulation**, inactif, hérité et changement en attente peuvent exposer des actions différentes.
- Un abonnement précédent expiré peut afficher **Renouveler** au lieu des choix affichés pour un espace de travail gratuit jamais payé. Attendez que les détails de facturation se chargent avant de sélectionner Renouveler.
- Un engagement annuel peut désactiver les choix Mensuel.
- Un changement de plan peut être immédiat, programmé ou en attente d'un paiement supplémentaire. Utilisez le statut que Runner affiche après la demande.
- **Configuration de votre abonnement** signifie que Runner confirme toujours l'état de paiement retourné.
- Un délai d'expiration du traitement vous demande d'actualiser et de vérifier ; il ne prouve pas l'échec ou le succès.
- L'achat de crédits supplémentaires n'est pas disponible sans un abonnement actif admissible.
## Dépannage
- Si le mauvais espace de travail est affiché, fermez Paramètres et rouvrez-le à partir de l'espace de travail prévu.
- Si le bouton Mensuel est désactivé, consultez l'engagement annuel actuel affiché sur la page.
- Si la gestion de la facturation ne s'ouvre pas, réessayez une fois et laissez la page de facturation sécurisée s'ouvrir.
- Si l'abonnement est En retard, suivez l'action de facturation affichée avant de tenter un autre changement de plan.
- Si le paiement revient à un état de traitement, actualisez et vérifiez avant de soumettre à nouveau pour éviter une tentative en double.
## Guides connexes
- [Crédits et utilisation](./credits-and-usage)
- [Général de l’espace de travail](../account-and-settings/workspace-general)
- [Supprimer, récupérer et quitter](../account-and-settings/delete-recover-and-leave)
- [Compétences de l'agent](../agent/skills)
---
# Bienvenue dans Runner AI
Source: https://www.runnerai.com/docs/fr/guides/product-guide
Runner vous aide à transformer une idée commerciale en un magasin en ligne fonctionnel, puis à gérer le magasin à partir d'un seul espace de travail. Ces guides expliquent chaque page majeure, entrée, bouton, état et prochaine étape sûre en langage clair.
**[Créer votre premier magasin, étape par étape](./start-here/first-store-quickstart)**
Suivez des captures d'écran et de courtes vidéos pour créer une boutique, envoyez votre première demande, vérifiez l'aperçu et préparez-vous à publier.
## Commencez par le chemin qui correspond à votre objectif
**Démarrer**
- [Explorer Runner avant de créer un compte](./start-here/explore-runner-before-sign-in)
**Explorer Runner avant la connexion** — Comprendre la navigation publique actuelle, la langue, la démo et les actions de connexion.
- [Évaluer un modèle de boutique terminé](./start-here/browse-and-remix-templates)
**Parcourir et remixer les modèles de boutique** — Comparer les aperçus publics et comprendre si le remixage est actuellement disponible.
- [Créer votre premier magasin Runner](./start-here/create-runner-store)
**Créer un magasin Runner** — Créez un projet, envoyez la première demande et accédez à l'espace de travail du magasin.
- [Utiliser un magasin Shopify existant](./start-here/connect-shopify)
**Connecter Shopify** — Démarrez le chemin de connexion Shopify et comprenez ce qui reste dans Shopify.
**Créer**
- [Demander à Runner de créer ou de modifier quelque chose](./work-with-runner/chat-with-runner)
**Discuter avec Runner** — Envoyez une demande claire, répondez aux questions de suivi et suivez la progression des tâches.
- [Examiner la vitrine](./storefront-and-publishing/preview-your-store)
**Prévisualiser votre boutique** — Ouvrez l'aperçu actuel et vérifiez les mises en page de bureau ou mobile.
- [Mettre le magasin en ligne](./storefront-and-publishing/prepare-to-publish)
**Préparer la publication** — Complétez la configuration requise avant de sélectionner **Publier**.
**Gérer**
- [Ajouter et gérer les produits](./store-operations/products)
**Produits** — Trouvez les contrôles de produit et comprenez le résultat de chaque action.
- [Connecter les paiements, l'expédition ou l'e-mail](./apps-and-integrations)
**Applications et intégrations** — Connectez, inspectez, reconnectez ou déconnectez les services pris en charge.
**Mettre à niveau**
- [Comprendre les performances](./analytics-and-seo)
**Analyse et référencement** — Lisez les vues de magasin, de trafic, de conversion, de recherche et de visibilité IA.
- [Trouver une fonctionnalité manquante ou verrouillée](./advanced/feature-availability)
**Disponibilité des fonctionnalités** — Identifiez les conditions préalables et la prochaine étape la plus sûre sans deviner.
- [Récupérer après un problème](./help-and-reference)
**Aide et référence** — Diagnostiquez les états de tâche, de construction, de publication, de paiement ou d'intégration.
## Le parcours habituel
1. [Connectez-vous](./start-here/sign-in) et entrez dans votre espace de travail.
2. Ouvrez le menu du nom du magasin dans la barre latérale et sélectionnez **Créer un magasin**. Dans un espace de travail vide, utilisez **Créer un magasin** ou **+ Store** si affiché. Choisissez **Partir de zéro** ou **Connecter Shopify** uniquement si le sélecteur de type de magasin apparaît.
3. [Dites à Runner ce que vous voulez](./work-with-runner/write-effective-requests).
4. Suivez l'état de la tâche et répondez à toutes les questions que Runner affiche.
5. Examinez le résultat dans [Vitrine](./storefront-and-publishing/preview-your-store).
6. Apportez des modifications visuelles en [Mode de conception](./storefront-and-publishing/design-mode) ou envoyez une demande de suivi.
7. Configurez les produits, l'expédition, les paiements et les détails du magasin.
8. Complétez la [liste de contrôle de publication](./storefront-and-publishing/prepare-to-publish), puis publiez.
9. Utilisez les groupes **Créer**, **Développer** et **Mesurer** dans la barre latérale pour exécuter et améliorer l'entreprise.
## Parcourir toute la documentation
### Commencer
- [Commencez ici](./start-here)
connectez-vous, créez ou connectez un magasin et complétez le premier flux de travail utile.
- [Espace de travail](./workspace)
gérez les magasins, les statuts, les coéquipiers, les notifications et la navigation de l'espace de travail.
- [Travailler avec Runner](./work-with-runner)
utilisez le chat, l'historique, la recherche, les images, les profils, les compétences et les détails des tâches.
### Créer et gérer le magasin
- [Vitrine et publication](./storefront-and-publishing)
aperçu, conception, édition de code conditionnelle, versions, publication, paiement et domaines.
- [Opérations de la boutique](./store-operations)
paramètres généraux, expédition, produits, commandes, clients, promotions, approvisionnement et avis.
- [Applications et intégrations](./apps-and-integrations)
paiements, e-mail, expédition, Shopify, exécution et connexions d'agent.
### Mesurer, automatiser et créer
- [Analyse et référencement](./analytics-and-seo)
métriques, trafic, conversion, performance de recherche, santé du site et visibilité IA.
- [Automatiser, tester et créer](./automate-test-and-create)
automatisations, simulations, expériences, Studio créatif, Bibliothèque multimédia et Annonces.
- [Agent](./agent)
compétences réutilisables, mémoire et palette de commandes.
### Configurer et dépanner
- [Compte et paramètres](./account-and-settings)
espace de travail, facturation, utilisation, magasin, personnel, clé API et paramètres de sécurité.
- [Fonctionnalités avancées](./advanced)
recherche conditionnelle, Fly, flux de travail, webhooks et règles de disponibilité.
- [Aide et référence](./help-and-reference)
états, dépannage, support, journal des modifications, FAQ et glossaire.
## Comment lire ces guides
Chaque page de tâche suit le même modèle :
### Afficher la structure de la page
1. **Chemin d'entrée** vous indique exactement où commencer dans Runner.
2. **Avant de commencer** énumère l'état du magasin requis, l'accès, le plan ou la connexion.
3. **Contrôles** explique ce que chaque bouton important fait après l'avoir sélectionné.
4. **Liste des tâches** décrit le flux de travail sûr le plus court.
5. **États et dépannage** explique ce qui a changé et ce qu'il faut essayer ensuite.
6. **Guides connexes** renvoie à la tâche suivante probable.
## Limites de sécurité
Avant un clic à fort impact :
:::warning
- lisez la confirmation et le nom du magasin ou de l'espace de travail affecté ;
- enregistrez le travail qui devrait rester disponible ;
- vérifiez si l'action modifie le magasin en direct, la facturation, la communication client, les secrets ou l'accès à l'équipe ;
- demandez à un propriétaire d'espace de travail quand votre rôle ne permet pas l'action.
:::
---
# Commencer avec Runner
Source: https://www.runnerai.com/docs/fr/guides/start-here
**Ce que couvre ce guide :** Vous saurez quel chemin de configuration suivre et où Runner vous mène après chaque étape.
Utilisez cette section quand vous vous connectez pour la première fois, que vous démarrez un magasin alimenté par Runner,
ou que vous connectez un magasin Shopify existant.
**[Créer votre premier magasin, étape par étape](/fr/guides/start-here/first-store-quickstart)**
Suivez des captures d'écran et de courtes vidéos pour créer une boutique, envoyez votre première demande, vérifiez l'aperçu et préparez-vous à publier.
**Chemin d'entrée :** Connexion → espace de travail → menu du nom du magasin dans la barre latérale → **Créer un magasin**.
## Choisissez votre chemin
| Votre situation | Commencez ici | Ce qui se passe ensuite |
| --- | --- | --- |
| Vous voulez la procédure complète la plus courte | [Créer votre premier magasin](/fr/guides/start-here/first-store-quickstart) | Passez d'une idée de magasin à l'aperçu et aux vérifications de publication. |
| Vous voulez explorer Runner avant de vous connecter | [Explorer Runner avant de vous connecter](/fr/guides/start-here/explore-runner-before-sign-in) | Examinez la navigation publique, la langue, la démo et les actions de compte disponibles dans le déploiement actuel. |
| Vous voulez évaluer un modèle de boutique | [Parcourir et remixer les modèles de boutique](/fr/guides/start-here/browse-and-remix-templates) | Comparez les aperçus bureau, mobile et capture d'écran, puis vérifiez la disponibilité actuelle du remix. |
| Vous n'avez pas de compte Runner | [Se connecter](/fr/guides/start-here/sign-in) | Vérifiez votre compte, puis entrez un espace de travail. |
| Vous voulez que Runner crée la vitrine et le service de boutique | [Créer un magasin Runner](/fr/guides/start-here/create-runner-store) | Runner crée un projet et ouvre sa conversation. |
| Vous vendez déjà via Shopify | [Connecter Shopify](/fr/guides/start-here/connect-shopify) | Runner démarre une connexion Shopify ou réutilise une connexion existante admissible. |
| Vous voyez une boîte de dialogue d'introduction ou une récompense de crédit | [Visite de bienvenue et crédits quotidiens](/fr/guides/start-here/welcome-tour-and-daily-credits) | Découvrez les zones principales ou réclamez la récompense actuellement affichée. |
## Le chemin de première exécution
1. [Connexion](/fr/guides/start-here/sign-in) et ouvrez votre espace de travail.
2. Remplissez le court questionnaire commercial si Runner le montre.
3. Ouvrez le menu du nom du magasin dans la barre latérale et sélectionnez **Créer un magasin**. Dans un espace de travail vide, utilisez **Créer un magasin** ou **+ Store** si affiché.
4. Si un sélecteur de type de magasin apparaît, sélectionnez **Partir de zéro** pour un nouveau magasin Runner, ou **Connecter Shopify** pour un magasin Shopify existant.
5. Entrez un **Nom du magasin**, sélectionnez **Créer** et attendez l'ouverture du nouveau magasin.
6. Utilisez la conversation du projet pour indiquer à Runner ce que vous souhaitez construire.
## Avant de commencer
- Vous avez besoin d'accès au compte e-mail ou Google utilisé pour vous connecter.
- Un espace de travail peut avoir des limites de magasin et de siège. Runner affiche un chemin de mise à niveau quand une limite
bloque une action.
- **Connecter Shopify** peut ne pas apparaître pour chaque espace de travail.
- Un aperçu généré, une vitrine publiée et un paiement fonctionnant sont des états distincts.
## Si vous êtes bloqué
- Si un code e-mail échoue, demandez un nouveau code après que **Renvoyer le code de vérification** devienne disponible.
- Si **Créer un magasin** ouvre un message de mise à niveau, vérifiez le plan d'espace de travail actuel avant de réessayer.
- Si Shopify n'est pas affiché, créez un magasin Runner ou vérifiez si l'accès à Shopify est activé pour
votre espace de travail.
## Guides connexes
- [Se connecter](/fr/guides/start-here/sign-in)
- [Explorer Runner avant de vous connecter](/fr/guides/start-here/explore-runner-before-sign-in)
- [Parcourir et remixer les modèles de boutique](/fr/guides/start-here/browse-and-remix-templates)
- [Créer un magasin Runner](/fr/guides/start-here/create-runner-store)
- [Connecter Shopify](/fr/guides/start-here/connect-shopify)
- [Créer votre premier magasin](/fr/guides/start-here/first-store-quickstart)
---
# Parcourir et remixer les modèles de boutique
Source: https://www.runnerai.com/docs/fr/guides/start-here/browse-and-remix-templates
La page publique des modèles de boutique de Runner vous permet d'inspecter les modèles publiés avant de vous connecter et, lorsque le remixage est disponible, de demander une copie dans votre propre espace de travail.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgR0WXr5OLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Choisissez une catégorie et un modèle, examinez **Ordinateur**, **Mobile** ou **Capture d’écran**, puis sélectionnez **Utiliser ce modèle** pour commencer à créer une copie. L’image montre l’action de départ, pas un remix terminé.
Sélectionnez l’image pour l’agrandir. Les annotations sont en anglais.
## Chemin d'accès
Ouvrez la page publique **Modèles** de Runner à [www.runnerai.com/templates](https://www.runnerai.com/templates), ou suivez un lien vers un modèle de boutique Runner. Aucun compte n'est requis pour parcourir la galerie ou ouvrir un modèle.
## Avant de commencer
- Vous avez besoin d'un compte Runner et d'un espace de travail actif si le remixage devient disponible.
- Un aperçu en direct, une capture d'écran et un remixage sont différents : l'aperçu est en lecture seule ; seul un remixage réussi crée un travail de projet.
- Les modèles disponibles, les descriptions et les nombres de remixage peuvent changer.
## Parcourir la galerie
Utilisez le filtre de catégorie pour restreindre la galerie, notamment aux modèles d'**Animation 3D**. Chaque carte affiche le titre du modèle, la miniature le cas échéant et une brève description. Sélectionnez une carte pour ouvrir sa page de détails. Si la page indique **Aucun modèle de boutique pour le moment**, aucun modèle public n'est disponible à ce moment ; revenez plus tard au lieu de le traiter comme un problème de compte.
## Examiner un modèle
| Contrôle ou section | Ce qui se passe après l'avoir sélectionné |
| --- | --- |
| **Ordinateur** | Ouvre l'aperçu du modèle en direct dans un cadre en forme de bureau. Il ne modifie pas le modèle. |
| **Mobile** | Affiche le même aperçu en direct dans un cadre en forme de téléphone étroit. |
| **Capture d’écran** | Affiche l'image de page complète enregistrée lorsqu'une est disponible. C'est une image statique, pas le magasin en direct. |
| **À propos de ce modèle** | Explique l'objectif du modèle. |
| **Conçu pour** | Énumère les audiences ou les types de magasins que le modèle cible. |
| **Points forts et capacités** | Résume les idées principales démontrées par le modèle. |
| Nombre de remixages | Affiche le nombre de copies que Runner a enregistrées. Il ne mesure pas les magasins en direct ou les ventes. |
| **Retour à la galerie** | Revient à la liste de modèles publics. |
Si un aperçu en direct n'est pas disponible, utilisez **Capture d’écran** lorsque le modèle en a une. Une capture d'écran ou un aperçu manquant ne vous empêche pas de lire les détails du modèle.
## Remixer le modèle
1. Examinez le modèle dans **Ordinateur**, **Mobile** et **Capture d’écran** selon disponibilité.
2. Sélectionnez **Utiliser ce modèle** uniquement lorsque vous voulez que Runner crée un projet à partir de celui-ci.
3. Si vous êtes déconnecté, complétez le flux de connexion. Runner garde le modèle sélectionné pour le chemin de remixage.
4. Après la connexion, si la configuration n'a pas démarré automatiquement, revenez au détail du modèle et sélectionnez **Utiliser ce modèle** à nouveau. Attendez ensuite que le bouton affiche **Création de votre boutique…**.
5. La copie réussit lorsque Runner ouvre un nouveau projet dans votre espace de travail. Si Runner affiche un échec ou perd la connexion, vérifiez votre liste de magasins avant de réessayer ; le message à lui seul ne prouve pas qu’aucun projet n’a été créé.
6. Examinez la vitrine copiée, les produits, les paramètres et l'état de publication avant de la rendre en direct.
Un remixage réussi devient votre propre projet ; le modifier ne change pas le modèle public. C'est un point de départ, pas une preuve que les paiements, l'expédition, les données du catalogue, la publication ou le paiement sont prêts.
## Dépannage
| État | Que faire |
| --- | --- |
| **Aperçu indisponible** | Basculez vers **Capture d’écran** ou lisez les détails du modèle. |
| **Aucune capture d'écran n'est disponible pour ce modèle** | Utilisez **Ordinateur** ou **Mobile** si l'aperçu en direct fonctionne. |
| La connexion s'ouvre après **Utiliser ce modèle** | Terminez la connexion avec le compte qui possède l'espace de travail prévu. Si la configuration ne démarre pas, revenez au modèle et sélectionnez **Utiliser ce modèle** à nouveau. |
| **Création de votre boutique…** | Gardez la page ouverte pendant que Runner crée le projet. Ne démarrez pas le même remixage à nouveau. |
| **Échec du remix de ce magasin. Veuillez réessayer.** | Vérifiez le menu du nom du magasin pour un projet nouvellement créé avant de réessayer. Si le remix reste indisponible, parcourez le modèle ou créez plutôt un nouveau magasin Runner. |
| Modèle non trouvé | Revenez à la galerie ; le modèle peut ne plus être publié. |
## Guides connexes
- [Explorer Runner avant la connexion](./explore-runner-before-sign-in)
- [Connectez-vous](./sign-in)
- [Créer un magasin Runner](./create-runner-store)
- [Prévisualiser votre magasin](../storefront-and-publishing/preview-your-store)
---
# Connecter un magasin Shopify
Source: https://www.runnerai.com/docs/fr/guides/start-here/connect-shopify
**Ce que couvre ce guide :** Vous allez démarrer l'autorisation Shopify ou réutiliser une connexion Shopify éligible pour un nouveau projet Runner.
Utilisez ce chemin lorsque votre catalogue et votre paiement vivent déjà dans Shopify.
**Chemin d'entrée :** Menu Nom du magasin → **Créer un magasin** → **Connecter Shopify**, si disponible.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Ouvrez le menu du nom de la boutique et choisissez **Create Store**. Continuez avec **Connect Shopify** uniquement si votre espace de travail propose cette option.
Les annotations sont en anglais. Sélectionnez l’image pour l’agrandir.
## Avant de commencer
- **Connecter Shopify** doit être activé pour votre espace de travail.
- Vous avez besoin du domaine permanent du magasin se terminant par `.myshopify.com`.
- Pour une nouvelle connexion, vous avez besoin de la permission d'approuver l'accès dans Shopify.
- Votre espace de travail Runner doit avoir de la place pour un autre magasin.
## Créer des contrôles de magasin
| Contrôle | Pourquoi c'est utile | Ce qui se passe après l'avoir sélectionné |
| --- | --- | --- |
| Type de projet **Connecter Shopify** | Garde le système de commerce Shopify existant. | Affiche les choix de connexion Shopify et le champ de domaine du magasin. |
| **Nom du magasin** | Nomme le projet Runner. | Utilisé dans l'espace de travail Runner ; il ne renomme pas le magasin Shopify. |
| **Utiliser la connexion existante : _domaine_** | Évite de répéter l'autorisation pour une connexion éligible. | Sélectionne cette connexion Shopify pour le nouveau projet Runner. |
| **Connecter une autre boutique** | Commence avec un autre magasin Shopify. | Affiche **Domaine de la boutique**. |
| **Domaine de la boutique** | Identifie le magasin Shopify. | Accepte un domaine tel que `your-store.myshopify.com`. |
| Bouton de soumission **Connecter Shopify** | Démarre une nouvelle autorisation. | Vous envoie à Shopify ; Runner termine le transfert uniquement après que Shopify revient avec succès. |
| **Créer** | Utilise la connexion existante sélectionnée. | Crée le projet Runner et l'ouvre. |
| **Annuler** | Quitte sans connecter ou créer. | Ferme la boîte de dialogue. |
## Connecter un nouveau magasin Shopify
1. Ouvrez le menu du nom du magasin, sélectionnez **Créer un magasin**, puis choisissez **Connecter Shopify**.
2. Entrez un **Nom du magasin** pour le projet Runner.
3. Choisissez **Connecter une autre boutique** si les choix de connexion sont affichés.
4. Entrez le domaine complet `.myshopify.com` dans **Domaine de la boutique**.
5. Sélectionnez **Connecter Shopify**.
6. Examinez la demande d'accès sur Shopify et continuez uniquement si elle nomme le magasin que vous attendez.
7. Après que Shopify revient à Runner, confirmez que le nouveau projet apparaît dans l'espace de travail.
## Réutiliser une connexion existante
1. Choisissez **Connecter Shopify** dans **Créer un magasin**.
2. Entrez le **Nom du magasin** Runner.
3. Sélectionnez **Utiliser la connexion existante : _domaine_**.
4. Sélectionnez **Créer**.
5. Confirmez que Runner ouvre le nouveau projet avec le nom de magasin prévu et la connexion Shopify.
## Dépannage
| État | Signification | Que faire |
| --- | --- | --- |
| L'option Shopify est manquante | La fonctionnalité n'est pas activée pour cet espace de travail. | Utilisez **Partir de zéro** ou vérifiez la disponibilité de l'espace de travail. |
| **Connecter Shopify** est désactivé | Le nom du magasin ou le domaine `.myshopify.com` est incomplet. | Corrigez le champ en surbrillance. |
| La connexion est déjà liée | Cette connexion Shopify appartient à un autre magasin Runner. | Choisissez une autre connexion éligible ou un magasin différent. |
| Connexion non trouvée | Une connexion enregistrée n'est plus disponible. | Sélectionnez une autre connexion ou démarrez une nouvelle autorisation. |
| L'autorisation Shopify est annulée | Shopify n'a pas renvoyé une connexion approuvée. | Revenez à **Créer un magasin** et réessayez lorsque vous êtes prêt. |
Le paiement reste dans Shopify pour ce type de projet. Une connexion réussie ne prouve pas que
la vitrine Runner est construite ou publiée ; examinez ces états séparément.
## Guides connexes
- [Créer un magasin Runner à la place](/fr/guides/start-here/create-runner-store)
- [Construire votre premier magasin](/fr/guides/start-here/first-store-quickstart)
- [Commencer](/fr/guides/start-here)
---
# Créer un magasin Runner
Source: https://www.runnerai.com/docs/fr/guides/start-here/create-runner-store
**Ce que couvre ce guide :** Vous allez créer un nouveau projet Runner et arriver dans sa conversation de projet.
Utilisez **Partir de zéro** lorsque vous partez d'une idée et que vous n'avez pas besoin de garder le paiement Shopify.
**Chemin d'accès :** Espace de travail → nom du magasin en haut de la barre latérale gauche → **Créer un magasin**. Déployez d'abord la barre latérale si elle est réduite. Dans un espace vide, utilisez **Créer un magasin** ou **+ Magasin** lorsque cette action s'affiche.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Suivez [Créer votre premier magasin, étape par étape](./first-store-quickstart) pour un exemple complet avec captures d'écran et courtes vidéos.
## Avant de commencer
- Vous devez être connecté à un espace de travail actif.
- Votre espace de travail doit avoir de la place pour un autre magasin.
- Entrez un nom qui identifie clairement le magasin à votre équipe.
## Créer des contrôles de magasin
| Contrôle | Pourquoi c'est utile | Ce qui se passe après l'avoir sélectionné |
| --- | --- | --- |
| **Partir de zéro**, si cette option s'affiche | Choisit le parcours de magasin natif de Runner. | Le formulaire ne conserve que les champs nécessaires pour un magasin Runner. Si aucun choix de type de magasin n'apparaît, passez à Nom du magasin. |
| **Nom du magasin** | Nomme le projet dans votre espace de travail. | **Créer** devient disponible après que le nom soit valide. |
| **Créer** | Confirme le nouveau magasin. | Runner crée le projet et navigue vers sa conversation. |
| **Annuler** ou fermer | Quitte sans créer de magasin. | La boîte de dialogue se ferme et l'espace de travail reste inchangé. |
## Créer le magasin
1. Ouvrez le menu du nom du magasin dans la barre latérale et sélectionnez **Créer un magasin**, ou utilisez l'action de création dans un espace vide.
2. Choisissez **Partir de zéro** si le formulaire propose ce choix. Sinon, passez à **Nom du magasin**.
3. Entrez le **Nom du magasin**.
4. Sélectionnez **Créer**.
5. Attendez que le nouveau projet s'ouvre.
6. Dans la conversation du projet, décrivez votre activité, votre public, le style visuel et les pages nécessaires. Vous pouvez aussi ouvrir **Boutique en ligne** pour saisir la première demande.
La création du projet ne le publie pas. Runner a toujours besoin de votre demande avant de pouvoir construire un aperçu de vitrine.
Une fois la première version terminée par Runner, ouvrez **Boutique en ligne** pour vérifier l’aperçu. Un aperçu prêt n’est pas encore public. Lorsque vous êtes prêt à rendre le magasin public, sélectionnez **Publier** et résolvez chaque point de préparation avant de confirmer.
## Dépannage
| État | Signification | Que faire |
| --- | --- | --- |
| **Créer** est désactivé | Une valeur requise est manquante ou invalide, ou la création est déjà en cours. | Examinez le **Nom du magasin** et attendez toute action en attente. |
| Message de mise à niveau | L'espace de travail a atteint sa limite actuelle de magasins. | Ouvrez les informations de plan affichées par Runner ou annulez la boîte de dialogue. |
| L'accès à l'espace de travail a expiré | Les nouveaux magasins ne peuvent pas être créés dans cet espace de travail. | Suivez le chemin de réactivation de l'espace de travail ou de plan affiché à l'écran. |
| La création a échoué | Runner n'a pas pu terminer la création du projet. | Gardez le nom prévu, revenez à l'espace de travail et réessayez une fois de plus. |
## Guides connexes
- [Connectez-vous](/fr/guides/start-here/sign-in)
- [Construire votre premier magasin](/fr/guides/start-here/first-store-quickstart)
- [Connecter Shopify à la place](/fr/guides/start-here/connect-shopify)
- [Visite de bienvenue et crédits quotidiens](/fr/guides/start-here/welcome-tour-and-daily-credits)
---
# Explorer Runner avant de vous connecter
Source: https://www.runnerai.com/docs/fr/guides/start-here/explore-runner-before-sign-in
Les pages publiques de Runner vous permettent d'en savoir plus sur le produit, de comparer les tarifs et de commencer une démo ou un flux de compte avant d'entrer dans un espace de travail.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1kPfxvrvDHKGRP0BUIpjksTZQ9oN4rSwzeqA)
Utilisez **Produits** et **Ressources** pour découvrir Runner, le **sélecteur de langue** pour choisir une langue et **Voir comment ça marche** pour ouvrir la vidéo de démonstration. Cette action est distincte de **Réserver une démo**, qui ouvre la réservation d’un rendez-vous lorsqu’elle est disponible.
Sélectionnez l’image pour l’agrandir. Les annotations sont en anglais.
## Ce que couvre ce guide
Vous vous repérerez dans les pages publiques de Runner, choisirez une langue, réserverez une démo en toute sécurité et saurez si l'action principale lancera la connexion ou ouvrira un espace de travail.
## Disponibilité et conditions préalables
- Aucun compte n'est requis pour parcourir les pages publiques.
- Runner peut afficher l'une de deux dispositions de navigation publique. Seule la version attribuée à la visite actuelle apparaît ; c'est normal.
- Le panneau de planification **Réserver une démo** utilise un service externe et nécessite une connexion réseau fonctionnelle.
- L'action de compte principal change après votre connexion.
## Chemin d'accès
Ouvrez la page d'accueil publique de Runner dans un navigateur. Sur mobile, sélectionnez **Ouvrir le menu** pour afficher la navigation et **Fermer le menu** pour la masquer.
## Contrôles courants
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| Sélecteur de langue | Enregistre la langue choisie pour le compte connecté ou le navigateur actuel, puis recharge la page actuelle dans cette langue. |
| **Réserver** ou **Réserver une démo** | Ouvre le panneau de planification, dont le titre accessible est **Réserver une démo**. Une réunion n'est créée qu'après la confirmation du planificateur. |
| **Début** ou **Commencer** | Ouvre le flux de connexion ou de création de compte Runner. L'étiquette dépend de la version de navigation publique. |
| **Ouvrir l'espace de travail** | Apparaît pour un visiteur connecté et ouvre l'espace de travail protégé. |
| Avatar connecté | Ouvre le menu de compte disponible au lieu de l'action **Début** ou **Commencer** déconnectée. |
| **Ouvrir le menu** / **Fermer le menu** | Affiche ou masque la navigation mobile. La sélection d'une destination ferme le menu au début de la navigation. |
Le menu mobile contient les liens et le contrôle de langue pour la version de navigation publique qui vous a été attribuée. Son action principale reste facile d'accès près du bord du menu : **Début** ou **Commencer** quand vous êtes déconnecté, ou l'action d'espace de travail connecté quand elle est disponible.
## Choisissez votre prochaine étape
1. Ouvrez [Prix](https://www.runnerai.com/pricing) pour comparer les forfaits publics et les fonctionnalités incluses.
2. Parcourez [Modèles](https://www.runnerai.com/templates) pour inspecter un point de départ sur ordinateur et mobile.
3. Revenez à l'action du compte principal lorsque vous êtes prêt à créer.
4. Après la connexion, confirmez que Runner ouvre l'espace de travail que vous avez l'intention d'utiliser avant de créer un magasin.
## Changer la langue
1. Ouvrez le sélecteur de langue.
2. Sélectionnez la langue souhaitée.
3. Attendez le rechargement de la page.
4. Confirmez que la page actuelle, plutôt qu'une destination non liée, s'est rouverte dans la langue sélectionnée.
Si l'enregistrement échoue, Runner conserve la langue précédente et signale une erreur. Réessayez une fois après avoir vérifié la connexion. Un changement de langue affecte le texte de l'interface ; il ne traduit pas le contenu que vous avez saisi dans un projet de magasin.
## Réserver une démo
1. Sélectionnez **Réserver** ou **Réserver une démo**, selon ce que votre navigation affiche.
2. Attendez que le planificateur affiche les dates et heures disponibles.
3. Choisissez une heure et complétez les détails de contact demandés.
4. Confirmez la réunion dans le planificateur.
5. Attendez le message de succès de Runner et la fermeture du panneau.
Fermer le planificateur avant la confirmation ne réserve pas de réunion. S'il reste vide ou indisponible, fermez-le, vérifiez la connexion et réessayez une fois. Utilisez [Support et communauté](/fr/guides/help-and-reference/support-and-community) si le problème persiste.
## Démarrer ou rouvrir Runner
- Quand vous êtes déconnecté, sélectionnez **Début** ou **Commencer** et complétez les étapes de connexion ou de création de compte affichées.
- Quand vous êtes déjà connecté, sélectionnez **Ouvrir l'espace de travail** pour entrer dans le produit protégé.
- Si une action protégée vous ramène à la connexion, complétez la connexion pour le compte prévu avant de continuer.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Liens publics différents de ceux attendus | Runner a attribué l'autre version de navigation actuelle. Utilisez les étiquettes visibles. |
| Les liens mobiles sont masqués | Sélectionnez **Ouvrir le menu**. Après avoir choisi un lien, rouvrez le menu si vous avez besoin d'une autre destination. |
| Les boutons de compte affichent des espaces réservés | Runner vérifie toujours la session. Attendez **Début**, **Commencer** ou **Ouvrir l'espace de travail** avant de décider si vous êtes connecté. Le contrôle de langue peut également rester indisponible pendant cette vérification. |
| La langue ne change pas | La préférence n'a pas été confirmée. Vérifiez l'erreur et la connexion, puis réessayez une fois. |
| Le planificateur de démo se charge | Attendez ses contrôles de date et d'heure avant d'entrer les détails. |
| Le panneau de démo se ferme sans succès | Aucune réservation n'a été confirmée. Rouvrez-le et complétez la confirmation du planificateur. |
| **Début** ou **Commencer** est remplacé par **Ouvrir l'espace de travail** | Runner reconnaît une session connectée. Ouvrez l'espace de travail ou utilisez le menu avatar pour les actions de compte. |
## Guides connexes
- [Se connecter](/fr/guides/start-here/sign-in)
- [Parcourir et remixer les modèles de boutique](/fr/guides/start-here/browse-and-remix-templates)
- [Créer un magasin Runner](/fr/guides/start-here/create-runner-store)
- [Support et communauté](/fr/guides/help-and-reference/support-and-community)
---
# Créer votre premier magasin, étape par étape
Source: https://www.runnerai.com/docs/fr/guides/start-here/first-store-quickstart
Créez une vitrine que vous pouvez examiner, modifier et préparer à partager. Suivez les étapes dans l'ordre ou utilisez le sommaire pour retrouver celle qui vous intéresse.
L'exemple est **Quiet Mornings**, un magasin de bougies artisanales. Vous pouvez utiliser votre propre idée d'entreprise. Les captures d'écran et les vidéos sans son montrent l'interface en anglais ; les questions et les commandes disponibles peuvent varier selon le magasin.
**Chemin d'accès :** [Runner AI](https://www.runnerai.com) → **Commencer** → connexion → votre espace de travail.
## Le parcours en bref
1. Ouvrez le menu du nom du magasin → **Créer un magasin** (ou **+ Magasin** dans un espace de travail vide). Choisissez **Partir de zéro** si cette option apparaît, ou **Connecter Shopify** pour un magasin Shopify existant.
2. Dans la conversation du projet, décrivez votre activité, votre public, le style visuel et les pages nécessaires. Envoyez la demande et répondez aux questions de Runner.
3. Une fois la première version prête, ouvrez **Boutique en ligne** et vérifiez l’aperçu. Un aperçu prêt n’est pas encore public.
4. Pour lancer le magasin, sélectionnez **Publier** et résolvez chaque point de préparation avant de confirmer. La publication et le bon fonctionnement du paiement restent deux vérifications distinctes.
## Avant de commencer
- Utilisez une adresse e-mail ou un compte Google auquel vous avez accès.
- Choisissez un [espace de travail](/fr/guides/workspace) disposant d'un emplacement de magasin libre et de suffisamment de crédits pour votre demande. Résolvez toute limite de forfait ou d'accès avant de créer un autre magasin.
- Préparez une phrase sur ce que vous vendez et à qui. Affinez le design après le premier aperçu.
Vous n'avez pas besoin de connecter un service de paiement pour examiner une vitrine. **Aperçu**, **publié** et **prêt à accepter des paiements** sont des points de contrôle distincts.
## 1. Se connecter [#sign-in]
1. Ouvrez Runner et sélectionnez **Commencer**. Si vous êtes déjà connecté, sélectionnez **Ouvrir l'espace de travail**.
2. Sélectionnez **Continuer avec Google** et choisissez votre compte, ou renseignez **E-mail**, sélectionnez **Continuer**, puis saisissez le code reçu dans l'e-mail de Runner.
3. Répondez aux éventuelles questions sur votre compte. Runner ouvre votre espace de travail ou vous ramène à la page de départ.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
**À vérifier :** Vous pouvez ouvrir votre espace de travail sans revenir à la connexion. Consultez [Se connecter](./sign-in) si un code ou le choix du compte ne fonctionne pas.
## 2. Créer un magasin [#create-store]
1. Sélectionnez le nom du magasin en haut de la barre latérale gauche, puis **Créer un magasin**. Déployez d'abord la barre latérale si elle est réduite. Dans un espace vide, utilisez l'action **Créer un magasin** ou **+ Magasin** qui s'affiche.
2. Choisissez **Partir de zéro** si le formulaire propose ce choix. Utilisez plutôt [Connecter Shopify](./connect-shopify) pour conserver un magasin Shopify existant.
3. Saisissez **Quiet Mornings** dans **Nom du magasin**, ou utilisez votre propre nom.
4. Sélectionnez **Créer** et attendez l'ouverture du nouveau magasin. Ne sélectionnez pas à nouveau Créer pendant l'opération.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
**À vérifier :** La barre latérale affiche le nom du nouveau magasin. Sa création ne construit ni ne publie encore sa vitrine.
## 3. Décrire la première version [#first-request]
1. Sélectionnez **Boutique en ligne**. Si aucune version n'a été construite, Runner affiche un champ pour décrire l'apparence souhaitée. Vous pouvez aussi utiliser la conversation du nouveau magasin.
2. Copiez cet exemple dans le champ et adaptez les informations sur votre entreprise :
~~~text
Build a store for Quiet Mornings, a handmade candle brand for people
who enjoy slow mornings. Use warm cream colors, forest-green accents,
and spacious product photography. Include a homepage, product pages,
About, and Contact. Start with three sample candles: Morning Light,
Cedar Cabin, and Lavender Dusk. Keep the store unpublished.
~~~
3. Sélectionnez la flèche d'envoi (**Envoyer le message**). Si l'écran de départ affiche **Commencer à créer**, utilisez cette action.
4. Runner ouvre la conversation de construction et commence le travail. Restez dans ce magasin pour examiner le résultat.
**À vérifier :** Votre demande apparaît dans la conversation. Un indicateur de progression ou une question complémentaire apparaît en dessous. Les produits d'exemple servent à vous exercer ; remplacez leurs informations avant de les vendre.
## 4. Répondre aux questions et suivre le travail [#follow-progress]
1. Lisez chaque question. Sélectionnez une réponse ou utilisez **Autre…** pour écrire la vôtre.
2. Répondez aux questions restantes. Dans cet exemple, nous choisissons un prix pour les bougies et un style photographique.
3. Attendez que Runner poursuive. Ouvrez **Détails** pour comprendre une étape en échec ou bloquée.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
### Vidéo : répondre aux questions complémentaires
La vidéo montre le choix d'un prix, le passage à la question sur les photos, puis le choix d'une direction visuelle. **Répondu** confirme les choix et Runner reprend le travail. Les questions dépendent de votre demande.
**À vérifier :** Aucune question n'attend encore votre réponse. Un message de fin ne suffit pas : ouvrez la vitrine et examinez ce qui s'affiche réellement.
## 5. Prévisualiser et apporter une modification [#preview-and-change]
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
1. Ouvrez **Boutique en ligne** ou sélectionnez **Aperçu** sur la carte de construction terminée si cette action est proposée.
2. Attendez que le magasin s'affiche. **Préparation de l'aperçu…** signifie qu'il n'est pas encore prêt à être examiné.
3. Ouvrez l'accueil, un produit, la page À propos et la page Contact. Vérifiez les textes, les images, les prix et la navigation.
4. Utilisez la commande d'appareil pour vérifier **PC**, **Tablette** et **Téléphone**. Recherchez les textes coupés, les boutons qui se chevauchent et le défilement horizontal.
5. Revenez à la conversation et demandez une seule modification précise :
~~~text
Change the homepage headline to “Make room for a slower morning.”
Keep the colors, layout, and product information unchanged.
~~~
6. Attendez la modification, rouvrez l'aperçu actuel et confirmez que le nouveau titre apparaît. Vérifiez à nouveau Téléphone.
**À vérifier :** Vous pouvez repérer la modification demandée dans l'aperçu. Le magasin n'est toujours pas publié. S'il est disponible, le [Mode Design](../storefront-and-publishing/design-mode) permet aussi de sélectionner un élément pour une modification ciblée.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
### Vidéo : vérifier les mises en page sur ordinateur et téléphone
La commande d'appareil passe de **PC** à **Tablette**, puis à **Téléphone**, avant de revenir à **PC**. Seul le cadre d'aperçu change ; cette action ne publie ni ne modifie votre magasin.
## 6. Examiner les vérifications de publication [#publish-checks]
La publication peut nécessiter un forfait payant ou des droits supplémentaires dans l'espace de travail. Si **Publier** ouvre un message de mise à niveau, examinez les [forfaits actuels](https://www.runnerai.com/pricing) ou revenez à l'aperçu. Résolvez cette condition d'accès avant d'attendre la confirmation de publication.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
1. Sélectionnez **Publier** dans la barre d'outils de Vitrine. Cela lance les vérifications d'accès et de préparation ; ce n'est pas la preuve que le magasin est en ligne.
2. Lisez **Confirmer le Déploiement** et attendez la vérification de compilation.
3. Résolvez les éléments affichés. **Corriger avec l'IA** demande une réparation, **Relancer la vérification** relance le contrôle et **Ouvrir Opérations de la boutique** mène à la configuration lorsque cette action est proposée.
4. Si vous vous exercez, sélectionnez **Annuler**. Pour rendre cette version publique, examinez les avertissements et sélectionnez **Confirmer** uniquement lorsque le bouton est actif.
5. Après confirmation, attendez une publication réussie, ouvrez l'URL publique et vérifiez les pages en ligne. En cas d'échec, ne supposez pas que vos modifications sont en ligne.
Dans la capture, la vérification de compilation réussit, mais la configuration reste à terminer. **Publier quand même : je terminerai la configuration plus tard.**, lorsque cette option est proposée, confirme que vous acceptez les éléments de configuration inachevés ; elle ne termine pas ce travail.
### Vidéo : quitter les vérifications sans publier
La vidéo examine le résultat de compilation et l'avertissement de configuration, puis sélectionne **Annuler** pour revenir à l'aperçu. Elle ne publie pas le magasin d'exemple.
**À vérifier :** Un aperçu fonctionnel prouve que vous pouvez voir la version construite. Une publication réussie et une URL publique fonctionnelle prouvent que les visiteurs peuvent y accéder. Vous devez encore connecter le service de paiement et vérifier le passage en caisse avant d'accepter des commandes.
Consultez [Préparer la publication](../storefront-and-publishing/prepare-to-publish) pour les produits, la livraison, les politiques et les autres réglages. Poursuivez avec [Publier et republier](../storefront-and-publishing/publish-and-republish) et [Magasin en ligne et paiement](../storefront-and-publishing/live-store-and-checkout).
## Si une étape ne se termine pas
| Ce que vous voyez | Votre prochaine action |
| --- | --- |
| Aucun magasin pour le moment | Ouvrez le menu du nom du magasin ou l'action de création de l'espace vide. |
| Une limite de magasins ou de forfait | Examinez le forfait de l'espace de travail ou choisissez un espace disposant de place. Répéter Créer ne supprime pas la limite. |
| Une question en attente | Répondez-y pour que Runner puisse continuer. |
| Préparation de l'aperçu | Gardez la version actuelle ouverte. Utilisez Actualiser si cette action est proposée lorsque la préparation ne progresse plus. |
| Résultats en échec, arrêtés ou contradictoires | Ouvrez Détails, lisez le problème restant et vérifiez l'aperçu réel. Demandez à Runner de corriger le problème précis sans vous fier uniquement au résumé de réussite. |
| Confirmer est désactivé | Terminez la compilation ou la tâche active et résolvez les exigences indiquées. « Aucune modification » nécessite une nouvelle modification enregistrée ; ce n'est pas un avertissement à ignorer. |
| Un magasin en ligne ne peut pas accepter de paiement | Terminez la connexion du service de paiement et la configuration du passage en caisse dans Applications ou dans l'écran post-publication. |
## Guides connexes
- [Créer un magasin Runner](./create-runner-store)
- [Rédiger des demandes efficaces](../work-with-runner/write-effective-requests)
- [Prévisualiser votre magasin](../storefront-and-publishing/preview-your-store)
- [Ouvrir votre premier magasin à la vente](../open-your-first-store)
---
# Se connecter à Runner
Source: https://www.runnerai.com/docs/fr/guides/start-here/sign-in
**Ce que couvre ce guide :** Vous vous connecterez et retournerez à la page Runner ou à l'espace de travail qui a lancé le flux de connexion.
Utilisez l'e-mail quand vous voulez un code à usage unique sans mot de passe. Utilisez Google quand ce compte est déjà
disponible dans votre navigateur.
**Chemin d'accès :** Page d'accueil de Runner → **Commencer**, ou **Ouvrir l'espace de travail** si vous êtes déjà connecté.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Pour le parcours illustré complet, suivez [Créer votre premier magasin, étape par étape](./first-store-quickstart).
## Avant de commencer
- Utilisez un compte e-mail que vous pouvez ouvrir sur le même appareil de confiance.
- Si votre organisation vous a invité, connectez-vous avec l'adresse e-mail invitée.
- Ne partagez pas un code à usage unique et ne le laissez pas visible dans une capture d'écran.
## Contrôles de connexion
| Contrôle | Pourquoi c'est utile | Ce qui se passe après sa sélection |
| --- | --- | --- |
| **Continuer avec Google** | Utilise votre compte Google. | Ouvre le flux de compte et de consentement de Google. Runner reprend après le retour réussi de Google. |
| **E-mail** | Vous permet de vous connecter sans mot de passe. | Accepte l'adresse qui recevra le code à usage unique. |
| **Continuer** | Demande un code e-mail. | Runner envoie un code de vérification à six chiffres et ouvre le formulaire de code. |
| Champs de code de vérification | Confirme que vous contrôlez l'adresse e-mail. | Le formulaire se soumet automatiquement après la saisie de tous les six chiffres. |
| **Renvoyer le code de vérification** | Remplace un code manquant ou expiré. | Envoie un autre code après la fin du compte à rebours visible. |
## Se connecter avec l'e-mail
1. Entrez votre adresse e-mail.
2. Sélectionnez **Continuer**.
3. Ouvrez le message de Runner et trouvez le code à six chiffres.
4. Entrez les six chiffres. Vous n'avez pas besoin de sélectionner un autre bouton de soumission.
5. Attendez que Runner vous ramène à la destination sûre qui a lancé la connexion.
## Complétez les questions du nouveau compte
Certains nouveaux comptes voient **Parlez à Runner de votre boutique** avant d'entrer dans l'espace de travail.
1. Choisissez une réponse pour la question ouverte.
2. Sélectionnez **Question suivante** pour continuer.
3. Utilisez **Modifier** pour réviser une question répondue.
4. Sélectionnez **Commencer** quand toutes les questions requises sont complètes.
Le questionnaire demande le contexte commercial ; il ne crée ni ne publie un magasin par lui-même.
## Dépannage
| État | Signification | Que faire |
| --- | --- | --- |
| E-mail invalide | L'adresse est incomplète ou ne peut pas être utilisée telle qu'entrée. | Corrigez l'adresse, puis sélectionnez **Continuer** à nouveau. |
| Envoi en cours | Runner demande l'e-mail de vérification. | Gardez la page ouverte jusqu'à ce que le formulaire de code apparaisse. |
| Code incorrect | Le code saisi n'a pas été accepté. | Entrez à nouveau le dernier code ou demandez-en un autre. |
| Compte à rebours de renvoi | Un autre code ne peut pas être envoyé pour le moment. | Attendez que **Renvoyer le code de vérification** soit disponible. |
| Échec de l'enregistrement du questionnaire | Runner n'a pas pu stocker les réponses. | Gardez vos réponses à l'écran et réessayez l'action. |
Ne partagez pas un code de vérification avec quiconque. Le support Runner n'en a pas besoin pour vous aider avec un
problème de compte.
## Guides connexes
- [Commencer](/fr/guides/start-here)
- [Créer un magasin Runner](/fr/guides/start-here/create-runner-store)
- [Créer votre premier magasin](/fr/guides/start-here/first-store-quickstart)
---
# Utiliser la visite de bienvenue et les crédits quotidiens
Source: https://www.runnerai.com/docs/fr/guides/start-here/welcome-tour-and-daily-credits
**Ce que couvre ce guide :** Vous quitterez la visite de bienvenue en sachant où vivent les outils principaux et comprendrez ce qui change après une vérification quotidienne.
Utilisez cette page quand Runner ouvre **Bienvenue sur Runner** ou quand **Gagner des crédits** est visible.
## Chemins d'accès
- **Visite de bienvenue :** Runner ouvre **Bienvenue sur Runner** automatiquement pour un compte admissible. La visite n'a pas d'entrée de navigation permanente.
- **Crédits quotidiens :** **Gagner des crédits** → **Pointage quotidien**.
## Avant de commencer
- La visite de bienvenue et la récompense quotidienne peuvent être absentes quand le compte n'est pas admissible ou l'étape est déjà complète.
- Lisez le montant, l'expiration et l'état de réclamation dans la boîte de dialogue actuelle plutôt que de vous fier à une capture d'écran plus ancienne.
- Les crédits de bienvenue sont distincts des crédits d'enregistrement quotidiens. Lisez le message de bienvenue actuel pour voir ce qui a déjà été ajouté avant de réclamer une récompense quotidienne.
## Suivez la visite de bienvenue
Les six étapes de la visite présentent la création et l'aperçu, Creative Studio, les Compétences, le Dropshipping,
les Opérations de la boutique et le Mode de conception.
| Contrôle | Ce qui se passe |
| --- | --- |
| Points d'étape | Saute directement à l'étape de visite sélectionnée. |
| **Retour** | Retourne à l'étape précédente. Il est désactivé à la première étape. |
| **Suivant** | Ouvre l'étape suivante. |
| **Agrandir la vidéo** | Ouvre la démonstration actuelle à une taille plus grande quand la vidéo est prête. |
| **Passer la visite** ou fermer | Ferme la visite sans modifier le magasin. |
| **Commencer à créer** | Termine la dernière étape et ferme la visite. |
1. Lisez le but de la zone actuelle.
2. Jouez ou agrandissez la démonstration si cela aide.
3. Sélectionnez **Suivant**, **Retour** ou un point d'étape pour vous déplacer dans la visite.
4. Sélectionnez **Commencer à créer** à l'étape finale, ou **Passer la visite** quand vous êtes prêt à travailler.
La visite est informative. Elle ne lance pas de Compétence, n'importe aucun produit et ne modifie aucune vitrine.
## Réclamez une récompense quotidienne
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsiEEL0uaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Dans l’image : 1. Ouvrez **Gagner des crédits**. 2. Trouvez **Pointage quotidien**. 3. **Done** dans l’image signifie que la récompense du jour a déjà été réclamée. Les valeurs du compte sont masquées. Sélectionnez l’image pour l’agrandir. Les annotations utilisent l’interface de bureau en anglais.
La boîte de dialogue peut afficher la séquence actuelle, les crédits disponibles aujourd'hui, la date d'expiration de la récompense,
les crédits accordés dans le cycle actuel et le prochain jalon.
Lorsque Runner affiche **Cadeau de bienvenue**, le message confirme que les crédits de bienvenue affichés sont déjà dans le solde. Le bouton quotidien réclame une récompense distincte ; il ne réclame plus la subvention de bienvenue.
Fermer **Cadeau de bienvenue** ne supprime pas les crédits de bienvenue qui sont déjà dans le solde. Fermer une vérification quotidienne toujours réclamable laisse cette récompense quotidienne distincte non réclamée.
1. Confirmez que la boîte de dialogue dit qu'une récompense est réclamable.
2. Examinez le montant et la date d'expiration affichés.
3. Sélectionnez **Vérifier aujourd'hui** ou le bouton de réclamation visible.
4. Attendez l'état réclamé avant de fermer la boîte de dialogue.
5. Vérifiez le solde affiché ou l'historique des récompenses pour confirmer que la récompense quotidienne a été ajoutée une fois.
## Dépannage
| État | Signification | Que faire |
| --- | --- | --- |
| Bouton de réclamation disponible | La récompense d'aujourd'hui peut être réclamée pour l'espace de travail affiché. | Sélectionnez-le une fois et attendez la confirmation. |
| Vérifié / réclamé | La récompense d'aujourd'hui a déjà été ajoutée. | Revenez un autre jour admissible. |
| Récompense indisponible | Le compte n'est pas actuellement admissible ou aucune réclamation n'est due. | Fermez la boîte de dialogue ; ne supposez pas qu'un crédit a été ajouté. |
| Échec de la réclamation | Runner n'a pas confirmé la récompense. | Gardez la boîte de dialogue ouverte et réessayez plus tard. |
Fermer une récompense réclamable la laisse non réclamée. Vérifiez l'expiration affichée avant de décider de revenir plus tard.
## Guides connexes
- [Commencer](/fr/guides/start-here)
- [Créer votre premier magasin](/fr/guides/start-here/first-store-quickstart)
- [Créer un magasin Runner](/fr/guides/start-here/create-runner-store)
---
# Opérations de la boutique
Source: https://www.runnerai.com/docs/fr/guides/store-operations
Utilisez les opérations de la boutique pour gérer les informations et l'activité quotidiennes derrière votre magasin Runner.
## Pourquoi et quand utiliser les opérations de la boutique
Ouvrez cette zone après que Runner ait créé votre magasin. C'est le centre de contrôle pratique pour les détails du magasin, les règles d'expédition, les produits, les commandes, les clients et les promotions. Certains travaux, tels que l'approvisionnement auprès de fournisseurs ou la modération des avis, n'apparaissent que lorsque la capacité correspondante est disponible.
## Disponibilité et conditions préalables
- Connectez-vous et ouvrez un projet Runner qui inclut un magasin.
- Attendez si Runner affiche **Veuillez patienter, l'administrateur de la boutique est en cours de déploiement...**. Les pages se chargent lorsque le service de boutique est prêt.
- Votre rôle d'espace de travail et l'état du magasin peuvent limiter les contrôles affichés.
- Les services de paiement, d'expédition, d'exécution, de réservation et de fournisseur connectés peuvent ajouter des contrôles spécifiques à l'état.
## Ouvrir les opérations de la boutique
1. Ouvrez **Espace de travail**.
2. Choisissez le magasin que vous souhaitez gérer.
3. Sélectionnez **Opérations de la boutique** dans la navigation du projet.
4. Si des cartes de configuration apparaissent, [complétez les détails du magasin requis et résolvez la configuration du produit/expédition](/fr/guides/store-operations/onboarding-and-general-settings), puis sélectionnez **Ouvrir Opérations de la boutique**.
5. Choisissez une section dans le menu Opérations du magasin.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRKgUAoOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Si ces cartes de configuration apparaissent, complétez les détails requis et résolvez les jalons facultatifs avant d'utiliser le menu d'administration. L'image ne montre pas la configuration de la publication ou du paiement.
## Demander à Runner de vous aider à partir du chat
**Chemin d'entrée :** Ouvrez le projet → choisissez **Nouvelle tâche** ou une conversation existante.
Vous pouvez demander à Runner d'inspecter ou de mettre à jour les enregistrements de magasin approuvés sans trouver chaque page d'administration
vous-même. Cela inclut le travail courant avec les produits et les variantes, les clients, l'inventaire, l'expédition,
l'exécution, les commandes, les retours, les promotions et les enregistrements connexes.
1. Nommez l'enregistrement et le résultat exact que vous souhaitez.
2. Demandez à Runner d'inspecter d'abord l'état actuel lorsque la modification dépend d'une commande, d'un inventaire ou d'un
état d'exécution.
3. Autorisez explicitement l'effet exact avant une action destructrice ou de cycle de vie de commande. Une demande générale
n'est pas une permission de supprimer un enregistrement, d'annuler une commande ou d'avancer l'exécution.
4. Attendez le résultat de Runner, puis actualisez la page Opérations de la boutique pertinente et vérifiez l'état mis à jour avant de réessayer ou de commencer un autre changement.
L'accès au compte, les paramètres du système de magasin, les paiements et l'administration fiscale ne sont pas disponibles via
cette capacité de chat. Les importations de produits et autres téléchargements de fichiers utilisent toujours leurs flux dédiés.
## Choisir la bonne section
| Section | Utilisez-la pour | Ce que la sélectionner affiche |
| --- | --- | --- |
| **Général** | Visibilité du magasin, identité, marchés, emplacements de stock, expédition et disponibilité des avis | Ouvre la page des paramètres partagés. La plupart des champs utilisent la **Enregistrer** de la page ; le commutateur **Avis produits** s'enregistre immédiatement. |
| **Commandes** | Achats client et progression de l'exécution | Ouvre la liste des commandes ; sélectionner une ligne ouvre l'enregistrement complet de la commande. |
| **Produits** | Articles du catalogue, prix, images, variantes, inventaire et optimisation pour les moteurs de recherche | Ouvre la liste des produits ; **Ajouter** démarre un nouveau produit et une ligne ouvre l'édition. |
| **Clients** | Détails de contact client, adresses et historique des commandes | Ouvre la liste des clients ; sélectionner une ligne ouvre l'enregistrement client. |
| **Promotions** | Remises automatiques et codes de promotion | Ouvre la liste des promotions. Utilisez **Créer** ou **Ajouter la première promotion** dans une liste vide pour choisir un type de remise. |
| **Dropshipping** (navigation du projet) | Parcours conditionnel du catalogue des fournisseurs | Ouvrez l'entrée de projet séparée ; les anciennes mises en page peuvent l’afficher dans les opérations du magasin. |
| **Impression à la demande** (navigation du projet) | Produits personnalisés imprimés et traités par Printful, de façon conditionnelle | Ouvrez l'entrée de projet séparée. Consultez [Impression à la demande avec Printful](/fr/guides/store-operations/print-on-demand). |
| **Avis** | Modération des avis conditionnelle | Apparaît après l'activation des avis sur les produits et le support par le magasin. |
**Général ici** gère les détails opérationnels tels que les marchés, les emplacements de stock et l'expédition. [Général du store dans Paramètres](/fr/guides/account-and-settings/store-general) gère le nom Runner, l'aperçu de la recherche, le favicon et le filigrane. Vérifiez quelle page Général vous avez ouverte avant de la modifier.
L'enregistrement se déplace dans les commandes, les clients et les avis dans la boutique de didacticiels. Il montre les états vides et la navigation ; aucun achat, création de client, remboursement ou exécution n'est effectué.
## Ordre de configuration recommandé
1. Complétez [l'intégration et les paramètres généraux](/fr/guides/store-operations/onboarding-and-general-settings).
2. Ajoutez un emplacement de stock et configurez [l'expédition](/fr/guides/store-operations/shipping).
3. Créez [des produits](/fr/guides/store-operations/products) et vérifiez [les variantes et l'inventaire](/fr/guides/store-operations/inventory-and-variants).
4. Connectez un service de paiement à partir des **Apps** avant de tester le paiement.
5. Utilisez [les commandes](/fr/guides/store-operations/orders), [les clients](/fr/guides/store-operations/customers) et [les promotions](/fr/guides/store-operations/promotions) au fur et à mesure que l'activité commence.
6. Utilisez [le dropshipping](/fr/guides/store-operations/dropshipping), [l'impression à la demande](/fr/guides/store-operations/print-on-demand) ou [les avis](/fr/guides/store-operations/reviews-and-advanced-admin) uniquement lorsque ces entrées et conditions préalables sont disponibles.
## États courants et limites
- **Pas encore de données** est un état valide. Les produits, commandes, clients, promotions et avis affichent un message vide jusqu'à ce que des enregistrements existent.
- **Le chargement n'est pas le succès.** Attendez une liste, une confirmation enregistrée ou un statut mis à jour avant de supposer qu'une action est terminée.
- **Les modifications non enregistrées restent sur la page.** Utilisez **Enregistrer** où indiqué ; si Runner vous avertit de partir, choisissez de rester, d'enregistrer ou de quitter sans enregistrer.
- **Les actions destructrices nécessitent une confirmation.** La suppression d'un produit, d'un client ou d'une promotion ne peut pas être supposée récupérable.
- **Les résultats du chat ont toujours besoin de vérification.** Après que Runner ait modifié un enregistrement de magasin, actualisez la page pertinente et confirmez le nouvel état avant de réessayer.
- **Les entrées conditionnelles peuvent être absentes.** N'utilisez pas une URL copiée comme preuve que votre magasin prend en charge une fonctionnalité cachée.
## Si les opérations de la boutique ne se chargent pas
1. Confirmez que vous avez ouvert le projet prévu.
2. Attendez que le message de déploiement disparaisse, puis actualisez la page.
3. Retournez au projet et sélectionnez **Opérations de la boutique** à nouveau.
4. Si une seule section échoue, essayez son contrôle **Actualiser** si disponible.
5. Si le problème persiste, conservez le nom du projet, le nom de la section, l'erreur visible et l'heure approximative pour le support.
## Guides connexes
- [Bienvenue dans Runner AI](/fr/guides/product-guide)
- [Paramètres généraux et intégration](/fr/guides/store-operations/onboarding-and-general-settings)
- [Produits](/fr/guides/store-operations/products)
- [Commandes](/fr/guides/store-operations/orders)
---
# Clients
Source: https://www.runnerai.com/docs/fr/guides/store-operations/customers
Utilisez Clients pour garder les dossiers des acheteurs exacts et comprendre les commandes connectées à chaque personne.
## Pourquoi et quand utiliser Clients
Ouvrez cette section quand vous avez besoin de trouver un acheteur, d'ajouter un dossier client, de corriger les coordonnées ou les informations d'expédition, ou d'examiner l'historique des commandes de la personne.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Un client peut apparaître après le paiement ou être ajouté manuellement.
- La liste étiquette les dossiers comme **Invité** ou **Inscrit** quand ces informations de compte sont disponibles.
- Un emplacement de stock enregistré peut être requis par les flux de travail de magasin liés aux adresses, mais ce n'est pas une affirmation qu'une adresse client est un entrepôt.
- Utilisez les données client uniquement pour le but et l'accès autorisés par votre organisation.
## Ouvrir Clients
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Clients**
Sélectionnez une ligne de client pour ouvrir son profil, les détails de son activité et de son parcours disponibles, ainsi que ses commandes. Sélectionnez **Modifier** pour afficher le formulaire Général ; Les commandes sont masquées pendant que vous les modifiez.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4cFKBjWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Une liste vide est attendue avant que les clients existent. Aucun enregistrement client n'a été créé pour cet exemple.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe quand il est sélectionné |
| --- | --- | --- |
| **Rechercher des clients...** | Trouvez un client par des détails connus | Filtre la liste des clients après un court délai. |
| **Actualiser** | Demander les données client actuelles | Recharge la liste et les données d'emplacement connexes. |
| **Créer** / **Ajouter un client** | Ajouter un client manuellement | Ouvre la boîte de dialogue de création de client. |
| **Créer** dans la boîte de dialogue | Enregistrer le nouveau client | Crée un dossier valide et ouvre sa page de détail après succès. |
| Ligne client | Inspecter un client | Ouvre les coordonnées, l'adresse d'expédition, le type de compte et l'historique des commandes. |
| **Modifier** | Corriger les informations client | Ouvre Général avec les noms, les champs d'e-mail en lecture seule, d'entreprise, de téléphone et d'adresse de livraison. Les commandes sont masquées lors de l'édition. |
| Coupe **Commandes** | Vérifier les achats du client | Affiche les commandes connectées ou **Pas encore de commandes** dans la vue détaillée en lecture seule. |
| **Enregistrer** | Appliquer les modifications sans partir | Enregistre les modifications valides et garde la page de détail ouverte. |
| Retour ou fermeture avec modifications non enregistrées | Décider quoi faire avec les modifications | Ouvre une boîte de dialogue **Modifications non enregistrées** avec **Enregistrer et quitter** et **Quitter sans enregistrer**. |
| **Enregistrer et quitter** | Appliquer les modifications et retourner | À partir de la boîte de dialogue des modifications non enregistrées, enregistre les modifications valides et retourne à la liste des clients. |
| **Quitter sans enregistrer** | Abandonner les modifications après un avertissement | Quitte la page de détail sans appliquer les modifications non enregistrées. |
| Icône Supprimer du bureau / **Supprimer** | Supprimer un dossier client | Ouvre une confirmation ; la confirmation ne peut pas être annulée. La liste mobile actuelle n'affiche pas cette action. |
Un client créé manuellement est inscrit dans **Tous les clients abonnés**. Ajoutez uniquement un enregistrement réel que vous êtes autorisé à gérer ; ne créez pas de destinataires uniquement pour explorer le formulaire. Les sections d'activité ou de parcours vides signifient qu'aucun événement n'est disponible pour ce client, et non que le profil n'a pas pu être enregistré.
La liste vide peut afficher **0 clients**. Utilisez les filtres de recherche, de tri et de balise pour localiser les enregistrements une fois que les clients existent. Effacez les filtres avant de conclure qu’un client est manquant.
Le formulaire vierge affiche l'e-mail requis et les champs facultatifs disponibles. **Créer** reste désactivé jusqu'à ce que les informations requises soient fournies ; aucun enregistrement n'a été sauvegardé.
## Ajouter un client
1. Sélectionnez **Créer** ou **Ajouter un client**.
2. Entrez le **E-mail** requis. Ajoutez le prénom et le nom de famille lorsqu'ils sont connus ; examinez les balises facultatives, l’adresse, l’entreprise, le téléphone, les champs personnalisés et la mémoire uniquement lorsque vous disposez d’informations pertinentes.
3. Examinez les valeurs pour l'orthographe et le client prévu.
4. Sélectionnez **Créer** une fois.
5. Dans l'enregistrement ouvert, sélectionnez **Modifier** avant d'ajouter des informations facultatives sur l'entreprise, le téléphone ou l'adresse de livraison.
6. Sélectionnez **Enregistrer**, puis retournez à la liste et confirmez que la nouvelle ligne apparaît. Si vous partez avec des modifications non enregistrées à la place, choisissez **Enregistrer et quitter** dans l'avertissement.
7. Un nouveau client valide est automatiquement inscrit dans **Tous les clients abonnés**.
## Mettre à jour un client
1. Recherchez et sélectionnez le client.
2. Sélectionnez **Modifier**. Dans le formulaire **Général**, vérifiez le prénom, le nom, l'adresse e-mail en lecture seule, l'entreprise, le téléphone et l'adresse de livraison.
3. Utilisez **Ajouter** pour ajouter les informations d'adresse que Runner demande, ou **Effacer** pour supprimer les valeurs d'adresse modifiables actuelles.
4. Sélectionnez **Enregistrer** pour rester sur le dossier. Pour enregistrer en partant, utilisez le contrôle de retour ou de fermeture et choisissez **Enregistrer et quitter** dans l'avertissement.
5. Quittez l'édition après l'enregistrement, puis inspectez **Commandes** pour confirmer les achats connectés.
## États et limites
- **Invité** signifie que le dossier n'est pas affiché comme un dossier client enregistré ; il peut toujours avoir des commandes.
- Un invité qui commande ou réserve au paiement n'est pas inscrit dans **Tous les clients abonnés**. Il n'y est inscrit que par le formulaire de newsletter de la boutique ou en créant un compte.
- **Inscrit** identifie un dossier client soutenu par un compte.
- **Pas encore de clients** et **Pas encore de commandes** sont des états vides valides.
- La recherche filtre le projet actuel uniquement.
- Les mises à jour client ne modifient pas les totaux de commande historiques ou les états de paiement.
- Recréer un client ne remplace ni un désabonnement antérieur ni la suppression de cette adresse par un fournisseur de messagerie.
- Supprimer est explicitement irréversible et actuellement disponible à partir de la liste de bureau uniquement. Confirmez l'e-mail affiché avant de continuer et conservez les données uniquement selon la politique de votre organisation.
## Dépannage
- **Aucun client trouvé :** Effacez ou raccourcissez la recherche et vérifiez que vous avez ouvert le projet correct.
- **L'enregistrement échoue :** Complétez les champs requis, corrigez l'e-mail ou l'adresse et réessayez une fois.
- **Vous ne pouvez pas quitter le dossier :** Choisissez **Enregistrer et quitter** ou répondez à la boîte de dialogue Modifications non enregistrées avec **Quitter sans enregistrer**.
- **Les commandes manquent :** Confirmez que la commande a utilisé le même dossier client ou e-mail et actualisez à la fois Clients et Commandes.
- **Les détails du client ne se chargent pas :** Retournez à la liste, sélectionnez **Actualiser** et rouvrez la ligne.
## Guides connexes
- [Commandes](./orders)
- [Promotions](./promotions)
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
- [Aperçu des opérations de la boutique](/fr/guides/store-operations)
---
# Vendre des produits numériques
Source: https://www.runnerai.com/docs/fr/guides/store-operations/digital-products
Utilisez les produits numériques pour vendre des fichiers, comme des livres numériques, des guides PDF, des modèles et d'autres téléchargements. Rien n'est expédié. Après le paiement, Runner envoie à l'acheteur un lien privé vers une page de livraison sur votre boutique, où il télécharge les fichiers dans les limites que vous fixez.
## Fonctionnement
1. **Créez un produit numérique.** Choisissez **Numérique** comme type de produit. Les produits numériques n'ont ni expédition ni inventaire.
2. **Ajoutez des avantages.** Un avantage est ce que reçoit l'acheteur, par exemple un ensemble de fichiers. Les avantages sont réutilisables dans tous les produits de votre boutique.
3. **Rédigez l'e-mail de livraison.** Runner l'envoie dès que le paiement est capturé.
4. **Publiez.** Runner vérifie que chaque avantage a un fichier prêt et que l'e-mail de la boutique est activé.
5. **Gérez les livraisons depuis la commande.** Renvoyez l'e-mail, révoquez ou rétablissez l'accès, et décidez de ce que devient l'accès après un remboursement.
### Vidéo : vendre un produit numérique du début à la fin
La vidéo crée un produit **Numérique** et ajoute un avantage de chaque type : **Téléchargements de fichiers**, **Codes ou liens à usage unique**, **Lien d'invitation partagé** et **Note**. Elle rédige l'**E-mail de livraison**, passe le produit à **Publié** et enregistre. Un acheteur achète ensuite le produit par carte, voit son achat sur la page de la commande, ouvre l'e-mail de livraison, télécharge un fichier, affiche un code et sélectionne **Recevoir un nouveau lien par e-mail**. De retour dans **Commandes**, la carte **Livraison numérique** de la commande affiche chaque avantage, et la vidéo utilise **Renvoyer**, **Révoquer** et **Rétablir**. Elle rembourse enfin une deuxième commande avec **Révoquer l'accès de l'acheteur**. Les données de carte sont saisies hors champ. L'interface, les sous-titres et la voix de la vidéo sont en anglais.
## Avant de commencer
**Chemin d'accès :** **Espace de travail → choisissez une boutique → Opérations de la boutique → Produits**
Si **Numérique** n'apparaît pas dans la liste **Type de produit**, les produits numériques ne sont pas encore activés pour votre compte. Contactez le [support Runner](/fr/guides/help-and-reference/support-and-community) pour demander l'accès. Si le formulaire du produit affiche **Votre boutique doit être mise à jour avant de pouvoir vendre des produits numériques.**, votre boutique utilise une version plus ancienne ; contactez le support pour la mettre à jour.
Il vous faut :
- une boutique publiée, car les acheteurs ouvrent leur achat sur votre boutique ;
- l'e-mail de la boutique activé dans **Projet → Apps → Gérez votre boutique → E-mail** tant que l'e-mail de livraison est activé (voir [Activer l'e-mail de la boutique](/fr/guides/apps-and-integrations/resend-email)) ; et
- un prestataire de paiement, pour que les acheteurs puissent payer. Voir [Paiements Stripe](/fr/guides/apps-and-integrations/stripe-payments).
## 1. Créer un produit numérique
1. Ouvrez **Opérations de la boutique → Produits** et sélectionnez **Ajouter**.
2. Dans **Type de produit**, choisissez **Numérique**.
3. Saisissez le nom, la description, les images et le prix comme pour tout produit.
Un produit numérique n'a pas de section d'expédition, et son stock n'est pas suivi : la liste des produits affiche **-** dans **Inventaire**. Un acheteur qui ne prend que des produits numériques paie sans étape d'expédition.
## 2. Ajouter des avantages
La section **Avantages** liste ce que reçoivent les acheteurs. Les acheteurs obtiennent chaque avantage de la liste.
### Créer un avantage
1. Sélectionnez **Créer un avantage**.
2. Saisissez un **Nom**, par exemple « Fichiers du guide ». Les acheteurs le voient sur la page de livraison et dans l'e-mail.
3. Déposez des fichiers sur **Déposez les fichiers ici** ou sélectionnez **Parcourir les fichiers**. Un avantage contient jusqu'à 20 fichiers de 5 Go chacun. Les fichiers restent privés : les acheteurs ne les téléchargent qu'avec leur lien.
4. Dans **Règles d'accès**, choisissez :
- **Limiter les téléchargements** et le nombre de **Téléchargements par article**. Un téléchargement échoué peut être relancé pendant 15 minutes sans consommer un autre téléchargement.
- **Le lien expire** et la durée **Le lien fonctionne pendant**, en heures ou en jours. Un renvoi donne un nouveau lien à l'acheteur.
5. Sélectionnez **Créer** pour lancer l'envoi des fichiers. Gardez la fenêtre ouverte jusqu'à la fin des envois, quand l'avantage apparaît dans la liste **Avantages** du produit.
Pour réutiliser un avantage existant, sélectionnez **Ajouter un avantage existant**. Faites glisser les avantages, ou utilisez **Monter** et **Descendre**, pour définir l'ordre que voient les acheteurs. Un produit numérique garde au moins un avantage.
### Choisir le type d'avantage
Quand vous créez un avantage, choisissez son **Type**. Vous ne pourrez plus le modifier ensuite.
| Type | Ce que reçoivent les acheteurs |
| --- | --- |
| **Téléchargements de fichiers** | Des fichiers privés que les acheteurs téléchargent depuis leur page de livraison. |
| **Codes ou liens à usage unique** | Chaque acheteur reçoit un code ou un lien différent, tiré d'une liste que vous collez. Le produit est épuisé quand la liste est vide. |
| **Lien d'invitation partagé** | Un lien que tous les acheteurs ouvrent, comme une invitation à une communauté. |
| **Note** | Un texte que les acheteurs voient après l'achat, ou une étiquette masquée pour des commandes que vous traitez vous-même. |
Si **Type** n'affiche que **Téléchargements de fichiers**, votre boutique utilise une version antérieure ; contactez le [support Runner](/fr/guides/help-and-reference/support-and-community) pour la mettre à jour.
#### Codes ou liens à usage unique
1. Dans **Ajouter des codes ou des liens**, collez un code ou un lien par ligne, jusqu'à 10 000 à la fois. Les doublons sont ignorés, et chaque valeur est stockée chiffrée.
2. L'avantage indique combien de valeurs sont **Prêts à vendre** et combien sont **Vendus ou réservés pour des commandes**, et vous prévient quand il en reste peu. Quand la liste est vide, le produit apparaît épuisé et ne peut plus être commandé.
3. Chaque unité payée reçoit sa propre valeur, que l'acheteur révèle sur sa page de livraison.
4. Pour reprendre une valeur que personne n'a achetée, retirez-la de **Valeurs inutilisées**.
Dans la commande, la carte **Livraison numérique** affiche la fin de chaque valeur et indique si l'acheteur l'a révélée. Sélectionnez **Afficher** pour voir la valeur entière, ou **Copier** pour la copier.
#### Lien d'invitation partagé
Saisissez le **Lien d'invitation**, qui commence par https:// ou http://. Tous les acheteurs reçoivent le même lien : réglez donc son expiration là où le lien est géré, par exemple dans les paramètres de votre communauté. La carte de la commande indique si l'acheteur l'a ouvert.
#### Note
Rédigez la note dans **Note privée**, puis choisissez sa **Visibilité** :
- **Visible** : les acheteurs la voient après l'achat, sur la confirmation de commande et sur leur page de livraison.
- **Masquée** : accordée à l'achat mais jamais montrée à l'acheteur, par exemple pour étiqueter les commandes que vous traitez vous-même.
Un produit publié garde au moins un avantage que voient les acheteurs : vous ne pouvez donc pas masquer sa seule note visible. Vous ne pouvez pas non plus masquer une note que nomme l'e-mail de livraison d'un produit : retirez-la d'abord de l'e-mail. Les notes masquées n'ont pas de variables d'e-mail.
### Mettre un avantage en pause
Désactivez l'interrupteur à côté d'un avantage pour le mettre en pause pour tous les acheteurs de tous les produits qui l'utilisent. Les acheteurs ne peuvent plus le télécharger tant que vous ne le réactivez pas. Les nouveaux achats attendent, et leur e-mail part dès que vous réactivez l'avantage.
### Modifier les fichiers plus tard
Vous pouvez ajouter des fichiers à un avantage à tout moment ; les acheteurs existants les voient sur leur page de livraison. Retirer un fichier le retire pour tous les acheteurs. Un avantage vendu par des produits garde au moins un fichier : ajoutez d'abord un autre fichier, ou retirez l'avantage de ces produits.
## 3. Rédiger l'e-mail de livraison
La section **E-mail de livraison** contrôle le message que les acheteurs reçoivent dès que le paiement est capturé.
| Réglage | Effet |
| --- | --- |
| **Envoyer l'e-mail de livraison** | Désactivez-le pour livrer uniquement sur la page de confirmation de commande. Les acheteurs y retrouvent alors leur achat pendant 24 heures, et le renvoi par le client est désactivé. |
| **De** | Le nom d'expéditeur que voient les acheteurs. L'e-mail part de l'adresse de Runner, et les réponses arrivent à l'e-mail de contact de votre boutique. |
| **Objet** et **Message** | Utilisez **Insérer une variable** pour ajouter le numéro de commande, la date de commande, le nom du produit, le total payé, le nom ou l'e-mail de l'acheteur, le nom de votre boutique et **Tous les avantages**, qui affiche la liste des avantages. Le lien, l'expiration et les téléchargements appartiennent à un seul avantage ; ils sont donc listés sous chacun. |
| **URL du logo** et **Couleur d'accent** | Tous les e-mails de livraison utilisent le même design. Une **URL du logo** place votre logo en haut de l'e-mail, et la couleur d'accent met en valeur le nom et le bouton de chaque avantage. Laissez **URL du logo** vide pour envoyer l'e-mail sans logo. |
Sélectionnez **Aperçu** pour voir l'e-mail d'une commande d'exemple. L'éditeur refuse une variable qu'il ne connaît pas.
Dans **Paramètres avancés** :
- **Les clients peuvent renvoyer l'e-mail** permet aux acheteurs de le redemander depuis leur page de livraison, jusqu'à 3 fois par jour, à l'adresse e-mail de la commande.
- **Renvoyer automatiquement en cas de rebond temporaire** réessaie une fois après 30 minutes avec le même lien.
## 4. Publier
Réglez **Statut** sur **Publié** et enregistrez. S'il manque quelque chose, Runner enregistre le produit en brouillon et affiche **Ce produit ne peut pas encore être publié** avec ce qu'il faut corriger :
| Message | Que faire |
| --- | --- |
| **Ajoutez au moins un avantage.** | Ajoutez un avantage dans la section **Avantages**. |
| **Ajoutez un fichier à** un avantage | Envoyez au moins un fichier pour cet avantage. |
| **Attendez la fin de l'envoi de** un avantage | Gardez la page ouverte jusqu'à ce que chaque fichier affiche **Prêt**. |
| **Activez l'app E-mail dans Apps, ou désactivez l'e-mail de livraison de ce produit.** | Activez **E-mail** dans **Projet → Apps → Gérez votre boutique**, ou désactivez **Envoyer l'e-mail de livraison**. |
| **Votre boutique doit être mise à jour avant de pouvoir vendre des produits numériques.** | Contactez le [support Runner](/fr/guides/help-and-reference/support-and-community). |
## Ce que reçoivent les acheteurs
1. L'acheteur passe commande. Un panier ne contenant que des produits numériques n'a pas d'étape d'expédition.
2. Dès que le paiement est capturé, Runner envoie à l'acheteur un lien vers sa page de livraison sur votre boutique. La page de confirmation de commande affiche aussi l'achat pendant 24 heures.
3. Sur la page de livraison, l'acheteur télécharge chaque fichier. Chaque téléchargement compte dans la limite, et le lien cesse de fonctionner quand il expire ou quand vous en envoyez un plus récent.
4. Si vous l'autorisez, l'acheteur peut redemander l'e-mail depuis la page de livraison.
## Gérer les livraisons d'une commande
Dans **Opérations de la boutique → Commandes**, la colonne **Traitement** affiche l'état de livraison de chaque commande numérique, avec les états du tableau ci-dessous. Quand une commande a plusieurs avantages, la colonne affiche celui qui demande votre attention en premier : **Échec**, puis un état pas encore livré (**En attente**, **Envoi en cours** ou **Lien prêt**), puis **Livré**. **Téléchargements épuisés**, **Expiré** et **Révoqué** n'apparaissent que lorsque tous les avantages sont terminés. Une commande affiche **Sans livraison** tant que son paiement n'est pas capturé.
Ouvrez **Opérations de la boutique → Commandes** et sélectionnez une commande. La carte **Livraison numérique** affiche chaque avantage avec son état, **Téléchargements utilisés**, **Le lien expire** et **Dernière activité**.
| État | Signification |
| --- | --- |
| **En attente** | La livraison attend, par exemple pendant que l'avantage est en pause. |
| **Lien prêt** | Le lien existe. L'e-mail est en file d'attente, ou l'e-mail de livraison est désactivé. |
| **Envoi en cours** | L'e-mail est en route. |
| **Livré** | L'e-mail est arrivé chez l'acheteur. |
| **Échec** | La livraison s'est arrêtée. La carte indique pourquoi, par exemple **L'e-mail de la boutique est désactivé** ou **La boutique n'est pas publiée**. |
| **Téléchargements épuisés** | L'acheteur a utilisé tous ses téléchargements. Un renvoi les rétablit. |
| **Expiré** | Le lien a expiré. Un renvoi donne un nouveau lien. |
| **Révoqué** | Vous avez révoqué l'accès. |
Utilisez les actions de la carte :
- **Renvoyer** envoie un nouveau lien, éventuellement à une adresse corrigée. Les liens précédents cessent de fonctionner, et les téléchargements épuisés sont rétablis.
- **Révoquer** arrête les nouveaux téléchargements pour un avantage ou pour toute la commande. Un lien de téléchargement émis dans la dernière minute peut encore aboutir.
- **Rétablir** rend un accès révoqué avec un nouveau quota de téléchargements et envoie un nouveau lien.
**Historique de livraison** liste chaque e-mail et son résultat, et **Parcours** liste chaque événement, comme **E-mail ouvert**, **Page de livraison ouverte** et **Téléchargé**. Sélectionnez **Exporter en CSV** pour télécharger le parcours.
Pour trouver les commandes qui demandent votre intervention, activez le filtre **À traiter** dans la liste des commandes. Il affiche les livraisons en échec et les remboursements sans décision d'accès.
### Remboursements
Quand vous remboursez une commande avec des articles numériques, choisissez **Conserver l'accès de l'acheteur** ou **Révoquer l'accès de l'acheteur** dans la boîte de dialogue de remboursement. Un remboursement effectué ailleurs, par exemple dans le tableau de bord de votre prestataire de paiement, apparaît sur la carte comme remboursé avec l'accès toujours actif, avec **Conserver l'accès** et **Révoquer l'accès**, pour que vous décidiez plus tard.
## Créer un produit numérique dans le chat
Vous pouvez aussi le demander à Runner dans le chat. Joignez les fichiers à votre message et décrivez le produit, par exemple « Vends ce PDF comme livre numérique à 12 € ». Runner crée un brouillon de produit avec un avantage pour les fichiers et rédige l'e-mail de livraison. Il s'arrête là où vous seul pouvez agir, par exemple quand l'e-mail de la boutique est désactivé. Vérifiez le brouillon dans **Produits** avant de publier.
Les fichiers joints dans le chat sont limités à ce que le chat accepte : documents jusqu'à 10 Mo et images jusqu'à 32 Mo. Envoyez les fichiers plus volumineux dans le formulaire du produit.
## Dépannage
| Problème | Que faire |
| --- | --- |
| La carte affiche **Échec** avec **L'e-mail de la boutique est désactivé** | Activez **E-mail** dans **Projet → Apps → Gérez votre boutique**, puis sélectionnez **Renvoyer**. |
| La carte affiche **Échec** avec **La boutique n'est pas publiée** | Publiez votre boutique, puis sélectionnez **Renvoyer**. |
| L'e-mail est **Rejeté** | Vérifiez l'adresse avec l'acheteur, puis sélectionnez **Renvoyer** et saisissez l'adresse corrigée. |
| **Aucun fichier n'était prêt quand la commande a été payée.** | Envoyez un fichier pour l'avantage, puis sélectionnez **Renvoyer**. |
| **L'avantage est en pause.** | Réactivez l'avantage. L'e-mail en attente part. |
---
# Dropshipping
Source: https://www.runnerai.com/docs/fr/guides/store-operations/dropshipping
Le dropshipping vous permet de vendre des produits fournisseur sans détenir de stock : lorsqu'un client achète, Runner envoie la commande à votre fournisseur, puis vous la confirmez et la payez dans votre compte fournisseur pour que le fournisseur l'expédie à votre client.
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Dropshipping**
Les mises en page plus anciennes peuvent afficher Dropshipping dans **Opérations de la boutique**. Utilisez l'entrée affichée dans votre projet.
## Fonctionnement du dropshipping
| Étape | Ce que vous faites | Ce que fait Runner |
| --- | --- | --- |
| [1. Connecter](#1-connecter-un-fournisseur) | Connectez votre propre compte CJ Dropshipping ou AliExpress. | Utilise ce compte pour rechercher, importer et passer les commandes fournisseur. |
| [2. Parcourir et choisir](#2-parcourir-et-choisir-un-produit) | Choisissez une destination, trouvez un produit et comparez les variantes, le stock et les délais de livraison estimés. | Charge les données fournisseur en direct pour votre compte connecté. |
| [3. Vérifier et publier](#3-vérifier-et-publier-un-produit) | Choisissez un marché cible, fixez les prix, sélectionnez les variantes et ajoutez le produit. | Crée le produit et le publie sur ce marché. |
| [4. Traiter les commandes](#4-traiter-les-commandes) | **Payez chaque commande fournisseur dans votre compte fournisseur**, puis enregistrez l'expédition sur la commande de la boutique. | Crée automatiquement la commande fournisseur après le paiement du client et affiche son statut et son suivi. |
Pour cesser d'utiliser un fournisseur ou changer de compte fournisseur, consultez [Déconnecter un fournisseur](#déconnecter-un-fournisseur). Il s'agit d'une tâche distincte, avec ses propres vérifications, qui ne fait pas partie du travail quotidien.
:::warning
Runner passe les commandes fournisseur à votre place, mais il **ne paie pas le fournisseur**. Une commande fournisseur reste impayée, et n'est pas expédiée, tant que vous ne l'avez pas confirmée et payée dans votre compte CJ ou AliExpress.
:::
## Avant de commencer
- **Votre propre compte fournisseur.** Utilisez un compte CJ Dropshipping ou un compte acheteur AliExpress capable de payer des commandes. Vous payez le fournisseur pour chaque commande, indépendamment de ce que votre client vous paie.
- **Rôle de propriétaire ou d'administrateur.** Seul un propriétaire ou un administrateur de l'espace de travail peut connecter ou déconnecter un fournisseur. Les autres membres voient **Seul le propriétaire ou un administrateur de l’espace de travail peut connecter ce fournisseur. Demandez-le-lui.**
- **Un marché de boutique.** Les destinations de dropshipping proviennent des marchés de votre boutique. Sans marché, la page affiche **Ajoutez un marché pour choisir une destination de livraison et parcourir les produits.**
- **Un service de paiement.** Les clients ne peuvent acheter qu'une fois un service de paiement connecté dans **Apps**.
Les connexions fournisseur appartiennent à votre organisation : toutes les boutiques de l'espace de travail utilisent donc les mêmes connexions CJ et AliExpress. CJ et AliExpress se connectent séparément ; connecter l'un ne remplace jamais l'autre.
## 1. Connecter un fournisseur
Vous pouvez parcourir les étagères d'aperçu **Tendances**, **Sélection à petit prix** et **Moins de 5 $** sans connexion. La recherche, l'ouverture des données produit en direct et l'ajout de produits nécessitent un fournisseur connecté.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Les annotations en anglais indiquent les commandes. Sélectionnez l'image pour l'agrandir.
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| **Connecter un fournisseur** | Lancer votre première connexion fournisseur. | Ouvre **Connecter et gérer les fournisseurs** avec des panneaux distincts pour CJ Dropshipping et AliExpress. |
| **Gérer les fournisseurs** | Vérifier, reconnecter ou déconnecter une connexion existante. | Remplace **Connecter un fournisseur** dès qu'un fournisseur est connecté et ouvre la même boîte de dialogue. |
| **Comment ça marche** | Comparer les deux méthodes de connexion. | Explique que CJ utilise une clé API et qu'AliExpress utilise la connexion AliExpress. |
| **Clé API CJ** | Connecter votre compte CJ. | Accepte la clé copiée depuis CJ. La valeur reste masquée. |
| **Voir les instructions CJ** | Trouver votre clé API dans CJ. | Ouvre les instructions de CJ sur la clé API dans un nouvel onglet. |
| **Connecter CJ Dropshipping** | Envoyer la clé. | Runner vérifie la clé auprès de CJ. En cas de réussite, la boîte de dialogue se ferme et CJ apparaît comme connecté. |
| **Connecter AliExpress** | Connecter votre compte acheteur AliExpress. | Vous redirige vers la connexion AliExpress, puis vous ramène dans Dropshipping. |
| **Reconnecter AliExpress** | Renouveler l'accès AliExpress avant ou après son expiration. | Relance la connexion AliExpress pour le compte connecté. |
### Connecter CJ Dropshipping
1. Ouvrez **Dropshipping** et sélectionnez **Connecter un fournisseur** (ou **Gérer les fournisseurs**).
2. Dans votre compte CJ Dropshipping, ouvrez **Apps → API**, puis sélectionnez l'onglet **API**. Copiez la clé de type **API Key** dans la colonne **API Key & MCP Token**. Si vous n'en avez pas, sélectionnez **Add API** pour en créer une. Sélectionnez **Voir les instructions CJ** dans Runner si vous avez besoin des étapes de CJ.
3. Collez la clé dans **Clé API CJ** et sélectionnez **Connecter CJ Dropshipping**.
4. Attendez que la boîte de dialogue se ferme et que CJ Dropshipping apparaisse comme connecté.
5. Recherchez un produit pour vérifier que votre catalogue CJ se charge.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw6oh1NIkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
Dans CJ, ouvrez **Apps** (1) et **API** (2), sélectionnez l'onglet **API** (3), puis copiez la clé dans **API Key & MCP Token** (4). Sélectionnez l'image pour l'agrandir. Gardez votre clé confidentielle ; cet exemple masque les valeurs des clés.
Si vous voyez **Impossible de connecter CJ : vérifiez la clé API et réessayez.**, copiez à nouveau la clé depuis CJ et réessayez. Ce message signifie que CJ a refusé la clé. Si vous voyez **CJ n'a pas répondu. Réessayez dans un instant.**, CJ a rencontré un problème en vérifiant la clé ; réessayez peu après. Si vous voyez **CJ limite actuellement les requêtes de ce compte. Patientez quelques minutes, puis réessayez.**, la clé peut tout de même être valide : CJ limite les appels à votre compte CJ, par exemple parce qu'une autre application utilise la même clé. Patientez quelques minutes, puis réessayez.
### Connecter AliExpress
1. Ouvrez **Dropshipping** et sélectionnez **Connecter un fournisseur** (ou **Gérer les fournisseurs**).
2. Sélectionnez **Connecter AliExpress**. Votre navigateur quitte Runner et ouvre la page de connexion AliExpress.
3. Connectez-vous avec le compte **acheteur** AliExpress que vous utiliserez pour payer les commandes fournisseur, puis autorisez l'accès.
4. Lorsque AliExpress vous renvoie vers Runner, vérifiez que **AliExpress est connecté** s'affiche. Si vous étiez parti d'une recherche ou d'un produit, Runner vous y ramène à la place.
Si vous voyez **Impossible d’ouvrir la connexion à AliExpress. Réessayez.**, relancez la connexion depuis le même compte Runner.
**L'accès AliExpress expire.** AliExpress fixe la durée de validité de l'accès. Runner affiche **Votre autorisation AliExpress expire bientôt** et envoie un e-mail aux propriétaires et administrateurs de l'espace de travail 7 jours et 1 jour avant l'expiration. Sélectionnez **Reconnecter AliExpress** et connectez-vous avec le **même** compte AliExpress. Si l'accès expire, la recherche, l'importation et les nouvelles commandes AliExpress s'arrêtent jusqu'à ce que vous vous reconnectiez.
L'enregistrement passe en revue les connexions CJ et AliExpress existantes, puis revient au catalogue. Il ne connecte, ne déconnecte, n'achète et n'importe rien.
## 2. Parcourir et choisir un produit
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgL9CDE0P6BaUgYNS457p8WDbAxIJ2kfdz9Vju)
Les annotations en anglais indiquent les commandes. Sélectionnez l'image pour l'agrandir.
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| **Tendances**, **Sélection à petit prix**, **Moins de 5 $** | Trouver des idées sans effectuer de recherche. | Ouvre une étagère d'aperçu. Les étagères ne garantissent ni la popularité, ni la marge, ni la livraison. |
| **Rechercher des produits...** | Trouver des articles par mot-clé. Avec AliExpress, vous pouvez aussi coller un ID ou un lien de produit. | Charge les résultats de votre fournisseur connecté. Sans connexion, ouvre la boîte de dialogue de connexion. |
| **Expédier vers** | Choisir le pays dans lequel vous vendez. | Recharge les produits pouvant être expédiés vers ce pays. Seuls les pays de vos marchés de boutique peuvent être sélectionnés ; les autres affichent **Ajouter** pour que vous puissiez créer un marché. |
| Sélecteur de fournisseur | Limiter les résultats à un seul fournisseur. | Affiche **Tous les fournisseurs**, **CJ Dropshipping** ou **AliExpress**, selon ce que vous avez connecté. |
| **Catégorie**, **Expédier depuis**, **Prix** | Affiner les résultats. | Filtre par catégorie, par pays de l'entrepôt du fournisseur et par prix minimum et maximum. |
| Tri | Modifier l'ordre des résultats. | CJ propose des tris par prix, par mise en ligne et par nouveauté. AliExpress propose **Meilleure correspondance** et **Plus de commandes (180 derniers jours)** ; il ne permet pas de trier par prix de façon fiable. |
| Fiche produit | Évaluer un article. | Ouvre ses images, ses variantes, son stock, son prix fournisseur et ses délais de livraison estimés. |
1. Choisissez **Expédier vers**. La valeur de départ est les États-Unis lorsqu'ils font partie de vos marchés, sinon votre marché par défaut.
2. Parcourez une étagère ou lancez une recherche. Utilisez le sélecteur de fournisseur et les filtres pour affiner les résultats.
3. Ouvrez une fiche produit. Vérifiez les images, les variantes que vous souhaitez vendre, le stock (**en stock** ou **En rupture de stock**) et le prix fournisseur.
4. Pour chaque variante, examinez le **Mode de livraison de référence** et le **Délai de livraison estimé**. Il s'agit d'estimations du fournisseur, pas de garanties de livraison.
5. Sélectionnez **Retour** pour comparer d'autres produits. Votre destination reste sélectionnée.
## 3. Vérifier et publier un produit
La page produit regroupe au même endroit la configuration du produit, le marché, les prix et la livraison. Sélectionner **Ajouter le produit à la boutique** crée le produit et le publie sur le marché sélectionné.
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| **Marché cible** | Choisir le marché qui vend ce produit. | Définit la devise de vos prix. La valeur de départ reprend votre choix **Expédier vers**. **Ajouter un marché** en crée un nouveau. |
| **Frais de livraison du client** | Décider ce que les clients paient pour la livraison. | **Utiliser les tarifs de livraison de la boutique** applique les tarifs de livraison de votre marché au moment du paiement. |
| **Définir la majoration** | Fixer le prix de toutes les variantes à partir d'une seule majoration. | Suggère un prix de vente pour chaque variante sélectionnée à partir de son coût produit et de la référence des frais de livraison fournisseur. |
| **Prix de vente** | Fixer votre prix de vente par variante. | Met à jour le bénéfice et la marge estimés pour cette variante. |
| Case à cocher de variante | Choisir les variantes à vendre. | Ajoute ou retire la variante. La barre d'actions indique le nombre de variantes sélectionnées. |
| **Mode de livraison de référence** | Estimer vos frais de livraison fournisseur. | Met à jour la répartition des coûts : **Coût du produit**, **+ Référence des frais de livraison fournisseur**, **+ Bénéfice · marge**. |
| **Ajouter le produit à la boutique** | Créer et publier le produit. | Importe les variantes sélectionnées et publie le produit sur le marché cible. Affiche **Connecter un fournisseur** en l'absence de connexion. |
### Configurer les détails et les prix du produit
1. Choisissez le **Marché cible**.
2. Sélectionnez uniquement les variantes que vous comptez vendre. Ignorez les variantes qui affichent **En rupture de stock**.
3. Choisissez un **Mode de livraison de référence** pour chaque variante et vérifiez son **Délai de livraison estimé**.
4. Saisissez une majoration dans **Définir la majoration**, ou saisissez un prix pour chaque variante dans **Prix de vente**.
5. Vérifiez la répartition des coûts et le **Bénéfice moyen estimé par unité**. Assurez-vous que chaque prix couvre le coût du produit et les frais de livraison fournisseur que vous paierez.
CJ indique les coûts fournisseur en dollars américains. Lorsque votre marché utilise une autre devise, Runner affiche des montants convertis à titre indicatif uniquement.
### Choisir les marchés cibles
- Chaque importation publie sur un seul marché à la fois. Les prix sont enregistrés dans la devise de ce marché.
- Pour vendre le même produit sur un autre marché, revenez au produit dans Dropshipping, choisissez l'autre **Marché cible**, saisissez les prix dans cette devise et sélectionnez à nouveau **Ajouter le produit à la boutique**.
- Chaque variante du produit doit avoir un prix dans la devise du marché avant de pouvoir y être publiée.
### Configurer la livraison
- Les clients paient les **tarifs de livraison de votre boutique** pour leur marché, et non les frais de livraison du fournisseur. Incluez les frais de livraison fournisseur estimés dans le prix de votre produit ou dans votre tarif de livraison.
- Les **Frais de livraison** d'un nouveau marché correspondent au tarif payé par les clients. **Saisissez 0 pour la livraison gratuite.** Vous pourrez modifier les options de livraison plus tard dans [Expédition](./shipping).
- Les coûts fournisseur varient selon l'adresse de livraison. Au moment du paiement, Runner revérifie votre connexion fournisseur, le stock, le prix et la livraison pour l'adresse du client. Si le fournisseur ne peut plus fournir l'article, le paiement s'arrête au lieu d'accepter une commande que vous ne pourriez pas traiter.
### Publier et vérifier le résultat
1. Sélectionnez **Ajouter le produit à la boutique** une fois vos variantes et vos prix définis.
2. Attendez le message **Publié. Vous pouvez sélectionner un autre marché pour y publier ce produit.** Un message **Modifications enregistrées** avec **Voir la boutique** s'affiche également.
3. Ouvrez **Produits** et vérifiez le produit, ses variantes, ses prix, ses images et sa description. Vous pouvez y modifier le titre, la description et les images.
4. Prévisualisez la boutique et vérifiez que le produit apparaît sur le marché choisi.
Les produits en dropshipping ne suivent pas l'inventaire dans Runner ; le stock du fournisseur est vérifié au moment du paiement. La colonne **Inventaire** de Produits affiche un tiret pour ces produits.
Si vous voyez **Le résultat n’est pas confirmé. Réessayez la même demande avant de modifier la sélection.**, sélectionnez à nouveau la même action sans modifier vos sélections, puis vérifiez **Produits**.
Les boutiques plus anciennes peuvent afficher une autre page produit avec **Expédier depuis**, **Expédier vers**, une liste de modes d'expédition et **Ajouter à la boutique**. Les mêmes règles s'appliquent : choisissez un itinéraire et un devis, fixez un prix pour chaque variante sélectionnée, puis ajoutez le produit.
## 4. Traiter les commandes
Lorsqu'un client achète un produit en dropshipping, le traitement se fait en deux temps. Runner passe la commande fournisseur à votre place. **Vous devez ensuite la confirmer et la payer dans votre compte fournisseur.** Le fournisseur n'expédie rien tant que vous ne l'avez pas fait.
### Ce que Runner fait automatiquement
- Après le paiement du client, Runner crée une commande fournisseur dans votre compte CJ ou AliExpress connecté. Vous n'avez rien à sélectionner dans Runner pour l'envoyer.
- Une commande de la boutique peut créer plusieurs commandes fournisseur : une par fournisseur, entrepôt ou mode d'expédition.
- Chaque commande fournisseur apparaît dans la section **Traitement dropshipping** de la commande de la boutique, avec son statut, **Méthode d'expédition**, **Entrepôt**, **Articles** et l'heure de **Dernière mise à jour**. Les informations de suivi apparaissent dès que le fournisseur expédie.
- Si une commande fournisseur ne peut pas être créée du premier coup, Runner continue de réessayer et affiche **Création en attente** pendant ce temps.
- Runner met à jour le statut fournisseur lorsque vous ouvrez la commande, lorsque vous sélectionnez **Actualiser le statut** et lors d'une vérification quotidienne en arrière-plan pour les commandes passées au cours des 90 derniers jours. Pour les commandes en cours plus anciennes, sélectionnez **Actualiser le statut** ou contactez l'assistance.
Runner ne paie **pas** le fournisseur et ne marque **pas** la commande de la boutique comme expédiée à votre place.
### Traiter une commande étape par étape
1. Ouvrez **Opérations de la boutique → Commandes** et sélectionnez la commande.
2. Repérez **Traitement dropshipping**. Attendez que la commande fournisseur affiche **Créé** ou **Non payé**. Si elle affiche encore **Création en attente**, revenez plus tard ; Runner réessaie.
3. **Payez la commande fournisseur dans votre compte fournisseur :**
- **CJ Dropshipping :** connectez-vous à CJ, ouvrez vos commandes et trouvez celle dont le numéro contient votre numéro de commande Runner (par exemple, `…-1042-0` pour la commande 1042). Confirmez les informations de livraison et payez-la avec votre solde CJ ou votre moyen de paiement.
- **AliExpress :** Runner affiche **Paiement manuel requis** et les **ID de commande fournisseur AliExpress**. Connectez-vous au compte acheteur AliExpress connecté et payez chaque commande de la liste.
4. Revenez à la commande dans Runner et sélectionnez **Actualiser le statut**. Après le paiement, le statut passe à **En traitement**, puis à **Expédié** lorsque le fournisseur envoie la commande.
5. Lorsque **toutes** les commandes fournisseur de **Traitement dropshipping** affichent **Expédié**, sélectionnez **Marquer comme préparé** sur la commande de la boutique, puis **Marquer comme expédié**. Saisissez le **Transporteur** et un **Numéro de suivi** figurant dans la section Traitement Dropshipping. L'expédition est ainsi enregistrée sur la commande de la boutique que voit votre client.
6. Lorsque toutes les commandes fournisseur affichent **Livré**, sélectionnez **Marquer comme livré**.
**Marquer comme préparé** et **Marquer comme expédié** s'appliquent à l'ensemble de la commande de la boutique, y compris aux articles que vous expédiez vous-même, et une commande ne peut être marquée comme expédiée qu'une seule fois. Si une commande comporte plusieurs commandes fournisseur, attendez qu'elles aient toutes été expédiées, puis envoyez directement les autres numéros de suivi à votre client.
:::warning
Ne repassez pas vous-même la même commande dans CJ ou AliExpress. Runner l'a déjà créée. Une deuxième commande signifie que le fournisseur expédie, et vous facture, deux fois.
:::
### Statuts des commandes fournisseur
| Statut | Ce que cela signifie | Que faire |
| --- | --- | --- |
| **Création en attente** | Runner est encore en train de créer la commande fournisseur. | Attendez. Runner réessaie automatiquement. **Actualiser le statut** ne s'applique pas encore. |
| **Créé**, **Dans le panier**, **Non payé** | Le fournisseur a reçu la commande, mais elle n'est pas payée. | Payez-la dans votre compte CJ ou AliExpress. |
| **En traitement**, **Autre** | Payée ; le fournisseur la prépare. Les commandes AliExpress à ce stade affichent **Autre**. | Attendez le suivi. Sélectionnez **Actualiser le statut** pour vérifier. Si une commande AliExpress reste sur **Autre**, ouvrez-la dans votre compte AliExpress pour voir si elle nécessite une action, par exemple une adresse complète. |
| **Expédié** | Le fournisseur l'a expédiée. | Sélectionnez **Suivre la commande** pour la suivre. Lorsque toutes les commandes fournisseur de la commande de la boutique ont été expédiées, enregistrez l'expédition avec **Marquer comme expédié**. |
| **Livré** | Le fournisseur signale la livraison. | Sélectionnez **Marquer comme livré** sur la commande de la boutique. |
| **Annulation en attente** | Runner a demandé au fournisseur d'annuler. | Attendez, puis sélectionnez **Actualiser le statut**. |
| **Annulé**, **Annulée** | La commande fournisseur ne sera pas expédiée. | Vérifiez que la commande de la boutique est également annulée ou remboursée. |
| **Échoué** | Runner n'a pas pu créer la commande fournisseur. | Recherchez la commande dans votre compte fournisseur. Si elle n'y figure pas, contactez l'assistance avant de la passer manuellement. |
| **Vérification manuelle requise** | Runner n'a pas pu confirmer que le fournisseur a bien reçu la commande. | Ne la renvoyez pas. Sélectionnez **Contacter l’assistance** pour que la commande soit rapprochée en toute sécurité. |
### Annuler ou rembourser une commande dropshipping
Lorsque vous sélectionnez **Annuler la commande** sur une commande de la boutique, Runner demande automatiquement au fournisseur d'annuler ses commandes fournisseur. Aucune étape supplémentaire n'est nécessaire dans Runner.
- **CJ Dropshipping :** Runner envoie l'annulation à CJ tant que la commande fournisseur n'a pas été expédiée. CJ décide si elle peut encore être annulée.
- **AliExpress :** Runner ne peut arrêter la commande qu'avant sa création dans AliExpress ; AliExpress n'accepte pas les annulations envoyées par Runner. Ensuite, Runner affiche **Annulation manuelle requise** et **Ne payez pas. Annulez ces ID de commande fournisseur dans le compte acheteur AliExpress connecté.** Annulez ces commandes dans votre compte AliExpress.
Après l'annulation, ouvrez la commande et vérifiez **Traitement dropshipping**. **Annulation en attente** signifie que Runner attend le fournisseur ; **Annulé** signifie que l'annulation est terminée. Si le statut ne passe pas à **Annulé**, annulez la commande directement dans votre compte CJ ou AliExpress, et ne la payez pas.
- **Un remboursement n'annule pas la commande fournisseur.** Si vous remboursez un client sans annuler la commande, le fournisseur peut quand même l'expédier et vous la facturer.
- **Runner ne rembourse pas les coûts fournisseur.** Si vous avez déjà payé le fournisseur, demandez un remboursement à CJ ou à AliExpress.
## Déconnecter un fournisseur
Ne déconnectez un fournisseur que lorsque vous cessez de l'utiliser ou que vous devez changer de compte fournisseur. La déconnexion supprime votre clé API CJ ou votre accès AliExpress de l'organisation. Elle concerne toutes les boutiques de l'espace de travail.
:::warning
**Traitez et clôturez les commandes en cours avant de vous déconnecter.** Après la déconnexion, Runner cesse de mettre à jour ces commandes fournisseur : le statut, le suivi, **Actualiser le statut** et l'annulation ne fonctionnent plus dans Runner, et vous devez les gérer directement dans CJ ou AliExpress.
:::
### Avant de vous déconnecter
1. Ouvrez **Opérations de la boutique → Commandes** et examinez chaque commande comportant une section **Traitement dropshipping** pour ce fournisseur.
2. Payez chaque commande fournisseur **Créé**, **Dans le panier** ou **Non payé**, ou annulez-la.
3. Attendez que les commandes **Création en attente** et **En traitement** soient créées, expédiées ou annulées.
4. Enregistrez l'expédition sur chaque commande de la boutique avec **Marquer comme expédié** une fois que toutes ses commandes fournisseur ont été expédiées.
5. Passez les produits de ce fournisseur en **Brouillon** dans **Produits**, ou supprimez-les. Après la déconnexion, les clients ne peuvent plus les acheter.
### Se déconnecter
1. Ouvrez **Dropshipping** et sélectionnez **Gérer les fournisseurs**.
2. Sélectionnez **Déconnecter** pour CJ Dropshipping ou AliExpress.
3. Lisez **Déconnecter CJ Dropshipping ?** ou **Déconnecter AliExpress ?** : **Vous ne pourrez plus ajouter de nouveaux produits ni recevoir de mises à jour de ce fournisseur. Les produits et commandes déjà dans Runner sont conservés.**
4. Sélectionnez **Déconnecter** pour confirmer, ou **Annuler** pour conserver la connexion.
5. Vérifiez que le fournisseur n'apparaît plus comme connecté.
Si vous voyez **Impossible de déconnecter CJ ; il est toujours connecté. Réessayez.** ou **AliExpress est toujours connecté. La déconnexion n’a pas abouti. Réessayez.**, la connexion est toujours active. Réessayez, et ne considérez pas qu'elle a été supprimée.
### Ce qui change après la déconnexion
| Domaine | Résultat |
| --- | --- |
| Produits | Restent dans **Produits**, mais le paiement s'arrête pour eux jusqu'à ce que vous vous reconnectiez et, si nécessaire, que vous les importiez à nouveau. |
| Nouvelles commandes | Les clients ne peuvent pas acheter les produits de ce fournisseur : aucune nouvelle commande fournisseur n'est donc créée. |
| Commandes fournisseur existantes | Restent dans la commande, mais ne sont plus mises à jour. Gérez-les dans CJ ou AliExpress. |
| Autre fournisseur | Non concerné. Déconnecter CJ ne déconnecte pas AliExpress, et inversement. |
## Dépannage
- **La recherche ou Ajouter le produit à la boutique ouvre la boîte de dialogue de connexion :** connectez CJ ou AliExpress. Les étagères d'aperçu ne comptent pas comme une connexion.
- **Aucun résultat :** effacez la recherche et les filtres, vérifiez **Expédier vers** ou changez de fournisseur.
- **Un pays ne peut pas être sélectionné dans Expédier vers :** ajoutez un marché pour ce pays, puis choisissez-le à nouveau.
- **Une commande reste bloquée sur Non payé :** Runner ne paie jamais les fournisseurs. Payez la commande dans votre compte CJ ou AliExpress.
- **Le client n'a pas reçu de suivi :** Runner ne copie pas le suivi fournisseur sur la commande de la boutique. Utilisez **Marquer comme expédié** avec le numéro de suivi.
- **Actualiser le statut échoue avec « Une erreur est survenue » :** la connexion fournisseur a peut-être changé depuis que la commande a été passée. Vérifiez **Gérer les fournisseurs**, puis gérez la commande dans votre compte fournisseur.
- **Le paiement s'arrête pour un produit en dropshipping :** la connexion fournisseur, le stock, le prix ou la livraison ont changé. Reconnectez le fournisseur ou importez à nouveau le produit.
- **Un produit affiche un résultat incorrect après Ajouter le produit à la boutique :** vérifiez **Produits** avant de réessayer. Un état de chargement ne prouve pas que l'importation est terminée.
- Pour les messages d'erreur exacts, consultez le [guide des erreurs du catalogue Dropshipping](/fr/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products).
## Guides connexes
- [Commandes](./orders)
- [Produits](./products)
- [Expédition](./shipping)
- [Inventaire et variantes](./inventory-and-variants)
- [Connecter CJ Dropshipping](/fr/guides/apps-and-integrations/cj-dropshipping)
- [Aperçu des opérations de la boutique](/fr/guides/store-operations)
---
# Importer des produits
Source: https://www.runnerai.com/docs/fr/guides/store-operations/import-products
Importez des produits à partir d'un CSV préparé lorsque l'entrée des mêmes informations de catalogue structurées un produit à la fois serait inefficace.
## Pourquoi et quand utiliser l'importation
Utilisez Importer lorsque vous avez déjà des données de produit dans une feuille de calcul ou un autre système et que vous pouvez les mapper au modèle CSV de Runner. Utilisez le formulaire [Produits](./products) manuel pour un petit catalogue ou lorsque vous devez d'abord apprendre les champs.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Ouvrez **Opérations de la boutique → Produits** dans un magasin prêt.
- Complétez la configuration de publication/préparation du magasin qui crée son canal de catalogue de vitrine en direct ; la tâche d'importation ne peut pas continuer sans ce canal.
- La liste de produits de bureau remplie affiche **Importer**. Dans un catalogue vide, utilisez d'abord **Ajouter le premier produit** ; la vue mobile met l'accent sur la création manuelle.
- L'importation accepte uniquement les fichiers CSV.
- Utilisez le modèle actuel de Runner. Les colonnes `Product Handle` et `Product Title` sont obligatoires ; les lignes de variantes utilisent les champs d'options du modèle et `Variant SKU` est facultatif.
- Le démarrage d'une importation modifie le catalogue du magasin. Examinez le fichier avant de le soumettre.
## Ouvrir Importer des produits
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Produits → Importer**
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRTPhrLOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| **Importer** | Ouvrez le flux de travail d'importation en masse | Ouvre la boîte de dialogue Importer des produits sans démarrer une tâche. |
| **Modèle** | Commencez par les colonnes attendues de Runner | Télécharge le fichier `product-import-template.csv` actuel. |
| **Historique** | Vérifiez les tâches d'importation antérieures | Bascule vers une liste de fichiers d'importation et leurs derniers états. |
| Zone de téléchargement | Choisissez le CSV préparé | Lit le fichier localement et l'affiche comme prêt lorsque le contenu est disponible. |
| Contrôle de suppression de fichier | Corrigez une sélection incorrecte | Efface le fichier sélectionné pour que vous puissiez en choisir un autre. |
| **Démarrer l'importation** | Soumettez le CSV sélectionné | Démarre une tâche d'importation, puis passe à l'Historique lorsque Runner l'accepte. |
| **Annuler** | Quittez sans soumettre | Ferme la boîte de dialogue et efface le fichier sélectionné. |
| **Actualiser** dans l'Historique | Demandez le dernier état de la tâche | Recharge l'historique d'importation visible. |
| **Retour à l'import** | Préparez un autre fichier | Revient de l'Historique à la vue de téléchargement. |
| **Fermer** | Quittez l'Historique | Ferme la boîte de dialogue sans modifier la tâche déjà soumise. |
## Préparer et soumettre un CSV
1. Sélectionnez **Importer**, puis **Modèle**.
2. Ouvrez le CSV téléchargé dans un éditeur de feuille de calcul qui préserve le formatage CSV.
3. Conservez les en-têtes du modèle. Renseignez `Product Handle` et `Product Title` pour les produits, ainsi que les valeurs d'options affichées pour les variantes. Ajoutez `Variant SKU` si votre catalogue utilise des SKU.
4. Examinez les poignées de produit, les titres, les prix, les variantes et toutes les lignes répétées avant d'exporter en CSV.
5. Retournez à la boîte de dialogue et choisissez ou glissez-déposez le CSV dans la zone de téléchargement.
6. Attendez que le fichier affiche **Prêt à importer**.
7. Sélectionnez **Démarrer l'importation** une seule fois.
8. Dans **Historique**, suivez le fichier soumis jusqu'à ce qu'il atteigne un état terminal, puis actualisez la liste Produits et inspectez les lignes résultantes.
Pour découvrir le flux de travail sans modifier le catalogue, téléchargez **Modèle**, examinez ses en-têtes, puis ouvrez **Historique**. Revenez avec **Retour à l'import** et fermez la boîte de dialogue. La sélection d'un fichier le prépare ; seul **Démarrer l'importation** soumet une modification de catalogue.
L'enregistrement inspecte les exigences d'importation et l'historique vide, puis revient aux versions préliminaires des produits. Aucun CSV n'est soumis ou importé.
## Comprendre les états de l'Historique
| État | Signification | Que faire |
| --- | --- | --- |
| **En attente** | La tâche attend de démarrer | Laissez-la en place et vérifiez à nouveau plus tard ; ne soumettez pas immédiatement un doublon. |
| **Traitement en cours** | Runner traite le fichier | Gardez la boîte de dialogue ouverte ou retournez à l'Historique plus tard. |
| **Terminée** | Runner a fini de remettre le fichier à l'importateur de catalogue | Le traitement des produits peut continuer après cet état. Actualisez Produits et inspectez les noms, les variantes, les prix, le statut et l'inventaire. |
| **Échec** | Runner n'a pas pu terminer la tâche d'importation | La carte Historique actuelle enregistre l'état d'échec mais pas une cause détaillée. Vérifiez les conditions préalables et le CSV source avant de soumettre un nouveau fichier. |
| **Annulé** | La tâche n'a pas continué | Confirmez si des produits ont été créés avant de décider ce qu'il faut soumettre ensuite. |
L'Historique peut également afficher la taille du fichier, le nombre total de lignes et un ID de transaction lorsque Runner a ces valeurs. Ces détails identifient la tâche ; ils ne remplacent pas la vérification des enregistrements de produit.
## Limites et dépannage
- **Démarrer l'importation est désactivé :** Sélectionnez un fichier `.csv` et attendez que Runner finisse de lire le contenu non vide.
- **Type de fichier invalide :** Exportez la feuille de calcul en CSV ; renommer un autre format de fichier ne le convertit pas.
- **Erreur de lecture de fichier :** Réexportez le CSV, confirmez qu'il s'ouvre normalement sur votre appareil et choisissez-le à nouveau.
- **Échec de l'importation :** Vérifiez que la préparation à la publication a créé le canal de catalogue de la vitrine en ligne. Utilisez ensuite le modèle fourni, restaurez les colonnes obligatoires et vérifiez les valeurs d'options des variantes ainsi que les éventuelles valeurs `Variant SKU`.
- **La tâche semble bloquée :** Ouvrez l'Historique et sélectionnez **Actualiser**. En attente et Traitement ne sont pas la preuve de l'achèvement.
- **Des lignes de produit inattendues apparaissent :** Ne répétez pas aveuglément la même importation. Comparez les poignées CSV avec la liste Produits et corrigez les enregistrements délibérément.
## Guides connexes
- [Produits](./products)
- [Inventaire et variantes](./inventory-and-variants)
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
- [Aperçu des opérations de la boutique](/fr/guides/store-operations)
---
# Inventaire et variantes
Source: https://www.runnerai.com/docs/fr/guides/store-operations/inventory-and-variants
Utilisez les variantes et l'inventaire pour représenter les choix que les clients peuvent acheter et la quantité que le magasin peut vendre.
## Pourquoi et quand utiliser les variantes et l'inventaire
Ajoutez des variantes lorsqu'un produit a des choix de clients tels que la taille ou la couleur. Entrez l'inventaire lorsque Runner doit suivre le nombre d'unités disponibles à l'emplacement de stock du magasin.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Enregistrez un emplacement de stock dans **Opérations de la boutique → Général** avant de saisir l'inventaire suivi.
- Enregistrez le marché et la devise appropriés avant de définir les prix.
- Ouvrez un produit manuel. Les produits de réservation et de dropshipping peuvent utiliser des règles de disponibilité différentes et afficher un tiret dans la liste au lieu des totaux d'inventaire normaux.
- Planifiez les noms et valeurs des options avant de modifier un produit en direct car les modifier peut modifier l'ensemble des variantes achetables.
## Ouvrir les variantes et l'inventaire
**Chemin d'entrée :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Produits → Ajouter**, ou sélectionnez une ligne de produits existante, puis recherchez **Variation** et les champs de prix et de stock en ligne.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggCsEjzIC4NbwvYeKD2nM5xTZ76dBjp0auiyP)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Inspectez chaque variation de prix et la valeur du stock avant de sauvegarder. Aucune mise à jour d'inventaire ou de prix n'a été enregistrée pour cette capture d'écran.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| Contrôle d'option supplémentaire dans **Variation** | Ajouter le premier choix du client | Crée des champs pour un nom d'option et ses valeurs. |
| Contrôle de la valeur ajoutée | Ajouter un autre choix dans une option | Ajoute une autre valeur qui peut être combinée en variantes. |
| Une autre option | Ajoutez une deuxième dimension telle que la couleur | Crée un autre groupe d'options et développe les combinaisons de variantes. |
| **Supprimer** | Supprimez une option ou une valeur | Supprime ce choix du formulaire et peut modifier les combinaisons générées. |
| **Grouper par** | Organisez une longue liste de variantes | Sur le bureau, change la façon dont les variantes actuelles sont groupées pour l'édition. |
| Prix de la variante | Définissez le prix de vente pour un choix | Associe le montant saisi et la devise à cette variante. |
| **Définir le prix promotionnel** | Ajoutez un prix promotionnel inférieur | Ouvre les champs de prix de vente et d'horaire optionnel pour l'article ou la variante sélectionnée. |
| Quantité **Disponible** | Définissez le stock suivi pour une variante | Met à jour la quantité d'inventaire non enregistrée affichée pour cette variante et cet emplacement de stock. |
| **Enregistrer** | Appliquez la configuration complète du produit | Enregistre les modifications valides d'option, de variante, de prix et d'inventaire ensemble. |
## Créer des variantes de produit
1. Ouvrez Ajouter un produit ou le produit existant prévu.
2. Dans **Variation**, sélectionnez l'option Ajouter un contrôle.
3. Entrez un nom d'option convivial, puis ajoutez chaque valeur d'option valide.
4. Ajoutez une autre option uniquement lorsque le produit dispose d'un deuxième choix indépendant.
5. Examinez chaque variante générée. Supprimez les valeurs accidentelles avant d'entrer les prix ou le stock.
6. Définissez le prix correct et la quantité disponible pour chaque variante.
7. Sélectionnez **Enregistrer**, puis rouvrez la ligne et confirmez le nombre de variantes.
### Exemple : deux tailles de bougies
Utilisez une option nommée `Size` avec les valeurs `Small` et `Large`. Attendez-vous à deux variantes. Définissez le prix de chaque variante et le stock disponible, puis **Enregistrer** et rouvrez le produit.
| Options que vous entrez | Variantes à vérifier |
| --- | --- |
| Taille : Petit, Grand | Petit; Grand — 2 variantes |
| Taille : Petit, Grand plus Parfum : Cèdre, Agrumes | Petit/Cèdre ; Petit/Agrumes ; Grand/Cèdre ; Large/Agrumes — 4 variantes |
N'ajoutez la deuxième option que si vous vendez les quatre combinaisons. Confirmez le stock par variante plutôt que de copier le total dans chaque ligne.
## Entrer l'inventaire
1. Confirmez que le produit est un article stocké manuellement et qu'un emplacement de stock est enregistré.
2. Ouvrez le produit et trouvez **Stock**.
3. Entrez la quantité disponible pour chaque variante pertinente.
4. Examinez la valeur **Stock total à l'emplacement**.
5. Sélectionnez **Enregistrer**.
6. Retournez à Produits et confirmez que la colonne Inventaire reflète le total enregistré.
## États et limites
- Sans emplacement de stock enregistré, Runner affiche **Stock non enregistré** et empêche le produit de prétendre que le stock a été stocké.
- Les valeurs d'option créent des combinaisons. L'ajout de nombreuses valeurs sur plusieurs options peut produire une longue liste de variantes qui doit être vérifiée individuellement.
- Un prix de vente doit être inférieur au prix régulier. Les produits fournisseurs peuvent appliquer un prix de détail minimum supplémentaire.
- Une devise de produit en dehors des régions enregistrées du magasin produit un avertissement de non-concordance et empêche les prix de s'afficher correctement sur la vitrine.
- La suppression d'une option ou d'une valeur modifie les choix du client. Inspectez les variantes résultantes avant d'enregistrer.
- Les produits de réservation et de fournisseur peuvent gérer la disponibilité en dehors des champs Stock normaux.
## Dépannage
- **Inventaire non enregistré :** Ajoutez et enregistrez un emplacement de stock dans Général, puis réentrez la quantité du produit.
- **Le nombre de variantes est inattendu :** Vérifiez les valeurs en double ou vides et examinez chaque combinaison d'options.
- **Un prix de vente est rejeté :** Entrez une valeur inférieure au prix régulier et dans tout minimum du fournisseur.
- **Les prix n'apparaissent pas aux clients :** Alignez la devise du produit avec un marché enregistré, puis vérifiez la visibilité du produit et du magasin.
- **L'inventaire affiche un tiret dans Produits :** Vérifiez si l'article est un produit de réservation ou de dropshipping ; ces types n'utilisent pas le total d'inventaire standard dans cette liste.
## Guides connexes
- [Produits](./products)
- [Expédition](./shipping)
- [Importer des produits](./import-products)
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
---
# Intégration et paramètres généraux
Source: https://www.runnerai.com/docs/fr/guides/store-operations/onboarding-and-general-settings
Complétez l'assistant de configuration guidée quand il apparaît, puis utilisez Paramètres généraux pour maintenir à jour les détails opérationnels essentiels du magasin.
## Pourquoi et quand utiliser cette page
Utilisez les cartes de configuration la première fois que Runner demande les détails du magasin, un premier produit et l'expédition. Revenez à Général chaque fois que les détails de votre magasin public, les régions de vente, la devise, l'emplacement des stocks, la configuration de l'expédition ou l'examen des changements de disponibilité.
## Disponibilité et conditions préalables
- Ouvrez un projet Runner avec un service de boutique.
- Si le service de boutique est encore en cours de préparation, Runner affiche **Veuillez patienter, l'administrateur de la boutique est en cours de déploiement...**.
- L'assistant de configuration n'apparaît que pour les magasins qui ne l'ont pas complété et peut différer selon le déploiement des mises à jour d'intégration par Runner.
- La connexion au paiement est une tâche distincte dans **Apps**. La fin de la configuration ne permet pas le paiement ni la publication de la vitrine.
## Ouvrir Paramètres généraux
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Général**
Si Runner ouvre d'abord les cartes de configuration, complétez les détails requis du magasin et résolvez les autres jalons. Après la configuration, la page Général devient la destination normale.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Ce détail montre des exemples de champs ou des champs par défaut. Il ne confirme pas une configuration de marché, d'emplacement de stock ou d'expédition enregistrée.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe quand il est sélectionné |
| --- | --- | --- |
| **Configurer** | Ouvrir le jalon des détails du magasin | Ouvre le formulaire requis de détails du magasin. |
| **Ajouter un produit** | Commencer l'étape du premier produit | Ouvre le flux de configuration du produit. |
| **Ignorer la configuration des produits** / **Ignorer la configuration de livraison** | Différer un jalon facultatif | Résout cette carte de configuration sans configurer la fonctionnalité ignorée. |
| **Configurer la livraison** | Configurer le jalon d'expédition | Ouvre la configuration de l'expédition. |
| **Ouvrir Opérations de la boutique** | Quitter l'écran de configuration terminé | Ouvre l'administration normale du magasin une fois que tous les jalons sont résolus. |
| **Visible pour les clients** / **Masquer la boutique : les visiteurs voient « Bientôt disponible ».** | Modifier la visibilité plus tard dans Paramètres généraux | L'**Enregistrer** au niveau de la page stocke l'état visible ou masqué sélectionné. |
| **Ajouter** dans Marchés ou Emplacements de stock | Ajouter une autre ligne modifiable | Crée une ligne de région ou d'emplacement non enregistrée pour que vous la complétiez. |
| Commutateur **Avis produits** | Autoriser la fonctionnalité d'avis quand elle est prise en charge | Enregistre ce paramètre immédiatement. Si la demande échoue, le commutateur revient à sa valeur antérieure ; l'**Enregistrer** au niveau de la page n'est pas utilisé pour ce commutateur. |
| **Enregistrer** | Appliquer les modifications dans Paramètres généraux | Devient disponible après les modifications au niveau de la page, les valide quand il est sélectionné, et persiste les modifications valides de visibilité, identité, marché, emplacement et expédition. |
| **Configurer** dans une alerte de configuration | Résoudre un prérequis de paiement manquant | Se déplace vers la section Paramètres généraux pertinente, ou ouvre la vue des intégrations de paiement dans **Apps**. |
Commencez par les détails du magasin. **Enregistrer et continuer** soumet les champs obligatoires ; **Annuler** laisse le jalon inachevé.
## Terminez les trois étapes de configuration
1. Ouvrez **Opérations de la boutique**. Un nouveau magasin affiche **Configurer les informations de la boutique**, **Ajoutez votre premier produit** et **Configuration de base de la livraison** au lieu du menu d'administration normal.
2. Dans **Configurer les informations de la boutique**, sélectionnez **Configurer**. Remplissez les champs de nom du magasin, de contact et d'adresse demandés par **Complétez les informations de votre boutique**, puis sélectionnez **Enregistrer et continuer**. Cette étape obligatoire ne peut être ignorée.
3. Dans **Ajoutez votre premier produit**, sélectionnez **Ajouter un produit** et complétez le flux de produit. Choisissez **Ignorer la configuration des produits** uniquement si vous avez l'intention d'ajouter le catalogue ultérieurement.
4. Dans **Configuration de base de la livraison**, sélectionnez **Configurer la livraison** et complétez les champs demandés. Choisissez **Ignorer la configuration de livraison** uniquement si vous configurez la livraison ultérieurement.
5. Attendez **Configuration de la boutique terminée**, puis sélectionnez **Ouvrir Opérations de la boutique**.
6. Confirmez que le menu d'administration normal est disponible. Si vous avez sauté des produits ou l'expédition, suivez le guide correspondant avant de vous attendre à un magasin vendable.
Un lien direct vers des produits ne contourne pas une configuration incomplète. Si un magasin plus ancien affiche un assistant différent, suivez ses champs obligatoires visibles et les actions facultatives Ignorer ; ne cherchez pas de paiement ou de Go Live dans le flux à trois cartes ci-dessus.
L'enregistrement ouvre le formulaire de détails du magasin, puis le ferme et revient aux fiches de configuration. Il affiche la saisie et les champs obligatoires, la configuration non terminée, la publication ou une connexion de paiement.
## Mettez à jour les paramètres généraux plus tard
1. Ouvrez **Opérations de la boutique → Général**.
2. Choisissez la visibilité du magasin souhaitée.
3. Vérifiez le nom du magasin, l'adresse e-mail de contact et l'adresse commerciale.
4. Vérifiez les Marchés, y compris les pays de vente, la devise et le paramètre fiscal.
5. Vérifiez les Emplacements de stock avant de configurer l'expédition ou l'inventaire.
6. Vérifiez l'Expédition, puis sélectionnez **Enregistrer** et attendez l'état enregistré pour ces paramètres de page.
7. Fermez et rouvrez Général pour confirmer les détails du marché, de l'emplacement du stock et du magasin enregistrés.
8. Modifiez le commutateur conditionnel **Avis produits** séparément si nécessaire et attendez la fin de sa mise à jour immédiate.
## États et limites
- Le nom du magasin est obligatoire et le formulaire de configuration le limite à 30 caractères.
- L'adresse e-mail de contact doit être valide.
- La devise du marché affecte l'affichage des prix des produits. Un produit avec une devise en dehors des régions enregistrées affiche un avertissement et peut ne pas afficher les prix sur la vitrine.
- **Visible pour les clients** contrôle la visibilité du magasin. La publication du code de vitrine et la connexion d'un domaine sont des tâches distinctes.
- L'activation des avis n'ajoute pas de composants d'avis manquants à une vitrine plus ancienne. Runner peut afficher des conseils pour demander à l'agent d'ajouter la capacité et de publier ces modifications de vitrine.
- L'**Enregistrer** au niveau de la page couvre la visibilité, les détails du magasin, les Marchés, les Emplacements de stock et l'Expédition. Le commutateur **Avis produits** s'enregistre séparément et immédiatement.
## Dépannage
- **L'enregistrement est désactivé :** Effectuez une modification au niveau de la page ; modifier uniquement **Avis produits** n'utilise pas ce bouton.
- **L'enregistrement signale une erreur :** Complétez les champs nommés par le message de validation, puis réessayez.
- **Une alerte de configuration persiste :** Complétez son prérequis nommé, enregistrez-le, puis actualisez. Le stock, l'expédition et le paiement sont vérifiés séparément.
- **Le paiement est toujours manquant après la connexion :** Revenez de l'onglet du fournisseur, attendez que Runner affiche l'intégration comme activée, et actualisez si nécessaire.
- **Les avis n'apparaissent pas dans le menu :** Le commutateur, la prise en charge par le service de boutique ou la capacité de la vitrine peut ne pas être prête. Consultez le guide d'avis conditionnel avant d'essayer une URL directe.
- **La page avertit des modifications non enregistrées :** Restez et enregistrez, ou choisissez explicitement de quitter sans enregistrer. La navigation du navigateur seule n'applique pas les modifications.
## Guides connexes
- [Expédition](./shipping)
- [Produits](./products)
- [Avis](./reviews-and-advanced-admin)
- [Aperçu des opérations du magasin](/fr/guides/store-operations)
---
# Commandes
Source: https://www.runnerai.com/docs/fr/guides/store-operations/orders
Utilisez Commandes pour suivre chaque achat du placement au paiement, exécution, expédition, livraison, remboursement ou annulation.
## Pourquoi et quand utiliser Commandes
Ouvrez une commande quand vous devez confirmer ce que le client a acheté, vérifier les adresses et les totaux, comprendre la progression du paiement ou de l'exécution, ou effectuer une action suivante disponible. Les contrôles visibles dépendent de la commande, des services connectés et des actions antérieures.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Les commandes apparaissent après que les clients les placent. **Pas encore de commandes** est normal pour un nouveau magasin.
- Les contrôles de paiement nécessitent un état de paiement compatible et un fournisseur connecté.
- Les contrôles d'exécution nécessitent des articles exécutables et peuvent dépendre des services d'expédition ou de fournisseur.
- Les sections de réservation n'apparaissent que sur les commandes qui incluent des articles de réservation pris en charge.
- L'état du dropshipping, l'actualisation et le suivi n'apparaissent que quand la commande a des enregistrements d'exécution de fournisseur liés.
## Ouvrir Commandes
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Commandes**
Sélectionnez une ligne de commande pour ouvrir son enregistrement complet.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw69RBMGkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Aucune commande pour l’instant n’est un état de départ normal. Les actions conditionnelles ci-dessous nécessitent une commande réelle ; cet exemple ne montre pas de remboursement ou d'exécution.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe quand il est sélectionné |
| --- | --- | --- |
| **Rechercher des commandes...** | Trouver une commande spécifique | Filtre la liste en utilisant les informations de commande ou de client entrées. |
| **Actualiser** sur la liste des commandes | Demander les données de commande actuelles | Recharge la liste et les données d'état de réservation ou de dropshipping disponibles. |
| Ligne de commande | Inspecter un achat | Ouvre le Résumé, le client, l'adresse, l'article, le paiement, l'exécution, l'activité et les sections conditionnelles. |
| **Copier l'adresse** | Réutiliser une adresse affichée avec précision | Copie cette adresse dans le presse-papiers. |
| **Capturer le paiement** | Capturer un paiement autorisé | Ouvre une confirmation ; confirmer demande au service connecté de le capturer. |
| **Remboursement** (dialogue : **Rembourser**) | Retourner un montant admissible | Ouvre les champs de montant de remboursement et de note optionnelle ; le succès met à jour l'état du paiement. |
| **Marquer comme exécuté** | Exécuter tous les articles actuellement non exécutés | Soumet l'exécution immédiatement et met à jour la commande après le succès. |
| **Marquer comme expédié** | Enregistrer la progression de l'expédition | Demande les informations du transporteur et de suivi optionnelles, puis met à jour l'exécution après le succès. |
| **Marquer comme livré** | Enregistrer l'achèvement de la livraison | Confirme l'exécution admissible comme livrée après le succès. |
| **Annuler le fulfillment** | Arrêter une exécution admissible | Ouvre une confirmation et met à jour cette exécution si la demande réussit. |
| **Annuler la commande** | Annuler définitivement une commande admissible | Sur le bureau, ouvre une confirmation irréversible ; toutes les exécutions doivent d'abord être annulées. |
| **Actualiser le statut** | Vérifier une commande de dropshipping liée | Demande le dernier état du fournisseur pour cet enregistrement. |
| **Suivre la commande** | Ouvrir le suivi du fournisseur disponible | Ouvre le suivi uniquement quand une destination de suivi utilisable est présente. |
| Actions de réservation | Mettre à jour une réservation confirmée prise en charge | **Marquer comme terminée** ou **Marquer comme absent** n'apparaît que pour un état de réservation admissible. |
## Examinez une commande en toute sécurité
1. Recherchez la commande ou sélectionnez-la dans la liste.
2. Confirmez l'ID d'affichage, la date, le client, les articles, les totaux, l'adresse d'expédition et l'adresse de facturation.
3. Lisez Paiement et Exécution comme des états distincts ; l'un peut progresser sans l'autre.
4. Vérifiez l'Activité pour les modifications antérieures.
5. Si une section de réservation ou de dropshipping est présente, vérifiez son état et ses détails distincts.
6. Quand une autre personne ou un service externe peut avoir modifié la commande, revenez à la liste, sélectionnez **Actualiser**, et rouvrez l'enregistrement avant d'agir.
Pour un nouveau magasin avec **Pas encore de commandes**, effacez la recherche et sélectionnez **Actualiser** pour confirmer la liste vide. Vous pouvez apprendre la navigation dans la liste sans créer d'achat. Les actions ci-dessous sont conditionnelles à une commande existante et à ses états de paiement et d'exécution.
## Effectuez une action qui change l'état
1. Choisissez uniquement une action affichée pour l'état actuel. **Marquer comme exécuté** s'applique immédiatement à tous les articles non exécutés ; les autres actions peuvent ouvrir une confirmation ou des champs obligatoires.
2. Quand une boîte de dialogue apparaît, vérifiez la commande, les quantités d'articles, le montant, le transporteur ou les informations de suivi qu'elle affiche.
3. Soumettez ou confirmez une fois.
4. Attendez le message de succès et l'état mis à jour.
5. Actualisez avant de réessayer. Un délai d'attente ou un indicateur de chargement ne prouve pas que la première demande a échoué.
## Comprenez les états courants
| Zone | États d'exemple | Comment les lire |
| --- | --- | --- |
| Paiement | En attente de paiement, Autorisé, Payé, Partiellement payé, Remboursé, Partiellement remboursé, Annulé, Nécessite une action | Décrit le mouvement d'argent, pas la progression de l'expédition. |
| Exécution | Non exécuté, Partiellement exécuté, Exécuté, Expédié, Partiellement expédié, Livré, Partiellement livré, Annulé | Décrit la préparation et la livraison, pas si le paiement a été réglé. |
| Réservation | Confirmé, Complété, Absent, Annulé | N'apparaît que pour les articles de réservation pris en charge. |
| Dropshipping | Création en attente, Créé, En traitement, Expédié, Livré, Échoué, Annulé, ou autres états du fournisseur | Provient d'un enregistrement de fournisseur lié et peut se mettre à jour séparément de la commande du magasin. |
## Limites et dépannage
- **Une action est manquante :** L'état de la commande, le type d'article, le fournisseur ou votre accès ne le permet pas actuellement. N'utilisez pas une URL directe pour contourner le contrôle manquant.
- **Annuler la commande n'est pas disponible :** Ce contrôle est réservé au bureau et nécessite que chaque exécution soit d'abord annulée.
- **Un remboursement d'article n'est pas disponible :** Utilisez uniquement la méthode de remboursement que Runner expose pour la commande actuelle ; ne supposez pas que chaque article supporte le remboursement direct.
- **L'état n'a pas changé :** Attendez la confirmation, revenez à la liste des commandes, sélectionnez **Actualiser**, rouvrez l'enregistrement et vérifiez l'Activité avant de réessayer.
- **Le dropshipping dit Échoué ou n'a pas de commande :** Vérifiez les détails du fournisseur lié et la connexion avant de modifier la commande du magasin.
- **Commande non trouvée :** Effacez la recherche, vérifiez le projet et vérifiez l'identifiant de la commande.
## Guides connexes
- [Clients](./customers)
- [Expédition](./shipping)
- [Dropshipping](./dropshipping)
- [Aperçu des opérations du magasin](/fr/guides/store-operations)
---
# Impression à la demande avec Printful
Source: https://www.runnerai.com/docs/fr/guides/store-operations/print-on-demand
Utilisez Impression à la demande pour vendre des produits personnalisés, comme des t-shirts, des sweats à capuche, des mugs et des affiches, sans gérer de stock. Vous créez votre design sur un produit vierge Printful dans Runner, vous le publiez dans votre boutique, puis Printful imprime et expédie chaque commande une fois que vous l'avez confirmée dans Printful.
## Fonctionnement
1. **Connecter Printful.** Autorisez une seule fois votre propre compte Printful pour votre organisation.
2. **Choisissez un produit vierge et créez votre design.** Choisissez un produit, des couleurs, des tailles et une technique d'impression, puis ajoutez un visuel.
3. **Vérifiez et publiez.** Choisissez les maquettes, rédigez la fiche produit, définissez les prix, les marchés et la livraison, puis publiez.
4. **Traitez les commandes.** Chaque commande payée crée un brouillon de commande dans Printful. Vous confirmez ce brouillon dans Printful pour lancer la production.
Si vous devez plus tard cesser d'utiliser Printful, consultez [Déconnecter Printful](#déconnecter-printful).
## Avant de commencer
**Chemin d'entrée :** **Espace de travail → choisissez un magasin → Impression à la demande**
**Impression à la demande** apparaît dans le groupe **Créer** de la navigation du projet, à côté de **Opérations de la boutique** et **Dropshipping**. Si vous ne la voyez pas, la fonctionnalité n'est pas encore activée pour votre compte. Contactez [le support Runner](/fr/guides/help-and-reference/support-and-community) pour demander l'accès.
Vous avez besoin :
- d'un projet Runner avec une boutique ;
- d'un compte [Printful](https://www.printful.com) avec la facturation configurée, car Printful débite votre compte Printful pour chaque commande que vous confirmez ;
- du rôle **Administrateur** ou **Propriétaire** dans l'organisation Runner pour connecter ou déconnecter Printful ;
- d'au moins un marché et une devise de boutique dans **Opérations de la boutique → Général** ; et
- d'un emplacement de stock et d'une configuration de livraison avant de publier. Consultez [Expédition](/fr/guides/store-operations/shipping).
## 1. Connecter Printful
Vous pouvez parcourir le catalogue avant de vous connecter. La page affiche **Mode aperçu** tant que Printful n'est pas connecté. Vous devez connecter Printful avant de pouvoir créer, enregistrer ou publier un design.
1. Ouvrez **Impression à la demande**.
2. Sélectionnez **Connecter Printful**. Vous pouvez aussi ouvrir un produit vierge et sélectionner **Connecter votre propre compte Printful**.
3. Connectez-vous à Printful si nécessaire, puis vérifiez les autorisations demandées par Runner.
4. Dans le sélecteur de boutique de Printful, choisissez la boutique que Runner doit utiliser. Le sélecteur propose par défaut **Create a new Printful store** ; modifiez-le si vous souhaitez utiliser une boutique existante.
5. Approuvez l'accès. Printful vous renvoie vers **Impression à la demande**, et la page affiche **Connecté**.
La connexion appartient à votre **organisation** Runner : toutes les boutiques de cette organisation utilisent donc la même boutique Printful. Une organisation peut avoir une seule connexion Printful, et une boutique Printful ne peut être connectée qu'à une seule organisation Runner.
Pour vérifier quelle boutique Printful est connectée, ouvrez le menu **Gérer la boutique** et choisissez **Gérer la connexion**. La boîte de dialogue affiche le nom de la boutique connectée et l'identifiant de la boutique Printful.
### Reconnecter Printful
Si Printful n'accepte plus l'autorisation de Runner, Runner affiche **Reconnectez Printful pour continuer à traiter les commandes**. Cela signifie généralement que la boutique a été supprimée dans Printful ou que l'app Runner en a été désinstallée. Sélectionnez **Reconnecter Printful** et choisissez **la même boutique Printful** dans le sélecteur de boutique de Printful. Runner refuse une reconnexion qui choisit une autre boutique tant que la connexion est encore active.
## 2. Choisir un produit vierge et commencer la création
### Choisir un produit vierge
1. Parcourez **Tous les produits vierges**, filtrez par **Types de produits**, ou recherchez par produit, marque, méthode d'impression ou SKU.
2. Ouvrez un produit pour voir ses images, ses couleurs et tailles disponibles, ses emplacements d'impression, ses techniques, son coût de base, la livraison estimée et le délai de livraison estimé pour vos marchés.
3. Choisissez une **Technique** : **Impression** ou **Broderie**, lorsque les deux sont proposées. Sous **Impression**, choisissez le **Type d’impression** que Printful propose pour ce produit, comme DTG, DTF, la sublimation ou l'impression intégrale.
4. Choisissez une ou plusieurs **couleurs** et **tailles**. Vous pouvez sélectionner jusqu'à **20 variantes** (combinaisons de couleur et de taille) pour un même produit.
5. Utilisez le curseur **Majoration** pour prévisualiser le prix de vente et le bénéfice. Le prix part du prix suggéré, une marge de 35 % au-dessus du seuil de rentabilité : le coût de base Printful plus la livraison estimée. Le bénéfice correspond au prix moins ces deux montants et s'affiche dès que l'estimation de livraison est disponible. Vous pourrez encore modifier les prix lors de la vérification.
6. Sélectionnez **Commencer la création**. L'éditeur s'ouvre avec les options choisies.
Si Runner modifie votre sélection, par exemple « La taille a changé pour correspondre à cette couleur. », c'est que Printful ne propose pas cette combinaison exacte. Vérifiez les options ajustées avant de continuer.
### Ajouter votre design
Chaque emplacement d'impression, comme l'avant, le dos ou la manche, a son propre onglet dans l'éditeur. Ajoutez un visuel à chaque emplacement que vous voulez imprimer.
| Source du design | Ce qu'elle fait |
| --- | --- |
| **Importer un fichier** | Importez des fichiers JPEG, PNG, WebP ou SVG jusqu'à 18 MB. Les fichiers SVG sont convertis en PNG. 300 DPI sont recommandés. |
| **Depuis la médiathèque** | Réutilisez des images que vous avez déjà créées ou importées dans Runner. |
| **Créer avec Runner AI** | Décrivez votre idée. **Créer une image** crée un nouveau visuel ; **Modifier le visuel actuel** modifie le visuel déjà présent sur le produit. |
| **Inspirations → Texte** | Choisissez un style de lettrage, comme Universitaire grasse, Serif classique ou Script léger. Runner AI transforme vos mots en visuel texte prêt à imprimer. |
| **Inspirations → Étiquettes et badges** | Choisissez une forme, comme Badge rond, Écusson ou Étiquette ticket. Runner AI crée le badge avec votre texte. |
| **Inspirations → Arts** | Placez directement sur votre produit une œuvre sélectionnée et libre d'utilisation (CC0) de l'Art Institute of Chicago. |
Sélectionnez un calque de visuel pour le modifier dans l'inspecteur :
- déplacez-le, redimensionnez-le, faites-le pivoter et modifiez son opacité ;
- **Recadrage** : recadrez le visuel sans modifier l'image d'origine ;
- **Supprimer l’arrière-plan** pour que seul votre design soit imprimé ;
- **Répéter le motif** selon une disposition en bloc, en brique ou en demi-brique, avec un espacement et un décalage réglables ;
- **Dupliquer**, **Verrouiller** et réorganiser les calques ; et
- **Annuler** et **Rétablir** les modifications.
### Vérifier la qualité d'impression
Avant d'enregistrer, vérifiez les indicateurs de qualité de chaque calque :
- **Qualité d’impression** compare la résolution du visuel à sa taille actuelle avec le nombre de DPI exigé par Printful. Si l'indicateur signale que le visuel sera flou à l'impression, réduisez-le ou importez un fichier plus net.
- Les avertissements de **zone d'impression** et de **zone de sécurité** signifient qu'une partie du visuel risque d'être coupée ou rognée. Déplacez-le ou redimensionnez-le jusqu'à ce qu'il se trouve à l'intérieur des deux zones.
### Enregistrer votre design
L'éditeur n'enregistre pas automatiquement. Sélectionnez **Enregistrer le design** lorsque vous avez terminé. Le statut affiche **Modifications non enregistrées** jusqu'à l'enregistrement. Si vous quittez l'éditeur avec des modifications non enregistrées, Runner vous demande s'il faut les enregistrer ou les abandonner.
Les designs enregistrés apparaissent sous **Designs enregistrés** sur la page Impression à la demande. Ouvrez-en un pour continuer à le modifier ou pour le transformer en produit. Supprimer un design enregistré ne supprime pas les images de votre médiathèque.
## 3. Vérifier et publier le produit
Lorsque votre design est prêt, sélectionnez **Publier** dans l'éditeur. Runner enregistre le design et ouvre **Publier le produit**.
### Configurer le produit
| Section | Que faire |
| --- | --- |
| **Maquettes du produit** | Sélectionnez **Générer des maquettes** pour créer des photos de votre design sur le produit. Sélectionnez au moins une maquette et jusqu'à huit. Faites-les glisser pour les réorganiser ; la première image est l'image de votre fiche produit. |
| **Détails** | Vérifiez le **Titre du produit** et la **Description du produit** rédigés par Runner. Utilisez **Imaginer avec l’IA** pour obtenir une nouvelle description, puis relisez chaque mot. |
| **Marchés** | Sélectionnez **Choisir les marchés** pour choisir les pays et devises dans lesquels vous vendez ce produit. Seuls les marchés vers lesquels Printful peut livrer sont listés. Choisissez au moins un marché. |
| **Tarification** | Chaque variante part du prix suggéré, une marge de 35 % au-dessus de son seuil de rentabilité : le coût de base Printful plus la livraison que vous payez. Utilisez **Majoration** pour définir une autre majoration sur le seuil de rentabilité, ou saisissez un prix pour chaque variante. Les revenus correspondent au prix moins le coût de base Printful et la livraison que vous payez ; un prix sous le seuil de rentabilité s'affiche comme une perte. Pour chaque marché, le tableau affiche le prix de vente, la livraison, les taxes et les revenus estimés de la variante qui rapporte le moins. |
| **Frais de livraison facturés au client** | Choisissez **Utiliser les tarifs de livraison de la boutique** pour que les acheteurs paient les tarifs de livraison de votre boutique, ou **Facturer les tarifs de livraison de Printful** pour que les acheteurs paient, au moment du paiement, le tarif indiqué par Printful pour leur adresse. |
L'estimation de livraison affichée sur cette page sert de référence pour la tarification : le tarif standard le moins cher de Printful, hors livraison express ou prioritaire. Le coût de livraison réel de Printful dépend de l'adresse de livraison de chaque client. Avec **Utiliser les tarifs de livraison de la boutique**, les acheteurs paient les tarifs de votre boutique et Printful vous facture la livraison : l'estimation entre donc dans le seuil de rentabilité, le prix suggéré et vos revenus. Avec **Facturer les tarifs de livraison de Printful**, les acheteurs paient le tarif Printful au moment du paiement : seul le coût de base Printful compte alors.
Ce produit est traité par Printful : la politique de retour de Printful s'applique donc. Consultez-la via le lien de la page de vérification.
### Créer le brouillon
1. Sélectionnez **Créer le produit**.
2. Patientez pendant que Runner prépare les fichiers de production et crée le produit. Vous pouvez vérifier le statut à tout moment.
3. Lorsque vous voyez **Votre produit est maintenant un brouillon dans votre boutique. Publiez-le quand vous voulez commencer à vendre.**, sélectionnez **Voir le produit**.
Le produit est désormais un **Brouillon** dans **Produits**. Les acheteurs ne peuvent pas encore le voir. Vous pouvez modifier son URL et sa fiche pour les moteurs de recherche dans Produits.
### Publier
1. Ouvrez le brouillon du produit dans **Produits**.
2. Vérifiez **Livraison au paiement** et assurez-vous qu'un mode de livraison est sélectionné.
3. Sélectionnez **Publier le produit**.
4. Attendez **Synchronisé avec Printful.** Le produit est maintenant en ligne dans votre boutique et synchronisé avec votre boutique Printful.
Pour publier, la boutique a besoin d'une connexion Printful active, d'un emplacement de stock, d'une option de livraison et d'un mode de livraison pour le produit. Si l'un de ces éléments manque, Runner indique ce qu'il faut corriger avant de réessayer.
Une fois qu'un design est devenu un produit, il est verrouillé sur ce produit. Si vous le modifiez à nouveau, Runner en crée une copie, et l'enregistrement de cette copie ne modifie pas le produit existant.
## 4. Traiter les commandes
Runner n'envoie **pas** automatiquement les commandes en production. Chaque commande payée crée un **brouillon de commande** dans votre boutique Printful, et vous le confirmez dans Printful pour lancer la production.
1. Un acheteur paie une commande qui contient un produit imprimé à la demande.
2. Runner crée un brouillon de commande correspondant dans votre boutique Printful. Cette étape est automatique pour les commandes dont le paiement a été capturé.
3. Ouvrez **Opérations de la boutique → Commandes** et sélectionnez la commande. La section **Traitement Printful** affiche le statut du brouillon et le coût de production Printful dès que Printful l'a calculé.
4. Lorsque le statut est **Brouillon prêt**, sélectionnez **Passer la commande dans Printful**. Printful ouvre la commande dans un nouvel onglet.
5. Vérifiez la commande dans Printful et confirmez-la. Printful débite votre compte Printful et lance la production.
6. Revenez à la commande dans Runner et sélectionnez **Actualiser le statut**. Runner met aussi le statut à jour automatiquement lorsque Printful envoie des mises à jour.
| Statut | Signification |
| --- | --- |
| **Préparation du brouillon** | Runner crée le brouillon dans Printful. |
| **Brouillon prêt** | Le brouillon est dans Printful et attend que vous le confirmiez là-bas. |
| **Envoyée** / **En production** | Vous avez confirmé la commande, et Printful la produit. |
| **Partiellement traitée** / **Traitée** | Printful a expédié une partie ou la totalité des articles. |
| **Action requise** | Printful a besoin d'une mise à jour avant de pouvoir continuer. Ouvrez la commande dans Printful. |
| **Action requise** | Runner n'a pas pu confirmer l'état du traitement. Actualisez le statut ou contactez le support. |
| **Annulé** / **Supprimé** | La commande Printful a été annulée, ou le brouillon a été supprimé. |
Gardez ces règles en tête :
- **Ne confirmez que les commandes que vous comptez traiter.** Une confirmation dans Printful lance une production irréversible et débite votre compte Printful.
- **Les remboursements et annulations ne modifient pas le brouillon Printful.** Si vous remboursez ou annulez une commande client, supprimez ou annulez vous-même le brouillon dans Printful, et ne le confirmez pas.
- **Supprimer un brouillon Printful n'annule pas et ne rembourse pas la commande client.** Traitez la commande client séparément dans Runner.
- Si Runner affiche **Réessayer le brouillon**, Printful n'a pas créé le brouillon et vous pouvez réessayer sans risque.
- Si Runner indique que Printful a créé la commande mais que Runner n'a pas pu la relire, **ne la renvoyez pas**. Runner la rapproche automatiquement : revenez vérifier plus tard.
## Déconnecter Printful
La déconnexion empêche immédiatement Runner d'utiliser votre boutique Printful. **Terminez ou clôturez toutes les commandes en cours avant de vous déconnecter.** Les commandes non terminées sont mises hors ligne dans Runner et ne sont pas relancées, même si vous connectez plus tard une autre boutique Printful.
### Avant de vous déconnecter
1. Dans **Opérations de la boutique → Commandes**, repérez chaque commande dont la section **Traitement Printful** n'est pas **Traitée**, **Annulé** ou **Supprimé**.
2. Pour chaque commande **Brouillon prêt**, confirmez-la dans Printful, ou annulez et remboursez la commande client dans Runner puis supprimez le brouillon Printful.
3. Attendez que les commandes confirmées affichent **Traitée**, ou continuez à les suivre directement dans Printful.
4. Dépubliez ou supprimez les produits imprimés à la demande que vous ne voulez plus montrer aux acheteurs.
### Déconnecter
1. Ouvrez **Impression à la demande**.
2. Ouvrez le menu **Gérer la boutique** et choisissez **Gérer la connexion**.
3. Sélectionnez **Déconnecter**.
4. Lisez les conséquences, puis sélectionnez **Déconnecter Printful**.
Après la déconnexion :
- vos produits imprimés à la demande et vos brouillons restent visibles dans **Produits**, mais les acheteurs ne peuvent ni les ajouter au panier ni passer commande ;
- ces produits affichent **Ce produit POD est indisponible** et ne peuvent plus être vendus ni modifiés via Printful ;
- les traitements Printful en cours sont mis hors ligne dans Runner ; et
- votre boutique Printful et ses commandes restent dans votre compte Printful.
**Une reconnexion ne restaure pas les produits.** Si vous connectez de nouveau Printful plus tard, les produits de la connexion précédente restent indisponibles. Créez de nouveaux produits à partir de vos designs enregistrés.
## Limites
| Élément | Limite |
| --- | --- |
| Variantes par produit | 1 à 20 combinaisons de couleur et de taille |
| Images de fiche par produit | Jusqu'à 8 maquettes |
| Marchés par produit | Jusqu'à 51 |
| Majoration | 0–500 % |
| Titre du produit | Jusqu'à 255 caractères |
| Taille des fichiers importés | 18 MB (JPEG, PNG, WebP ou SVG) |
| Connexions Printful | Une par organisation |
Votre forfait peut aussi limiter le nombre de produits que vous pouvez créer. Si vous atteignez cette limite, Runner affiche **Vous avez atteint la limite de produits d’impression à la demande de votre forfait. Passez à un forfait supérieur pour en ajouter davantage.**
## Dépannage
- **Impression à la demande n'apparaît pas dans la navigation :** la fonctionnalité n'est pas activée pour votre compte. Contactez le support.
- **Connecter Printful échoue ou vous n'êtes pas autorisé à vous connecter :** demandez à un Administrateur ou un Propriétaire de l'organisation de connecter Printful.
- **La livraison des événements Printful attend la configuration de Runner :** Runner doit terminer une configuration unique. Vous n'avez rien à modifier dans votre boutique.
- **Une maquette, un prix ou une estimation de livraison ne se charge pas :** réessayez depuis la même page. Votre design enregistré n'est pas affecté.
Pour les messages d'erreur exacts et les étapes de résolution, consultez :
- [Connexion et catalogue Printful](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog) (en anglais)
- [Conflits de design et visuels indisponibles Printful](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork) (en anglais)
- [Vérification des produits, maquettes et publication Printful](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication) (en anglais)
- [Erreurs de commandes et de traitement](/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment) (en anglais)
## Guides connexes
- [Opérations de la boutique](/fr/guides/store-operations)
- [Produits](/fr/guides/store-operations/products)
- [Commandes](/fr/guides/store-operations/orders)
- [Expédition](/fr/guides/store-operations/shipping)
- [Dropshipping](/fr/guides/store-operations/dropshipping)
---
# Produits
Source: https://www.runnerai.com/docs/fr/guides/store-operations/products
Utilisez Produits pour transformer un article en une liste de magasin complète avec des informations destinées aux clients, des prix, des médias et un état.
## Pourquoi et quand utiliser Produits
Créez un produit quand vous voulez vendre un article directement, puis revenez pour ajuster son nom, sa description, sa catégorie, ses images, ses prix, ses variantes, son inventaire, sa liste de recherche ou son état Brouillon/Publié.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Ouvrez un projet Runner dont le service de boutique est prêt.
- Enregistrez au moins un Marché pour que la devise du produit puisse correspondre à une région de vente.
- Enregistrez un Emplacement de stock avant de vous attendre à ce que les modifications d'inventaire soient stockées.
- **Importer** apparaît dans la liste de bureau remplie ; un nouveau catalogue vide commence par **Ajouter le premier produit**.
- Les produits de dropshipping peuvent afficher un comportement de coût et d'inventaire différent des produits gérés manuellement.
## Ouvrir Produits
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Produits**
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Les lignes brouillon affichent les enregistrements de catalogue disponibles pour la modification. Ils ne prouvent pas que les articles sont publiés ou achetables.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe quand il est sélectionné |
| --- | --- | --- |
| **Actualiser** | Recharger les données du catalogue actuel | Récupère les produits et les informations de marché ; cela ne crée ni ne publie rien. |
| **Ajouter** / **Ajouter le premier produit** | Créer un produit manuel | Ouvre un formulaire Ajouter un produit vierge. |
| **Importer** | Ajouter des produits à partir d'un CSV pris en charge | Ouvre la boîte de dialogue d'importation avec Modèle et Historique. |
| Ligne de produit | Examiner ou modifier un article | Ouvre Modifier le produit pour ce produit. |
| Icône de crayon | Modifier un produit sans sélectionner sa ligne | Ouvre le même formulaire Modifier le produit. |
| Icône de suppression | Supprimer un produit | Ouvre une confirmation destructrice ; confirmer supprime le produit et ne peut pas être supposé réversible. |
| **Brouillon** | Garder la liste hors du catalogue publié | Enregistre le produit avec l'état Brouillon. |
| **Publié** | Rendre la liste admissible à apparaître dans le catalogue | Enregistre l'état Publié ; la visibilité réelle de la vitrine dépend toujours de l'état du magasin et de la vitrine. |
| **Enregistrer** | Stocker les modifications de produit valides | Enregistre le produit et revient à la liste actualisée après le succès. |
| **Annuler** ou contrôle de retour | Quitter le formulaire | Revient vers la liste ; les modifications de formulaire non enregistrées ne sont pas appliquées. |
## Créez un produit
1. Sélectionnez **Ajouter** ou **Ajouter le premier produit**.
2. Choisissez une Catégorie de produit et entrez un Nom et une Description clairs.
3. Ajoutez des images et choisissez la miniature prévue.
4. Choisissez **Brouillon** pendant la préparation de la liste ou **Publié** quand elle est prête pour le catalogue.
5. Entrez le Prix régulier. Ajoutez un Prix de vente inférieur et des dates de début/fin valides uniquement quand vous voulez une vente programmée.
6. Configurez les [variantes et l'inventaire](./inventory-and-variants) si l'article a des options ou un stock suivi.
7. Vérifiez le titre de page SEO, la méta-description, le handle et l'URL du magasin affichée.
8. Sélectionnez **Enregistrer** et attendez que la liste Produits revienne avec la ligne mise à jour.
### Pratique avec un seul brouillon
Pour une liste manuelle des bougies, entrez un nom clair tel que `Cedar Candle`, ajoutez la description réelle du produit et gardez **Brouillon** sélectionné. Utilisez un prix dans la devise du marché enregistrée dans le magasin. Si Runner demande d'abord un type de produit, choisissez le chemin de produit manuel avant de saisir ces détails.
Après **Enregistrer**, rouvrez la ligne et comparez son nom, son prix et son statut de brouillon avec votre saisie. Cela vérifie la sauvegarde du catalogue ; la publication et une passage en caisse fonctionnel nécessitent des contrôles séparés.
## Modifiez ou supprimez un produit
1. Sélectionnez la ligne du produit ou son icône en forme de crayon. **Modifier le produit** affiche le type de produit existant en lecture seule.
2. Modifiez uniquement les champs qui doivent affecter la liste.
3. Sélectionnez **Enregistrer** et confirmez que la ligne reflète le nouvel état ou les nouvelles informations.
4. Pour supprimer le produit, revenez à la liste et sélectionnez son icône de suppression.
5. Lisez le nom du produit dans la confirmation. Continuez uniquement si la suppression permanente est prévue.
## États et limites
- Les badges **Brouillon** et **En direct** dans la liste résument l'état du produit. Le formulaire utilise **Brouillon** et **Publié**.
- Un avertissement d'inadéquation de devise signifie que la devise du produit est en dehors des régions enregistrées du magasin ; ses prix ne s'afficheront pas sur la vitrine jusqu'à correction.
- Le Prix de vente doit être inférieur au Prix régulier. Les articles du fournisseur peuvent également appliquer un prix de détail minimum.
- Les images acceptent uniquement les formats et la taille affichés par le formulaire. La compression ou le téléchargement échoué laisse l'image du produit inchangée.
- Les lignes de réservation et de dropshipping peuvent afficher un tiret au lieu des totaux d'inventaire ou de variante normaux.
- L'enregistrement de l'état Publié n'est pas la même chose que la publication ou le déploiement de la vitrine.
## Dépannage
- **L'inventaire n'est pas enregistré :** Ajoutez et enregistrez un Emplacement de stock, puis rouvrez le produit et entrez à nouveau le stock.
- **Le prix ne s'affiche pas :** Faites correspondre la devise du produit à une région de Marché enregistrée.
- **L'enregistrement reste désactivé ou échoue :** Effectuez une modification, puis complétez le Nom et l'état requis et corrigez toute erreur en ligne. Ajoutez une catégorie et un prix appropriés avant de vous attendre à une liste complète destinée aux clients, mais ce ne sont pas des conditions préalables pour activer **Enregistrer**.
- **Le téléchargement d'image échoue :** Utilisez JPEG, PNG, GIF ou WebP dans la taille affichée dans l'indice d'image, puis réessayez.
- **Le produit est manquant de la vitrine :** Vérifiez l'état Publié, la visibilité du magasin, la publication de la vitrine et le marché pertinent. Une ligne d'administrateur enregistrée seule ne prouve pas la visibilité du client.
## Guides connexes
- [Importer des produits](./import-products)
- [Inventaire et variantes](./inventory-and-variants)
- [Dropshipping](./dropshipping)
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
---
# Promotions
Source: https://www.runnerai.com/docs/fr/guides/store-operations/promotions
Utilisez Promotions pour définir une remise, son expérience client, ses règles d'admissibilité et si elle est active ou toujours un brouillon.
## Pourquoi et quand utiliser Promotions
Créez une promotion pour une campagne prévue, une incitation client, une offre d'expédition gratuite ou une offre d'achat et de réception. Commencez en Brouillon en vérifiant les détails ; utilisez Actif uniquement quand la remise doit être admissible au paiement.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Ouvrez un projet Runner dont le service de boutique est prêt.
- Créez les produits référencés par une règle Acheter X Obtenir Y avant de construire cette promotion.
- Confirmez la devise du marché pertinent et la configuration d'expédition avant d'offrir des remises basées sur le montant ou l'expédition gratuite.
- Testez le comportement du paiement avec une commande de test appropriée avant de partager un code publiquement.
## Ouvrir Promotions
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Promotions**
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe quand il est sélectionné |
| --- | --- | --- |
| **Créer** / **Ajouter la première promotion** | Choisir un nouveau type de remise | Ouvre un menu pour Montant de la commande, Pourcentage de la commande, Acheter X Obtenir Y ou Expédition gratuite. La liste vide utilise **Ajouter la première promotion**. |
| **Remise fixe sur la commande** | Réduire le total de la commande d'un montant fixe | Ouvre un formulaire avec montant, méthode, état et paramètres d'admissibilité. |
| **Remise en pourcentage sur la commande** | Réduire le total de la commande d'un pourcentage | Ouvre un formulaire avec une valeur de pourcentage et les paramètres partagés. |
| **Achetez X, obtenez Y** | Donner les produits sélectionnés après un achat admissible | Ouvre les sélecteurs de quantité et de produit pour ce que le client achète et obtient. |
| **Livraison gratuite** | Supprimer les frais d'expédition admissibles | Ouvre une promotion dont la remise s'applique à l'expédition. |
| **Remise automatique** | Appliquer la promotion sans demander au client un code | Le paiement évalue les règles automatiquement, mais le formulaire nécessite toujours une valeur de code pour identifier la promotion. |
| **Code promotionnel** | Exiger un code entré par le client | Les clients doivent entrer le code requis au paiement. |
| **Active** / **Brouillon** | Contrôler si la promotion est utilisable | Enregistre l'état opérationnel choisi avec la promotion. |
| **Ajouter une condition** | Limiter qui peut utiliser la promotion | Ajoute des champs d'attribut client, d'opérateur et de valeur. |
| **Enregistrer** | Appliquer un formulaire de création ou de modification valide | Crée ou met à jour la promotion et revient à la liste de promotion après le succès. |
| Ligne de promotion | Inspecter une promotion | Ouvre le type, la méthode, l'état, le code, l'utilisation et les actions disponibles. |
| **Modifier** | Modifier la promotion sélectionnée | Ouvre le formulaire de modification pour ce type de promotion existant. |
| **Supprimer** | Supprimer définitivement la promotion | À partir de la liste de bureau, ouvre une confirmation irréversible nommant le code de promotion. La vue mobile actuelle n'affiche pas cette action. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBOjWz1xmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Ce détail indique le statut du brouillon, le code par rapport à la remise automatique, la valeur et l'éligibilité. La sauvegarde et l'activation ne sont pas affichées.
## Créez une promotion
1. Sélectionnez **Créer**, ou **Ajouter la première promotion** quand la liste est vide.
2. Choisissez le type qui correspond à l'offre.
3. Choisissez **Remise automatique** ou **Code promotionnel**.
4. Entrez la valeur de code requise. Pour **Code promotionnel**, entrez le code exact que les clients doivent utiliser ; pour **Remise automatique**, les clients ne l'entrent pas.
5. Choisissez **Brouillon** pendant la préparation ou **Active** quand elle doit être admissible.
6. Entrez la valeur de Remise, ou sélectionnez les produits Acheter et Obtenir et les quantités.
7. Laissez l'admissibilité pour tous les clients ou sélectionnez **Ajouter une condition** et complétez chaque champ de condition.
8. Vérifiez le résumé, puis sélectionnez **Enregistrer**.
9. Revenez à la liste et confirmez le Type, la Méthode, l'État, le Code et les valeurs Utilisé.
### Exemple : préparer un code à 10 %
Choisissez **Remise en pourcentage sur la commande**, **Code promotionnel**, le code `WELCOME10`, **Brouillon** et la valeur `10`. Vérifiez l’éligibilité avant d’économiser. Si vous êtes seulement en train d'apprendre le formulaire, partez sans sauvegarder ; un formulaire non enregistré ne crée aucune promotion.
Après avoir enregistré un brouillon prévu, rouvrez sa ligne et vérifiez l'état du code, de la méthode et du brouillon. Conservez-le en tant que brouillon jusqu'à ce que vous ayez vérifié séparément le comportement de paiement prévu. Une remise automatique nécessite également un code interne, mais les clients ne saisissent pas ce code.
## Modifiez ou supprimez une promotion
1. Sélectionnez une ligne de promotion.
2. Choisissez **Modifier**, modifiez les champs prévus et sélectionnez **Enregistrer**.
3. Testez la règle mise à jour avant de la partager avec les clients.
4. Pour la supprimer, revenez à la liste de bureau, sélectionnez **Supprimer** et lisez le code dans la confirmation.
5. Continuez uniquement si la suppression permanente est prévue.
## États et limites
- **Brouillon** est stocké mais n'est pas destiné à être utilisable au paiement.
- **Active** est admissible à s'appliquer quand sa méthode et ses conditions correspondent.
- **Inactif** peut apparaître dans la liste quand une promotion existante n'est pas actuellement active.
- Une valeur de pourcentage doit être entre 1 et 100.
- Le formulaire nécessite une valeur de code pour les deux méthodes. Les clients l'entrent uniquement quand **Code promotionnel** est sélectionné.
- Acheter X Obtenir Y nécessite à la fois le produit admissible et le produit gratuit.
- Chaque condition ajoutée a besoin d'un attribut, d'un opérateur et d'une valeur.
- Avec une remise automatique, le paiement décide si ses règles correspondent ; le client n'entre pas la valeur de code du formulaire.
## Dépannage
- **L'enregistrement est désactivé ou affiche une erreur :** Complétez la valeur, le code, le produit, la quantité ou les champs de condition nommés par le formulaire.
- **Un code ne fonctionne pas au paiement :** Confirmez l'orthographe exacte, l'état Actif, l'admissibilité du client, les exigences de produit, le marché et le paiement actuel.
- **Une remise automatique ne s'applique pas :** Vérifiez que la commande répond à chaque condition et qu'une autre promotion ne change pas le résultat attendu.
- **Une promotion d'expédition gratuite n'a pas d'effet visible :** Confirmez que la commande a une option d'expédition enregistrée admissible et que la promotion est Actif.
- **La liste de promotion ne se charge pas :** Actualisez la page et confirmez le projet correct avant d'essayer de créer un doublon.
## Guides connexes
- [Produits](./products)
- [Clients](./customers)
- [Expédition](./shipping)
- [Commandes](./orders)
---
# Avis
Source: https://www.runnerai.com/docs/fr/guides/store-operations/reviews-and-advanced-admin
Utilisez Avis pour modérer les commentaires des clients lorsque la fonctionnalité est activée.
## Pourquoi et quand utiliser Avis
Activez Avis lorsque votre vitrine est prête à collecter les commentaires des produits et que quelqu'un modérera les soumissions.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
### Avis
- Ouvrez **Opérations de la boutique → Général** et recherchez **Avis produits**.
- L'entrée Avis et ses contrôles disponibles dépendent de la prise en charge du magasin et de la présentation actuelle. S'il est manquant ou bloqué, inspectez les avis sur les produits en général plutôt que de forcer un itinéraire direct.
- Une vitrine plus ancienne peut manquer de composants d'avis même après l'activation du commutateur. Lorsque Runner affiche l'indice de fonctionnalité, demandez à l'agent d'ajouter la fonctionnalité d'avis sur les produits et de publier les modifications de vitrine résultantes.
- Les avis n'apparaissent qu'après que les clients les soumettent via une vitrine prise en charge.
## Chemins d'accès
**Chemin d'accès aux avis :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Général → Avis produits**, activez le commutateur, puis sélectionnez **Opérations de la boutique → Avis** lorsque cet élément de menu apparaît.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglTicdyefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
L’image recadrée et annotée met en évidence les filtres de modération. Ouvrez Général pour gérer les paramètres de collecte ; aucun avis n’a été approuvé dans cet exemple.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| Commutateur **Avis produits** | Demander la collecte d'avis pour le magasin | Enregistre le paramètre immédiatement. Si la demande échoue, le commutateur revient à sa valeur antérieure ; aucun **Enregistrer** au niveau de la page n'est nécessaire pour ce commutateur. |
| **Tout** | Examiner tous les états de modération chargés | Efface le filtre de statut. |
| **Approuvé** | Examiner les soumissions acceptées | Filtre la liste sur Approuvés. |
| **Rejeté** | Examiner les soumissions refusées | Filtre la liste sur Rejetés. |
| **En attente** | Trouver les avis en attente d'une décision | Filtre la liste sur En attente. |
| Case à cocher de ligne | Sélectionner les avis pour une décision en masse | Ajoute ou supprime cet avis de la sélection actuelle. |
| **Approuver** | Accepter un avis | Met à jour son statut sur Approuvé après succès. |
| **Rejeter** | Refuser un avis | Met à jour son statut sur Rejeté après succès. |
| **Approuver la sélection** | Accepter tous les avis cochés | Applique Approuvé à la sélection actuelle après succès. |
| **Rejeter la sélection** | Refuser tous les avis cochés | Applique Rejeté à la sélection actuelle après succès. |
## Activer les avis et modérer les avis reçus
1. Ouvrez **Opérations de la boutique → Général**.
2. Activez **Avis produits**.
3. Attendez que le paramètre finisse d'être enregistré. Si le commutateur revient à désactivé, la demande a échoué ; réessayez après avoir vérifié la disponibilité du magasin.
4. Si Runner indique que la vitrine manque de composants d'avis, demandez à l'agent Runner d'ajouter la fonctionnalité d'avis sur les produits, examinez la modification de vitrine et publiez-la.
5. Retournez à Opérations de la boutique et ouvrez **Avis** après l'apparition du menu.
6. Sélectionnez **En attente**.
7. Lisez le produit, l'évaluateur, la note, le contenu et la date pour chaque soumission.
8. Sélectionnez **Approuver** ou **Rejeter**, ou cochez plusieurs lignes et utilisez l'action sélectionnée correspondante.
9. Attendez le message de succès et vérifiez la colonne Statut.
## États et limites
- **En attente** nécessite une décision de modération ; **Approuvé** et **Rejeté** enregistrent la décision actuelle.
- **Aucun avis pour le moment** est valide jusqu'à ce que des soumissions de clients prises en charge existent.
- L'activation du paramètre ne fabrique pas d'avis et ne prouve pas que la vitrine contient un formulaire d'avis.
## Dépannage
- **Le menu Avis est manquant :** Confirmez le commutateur dans Général, la disponibilité du service de boutique et l'indice de fonctionnalité de vitrine. Actualisez après la confirmation du paramètre.
- **Les clients ne peuvent pas laisser d'avis :** Vérifiez que la vitrine inclut les composants d'avis et que ces modifications de vitrine ont été publiées.
- **Une action de modération échoue :** Gardez l'avis sélectionné, actualisez une fois et réessayez uniquement après avoir vérifié son statut actuel.
## Guides connexes
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
- [Produits](./products)
- [Commandes](./orders)
- [Aperçu des opérations de la boutique](/fr/guides/store-operations)
---
# Expédition
Source: https://www.runnerai.com/docs/fr/guides/store-operations/shipping
Configurez d'où les commandes sont expédiées, où les clients peuvent les recevoir et comment le paiement calcule les frais d'expédition.
## Pourquoi et quand utiliser les paramètres d'expédition
Configurez l'expédition avant de tester le paiement ou de rendre un produit physique disponible aux clients. Retournez lorsque vous ajoutez un lieu d'exécution, vendez dans un nouveau pays ou modifiez le montant que les clients paient pour la livraison.
## Disponibilité et conditions préalables
Si les cartes de configuration apparaissent à la place du menu administrateur, [terminer la configuration du magasin](/fr/guides/store-operations/onboarding-and-general-settings) d'abord, puis sélectionnez **Ouvrir Opérations de la boutique**.
- Créez et enregistrez d'abord un Lieu de stock.
- Conservez au moins une région de Marché enregistrée. Lorsqu'une région par défaut existe, Runner peut ajouter la destination d'expédition nouvellement sélectionnée à celle-ci lorsque vous enregistrez ; sans région par défaut, l'enregistrement échoue.
- Les choix d'expédition affichés ici sont des règles de magasin. Les services spécifiques au transporteur ou à l'application peuvent nécessiter une connexion séparée dans **Apps**.
- Les flux de produits numériques, de réservation, de fournisseur ou autres spéciaux peuvent suivre des règles d'exécution différentes.
## Ouvrir Expédition
**Chemin d'accès :** **Espace de travail → choisissez un magasin → Opérations de la boutique → Général → Livraison**
Si Runner affiche une alerte de configuration d'expédition, sélectionnez **Configurer**. Cela vous déplace vers la section Expédition sur Général. L'expédition n'est pas un élément permanent dans la barre latérale Opérations de la boutique.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Utilisez le marché et l'emplacement de stock enregistrés avant d'ajouter une option d'expédition. Cet exemple de vue de champ n'affiche pas un taux de sauvegarde ou de récupération terminé.
## Contrôles principaux
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| **Ajouter** | Créer une option d'expédition | Ajoute une ligne **Expédition gratuite** non enregistrée avec une destination **Livrer vers** vide et un coût d'expédition gratuit. |
| **Nom** | Donner aux clients un choix de livraison reconnaissable | Définit l'étiquette utilisée pour l'option d'expédition. |
| **Livrer vers** | Choisir le pays de destination du client | Limite l'option à cette destination. |
| **Frais de livraison** | Définir comment le paiement calcule les frais | Ouvre la boîte de dialogue Expédition pour **Tarif forfaitaire** ou **Tarif par prix**. |
| **Tarif forfaitaire** | Facturer un montant | Affiche un seul champ de prix d'expédition. |
| **Tarif par prix** | Varier l'expédition selon le total des articles du panier | Affiche les lignes de plage minimale, maximale et de prix d'expédition. |
| **Ajouter** dans la boîte de dialogue de tarif | Ajouter une autre bande de prix | Ajoute une plage de total du panier non enregistrée. |
| **Enregistrer** dans la boîte de dialogue de tarif | Accepter le brouillon de tarif | Ferme la boîte de dialogue et retourne le tarif configuré à la page Général. |
| **Annuler** dans la boîte de dialogue de tarif | Abandonner les modifications de la boîte de dialogue | Ferme la boîte de dialogue sans appliquer ces modifications de tarif. |
| **Enregistrer** sur Général | Persister l'option d'expédition | Enregistre l'expédition complétée et les modifications Général connexes au magasin. |
## Ajouter une option à tarif fixe ou gratuit
1. Dans Général, confirmez qu'une région de Marché et un Lieu de stock sont enregistrés.
2. Faites défiler jusqu'à Expédition et sélectionnez **Ajouter**.
3. Entrez un Nom clair, comme la vitesse de livraison ou la méthode que les clients reconnaîtront.
4. Choisissez **Livrer vers**. Les options d'expédition utilisent le Lieu de stock enregistré dans Général ; il n'y a pas de sélecteur **Expédier depuis** séparé dans chaque ligne.
5. Ouvrez **Frais de livraison**.
6. Choisissez **Tarif forfaitaire** et entrez un prix d'expédition. Entrez `0` lorsque la livraison doit s'afficher comme **Gratuit**.
7. Sélectionnez **Enregistrer** dans la boîte de dialogue.
8. Sélectionnez l'**Enregistrer** au niveau de la page et attendez l'état enregistré.
**Exemple :** nommez une option `Standard shipping`, choisissez une destination dans votre marché enregistré et définissez **Tarif forfaitaire** sur `0` pour une livraison gratuite. Sélectionnez **Enregistrer** dans la boîte de dialogue, puis **Enregistrer** dans Général. Rouvrez Général et vérifiez la destination et le tarif enregistré. Le premier enregistrement ferme uniquement l'éditeur de tarifs ; il n’enregistre pas les paramètres d’expédition. Le service du transporteur et le montant affiché au passage en caisse nécessitent une vérification distincte.
## Ajouter des tarifs basés sur le prix
1. Ouvrez **Frais de livraison** pour l'option prévue.
2. Choisissez **Tarif par prix**.
3. Entrez un total minimum ou maximum des articles du panier et le prix d'expédition pour cette plage.
4. Sélectionnez **Ajouter** pour chaque plage supplémentaire.
5. Assurez-vous que les plages ne se chevauchent pas et que chaque ligne a un prix d'expédition.
6. Sélectionnez **Enregistrer** dans la boîte de dialogue, puis **Enregistrer** sur Général.
## États et limites
- Chaque plage de prix a besoin d'au moins un total minimum ou maximum des articles du panier.
- Les plages de prix qui se chevauchent sont rejetées.
- Un prix d'expédition est requis pour les méthodes fixes et basées sur le prix.
- Une destination sans région enregistrée affiche **Vous ne vendez pas encore dans ce pays : ajoutez-le d’abord dans « Marchés ».**.
- Lorsqu'une région de Marché par défaut existe, l'enregistrement peut ajouter le pays de destination sélectionné à cette région automatiquement.
- L'**Enregistrer** de la boîte de dialogue prépare l'option sur la page ; utilisez l'**Enregistrer** de la page Général pour persister le changement de paramètres complet.
## Dépannage
- **Veuillez d'abord ajouter un lieu de stock :** Ajoutez-en un et enregistrez-le dans Général, puis retournez à Expédition.
- **Aucune région par défaut n'est disponible :** Créez et enregistrez une région de Marché, puis réessayez l'**Enregistrer** de la page Général.
- **Veuillez d'abord enregistrer le lieu de stock :** Utilisez l'**Enregistrer** de la page Général, puis rouvrez la ligne d'expédition.
- **Deux tranches se chevauchent : un total de panier correspondrait aux deux.** Ajustez les valeurs minimales et maximales afin que chaque total du panier ne corresponde qu'à une seule ligne.
- **L'expédition est manquante au paiement :** Confirmez que la destination correspond à un marché enregistré, que la ligne d'expédition est enregistrée, que le produit nécessite une expédition et que tout service connecté est prêt.
## Guides connexes
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
- [Inventaire et variantes](./inventory-and-variants)
- [Commandes](./orders)
- [Aperçu des opérations de la boutique](/fr/guides/store-operations)
---
# Vitrine et publication
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing
Utilisez cette section pour déplacer une vitrine d'un aperçu dans l'application à un magasin en direct vérifié. Chaque page couvre une tâche et explique ce que chaque contrôle important fait.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Commencez par consulter l’aperçu actuel, puis suivez le guide pour connaître l’étape de modification ou de lancement dont vous avez besoin.
## Ce que couvre ce guide
Choisissez le guide qui correspond à votre tâche de vitrine actuelle, sans confondre un aperçu modifiable avec un magasin en direct et achetable.
## Comprendre les quatre états de la vitrine
| État | Ce que cela signifie | Ce que cela ne prouve pas |
| --- | --- | --- |
| **Aperçu** | Runner affiche une copie de travail à l'intérieur de votre projet. Vous pouvez examiner les pages et les mises en page. | Le magasin n'est pas nécessairement public. |
| **Publier** | Runner vérifie et envoie la version actuelle à une URL de magasin public pour la première fois. | Les produits, le stock, l'expédition, les paiements et le paiement ne sont pas automatiquement vérifiés. |
| **Publier les modifications** | Un magasin en direct existe déjà et Runner peut envoyer les modifications plus récentes. | Les modifications non enregistrées ou inachevées ne sont pas en direct. |
| **Republier** | Runner peut réessayer après une publication échouée ou une publication terminée qui n'a pas renvoyé une URL utilisable. | Ce n'est pas l'étiquette normale pour publier de nouvelles modifications sur un magasin sain. |
## Choisir une tâche
| Ce que vous voulez faire | Guide | Résultat |
| --- | --- | --- |
| Examiner la vitrine actuelle | [Prévisualiser votre magasin](/fr/guides/storefront-and-publishing/preview-your-store) | Vérifiez les pages, les itinéraires, le comportement d'actualisation et les mises en page réactives. |
| Apporter des modifications visuelles | [Utiliser le mode de conception](/fr/guides/storefront-and-publishing/design-mode) | Sélectionnez un élément et ouvrez les contrôles d'édition. |
| Modifier le texte, l'espacement, le type ou les images | [Modifier le contenu, les pages et les médias](/fr/guides/storefront-and-publishing/edit-content-pages-and-media) | Mettez à jour une page visible et enregistrez le résultat. |
| Inspecter ou modifier un fichier de vitrine | [Inspecter et modifier le code de la vitrine](/fr/guides/storefront-and-publishing/inspect-and-edit-code) | Ouvrez l'éditeur de code conditionnel, enregistrez une modification de fichier ciblée et examinez son état Git. |
| Comparer ou récupérer un état antérieur | [Utiliser l'historique des versions](/fr/guides/storefront-and-publishing/version-history) | Prévisualisez une version ou restaurez-la comme nouvelle version actuelle. |
| Vérifier si le magasin est prêt | [Préparer la publication](/fr/guides/storefront-and-publishing/prepare-to-publish) | Résolvez ou reconnaissez explicitement les vérifications affichées par Runner. |
| Mettre les modifications en ligne | [Publier et republier](/fr/guides/storefront-and-publishing/publish-and-republish) | Démarrez le flux de publication correct pour l'état actuel. |
| Prouver que le parcours client fonctionne | [Vérifier le magasin en direct et le paiement](/fr/guides/storefront-and-publishing/live-store-and-checkout) | Confirmez le catalogue public, le panier et le paiement séparément. |
| Utiliser votre propre adresse Web | [Connecter un domaine personnalisé](/fr/guides/storefront-and-publishing/custom-domains) | Ajoutez, achetez, transférez, renouvelez ou diagnostiquez un domaine éligible. |
| Récupérer d'un état bloqué | [Dépanner l'aperçu et la publication](/fr/guides/storefront-and-publishing/troubleshoot-preview-and-publishing) | Faites correspondre le message à l'écran à l'action suivante la plus sûre. |
## Ordre recommandé pour un premier lancement
1. Examinez la dernière version dans [Aperçu](/fr/guides/storefront-and-publishing/preview-your-store).
2. Apportez et enregistrez les modifications visuelles dans [Mode de conception](/fr/guides/storefront-and-publishing/design-mode).
3. Vérifiez les [conditions préalables à la publication](/fr/guides/storefront-and-publishing/prepare-to-publish).
4. Sélectionnez **Publier** et suivez le flux de confirmation.
5. Ouvrez l'URL publique et [vérifiez le catalogue et le paiement](/fr/guides/storefront-and-publishing/live-store-and-checkout).
6. Ajoutez un [domaine personnalisé](/fr/guides/storefront-and-publishing/custom-domains) uniquement après la première publication réussie.
## Disponibilité et sécurité
- **Mode Design** est conditionnel. Il est destiné à une version prête la plus récente sur une mise en page de bureau et peut ne pas être disponible pendant que Runner fonctionne.
- **Ouvrir l'éditeur de code** est conditionnel. L'enregistrement, la validation, l'envoi, la publication et la vérification du magasin en direct sont des résultats séparés.
- La publication peut être limitée par le plan ou l'état du magasin. Suivez le message affiché dans votre espace de travail plutôt que de supposer que chaque compte a le même accès.
- Une confirmation de publication peut vous permettre de reconnaître une configuration incomplète. Ce choix peut mettre une vitrine consultable en ligne tandis que le paiement reste en pause ou incomplet.
## Guides connexes
- [Bienvenue dans Runner AI](/fr/guides/product-guide)
- [Inspecter et modifier le code de la vitrine](/fr/guides/storefront-and-publishing/inspect-and-edit-code)
- [Dépanner l'aperçu et la publication](/fr/guides/storefront-and-publishing/troubleshoot-preview-and-publishing)
---
# Connecter un domaine personnalisé
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/custom-domains
**Chemin d'entrée :** Barre latérale **Paramètres** → **Magasin : _nom du magasin_** → **Domaine**. Sur ordinateur, le menu du site publié **Boutique en ligne** peut également proposer **Paramètres du domaine**.
## Ce que couvre ce guide
Ouvrez Paramètres de domaine pour un magasin publié, choisissez le flux de travail de domaine correct et comprenez ce que chaque action à fort impact change avant de continuer.
## Pourquoi et quand utiliser un domaine personnalisé
Un domaine personnalisé donne aux clients une adresse de marque pour le magasin publié. Connectez-en un après la première publication réussie et après que le magasin fonctionne à son URL publique existante. Cela isole les problèmes de domaine des problèmes de vitrine, de catalogue et de paiement.
## Disponibilité et conditions préalables
- L'accès au **domaine personnalisé** dépend du plan.
- Le magasin doit avoir une publication réussie avant que les contrôles de domaine deviennent disponibles.
- Vous avez besoin d'accès aux paramètres du projet.
- L'ajout d'un domaine que vous possédez déjà nécessite la permission de modifier ses enregistrements DNS chez votre fournisseur DNS.
- L'achat ou le renouvellement d'un domaine démarre un flux de paiement externe.
- Le transfert d'un domaine entre les magasins du même espace de travail est limité aux propriétaires et administrateurs de l'espace de travail.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgj47Uwq6IQ3D84warl6z9RO5sLdoxCUgTn1v2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Une boutique non publiée montre ce préalable. Publiez et vérifiez son URL publique avant de suivre les étapes de connexion DNS ci-dessous.
## Ouvrir Paramètres de domaine
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Après publication, ouvrez le menu déroulant à côté de **Publier les modifications** : 1. Menu du site publié. 2. **Voir le site** ouvre le magasin en ligne ; **Copier l’URL** copie son adresse. 3. **Paramètres de domaine** ouvre la gestion des adresses. Cette image ne vérifie pas le paiement. Sélectionnez l’image pour l’agrandir. Les annotations utilisent l’interface de bureau en anglais.
1. Confirmez le nom actuel du magasin.
2. Ouvrir la barre latérale **Paramètres**.
3. Sous **Magasin : _nom du magasin_**, sélectionnez **Domaine**.
4. Si la page vous demande de publier en premier, complétez et vérifiez la première publication avant d'ajouter un domaine.
## Contrôles de domaine
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsque vous le sélectionnez |
| --- | --- | --- |
| **Comment connecter mon propre domaine ?** | Ouvrir l'aide de connexion actuelle. | La page d'aide s'ouvre dans un nouvel onglet. |
| Saisissez votre domaine + **Continuer** | Attachez un domaine que vous possédez déjà. | Runner valide et joint l'adresse, puis vérifie le fournisseur DNS. **Domaine ajouté avec succès** confirme uniquement la pièce jointe ; Le DNS et la propriété sont vérifiés séparément. Le champ n'est pas disponible avant la première publication réussie. |
| **Continuer vers Cloudflare** | Laisser Runner ajouter les enregistrements requis pour un domaine compatible géré par Cloudflare. | Runner ouvre la page d'autorisation de Cloudflare. Choisissez le compte qui contient le domaine et autorisez l'accès DNS de Runner. À votre retour, Runner écrit les enregistrements exacts requis et lance une nouvelle vérification de connexion. Cette option apparaît uniquement lorsque la configuration automatique est disponible. |
| **Utiliser les enregistrements manuels** | Passer d'un flux automatique proposé à la configuration DNS manuelle. | Sélectionnez cette option pour afficher les enregistrements exacts **Type / Hôte / Valeur**. Si la configuration automatique n'est pas disponible, Runner affiche directement ces enregistrements. Ajoutez chaque enregistrement affiché chez votre fournisseur DNS, puis revenez dans Runner. |
| **J’ai ajouté les enregistrements** | Vérifier immédiatement le DNS après l’enregistrement des entrées manuelles. | Runner vérifie automatiquement ; ce bouton évite l’attente initiale et vérifie immédiatement les enregistrements de routage ainsi que tout défi de propriété. Une autorisation réussie chez le fournisseur ne suffit pas à marquer le domaine comme connecté. |
| Icône d'effacement dans le champ de domaine | Supprimer la valeur saisie. | L'entrée est effacée ; aucun domaine n'est modifié. |
| Recherche **Acheter un domaine** + **Rechercher** | Trouver les domaines proposés à l'achat. | Runner répertorie les résultats disponibles ou explique que le domaine demandé n'est pas disponible. |
| **Acheter** | Commencer à acheter un domaine disponible sélectionné. | Runner ouvre **Informations de contact** avec le domaine et le prix affichés. Aucun achat n'a lieu encore. |
| **Procéder au paiement** | Continuer un achat ou un renouvellement de domaine. | Runner redirige vers un paiement externe. Cela peut créer une charge si vous le complétez. Examinez d'abord les détails affichés. |
| **Transférer un domaine** / **Choisir un domaine à transférer** | Déplacer un domaine admissible d'un autre magasin du même espace de travail. | La sélection d'un domaine ouvre une confirmation nommant les magasins source et destination. La confirmation démarre le transfert ; le magasin source perd ce domaine. |
| Adresse de domaine sous **Vos domaines** | Ouvrir le site à cette adresse. | Le domaine s'ouvre dans un nouvel onglet du navigateur. |
| Copier à côté de **Hôte** ou **Valeur** | Utiliser l'enregistrement DNS exact que Runner recommande. | L'**Hôte** ou la **Valeur** sélectionné est copié pour utilisation chez votre fournisseur DNS. Entrez le **Type** affiché séparément. |
| Supprimer le domaine | Détacher un domaine personnalisé. | Runner ouvre **Supprimer le domaine**. La sélection de **Supprimer** confirme une modification que la boîte de dialogue décrit comme irréversible. |
| **Renouveler** | Prolonger un domaine acheté admissible affiché près de l'expiration. | Runner ouvre les options de renouvellement et un total avant **Procéder au paiement**. |
| **Réessayer** dans un transfert échoué | Commencer une autre tentative de transfert. | Runner démarre une nouvelle tentative pour le même domaine sélectionné. |
| **Fermer** dans un transfert échoué | Quitter la boîte de dialogue de transfert échoué. | La boîte de dialogue se ferme sans démarrer la nouvelle tentative. |
| Fermer ou X pendant **Transfert en cours** | Ignorer la boîte de dialogue de progression | Le transfert côté serveur continue ; fermer la boîte de dialogue ne l'annule pas. Retournez plus tard pour inspecter le statut et ne démarrez pas un autre transfert. |
## Connecter un domaine que vous possédez déjà
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Cet exemple indique que le magasin est publié et que les commandes de domaine sont débloquées. 1. Saisissez un domaine que vous possédez. 2. Sélectionnez **Continuer**. 3. Recherchez éventuellement dans **Acheter un domaine**. 4. Ouvrez l’adresse publiée sous **Vos domaines**. **Transférer un domaine** est une option distincte. L’adresse est masquée ; aucun domaine n’a été ajouté. Sélectionnez l’image pour l’agrandir. Les annotations utilisent l’interface de bureau en anglais.
1. Confirmez que le magasin fonctionne à son URL publique actuelle.
2. Ouvrez **Paramètres de domaine**.
3. Entrez le domaine complet que vous contrôlez, puis sélectionnez **Continuer**.
4. **Domaine ajouté avec succès** signifie que Runner a accepté et joint l'adresse. Il ne confirme pas que le DNS est configuré ou que le site est actif.
5. Choisissez une méthode de configuration :
- Si Runner détecte une configuration Cloudflare compatible, sélectionnez **Continuer vers Cloudflare**, choisissez le compte Cloudflare qui contient le domaine et autorisez l'accès DNS de Runner. À votre retour, Runner écrit les enregistrements exacts affichés dans les paramètres du domaine.
- Si un flux automatique est proposé et que vous préférez la configuration manuelle, sélectionnez **Utiliser les enregistrements manuels**. Si la configuration automatique n'est pas disponible, les enregistrements sont déjà affichés. Ajoutez chaque enregistrement **Type / Hôte / Valeur** affiché chez votre fournisseur DNS.
6. Après avoir enregistré les enregistrements manuels, sélectionnez **J’ai ajouté les enregistrements** pour éviter l’attente initiale et vérifier immédiatement. Runner vérifie également automatiquement pendant qu’une connexion est en attente et lorsque vous revenez de Cloudflare.
7. Attendez l'état connecté. Runner exige la validation des enregistrements de routage et de la propriété du domaine ; terminer l'autorisation Cloudflare ne constitue pas à lui seul une preuve de connexion.
8. Ouvrez le domaine depuis **Vos domaines**, puis vérifiez à nouveau la vitrine publique, le produit, le panier et le paiement à l'adresse personnalisée.
## Acheter, transférer, renouveler ou supprimer avec prudence
- **Acheter :** Recherchez, sélectionnez **Acheter**, examinez le domaine et le prix actuel, entrez les informations de contact exactes, puis continuez vers le paiement uniquement lorsque vous avez l'intention de l'acheter.
- **Transférer :** Lisez la source et la destination nommées. La confirmation indique que le magasin source perd le domaine et que l'annulation immédiate n'est pas disponible. Ne confirmez pas tant que ce magasin source a toujours besoin de l'adresse. Fermer la boîte de dialogue de progression n'annule pas un transfert actif.
- **Renouveler :** Examinez la période de renouvellement et le total avant de continuer vers le paiement.
- **Supprimer :** Assurez-vous qu'un autre domaine fonctionnel existe et enregistrez la configuration actuelle avant de sélectionner **Supprimer**. La confirmation avertit que la suppression ne peut pas être annulée.
## États, limites et dépannage
| Ce que vous voyez | Signification | Ce que vous devez faire |
| --- | --- | --- |
| **Veuillez d'abord publier** | Le projet n'a pas encore de publication réussie. | Publiez et vérifiez l'URL publique existante avant d'ajouter un domaine personnalisé. |
| **Aucun domaine trouvé** | Aucun domaine n'est actuellement attaché. | Ajoutez un domaine possédé ou recherchez-en un à acheter. |
| **Cela ne ressemble pas à un domaine. Essayez quelque chose comme yourbrand.com.** | Runner a rejeté le format d'adresse. | Corrigez l'adresse et réessayez. |
| **Le domaine est déjà attaché à un autre magasin** | Un autre magasin de cet espace de travail l'utilise. | Un propriétaire ou un administrateur peut sélectionner **Le transférer à la place ?** ; les autres membres doivent contacter un administrateur. |
| **Domaine ajouté avec succès** | Runner a accepté et joint l'adresse. La configuration DNS est vérifiée séparément. | Lisez la ligne du domaine avant de considérer l'adresse comme prête. |
| **Continuer vers Cloudflare** n'est pas affiché | La configuration automatique n'est actuellement pas disponible pour ce domaine ou le service de connexion Cloudflare n'est pas prêt. | Utilisez les enregistrements DNS manuels affichés dans la ligne du domaine. N'attendez pas qu'une option automatique apparaisse. |
| Enregistrements DNS manuels et **J’ai ajouté les enregistrements** | Le domaine possédé est rattaché, mais le routage ou la vérification de propriété n'a pas encore réussi. | Ajoutez exactement chaque enregistrement affiché, attendez la propagation DNS, puis sélectionnez **J’ai ajouté les enregistrements** pour vérifier immédiatement. Runner continue à vérifier automatiquement. |
| État de vérification après le retour de Cloudflare | Runner lit l'état réel du DNS et de la propriété. | Gardez la page ouverte ou revenez plus tard. Si le domaine ne se connecte pas, utilisez les enregistrements manuels et vérifiez à nouveau. |
| Coche bleue et disparition des contrôles DNS du domaine | La configuration DNS actuelle et la vérification de propriété ont toutes deux réussi. | Ouvrez le domaine et vérifiez tout le parcours client ; la coche seule ne prouve pas que la vitrine ou le paiement fonctionnent. |
| Indicateur de chargement avec **Configuration du domaine en cours — disponible dans quelques minutes** | Un domaine acheté via Runner est encore en cours de configuration. | N'appliquez pas les instructions DNS manuelles des domaines possédés à cet état. Revenez plus tard ; aucun délai d'achèvement fixe n'est garanti. |
| **Transfert en cours** | Un déplacement de domaine d'espace de travail a commencé. | Évitez de démarrer un autre déplacement pour le même domaine. Fermer la boîte de dialogue ne fait que la rejeter ; le transfert continue sur le serveur. Retournez plus tard pour inspecter le résultat. |
| Le transfert a échoué | Le déplacement n'a pas été complété. | Lisez l'erreur, puis sélectionnez **Réessayer** ou **Fermer**. Confirmez quel magasin détient toujours le domaine avant une autre action. |
| L'achat ou le renouvellement a échoué | Le paiement externe n'a pas été complété. | Suivez le statut affiché par Runner et confirmez tout état de remboursement avant d'essayer un autre paiement. |
## Guides connexes
- [Publier et republier](./publish-and-republish)
- [Vérifier le magasin en direct et le paiement](./live-store-and-checkout)
- [Dépanner l'aperçu et la publication](./troubleshoot-preview-and-publishing)
---
# Utiliser le mode de conception
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/design-mode
**Chemin d'accès :** Espace de travail → sélectionnez un magasin → **Boutique en ligne** → **Mode Design**
## Ce que couvre ce guide
Ouvrez le mode de conception sur la dernière version de vitrine, sélectionnez un élément visible, effectuez une modification contrôlée et enregistrez-la dans le cadre du projet actuel.
## Pourquoi et quand utiliser le mode de conception
Utilisez le mode de conception pour les modifications visuelles ciblées qui sont plus faciles à pointer qu'à décrire à partir de zéro : réécrire un titre, remplacer une image, ajuster l'espacement, modifier la typographie ou supprimer un élément visible.
Utilisez le chat Runner pour un travail plus large qui s'étend sur plusieurs pages, modifie le comportement du magasin ou nécessite une nouvelle fonctionnalité.
## Disponibilité et conditions préalables
Le mode de conception est conditionnel. Il est disponible lorsque :
- vous utilisez une mise en page de bureau ;
- la dernière version de vitrine est prête et sélectionnée ;
- vous ne prévisualisez pas une version plus ancienne ;
- Runner ne traite pas actuellement une autre demande ; et
- la fonctionnalité Mode de conception est activée pour l'espace de travail.
Si l'aperçu est toujours en préparation, une version historique est sélectionnée ou Runner fonctionne, le bouton peut être masqué ou désactivé.
## Ouvrir le mode de conception
1. Ouvrez votre projet.
2. Sélectionnez **Boutique en ligne**.
3. Assurez-vous que l'étiquette de version indique **Actuel** et que l'aperçu est prêt.
4. Sélectionnez **Mode Design** dans la barre d'outils de vitrine.
5. Si une barre d'édition inférieure apparaît avec un autre contrôle **Mode Design**, sélectionnez-le pour activer la sélection d'éléments.
6. Déplacez-vous sur la vitrine et sélectionnez l'élément que vous souhaitez modifier.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Le mode Conception est ouvert, mais aucun élément n’est encore sélectionné. Sélectionnez l'élément que vous souhaitez modifier pour révéler ses contrôles disponibles ; la capture d'écran ne montre pas de modification ou de sauvegarde.
## Contrôles du mode de conception
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsque vous le sélectionnez |
| --- | --- | --- |
| **Mode Design** dans la barre d'outils de vitrine | Entrer la vue d'édition dédiée. | Runner ouvre la vitrine actuelle dans le panneau de conception. |
| **Mode Design** dans la barre inférieure | Activer ou désactiver l'inspection d'éléments. | Lorsqu'il est activé, les éléments sélectionnables sont encadrés et la sélection d'un élément ouvre sa barre d'édition. Le désactiver efface la session d'édition actuelle. |
| Champ **Demander à Runner** et flèche d'envoi | Décrire une modification pour l'élément sélectionné. | Runner reçoit l'instruction avec l'élément sélectionné. Lorsque Runner démarre, il efface la sélection et réinitialise les modifications directes non enregistrées et leur historique d'annulation/rétablissement, alors enregistrez les modifications directes en attente avant d'envoyer. |
| **Espacement** | Modifier l'espace à l'intérieur ou autour de l'élément. | Un panneau s'ouvre pour la marge et le remplissage horizontaux et verticaux. |
| **Image** | Remplacer une image sélectionnée ou une image de fond. | Un panneau s'ouvre avec les options **Télécharger** et **Généré par IA** lorsque cet élément prend en charge l'édition de médias. |
| **Texte** | Modifier le style de type. | Un panneau s'ouvre pour la taille de police, le poids, la famille, la couleur, l'opacité et l'alignement lorsqu'ils sont pris en charge. |
| **Supprimer l'élément** | Supprimer l'élément sélectionné de la modification actuelle. | L'élément disparaît immédiatement dans l'éditeur. Utilisez **Annuler** si c'était accidentel et examinez avant d'enregistrer. |
| **Annuler** | Inverser la dernière modification visuelle non enregistrée. | Runner revient en arrière dans l'historique d'édition du mode de conception actuel. |
| **Rétablir** | Réappliquer une modification que vous venez d'annuler. | Runner avance dans l'historique d'édition du mode de conception actuel. |
| **Enregistrer** | Conserver les modifications visuelles actuelles. | Runner écrit les modifications en attente, enregistre un nouvel instantané de version lorsque possible, efface l'historique d'annulation/rétablissement de cette session et recharge l'aperçu. Le bouton est désactivé lorsqu'il n'y a rien à enregistrer. |
| **Fermer** | Quitter le panneau de conception dédié. | Runner revient à l'aperçu normal de vitrine et efface les modifications non enregistrées et l'historique des commandes. Enregistrez d'abord si vous souhaitez conserver les modifications. |
## Effectuer une modification visuelle sûre
1. Accédez à la page cible en aperçu normal avant d'ouvrir le mode de conception.
2. Entrez le mode de conception et sélectionnez un élément.
3. Choisissez un chemin pour cette modification :
- Pour une modification directe, utilisez **Espacement**, **Image**, **Texte** ou **Supprimer l'élément**, puis examinez-la avec **Annuler** ou **Rétablir** et sélectionnez **Enregistrer**.
- Pour une demande IA, enregistrez d'abord les modifications directes en attente, resélectionnez l'élément si nécessaire, entrez l'instruction dans **Demander à Runner** et envoyez-la. Lorsque Runner démarre, la sélection et l'historique des modifications directes non enregistrées sont effacés.
4. Attendez que l'enregistrement ou la demande Runner choisi se termine, puis examinez la page en aperçu normal.
5. Vérifiez à nouveau la page dans les mises en page **PC**, **Tablette** et **Téléphone**. Vérifiez que le titre, l'image ou l'espacement enregistré est toujours présent après le rechargement de l'aperçu.
6. Publiez uniquement après que l'aperçu enregistré a réussi votre examen.
## États, limites et dépannage
| Ce que vous voyez | Signification | Ce que vous devez faire |
| --- | --- | --- |
| **Démarrage du mode design…** | Runner prépare l'aperçu modifiable. | Gardez la dernière version sélectionnée. |
| **Le mode de conception n'a pas démarré** | L'aperçu modifiable n'est pas devenu prêt. | Sélectionnez **Réessayer**. S'il se répète, retournez à l'aperçu normal et actualisez. |
| **Votre aperçu est encore en cours de chargement.** | L’inspection des éléments n’est pas prête. | Attendez que la vitrine ait fini de se charger. |
| **Vous pourrez de nouveau modifier visuellement une fois que Runner aura terminé.** | Runner traite une autre demande. | Attendez la fin de la requête, puis sélectionnez à nouveau l'élément. |
| Runner démarre après une demande **Demander à Runner** | L'éditeur visuel se réinitialise pour la nouvelle tâche. | Toute modification directe non enregistrée et son historique d'annulation/rétablissement sont abandonnés. Enregistrez les modifications directes avant d'envoyer la demande. |
| **Cette partie change selon vos données : modifiez-la plutôt dans le chat.** | Le contenu sélectionné ne peut pas être modifié via ce contrôle. | Décrivez la page et le résultat souhaité dans le chat Runner régulier. |
| **Rien à annuler / rétablir / enregistrer** | La session du mode de conception actuelle n'a pas d'action correspondante. | Sélectionnez d'abord un élément modifiable et effectuez une modification. |
| **Modifications enregistrées dans les fichiers source** | Runner a complété l'enregistrement du mode de conception. | Attendez que l'aperçu se recharge, puis examinez à nouveau la page modifiée. |
| **Impossible d'enregistrer vos modifications de design** | Runner n'a pas pu écrire une ou plusieurs modifications dans les fichiers de votre boutique. Ces modifications restent dans l'éditeur et **Enregistrer** reste disponible. Les modifications déjà enregistrées le restent. | Sélectionnez à nouveau **Enregistrer**. Si l'échec persiste, annulez cette modification ou décrivez le changement dans le chat Runner. |
| La modification est enregistrée mais pas en direct | L'enregistrement des modifications met à jour le projet, pas la vitrine publiée. | Examinez la version actuelle, puis sélectionnez **Publier les modifications**. |
## Guides connexes
- [Modifier le contenu, les pages et les médias](./edit-content-pages-and-media)
- [Prévisualiser votre magasin](./preview-your-store)
- [Utiliser l'historique des versions](./version-history)
---
# Modifier le contenu, les pages et les médias
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/edit-content-pages-and-media
**Chemin d'accès :** Espace de travail → sélectionnez un magasin → **Boutique en ligne** → ouvrez la page de vitrine cible → **Mode Design** → sélectionnez un élément
## Ce que couvre ce guide
Ouvrez la page de vitrine exacte que vous souhaitez modifier, modifiez un élément de texte, de mise en page ou de média pris en charge, et vérifiez le résultat enregistré avant de publier.
## Pourquoi et quand utiliser ce flux de travail
Utilisez ce flux de travail pour affiner les pages : corriger le texte, modifier la typographie, ajuster l'espacement, remplacer une photo, générer une image alternative ou supprimer un élément inutile. Cela maintient la clarté de la page cible et de l'élément sélectionné.
Pour les modifications du comportement de navigation, des données de produit, du paiement ou de plusieurs pages à la fois, envoyez une demande régulière à Runner au lieu de vous fier uniquement aux contrôles visuels.
## Disponibilité et conditions préalables
- [Utiliser le mode de conception](./design-mode) explique comment ouvrir l'éditeur, l'exigence de mise en page de bureau et les cas où le contrôle est indisponible.
- Certains éléments générés ou dynamiques ne peuvent pas être modifiés en ligne. Runner affiche moins de contrôles pour ces éléments.
- La génération d'images par IA peut utiliser des crédits. Runner affiche l'avis applicable dans le panneau d'image avant de l'exécuter.
## Ouvrir la page et l'éditeur
1. Ouvrez votre projet et sélectionnez **Boutique en ligne**.
2. En aperçu normal, sélectionnez les liens de la vitrine pour accéder à la page souhaitée.
3. Si vous connaissez l'itinéraire, sélectionnez le champ de chemin, entrez un chemin du même site tel que `/about`, et appuyez sur **Entrée**.
4. Confirmez que la page correcte est visible.
5. Sélectionnez **Mode Design**, puis sélectionnez l'élément cible.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Commencez par sélectionner l'élément cible dans cette vue. Les contrôles spécifiques à l'image n'apparaissent qu'après avoir sélectionné le support pris en charge ; aucun remplacement ou sauvegarde n'est affiché ici.
## Contrôles de médias
[Utiliser le mode de conception](./design-mode) documente les contrôles partagés **Demander à Runner**, **Espacement**, **Texte**, **Supprimer l'élément**, **Annuler**, **Rétablir** et **Enregistrer**. Les contrôles ci-dessous apparaissent uniquement quand l'élément sélectionné prend en charge les médias.
| Contrôle | Ce qu'il change | Ce qui se passe quand vous l'utilisez |
| --- | --- | --- |
| **Image → Télécharger** | Une image sélectionnée ou une image de fond prise en charge. | Sélectionnez **Télécharger l'image**, choisissez un fichier image, et Runner remplace le média sélectionné après le succès du téléchargement. La limite actuelle affichée par le produit est de 5 Mo par image. |
| **Image → Généré par IA** | Une image de remplacement générée. | Entrez une invite et sélectionnez **Exécuter**. Après le premier résultat, **Réexécuter** demande un autre résultat et **Historique** ouvre les résultats de cette session d'édition. |
| **Historique** | Images générées de la session d'édition d'image actuelle. | Sélectionnez un élément pour l'inspecter. **Restaurer cette version** applique cette image et son invite ; l'icône de téléchargement télécharge un résultat individuel. |
## Modifier une page en toute sécurité
1. Enregistrez le chemin de la page actuelle pour pouvoir y revenir.
2. Sélectionnez l'élément et vérifiez quels contrôles apparaissent. Les contrôles varient selon l'élément.
3. Apportez une modification à la fois, puis utilisez **Annuler**, **Rétablir** ou l'**Historique** d'image pour comparer le résultat avant de sélectionner **Enregistrer**.
4. Attendez que la sauvegarde choisie ou la demande Runner se termine.
5. Fermez le mode Conception et rouvrez la même page. Confirmez que la nouvelle image ou le nouveau contenu reste après le rechargement, puis examinez-le dans les mises en page **PC**, **Tablette** et **Téléphone**.
6. Répétez pour la page suivante uniquement après que la première page soit correcte.
## États, limites et dépannage
| Ce que vous voyez | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| Un élément sélectionné n'a que certains contrôles | Runner expose les contrôles pris en charge par cet élément. | Utilisez le contrôle disponible ou demandez à Runner en chat pour une modification plus large. |
| Téléchargement rejeté | Le fichier est manquant, n'est pas une image, dépasse la limite affichée ou le téléchargement a échoué. | Choisissez une autre image et réessayez. |
| **Génération…** | Runner crée l'image demandée. | Gardez le panneau ouvert jusqu'à ce qu'il se termine ou signale une erreur. |
| **Historique** est absent | Aucune image générée par IA n'existe dans cette session d'édition. | Générez la première image ou téléchargez la vôtre à la place. |
| L'itinéraire ne s'ouvre pas | Le chemin est invalide, externe ou ne fait pas partie de l'aperçu. | Retournez à `/`, utilisez un lien de vitrine visible ou demandez à Runner de créer ou réparer la page. |
| La page enregistrée diffère sur mobile | La modification a affecté une mise en page réactive. | Rouvrez le mode de conception ou demandez à Runner une correction spécifique à l'appareil avant de publier. |
## Guides connexes
- [Utiliser le mode de conception](./design-mode)
- [Prévisualiser votre magasin](./preview-your-store)
- [Publier et republier](./publish-and-republish)
---
# Inspecter et modifier le code de la vitrine
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/inspect-and-edit-code
L'éditeur de code vous permet d'inspecter ou d'apporter une modification ciblée aux fichiers de vitrine derrière l'aperçu actuel. Utilisez-le uniquement quand une modification visuelle ou une demande Runner n'est pas la meilleure option.
## Ce que couvre ce guide
Ouvrez l'éditeur de code conditionnel, enregistrez une modification de fichier ciblée, retournez à l'aperçu pour la vérifier, et gardez la validation, l'envoi et la publication comme des actions délibérées séparées.
## Chemin d'accès
Ouvrez un projet de magasin → **Boutique en ligne** → **Ouvrir l'éditeur de code**.
## Avant de commencer
- Attendez que l'espace de travail du projet et l'aperçu de la vitrine soient connectés.
- Utilisez l'éditeur de code uniquement si vous comprenez le fichier que vous avez l'intention de modifier.
- Enregistrez chaque fichier modifié avant de fermer son onglet ou la boîte de dialogue. La fermeture d'un fichier non enregistré n'affiche pas de confirmation.
- Un fichier enregistré modifie l'espace de travail du projet, mais il n'est pas automatiquement validé, envoyé, publié ou prouvé correct dans l'aperçu.
- Utilisez **Valider** et **Pousser** uniquement si vous êtes autorisé à modifier le dépôt Git configuré du projet.
## Contrôles de l'éditeur et résultats des clics
| Contrôle ou état | Ce qui se passe après l'utilisation |
| --- | --- |
| **Ouvrir l'éditeur de code** | Ouvre la boîte de dialogue **Éditeur de code** en pleine hauteur. La fermeture de la boîte de dialogue ramène le panneau Vitrine à l'aperçu. |
| Icône Fichiers | Affiche l'arborescence des fichiers de vitrine consultable. L'expansion d'un dossier charge son contenu ; la sélection d'un fichier l'ouvre dans un onglet. |
| Onglet Fichier | Bascule l'éditeur vers ce fichier ouvert. Un point orange signifie que l'onglet contient des modifications non enregistrées. |
| Icône Fermer sur un onglet de fichier | Ferme cet onglet. Runner ne demande pas les modifications non enregistrées, alors enregistrez d'abord. |
| Éditeur de code | Vous permet de modifier le fichier actif. La saisie modifie l'onglet ouvert mais n'enregistre pas le fichier automatiquement. |
| **Commande-S** sur macOS ou **Contrôle-S** sur Windows/Linux | Enregistre le fichier actif dans l'espace de travail du projet connecté. L'indicateur non enregistré orange disparaît après le succès. |
| Icône de branche Git | Ouvre la branche actuelle, les listes de fichiers modifiés, le formulaire de validation et les contrôles d'envoi. La sélection d'un fichier modifié ouvre sa différence. |
| **Mettre en scène** / **Retirer de la scène** | Ajoute ou supprime un fichier de la prochaine validation. Cela n'enregistre pas un onglet d'éditeur non enregistré. |
| **Tout indexer** / **Tout désindexer** | Applique le même choix de mise en scène à chaque fichier dans la liste correspondante. Examinez la liste avant d'utiliser l'une ou l'autre action. |
| **Message de commit** | Enregistre l'explication qui sera attachée à la prochaine validation. |
| **Valider** | Crée une validation à partir des fichiers mis en scène quand le message n'est pas vide. Les modifications non mises en scène et non enregistrées restent en dehors de cette validation. |
| **Pousser** | Envoie immédiatement les validations qui sont en avance sur le dépôt distant configuré. Il n'y a pas de deuxième confirmation dans ce panneau. |
| **Actualiser** | Demande le dernier état Git pour l'espace de travail du projet connecté. |
## Apporter et vérifier une modification ciblée
1. Confirmez le nom du projet et la vitrine actuelle dans l'aperçu.
2. Sélectionnez **Ouvrir l'éditeur de code**.
3. Gardez la vue Fichiers ouverte, développez le dossier requis et sélectionnez un fichier.
4. Lisez le contenu existant avant de le modifier.
5. Apportez la plus petite modification prévue.
6. Appuyez sur **Commande-S** ou **Contrôle-S** et confirmez que le point orange disparaît.
7. Rouvrez le fichier pour confirmer le contenu enregistré, puis fermez l'éditeur de code et examinez la page concernée dans Aperçu.
8. Vérifiez les mises en page de bureau et mobile quand la modification peut affecter l'une ou l'autre.
9. Si le résultat est incorrect, retournez à l'éditeur et corrigez-le, ou demandez à Runner de réparer le fichier spécifique et le problème visible.
L'enregistrement prouve uniquement que Runner a écrit le fichier. L'aperçu prouve uniquement que le projet actuel peut l'afficher. La publication et le parcours client en direct restent des vérifications séparées.
## Valider et envoyer uniquement si nécessaire
1. Enregistrez chaque fichier que vous avez l'intention d'inclure.
2. Ouvrez la vue de branche Git.
3. Sélectionnez chaque fichier modifié et examinez sa différence.
4. Utilisez **Mettre en scène** pour les fichiers prévus. Évitez **Tout indexer** quand des modifications non liées sont présentes.
5. Entrez un **Message de commit** clair.
6. Sélectionnez **Valider** et attendez que l'état Git se rafraîchisse.
7. Utilisez **Pousser** uniquement après avoir confirmé la branche et le flux de travail distant. L'action démarre immédiatement.
8. Retournez à l'aperçu et vérifiez le résultat visible. Une validation ou un envoi réussi ne publie pas la vitrine.
## Dépannage
| État | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| **Ouvrir l'éditeur de code** est manquant | La fonctionnalité n'est pas activée pour ce projet. | Utilisez le mode de conception ou demandez à Runner d'apporter la modification. Ne vous fiez pas à un itinéraire interne copié. |
| **Connexion au sandbox...** | L'espace de travail du projet n'est pas encore connecté. | Gardez le projet ouvert et réessayez après la reconnexion de l'espace de travail. |
| Indicateur de chargement de l'arborescence des fichiers | Runner charge le dossier actuel. | Attendez avant de sélectionner un autre dossier à plusieurs reprises. |
| La sélection d'un fichier ne fait rien | Le fichier n'a pas pu être lu ou l'espace de travail s'est déconnecté. | Vérifiez la connexion, puis sélectionnez le fichier une fois de plus. |
| Le point orange persiste après l'enregistrement | Le fichier n'a pas été enregistré avec succès. | Gardez l'onglet ouvert, lisez le message d'erreur et réessayez après la reconnexion si nécessaire. |
| **Ouvrir un fichier depuis l'arborescence** | Aucun fichier n'est actif. | Sélectionnez un fichier dans la vue Fichiers. |
| **Aucune modification** | Git ne signale pas les modifications de fichier enregistrées. | Enregistrez l'onglet de l'éditeur, puis sélectionnez **Actualiser**. |
| **Valider** est désactivé | Aucun fichier mis en scène ou aucun message de validation n'est présent. | Mettez en scène le fichier prévu enregistré et entrez un message. |
| **Pousser** est désactivé | La branche n'a pas de validation locale en avance sur le dépôt distant, ou un envoi est en cours. | Validez la modification prévue ou attendez l'envoi actuel. |
| **Échec du chargement du statut git** | Runner n'a pas pu lire l'état du dépôt. | Sélectionnez **Réessayer**. Ne mettez pas en scène ou n'envoyez pas jusqu'à ce que l'état se charge. |
| Le nombre de flèches vers le bas indique que la branche est en retard | Le dépôt distant contient des validations non présentes dans l'espace de travail. | Arrêtez avant d'envoyer et demandez au propriétaire du projet comment mettre à jour la branche en toute sécurité. |
| Erreur d'enregistrement, de mise en scène, de validation ou d'envoi | L'action ne s'est pas terminée. | Conservez l'état actuel, lisez l'erreur et réessayez uniquement après avoir vérifié la connexion et la permission. |
## Guides connexes
- [Prévisualiser votre magasin](./preview-your-store)
- [Utiliser le mode de conception](./design-mode)
- [Utiliser l'historique des versions](./version-history)
- [Publier et republier](./publish-and-republish)
- [Dépanner l'aperçu et la publication](./troubleshoot-preview-and-publishing)
---
# Vérifier le magasin en direct et le paiement
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/live-store-and-checkout
**Chemin d'accès :** Après une publication réussie, utilisez l'URL publique ou **Voir la boutique** quand la remise l'offre. Sur le bureau, quand le menu du site publié est affiché, ouvrez **Boutique en ligne** → menu du site publié → **Voir le site**. La barre d'outils Vitrine mobile actuelle masque ce menu.
## Ce que couvre ce guide
Prouvez qu'un client peut ouvrir le magasin public, trouver un vrai produit, ajouter une option disponible au panier et atteindre un paiement utilisable, sans traiter un message de publication réussi comme une preuve de tout le parcours.
## Pourquoi et quand vérifier le parcours en direct
Exécutez cette vérification après la première publication et après les modifications des produits, de la navigation, de la tarification, de l'inventaire, de l'expédition, des paiements ou du paiement. Les quatre résultats sont indépendants :
1. la vitrine peut être publique ;
2. le catalogue prévu peut être manquant ou obsolète ;
3. le panier peut échouer même quand une page de produit se charge ; et
4. le paiement peut être en pause même quand la vitrine est en direct.
## Disponibilité et conditions préalables
- Une publication terminée doit fournir une URL publique.
- Au moins un produit prévu doit être actif, visible, tarifé et disponible pour la région que vous testez.
- La configuration de l'expédition ou de la livraison doit couvrir la destination du test si nécessaire.
- Pour un magasin Runner natif, Stripe doit être connecté si vous attendez que les clients paient. Les magasins Shopify utilisent la caisse Shopify et sa configuration de paiement.
- Ne complétez pas un achat réel à moins que vous ne vouliez intentionnellement passer cette commande et comprendre l'impact des frais et de l'exécution.
## Ouvrir le magasin en direct
Utilisez l'un ou l'autre chemin :
1. Après la publication, sélectionnez **Voir la boutique** dans la remise ; ou
2. Sur le bureau quand affiché, sélectionnez le menu du site publié dans **Boutique en ligne**, puis sélectionnez **Voir le site** ; ou
3. Ouvrez la barre latérale **Paramètres → Store : _nom du magasin_ → Domaine** et sélectionnez l'adresse publiée, y compris sur mobile lorsque le menu Vitrine est masqué.
Le menu du site publié de bureau offre également **Copier l'URL** quand affiché, afin que vous puissiez tester la même adresse dans une autre session de navigateur.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Après publication, ouvrez le menu déroulant à côté de **Publier les modifications** : 1. Menu du site publié. 2. **Voir le site** ouvre le magasin en ligne ; **Copier l’URL** copie son adresse. 3. **Paramètres de domaine** ouvre la gestion des adresses. Cette image ne vérifie pas le paiement. Sélectionnez l’image pour l’agrandir. Les annotations utilisent l’interface de bureau en anglais.
## Contrôles et résultats du magasin en direct
Les étiquettes d'état Stripe ci-dessous s'appliquent aux magasins Runner natifs. Pour un magasin Shopify connecté, vérifiez la caisse Shopify séparément.
| Contrôle ou statut | Ce qui se passe |
| --- | --- |
| URL publiée | Ouvre la vitrine publique. Confirmez que l'adresse est celle que vous avez l'intention de partager. |
| **Voir la boutique** / **Voir le site** | Ouvre l'URL publique dans un nouvel onglet. C'est différent de **Ouvrir dans un nouvel onglet** à l'intérieur de l'aperçu. |
| **Copier** / **Copier l'URL** | Copie l'URL publique pour le partage ou un test de navigateur indépendant. |
| **Boutique en ligne** | Runner a trouvé une URL de magasin public que les clients peuvent parcourir et partager. Cela ne confirme pas le paiement. |
| **Vérification du paiement** | Runner vérifie si le magasin peut accepter les paiements. |
| **Paiement actif** | Runner a trouvé une connexion Stripe activée. Cela ne teste pas le produit sélectionné, la destination d'expédition, les champs de paiement ou l'étape de paiement ; vérifiez-les séparément. |
| **Paiement en pause** | La vitrine publique est consultable, mais les paiements ne sont pas disponibles jusqu'à ce que Stripe soit connecté. |
| **Statut du paiement indisponible** | Runner n'a pas pu déterminer l'état du paiement. Sélectionnez **Revérifier le statut du paiement** avant de prétendre que le paiement est prêt. |
| **Connecter Stripe** | Ouvre le chemin de connexion au paiement. Seul un propriétaire ou un administrateur d'espace de travail éligible peut le terminer. |
| **Ignorer pour l’instant** | Ferme l'invite sans activer les paiements. |
## Tester le parcours client
1. Ouvrez l'URL publique dans un nouvel onglet. Pour une vérification plus forte, utilisez une session déconnectée ou une session de navigation privée.
2. Confirmez que la page d'accueil attendue se charge sans contrôles de projet Runner.
3. Suivez la navigation publique vers une collection ou une page de produit.
4. Confirmez que le produit prévu est visible avec le titre, les médias, le prix et les options disponibles corrects.
5. Choisissez toute option requise, comme la taille ou la couleur.
6. Sélectionnez le contrôle d'ajout au panier de la vitrine et confirmez que le nombre de panier ou le contenu du panier change.
7. Ouvrez le panier. Confirmez que le produit, l'option, la quantité, le prix et les totaux correspondent à ce que vous avez sélectionné.
8. Démarrez le paiement et confirmez que la page de paiement accepte les informations client et de livraison requises.
9. Confirmez que l'étape de paiement est disponible si Runner signale **Paiement actif**.
10. Arrêtez avant l'action d'achat final à moins qu'une commande de test réelle soit autorisée.
11. Répétez les étapes de navigation et de panier principales sur une fenêtre d'affichage de taille téléphone ou un navigateur mobile réel.
## Enregistrer chaque résultat séparément
| Vérification | Condition de réussite |
| --- | --- |
| URL publique | S'ouvre sans portail d'accès ou état de page manquante. |
| Navigation | Les liens importants atteignent les pages publiques prévues. |
| Catalogue | Le produit en direct prévu et ses données actuelles sont visibles. |
| Panier | L'ajout d'une option disponible produit l'état de panier correct. |
| Expédition | La destination prévue a un chemin de livraison attendu le cas échéant. |
| Commander | La caisse prévue atteint son étape de paiement. Le statut de paiement natif Runner ou la configuration Shopify confirme également un fournisseur activé. |
| Mobile | Le contenu important et les contrôles d'achat restent utilisables sur un petit écran. |
## États, limites et dépannage
| Ce que vous voyez | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| L'aperçu fonctionne mais l'URL publique échoue | L'aperçu et la publication sont des environnements ou des versions différents. | Retournez à Runner, vérifiez l'état de la publication et utilisez **Republier** uniquement après avoir corrigé le problème nommé. |
| Le site public se charge mais le produit est manquant | La vitrine est en direct, mais le catalogue prévu n'y est pas visible. | Vérifiez l'état du produit, le marché, l'inventaire et si les dernières modifications ont été publiées. |
| L'ajout au panier est manquant ou désactivé | Le produit ou l'option choisi peut ne pas être vendable dans ce contexte. | Vérifiez la disponibilité, les options, le prix, le stock et la configuration du marché dans les opérations du magasin. |
| **Paiement en pause** | Les paiements ne sont pas connectés. | Sélectionnez **Connecter Stripe** ; ne faites pas la publicité du magasin comme prêt pour les commandes. |
| **Statut du paiement indisponible** | Runner ne peut pas confirmer l'état du paiement. | Sélectionnez **Revérifier le statut du paiement** et ouvrez indépendamment le chemin de paiement. |
| Le paiement s'ouvre mais ne peut pas continuer | Le produit, l'expédition, le marché, les champs client ou la configuration du paiement peuvent être incomplets. | Enregistrez l'étape et le message exacts, corrigez cette configuration, publiez les modifications si nécessaire et retestez à partir de l'URL publique. |
## Guides connexes
- [Publier et republier](./publish-and-republish)
- [Préparer la publication](./prepare-to-publish)
- [Dépanner l'aperçu et la publication](./troubleshoot-preview-and-publishing)
---
# Préparer la publication
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/prepare-to-publish
**Chemin d'entrée :** Espace de travail → sélectionnez un magasin → **Boutique en ligne** → **Publier**, **Publier les modifications** ou **Republier** (l'étiquette dépend de l'état de publication) → **Confirmer le Déploiement**
Lorsque les cartes de version de conversation conditionnelle sont activées, **Publier** sur une carte de travail **Version actuelle** non publiée ouvre les mêmes vérifications de publication. Les cartes de version historique ne publient pas directement.
## Ce que couvre ce guide
Atteindre une vérification de publication réussie avec les détails du magasin que vous avez l'intention de lancer, ou prendre une décision éclairée concernant toute configuration incomplète que Runner vous demande de reconnaître.
## Pourquoi et quand préparer
Utilisez cette liste de contrôle avant la première **Publier** et avant les **Publier les modifications** importantes. Cela réduit le risque de lancer une page soignée sans produit vendable, expédition incomplète, paiements en pause ou compilation échouée.
Runner peut parfois vous permettre de publier après avoir reconnu une configuration incomplète. C'est une exception délibérée, pas une preuve que le magasin est prêt à recevoir des commandes.
Les vérifications exactes et la transmission dépendent de l'expérience de publication activée pour l'espace de travail. Certains espaces de travail affichent un avertissement de paiement avant la publication et un message de réussite après ; d'autres affichent les vérifications des opérations du magasin avant la publication et l'état du paiement après la publication. Suivez les libellés affichés dans votre flux.
## Disponibilité et conditions préalables
- Vous avez besoin d'un projet avec un aperçu de magasin prêt.
- La publication dépend des droits du forfait et de l'accès au projet. Si Runner demande un autre forfait, comparez les [forfaits publics](https://www.runnerai.com/pricing) et choisissez un forfait admissible avant de revenir à ce parcours.
- L'espace de travail du magasin doit être connecté et Runner doit être inactif.
- La disponibilité du magasin varie selon l'entreprise. Runner peut vérifier les bases du magasin, les produits, les détails d'expédition ou de stock, la connexion de paiement, les modifications détectées et si le magasin se compile.
## Ouvrir le flux de disponibilité
1. Ouvrez votre projet et sélectionnez **Boutique en ligne**.
2. Examinez la dernière version **Actuel**.
3. Sélectionnez **Publier**, **Publier les modifications** ou **Republier**, selon le libellé affiché.
4. Runner vérifie l'accès, actualise les modifications détectées et l'état de configuration, puis ouvre **Confirmer le Déploiement**.
## Contrôles de préparation
| Contrôle | Quand il apparaît | Ce qui se passe quand vous le sélectionnez |
| --- | --- | --- |
| **Ouvrir Opérations de la boutique** | La confirmation indique que la configuration du magasin est incomplète. | Runner ferme la confirmation et ouvre les opérations du magasin. |
| **Revérifier la configuration** | Runner n'a pas pu vérifier les opérations du magasin. | Runner vérifie à nouveau l'état de la configuration. |
| **Relancer la vérification** | Runner n'a pas pu atteindre l'espace de travail du magasin. | Runner réexécute la vérification de compilation de publication. |
| **Corriger avec l'IA** | La vérification de compilation du magasin échoue et Runner peut la réparer. | Runner ferme la confirmation et envoie l'erreur de compilation dans la conversation pour réparation. Aucune publication ne commence. |
| Case de confirmation d'un avertissement | Selon le parcours de publication, des opérations de magasin incomplètes ou indisponibles, ou l'absence de connexion de paiement, nécessitent une acceptation explicite. L'absence de modifications reste bloquante. | Cocher la case confirme que vous comprenez le risque indiqué ; cela peut activer **Confirmer** après une vérification de compilation réussie. |
| **Annuler** | Vous n'êtes pas prêt à continuer. | Runner ferme la confirmation sans publier. |
| **Confirmer** | La vérification de compilation a réussi et les avertissements requis ont été résolus ou reconnus. | Runner démarre la publication. Le bouton reste désactivé tant que les vérifications sont incomplètes ou que Runner travaille. |
## Remplir la liste de contrôle de lancement
1. Dans l'aperçu, vérifiez la page d'accueil, la navigation, la page produit, l'entrée du panier et la mise en page téléphone.
2. Ouvrez les opérations du magasin et confirmez que les détails commerciaux et du magasin affichés y sont corrects.
3. Confirmez qu'au moins un produit prévu est visible, vendable et utilise le prix, les options et les médias corrects.
4. Confirmez l'emplacement du stock et la configuration d'expédition nécessaires pour ce produit.
5. Décidez si le paiement doit accepter les paiements au lancement. Pour une boutique native Runner, connectez Stripe si les paiements doivent être acceptés. Les magasins Shopify conservent la caisse dans Shopify ; vérifiez la configuration de paiement de cette boutique. Certains espaces de travail affichent cet avertissement avant la publication et d'autres signalent l'état d'extraction par la suite ; ni l’un ni l’autre ne remplace le test de paiement.
6. Retournez à **Boutique en ligne** et sélectionnez le bouton de publication.
7. Attendez **Votre boutique est prête à publier !**
8. Résolvez chaque avertissement. Utilisez une reconnaissance uniquement quand vous acceptez son impact client exact.
9. Si vous souhaitez uniquement inspecter l'état de préparation, sélectionnez **Annuler**. Sélectionnez **Confirmer** uniquement lorsque vous comptez mettre cette version en ligne.
10. Après la publication, vérifiez séparément le magasin en direct, le catalogue, le panier et le paiement.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
La construction est réussie dans cet exemple, mais la configuration du magasin nécessite encore une attention particulière. Un accusé de réception ne termine pas cette configuration.
### Vidéo : examiner les vérifications et annuler
L'enregistrement examine le résultat de la construction et l'avertissement de configuration, puis sélectionne **Annuler**. Il ne publie pas l'exemple de magasin.
## États de disponibilité et dépannage
| Ce que vous voyez | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| **Vérification de la disponibilité de votre magasin pour la publication…** | Runner vérifie la compilation du magasin actuelle. | Attendez la réussite ou un échec nommé. |
| **Votre boutique est prête à publier !** | La vérification de compilation a réussi. | Résolvez les avertissements, puis sélectionnez **Confirmer**. |
| **Votre boutique ne peut pas encore être compilée, elle ne peut donc pas être mise en ligne. Laissez Runner corriger les erreurs, puis publiez.** | La vitrine ne peut pas être publiée sous sa forme actuelle. | Sélectionnez **Corriger avec l'IA**, examinez la réparation et redémarrez le flux de préparation. |
| **Nous n'avons pas pu accéder à votre espace de travail. Relancez la vérification pour continuer.** | La vérification n'a pas pu accéder à l'espace de travail actuel. | Sélectionnez **Relancer la vérification**. Si cela se répète, reconnectez l'espace de travail. |
| **Apportez une modification visible à votre boutique avant de la publier.** | Runner n’a trouvé aucun changement depuis la dernière publication. | Annulez et effectuez la modification de vitrine souhaitée. **Confirmer** reste désactivé lorsqu’il n’y a aucune modification à publier. |
| **Quelques détails d’exploitation demandent encore votre attention. Vous pouvez passer en ligne maintenant et les terminer dans Opérations de la boutique.** | Des détails opérationnels importants restent inachevés. | Sélectionnez **Ouvrir Opérations de la boutique**. Publiez avec accusé de réception uniquement si vous acceptez les limitations. |
| **Impossible de vérifier Opérations de la boutique. Réessayez, ou confirmez et publiez quand même.** | L'état de l'installation n'est pas disponible, pas nécessairement terminé. | Sélectionnez **Revérifier la configuration** avant d’envisager l’accusé de réception. |
| **Les acheteurs peuvent parcourir la boutique mais pas encore payer : connectez Stripe dans les Paramètres pour recevoir des commandes.** | Dans les flux de publication qui affichent cet avertissement avant le lancement, Runner n'a pas trouvé de connexion de paiement activée. | Connectez Stripe ou accusez réception uniquement si un lancement en navigation uniquement est intentionnel. D’autres flux signalent plutôt l’état de paiement après la publication. |
## Guides connexes
- [Aperçu de votre magasin](./preview-your-store)
- [Publier et republier](./publish-and-republish)
- [Vérifier le magasin en direct et le paiement](./live-store-and-checkout)
---
# Prévisualiser votre magasin
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/preview-your-store
**Chemin d'accès :** Espace de travail → sélectionnez un magasin → **Boutique en ligne**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
## Ce que couvre ce guide
Examinez la vitrine actuelle dans Runner, déplacez-vous entre ses pages et vérifiez comment elle s'affiche sur les mises en page de bureau, tablette et téléphone sans la publier.
## Pourquoi et quand utiliser l'aperçu
Utilisez l'aperçu après que Runner a créé ou modifié la vitrine. C'est l'endroit le plus sûr pour repérer le texte manquant, les routes rompues, les mauvaises mises en page mobiles ou les sections inachevées avant que les clients ne les voient.
L'aperçu est distinct du magasin publié. Une page qui semble correcte ici ne prouve pas que l'URL publique, les données du catalogue, l'inventaire, la connexion au service de paiement ou le paiement fonctionnent.
## Disponibilité et conditions préalables
- Ouvrez un projet avec une activité de vitrine existante ou une version prévisualisable.
- Si la page indique **Dites à Runner à quoi votre boutique en ligne doit ressembler.**, utilisez le champ de cette page pour demander à Runner de construire la première version.
- Si elle dit **Construction de la première version de votre boutique…** ou **Préparation de l'aperçu…**, l'aperçu n'est pas encore prêt.
- Certains espaces de travail utilisent la vitrine plus récente basée sur les points de contrôle. Les contrôles de version exacts peuvent varier avec la disponibilité échelonnée.
Quand les cartes de version conditionnelles sont activées dans la conversation, sélectionner l'image de la vitrine ou **Aperçu** sur une carte de travail terminée ouvre précisément la version prête créée par cette tâche. Il peut s'agir d'une version historique plutôt que de la plus récente. Pour un ancien projet sans historique de version enregistré, **Aperçu** sur la carte de travail de vitrine la plus récente ouvre à la place l'aperçu actuel en direct. Vérifiez les étiquettes **v…**, **Version actuelle** et **Publié** lorsqu'elles sont disponibles, avant toute modification ou publication.
Une tâche terminée ou une compilation réussie du code source ne signifie pas à elle seule que l'aperçu a été mis à jour. Runner promeut la vitrine terminée une fois la tâche achevée. Si cette promotion échoue, l'aperçu conserve la dernière version promue avec succès — ou n'affiche aucun aperçu généré s'il n'en existe pas encore — ; confirmez donc la version visible et le résultat de l'aperçu.
## Ouvrir l'aperçu
1. Ouvrez votre espace de travail Runner.
2. Sélectionnez le magasin que vous voulez examiner.
3. Sélectionnez **Boutique en ligne** dans la navigation du projet.
4. Attendez que la version actuelle apparaisse dans la zone d'aperçu.
### Voir la commande d'appareil en action
Cet enregistrement silencieux montre l'aperçu original de la v1 dans l'interface anglaise. Sélectionnez **PC**, puis **Tablette**, puis **Téléphone** pour modifier le cadre d'aperçu. Sélectionnez à nouveau **Téléphone** pour revenir au bureau. La vitrine reste non publiée tout au long de cet exemple.
Si le projet n'a pas encore de vitrine :
1. Saisissez votre demande dans le champ de description de la vitrine. Décrivez l'apparence, la mise en page, les produits et le contenu souhaités.
2. Sélectionnez la flèche d'envoi (**Envoyer le message**), ou **Commencer à créer** si cette action apparaît dans votre espace de travail.
3. Runner crée une conversation et envoie cette description comme première demande.
4. Si la création échoue, la description reste dans le champ pour que vous puissiez réessayer.
## Contrôles d'aperçu
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe quand vous le sélectionnez |
| --- | --- | --- |
| **Retour** | Retournez à la page précédente visitée dans l'aperçu. | L'aperçu se déplace vers l'arrière dans son propre historique de page. Il ne quitte pas votre projet Runner. |
| **Avancer** | Revisitez une page après être allé en arrière. | L'aperçu avance quand une entrée d'historique ultérieure existe. |
| **PC / Tablette / Téléphone** | Vérifiez les mises en page réactives. | Chaque sélection fait défiler le cadre d'aperçu à la taille d'appareil suivante. Il ne modifie pas la vitrine en direct. |
| Champ de chemin, tel que `/` | Ouvrez une route de vitrine connue. | Sélectionnez le chemin, entrez un autre chemin sur le même site d'aperçu et appuyez sur **Entrée**. Les adresses invalides ou externes sont ignorées. |
| **Actualiser** | Rechargez l'aperçu actuel après une modification ou un rendu bloqué. | Runner recharge la page visible et efface la sélection du mode de conception actif et la session d'annulation/rétablissement. Enregistrez d'abord les modifications de conception en attente. |
| **Ouvrir dans un nouvel onglet** | Examinez l'aperçu avec plus d'espace. | Runner ouvre cette URL d'aperçu dans un autre onglet du navigateur. C'est toujours un aperçu, pas la preuve d'un magasin publié. |
| Étiquette de version, telle que **v1 · Actuel** | Identifiez ce que vous examinez. | L'étiquette distingue la version actuelle la plus récente d'un aperçu historique. |
| **Mode Design** | Commencez l'édition visuelle. | Runner ouvre l'espace de travail de conception quand la version la plus récente est admissible. |
| **Historique des versions** | Comparez les versions de vitrine antérieures. | Runner ouvre la liste des versions sans modifier la vitrine actuelle. |
| **Ouvrir l'éditeur de code** | Inspectez ou modifiez la source de la vitrine quand ce contrôle avancé est disponible. | Runner ouvre le dialogue **Éditeur de code** pleine hauteur. Le fermer retourne le panneau Vitrine à l'aperçu ; vérifiez le résultat visible là. |
| Pièce / **Inviter des amis** | Ouvrez l'offre de parrainage. | Runner ouvre le dialogue de parrainage ; aucun crédit n'est gagné simplement en l'ouvrant. |
| Nombre de crédits / **Mettre à niveau** | Examinez les options de crédit, de plan ou d'utilisation. | Runner ouvre une fenêtre contextuelle dont les actions disponibles peuvent mener à la facturation ou à l'utilisation de l'espace de travail. |
| **Publier**, **Publier les modifications** ou **Republier** | Commencez le flux de publication approprié à l'état actuel. | Runner exécute les vérifications d'accès et de disponibilité avant le début de toute publication. |
## Examiner une page de vitrine page par page
1. Commencez à `/` et scannez l'en-tête, la zone d'annonce, le héros, les produits en vedette, les sections et le pied de page.
2. Sélectionnez chaque lien de navigation visible. Confirmez que la destination apparaît et que le chemin d'aperçu change comme prévu.
3. Ouvrez une page de produit à partir de la vitrine. Confirmez que son titre, ses médias, son prix, ses options, sa disponibilité et son contrôle d'achat sont visibles.
4. Utilisez le champ de chemin pour les routes importantes qui ne sont pas liées à partir de la page actuelle.
5. Faites défiler **PC**, **Tablette** et **Téléphone**. Recherchez le contenu coupé, les contrôles qui se chevauchent, le texte illisible et le défilement horizontal.
6. Sélectionnez **Actualiser** uniquement après avoir enregistré les modifications du mode de conception.
7. Enregistrez tout problème dans le chat Runner avec le chemin de la page, la taille de l'appareil et le résultat attendu.
## États, limites et dépannage
| Ce que vous voyez | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| **Dites à Runner à quoi votre boutique en ligne doit ressembler.** | Runner n'a aucune vitrine prête à afficher. | Saisissez une demande pour créer la première version. |
| **Construction de la première version…** | La première version est toujours en cours de préparation. | Suivez la progression des tâches et attendez qu'elles atteignent un état final. |
| **Préparation de l'aperçu…** | Runner démarre l'aperçu sélectionné. | Gardez la page ouverte ; utilisez **Actualiser** uniquement si l'état cesse de progresser. |
| **Impossible de charger l'aperçu pour cette version** | La version sélectionnée n'a pas pu être affichée. | Retournez à la version actuelle, actualisez ou signalez la version et l'erreur à Runner. |
| **Reconnexion de l'aperçu** | Runner a perdu la connexion d'aperçu et réessaye. | Gardez le projet ouvert et suivez le nombre de tentatives. S'il ne peut pas récupérer, reconnectez l'espace de travail. |
| Barre d'erreur d'aperçu avec **Correction** | L'aperçu a signalé une erreur que Runner peut inspecter. | Sélectionnez **Correction** ou **Corriger l'erreur** pour envoyer le diagnostic affiché à Runner. Utilisez **Afficher plus** pour développer les détails et **Fermer** uniquement pour masquer le message. |
| Un contrôle est désactivé | L'aperçu ne prend pas actuellement en charge cette action, l'espace de travail est déconnecté ou Runner est encore en cours d'exécution. | Attendez que Runner termine, reconnectez l'espace de travail si vous y êtes invité, ou revenez à la version prête la plus récente. |
| L'aperçu semble correct, mais pas le magasin publié | Les modifications n'ont pas été publiées ou vous consultez des versions différentes. | Vérifiez l'étiquette de version, puis utilisez [Publier les modifications](./publish-and-republish). |
## Guides connexes
- [Créer votre premier magasin, étape par étape](../start-here/first-store-quickstart)
- [Utilisez le mode de conception](./design-mode)
- [Modifier le contenu, les pages et les médias](./edit-content-pages-and-media)
- [Inspectez et modifiez le code de la vitrine](./inspect-and-edit-code)
- [Utilisez l'historique des versions](./version-history)
- [Préparez-vous à publier](./prepare-to-publish)
---
# Publier et republier
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/publish-and-republish
**Chemin d'accès :** Espace de travail → sélectionner un magasin → **Magasin** → **Publier**, **Publier les modifications** ou **Republier** (le libellé dépend de l'état de la publication)
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
## Ce que couvre ce guide
Utilisez l'action de publication que Runner affiche pour l'état du magasin actuel, suivez la confirmation jusqu'à un résultat terminal et ouvrez ou copiez l'URL publique quand une est disponible.
## Pourquoi et quand publier
La publication rend la version du projet actuelle disponible à une URL de magasin publique. Utilisez **Publier** pour le premier lancement, **Publier les modifications** pour un magasin qui a déjà une URL publique saine et **Republier** pour réessayer un résultat de publication échoué ou incomplet.
Enregistrer une modification du mode de conception, restaurer une version ou voir un aperçu correct ne met pas à jour le magasin public par lui-même.
Le parcours post-publication dépend de la variante déployée dans l'espace de travail. Certains espaces de travail affichent un avertissement relatif au paiement avant la publication, puis uniquement une notification de réussite ; d'autres affichent les vérifications des opérations du magasin avant la publication, puis ouvrent un écran post-publication indiquant l'état du paiement.
## Disponibilité et conditions préalables
- Complétez la [liste de contrôle de disponibilité de publication](./prepare-to-publish).
- Utilisez la dernière version **Actuelle** du magasin.
- Attendez que Runner termine toute demande active.
- Reconnectez l'espace de travail du magasin si le bouton indique qu'il est indisponible.
- La publication peut être restreinte par votre plan ou l'admissibilité du projet.
- Lorsque la publication nécessite un plan supérieur, **Mettre à niveau** ouvre la confirmation mensuelle Plus. Vous pouvez revenir de cette confirmation à la liste complète des plans avant l'achat.
## Ouvrir le flux de publication
1. Ouvrez votre projet.
2. Sélectionnez **Magasin**.
3. Sélectionnez le bouton de publication sur le côté droit de la barre d'outils.
4. Lisez **Confirmer le Déploiement** et attendez la vérification de compilation.
5. Résolvez les éléments bloquants. Acceptez un avertissement uniquement si la boîte de dialogue le permet et si vous en comprenez l'effet.
6. Sélectionnez **Confirmer** uniquement lorsque le bouton est actif et que vous souhaitez rendre cette version publique. Sélectionnez **Annuler** pour quitter sans publier.
### Vidéo : examiner les vérifications sans publier
Cette vidéo sans son, avec l'interface en anglais, montre le résultat de compilation et l'avertissement de configuration restant. **Annuler** ramène à l'aperçu. Une vérification de compilation réussie ne termine pas la configuration des opérations du magasin et n'active pas le paiement.
## Choisir l'action correcte
| Libellé | Quand Runner l'affiche | Ce que le sélectionner fait |
| --- | --- | --- |
| **Publier** | Le magasin n'a pas complété sa première publication. | Ouvre les vérifications d'accès, de configuration, de modification et de compilation pour la version actuelle. |
| **Publier les modifications** | Une publication complétée a une URL publique utilisable. | Ouvre les mêmes vérifications pour que vous puissiez envoyer la version actuelle au magasin en direct existant. |
| **Republier** | La dernière publication a échoué ou s'est terminée sans URL utilisable. | Démarre une nouvelle tentative de publication avec les vérifications nécessaires. |
| **Démarrage… / Préparation… / Compilation… / Enregistrement du point de contrôle… / Publication…** | Une étape de publication est en cours. | Le bouton est désactivé et signale la progression. Attendez la réussite ou l'échec. |
## Contrôles de publication et de suivi post-publication
| Contrôle | Ce qui se passe quand vous le sélectionnez |
| --- | --- |
| **Annuler** dans **Confirmer le Déploiement** | Ferme la boîte de dialogue sans publier cette version. |
| **Corriger avec l'IA** | Envoie un échec de compilation à Runner pour réparation, sans publier. |
| **Réessayer la vérification** | Réexécute la vérification de compilation après un échec d'accès à l'espace de travail. |
| **Confirmer** | Démarre la publication une fois la vérification de compilation et les confirmations requises terminées. |
| **Publier quand même : je terminerai la configuration plus tard.**, lorsque cette option est proposée | Confirme que vous acceptez la configuration incomplète indiquée. Cette action ne termine pas ces tâches et ne publie pas le magasin tant que vous ne sélectionnez pas aussi Confirmer. |
| URL publiée | Ouvre le magasin public dans un nouvel onglet. |
| **Copier** ou **Copier l'URL** | Copie l'adresse du magasin public dans votre presse-papiers. |
| **Afficher le magasin** | Dans l'écran post-publication sur l'état du paiement, ouvre le magasin public après une publication réussie. |
| **Connecter Stripe** | Dans les flux qui affichent l'état du paiement, démarre la connexion de paiement quand le paiement n'est pas prêt. L'accès peut dépendre de votre rôle dans l'espace de travail. |
| **Ignorer pour l'instant** | Ferme l'invite de paiement affichée après la publication. Le magasin peut rester consultable pendant que les paiements en ligne restent suspendus. |
| **Réessayer l'état du paiement** | Dans l'écran post-publication, vérifie à nouveau si une connexion Stripe est activée lorsque l'état n'a pas pu être obtenu. |
| **Fermer** | Ferme l'écran post-publication lorsqu'il est affiché et que le paiement est déjà configuré. |
| Menu du site publié | Sur le bureau quand il est affiché, ouvre **Afficher le site**, **Copier l'URL**, **Paramètres de domaine** et les dernières informations publiées. |
## Publier jusqu'à un résultat terminal
1. Confirmez que le libellé du bouton correspond à votre intention.
2. Sélectionnez-le et attendez la fin de la vérification de compilation.
3. Si **Corriger avec l'IA** apparaît, utilisez-le, examinez l'aperçu résultant et recommencez la publication.
4. Si des avertissements apparaissent, corrigez la configuration sous-jacente chaque fois que le paiement ou les opérations normales du magasin importent.
5. Sélectionnez **Confirmer**.
6. Gardez le projet ouvert jusqu'à ce que Runner signale la réussite ou l'échec.
7. En cas de réussite, ouvrez l'URL publique. Utilisez **Afficher le magasin** lorsque l'écran post-publication sur l'état du paiement apparaît ; selon la variante déployée, seule une notification de réussite peut s'afficher avant le retour à **Magasin**.
8. Si l'URL n'est pas disponible, fermez l'écran post-publication et utilisez **Republier** une fois l'espace de travail prêt.
9. Si la publication échoue, lisez l'échec, réparez-le et sélectionnez **Republier**. Ne supposez pas que les modifications tentées sont déjà en ligne.
## États de publication et dépannage
| Ce que vous voyez | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| **Magasin publié** / **Votre magasin est en direct** | Runner a complété la publication et a une URL publique. | Ouvrez l'URL et vérifiez le parcours client. |
| **Publication complète** avec **Lien du magasin indisponible** | La publication s'est terminée sans fournir de lien utilisable dans l'écran post-publication. | Fermez la boîte de dialogue, assurez-vous que l'espace de travail est prêt, puis utilisez **Republier**. |
| **La publication du magasin a échoué** | La tentative de publication n'a pas été complétée. | Examinez l'erreur ou demandez à Runner de la corriger, puis utilisez **Republier**. |
| **Votre magasin n'a pas pu être compilé** | Le projet actuel a échoué avant la publication. | Sélectionnez **Corriger avec l'IA** et ne réessayez pas le travail inchangé. |
| Le bouton indique **Reconnectez le bac à sable pour publier** | Runner ne peut pas atteindre l'espace de travail du magasin. | Reconnectez-le, puis réexécutez les vérifications. |
| Le bouton indique **Attendez que Runner finisse** | Une demande est toujours active. | Attendez son résultat terminal avant de publier. |
| **Aucune modification** ou **Confirmer** désactivé | Il n'y a aucune nouvelle modification enregistrée, une compilation est incomplète, une tâche IA est active ou une vérification obligatoire reste à résoudre. | Terminez l'élément affiché. Aucune modification est un état bloquant, pas un avertissement que vous pouvez accepter pour continuer. |
| Le magasin public affiche une version plus ancienne | Les dernières modifications du projet n'ont pas été publiées avec succès. | Vérifiez la version actuelle, puis utilisez **Publier les modifications** et vérifiez à nouveau. |
## Guides connexes
- [Créer votre premier magasin, étape par étape](../start-here/first-store-quickstart)
- [Préparer la publication](./prepare-to-publish)
- [Vérifier le magasin en direct et le paiement](./live-store-and-checkout)
- [Connecter un domaine personnalisé](./custom-domains)
---
# Dépanner l'aperçu et la publication
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/troubleshoot-preview-and-publishing
**Chemin d'accès :** Espace de travail → sélectionner un magasin → **Boutique en ligne** → reproduire l'état d'aperçu ou de publication affiché à l'écran
## Ce que couvre ce guide
Identifiez quelle couche échoue—version du projet, aperçu, vérification de compilation, publication, catalogue public, paiement ou domaine—et prenez la plus petite action de récupération sûre.
## Pourquoi cette distinction importe
Le parcours du magasin a plusieurs couches indépendantes. Répéter **Publier** ne peut pas corriger les données de produit manquantes et actualiser l'aperçu ne peut pas réparer une connexion de paiement. Commencez par le message exact et la surface qui a échoué.
## Disponibilité et conditions préalables
- Gardez le projet ouvert et notez le libellé de version actuelle.
- Enregistrez le chemin exact de la page ou l'URL publique et si elle a échoué dans l'aperçu ou sur le magasin en direct.
- Attendez que le travail actif de Runner atteigne **Terminée**, **Échec** ou **Arrêté** avant de commencer une action de récupération conflictuelle.
- Ne supprimez pas les domaines, ne restaurez pas les versions ou ne répétez pas les actions payantes juste pour tester une théorie.
## Trouver la couche défaillante
1. Dans **Boutique en ligne**, vérifiez si une version actuelle existe.
2. Confirmez si l'aperçu normal s'ouvre.
3. Si vous publiez, lisez le résultat de la vérification de compilation avant de sélectionner une autre action.
4. Si la publication réussit, ouvrez l'URL publique plutôt que l'URL d'aperçu.
5. Sur le magasin public, testez le catalogue et le panier.
6. Vérifiez l'état du paiement de Runner et le chemin de paiement réel.
7. Si seule l'adresse personnalisée échoue, vérifiez les paramètres de domaine en dernier.
## Contrôles de récupération importants
| Contrôle | Ce qui se passe quand il est sélectionné |
| --- | --- |
| **Actualiser** dans l'aperçu | Recharge l'aperçu actuel et efface la sélection du mode de conception active et la session d'annulation/rétablissement. Enregistrez d'abord les modifications directes en attente. |
| **Correction** / **Corriger l'erreur** | Envoie le diagnostic d'aperçu affiché à Runner comme demande de réparation. **Fermer** masque uniquement le message. |
| **Corriger avec l'IA** | Ferme la confirmation de publication et envoie son échec de compilation à Runner pour réparation ; la publication ne commence pas. |
| **Relancer la vérification** | Réexécute la vérification de compilation du magasin après que Runner n'a pas pu atteindre l'espace de travail. |
| **Ouvrir Opérations de la boutique** | Ferme la confirmation de publication et ouvre les opérations du magasin pour que vous puissiez compléter la configuration nommée. |
| **Revérifier la configuration** | Vérifie à nouveau la disponibilité des opérations du magasin après que son statut était indisponible. |
| **Republier** | Démarre une tentative de publication vérifiée et nouvelle après un résultat échoué ou sans lien. Corrigez d'abord la cause nommée. |
| **Revérifier le statut du paiement** | Vérifie à nouveau une connexion de paiement activée ; cela ne teste pas un produit, l'expédition ou le formulaire de paiement. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Une vérification de compilation réussie peut apparaître à côté d’un avertissement de configuration. Lisez les deux avant de décider si le magasin est prêt.
## Référence état-à-action
| Message ou symptôme | Couche | Ce que cela signifie | Action de récupération la plus sûre |
| --- | --- | --- | --- |
| Pas de version vitrine prête | Version du projet | Aucune version prévisualisable n'existe. | Demandez à Runner de construire la première vitrine. |
| **Compilation de la première version…** | Version du projet | Runner la crée toujours. | Suivez la progression de la tâche ; ne publiez pas encore. |
| **Échec de la compilation** sur une version | Version du projet | Cette version n'est pas prête. | Ouvrez les détails de la tâche et demandez à Runner de réparer l'échec. |
| **Préparation de l'aperçu…** | Aperçu | Runner démarre l'aperçu sélectionné. | Gardez la dernière version sélectionnée ; actualisez uniquement si la progression s'arrête. |
| **Impossible de charger l'aperçu pour cette version** | Aperçu | La version sélectionnée n'a pas pu être affichée. | Retournez à la version actuelle, actualisez ou essayez une autre version prête. |
| **Reconnexion de l'aperçu** | Aperçu | Runner a perdu la connexion d'aperçu et réessaie. | Suivez le nombre de tentatives ; reconnectez l'espace de travail si la récupération échoue. |
| Barre d'erreur d'aperçu avec **Correction** | Aperçu | La page en cours d'exécution a signalé un diagnostic que Runner peut utiliser. | Sélectionnez **Afficher plus** pour l'inspecter, **Correction** ou **Corriger l'erreur** pour l'envoyer à Runner, ou **Fermer** uniquement pour masquer la barre. |
| **Page non trouvée** | Route d'aperçu ou publique | Le chemin n'existe pas dans cette version. | Retournez à `/`, utilisez la navigation visible et demandez à Runner de créer ou réparer la route. |
| **Le mode de conception n'a pas démarré** | Mode de conception | L'aperçu modifiable n'est pas devenu prêt. | Sélectionnez **Réessayer** ou retournez à l'aperçu actuel et actualisez. |
| **Vous pourrez de nouveau modifier visuellement une fois que Runner aura terminé.** | Mode conception | Runner traite une autre demande. | Attendez que Runner ait terminé. |
| **Impossible de charger vos versions ; réessayez.** | Historique des versions | La demande de liste des versions a échoué. | Sélectionnez **Réessayer**. |
| La restauration est bloquée | Historique des versions | Runner est actif ou la version n'est pas prête. | Attendez Runner, puis choisissez une version prête. |
| **Nous n'avons pas pu accéder à votre espace de travail. Relancez la vérification pour continuer.** | Contrôle de publication | Runner n'a pas pu exécuter la vérification de compilation. | Sélectionnez **Relancer la vérification** ; reconnectez l’espace de travail si cela se répète. |
| **Votre boutique ne peut pas encore être compilée, elle ne peut donc pas être mise en ligne. Laissez Runner corriger les erreurs, puis publiez.** | Contrôle de publication | La vitrine actuelle ne peut pas réussir la version. | Sélectionnez **Corriger avec l'IA**, examinez la réparation, puis réexécutez les vérifications. |
| **Quelques détails d’exploitation demandent encore votre attention. Vous pouvez passer en ligne maintenant et les terminer dans Opérations de la boutique.** | Configuration de la publication | Les opérations importantes du magasin restent inachevées. | Sélectionnez **Ouvrir Opérations de la boutique**. Reconnaissez seulement si la limitation est intentionnelle. |
| **Impossible de vérifier Opérations de la boutique. Réessayez, ou confirmez et publiez quand même.** | Configuration de la publication | L'état de l'installation est inconnu. | Sélectionnez **Revérifier la configuration** avant d’envisager un accusé de réception. |
| **Apportez une modification visible à votre boutique avant de la publier.** | Modifications des publications | Runner n'a rien trouvé de nouveau depuis la dernière publication. | Annulez et effectuez d’abord la modification souhaitée. **Confirmer** est désactivé lorsqu’il n’y a aucune modification à publier. |
| **Les acheteurs peuvent parcourir la boutique mais pas encore payer : connectez Stripe dans les Paramètres pour recevoir des commandes.** | Configuration du paiement | Certains flux de publication l'affichent avant le lancement lorsqu'aucune connexion de paiement activée n'est trouvée. | Pour un magasin Runner natif, connectez Stripe ; utilisez l'accusé de réception uniquement pour un lancement intentionnel en navigation uniquement. D'autres flux signalent l'état de paiement après la publication. |
| **Échec de la publication** | Publication | La tentative n'a pas été complétée. | Réparez le problème nommé, puis sélectionnez **Republier**. |
| **Lien de la boutique indisponible** avec **Republier** | Transmission de publication | La tentative s'est terminée sans un lien utilisable dans Runner. | Fermez la boîte de dialogue, confirmez que l'espace de travail est prêt, puis sélectionnez **Publier les modifications**. |
| Le magasin public affiche du contenu ancien | Publication ou version | Les modifications du projet actuel ne sont pas en direct. | Confirmez la dernière version actuelle, sélectionnez **Paiement en pause** et rouvrez l'URL publique. |
| Produit manquant sur le magasin public | Catalogue | La publication a réussi, mais le produit prévu n'est pas visible. | Vérifiez l'état du produit, le marché, le prix et l'inventaire ; publiez les modifications si nécessaire. |
| L'action du panier est manquante ou désactivée | Catalogue ou disponibilité | L'élément sélectionné ne peut pas actuellement être ajouté. | Vérifiez les options requises, la disponibilité, le stock, le prix et la région. |
| **Connecter Stripe** | Paiement | Le flux post-publication n'a pas trouvé de connexion Stripe activée. | Sélectionnez **Statut du paiement indisponible**, puis testez à nouveau le chemin de paiement réel. |
| **Revérifier le statut du paiement** | État du paiement | Runner ne peut pas confirmer la disponibilité du paiement. | Sélectionnez **Réessayer l'état du paiement** et testez le paiement public indépendamment. |
| Le domaine personnalisé possédé affiche un avertissement rouge et un tableau **J’ai ajouté les enregistrements** | Domaine | La vérification de configuration actuelle du fournisseur n'a pas encore réussi. | Copiez exactement les valeurs affichées chez votre fournisseur. Runner vérifie de nouveau automatiquement tant que les Paramètres de domaine restent ouverts ; il n'existe pas de bouton de vérification manuelle. |
| **Transfert en cours** | Domaine | Un domaine se déplace entre les magasins. | Ne commencez pas un autre transfert ; suivez l'état affiché. |
## Confirmer la récupération
Revenez à la même page, version et taille de périphérique qui ont échoué. Répétez une fois la plus petite étape ayant échoué. Vérifiez son résultat visible : un aperçu prêt, une publication réussie avec la page attendue à l'URL publique, un panier correct ou un domaine fonctionnel. Enregistrez séparément toute étape qui échoue toujours.
## Signaler un problème à Runner
Incluez ces détails dans un message :
1. le chemin exact de la page ou l'URL publique ;
2. si elle a échoué dans l'aperçu ou sur le magasin en direct ;
3. le libellé de version actuelle ;
4. le texte d'erreur ou d'état exact ;
5. le dernier bouton que vous avez sélectionné ;
6. le résultat attendu ; et
7. si le problème se reproduit après l'action de réessai documentée.
Pour un problème visuel, incluez la mise en page de l'appareil et une capture d'écran. Pour le paiement, arrêtez avant une charge réelle et signalez la dernière étape réussie.
## Limites de récupération
- Ne reprenez pas ou ne republiiez pas à plusieurs reprises un état échoué inchangé. Corrigez d'abord la cause nommée.
- Ne restaurez pas une version plus ancienne pendant que Runner travaille.
- Ne supprimez pas un domaine pour corriger un problème de magasin ou de paiement.
- Ne réclamez pas le succès du lancement jusqu'à ce que l'URL publique, le catalogue prévu, le panier et l'étape de paiement requise aient chacun été vérifiés.
## Guides connexes
- [Aperçu de votre magasin](./preview-your-store)
- [Préparer la publication](./prepare-to-publish)
- [Publier et republier](./publish-and-republish)
- [Vérifier le magasin en direct et le paiement](./live-store-and-checkout)
- [Connecter un domaine personnalisé](./custom-domains)
---
# Utiliser l'historique des versions
Source: https://www.runnerai.com/docs/fr/guides/storefront-and-publishing/version-history
**Chemin d'accès :** Espace de travail → sélectionnez un magasin → **Boutique en ligne** → **Historique des versions** (icône d’horloge avec une flèche)
## Ce que couvre ce guide
Comparez les versions de la vitrine, prévisualisez une version antérieure prête et, si nécessaire, restaurez son contenu en tant que nouvelle version actuelle tout en conservant l'historique existant.
## Pourquoi et quand utiliser l'historique des versions
Utilisez l'historique des versions lorsque vous devez comprendre ce qui a changé, examiner une conception antérieure ou récupérer du contenu qui était meilleur avant une demande récente. La prévisualisation est en lecture seule. La restauration modifie le projet, alors examinez d'abord la confirmation.
## Disponibilité et conditions préalables
- Ouvrez un projet avec au moins une version de vitrine.
- L'aperçu historique et la restauration ne sont disponibles que pour les versions que Runner peut charger avec succès.
- Attendez que Runner termine une demande active avant de restaurer.
- L'historique des versions est conditionnel dans les espaces de travail utilisant l'expérience de vitrine basée sur les points de contrôle.
- Certaines cartes de travail de conversation terminées affichent également une étiquette de version conditionnelle, un aperçu de version exacte et une action **Publier** pour une version actuelle non publiée. Ces cartes sont un accès rapide ; cette page reste la vue complète de comparaison et de restauration.
## Ouvrir l'historique des versions
Ouvrez le magasin que vous souhaitez examiner, puis suivez les repères numérotés ci-dessous.
1. **Sélectionnez Vitrine dans la barre latérale gauche.** L’aperçu de votre magasin s’ouvre. Si la barre latérale n’affiche que des icônes, développez-la à l’aide du bouton situé dans le coin supérieur gauche.
2. **Cliquez sur l’icône d’horloge avec une flèche au-dessus de l’aperçu, près du coin supérieur droit.** Il s’agit de **Historique des versions**. Survolez l’icône pour voir son nom. Dans l’exemple, elle se trouve juste à gauche de l’adresse du site publié et de **Publier les modifications**.
3. **Vérifiez que le panneau Historique des versions s’ouvre à droite.** La version la plus récente apparaît sous **Version actuelle**. Faites défiler vers le bas pour consulter les versions antérieures, si votre magasin en possède. Sélectionnez **Retour** (la flèche gauche à côté du titre du panneau) pour le fermer.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsx1z1nuaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Sélectionnez l’image pour l’agrandir. Les vues annotées sur ordinateur montrent où cliquer. Ouvrir l’historique ne restaure ni ne publie rien. Si un magasin ne possède qu’une seule version enregistrée, seule **Version actuelle** s’affiche.
**Sur un téléphone :** ouvrez **Boutique en ligne**, touchez **Plus d’actions** (**…**) à côté du bouton de publication en bas de l’écran, puis touchez **Historique des versions**.
Si la commande d’historique n’est pas visible, quittez **Mode Design** ou revenez d’abord à l’aperçu le plus récent. Attendez la fin de la compilation initiale. La disponibilité peut aussi dépendre de l’expérience de vitrine de votre espace de travail.
### Exemple avec une version antérieure
Les captures de cette page montrent l'interface en anglais.
Comparez les étiquettes avant de choisir une version. Cet exemple ouvre uniquement l'historique ; il ne restaure ni ne publie de version.
## Contrôles de l'historique des versions
| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsque vous le sélectionnez |
| --- | --- | --- |
| **Retour** | Quittez la liste des versions. | Runner revient à la vue de la vitrine. |
| Capture d'écran de la version | Inspectez l'apparence capturée. | La capture d'écran s'ouvre dans une visionneuse d'images plus grande si disponible. |
| **Voir le diff complet** | Consultez un enregistrement détaillé de ce qui a changé. | Runner ouvre les détails des modifications pour cette version dans un nouvel onglet. |
| **Aperçu** / **Aperçu de cette version** | Examinez une version antérieure prête sans la restaurer. | La vitrine bascule vers un aperçu historique temporaire étiqueté **Aperçu de v…**. La dernière version du projet et le magasin en direct ne changent pas. |
| **Retour au plus récent** / **Retour à la version actuelle** | Terminez un aperçu historique. | Runner recharge la dernière version actuelle de la vitrine. |
| **Restaurer** | Réutilisez le contenu d'une version antérieure. | Runner ouvre **Restaurer vers v…?**. La confirmation crée une nouvelle dernière version avec ce contenu ; la version sélectionnée, les versions plus récentes et l'historique restent. |
| **Plus d’actions** | Accédez aux actions de carte sur les mises en page compactes. | Un menu s'ouvre avec les actions disponibles pour cette version, telles que Aperçu, Restaurer ou Afficher le diff complet. |
| **Publier** sur la version actuelle | Commencez à publier la dernière version. | Runner ouvre les vérifications de publication. Il ne publie pas directement un aperçu historique. |
## Lire les cartes de version
| Étiquette ou état | Signification |
| --- | --- |
| **Dernière** ou **Version actuelle** | C'est la version de projet la plus récente. |
| **Publié** | Cette version est associée à une publication terminée. Cela ne prouve pas que le paiement fonctionne maintenant. |
| **Compilation…** | Runner crée toujours la version. L'aperçu et la restauration peuvent ne pas être disponibles. |
| **Échec de la compilation** | Cette version n'a pas atteint un état prêt. Utilisez son contexte d'erreur pour demander à Runner de corriger. |
| Nombres de changements de fichiers | Un résumé des fichiers ajoutés, modifiés ou supprimés pour cette version. |
| Heure | Quand la version a été enregistrée. |
| Description | Le résumé enregistré de la version si disponible. |
## Aperçu et restauration en toute sécurité
1. Sélectionnez **Aperçu** sur la version que vous souhaitez inspecter.
2. Confirmez que la barre d'outils indique **Aperçu de v…** pour ne pas la confondre avec la dernière version.
3. Vérifiez la mise en page pertinente et les appareils.
4. Sélectionnez **Retour au plus récent** si vous aviez seulement besoin de comparer.
5. Pour récupérer le contenu plus ancien, sélectionnez **Restaurer**.
6. Lisez la confirmation : Runner ajoutera une nouvelle version et conservera l'historique existant.
7. Confirmez la restauration uniquement lorsque Runner est inactif.
8. Confirmez qu'un nouveau **Version actuelle** apparaît, puis examinez le contenu restauré dans Aperçu avant de le publier. L’historique plus ancien devrait toujours être disponible.
## États, limites et dépannage
| Ce que vous voyez | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| **Pas encore d'historique des versions** | Seul l'état de démarrage actuel existe, ou aucun historique n'est disponible. | Continuez à travailler ; revenez après que Runner ait enregistré une autre version. |
| **Chargement de l'historique des versions…** | Runner récupère les cartes. | Gardez le panneau ouvert jusqu'à ce qu'il se termine. |
| **Échec du chargement de l'historique des versions** | La demande de liste a échoué. | Sélectionnez **Réessayer**. |
| **Échec du chargement de l'aperçu pour cette version** | Cet aperçu historique n'a pas pu démarrer. | Revenez à la version actuelle et essayez une autre version prête. |
| La restauration est désactivée | Runner est actif ou la version n'est pas restaurable. | Attendez que Runner se termine ou sélectionnez une version prête. |
| **Impossible de restaurer pendant que l'agent travaille** | La restauration entrerait en conflit avec la tâche active. | Laissez la tâche atteindre un état terminal, puis réessayez. |
| Le contenu restauré n'est pas en direct | La restauration a créé une version de projet, pas une publication. | Examinez-la, puis sélectionnez **Publier les modifications**. |
## Guides connexes
- [Prévisualisez votre magasin](./preview-your-store)
- [Publier et republier](./publish-and-republish)
- [Dépannage de l'aperçu et de la publication](./troubleshoot-preview-and-publishing)
---
# Cas d’usage
Source: https://www.runnerai.com/docs/fr/guides/use-cases
Vous êtes nouveau sur le Runner ? Suivez d'abord [Créez votre première boutique](/fr/guides/start-here/first-store-quickstart), puis choisissez le résultat dont vous avez besoin ci-dessous.
## Explorer par objectif
- [Vitrine et publication](/fr/guides/storefront-and-publishing)
Prévisualisez, modifiez, versionnez, publiez et vérifiez votre vitrine Runner.
- [Opérations de la boutique](/fr/guides/store-operations)
Configurez et gérez le catalogue, les commandes, les clients, les promotions, l'approvisionnement et les avis de votre magasin.
- [Applications et intégrations](/fr/guides/apps-and-integrations)
Trouvez, connectez et gérez les services que votre magasin Runner et Agent peuvent utiliser.
- [Analyses et SEO](/fr/guides/analytics-and-seo)
Lisez la performance du magasin, diagnostiquez la conversion et améliorez la façon dont les personnes et les outils de recherche IA trouvent votre vitrine.
- [Automatiser, tester et créer](/fr/guides/automate-test-and-create)
Utilisez les outils conditionnels de Runner pour les travaux récurrents, les tests de clients, les expériences, la génération de médias et la publicité.
- [Personnalisation de l'agent](/fr/guides/agent)
Ajoutez des compétences réutilisables et une mémoire de confiance pour que Runner puisse travailler d'une manière qui convient à votre magasin.
---
# Travailler avec Runner
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner
**Ce que couvre ce guide :** Vous saurez où démarrer une demande, comment guider le travail et où examiner le résultat.
Utilisez cette section après avoir ouvert un projet de magasin. Runner garde la demande, la progression,
l'aperçu et les outils de projet connexes ensemble pour que vous puissiez passer d'une idée à un résultat examinable.
**Chemin d'entrée :** Ouvrez le magasin souhaité à partir du menu Nom du magasin → ouvrez sa tâche actuelle ou sélectionnez **Nouvelle tâche**.
## La boucle quotidienne
1. Ouvrez le magasin que vous souhaitez modifier.
2. Démarrez un **Nouvelle tâche** lorsque le travail nécessite une conversation séparée.
3. Décrivez un seul résultat clair dans la boîte de message.
4. Ajoutez une image de référence, choisissez un profil ou ajoutez une compétence lorsque cela aidera.
5. Sélectionnez **Envoyer le message** et suivez l'état de la tâche.
6. Répondez à toute question que Runner pose pour qu'il puisse continuer avec le bon choix.
7. Ouvrez **Détails**, l'aperçu ou un autre onglet de canevas de travail pour examiner le résultat.
8. Envoyez un suivi ciblé si quelque chose nécessite un ajustement. Terminez en vérifiant que l’action client demandée fonctionne dans la page ou l’outil résultant.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Lorsqu'une tâche nécessite votre décision, répondez à sa carte active avant d'attendre plus de travail. Le [guide des questions](/fr/guides/work-with-runner/answer-runner-questions) comprend l'enregistrement correspondant.
## Choisir un guide
| Ce que vous voulez faire | Guide |
| --- | --- |
| Démarrer une demande et comprendre le compositeur | [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner) |
| Rouvrir, renommer ou supprimer une conversation | [Chats et historique](/fr/guides/work-with-runner/chats-and-history) |
| Trouver un outil de projet ou un chat récent | [Navigation et recherche du projet](/fr/guides/work-with-runner/project-navigation-and-search) |
| Donner à Runner une direction plus claire | [Rédiger des demandes efficaces](/fr/guides/work-with-runner/write-effective-requests) |
| Ajouter du contexte ou modifier la façon dont Runner aborde une tâche | [Images, modèles et compétences](/fr/guides/work-with-runner/attachments-profiles-and-skills) |
| Répondre lorsque Runner a besoin d'une décision | [Quand Runner pose une question](/fr/guides/work-with-runner/answer-runner-questions) |
| Comprendre la progression et inspecter le travail terminé | [États des tâches et détails](/fr/guides/work-with-runner/task-states-and-details) |
| Ajouter rapidement une compétence ou une mémoire | [Palette de commandes Agent](/fr/guides/agent/command-palette) |
## Avant de commencer
- Vous devez être connecté et avoir accès à un projet de magasin.
- Un chat nouvellement créé est vierge jusqu'à ce que vous envoyiez un message.
- Certains outils, profils, compétences et destinations de navigation sont conditionnels. Runner affiche uniquement
ce qui est disponible pour le compte et le projet actuels.
- La publication, la facturation et les actions destructrices nécessitent leurs propres chemins de confirmation. Une tâche de chat terminée ne signifie pas par elle-même qu'un magasin a été publié ou qu'une action externe s'est produite.
## Guides connexes
- [Construire votre premier magasin](/fr/guides/start-here/first-store-quickstart)
- [Gérer les magasins](/fr/guides/workspace/manage-stores)
- [Comprendre les statuts des magasins](/fr/guides/workspace/store-statuses)
---
# Quand Runner pose une question
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/answer-runner-questions
**Ce que couvre ce guide :** Vous répondrez aux questions de Runner ou les ignorerez intentionnellement sans perdre le contexte de la tâche.
Runner pose une question lorsque votre décision peut modifier matériellement le résultat. Les questions peuvent utiliser un choix unique, plusieurs choix ou une réponse en texte libre.
**Chemin d'accès :** Ouvrez une conversation dont l'état de la tâche attend une entrée → carte de question.
## Avant de commencer
- Répondez à la question active la plus récente ; les cartes plus anciennes peuvent être en lecture seule.
- Examinez attentivement l'effet lorsqu'un choix implique l'accès, l'argent, la publication, les données des clients ou un service externe.
- Utilisez **Ignorer** uniquement lorsque Runner peut choisir en toute sécurité sans votre préférence.
## Contrôles des questions
| Contrôle ou état | Ce qui se passe |
| --- | --- |
| Une option à choix unique | Sélectionne la réponse et peut passer à la question suivante. Le choix final peut envoyer les réponses automatiquement. |
| Options à choix multiples | Vous permet de sélectionner plus d'une réponse autorisée. |
| **Autre…** | Ouvre un champ pour une réponse qui n'est pas listée. |
| Soumettre ou continuer l'action, lorsque cela est affiché | Avance la carte ou envoie les réponses complétées. |
| **Ignorer**, lorsqu'il est offert | Demande à Runner de procéder en utilisant son meilleur jugement. |
| Carte désactivée | La tâche est occupée, expirée, arrêtée, ou la question ne peut plus accepter de réponse. |
## Répondre à une question
1. Lisez la question et toute explication au-dessus des choix.
2. Lisez chaque choix avant de le sélectionner : un seul choix peut avancer immédiatement et la réponse finale peut être soumise automatiquement.
3. Sélectionnez le ou les choix qui correspondent à votre intention.
4. Choisissez **Autre…** et entrez une réponse concise lorsqu'aucun des choix listés ne convient.
5. Utilisez l’action Continuer ou Soumettre uniquement si la carte en affiche une.
6. Attendez pendant que Runner fournit les réponses.
7. Confirmez que Runner reprend la tâche et enregistre votre réponse dans la conversation.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Lisez chaque choix avant de le sélectionner ; la réponse finale peut être envoyée automatiquement.
### Vidéo : répondez aux questions complémentaires
L'exemple sélectionne un prix de bougie et une direction de photographie. **Réponse** confirme les choix, puis Runner reprend la tâche.
## Ignorer lorsque Runner peut décider
1. Lisez ce que Runner demande.
2. Si la carte propose **Ignorer**, sélectionnez-la uniquement lorsque vous êtes à l'aise avec Runner en utilisant votre meilleur jugement.
3. Regardez la tâche reprendre.
4. Examinez le résultat de près, car vous n'avez pas fourni la préférence manquante.
Ignorer est utile pour les choix de présentation à faible risque. Donnez une réponse explicite lorsque la décision affecte l'accès, l'argent, la publication, les données des clients ou une action destructrice.
## Dépannage
| État | Signification | Ce qu'il faut faire |
| --- | --- | --- |
| En attente d'entrée | Runner ne peut pas continuer avec confiance sans une réponse. | Répondez ou ignorez intentionnellement la question active. |
| L'ancienne question est en lecture seule | Un nouveau message ou état de tâche l'a remplacée. | Répondez plutôt à la question active la plus récente. |
| **L'utilisateur a interrompu cette question** | La tâche a été arrêtée avant que la question ne soit complétée. | Commencez un nouveau message de suivi si vous souhaitez toujours que Runner continue. |
| Soumettre n'est pas disponible | Une ou plusieurs réponses requises sont incomplètes, ou la carte n'est plus active. | Complétez chaque question actuelle ou passez à la dernière carte de question. |
| Erreur de réponse | Runner n'a pas pu accepter la réponse. | La carte peut revenir à son état sans réponse. Gardez la conversation ouverte, vérifiez le dernier état de la tâche et répondez à nouveau uniquement lorsque la carte accepte l'entrée. |
## Guides connexes
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
- [Rédiger des demandes efficaces](/fr/guides/work-with-runner/write-effective-requests)
- [États et détails des tâches](/fr/guides/work-with-runner/task-states-and-details)
---
# APièces jointes, modèles et compétences
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/attachments-profiles-and-skills
**Ce que couvre ce guide :** Vous donnerez à Runner le bon contexte et les bons outils avant d'envoyer une demande.
Les images montrent à Runner ce que vous voulez dire. Les modèles et les compétences modifient les capacités disponibles pour
la prochaine demande. Lorsque **Joindre** apparaît, vous pouvez également donner comme contexte les documents pris en charge par Runner. Utilisez-les délibérément ; une demande claire reste l’apport le plus important.
**Chemin d'accès :** Ouvrez un projet de magasin → compositeur de conversation.
## Avant de commencer
- Utilisez uniquement les images que vous êtes autorisé à partager avec l'espace de travail actuel.
- Supprimez les secrets, les données de paiement et les informations client inutiles.
- Vérifiez l'accès selon le forfait et la compatibilité du navigateur lorsqu'un modèle, une compétence ou une action de capture d'écran manque.
## Contrôles du compositeur
| Contrôle | Ce qui se passe lorsque vous le sélectionnez |
| --- | --- |
| **Ajouter** | Sur le bureau, ouvre **Importer une image** ou **Joindre** lorsque les pièces jointes aux documents sont activées, plus **Prendre une capture d'écran** lorsqu'elles sont prises en charge. |
| **Joindre**, lorsqu'il est offert | Ouvre le sélecteur de documents et d'images pris en charge. |
| **Télécharger une image** | Ouvre le sélecteur d'images pour les fichiers JPG/JPEG, PNG, GIF, WebP, BMP ou TIFF. |
| **Depuis la bibliothèque multimédia**, lorsqu'il est offert | Ouvre le support de projet existant afin que vous puissiez choisir une référence pour le brouillon. |
| **Prendre une capture d'écran** | Démarre la capture d'écran lorsque le navigateur et le compte la prennent en charge. Le navigateur peut demander une permission. |
| **Image** sur mobile | Ouvre le sélecteur d'images mobile. Un flux de pièces jointes de documents activé affiche à la place **Joindre**. |
| Sélecteur de modèle | Liste les modèles Runner disponibles pour le compte. Un modèle verrouillé ouvre le chemin **Plan et Facturation** pertinent au lieu de le sélectionner. |
| **Commandes rapides** ou **Compétences** | Ouvre les raccourcis disponibles qui peuvent être ajoutés à la demande. |
| **Plus d'actions** | Révèle les outils du compositeur qui ne rentrent pas dans la disposition actuelle. |
Dans le sélecteur d'images uniquement, Runner ignore une image portant le même nom et la même taille qu'une image déjà présente dans le brouillon et affiche
**Image en double ignorée**. Les fichiers non pris en charge sont ignorés avec **Utilisez une image JPG, PNG, GIF, WebP, BMP
ou une image TIFF**. Dans une sélection mixte, les images prises en charge restent disponibles. Runner accepte jusqu'à 10 pièces jointes par message. Les images peuvent atteindre 32 Mo chacune. Lorsque les pièces jointes aux documents sont activées, les documents peuvent peser jusqu'à 10 Mo chacun.
Les captures et vidéos de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Les pièces jointes aux documents sont activées dans cet espace de travail. Le menu affiche donc **Joindre**. L'ouverture du menu ne télécharge pas de fichier ni n'envoie la demande.
## Ajouter une image
1. Rédigez suffisamment la demande pour expliquer pourquoi le fichier est important.
2. Sélectionnez **Ajouter** sur ordinateur ou **Image** sur mobile.
3. Choisissez **Télécharger une image**, **Image** ou **Prendre une capture d'écran**, selon ce qui s'affiche.
4. Choisissez ou capturez l'image pertinente.
5. Confirmez que la miniature d'image correcte apparaît avec le brouillon et que toute progression de téléchargement est terminée.
6. Supprimez-la avant d'envoyer si c'est la mauvaise référence.
7. Sélectionnez **Envoyer le message**.
Si la capture d'écran n'est pas disponible ou si la permission est refusée, prenez une capture d'écran avec votre appareil et
téléchargez l'image enregistrée à la place.
## Joindre un document lorsque cette option est disponible
1. Ouvrez **Ajouter** et sélectionnez **Joindre**. Si seul **Importer une image** ou **Image** apparaît, cet espace de travail ne prend pas en charge les documents dans ce composeur.
2. Choisissez un fichier pris en charge, tel qu'un PDF, un document Word, une présentation, une feuille de calcul ou un CSV.
3. Confirmez que la pièce jointe apparaît à côté de votre brouillon.
4. Indiquez à Runner ce qu'il doit utiliser, par exemple « Utilise les noms et descriptions de produits de ce CSV pour rédiger les textes de la collection ; ne modifie pas les prix. »
5. Sélectionnez **Envoyer le message** et attendez la fin de la préparation du document.
6. Vérifiez que la réponse de Runner reflète le document prévu avant de demander un changement de magasin.
Si le fichier ne peut pas être lu, suivez l'erreur affichée. Les documents protégés par mot de passe, endommagés, trop complexes ou vides peuvent échouer. Utilisez une exportation déverrouillée et plus petite ou collez le texte correspondant ; conservez votre brouillon jusqu’à ce que le remplacement soit accepté. Les vidéos ne sont pas prises en charge par ce flux de pièces jointes.
## Choisir un modèle
1. Sélectionnez le modèle actuel dans le compositeur.
2. Examinez les modèles que Runner met à disposition. L'interface enregistrée affiche **Runner 2.0 Pro** ; utilisez l'étiquette dans votre propre sélecteur car les profils disponibles peuvent changer.
3. Choisissez le modèle qui correspond à la tâche.
4. Confirmez que le modèle sélectionné s'affiche avant d'envoyer.
Si un modèle est verrouillé, conservez le modèle actuel ou suivez les informations de plan que Runner ouvre. Un
choix verrouillé n'est pas appliqué au brouillon.
## Ajouter une compétence
1. Ouvrez les **Commandes rapides** du compositeur ou le contrôle **Compétences** lorsqu'il est affiché.
2. Recherchez ou parcourez la capacité dont vous avez besoin.
3. Sélectionnez une compétence disponible pour cette demande. Les **commandes rapides** peuvent placer leur commande slash dans le compositeur, comme `/store-seo` ; le sélectionner n’exécute pas la commande.
4. Revenez au compositeur et confirmez que la compétence ou la commande slash prévue est présente. Ajoutez les instructions spécifiques à la tâche avant l'envoi.
5. Envoyer la demande.
La [palette de commandes Agent](../agent/command-palette) gère séparément l'état des capacités : sélectionner une ligne peut installer, activer ou mettre en pause une compétence. Cela diffère de la sélection d'une compétence dans le champ de rédaction.
Lorsque le plan actuel n'inclut pas une compétence, Runner peut ouvrir le chemin **Agent** ou de mise à niveau
à la place. Les choix de mémoire n'apparaissent que lorsque la mémoire est activée pour le compte.
La sélection d'une commande prépare le brouillon. Ajoutez votre demande et vérifiez-la avant de l'envoyer.
### Vidéo : préparer une commande rapide
L'enregistrement sélectionne **store-seo** dans le compositeur et ne l'envoie pas. Aucune analyse SEO ne démarre.
## Dépannage
| Problème | Que faire |
| --- | --- |
| L'image n'est pas ajoutée | Utilisez un format d'image pris en charge, gardez-la sous 32 Mo et limitez le message à 10 images ou moins. |
| **Image en double ignorée** | La même image avec le même nom et la même taille est déjà dans le brouillon. Conservez la copie existante ou supprimez-la avant de sélectionner l'image à nouveau. |
| Avertissement de fichier non pris en charge | Choisissez une image JPG/JPEG, PNG, GIF, WebP, BMP ou TIFF. Si **Joindre** est disponible, choisissez plutôt un document pris en charge. Sinon, utilisez une image ou collez le texte correspondant. |
| **Prendre une capture d'écran** manque | Utilisez une image enregistrée ; la capture en direct est conditionnelle. |
| La capture d'écran s'arrête | Autorisez la permission du navigateur le cas échéant, ou joignez une capture d'écran normale. |
| Une compétence ne bascule pas | Terminez toute action du compositeur en conflit et confirmez que le plan inclut la compétence. |
| Un modèle verrouillé ouvre la facturation | Fermez l'écran du plan pour conserver le modèle actuel, ou examinez l'accès avec le propriétaire de l'espace de travail. |
## Guides connexes
- [Rédiger des demandes efficaces](/fr/guides/work-with-runner/write-effective-requests)
- [Palette de commandes Agent](../agent/command-palette)
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
- [Paramètres de l'espace de travail](/fr/guides/workspace/settings)
---
# Discuter avec Runner
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/chat-with-runner
**Ce que couvre ce guide :** Vous enverrez une demande ciblée dans le bon projet de magasin et saurez ce que chaque contrôle de chat fait.
Le chat est le principal endroit pour demander à Runner de construire, modifier, inspecter ou expliquer quelque chose à propos de votre
magasin. Gardez un seul résultat principal dans chaque demande pour que le résultat soit plus facile à examiner.
**Chemin d'entrée :** Ouvrez le magasin souhaité à partir du menu Nom du magasin → utilisez la tâche en cours ou sélectionnez **Nouvelle tâche** dans la barre latérale.
## Avant de commencer
- Confirmez le magasin et la conversation avant d'envoyer une demande.
- Gardez un seul résultat principal dans le brouillon et supprimez les secrets ou données client inutiles.
- Attendez la fin d’une action de composition conflictuelle avant de sélectionner **Envoyer le message**.
## Contrôles de chat
| Contrôle | Pourquoi c'est utile | Ce qui se passe lorsque vous le sélectionnez |
| --- | --- | --- |
| **Nouvelle tâche** | Sépare une nouvelle tâche d'une discussion précédente. | Runner crée et ouvre une conversation vide. Aucun travail ne commence tant que vous n'avez pas envoyé un message. |
| Boîte de message | Contient la demande et toutes les instructions de suivi. | Votre texte reste un brouillon jusqu'à ce que vous l'envoyiez. |
| **Ajouter** | Donne le contexte visuel Runner. | Ouvre **Importer une image** ou, lorsque les pièces jointes aux documents sont activées, **Joindre**. **Prendre une capture d'écran** est conditionnel. Sur mobile, le sélecteur d'images uniquement est étiqueté **Image**. Consultez le guide des pièces jointes pour connaître les formats et les limites pris en charge. |
| Sélecteur de profil | Change le profil de travail Runner disponible. | Le profil sélectionné est utilisé pour la demande suivante ; les choix verrouillés ouvrent le chemin de plan pertinent. |
| **Saisie vocale** | Convertit la parole en texte de brouillon. | Demande l'accès au microphone, affiche **Écoute…**, puis **Traitement…**, et ajoute la transcription au brouillon actuel. Il n'envoie pas la demande. |
| **Plus d’actions** | Garde les outils moins fréquemment utilisés disponibles sur les petites dispositions. | Ouvre des actions telles que **Saisie vocale** ou **Améliorer le prompt** lorsqu'elles ne rentrent pas dans la barre d'outils. |
| **Envoyer le message** | Démarre la demande. | Votre message est ajouté à la conversation et la tâche commence. |
| **Arrêt** | Interrompt une tâche en cours. | Runner arrête le tour actuel et préserve la conversation pour que vous puissiez l'examiner ou la continuer plus tard. |
| **Utile** / **Pas utile** | Donnez votre avis sur une réponse de Runner. | Ouvre un avis modifiable. **Pas utile** exige une raison ou une description. Rien n'est enregistré avant **Soumettre** ; le partage du contexte de la conversation est facultatif. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Utilisez **Ajouter** lorsque la demande nécessite une référence. Le menu illustré est ouvert avant qu’un fichier ne soit téléchargé ou qu’un message ne soit envoyé.
## Envoyer une demande
1. Confirmez que le nom du projet dans la barre latérale ou l'en-tête est le magasin que vous avez l'intention de modifier.
2. Choisissez **Nouvelle tâche** si la demande est distincte de la conversation en cours.
3. Entrez le résultat que vous souhaitez dans la boîte de message.
4. Ajoutez un contexte important, des contraintes et des images de référence.
5. Sélectionnez un profil ou une compétence uniquement lorsque cela aide cette tâche.
6. Sélectionnez **Envoyer le message**.
7. Gardez la conversation ouverte pendant que Runner travaille, ou retournez-y à partir des **Discussions récentes** plus tard.
8. Si Runner pose une question, répondez-y pour laisser la tâche continuer.
9. Une fois la tâche terminée, ouvrez la page ou l'outil concerné et vérifiez le résultat que vous avez demandé. Un message final à lui seul ne vérifie pas le résultat.
## Rédiger avec entrée vocale
1. Sélectionnez **Saisie vocale**. Si le navigateur demande, autorisez l'accès au microphone uniquement sur un appareil de confiance.
2. Attendez **Écoute…**, puis prononcez une instruction ciblée.
3. Sélectionnez **Arrêter la saisie vocale** lorsque vous avez terminé.
4. Gardez le compositeur ouvert pendant que Runner affiche **Traitement…**.
5. Examinez le texte ajouté au brouillon. Runner l'ajoute après le texte qui était déjà présent.
6. Corrigez les noms, les numéros, les URL et les détails du produit avant de sélectionner **Envoyer le message**.
La saisie vocale prépare uniquement le texte. Aucune demande ne démarre tant que vous n'avez pas sélectionné **Envoyer le message**.
## Pendant que Runner travaille
- Une tâche en cours affiche la progression active dans la conversation.
- **Détails** ouvre l'enregistrement des tâches étape par étape lorsqu'il est disponible.
- **Arrêt** est disponible pendant le travail qui peut être interrompu.
- L'aperçu ou d'autres onglets de canevas peuvent se mettre à jour au fur et à mesure que Runner produit des résultats.
- Une tâche en attente d'entrée a besoin de votre réponse avant que Runner puisse continuer avec confiance.
## Dépannage
| Ce que vous voyez | Ce que cela signifie | Que faire |
| --- | --- | --- |
| **Envoyer le message** n'est pas disponible | Le brouillon est vide, les informations requises sont manquantes ou une autre action est toujours en cours de préparation. | Ajoutez une demande claire et attendez la fin de l'action du compositeur en cours. |
| Un profil est verrouillé | Il n'est pas inclus dans le plan actuel ou l'accès au compte. | Conservez le profil actuel ou suivez le chemin **Plan et Facturation** que Runner ouvre. |
| **Saisie vocale indisponible** | Le navigateur ou l'appareil ne peut pas enregistrer via ce contrôle. | Tapez la demande ou utilisez un navigateur et un appareil pris en charge. |
| Permission du microphone refusée | Le navigateur a bloqué l'enregistrement. | Autorisez l'accès uniquement si approprié, puis recommencez l'entrée vocale ; sinon, tapez la demande manquante. |
| **Aucune parole détectée** ou la transcription a échoué | Runner n'a pas ajouté de texte utilisable au brouillon. | Conservez le brouillon existant, vérifiez le microphone et réessayez une fois ou tapez le texte manquant. |
| La tâche attend | Runner a besoin d’une décision ou de plus d’informations. | Répondez à la question visible ou choisissez **Ignorer**, lorsqu'elle est proposée, si Runner doit faire preuve de son meilleur jugement. |
| La tâche a échoué | Runner n'a pas pu terminer le tour. | Lisez l'erreur et les **Détails**, puis choisissez **Réessayer** si cette option est proposée, ou envoyez une demande plus ciblée. |
| Vous avez ouvert le mauvais magasin | La conversation appartient à un autre projet. | Retournez à l'espace de travail, ouvrez le magasin prévu et démarrez la demande là. |
## Guides connexes
- [Rédiger des demandes efficaces](/fr/guides/work-with-runner/write-effective-requests)
- [Images, modèles et compétences](/fr/guides/work-with-runner/attachments-profiles-and-skills)
- [Quand Runner pose une question](/fr/guides/work-with-runner/answer-runner-questions)
- [États des tâches et détails](/fr/guides/work-with-runner/task-states-and-details)
---
# Chats et historique
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/chats-and-history
**Ce que couvre ce guide :** Vous garderez les conversations de projet organisées et rouvrirez le bon contexte lorsque vous en avez besoin.
Chaque magasin a son propre historique de conversation. Utilisez des chats séparés pour des résultats distincts, et gardez le travail de suivi dans le même chat lorsqu'il dépend de décisions antérieures.
**Chemin d'entrée :** Ouvrez un magasin → développez son historique des tâches dans la barre latérale. Selon l'espace de travail, la liste peut être étiquetée **Tâches de boutique** ou **Discussions récentes**. La recherche conserve l’en-tête de résultat **Discussions récentes**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Recherchez dans votre magasin ; 2. Démarrez une nouvelle tâche ; 3. Ouvrez un outil de l’espace de travail ; 4. Rouvrez une tâche enregistrée. Sélectionnez l’image pour l’agrandir. Les repères numérotés correspondent à l’interface de bureau en anglais.
## Avant de commencer
- Confirmez le magasin actuel car chaque projet a son propre historique de conversation.
- Laissez une action de renommage ou de tâche active se terminer avant de changer de conversations.
- Gardez un chat lorsque vous n'êtes pas sûr ; la suppression supprime le contexte et nécessite une confirmation.
## Contrôles de conversation
| Contrôle ou état | Ce qui se passe |
| --- | --- |
| **Nouvelle tâche** | Ouvre une conversation vide. Il ne démarre pas une tâche tant que vous n'envoyez pas de message. |
| Une ligne dans l'historique des tâches du magasin | Ouvre cette conversation et son historique de tâches enregistré. |
| Indicateur d'activité | Indique que la conversation a actuellement du travail en cours. |
| Point inactif | Indique que la conversation n'est pas actuellement en cours d'exécution. |
| Options de chat → **Renommer** | Ouvre une boîte de dialogue où vous pouvez entrer et enregistrer un nom de chat plus clair. |
| Options de chat → **Supprimer** | Ouvre une confirmation avant que la conversation ne soit supprimée. |
## Commencer ou rouvrir un chat
1. Ouvrez le projet de magasin correct.
2. Développez la barre latérale et ouvrez la liste des tâches du magasin lorsqu'elle est affichée.
3. Choisissez **Nouvelle tâche** pour une tâche sans rapport ou sélectionnez une discussion existante pour continuer son contexte.
4. Examinez le titre de la conversation et les derniers messages avant d'envoyer de nouvelles instructions.
5. Confirmez que les messages rouverts appartiennent à la tâche prévue. Saisissez la demande suivante et sélectionnez **Envoyer le message**.
## Renommer un chat
1. Retrouvez la conversation dans l'historique des tâches du magasin actuel.
2. Ouvrez son menu d'options.
3. Choisissez **Renommer**.
4. Entrez un nom qui décrit le résultat, tel que « Mettre à jour la page d'accueil de la collection d'été ».
5. Enregistrez la modification. Le nouveau nom apparaît dans la liste des chats récents.
## Supprimer un chat avec prudence
1. Ouvrez le menu d'options de la conversation.
2. Choisissez **Supprimer**.
3. Lisez la confirmation et vérifiez le nom du chat.
4. Annulez si vous avez toujours besoin de ses instructions ou résultats. Confirmez uniquement lorsque vous avez l'intention de le supprimer.
## Dépannage
| État | Ce qu'il faut faire |
| --- | --- |
| L'historique des tâches est vide ou absent | Envoyez une demande dans un nouveau chat. La section apparaît lorsque le projet a un historique des conversations. |
| Un chat en cours ne s'ouvre pas instantanément | Attendez que la navigation se termine ; Runner peut protéger le travail inachevé avant de changer de vues. |
| Vous ne trouvez pas un chat en scannant la liste | Ouvrez la recherche de projet avec `Command/Control + K` et recherchez **Discussions récentes**. |
| Un titre renommé ne s'est pas mis à jour | Rouvrez la liste des chats et réessayez le renommage une fois que la tâche actuelle s'est stabilisée. |
| Vous n'êtes pas sûr de supprimer | Gardez le chat. Le renommer est le moyen plus sûr de réduire la confusion. |
## Guides connexes
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
- [Navigation et recherche de projet](/fr/guides/work-with-runner/project-navigation-and-search)
- [États et détails des tâches](/fr/guides/work-with-runner/task-states-and-details)
---
# Navigation et recherche de projet
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/project-navigation-and-search
La barre latérale regroupe les outils en fonction du travail que vous souhaitez effectuer. La recherche trouve une destination disponible ou une conversation dans la boutique actuelle.
**Chemin d'entrée :** Ouvrez le magasin souhaité → développez la barre latérale → **Créer**, **Développer**, **Mesurer** ou **Rechercher**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Recherchez dans votre magasin ; 2. Démarrez une nouvelle tâche ; 3. Ouvrez un outil de l’espace de travail ; 4. Rouvrez une tâche enregistrée. Sélectionnez l’image pour l’agrandir. Les repères numérotés correspondent à l’interface de bureau en anglais.
## Avant de commencer
- Confirmez le nom du magasin avant de naviguer ou de démarrer une tâche.
- Enregistrez une copie d'un brouillon non envoyé avant de quitter sa conversation.
- La disponibilité de Tool varie selon le type de magasin, le forfait, le rôle et les fonctionnalités activées. Une entrée visible peut toujours ouvrir un écran de prérequis ou de plan.
## Trouver une destination
| Zone | Les destinations disponibles peuvent inclure | Utilisez-le pour |
| --- | --- | --- |
| **Boutique en ligne** | Aperçu, édition, historique des versions, publication | Examinez et mettez à jour ce que les clients voient. |
| **Créer** | **Opérations de la boutique**, **Dropshipping**, **Impression à la demande**, **Apps**, **Webhooks** | Configurez le magasin, le catalogue et les connexions. |
| **Développer** | **Publicités**, **SEO**, **E-mail**, **Automatisations**, **Studio**, **Médias** | Créez et gérez des travaux de croissance et des supports réutilisables. |
| **Mesurer** | **Analyses**, **Expériences**, **Simulation**, **Recherche** | Examinez les performances ou étudiez une question commerciale. |
| **Agent** | **Compétences**, **Mémoire** lorsqu'il est activé | Gérez les instructions réutilisables et les faits conservés. |
| **Fly**, lorsqu'il est affiché | Missions commerciales guidées | Suivez le workflow de mission disponible. |
1. Agrandissez le groupe qui correspond à votre objectif.
2. Sélectionnez la destination.
3. Confirmez son en-tête de page et sa boutique actuelle.
4. Suivez tout message de configuration ou de plan avant d'essayer la fonctionnalité.
Par exemple, **Dropshipping** peut ouvrir une expérience de sourcing dédiée ou la section Opérations de magasin associée, selon le magasin. Suivez la page que vous voyez réellement. La navigation groupée remplace l'ancien menu de débordement **Plus**.
## Rechercher des destinations et des tâches
**Raccourci :** `Command + K` sur macOS ou `Control + K` sur Windows et Linux.
1. Sélectionnez **Rechercher** ou utilisez le raccourci.
2. Entrez une partie d'un titre de destination ou de tâche.
3. Examinez les résultats sous **Centre de contrôle** et **Discussions récentes**.
4. Sélectionnez un résultat **Centre de contrôle** pour ouvrir un outil ou un résultat **Discussions récentes** pour rouvrir une conversation.
5. Confirmez que la page ou les messages prévus sont visibles avant de continuer.
6. Appuyez sur `Escape` pour fermer la recherche sans naviguer.
L'en-tête **Centre de contrôle** appartient aux résultats de recherche ; ce n'est pas une zone de barre latérale distincte que vous devez trouver.
## Passer à un autre magasin
1. Ouvrez le menu actuel du nom du magasin en haut de la barre latérale.
2. Sélectionnez le magasin souhaité.
3. Confirmez le nouveau nom du magasin après la navigation.
Le menu propose également **Créer un magasin** et **Paramètres de l'espace de travail**. Il ne prévisualise pas la liste des magasins d’un autre espace de travail. Voir [Navigation dans l'espace de travail](/fr/guides/workspace/navigation-and-search) pour les paramètres et la navigation dans le compte.
Les captures et vidéos de cette page montrent l'interface en anglais.
La recherche affiche les destinations disponibles sous **Centre de contrôle**. Sélectionnez un résultat pour naviguer ou appuyez sur Échap pour conserver la page actuelle.
### Vidéo : filtrer la recherche de navigation
L'enregistrement tape **Analyses** et inspecte la destination correspondante. Il s'arrête avant d'ouvrir le résultat ; sélectionnez vous-même un résultat pour naviguer.
## Dépannage
| Ce que vous voyez | Que faire |
| --- | --- |
| Chargement des résultats | Attendez que la recherche termine le chargement avant de sélectionner une ligne. |
| **Aucun résultat** | Raccourcissez la requête ou utilisez le nom visible de l'outil. Effacez la requête pour inspecter les résultats disponibles. |
| **Échec de la recherche** | Sélectionnez **Réessayer** lorsqu'il est affiché. |
| L'outil est absent de son groupe | Vérifiez Rechercher, puis lisez les prérequis de cette fonctionnalité. La disponibilité peut différer selon le magasin. |
| Pauses de navigation | Gardez la tâche ouverte et suivez tout message concernant le travail inachevé. |
| Un sélecteur de compétences s'ouvre à la place | Fermez-le et utilisez la barre latérale **Rechercher**. La [Palette de commandes de l'agent](/fr/guides/agent/command-palette) gère les fonctionnalités plutôt que la navigation. |
## Guides connexes
- [Chats et historique](/fr/guides/work-with-runner/chats-and-history)
- [Navigation et recherche de l'espace de travail](/fr/guides/workspace/navigation-and-search)
- [Palette de commandes d'agent](/fr/guides/agent/command-palette)
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
---
# États des tâches et détails
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/task-states-and-details
**Ce que couvre ce guide :** Vous saurez si une tâche fonctionne, attend, est terminée, interrompue ou a besoin d'une autre tentative.
Les états des tâches vous indiquent ce dont Runner a besoin ensuite. La vue détaillée et le canevas du projet vous aident à examiner
le travail sans vous fier uniquement au dernier message de la conversation.
**Chemin d'accès :** Ouvrez un projet de magasin → sélectionnez une conversation → inspectez la carte de tâche actuelle et
choisissez **Détails** lorsqu'il est disponible.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgDROEIVBmoeRbFHcSPrynU5Il76xY2q981Nj4)
1. Vérifiez l’état de la tâche. 2. Sélectionnez Détails pour examiner le travail. Cette carte d’exemple montre une tâche terminée ; cela ne prouve pas à lui seul que la boutique est publiée ou que le paiement fonctionne. Sélectionnez l’image pour l’agrandir.
## Avant de commencer
- Confirmez la conversation actuelle et la dernière tâche avant d'agir sur un état.
- Gardez l'erreur visible ou la question en attente disponible jusqu'à ce que la récupération réussisse.
- Ne traitez pas une tâche terminée comme une preuve que l'aperçu, la publication ou un fournisseur externe a réussi.
## États des tâches
| État | Signification | Que faire ensuite |
| --- | --- | --- |
| En cours | Runner travaille activement sur la demande. | Suivez la progression, ouvrez **Détails** ou choisissez **Arrêter** si la tâche ne doit pas continuer. |
| En attente d'entrée | Runner a besoin de votre choix ou d'informations manquantes. | Répondez à la question active ou choisissez **Ignorer**, lorsqu'elle est proposée, afin que Runner puisse faire preuve de son meilleur jugement. |
| Terminé | Runner a terminé le tour actuel. | Examinez le message, les détails, l'aperçu et toute zone de projet modifiée. |
| Échoué | Runner n'a pas pu terminer le tour. | Lisez l'erreur et les détails, puis choisissez **Réessayer** si cette option est proposée, ou envoyez une demande plus ciblée. |
| Arrêté | Vous ou Runner avez interrompu le tour. | Examinez le travail partiel, puis envoyez une nouvelle instruction si la tâche doit continuer. |
Une tâche terminée signifie que le tour de conversation s'est terminé avec succès. Cela ne prouve pas par elle-même
qu'un magasin a été publié, qu'un paiement s'est produit ou qu'un service externe a accepté une modification.
## Examiner le travail
1. Sélectionnez **Détails** sur la tâche.
2. Suivez les entrées étape par étape pour comprendre ce que Runner a tenté.
3. Ouvrez **Utilisation** lorsqu'il est affiché pour examiner les crédits affichés, les appels d'outils et l'activité de l'agent.
4. Examinez le plan de travail lorsque la tâche en inclut un.
5. Utilisez **Aperçu** ou **Boutique en ligne** pour inspecter le résultat côté client.
6. Ouvrez d'autres onglets de canevas pertinents, tels qu'un fichier ou un résultat que Runner a mis en avant.
7. Utilisez **Ajouter un onglet** pour ouvrir une autre vue disponible, et **Fermer l'onglet** pour supprimer une vue du canevas.
8. Examinez **Historique des versions** lorsque vous avez besoin de comparer ou de localiser un état de projet antérieur.
9. Comparez le résultat réel de la page ou de l'outil avec le résultat demandé. Envoyez un suivi ciblé qui nomme tout problème restant.
Ouvrez uniquement les vues de tâches réellement proposées par Runner. Les vues de détail et de toile disponibles varient en fonction de la demande.
## Examiner une version de vitrine à partir d'une carte de travail terminée
> **Conditionnel :** Les étiquettes de version et les aperçus historiques nécessitent des versions de vitrine enregistrées et un accès aux fiches de version. Les projets plus anciens sans historique de version enregistré peuvent toujours afficher **Aperçu** sur la dernière carte de travail de vitrine ; cette action ouvre l'aperçu en direct actuel plutôt qu'une version historique exacte. Si aucune action de carte de travail n'apparaît, ouvrez directement [Aperçu](/fr/guides/storefront-and-publishing/preview-your-store).
| Contrôle ou état | Ce qu'il signifie ou fait |
| --- | --- |
| **v…** | Identifie la version de la vitrine affichée sur la carte de travail terminée. |
| **Version actuelle** | Marque la dernière version du projet. |
| **Publié** | Marque une version associée à une publication terminée ; cela ne prouve pas que le paiement fonctionne toujours. |
| **Construction…** | La version n'est pas encore prête pour l'aperçu. |
| **Échec de la construction** | La version n'a pas pu atteindre un état prêt pour l'aperçu. Ouvrez **Détails** et conservez tout contexte d'échec visible avant de demander à Runner de le corriger. |
| Image de la vitrine ou **Aperçu** | Ouvre la version prête exacte lorsque les données de version existent. Sur la dernière carte d'un projet plus ancien sans historique de version, elle ouvre l'aperçu en direct actuel de la vitrine à la place. Les anciennes cartes sans correspondance n'affichent pas **Aperçu**. |
| **Publier** | N'apparaît que pour une version actuelle non publiée et ouvre les vérifications de publication. Il n'est pas affiché pour une version historique ou déjà publiée. |
| Les informations de version sont en cours d'actualisation | L'image de la vitrine ainsi que les actions **Aperçu** et **Publier** de la version actuelle restent visibles, mais sont temporairement désactivées. Elles ne peuvent pas être sélectionnées tant que l'actualisation n'est pas terminée. |
Utilisez l'étiquette de version avant de juger une capture d'écran ou de sélectionner **Publier**. Un aperçu historique prêt est toujours en lecture seule jusqu'à ce que vous restauriez ou publiiez délibérément une version actuelle via le flux disponible.
Les captures de cette page montrent l'interface en anglais.
Utilisez les étiquettes de version pour distinguer le résultat actuel des travaux antérieurs. Cette image montre l'historique des versions, pas le panneau Détails de la tâche, et aucune version n'a été restaurée ou publiée.
## Contrôles de conversation
| Contrôle | Ce qui se passe |
| --- | --- |
| **Détails** / **Masquer les détails** | Ouvre l'enregistrement des tâches étape par étape dans le canevas, ou ramène le canevas à **Boutique en ligne**. Le masquer ne supprime pas l'enregistrement des tâches. |
| **Réessayer** | Démarre une autre tentative pour une tâche échouée lorsque l'action est offerte. |
| **Aller au dernier message** | Déplace la conversation vers l'entrée la plus récente. |
| Aperçu de la transcription | Vous permet de vous déplacer vers une section visible d'un enregistrement de tâche plus long. |
| **Aperçu** ou **Boutique en ligne** | Ouvre la vue de travail côté client du projet. |
| **Ajouter un onglet** | Ouvre la liste des vues de canevas disponibles pour ce projet et cette tâche. |
| **Fermer l'onglet** | Supprime la vue sélectionnée du canevas ; cela ne supprime pas le contenu du projet sous-jacent. |
## Si la progression semble bloquée
- Vérifiez si une question sans réponse attend plus bas dans la conversation.
- Ouvrez **Détails** pour identifier la dernière étape terminée.
- Utilisez **Aller au dernier message** si la conversation est défilée loin de l'état actif.
- Ne sélectionnez pas à plusieurs reprises **Réessayer** pendant qu'une autre tentative est déjà en cours.
- Si vous arrêtez une tâche, examinez les résultats partiels avant de demander à Runner de continuer.
## Guides connexes
- [Quand Runner pose une question](/fr/guides/work-with-runner/answer-runner-questions)
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
- [Chats et historique](/fr/guides/work-with-runner/chats-and-history)
- [Comprendre les statuts des magasins](/fr/guides/workspace/store-statuses)
- [Historique des versions](/fr/guides/storefront-and-publishing/version-history)
---
# Rédiger des demandes efficaces
Source: https://www.runnerai.com/docs/fr/guides/work-with-runner/write-effective-requests
**Ce que couvre ce guide :** Vous rédigerez des demandes qui sont plus faciles pour Runner à agir et plus faciles pour vous à examiner.
Une demande utile décrit le résultat, pas seulement le sujet. Donnez suffisamment de contexte pour rendre la prochaine
décision claire, puis utilisez les messages de suivi pour des raffinements ciblés.
**Chemin d'entrée :** Ouvrez un magasin → **Nouvelle tâche** ou la tâche en cours → boîte de message.
## Avant de commencer
- Confirmez le magasin et la page ou le flux de travail que vous souhaitez modifier.
- Décidez d'un seul résultat visible et de toute limite que Runner doit préserver.
- Supprimez les mots de passe, les secrets, les détails de paiement et les données client inutiles.
## Contrôles du compositeur et résultats
| Contrôle | Ce qui se passe après que vous le sélectionnez |
| --- | --- |
| **Plus d’actions** | Ouvre les outils du compositeur moins fréquemment utilisés lorsqu'ils ne rentrent pas dans la barre d'outils. |
| **Améliorer le prompt** | Génère un brouillon affiné ; cette action n'envoie pas la demande et ne modifie pas le magasin. |
| **Accepter** | Remplace le brouillon du compositeur par l'affinement affiché. |
| **Fermer** | Ferme l'affinement et conserve le brouillon existant. |
| **Regenerate** | Demande une autre version affinée. |
| **Revenir à l'original** | Restaure la formulation antérieure après un affinement accepté. |
| **Envoyer le message** | Ajoute le brouillon final à la conversation et démarre la tâche. |
## Une structure de demande simple
Incluez ces cinq parties lorsqu'elles sont pertinentes :
1. **Objectif :** Qu'est-ce qui devrait être différent lorsque le travail est terminé ?
2. **Contexte du magasin :** Que vendez-vous et qui est le client ?
3. **Problème actuel :** Qu'est-ce qui est confus, manquant ou peu performant maintenant ?
4. **Résultat souhaité :** Qu'est-ce qu'un client devrait pouvoir voir ou faire ?
5. **Limites :** Qu'est-ce qui doit rester inchangé et que Runner doit-il vérifier ?
**Par exemple :**
> Mettez à jour le héros de la page d'accueil de notre magasin minimaliste de sacs de voyage. Mettez la collection de bagages à main au premier plan, conservez la navigation existante et les données produit, et faites en sorte que l'action principale mène à cette collection. Vérifiez le résultat sur mobile et sur ordinateur avant de terminer.
## Envoyer une demande bien délimitée
1. Commencez par un seul résultat cohérent.
2. Nommez la page, la section, le produit ou le flux de travail impliqué.
3. Décrivez l'action du client que vous souhaitez améliorer.
4. Ajoutez une image de référence lorsque l'apparence ou le contenu existant est important.
5. Indiquez tout ce que Runner ne doit pas modifier.
6. Demandez les vérifications qui vous intéressent, telles que la disposition mobile ou un chemin de clic spécifique.
7. Sélectionnez **Envoyer le message**.
8. Examinez le résultat, puis envoyez une correction ciblée à la fois.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Comparez le résultat à votre demande : l'exemple demande un titre évoquant une matinée plus calme, en conservant la mise en page et les produits. Cette image montre l'aperçu obtenu, pas la boîte de dialogue **Améliorer le prompt**.
## Utiliser Améliorer l'invite lorsqu'elle est disponible
1. Rédigez la demande dans la boîte de message.
2. Ouvrez **Plus d’actions** si **Améliorer le prompt** n'est pas visible.
3. Sélectionnez **Améliorer le prompt**.
4. Attendez que le contrôle affiche **Amélioration en cours…**.
5. Examinez le **Prompt affiné**. Vérifiez qu'il préserve la page prévue, l'action du client et tout ce que vous avez demandé à Runner de laisser inchangé.
6. Choisissez **Accepter** pour l'utiliser, **Fermer** pour conserver votre brouillon, ou **Regenerate** pour une autre version.
7. Utilisez **Revenir à l'original** si vous avez accepté l'affinement et que vous voulez votre formulation antérieure.
8. Sélectionnez **Envoyer le message** uniquement lorsque la demande correspond toujours à votre intention.
## Éviter les demandes ambiguës
| Au lieu de | Essayez |
| --- | --- |
| « Rends-le mieux. » | « Rends les cartes de collection plus faciles à scanner sur mobile, tout en conservant leurs liens de produit actuels. » |
| « Répare le paiement. » | « Suis le parcours Ajouter au panier → Panier → Paiement et dis-moi où il s'arrête avant de modifier quoi que ce soit. » |
| « Copie ce site. » | « Utilise ceci comme référence pour l'espacement et le ton, mais conserve notre propre marque, nos produits et notre navigation. » |
| Une longue liste de modifications non liées | Démarrez un chat pour le résultat principal, puis créez-en un autre pour le travail séparé. |
## Récupération lorsque le résultat manque l'objectif
- Pointez la partie exacte qui est mauvaise.
- Décrivez le résultat du clic attendu ou l'état visible.
- Ajoutez une image de référence plus nette si la précédente manquait de clarté.
- Répondez aux questions de Runner plutôt que de répéter la demande complète.
- Pour une tâche échouée, lisez **Détails** avant de choisir **Réessayer**.
## Guides connexes
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
- [Images, modèles et compétences](/fr/guides/work-with-runner/attachments-profiles-and-skills)
- [Quand Runner pose une question](/fr/guides/work-with-runner/answer-runner-questions)
- [États des tâches et détails](/fr/guides/work-with-runner/task-states-and-details)
---
# Espace de travail
Source: https://www.runnerai.com/docs/fr/guides/workspace
Un espace de travail regroupe les magasins et les coéquipiers. Après la connexion, Runner peut ouvrir directement votre boutique actuelle. Vérifiez son nom avant de demander à Runner de modifier quoi que ce soit.
**Chemin d'entrée :** Connexion → magasin actuel → menu nom du magasin ou **Paramètres de l'espace de travail**.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Commencez par le menu du nom du magasin pour confirmer où vous travaillez.
## Choisissez votre prochaine tâche
| Ce dont vous avez besoin | Guide |
| --- | --- |
| Changer de magasin, créer un autre magasin ou examiner la suppression | [Gérer les magasins](/fr/guides/workspace/manage-stores) |
| Comprendre **En direct** et **Brouillon non publié** | [Statuts du magasin](/fr/guides/workspace/store-statuses) |
| Rechercher un outil, une tâche ou une zone de paramètres | [Navigation et recherche](/fr/guides/workspace/navigation-and-search) |
| Ajouter un coéquipier ou modifier l'accès des membres | [Membres et invitations](/fr/guides/workspace/members-and-invitations) |
| Partager une référence sans accorder l'accès à l'espace de travail | [Inviter des amis](/fr/guides/workspace/invite-friends) |
| Lire les mises à jour des produits et des comptes | [Boîte de réception et notifications](/fr/guides/workspace/inbox-and-notifications) |
| Modifier les préférences de l'espace de travail, du magasin ou de votre compte | [Paramètres](/fr/guides/workspace/settings) |
## Orientez-vous après la connexion
1. Lisez le nom du magasin en haut de la barre latérale.
2. Ouvrez son menu si vous avez besoin d'un autre magasin ou **Paramètres de l'espace de travail**.
3. Développez **Créer**, **Développer** ou **Mesurer** pour rechercher des outils pour le magasin actuel.
4. Utilisez **Rechercher** pour rechercher un outil ou une conversation récente.
5. Vérifiez **Boutique en ligne** lorsque vous devez confirmer ce qui est actuellement en aperçu ou en direct.
Si l'espace de travail est vide, suivez d'abord son invite de création de magasin. Effectuer une tâche, préparer un aperçu et publier la boutique sont des résultats distincts.
## Accès et paramètres
- Votre rôle détermine les modifications de membre et d’espace de travail que vous pouvez apporter.
- Les limites de magasin et de sièges peuvent remplacer les contrôles de création ou d'invitation par un message de plan.
- Les paramètres Workspace affectent l’équipe ; la barre latérale **Paramètres** commence par le magasin en contexte ; **Mes paramètres** appartient à votre compte.
- **Inviter des amis** est une référence. Utilisez **Membres** pour permettre à quelqu'un d'accéder à cet espace de travail.
## Guides connexes
- [Créer votre premier magasin](/fr/guides/start-here/first-store-quickstart)
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
- [Utiliser la visite de bienvenue et les crédits quotidiens](/fr/guides/start-here/welcome-tour-and-daily-credits)
---
# Boîte de réception et notifications
Source: https://www.runnerai.com/docs/fr/guides/workspace/inbox-and-notifications
**Ce que couvre ce guide :** Vous trouverez les mises à jour non lues et saurez ce qui peut se passer lorsque vous sélectionnez une notification.
La **Boîte de réception** regroupe les notifications de tous les espaces de travail auxquels vous avez accès. Elle est distincte des
notifications de navigateur optionnelles qui annoncent lorsqu'une tâche Runner est terminée.
**Chemin d'entrée :** Barre supérieure du bureau → icône en forme de cloche. Sur mobile, ouvrez le compte ou le menu de navigation et sélectionnez **Boîte de réception** lorsque cela s'affiche.
Sur le bureau, la cloche ouvre un panneau à côté de l'espace de travail. Sur mobile, elle ouvre un tiroir inférieur. Un
point bleu sur la cloche indique qu'il existe des notifications non lues.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1IjV7HprvDHKGRP0BUIpjksTZQ9oN4rSwzeq)
Commencez par **All** dans Inbox ou choisissez une catégorie comme **Release**. L’image montre uniquement les commandes de catégorie.
Sélectionnez l’image pour l’agrandir. Les annotations sont en anglais.
## Avant de commencer
- Confirmez l'espace de travail et le projet affecté avant de suivre une notification.
- Enregistrez tout brouillon non envoyé car une notification peut naviguer vers une autre page ou un autre projet.
- Évitez les notifications de tâche du navigateur sur un écran partagé lorsque leur texte peut révéler les détails du travail.
## Contrôles de la boîte de réception
| Contrôle ou état | Ce qui se passe |
| --- | --- |
| **Tout** | Affiche toutes les catégories de notifications disponibles. |
| **Abonnement** | Filtre les mises à jour liées au forfait et à la facturation. |
| **Sortie** | Filtre les mises à jour relatives aux nouvelles versions du produit. |
| **Événement** | Filtre les notifications d'événements. |
| Ligne de notification | Effectue l'action assignée à cette notification, si elle en a une. |
| Fermer la boîte de réception ou changer d'onglets | Marque les notifications qui étaient suffisamment visibles comme lues. Cela ne marque pas tous les éléments à la fois. |
| Faites défiler jusqu'au bas | Charge plus de notifications lorsque d'autres sont disponibles. |
La boîte de réception ne comporte ni contrôle **Tout marquer comme lu**, ni écran de nouvelle tentative distinct pour une requête échouée.
## Lire les notifications
1. Sélectionnez l'icône de cloche.
2. Commencez par **Tout**, ou choisissez une catégorie.
3. Lisez le titre, le message, l'heure relative et le point non lu.
4. Faites défiler lorsque vous souhaitez charger les éléments plus anciens.
5. Sélectionnez une ligne uniquement après avoir lu l'action qu'elle représente.
6. Fermez la boîte de réception ou changez d'onglet lorsque vous avez terminé ; les éléments visibles non lus sont alors marqués comme lus. Rouvrez la même catégorie pour vérifier que ces éléments n'affichent plus de point non lu.
## Ce qu'un clic de notification peut faire
Le comportement de clic dépend de la notification :
- Ouvrir une page connexe dans Runner.
- Ouvrir un élément externe, comme une facture, dans un nouvel onglet du navigateur.
- Copier une erreur de construction ou de pré-vérification pour que vous puissiez la coller dans une demande d'assistance ou une conversation Runner.
- Ouvrir un chemin de gestion de la facturation pour un problème de paiement.
- Ne rien faire lorsque la notification est informative et n'a pas d'action.
Lisez la notification avant de la sélectionner. Une ligne n'a pas une destination universelle.
## États vides et de chargement
| État | Signification | Que faire |
| --- | --- | --- |
| Chargement des espaces réservés | Runner récupère les notifications. | Gardez la boîte de réception ouverte jusqu'à ce que la liste se stabilise. |
| **Pas encore de notifications** | La catégorie sélectionnée ne contient aucun élément. | Revenez plus tard ou essayez **Tout**. |
| **Nous vous informerons quand quelque chose se passera.** | Il n'y a actuellement aucune mise à jour à traiter. | Fermez la boîte de réception et continuez à travailler. |
| Chargement de plus | Les éléments plus anciens sont récupérés après le défilement. | Attendez avant de faire défiler à nouveau. |
## Notifications de fin de tâche du navigateur
Certains navigateurs de bureau affichent une carte distincte dans la barre latérale Agent développée :
1. Choisissez **Activer** pour permettre au navigateur de demander l'autorisation d'envoyer des notifications.
2. Autorisez la permission uniquement si vous souhaitez des notifications système pour les tâches terminées.
3. Choisissez **Pas maintenant** pour reporter l'invite.
4. La sélection d'une notification système concentre Runner et revient à la conversation connexe.
Cette fonctionnalité dépend de la prise en charge du navigateur de bureau. Ne vous attendez pas au même comportement sur mobile ou dans
chaque configuration d'application installée. Les messages de fin de flux de travail de l'espace de travail et de magasin prêt peuvent également apparaître
comme des avis temporaires à l'écran ; **Prévisualiser la boutique** sur un avis de magasin prêt ouvre son aperçu.
## Guides connexes
- [Navigation et recherche](/fr/guides/workspace/navigation-and-search)
- [Membres et invitations](/fr/guides/workspace/members-and-invitations)
- [États des tâches et détails](/fr/guides/work-with-runner/task-states-and-details)
---
# Inviter des amis
Source: https://www.runnerai.com/docs/fr/guides/workspace/invite-friends
**Inviter, gagner des points** crée un lien de parrainage personnel que vous pouvez copier ou partager. Ce lien est distinct d'une invitation envoyée à un coéquipier pour rejoindre un espace de travail.
## Ce que couvre ce guide
Vous partagerez le lien de parrainage correct, comprendrez ce que le destinataire voit et éviterez de confondre un parrainage avec l'accès à l'espace de travail.
## Disponibilité et conditions préalables
- Vous devez être connecté à un espace de travail.
- Attendez que Runner génère le lien de parrainage avant de sélectionner une action de partage.
- L'admissibilité au parrainage et toute récompense sont régies par les conditions affichées dans le panneau au moment du partage. Ne vous fiez pas à un montant ou une capture d'écran plus ancienne.
- Un lien de parrainage n'ajoute pas son destinataire à votre espace de travail, vos magasins ou vos projets.
## Chemin d'accès
Ouvrez **Gagner des crédits** et choisissez l'action de référence. Si votre mise en page affiche toujours **Inviter des amis** dans la barre latérale, cela ouvre le même flux de parrainage. Runner ouvre un panneau de bureau ou un tiroir du bas mobile avec votre lien de parrainage et les conditions actuellement disponibles.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRvFfxwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Ouvrez **Gagner des crédits**, faites défiler jusqu’à **Plus de façons de gagner**, puis choisissez **Inviter des amis**. Dans l’image : 1. Repérez votre lien d’invitation. 2. Sélectionnez **Copier le lien** (**Copier** dans les anciennes interfaces). 3. Utilisez un partage sur les réseaux sociaux si nécessaire. Le lien personnel est masqué ; aucune invitation n’a été envoyée. Sélectionnez l’image pour l’agrandir. Les annotations utilisent l’interface de bureau en anglais.
## Contrôles de partage
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Copier le lien** | Copie le lien de parrainage dans le presse-papiers. Le libellé affiche brièvement **Copié !**, puis reprend son texte initial. |
| **X** | Ouvre le flux de partage de X avec le lien de parrainage préparé. |
| **Facebook** | Ouvre le flux de partage de Facebook avec le lien de parrainage préparé. |
| **LinkedIn** | Ouvre le flux de partage de LinkedIn avec le lien de parrainage préparé. |
| **Fermer** | Ferme le panneau sans modifier ni invalider le lien de parrainage. |
Les boutons sociaux ouvrent la fenêtre ou l'onglet de partage du fournisseur. Examinez l'audience et le message avant de publier ; l'ouverture d'un flux de partage ne publie pas par lui-même.
## Partagez un parrainage
1. Ouvrez **Gagner des crédits**, faites défiler jusqu’à **Plus de façons de gagner**, puis sélectionnez **Inviter des amis**.
2. Lisez les conditions d'admissibilité et de récompense actuelles.
3. Attendez que le lien de parrainage et les boutons de partage soient prêts.
4. Sélectionnez **Copier le lien** pour l'envoyer en privé, ou choisissez un réseau social.
5. Si vous l'avez copié, collez le lien entier dans le message prévu et vérifiez que son code d'invitation reste présent.
6. Dites au destinataire que le lien est pour s'inscrire à Runner, pas pour rejoindre votre espace de travail existant.
Lorsqu'un destinataire ouvre le lien, Runner enregistre le contexte de parrainage et l'envoie pour se connecter ou créer un compte. Le contexte de parrainage est préservé lors de cette étape de connexion. Toute admissibilité ou crédit résultant suit toujours les conditions affichées par Runner ; simplement ouvrir le lien ne garantit pas une récompense.
## Inviter un coéquipier à la place
Pour donner à quelqu'un accès à l'espace de travail actuel, ouvrez le menu du nom du magasin → **Paramètres de l'espace de travail** → **Membres** → **Inviter des personnes**. Une invitation de membre a ses propres états en attente, d’annulation et d’acceptation. Ne remplacez pas ce flux d'accès par un lien de référence.
## Dépannage
| État | Signification et prochaine étape |
| --- | --- |
| Les actions de partage ne sont pas disponibles | Runner génère toujours le lien. Attendez qu'il se termine. |
| **Copié !** | Le lien est dans le presse-papiers. Collez-le une fois et vérifiez l'URL complète. |
| La fenêtre du réseau social ne s'ouvre pas | Le navigateur peut avoir bloqué une fenêtre contextuelle. Autorisez la fenêtre de partage pour Runner ou utilisez plutôt **Copier le lien**. |
| Le lien ne se charge pas | Rouvrez **Inviter, gagner des points** et copiez le lien actuel. Si l'échec persiste, incluez l'erreur visible dans une demande d'assistance. |
| Le destinataire atteint la connexion | C'est attendu. Runner conserve le contexte de parrainage pendant que le destinataire se connecte ou crée un compte. |
## Guides connexes
- [Membres et invitations](/fr/guides/workspace/members-and-invitations)
- [Crédits et utilisation](/fr/guides/plans-and-billing/credits-and-usage)
- [Support et communauté](/fr/guides/help-and-reference/support-and-community)
---
# Gérer les magasins
Source: https://www.runnerai.com/docs/fr/guides/workspace/manage-stores
Utilisez le menu du nom du magasin pour choisir sur quel magasin Runner doit fonctionner. Chaque magasin a ses propres tâches, vitrine et paramètres.
**Chemin d'entrée :** Nom actuel du magasin en haut de la barre latérale → menu du magasin.
## Avant de commencer
- Confirmez l'espace de travail et le magasin actuels avant de créer ou de supprimer quoi que ce soit.
- Conservez une copie d'une demande non envoyée avant de changer de magasin.
- Votre plan d'espace de travail contrôle le nombre de magasins que vous pouvez créer.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Ouvrez ce menu pour choisir un magasin ou démarrer **Créer un magasin**. Vérifiez à nouveau le nom après le changement.
## Contrôles de magasin
| Contrôle | Ce qui se passe |
| --- | --- |
| Nom actuel du magasin | Ouvre le menu du magasin. |
| Un autre nom de magasin | Ouvre ce magasin et ses tâches. |
| **Créer un magasin** | Ouvre la boîte de dialogue de création ; un message de plan peut apparaître si vous avez atteint la limite du magasin. |
| **Paramètres de l'espace de travail** | Ouvre les paramètres de l'espace de travail, plutôt que du magasin. |
| Barre latérale **Paramètres** | Ouvre les paramètres du magasin actuel. |
| Magasin **Général** → **Supprimer le magasin** | Ouvre la confirmation de suppression. Vérifiez le magasin nommé avant de continuer. |
## Ouvrir un magasin existant
1. Sélectionnez le nom du magasin actuel en haut de la barre latérale.
2. Trouvez le magasin sur lequel vous comptez travailler.
3. Sélectionnez son nom et attendez la fin de la navigation.
4. Confirmez le nouveau nom du magasin dans la barre latérale.
5. Ouvrez sa tâche en cours ou **Boutique en ligne** pour vérifier que vous êtes dans le bon projet avant d'envoyer les instructions.
Si votre compte ouvre un espace de travail vide, utilisez son invite de création. Un espace de travail sans magasin n’a encore rien vers lequel basculer.
## Créer un autre magasin
1. Ouvrez le menu du nom du magasin et sélectionnez **Créer un magasin**.
2. Choisissez le type de magasin disponible. Utilisez le chemin de création Runner pour une nouvelle boutique, ou **Connecter Shopify** pour une boutique Shopify existante lorsqu'elle est proposée.
3. Entrez le **Nom du magasin** requis et complétez ce chemin.
4. Attendez que Runner ouvre le projet.
5. Confirmez que le nouveau nom apparaît dans le menu du magasin. Création ne publie pas la boutique.
Suivez [Créer un magasin Runner](/fr/guides/start-here/create-runner-store) ou [Connecter Shopify](/fr/guides/start-here/connect-shopify) pour la procédure pas à pas complète.
## Examiner une suppression de magasin
1. Basculez vers le magasin que vous souhaitez supprimer.
2. Ouvrez la barre latérale **Paramètres** et la section **Général** du magasin.
3. Trouvez **Supprimer le magasin** et lisez la confirmation.
4. Vérifiez le nom du magasin et les conséquences répertoriées.
5. Annulez si vous devez conserver le magasin. Entrez le nom du magasin requis et confirmez uniquement lorsque vous avez l'intention de le supprimer.
6. Après une suppression confirmée, vérifiez que la boutique n'est plus disponible dans la liste des boutiques actives.
La suppression est destructrice. Utilisez un autre magasin dans le menu si vous souhaitez uniquement changer de projet.
## Dépannage
| Ce que vous voyez | Que faire |
| --- | --- |
| La liste des magasins est en cours de chargement | Attendez avant de sélectionner ou de créer une autre boutique. |
| Il manque un magasin | Confirmez votre adhésion à l'espace de travail et l'espace de travail que vous avez ouvert. Ne créez pas de doublon simplement parce que la liste n'est pas chargée. |
| Création ouvre un chemin de mise à niveau | Consultez les [plans publics](https://www.runnerai.com/pricing) actuels ou interrogez le propriétaire de l'espace de travail sur la capacité. |
| La création a renvoyé une erreur | Vérifiez si un nouveau magasin apparaît déjà avant de lancer une autre tentative. |
| Les paramètres du magasin ne sont pas disponibles | Confirmez le magasin sélectionné et votre rôle. Demandez l’accès à un propriétaire ou à un administrateur d’espace de travail. |
| Écran de renouvellement | Réactivez l’espace de travail si vous y êtes autorisé ou utilisez un autre espace de travail auquel vous pouvez accéder. |
## Guides connexes
- [Statuts des magasins](/fr/guides/workspace/store-statuses)
- [Navigation et recherche](/fr/guides/workspace/navigation-and-search)
- [Paramètres de l'espace de travail](/fr/guides/workspace/settings)
- [Discuter avec Runner](/fr/guides/work-with-runner/chat-with-runner)
---
# Membres et invitations
Source: https://www.runnerai.com/docs/fr/guides/workspace/members-and-invitations
**Ce que cela couvre :** Vous inviterez le bon coéquipier et comprendrez quelles actions de membre votre rôle permet.
La page **Membres** affiche les membres actifs et les invitations en attente pour l'espace de travail sélectionné.
Les invitations d'équipe sont distinctes du lien de parrainage **Inviter des amis** disponible via **Gagner des crédits**.
**Chemin d'entrée :** Menu Nom du magasin → **Paramètres de l'espace de travail** → **Membres**.
## Avant de commencer
- Confirmez l'espace de travail et l'adresse e-mail prévue.
- Examinez la capacité des sièges et recherchez d'abord un membre existant ou une invitation en attente.
- Vous avez besoin d'autorisations de propriétaire ou d'administrateur pour les actions de gestion des membres. La gestion des invitations nécessite également un plan avec des places d'équipe : **Max** ou AppSumo License Tier 2, 3 ou 4. AppSumo License Tier 1 est un plan à place unique. Suivez la porte du plan lorsqu'elle est indiquée.
## Contrôles de la page Membres
| Contrôle ou valeur | Ce que cela signifie ou fait |
| --- | --- |
| **Rechercher des membres** | Filtre les lignes visibles par le nom ou l'e-mail d'un membre. |
| Sièges utilisés | Affiche les membres actuels par rapport à la capacité de l'espace de travail. Les invitations en attente affectent également si une autre invitation est autorisée. |
| **Inviter des personnes** | Ouvre le formulaire d’invitation pour les propriétaires et administrateurs d’espace de travail éligibles. |
| Champ E-mail | Accepte l'adresse e-mail du coéquipier. Il n'y a pas de sélecteur de rôle dans le formulaire d'invitation. |
| **Envoyer l'invitation** | Envoie l'invitation après que l'e-mail soit valide et qu'un siège soit disponible. |
| **Active** | La personne a rejoint l'espace de travail. |
| **En attente** / **Pas encore rejoint** | L'invitation n'a pas été acceptée. |
| **Annuler** | Annule immédiatement une invitation en attente sans autre confirmation. |
| **Supprimer** | Ouvre une confirmation avant qu'un propriétaire ou un administrateur autorisé ne supprime un autre membre. |
| **Quitter** | Ouvre une confirmation avant que vous quittiez l'espace de travail. |
## Inviter un coéquipier
1. Confirmez le nom de l'espace de travail dans les paramètres.
2. Ouvrez **Membres**.
3. Examinez les sièges utilisés et recherchez l'e-mail pour éviter une invitation en double.
4. Si votre rôle et votre plan le permettent, sélectionnez **Inviter des personnes**.
5. Entrez une adresse e-mail valide.
6. Sélectionnez **Envoyer l'invitation**.
7. Recherchez **Invitation envoyée** ou **Invitation renvoyée**.
8. Confirmez que la personne apparaît comme **En attente**.
L'invitation n'ajoute la personne que lorsqu'elle ouvre le lien avec le bon compte et choisit **Rejoindre**. Les liens d'invitation peuvent afficher des états déjà acceptés, annulés, expirés, mauvais compte, siège plein ou autres erreurs. Runner ne promet pas une durée de vie d'invitation fixe ici.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgXczT28QoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Entrez l'e-mail de votre coéquipier dans ce formulaire. La capture d'écran montre une invitation vierge ; aucune invitation n'a été envoyée.
## Accepter une invitation
1. Ouvrez le lien d'invitation de l'e-mail qui vous est adressé.
2. Connectez-vous avec la même adresse e-mail qui a reçu l'invitation.
3. Confirmez l'invitant et le nom de l'espace de travail affichés sur la page.
4. Sélectionnez **Rejoindre _nom de l'espace de travail_**.
5. Attendez **Rejoint _nom de l'espace de travail_** et confirmez que Runner ouvre cet espace de travail.
Sélectionner **Rejoindre** ajoute votre compte à l'espace de travail ; cela ne crée pas un magasin séparé ou ne change le rôle d'un autre membre. Si Runner affiche **Mauvais compte**, sélectionnez **Se connecter en tant que** suivi de l'adresse invitée, puis terminez la connexion avec cette adresse. S'il affiche **L'espace de travail est complet**, sélectionnez **Compris** et demandez à l'invitant de libérer un siège ou de mettre à jour le plan avant d'utiliser le même lien à nouveau.
## Modifier le rôle d'un membre
1. Recherchez le membre souhaité sur **Membres**.
2. Ouvrez le menu **Rôle** de la ligne lorsque vos autorisations le permettent.
3. Sélectionnez le rôle souhaité et attendez la mise à jour.
4. Confirmez que la ligne affiche le nouveau rôle.
Les propriétaires peuvent attribuer des rôles de propriétaire, d'administrateur ou de membre. Les administrateurs peuvent gérer les administrateurs et les membres, mais ne peuvent pas changer de propriétaire ni accorder la propriété. Le formulaire d'invitation n'a pas de sélecteur de rôle ; revoir les rôles après l’arrivée du coéquipier.
## Gérer l'accès avec prudence
### Annuler une invitation en attente
1. Recherchez l'e-mail en attente.
2. Sélectionnez **Annuler** uniquement quand vous avez l'intention d'invalider cette invitation.
3. Vérifiez que la ligne en attente n'apparaît plus.
Le flux coché n'affiche pas une deuxième confirmation pour **Annuler**.
### Supprimer un membre ou quitter
1. Trouvez la ligne du membre correct.
2. Sélectionnez **Supprimer**, ou sélectionnez **Quitter** sur votre propre ligne.
3. Lisez la confirmation, y compris la perte d'accès aux projets de l'espace de travail.
4. Annulez si l'accès doit rester.
5. Confirmez uniquement quand l'espace de travail et la personne sont corrects.
Un propriétaire ne peut pas être supprimé de la ligne propriétaire dans l’interface. Les actions de gestion des membres suivent également la hiérarchie des rôles, donc une action visible ou tentée peut toujours être rejetée quand votre rôle ne le permet pas.
## Dépannage
| État | Que faire |
| --- | --- |
| **Inviter des personnes** est absent | Vérifiez que l'espace de travail est sur Max ou AppSumo License Tier 2-4 et demandez à un propriétaire ou à un administrateur d'espace de travail d'envoyer l'invitation. |
| La capacité des sièges est atteinte | Résolvez une invitation en attente inutilisée ou demandez au propriétaire d'examiner le plan de l'espace de travail. |
| L'e-mail est rejeté | Vérifiez l'adresse complète et corrigez toute erreur de formatage. |
| L'invitation appartient à un autre compte | Connectez-vous avec l'e-mail invité avant de choisir **Rejoindre**. |
| L'invitation est expirée ou annulée | Demandez à un propriétaire ou à un administrateur d'espace de travail d'envoyer une nouvelle invitation. |
| **L'espace de travail est complet** | Demandez à l'invitant de libérer un siège ou de mettre à jour le plan de l'espace de travail, puis réessayez le lien. |
| **Invitation déjà acceptée** | Sélectionnez **Aller à Runner AI** et ouvrez l'espace de travail à partir de votre sélecteur d'espace de travail. |
| La recherche n'affiche aucun résultat | Effacez ou raccourcissez la recherche, puis vérifiez l'espace de travail sélectionné. |
## Guides connexes
- [Paramètres de l'espace de travail](/fr/guides/workspace/settings)
- [Navigation et recherche](/fr/guides/workspace/navigation-and-search)
- [Boîte de réception et notifications](/fr/guides/workspace/inbox-and-notifications)
---
# Navigation et recherche
Source: https://www.runnerai.com/docs/fr/guides/workspace/navigation-and-search
Commencez par vérifier le nom du magasin. Les outils de la barre latérale agissent sur ce magasin ; l’espace de travail et les paramètres personnels ont des entrées distinctes.
**Chemin d'entrée :** Ouvrez un magasin → développez la barre latérale ou ouvrez le menu de navigation sur mobile.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Recherchez dans votre magasin ; 2. Démarrez une nouvelle tâche ; 3. Ouvrez un outil de l’espace de travail ; 4. Rouvrez une tâche enregistrée. Sélectionnez l’image pour l’agrandir. Les repères numérotés correspondent à l’interface de bureau en anglais.
## Avant de commencer
- Enregistrez une copie d'une demande non envoyée avant de changer de magasin ou de tâche.
- Les destinations disponibles dépendent du type de magasin, du rôle, du forfait et des fonctionnalités activées.
## Choisir le bon niveau de paramètres
| Où chercher | Ce que vous pouvez faire |
| --- | --- |
| Nom du magasin en haut de la barre latérale | Changez de magasin, ouvrez **Créer un magasin** ou ouvrez **Paramètres de l'espace de travail**. |
| **Boutique en ligne** | Consultez les pages de la boutique actuelle et l'état de publication. |
| **Créer**, **Développer** et **Mesurer** | Développez les outils groupés pour les opérations, la croissance et le reporting des magasins. |
| **Agent** | Gérez les compétences et la mémoire disponibles du magasin. |
| Barre latérale **Paramètres** | Ouvrez les paramètres avec le magasin actuel en contexte. |
| Cloche en haut à droite | Ouvrez **Boîte de réception** sur le bureau. Sur mobile, utilisez l'entrée **Boîte de réception** lorsqu'elle est proposée dans le menu. |
| Avatar en haut à droite → **Mes paramètres** | Ouvrez les préférences du compte personnel. |
| **Gagner des crédits** | Passez en revue les actions de récompense et de parrainage disponibles. |
## Changer de magasin
1. Sélectionnez le nom du magasin en haut de la barre latérale.
2. Sélectionnez le magasin dont vous avez besoin dans la liste.
3. Attendez que sa page s'ouvre.
4. Confirmez le nouveau nom du magasin avant de sélectionner **Nouvelle tâche** ou de modifier les paramètres.
Le menu des magasins répertorie les magasins dans son espace de travail. La barre latérale Paramètres actuelle n’expose pas **Espaces de travail**. Utilisez une entrée de changement d'espace de travail uniquement lorsque Runner en présente une, puis ouvrez **Paramètres → Général de l’espace de travail** et confirmez le nom de l'espace de travail. Voir [Paramètres](/fr/guides/workspace/settings) pour les commandes de portée.
## Trouver un outil ou une tâche
1. Sélectionnez **Rechercher** dans la barre latérale du projet, ou appuyez sur `Command/Control + K`.
2. Saisissez un nom de destination visible, tel que `Storefront`, ou une partie du titre d'une tâche.
3. Choisissez un résultat sous **Centre de contrôle** pour un outil, ou **Discussions récentes** pour une conversation.
4. Confirmez que la page ou la tâche sélectionnée s'ouvre dans le magasin prévu.
5. Appuyez sur `Escape` pour fermer la recherche si vous ne souhaitez pas naviguer.
[Navigation et recherche du projet](/fr/guides/work-with-runner/project-navigation-and-search) répertorie les groupes d'outils et les états de récupération de recherche. La recherche ouvre une destination ; elle ne lance aucune tâche dans l’outil sélectionné.
Les captures et vidéos de cette page montrent l'interface en anglais.
La recherche affiche les destinations disponibles sous **Centre de contrôle**. Sélectionnez un résultat pour naviguer ou appuyez sur Échap pour conserver la page actuelle.
### Vidéo : filtrer la recherche de navigation
L'enregistrement tape **Analyses** et inspecte la destination correspondante. Il s'arrête avant d'ouvrir le résultat ; sélectionnez vous-même un résultat pour naviguer.
## Dépannage
| Problème | Que faire |
| --- | --- |
| Les étiquettes de la barre latérale sont masquées | Développez-le ou ouvrez le menu de navigation mobile. |
| Il manque une destination | Développez le groupe concerné, essayez Rechercher, puis vérifiez les prérequis de la fonctionnalité. |
| Il manque un magasin | Confirmez l'espace de travail et votre adhésion avant de créer une autre boutique. |
| La recherche ne trouve rien | Effacez la requête et utilisez l’étiquette d’outil visible actuelle. |
| Un lien ouvre un autre onglet de navigateur | Revenez à Runner après l'avoir lu ; l'ouverture d'une ressource ne change pas de magasin. |
## Guides connexes
- [Gérer les magasins](/fr/guides/workspace/manage-stores)
- [Navigation et recherche de projet](/fr/guides/work-with-runner/project-navigation-and-search)
- [Boîte de réception et notifications](/fr/guides/workspace/inbox-and-notifications)
- [Paramètres de l'espace de travail](/fr/guides/workspace/settings)
---
# Paramètres de l'espace de travail
Source: https://www.runnerai.com/docs/fr/guides/workspace/settings
**Ce que couvre ce guide :** Vous ouvrirez la zone de paramètres correcte et saurez quels changements affectent un espace de travail, un magasin ou uniquement votre compte.
Les paramètres sont regroupés par portée. Confirmez les noms de l'espace de travail et du magasin avant de modifier l'accès,
la facturation, les domaines, les scripts ou les contrôles de suppression.
**Chemins d'accès :**
- Menu Nom du magasin → **Paramètres de l'espace de travail** ouvre les paramètres de l'espace de travail.
- Avatar utilisateur en haut à droite → **Mes paramètres** ouvre les paramètres personnels.
- Barre latérale → **Paramètres** ouvre les paramètres avec le magasin actuel dans son contexte.
## Avant de commencer
- Confirmez l'espace de travail et, pour les paramètres du magasin, le groupe **Store : _nom du magasin_**.
- Attendez que l'état **Enregistrement** disparaisse avant de quitter la page.
- Lisez la confirmation finale avant les changements d'accès, de facturation, de domaine, de script ou de suppression.
## Contrôles et résultats importants
| Contrôle | Ce qui se passe après sa sélection |
| --- | --- |
| **Nom** ou **Description** | Enregistre automatiquement un changement d'espace de travail valide après l'arrêt de la modification. |
| **Général de l’espace de travail** | Ouvre les détails de l'espace de travail nommé dans la barre latérale des paramètres. |
| **Supprimer l'espace de travail** | Ouvre une confirmation destructive qui nécessite le nom complet de l'espace de travail. |
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Le groupe d'espace de travail et le groupe **Magasin** ont des paramètres distincts. Confirmez la portée nommée avant de la modifier.
## Sections des paramètres
| Portée | Sections actuellement affichées | Notes |
| --- | --- | --- |
| Espace de travail | **Général de l’espace de travail**, **Membres**, **Plan et Facturation**, **Utilisation et crédits** | Les rôles des membres contrôlent les modifications réussies. |
| Projet de magasin | **Général du store**, **Domaine**, **Scripts personnalisés**, **Agent** | **Expériences** apparaît uniquement lorsqu'il est activé. Les sections de projet apparaissent uniquement avec un magasin en contexte. |
| Personnel | **Mes paramètres** et **Clés API** lorsque cette section est activée | Les modifications personnelles et les clés API appartiennent à votre compte. |
## Mettre à jour les détails de l'espace de travail
1. Ouvrez **Paramètres → Général de l’espace de travail**.
2. Confirmez le nom de l'espace de travail en haut du panneau des paramètres.
3. Modifiez **Nom** ou **Description**.
4. Observez le changement d'état d'enregistrement de **Enregistrement** à **Enregistré**.
5. Gardez le panneau ouvert jusqu'à la fin de l'enregistrement.
Ces champs s'enregistrent automatiquement. Un nom vide ou invalide n'est pas enregistré. Si l'enregistrement échoue, Runner
peut restaurer la dernière valeur du serveur et afficher une erreur. La description de l'espace de travail accepte jusqu'à la
limite affichée par le champ, actuellement 500 caractères.
La mise à jour des détails de l'espace de travail nécessite une permission d'espace de travail suffisante. La suppression d'un espace de travail est une
action du propriétaire même si un autre rôle peut voir une partie de l'interface des paramètres.
## Changer le contexte des paramètres
1. Ouvrez **Paramètres** et lisez les noms de l’espace de travail et du magasin dans sa barre latérale.
2. Sélectionnez **Général de l’espace de travail** pour les détails de l'espace de travail ou **Général du store** pour le magasin actuel.
3. Sélectionnez **Mes paramètres** pour vos préférences personnelles.
La barre latérale actuelle n'expose pas de liste **Espaces de travail**. Utilisez une entrée de changement d'espace de travail ou de création uniquement lorsque Runner en présente une ; ne le cherchez pas sous **Mes paramètres**. Pour quitter un espace de travail, suivez [Membres et invitations](/fr/guides/workspace/members-and-invitations).
## Supprimer un espace de travail avec prudence
1. Ouvrez **Paramètres → Général de l’espace de travail**.
2. Trouvez **Supprimer l'espace de travail**.
3. Lisez la confirmation et le nom de l'espace de travail affecté.
4. Entrez le nom complet de l'espace de travail uniquement quand c'est la cible prévue.
5. Annulez si un magasin, une conversation, un accès membre ou des données d'espace de travail doivent rester disponibles.
L'espace de travail unique ne peut pas être supprimé depuis l’interface.
## États d'accès et dépannage
| État | Signification | Que faire |
| --- | --- | --- |
| **Enregistrement** | Runner enregistre un changement automatique. | Gardez le panneau des paramètres ouvert. |
| **Enregistré** | Le dernier changement de champ valide a été accepté. | Continuez ou fermez les paramètres. |
| Erreur d'enregistrement et ancienne valeur restaurée | Le changement n'a pas été accepté. | Corrigez la valeur, confirmez votre permission et réessayez. |
| **Créez votre premier espace de travail** | Votre compte n'a pas d'espace de travail disponible. | Utilisez l'action de création pour continuer. |
| **Accès à l'espace de travail refusé** | Votre compte ne peut pas ouvrir cet espace de travail. | Choisissez **Aller à votre espace de travail**. |
| Écran de renouvellement | L'espace de travail n'est pas actif. | Choisissez **Renouveler le forfait** si autorisé, ou changez d'espace de travail. |
| Une section est manquante | Elle n'est pas disponible pour le rôle actuel, le contexte du projet, le plan ou l'accès aux fonctionnalités. | Confirmez le contexte et demandez au propriétaire de l'espace de travail si nécessaire. |
## Guides connexes
- [Membres et invitations](/fr/guides/workspace/members-and-invitations)
- [Gérer les magasins](/fr/guides/workspace/manage-stores)
- [Navigation et recherche](/fr/guides/workspace/navigation-and-search)
- [Images, modèles et compétences](/fr/guides/work-with-runner/attachments-profiles-and-skills)
---
# Statuts du magasin
Source: https://www.runnerai.com/docs/fr/guides/workspace/store-statuses
Le résumé du magasin vous indique si une version publique existe. Ouvrez **Boutique en ligne** pour vérifier si votre dernière modification fait partie de cette version.
**Chemin d'entrée :** Nom et résumé du magasin actuel → **Boutique en ligne**.
## Lire le résumé
| Étiquette | Ce qu'il vous dit | Que vérifier ensuite |
| --- | --- | --- |
| **Brouillon non publié** | La boutique ne dispose pas de version publiée à utiliser comme vitrine en direct. | Passez en revue l’aperçu actuel et préparez sa première publication. |
| **En direct** | Une vitrine publique existe. | Ouvrez l'URL publique et confirmez que les modifications prévues sont visibles. |
| **Version actuelle** en vitrine | Il s'agit de la dernière version du projet. | Comparez-le avec la version publiée avant de supposer qu'elle est en ligne. |
| **Publié** sur une version | Cette version est associée à une publication terminée. | Vérifiez la page publique et procédez au paiement séparément. |
Les anciennes présentations de cartes de magasin peuvent utiliser **Brouillon**, **Déploiement** et **Publié**. Lisez **Déploiement** comme une opération en cours et attendez son résultat. Une étiquette en direct ou publiée peut toujours faire référence à une ancienne version réussie après l'échec d'une tentative ultérieure.
Les captures de cette page montrent l'interface en anglais.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Ceci est l'aperçu actuel du projet. Utilisez ses contrôles de version et de publication pour le comparer avec le live store ; un aperçu visible à lui seul ne le rend pas public.
## Vérifier un changement récent
1. Confirmez le nom actuel du magasin.
2. Ouvrez la tâche qui a demandé la modification et examinez son dernier statut ainsi que **Détails**.
3. Ouvrez **Boutique en ligne** et confirmez la modification attendue dans l'aperçu prêt actuel.
4. Vérifiez si cette version a été publiée.
5. Si tel était le cas, ouvrez l'URL publique et répétez l'action client appropriée.
Vous avez vérifié le changement uniquement lorsque la version prévue et son résultat visible concordent. L'achèvement d'une tâche ne prouve pas à lui seul qu'un aperçu, une publication, un paiement ou une action du fournisseur a réussi.
## Si le résumé semble erroné
- Laissez toute publication active se terminer avant de lancer une autre tentative.
- Ractualisez la vue actuelle une fois et lisez le dernier résultat de publication.
- Comparez les versions actuelles et publiées dans [Historique des versions](/fr/guides/storefront-and-publishing/version-history).
- Si la boutique publique affiche toujours du contenu plus ancien, consultez l'aperçu le plus récent avant d'utiliser **Publier les modifications**.
- Si la publication échoue, suivez l'erreur nommée au lieu de répéter la même action.
## Guides connexes
- [Gérer les magasins](/fr/guides/workspace/manage-stores)
- [États des tâches et détails](/fr/guides/work-with-runner/task-states-and-details)
- [Publier et republier](/fr/guides/storefront-and-publishing/publish-and-republish)
- [Vérifier la boutique en direct et payer](/fr/guides/storefront-and-publishing/live-store-and-checkout)
---
# Politique d'Utilisation Acceptable
Source: https://www.runnerai.com/docs/fr/legal/aup
## Politique d'Utilisation Acceptable de Runner AI
Cette Politique d'Utilisation Acceptable ("PUA") est émise par Adaptive Machines, Inc. ("Runner AI", "nous", "notre") et régit votre utilisation des services Runner AI.
**La règle principale pour l'utilisation de Runner AI est la suivante : Vous êtes responsable du respect de la loi, des règles de vos partenaires et de vos accords avec nous.**
Voici les principes qui sous-tendent nos attentes de manière plus détaillée :
## Vous ne pouvez pas utiliser Runner AI pour faire quoi que ce soit d'illégal là où vous exercez vos activités
Nous comprenons que les lois et les cadres réglementaires peuvent être complexes, mais en choisissant un marché sur lequel entrer et des produits à vendre, vous, le commerçant, vous engagez à prendre ce marché au sérieux, et nous vous faisons confiance et attendons de vous que vous compreniez les limites applicables. Vous devez également respecter le fait que certaines activités commerciales ne sont pas prises en charge par notre plateforme, comme le téléchargement d'Informations de Santé Protégées soumises à la loi HIPAA.
## Vous devez maintenir l'intégrité et la sécurité de la plateforme
Nous nous engageons à maintenir un environnement commercial sûr et digne de confiance. Les activités qui nuisent à l'intégrité de notre plateforme ou à la sécurité de nos utilisateurs sont strictement interdites. Cela inclut, sans s'y limiter :
### Biens illégaux et réglementés
Vendre des contrefaçons, des drogues illégales, des armes ou tout autre produit illégal dans votre juridiction ou celle de vos clients.
### Violation de la propriété intellectuelle
Violer les droits de propriété intellectuelle d'autrui, y compris les droits d'auteur et les marques de commerce.
### Contenu haineux, violent et préjudiciable
Vendre des produits ou publier du contenu qui promeut la haine, la discrimination, la violence ou facilite l'automutilation intentionnelle.
### Fraude et tromperie
Se livrer à du marketing trompeur, à des escroqueries financières ou à toute autre activité frauduleuse.
### Abus de la plateforme
Envoyer du spam, distribuer des logiciels malveillants ou tenter de perturber nos services.
## Règles spécifiques concernant les fonctionnalités d'IA
Votre utilisation de toute fonctionnalité d'intelligence artificielle au sein de Runner AI ("Fonctionnalités IA") est soumise aux conditions supplémentaires suivantes :
### a. Responsabilité des données d'entrée
Vous êtes seul responsable de tous les textes, données et informations que vous fournissez aux Fonctionnalités IA ("Données d'entrée"). Vous acceptez de ne fournir aucune Donnée d'entrée qui soit illégale, qui viole les droits de tiers ou qui contient des informations personnelles sensibles.
### b. Exactitude et responsabilité des données de sortie
Le contenu généré par les Fonctionnalités IA ("Données de sortie") peut contenir des erreurs. Vous devez examiner et vérifier de manière indépendante toutes les Données de sortie avant de les publier ou de vous y fier. Runner AI n'est pas responsable des dommages résultant de votre utilisation des Données de sortie.
### c. Utilisations interdites des fonctionnalités d'IA
Vous ne pouvez pas utiliser les Fonctionnalités IA pour générer du contenu trompeur, créer du contenu haineux ou harcelant, ou produire du spam.
## Vous devez respecter nos accords avec vous
Bien que nous ne souhaitions pas vous accabler de paperasse, nos Conditions d'Utilisation sont importantes pour notre fonctionnement. Nos accords vous lient en tant que commerçant et expliquent les règles de la plateforme que vous devez suivre.
Runner AI propose une gamme de produits et services qui tirent parti de partenariats avec d'autres organisations. Lorsque vous utilisez l'un de ces produits, vous interagissez avec toute une chaîne d'approvisionnement d'entreprises. Runner AI implique un écosystème de processeurs travaillant ensemble. Si vous utilisez ces services, vous devez respecter le fonctionnement de la chaîne d'approvisionnement et les conditions qui vous sont demandées.
## Les litiges les plus courants concernant l'éligibilité des produits proviennent de l'extérieur de Runner AI
Nous sommes une plateforme de commerce : la plupart des litiges concernant l'éligibilité des produits ou les retraits que les entrepreneurs peuvent rencontrer proviennent de l'extérieur de Runner AI, y compris des régulateurs et des détenteurs de droits de propriété intellectuelle tiers. Dans ces circonstances, nous vous informerons et vous fournirons des outils pour gérer vous-même vos risques et litiges, le cas échéant.
## Nous attendons de vous que vous agissiez de bonne foi. Si vous ne le faites pas, des mesures au niveau du compte peuvent être appropriées
Nous n'aimons pas voir les gens essayer de "jouer" avec les systèmes pour éviter les contraintes avec lesquelles ils ne sont pas d'accord. Nous ne tolérons pas non plus que quiconque fraude Runner AI, d'autres commerçants ou acheteurs, utilise notre plateforme pour envoyer du spam ou pour d'autres pratiques malveillantes. Dans ces cas, bien que nous essayions de minimiser l'impact sur les activités comme principe de premier ordre, des mesures au niveau du compte sont souvent plus appropriées.
Lorsque vous développez sur Runner AI en gardant ces principes à l'esprit, nous vous informerons, vous accorderons des opportunités de remédier vous-même aux conflits, prendrons des mesures d'application au niveau du produit par défaut et prendrons des mesures au niveau du compte en dernier recours, le cas échéant. Enfin, comme pour tous les excellents produits, nous nous attendons à itérer et à mettre à jour ces principes de temps à autre.
Si vous pensez qu'un utilisateur de Runner AI viole cette Politique d'Utilisation Acceptable, vous pouvez contacter le Support Runner AI par e-mail à support@adaptivemachines.ai.
---
# Politique relative aux Cookies
Source: https://www.runnerai.com/docs/fr/legal/cookies
## Politique relative aux Cookies de Runner AI
Cette Politique relative aux Cookies explique comment Adaptive Machines, Inc. ("Runner AI", "nous", "notre") utilise les cookies et technologies similaires sur notre site web (runner.ai) et les services que nous fournissons à nos commerçants (collectivement, les "Services"). Elle explique ce que sont ces technologies et pourquoi nous les utilisons, ainsi que vos droits pour contrôler notre utilisation de celles-ci. Cette politique doit être lue conjointement avec notre [Politique de Confidentialité](/fr/legal/policies) principale.
## Qu'est-ce qu'un cookie ?
Un cookie est une petite quantité d'informations qui est téléchargée sur votre ordinateur ou appareil lorsque vous visitez certains sites web. Nous utilisons un certain nombre de cookies différents sur le site web Runner AI, notamment des cookies strictement nécessaires, de performance, publicitaires et de médias sociaux ou de contenu. Les cookies améliorent votre expérience de navigation en permettant au site web de mémoriser vos actions et préférences (telles que la connexion et la sélection de région). Cela signifie que vous n'avez pas à ressaisir ces informations chaque fois que vous revenez sur le site ou que vous naviguez d'une page à l'autre. Les cookies fournissent également des informations sur la façon dont les gens utilisent le site web, par exemple s'il s'agit de leur première visite ou s'ils sont des visiteurs fréquents. Pour en savoir plus sur les cookies (et autres technologies de suivi similaires) et sur la façon dont nous utilisons les données collectées par ces technologies, consultez notre [Politique de Confidentialité](/fr/legal/policies).
## Cookies sur les boutiques de commerçants
Cette section est importante à la fois pour les commerçants utilisant notre plateforme et pour les visiteurs de leurs boutiques.
**Pour les visiteurs des boutiques de commerçants :** Lorsque vous visitez la boutique d'un commerçant alimentée par Runner AI, ce commerçant est le Responsable du Traitement de vos informations. Cela signifie que le commerçant décide quels cookies utiliser sur sa boutique, en particulier pour l'analytique et la publicité (par exemple, Google Analytics, Facebook Pixel). Runner AI agit en tant que Sous-traitant, plaçant des cookies strictement nécessaires pour la fonctionnalité de base de la boutique (par exemple, panier d'achat, paiement). Toute question concernant les pratiques de confidentialité d'un commerçant doit être adressée directement au commerçant lui-même.
**Pour les commerçants :** En tant que commerçant utilisant Runner AI, vous êtes le Responsable du Traitement des données de vos clients. Vous êtes responsable du respect de toutes les lois applicables en matière de confidentialité, y compris informer vos clients des cookies que vous utilisez (y compris ceux des applications tierces que vous installez) et obtenir un consentement valide lorsque cela est requis. Bien que Runner AI fournisse la plateforme, vous êtes responsable de la configuration spécifique des paramètres de confidentialité et des politiques de votre boutique.
## Quels cookies utilisons-nous et pourquoi ?
### Cookies nécessaires
Certains cookies sont nécessaires pour vous permettre de naviguer sur notre site web, d'utiliser ses fonctionnalités et d'accéder aux zones sécurisées. L'utilisation de ces cookies est essentielle au fonctionnement du site web. Par exemple, nous utilisons des cookies de saisie utilisateur pendant la durée d'une session pour garder une trace de leurs entrées lors du remplissage de formulaires qui s'étendent sur plusieurs pages.
### Cookies fonctionnels
Nous utilisons également des cookies fonctionnels pour mémoriser les choix que vous avez faits ou les informations que vous avez fournies, telles que votre nom d'utilisateur, votre langue ou la région dans laquelle vous vous trouvez. Cela nous permet d'adapter votre expérience web spécifiquement à vos préférences. Par exemple, les cookies d'authentification sont des cookies fonctionnels qui sont utilisés pour la durée d'une session (ou persistants, si vous acceptez la fonction "se souvenir de moi") pour permettre aux utilisateurs de s'authentifier lors de visites ultérieures ou d'accéder à du contenu autorisé sur plusieurs pages. Les cookies fonctionnels que nous utilisons incluent :
- **Cookies de sécurité centrés sur l'utilisateur :** Pour détecter les abus d'authentification pendant une durée persistante limitée, comme des tentatives de connexion infructueuses répétées.
- **Cookies de session de lecteur de contenu multimédia (cookies flash) :** Utilisés pendant la durée d'une session pour stocker les données techniques nécessaires à la lecture de contenu vidéo ou audio.
- **Cookies de session d'équilibrage de charge :** Utilisés pendant la durée de la session pour identifier le même serveur dans le pool afin que l'équilibreur de charge puisse rediriger les demandes de manière appropriée.
- **Cookies persistants de personnalisation de l'interface utilisateur :** Utilisés pour stocker la préférence d'un utilisateur concernant un service sur les pages web.
### Cookies de performance
Runner AI se consacre à l'optimisation de l'expérience utilisateur et nous utilisons de nombreux outils pour nous aider à améliorer notre site web et notre plateforme de commerce. À cette fin, nous utilisons des cookies de rapport et d'analyse pour collecter des informations sur la façon dont vous utilisez notre site web ou les vitrines de nos commerçants, et à quelle fréquence. Les cookies de performance que nous utilisons incluent :
- **Cookies d'analyse de première partie :** Nous utilisons ces cookies pour estimer le nombre de visiteurs uniques, améliorer nos sites web et ceux de nos commerçants, et détecter les mots les plus recherchés dans les moteurs de recherche qui mènent à une page web.
- **Cookies d'analyse tiers :** Nous utilisons également Google Analytics et d'autres fournisseurs d'analyse tiers répertoriés ci-dessous pour aider à mesurer comment les utilisateurs interagissent avec le contenu de notre site web.
### Cookies publicitaires
Les cookies publicitaires sont utilisés sur notre site web pour adapter le marketing à vous et à vos intérêts et vous fournir un service plus personnalisé à l'avenir. Ces cookies mémorisent que vous avez visité notre site web et nous pouvons partager ces informations avec des tiers, tels que des annonceurs. Sans ces cookies, les publicités que vous voyez peuvent être moins pertinentes et intéressantes pour vous.
### Cookies de médias sociaux et de contenu
Les cookies de médias sociaux et de contenu sont placés par de nombreux plugins de médias sociaux (par exemple le bouton "j'aime" de Facebook) et d'autres outils destinés à fournir ou améliorer le contenu d'un site web (par exemple des services qui permettent la lecture de fichiers vidéo, ou qui créent des sections de commentaires). Nous intégrons ces modules dans notre plateforme pour améliorer l'expérience de navigation et d'interaction avec nos sites web.
## Vitrines de commerçants
Lorsque les commerçants utilisent notre plateforme pour alimenter leurs boutiques en ligne, nous plaçons les cookies suivants pour les visiteurs de leurs boutiques.
### Cookies nécessaires au fonctionnement de la boutique
| Nom | Description | Durée |
|------|-------------|----------|
| \_medusa\_jwt | Identifiant de connexion du visiteur | 7j |
## Cookies tiers
De plus, nous utilisons des pixels et des balises des tiers suivants, qui peuvent à leur tour placer des cookies.
### Cookies nécessaires au fonctionnement des sites
| Tiers | Description | Politique de confidentialité |
|-------------|-------------|----------------|
| Vercel | Nous utilisons Vercel pour le routage edge. | [https://vercel.com/legal/privacy-policy](https://vercel.com/legal/privacy-policy) |
| Intercom | Nous utilisons Intercom pour le service client. | [https://www.intercom.com/legal/privacy](https://www.intercom.com/legal/privacy) |
| Chatwoot | Nous utilisons Chatwoot, que nous hébergeons nous-mêmes sur support.runnerai.com, pour le service client. Il dépose `cw_conversation` pour conserver votre conversation de chat d'une page et d'une visite à l'autre, `cw_user_` pour mémoriser à quel contact de chat appartient votre navigateur lorsque vous êtes connecté, et `cw_snooze_campaigns_till` pour suspendre les messages de campagne du chat pendant une heure après que vous en avez lu un. `cw_conversation` et `cw_user_` durent un an. | [Politique de Confidentialité](/fr/legal/policies) |
### Rapports et analyses
| Tiers | Description | Politique de confidentialité |
|-------------|-------------|----------------|
| Google Analytics | Nous utilisons Google Analytics pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Google Tag Manager | Nous utilisons Google Tag Manager pour aider à gérer les fournisseurs d'analyse. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| PostHog | Nous utilisons PostHog pour faire de l'analyse de données. | [https://posthog.com/privacy](https://posthog.com/privacy) |
### Publicité
| Tiers | Description | Politique de confidentialité |
|-------------|-------------|----------------|
| Facebook Pixel | Nous utilisons Facebook Pixel pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://www.facebook.com/privacy/explanation](https://www.facebook.com/privacy/explanation) |
| Google Ads | Nous utilisons Google Ads pour diffuser des publicités ciblées aux personnes qui visitent nos sites web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Instagram | Nous utilisons Instagram pour diffuser des publicités ciblées aux personnes qui visitent nos sites web. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| TikTok | Nous utilisons TikTok pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Twitter | Nous utilisons Twitter pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube | Nous utilisons YouTube pour diffuser des publicités ciblées aux personnes qui visitent nos sites web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Reddit | Nous utilisons Reddit pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Pinterest | Nous utilisons Pinterest pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Whatsapp | Nous utilisons Whatsapp pour aider à mesurer comment les utilisateurs interagissent avec nos sites web. | [https://www.whatsapp.com/legal/privacy-policy](https://www.whatsapp.com/legal/privacy-policy) |
### Médias sociaux et contenu
| Tiers | Description | Politique de confidentialité |
|-------------|-------------|----------------|
| Facebook Connect | Nous utilisons Facebook Connect pour permettre aux visiteurs de notre site web d'interagir et de partager du contenu via la plateforme de médias sociaux Facebook. | [https://www.facebook.com/policy.php](https://www.facebook.com/policy.php) |
| Instagram CDN | Nous utilisons Instagram CDN pour fournir du contenu à l'utilisateur. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| Twitter CDN | Nous utilisons Twitter pour permettre aux visiteurs de notre site web d'interagir et de partager du contenu via la plateforme de médias sociaux Twitter. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube CDN | Nous utilisons YouTube CDN pour fournir du contenu à l'utilisateur. | [https://policies.google.com/privacy?hl=en](https://policies.google.com/privacy?hl=en) |
| Tiktok CDN | Nous utilisons Tiktok CDN pour fournir du contenu à l'utilisateur. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Reddit CDN | Nous utilisons Reddit CDN pour fournir du contenu à l'utilisateur. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Linkedin CDN | Nous utilisons Linkedin CDN pour fournir du contenu à l'utilisateur. | [https://www.linkedin.com/legal/privacy-policy](https://www.linkedin.com/legal/privacy-policy) |
| Pinterest CDN | Nous utilisons Pinterest CDN pour fournir du contenu à l'utilisateur. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Rednote CDN | Nous utilisons Rednote CDN pour fournir du contenu à l'utilisateur. | [https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1](https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1) |
## Combien de temps les cookies restent-ils sur mon ordinateur ou appareil mobile ?
La durée pendant laquelle un cookie reste sur votre ordinateur ou appareil mobile dépend de s'il s'agit d'un cookie "persistant" ou "de session". Les cookies de session durent jusqu'à ce que vous arrêtiez de naviguer et les cookies persistants durent jusqu'à ce qu'ils expirent ou soient supprimés. La plupart des cookies que nous utilisons sont persistants et expireront entre 30 minutes et deux ans à compter de la date à laquelle ils sont téléchargés sur votre appareil. Consultez la section ci-dessous sur la façon de contrôler les cookies pour plus d'informations sur la façon de les supprimer avant qu'ils n'expirent.
## Comment contrôler les cookies ?
Vous pouvez contrôler et gérer les cookies de diverses manières. Veuillez garder à l'esprit que la suppression ou le blocage des cookies peut avoir un impact négatif sur votre expérience utilisateur et que certaines parties de notre site web peuvent ne plus être entièrement accessibles.
La plupart des navigateurs acceptent automatiquement les cookies, mais vous pouvez choisir d'accepter ou non les cookies via les contrôles de votre navigateur, souvent dans le menu "Outils" ou "Préférences" de votre navigateur. Pour plus d'informations sur la façon de modifier les paramètres de votre navigateur ou sur la façon de bloquer, gérer ou filtrer les cookies, consultez le fichier d'aide de votre navigateur ou des sites tels que : [www.allaboutcookies.org](https://www.allaboutcookies.org).
Bon nombre des services tiers de publicité et de suivi répertoriés ci-dessus vous offrent la possibilité de vous désinscrire de leurs systèmes de suivi. Vous pouvez en savoir plus sur les informations qu'ils collectent et sur la façon de vous désinscrire via les liens vers les politiques de confidentialité répertoriés ci-dessus.
---
# Accord de Traitement des Données
Source: https://www.runnerai.com/docs/fr/legal/dpa
## Accord de Traitement des Données de Runner AI
### I. OBJET
Cet Accord de Traitement des Données de Runner AI ("ATD") complète et est incorporé par référence dans les Conditions d'Utilisation de Runner AI, ainsi que toutes les conditions applicables à tout service Runner AI supplémentaire que vous choisissez d'utiliser (les "Conditions") par et entre Vous (ou "Commerçant"), et Adaptive Machines, Inc. ("Runner AI" "nous", "notre"), qui décrit les finalités commerciales spécifiques et les services liés à cet ATD. En cas de conflit entre les Conditions et cet ATD, l'ATD prévaudra en ce qui concerne le traitement de Vos Données Personnelles Client, tel que défini ci-dessous.
Vous et Runner AI (chacune une "Partie", ensemble les "Parties"), conviennent que cet ATD énonce les obligations des Parties régissant le traitement de Vos Données Personnelles Client. Vous agirez en tant que Responsable du Traitement et Runner AI agira en tant que Sous-traitant en ce qui concerne le traitement de Vos Données Personnelles Client, dans le cadre de Votre utilisation de nos Services qui reposent sur notre traitement de Vos Données Personnelles Client, à l'exception des services décrits à l'Annexe E.
Lorsque le traitement des Données Personnelles en vertu de cet ATD est soumis aux exigences de protection des données dans l'Espace Économique Européen (l'"EEE"), le Royaume-Uni (le "RU") ou la Suisse, et que Runner AI agit en tant que Sous-traitant, l'Annexe C complète cet ATD. En cas de conflit entre l'Annexe C et d'autres sections de cet ATD, l'Annexe C prévaudra en ce qui concerne le traitement de Vos Données Personnelles Client soumises aux exigences de protection des données de l'EEE, du RU et de la Suisse. Pour éviter toute ambiguïté, l'Annexe C ne s'appliquera pas aux activités de traitement décrites à l'Annexe E.
Lorsque le traitement des Données Personnelles en vertu de cet ATD est soumis aux Lois Américaines sur la Protection des Données, et que Runner AI agit en tant que Sous-traitant ou Prestataire de Services, l'Annexe D complète cet ATD. En cas de conflit entre l'Annexe D et d'autres sections de cet ATD, l'Annexe D prévaudra en ce qui concerne le traitement de Vos Données Personnelles Client soumises aux Lois Américaines sur la Protection des Données. Pour éviter toute ambiguïté, l'Annexe D ne s'appliquera pas aux activités de traitement décrites à l'Annexe E.
Si vous recevez des Services Améliorés de Runner AI (tel que défini dans la Section 9 des Conditions d'Utilisation), Runner AI traitera Vos Données Personnelles Client en tant que Responsable du Traitement ou Entreprise tel qu'énoncé à l'Annexe E. En cas de conflit entre l'Annexe E et d'autres sections de cet ATD, l'Annexe E prévaudra en ce qui concerne le traitement par Runner AI de Vos Données Personnelles Client en tant que Responsable du Traitement ou Entreprise.
### II. DÉFINITIONS
Les termes en majuscules utilisés mais non définis dans cet ATD auront la même signification que celle qui leur est donnée dans les Conditions :
**A. Loi(s) Applicable(s) sur la Protection des Données :** Toute loi sur la protection des données ou la vie privée applicable au traitement par Runner AI des Données Personnelles en vertu des Conditions, leurs règlements d'application et leur législation secondaire, chacun tel que modifié, mis à jour ou remplacé de temps à autre, y compris les lois qui s'appliquent en fonction de l'emplacement ou de la résidence du Commerçant et/ou de Votre(Vos) Client(s).
**B. Client :** Une personne physique ou morale qui visite, interagit avec et/ou achète un produit, bien ou service auprès de Votre(Vos) Boutique(s).
**C. Demande d'Exercice de Droits :** Une demande valide et légale d'une personne d'exercer les droits disponibles concernant les Données Personnelles en vertu d'une Loi Applicable sur la Protection des Données.
**D. Responsable du Traitement ou Entreprise :** La Partie qui détermine les finalités et les moyens du traitement des Données Personnelles, ou tel que défini autrement en vertu de toute Loi Applicable sur la Protection des Données.
**E. Sous-traitant ou Prestataire de Services :** La Partie ou autre entité ou entreprise qui fournit des services pour le compte de et traite les Données Personnelles sur instruction et pour le compte du Responsable du Traitement ou tel que défini en vertu de toute Loi Applicable sur la Protection des Données.
**F. Données Personnelles :** Informations ou données définies comme "données personnelles", "informations personnelles" ou "informations personnellement identifiables" (ou terme analogue) en vertu des Lois Applicables sur la Protection des Données.
**G. Violation de Données Personnelles :** En relation avec Vos Données Personnelles Client, sera interprété conformément aux Lois Applicables sur la Protection des Données.
**H. "Traiter", "traite" ou "traitement" :** (a) Toute opération ou ensemble d'opérations effectuée sur des Données Personnelles ou sur des ensembles de Données Personnelles, que ce soit ou non par des moyens automatisés, tels que la collecte, l'enregistrement, l'organisation, la structuration, le stockage, l'adaptation ou la modification, la récupération, la consultation, l'utilisation, la divulgation par transmission, la diffusion ou autrement la mise à disposition, l'alignement ou la combinaison, la restriction, l'effacement ou la destruction ; ou (b) la définition donnée à ce(s) terme(s) en vertu de la (des) Loi(s) Applicable(s) sur la Protection des Données.
**I. "Sous-traitant(s)" :** Sociétés affiliées ou Sous-traitants ou Prestataires de Services tiers qui peuvent traiter des Données Personnelles sur instruction de Runner AI dans le but de fournir les Services.
**J. "Vous", "Votre" ou "Commerçant" :** Signifie chaque entreprise que Vous exploitez et qui utilise ou bénéficie des Services, des Services Améliorés ou autres Services Supplémentaires et est Partie aux Conditions avec Runner AI.
**K. "Vos Données Personnelles Client" :** Données Personnelles provenant de ou concernant Vos Clients à l'exclusion de toute Donnée Personnelle concernant les Clients que Runner AI reçoit en raison de la relation du Client avec Runner AI, qui est régie par la Politique de Confidentialité Consommateur de Runner AI et non par cet ATD.
### III. NATURE DU TRAITEMENT ET RÔLES DES PARTIES
**Runner AI en tant que Sous-traitant ou Prestataire de Services.** Runner AI reçoit et traite Vos Données Personnelles Client afin de Vous fournir les Services et tel qu'énoncé ci-dessous. Selon les Services que Vous demandez ou utilisez, Runner AI traitera les catégories de Données Personnelles énoncées à l'Annexe A, de la manière et sur les bases qui y sont contenues.
Runner AI traitera Vos Données Personnelles Client en tant que Sous-traitant ou Prestataire de Services uniquement pour fournir les Services instruits dans les Conditions et toutes Conditions supplémentaires et tel que nécessaire pour fournir, développer et améliorer ses Services et s'engager dans toute autre finalité permise par les Lois Applicables sur la Protection des Données.
**Runner AI en tant que Responsable du Traitement ou Entreprise.** Runner AI traitera Vos Données Personnelles Client en tant que Responsable du Traitement ou Entreprise (a) dans les circonstances et de la manière énoncées à l'Annexe E, et (b) pour toute finalité supplémentaire compatible avec les instructions du Client et la Loi Applicable sur la Protection des Données.
### IV. OBLIGATIONS DES PARTIES
La section suivante décrit les obligations respectives des Parties en ce qui concerne le traitement des Données Personnelles couvertes par cet ATD.
#### A. Conformité Générale
1. Les Parties se conformeront à leurs obligations respectives en vertu des Lois Applicables sur la Protection des Données.
2. Runner AI n'aura aucune obligation d'interpréter ou de Vous conseiller sur Vos obligations en vertu des Lois Applicables sur la Protection des Données, y compris en ce qui concerne le traitement des Données Personnelles couvertes par cet ATD. Vous êtes seul responsable de la détermination de Vos obligations juridiques et réglementaires, y compris l'évaluation de la question de savoir si les mesures techniques et organisationnelles des Services sont conformes à Vos obligations juridiques et réglementaires indépendantes.
#### B. Obligations de Runner AI
##### 1. Sécurité des Données
Runner AI mettra en œuvre et maintiendra des mesures techniques et organisationnelles appropriées conçues pour protéger Vos Données Personnelles Client contre le traitement non autorisé ou illégal et contre la perte, la destruction, les dommages, le vol, l'altération ou la divulgation accidentels, tel qu'énoncé à l'Annexe B.
##### 2. Notification et Enquête sur les Violations de Données Personnelles
a) Tel que requis par les Lois Applicables sur la Protection des Données, Runner AI Vous fournira une notification dès que Runner AI confirmera une Violation de Données Personnelles.
b) Cette notification devra inclure les informations requises en vertu des Lois Applicables sur la Protection des Données dans la mesure où ces informations sont raisonnablement disponibles pour Runner AI. La réponse de Runner AI à, ou la notification de, une Violation de Données Personnelles n'est pas une reconnaissance par Runner AI de toute faute ou responsabilité.
c) Runner AI accepte d'enquêter sur toute Violation de Données Personnelles, et d'utiliser des efforts commercialement raisonnables pour identifier, prévenir, atténuer et remédier aux effets.
#### C. Vos Obligations en Matière de Données Personnelles
##### 1. Avis de Confidentialité et Transparence
Vous déclarez et garantissez que Vous êtes en conformité avec toutes les obligations en vertu des Lois Applicables sur la Protection des Données pour fournir un avis et une transparence concernant Votre traitement de Vos Données Personnelles Client en vertu des Conditions et dans le cadre de Votre utilisation des Services. Conformément aux Lois Applicables sur la Protection des Données, Vous communiquerez aux personnes concernées toutes les divulgations nécessaires pour que Runner AI traite légalement et équitablement Vos Données Personnelles Client dans le cadre de cet ATD, y compris lorsque vous recevez des Services Améliorés ou d'autres Services Supplémentaires, en fournissant un lien vers la Politique de Confidentialité Consommateur de Runner AI et vers Votre Politique de Confidentialité et en fournissant d'autres divulgations tel qu'énoncé dans la Section 9 des Conditions.
##### 2. Droits et Autorisations des Clients
Vous déclarez et garantissez que Vous disposez de tous les droits, autorisations et consentements nécessaires pour mettre à disposition Vos Données Personnelles Client à Runner AI, et pour que Runner AI traite Vos Données Personnelles Client afin que Vous receviez les Services, y compris les Services Améliorés ou autres Services Supplémentaires que vous recevez, conformément aux Conditions, cet ATD et les Lois Applicables sur la Protection des Données.
##### 3. Demandes d'Exercice de Droits
Vous déclarez et garantissez que Vous fournissez la capacité à Vos Clients d'exercer des Demandes d'Exercice de Droits, tel que requis en vertu des Lois Applicables sur la Protection des Données, en ce qui concerne le traitement de Vos Données Personnelles Client par Runner AI pour lequel Vous êtes le Responsable du Traitement.
##### 4. Enquêtes Réglementaires
Sauf interdiction par la loi applicable, Vous nous notifierez rapidement conformément à la disposition de Notification dans les Conditions de toute enquête ou plainte gouvernementale, réglementaire ou d'un tiers concernant Votre utilisation des Services.
### V. DIVERS
#### A. Transferts de Données Internationaux
Vous reconnaissez que Vos Données Personnelles Client peuvent être transférées et traitées dans tout pays dans lequel Runner AI, ses sociétés affiliées ou des prestataires de services tiers sont situés. Tout transfert de Vos Données Personnelles Client vers ces destinataires sera effectué en conformité avec les Lois Applicables sur la Protection des Données. Pour plus d'informations sur les transferts internationaux de données, lorsque Runner AI est soumis aux exigences de protection des données dans l'EEE, le RU ou la Suisse, voir la Section II(B)(8) de l'Annexe C.
#### B. Réponse aux Demandes Légales
1. Vous reconnaissez que, dans le cadre de la fourniture des Services, Runner AI peut partager Vos Données Personnelles Client (i) pour se conformer aux exigences légales ou pour répondre à des ordonnances judiciaires ou autres demandes gouvernementales ou réglementaires similaires ; ou (ii) pour prévenir ou enquêter sur une fraude présumée, des menaces à la sécurité physique, une activité illégale ou des violations d'un contrat (tel que les Conditions d'Utilisation) ou de nos politiques (telle que notre Politique d'Utilisation Acceptable).
2. Runner AI fera des efforts raisonnables avant de produire Vos Données Personnelles Client pour s'assurer qu'une telle divulgation est permise en vertu des Lois Applicables sur la Protection des Données et sera traitée comme information confidentielle en vertu du cadre juridique applicable.
#### C. Divulgation dans les Transactions Corporatives
Vous reconnaissez que, dans le cadre de la fourniture des Services, Runner AI peut être tenu de partager Vos Données Personnelles Client avec des contreparties potentielles à toute transaction corporative ou de restructuration.
#### D. Utilisation par Runner AI de Prestataires de Services
1. Vous reconnaissez et acceptez que, dans le cadre de la fourniture des Services, Runner AI peut utiliser des prestataires de services pour traiter Vos Données Personnelles Client. Runner AI maintient une liste mise à jour de tous les prestataires de services utilisés. Si les Lois Applicables sur la Protection des Données vous accordent de tels droits, Vous pouvez vous opposer à l'utilisation par Runner AI d'un prestataire de services, et si Runner AI est incapable ou refuse d'accommoder de telles demandes, Vous pouvez, conformément à ces lois, résilier Votre utilisation des Services impactés dans les 30 jours suivant cette notification conformément aux Conditions.
2. L'utilisation par Runner AI de prestataires de services pour traiter Vos Données Personnelles Client que Vous fournissez sera en conformité avec les Lois Applicables sur la Protection des Données. Lorsque Runner AI engage un prestataire de services, Runner AI conclura un accord écrit avec le prestataire de services qui impose des obligations contractuelles substantiellement identiques à celles énoncées dans cet ATD.
#### E. Modification de l'ATD
Vous reconnaissez et acceptez que Runner AI peut modifier cet ATD de temps à autre en publiant l'ATD modifié et révisé pertinent sur le site web de Runner AI, disponible à https://www.runnerai.com/docs/fr/legal/dpa et ces modifications à l'ATD sont effectives à compter de la date de publication. Votre utilisation continue des Services après la publication de l'ATD modifié sur le site web de Runner AI constitue Votre accord et acceptation de l'ATD modifié. Si Vous n'êtes pas d'accord avec les modifications à l'ATD, ne continuez pas à utiliser les Services.
### VI. ANNEXES
1. [Annexe A - Catégories de Données Personnelles](#annexe-a--catégories-de-données-personnelles)
2. [Annexe B - Sécurité des Données](#annexe-b--sécurité-des-données)
3. [Annexe C - RGPD, UK GDPR et Annexe de Traitement des Données de la Suisse](#annexe-d--lois-américaines-sur-la-protection-des-données)
4. [Annexe D - Lois Américaines sur la Protection des Données](#annexe-d--lois-américaines-sur-la-protection-des-données)
5. [Annexe E - Runner AI en tant que Responsable du Traitement ou Entreprise pour les Services Améliorés](#annexe-e--runner-ai-en-tant-que-responsable-du-traitement-ou-entreprise-pour-les-services-améliorés)
---
## ANNEXE A : CATÉGORIES DE DONNÉES PERSONNELLES
Dans le cadre de Votre utilisation des Services, et selon les Services que Vous utilisez, nous pouvons recevoir et traiter les catégories de Données Personnelles suivantes pour fournir les Services :
- Identifiants, y compris nom, adresse e-mail, adresse postale, numéro de téléphone
- Catégories d'informations personnelles énumérées dans le statut des dossiers clients de Californie, y compris nom, adresse postale et de facturation, numéro de téléphone, informations de carte de crédit ou de débit
- Informations commerciales, y compris les produits que vous achetez, placez dans votre panier, favoris ou évaluez (si vous êtes un client) et les informations que vous nous fournissez sur vous et votre entreprise (si vous êtes un commerçant)
- Photos et vidéos, qui peuvent inclure des images de visage, si vous choisissez de les fournir
- Informations sur l'activité du réseau Internet ou électronique, y compris des informations concernant l'appareil et le navigateur que vous utilisez, la connexion réseau, l'adresse IP et la façon dont vous naviguez sur nos sites
- Données de géolocalisation, y compris votre adresse postale et de facturation
- Inférences, ou informations dérivées d'autres informations personnelles vous concernant, qui pourraient inclure vos préférences, intérêts et autres informations utilisées pour personnaliser votre expérience
- Informations personnelles sensibles, qui peuvent inclure :
- Identifiants émis par le gouvernement, y compris numéro de sécurité sociale, permis de conduire, carte d'identité d'État ou numéro de passeport
- Vos identifiants d'accès au compte (tels que la connexion au compte, le compte financier, le numéro de carte de débit ou de crédit en combinaison avec tout code d'accès de sécurité requis, mot de passe ou identifiants permettant l'accès à un compte)
---
## ANNEXE B : SÉCURITÉ DES DONNÉES
Runner AI maintiendra un programme de sécurité de l'information conçu pour (a) Vous permettre de sécuriser Vos Données Personnelles Client contre le traitement non autorisé ou illégal et contre la perte, la destruction, les dommages, le vol, l'altération ou la divulgation accidentels ; (b) identifier les risques raisonnablement prévisibles pour la sécurité et la disponibilité des Services que Vous recevez ; et (c) minimiser les risques de sécurité pour les Services.
### I. Le programme de sécurité de l'information de Runner AI comprendra les protections suivantes :
#### A. Sécurité Logique
##### 1. Contrôles d'Accès
Runner AI rendra ses systèmes accessibles uniquement au personnel autorisé, et uniquement dans la mesure nécessaire pour maintenir et fournir les Services. Runner AI maintiendra des contrôles d'accès et des politiques conçus pour gérer les autorisations d'accès à ses systèmes, notamment par l'utilisation de pare-feu et/ou d'autres technologies et contrôles d'authentification.
##### 2. Accès Utilisateur Restreint
Runner AI (i) provisionnera et restreindra l'accès à ses systèmes conformément aux principes de moindre privilège basés sur les fonctions de travail du personnel, et (ii) exigera une authentification à deux facteurs (2FA) pour l'accès à ses systèmes.
##### 3. Évaluations de Vulnérabilité
Runner AI maintiendra un programme d'évaluation de vulnérabilité et de tests d'intrusion, responsable de l'investigation et du suivi des problèmes identifiés avec les Services jusqu'à leur résolution lorsque nécessaire.
##### 4. Sécurité des Applications
Runner AI maintient un programme de sécurité des applications responsable de la protection des Services contre les menaces de sécurité des applications.
##### 5. Gestion du Changement
Runner AI maintiendra des contrôles conçus pour enregistrer, autoriser, tester, approuver et documenter les modifications aux ressources des Services existants, et documentera les détails des modifications dans ses outils de gestion des modifications ou de déploiement. Runner AI testera les modifications conformément à ses normes de gestion des modifications avant la migration vers la production.
##### 6. Intégrité des Données
Le cas échéant, Runner AI maintiendra des contrôles conçus pour fournir l'intégrité des données pendant la transmission, le stockage et le traitement dans les Services.
##### 7. Disponibilité
Runner AI (i) mettra en œuvre la redondance le cas échéant pour les Services afin de minimiser l'effet d'un dysfonctionnement sur les Services, (ii) concevra les Services pour anticiper et tolérer les défaillances, et (iii) mettra en œuvre des processus appropriés conçus pour déplacer le trafic de Données Personnelles loin des zones affectées lorsque nécessaire pour récupérer des défaillances.
##### 8. Continuité des Activités et Reprise après Sinistre
Runner AI maintiendra un programme de gestion des risques conçu pour soutenir la continuité de ses fonctions commerciales critiques, y compris des processus et procédures pour l'identification, la réponse et la récupération des événements qui pourraient empêcher ou altérer matériellement la fourniture par Runner AI des Services que Vous recevez.
##### 9. Gestion des Incidents
Runner AI fournit une documentation pour Vous permettre de signaler des incidents de sécurité ou de disponibilité, de poser des questions sur la sécurité ou la disponibilité, et de soumettre des informations sur les problèmes potentiels de sécurité ou de disponibilité. Runner AI maintiendra des plans d'action corrective et des plans de réponse aux incidents conçus pour détecter, atténuer, enquêter et répondre aux menaces de sécurité potentielles pour les Services.
#### B. Sécurité Physique
Lorsque nécessaire pour protéger les Services, Runner AI (i) mettra en œuvre des mesures raisonnables conçues pour prévenir l'accès physique non autorisé, les dommages ou les interférences aux Services, (ii) utilisera des dispositifs de contrôle appropriés conçus pour restreindre l'accès physique aux Services uniquement au personnel autorisé qui a un besoin commercial légitime pour un tel accès, et (iii) effectuera des révisions périodiques pour valider le respect de ces normes.
#### C. Employés de Runner AI
Les employés de Runner AI qui sont autorisés à accéder à Vos Données Personnelles Client sont liés par des obligations de confidentialité dans le cadre de leurs conditions d'emploi. Runner AI mettra en œuvre et maintiendra des programmes de formation à la sécurité des employés concernant les exigences de sécurité de l'information de Runner AI. Les programmes de formation à la sensibilisation à la sécurité seront révisés et mis à jour périodiquement.
### II. Modifications de cette Annexe
Runner AI révise ses mesures de sécurité de temps à autre, et peut mettre à jour cette Annexe à sa seule discrétion. Toute mise à jour remplacera les versions antérieures de cette Annexe à compter de la date à laquelle Runner AI publie la version mise à jour.
---
## ANNEXE C : RGPD, UK GDPR ET ANNEXE DE TRAITEMENT DES DONNÉES DE LA SUISSE
Lorsque le traitement de Vos Données Personnelles Client en vertu de l'ATD est soumis aux exigences de protection des données dans l'Espace Économique Européen (l'"EEE"), le Royaume-Uni (le "RU") ou la Suisse (collectivement, "Lois Européennes sur la Protection des Données"), et que Runner AI agit en tant que Sous-traitant, l'Annexe C complète cet ATD.
### I. Nature du Traitement et Rôle des Parties
#### A. Données Personnelles
En vertu de cette Annexe, Vous agirez en tant que Responsable du Traitement et Runner AI agira en tant que Sous-traitant en ce qui concerne le traitement de Vos Données Personnelles Client tel que décrit à l'Addendum 1, tel que nécessaire pour remplir les finalités commerciales décrites dans les Conditions et Vous fournir les Services que Vous choisissez d'utiliser.
### II. Obligations des Parties
#### A. Vos Obligations
Vous vous conformerez :
- Aux Lois Européennes sur la Protection des Données qui Vous lient en relation avec Votre utilisation des Services ; et
- À Vos obligations énoncées dans l'ATD, y compris Vos obligations énoncées dans cette Annexe.
Vous déclarez et garantissez que Vous disposez d'une base juridique valide pour traiter Vos Données Personnelles Client (y compris la mise à disposition de ces données à Runner AI) et avez obtenu tous les consentements, droits et autorisations nécessaires et donné tous les avis nécessaires aux personnes pour permettre le traitement par Runner AI de Vos Données Personnelles Client pour fournir les Services, tel que requis par les Lois Européennes sur la Protection des Données.
#### B. Obligations de Runner AI
##### 1. Instructions du Responsable du Traitement et Violation des Lois Européennes sur la Protection des Données
a) Les Parties conviennent que les Conditions ainsi que cet ATD constituent Vos instructions documentées concernant le traitement par Runner AI de Vos Données Personnelles Client ("Instructions documentées").
b) Runner AI traitera Vos Données Personnelles Client en tant que Sous-traitant : (i) conformément à Vos Instructions documentées, ou (ii) pour se conformer aux obligations de Runner AI en vertu des lois applicables, sous réserve de toute exigence de notification en vertu de la loi de l'EEE, d'un État membre de l'EEE, du RU ou de la Suisse à laquelle Runner AI est soumis.
c) Runner AI Vous notifiera s'il reçoit une instruction qu'il détermine raisonnablement viole les Lois Européennes sur la Protection des Données (mais Runner AI n'a aucune obligation de surveiller activement Votre conformité avec les Lois Européennes sur la Protection des Données).
##### 2. Obligation de confidentialité
Runner AI veillera à ce que les personnes qu'il autorise à traiter Vos Données Personnelles Client concluent des accords de confidentialité écrits ou soient soumises à des obligations légales de confidentialité.
##### 3. Mesures de sécurité
a) Runner AI mettra en œuvre et maintiendra des mesures techniques et organisationnelles appropriées conçues pour protéger Vos Données Personnelles Client contre le traitement non autorisé ou illégal et contre la perte, la destruction, les dommages, le vol, l'accès non autorisé, l'altération ou la divulgation accidentels, tel qu'énoncé à l'Addendum 2.
b) Compte tenu de la nature de Vos Données Personnelles Client et du traitement associé, Runner AI fournira l'assistance raisonnable que Vous pouvez raisonnablement demander pour Vous aider à remplir Vos obligations de sécurité en vertu des Lois Européennes sur la Protection des Données.
c) Runner AI Vous fournira un avis, sans retard indu, dès qu'il prendra connaissance d'une violation de sécurité conduisant à la destruction, la perte, l'altération, la divulgation non autorisée ou l'accès accidentel ou illégal à Vos Données Personnelles Client transmises, stockées ou autrement traitées.
d) Runner AI accepte d'enquêter sur toute violation de sécurité et d'utiliser des efforts commercialement raisonnables pour atténuer les effets.
##### 4. Sous-traitants ultérieurs
a) Vous autorisez généralement Runner AI à engager des Sous-traitants ultérieurs pour traiter Vos Données Personnelles Client. Vous acceptez en outre que Runner AI puisse engager ses sociétés affiliées en tant que Sous-traitants ultérieurs.
b) L'utilisation par Runner AI de Sous-traitants ultérieurs pour traiter Vos Données Personnelles Client sera en conformité avec les Lois Européennes sur la Protection des Données.
c) Runner AI maintient une liste mise à jour de tous les Sous-traitants ultérieurs tel qu'énoncé à l'Addendum 3. Runner AI mettra à jour la liste des Sous-traitants ultérieurs le cas échéant et Vous fournira un mécanisme pour obtenir un avis de l'ajout ou du remplacement d'un Sous-traitant ultérieur. Vous pouvez vous opposer à l'utilisation par Runner AI d'un nouveau Sous-traitant ultérieur.
d) Dans la mesure où Vous vous opposez à l'utilisation par Runner AI d'un Sous-traitant ultérieur, et que Runner AI est incapable ou refuse d'accommoder de telles demandes, Vous pouvez résilier Votre utilisation des Services impactés dans les 30 jours suivant cette notification conformément aux Conditions.
e) Lorsque Runner AI engage un nouveau Sous-traitant ultérieur, Runner AI conclura un accord écrit avec le Sous-traitant ultérieur et Runner AI imposera, au Sous-traitant ultérieur, des obligations contractuelles substantiellement identiques à celles énoncées dans cet ATD. Runner AI sera pleinement responsable des actes et omissions de ses Sous-traitants ultérieurs dans la même mesure que Runner AI serait responsable s'il effectuait les services de chaque Sous-traitant ultérieur directement en vertu des termes de cet ATD. La responsabilité de Runner AI sera néanmoins soumise aux conditions et limitations de responsabilité énoncées dans les Conditions.
##### 5. Assistance au Responsable du Traitement
Compte tenu de la nature de Vos Données Personnelles Client et du traitement associé, Runner AI fournira l'assistance raisonnable que Vous pouvez raisonnablement demander pour Vous aider à Vous conformer à Vos obligations :
- De répondre aux Demandes d'Exercice de Droits en vertu des Lois Européennes sur la Protection des Données, en ce qui concerne tout traitement de Vos Données Personnelles Client par Runner AI ;
- De notifier les autorités compétentes et/ou les personnes concernées d'une Violation de Données Personnelles ;
- De réaliser des analyses d'impact sur la protection des données et des consultations préalables ;
- D'assurer la sécurité du traitement conformément à la section 3.
##### 6. Évaluation de la conformité
a) Runner AI peut satisfaire à Votre droit d'audit en vertu des Lois Européennes sur la Protection des Données en relation avec le traitement de Vos Données Personnelles Client en Vous fournissant - sur Votre demande écrite et sous réserve de confidentialité - :
(i) Les résultats du rapport d'audit le plus récent de Runner AI, provenant soit des auto-audits de Runner AI soit préparés par un auditeur tiers indépendant ;
(ii) Des informations supplémentaires sous le contrôle de Runner AI si une autorité de protection des données ou gouvernementale le demande.
b) Dans la mesure où et uniquement dans la mesure où les Lois Européennes sur la Protection des Données Vous accordent ce droit, Vous pouvez exercer Votre droit d'audit : (i) dans la mesure où un auditeur internationalement reconnu indépendant atteste que la fourniture par Runner AI d'un rapport d'audit ne fournit pas suffisamment d'informations pour Vous permettre de vérifier la conformité de Runner AI avec cet ATD et avec les Lois Européennes sur la Protection des Données ou (ii) tel que nécessaire pour Vous permettre de répondre à un audit d'une autorité gouvernementale. Chaque audit doit se conformer aux paramètres suivants : (i) être mené par un tiers indépendant qui conclura un accord de confidentialité avec Runner AI ; (ii) être limité en portée aux questions raisonnablement requises, et telles que convenues mutuellement, pour Vous permettre d'évaluer la conformité de Runner AI avec cet ATD et la conformité des parties avec les Lois Européennes sur la Protection des Données ; (iii) se produire à une date et une heure convenues mutuellement et uniquement pendant les heures de bureau régulières de Runner AI ; (iv) se produire pas plus d'une fois par an (sauf si requis en vertu des Lois Européennes sur la Protection des Données) ; (v) couvrir uniquement les installations contrôlées par Runner AI ; (vi) restreindre les résultats à Vos Données Personnelles Client uniquement ; et (vii) traiter tous les résultats comme des informations confidentielles dans toute la mesure permise par les Lois Européennes sur la Protection des Données. Pour clarification, Runner AI se conformera à tous Vos droits en vertu de cette section 6 conformément à ses obligations de confidentialité avec des tiers.
##### 7. Fin du traitement
a) Pendant Votre utilisation des Services, Vous pouvez utiliser les outils de compte pour accéder, Vous retourner ou supprimer Vos Données Personnelles Client.
b) Après la résiliation, Runner AI, à Votre choix, supprimera ou Vous retournera Vos Données Personnelles Client. Nonobstant ce qui précède, Runner AI peut conserver Vos Données Personnelles Client : (i) tel que requis par la loi, y compris les Lois Européennes sur la Protection des Données ; et (ii) conformément à ses politiques de sauvegarde ou de conservation des dossiers standard, à condition que, dans l'un ou l'autre cas, Runner AI maintienne la confidentialité de, et se conforme par ailleurs aux dispositions applicables de cet ATD en ce qui concerne, Vos Données Personnelles Client conservées, et ne Traitera pas davantage Vos Données Personnelles Client conservées sauf pour cette (ces) finalité(s) et durée permises en vertu de ces lois applicables.
##### 8. Transferts Internationaux
a) Vous reconnaissez que dans le cadre de la fourniture des Services, Adaptive Machines, Inc., une société basée aux États-Unis, traitera Vos Données Personnelles Client sur des serveurs situés aux États-Unis.
b) Lorsque Runner AI s'engage dans un Transfert International (c'est-à-dire un transfert de Vos Données Personnelles Client de l'Espace Économique Européen (EEE), du Royaume-Uni (RU) ou de la Suisse vers un pays en dehors de ces régions qui n'est pas reconnu comme fournissant un niveau adéquat de protection des données), il le fera en conformité avec les Lois Européennes sur la Protection des Données.
c) Dans la mesure où Runner AI est le destinataire de Vos Données Personnelles Client dans un pays qui n'assure pas un niveau adéquat de protection des données, les Parties conviennent que ces transferts seront soumis à des garanties appropriées, spécifiquement les mécanismes de transfert suivants : (i) Les Clauses Contractuelles Types pour le transfert de données personnelles vers des pays tiers conformément au Règlement (UE) 2016/679 du Parlement européen et du Conseil, tel qu'approuvé par la Décision d'Exécution (UE) 2021/914 de la Commission européenne du 4 juin 2021 (les "CCT UE") ; et/ou (ii) Pour les transferts depuis le Royaume-Uni, l'Addendum de Transfert International de Données aux clauses contractuelles types de la Commission européenne, émis par le Bureau du Commissaire à l'Information du RU en vertu de l'article S119A(1) de la Loi sur la Protection des Données du RU de 2018 (l'"Addendum RU") ; et/ou (iii) Pour les transferts depuis la Suisse, les CCT UE telles que modifiées pour satisfaire aux exigences de la Loi Fédérale Suisse sur la Protection des Données.
d) En acceptant cet ATD, vous êtes réputé avoir signé les mécanismes de transfert applicables, qui sont incorporés par référence et forment une partie intégrante de cet ATD.
### ADDENDUM 1 - DONNÉES PERSONNELLES
#### DESCRIPTION DU TRAITEMENT DES DONNÉES PERSONNELLES
**I. Objet du Traitement**
Fourniture des Services Runner AI au Commerçant.
**II. Catégories de Personnes Concernées**
Clients du Commerçant.
**III. Catégories de Données Personnelles Traitées**
Voir Annexe A ci-dessus.
**IV. Fréquence du transfert**
Continue.
**V. Nature du Traitement**
Collecte, enregistrement, hébergement, accès, utilisation, transfert et suppression de Données Personnelles tel que décrit dans les Conditions.
**VI. Finalités pour Lesquelles les Données Personnelles sont Traitées pour le Compte du Responsable du Traitement**
Pour l'exécution et l'amélioration des Services tel que décrit dans les Conditions.
**VII. Durée du Traitement**
Durée des Services en vertu des Conditions ou de l'accord applicable, plus la période après cette expiration jusqu'à l'anonymisation, le retour ou la suppression des données.
**VIII. Autorité de Contrôle Compétente**
L'autorité de contrôle compétente sera déterminée conformément au RGPD.
### ADDENDUM 2 - MESURES DE SÉCURITÉ
Les informations sur les mesures de sécurité sont fournies à l'Annexe B de l'ATD.
### ADDENDUM 3 - LISTE DES SOUS-TRAITANTS ULTÉRIEURS
Les Sous-traitants ultérieurs utilisés par Runner AI pour l'exécution des Services en vertu des Conditions sont énumérés ici.
Les Sous-traitants ultérieurs traiteront les catégories de Données Personnelles décrites ci-dessus dans le cadre des Services pendant la durée de leur accord avec Runner AI.
---
## ANNEXE D : LOIS AMÉRICAINES SUR LA PROTECTION DES DONNÉES
Cette section s'applique uniquement dans la mesure où : (i) les Lois Américaines sur la Protection des Données s'appliquent à Vous et/ou à Vos Données Personnelles Client dans le cadre de Votre utilisation des Services ; (ii) les dispositions suivantes sont requises par les Lois Américaines sur la Protection des Données ; et (iii) Runner AI agit en tant que Sous-traitant ou Prestataire de Services. Pour éviter toute ambiguïté, cette Annexe D ne s'appliquera pas aux activités de traitement décrites à l'Annexe E.
Les Parties conviennent que les Conditions ainsi que cet ATD constituent Vos instructions documentées concernant le traitement par Runner AI de Vos Données Personnelles Client ("Instructions documentées").
Outre ce qui est énoncé à l'Annexe E si vous recevez certains Services Améliorés, Runner AI ne : (i) conservera, utilisera ou divulguera Vos Données Personnelles Client en dehors de sa relation commerciale directe avec Vous ou pour toute autre finalité autre que pour les finalités limitées et spécifiées identifiées dans cet ATD et/ou les Conditions, y compris pour fournir, développer et améliorer les Services ou tel que permis autrement par les Lois Américaines Applicables sur la Protection des Données, ou (ii) "vendra" ou "partagera" Vos Données Personnelles Client ou s'engagera dans de la "publicité ciblée" avec Vos Données Personnelles Client au sens de la CCPA ou d'autres Lois Américaines sur la Protection des Données ; ou (iii) combinera Vos Données Personnelles Client avec des Données Personnelles qu'il reçoit d'autres sources, dans chaque cas sauf tel que permis en vertu des Lois Américaines sur la Protection des Données.
Runner AI : (i) fournira le même niveau de protection de la vie privée requis des Entreprises ou Responsables du Traitement par les Lois Américaines sur la Protection des Données, et Vous informera s'il détermine qu'il ne peut plus respecter ces obligations, auquel cas Vous pouvez prendre des mesures raisonnables et appropriées pour arrêter ou remédier à tout traitement non autorisé de Vos Données Personnelles Client, (ii) veillera à ce que le personnel qu'il autorise à traiter Vos Données Personnelles Client conclue des accords de confidentialité écrits ou soit soumis à des obligations légales de confidentialité, (iii) sur demande écrite raisonnable, et dans le cadre de Vous permettre de prendre des mesures raisonnables et appropriées pour assurer que Runner AI utilise Vos Données Personnelles Client d'une manière cohérente avec les Lois Américaines sur la Protection des Données, fournira le rapport SOC2 montrant une évaluation raisonnable du programme de sécurité de l'information de Runner AI ; et (iv) à la résiliation de ses Services pour Vous, Runner AI lancera son processus de purge pour supprimer, retourner ou désidentifier Vos Données Personnelles Client fournies à Runner AI pour traitement uniquement en tant que Sous-traitant ou Prestataire de Services.
Vous déclarez et garantissez que Vous ne partagerez pas avec Runner AI de Données Personnelles d'une personne qui a exercé un droit de refus que Vous vous êtes engagé à honorer ou de données personnelles sensibles d'une personne qui n'a pas consenti au traitement de ces données sensibles conformément aux exigences en vertu des Lois Applicables sur la Protection des Données.
---
## ANNEXE E : RUNNER AI EN TANT QUE RESPONSABLE DU TRAITEMENT OU ENTREPRISE POUR LES SERVICES AMÉLIORÉS
Runner AI agira en tant que Responsable du Traitement ou Entreprise lorsque Vous recevez les Services Améliorés tel que défini dans la Section 9 des Conditions d'Utilisation. Runner AI peut mettre à jour les services et produits pour lesquels il agit en tant que Responsable du Traitement ou Entreprise de temps à autre.
Dans le cadre de la fourniture par Runner AI des Services Améliorés, vous acceptez que Runner AI traitera Vos Données Personnelles Client en tant que Responsable du Traitement ou Entreprise en vertu des Lois Applicables sur la Protection des Données afin de fournir, développer et améliorer l'analytique, la personnalisation des produits, la publicité et d'autres services à Vous et à d'autres Commerçants qui incorporent les interactions et transactions de Vos Clients avec Votre Boutique, avec d'autres Commerçants et avec Runner AI. Lorsque Runner AI traite Vos Données Personnelles Client de cette manière, la Politique de Confidentialité Consommateur de Runner AI et cette Annexe E de cet ATD s'appliquent. Vous pouvez désactiver l'utilisation par Runner AI de Vos Données Personnelles Client de cette manière en désactivant Runner AI Network Intelligence ici.
### 1. Avis de Confidentialité, Transparence et Droits
Conformément aux Lois Applicables sur la Protection des Données, Vous communiquerez aux personnes concernées toutes les divulgations nécessaires pour que Runner AI traite légalement et équitablement Vos Données Personnelles Client pour Vous fournir des Services Améliorés dans le cadre de cette Annexe E de l'ATD, y compris en fournissant un lien vers la Politique de Confidentialité Consommateur de Runner AI dans votre politique de confidentialité et en fournissant les divulgations tel qu'énoncé dans la Section 9.2.5 des Conditions d'Utilisation.
### 2. Exigences Européennes
Si Vous êtes basé dans l'EEE, le Royaume-Uni ou la Suisse, ou si Vos Clients sont dans l'EEE, le Royaume-Uni ou la Suisse, Vous acceptez, déclarez et garantissez que vous avez obtenu le consentement des Clients, et fournissez aux Clients la capacité d'exercer le droit de retirer le consentement, de s'opposer à certains traitements et de refuser certains traitements, lorsque requis par les Lois Applicables sur la Protection des Données. Pour éviter toute ambiguïté, vous devez obtenir le consentement pour la publicité ciblée dans le cadre des Services Améliorés, et l'utilisation de cookies ou d'autres technologies de stockage local dans la mesure requise par les Lois Applicables sur la Protection des Données.
### 3. Responsabilités des Responsables du Traitement
Vous êtes un Responsable du Traitement de Vos Données Personnelles Client et déterminerez individuellement les finalités et les moyens de Votre traitement de Vos Données Personnelles Client et comment utiliser et traiter Vos Données Personnelles Client, y compris la détermination de la base juridique de Votre traitement en vertu de la Loi Applicable sur la Protection des Données. Runner AI est un Responsable du Traitement de Vos Données Personnelles Client qu'il traite conformément à cette Annexe E et déterminera individuellement les finalités et les moyens de son traitement de ces Données Personnelles et comment utiliser et traiter ces Données Personnelles, y compris la détermination de la base juridique de son traitement en vertu de la Loi Applicable sur la Protection des Données.
Chaque Partie est individuellement responsable de répondre aux Demandes d'Exercice de Droits qu'elle reçoit concernant son traitement de Vos Données Personnelles Client en tant que Responsable du Traitement.
### 4. Aucun Effet sur le Reste de l'ATD
Cette Annexe E n'affectera pas autrement les Conditions, y compris le reste de cet ATD, reflétant une relation Responsable du Traitement-Sous-traitant entre les Commerçants et Runner AI.
---
# Politique de confidentialité pour tous
Source: https://www.runnerai.com/docs/fr/legal/policies
## Table des matières
1. [Introduction](#introduction)
2. [Nos valeurs](#nos-valeurs)
3. [Pourquoi nous traitons vos informations](#pourquoi-nous-traitons-vos-informations)
4. [Vos droits sur vos informations](#vos-droits-sur-vos-informations)
5. [Où nous envoyons vos informations](#où-nous-envoyons-vos-informations)
6. [Google user data and Google integrations](#google-user-data-and-google-integrations)
7. [Combien de temps conservons-nous vos informations](#combien-de-temps-conservons-nous-vos-informations)
8. [Notre utilisation de l'apprentissage automatique](#notre-utilisation-de-lapprentissage-automatique)
9. [Comment nous protégeons vos informations](#comment-nous-protégeons-vos-informations)
10. [Comment nous utilisons les "cookies" et autres technologies de suivi](#comment-nous-utilisons-les-cookies-et-autres-technologies-de-suivi)
11. [Comment nous contacter](#comment-nous-contacter)
12. [Avis de confidentialité régional pour les États-Unis](#avis-de-confidentialité-régional-pour-les-états-unis)
13. [Informations supplémentaires pour les utilisateurs de certaines régions](#informations-supplémentaires-pour-les-utilisateurs-de-certaines-régions)
## Introduction
Cette Politique de confidentialité décrit comment Adaptive Machines, Inc. ("Runner AI", "nous", "notre" ou "nos") collecte, utilise et divulgue les informations personnelles lorsque vous utilisez notre site Web et nos services.
Dans notre mission de rendre le commerce meilleur pour tous chez Runner AI, nous collectons et utilisons des informations vous concernant, nos :
- commerçants utilisant Runner AI pour alimenter leur entreprise
- clients qui achètent dans une entreprise alimentée par Runner AI
- visiteurs des sites Web de Runner AI, ou toute personne contactant le support de Runner AI
Si nous modifions nos pratiques en matière de confidentialité, nous pourrons mettre à jour cette politique de confidentialité. Si des changements sont significatifs, nous vous en informerons (par exemple, via l'administration Runner AI ou par e-mail).
## Nos valeurs
La confiance est le fondement de la plateforme Runner AI et inclut le fait de nous faire confiance pour faire ce qu'il faut avec vos informations. Trois valeurs principales nous guident lors du développement de nos produits et services. Ces valeurs devraient vous aider à mieux comprendre comment nous pensons à vos informations et à votre vie privée.
### Vos informations vous appartiennent
Nous analysons soigneusement les types d'informations dont nous avons besoin pour fournir nos services, et nous essayons de limiter les informations que nous collectons à ce dont nous avons vraiment besoin. Dans la mesure du possible, nous supprimons ou anonymisons ces informations lorsque nous n'en avons plus besoin. Lors de la construction et de l'amélioration de nos produits, nos ingénieurs travaillent en étroite collaboration avec nos équipes de confidentialité et de sécurité pour concevoir en tenant compte de la vie privée. Dans tout ce travail, notre principe directeur est que vos informations vous appartiennent, et nous visons à utiliser vos informations uniquement à votre avantage.
### Nous protégeons vos informations contre les autres
Si un tiers demande vos informations personnelles, nous refuserons de les partager à moins que vous ne nous donniez la permission ou que nous y soyons légalement obligés. Lorsque nous sommes légalement tenus de partager vos informations personnelles, nous vous en informerons à l'avance, sauf si cela nous est légalement interdit.
### Nous aidons les commerçants à respecter leurs obligations en matière de confidentialité
De nombreux commerçants utilisant Runner AI ne bénéficient pas d'une équipe dédiée à la confidentialité, et il est important pour nous de les aider à respecter leurs obligations en matière de confidentialité. Pour ce faire, nous essayons de concevoir nos produits et services afin qu'ils puissent être facilement utilisés de manière respectueuse de la vie privée. Nous fournissons également des FAQ détaillées et de la documentation couvrant les sujets de confidentialité les plus importants, et répondons aux questions liées à la confidentialité que nous recevons.
## Pourquoi nous traitons vos informations
Nous traitons généralement vos informations lorsque nous devons le faire pour remplir une obligation contractuelle (par exemple, pour traiter vos paiements d'abonnement pour utiliser la plateforme Runner AI), ou lorsque nous ou quelqu'un avec qui nous travaillons devons utiliser vos informations personnelles pour une raison liée à leur activité (par exemple, pour vous fournir un service). Les lois de l'Espace économique européen ("EEE") et du Royaume-Uni ("RU") appellent ces raisons des "intérêts légitimes". Ces "intérêts légitimes" comprennent :
- la prévention des risques et de la fraude
- la réponse aux questions ou la fourniture d'autres types de support
- la fourniture et l'amélioration de nos produits et services
- la fourniture de rapports et d'analyses
- le test de fonctionnalités ou de services supplémentaires
- l'assistance au marketing, à la publicité ou à d'autres communications
Nous ne traitons les informations personnelles pour ces "intérêts légitimes" qu'après avoir examiné les risques potentiels pour votre vie privée et équilibré ces risques avec certaines mesures - par exemple, en fournissant une transparence claire sur nos pratiques en matière de confidentialité, en vous offrant un contrôle sur vos informations personnelles lorsque cela est approprié, en limitant les informations que nous conservons, en limitant ce que nous faisons avec vos informations, à qui nous envoyons vos informations, combien de temps nous conservons vos informations, ou les mesures techniques que nous utilisons pour protéger vos informations.
Nous pouvons également traiter vos informations personnelles lorsque vous avez donné votre consentement. En particulier, lorsque nous ne pouvons pas nous appuyer sur une base juridique alternative pour le traitement, lorsque vous nous demandez de transférer des informations à un tiers, lorsque nous recevons vos données d'un tiers qui les a déjà accompagnées d'un consentement, ou lorsque nous sommes tenus par la loi de demander votre consentement (y compris dans le contexte de certaines de nos activités de vente et de marketing). À tout moment, vous avez le droit de retirer votre consentement en modifiant vos choix de communication, en vous désabonnant de nos communications ou en nous contactant.
Selon que vous êtes un commerçant, un client ou un visiteur, veuillez vous référer à nos politiques de confidentialité supplémentaires, le cas échéant, pour comprendre nos finalités de traitement, les catégories de destinataires et la base juridique du traitement pour chaque type de données personnelles.
## Vos droits sur vos informations
Nous pensons que vous devriez pouvoir accéder et contrôler vos informations personnelles, peu importe où vous vivez. Selon la façon dont vous utilisez Runner AI, vous pouvez avoir le droit de demander l'accès à, corriger, modifier, supprimer, transférer vers un autre fournisseur de services, restreindre ou vous opposer à certaines utilisations de vos informations personnelles. Nous ne vous facturerons pas plus ou ne vous fournirons pas un niveau de service différent si vous exercez l'un de ces droits. Veuillez noter qu'un certain nombre de ces droits ne s'appliquent que dans certaines circonstances, et tous ces droits peuvent être limités par la loi.
Si vous achetez quelque chose ou fournissez vos informations à une boutique alimentée par Runner AI et souhaitez exercer ces droits sur les informations concernant votre achat ou interaction, vous devez contacter directement le commerçant avec lequel vous avez interagi. Nous sommes un sous-traitant et traitons les informations en leur nom. Nous aiderons bien sûr nos commerçants à satisfaire ces demandes dans la mesure requise par la loi, par exemple en leur donnant les outils pour le faire et en répondant à leurs questions.
Si vous êtes un commerçant, un employé de Runner AI, un visiteur de site Web ou toute autre personne avec laquelle Runner AI a une relation directe, veuillez soumettre une demande vérifiable en nous envoyant un e-mail à support@adaptivemachines.ai. Veuillez noter que si vous nous envoyez une demande concernant vos informations personnelles, nous devons nous assurer qu'il s'agit bien de vous avant de pouvoir répondre. Pour ce faire, nous pouvons utiliser un tiers pour collecter et vérifier les documents d'identification. De plus amples informations sur les droits disponibles pour les résidents américains se trouvent ci-dessous sous l'en-tête "Avis de confidentialité régional pour les États-Unis".
Enfin, comme il n'y a pas de compréhension commune de ce qu'un signal "Ne pas suivre" est censé signifier, nous ne répondons pas à ces signaux d'une manière particulière.
## Où nous envoyons vos informations
Nous sommes une entreprise américaine, mais nous travaillons avec et traitons des données sur des individus du monde entier. Pour exploiter notre entreprise, nous pouvons envoyer vos informations personnelles en dehors de votre État, province ou pays. Ces données peuvent être soumises aux lois des pays où nous les envoyons. Nous prenons des mesures pour protéger vos informations lorsque nous les envoyons au-delà des frontières.
Selon que vous êtes un commerçant, un client, un utilisateur ou un visiteur, veuillez vous référer à nos politiques de confidentialité supplémentaires, le cas échéant.
Enfin, bien que nous fassions ce que nous pouvons pour protéger vos informations, nous pouvons parfois être légalement tenus de divulguer vos informations personnelles (par exemple, si nous recevons une ordonnance judiciaire valide).
Lorsque nous transférons des informations personnelles depuis l'Espace économique européen (EEE), le Royaume-Uni ou la Suisse vers des pays qui n'ont pas été jugés fournir un niveau adéquat de protection des données, nous nous appuyons sur des mécanismes juridiques tels que les Clauses contractuelles types approuvées par la Commission européenne pour sauvegarder le transfert.
## Google user data and Google integrations
This section applies when you use Google Sign-In or connect Google Ads, Google Merchant Center, or another Google service to Runner AI.
### What Google user data we access and store
For Google Sign-In, we access the Google account information you authorize, such as your name, email address, profile image, and Google account identifier, to create or log in to your Runner AI account.
For Google Ads and Google Merchant Center integrations, we request the Google OAuth scopes needed to provide the ads features you choose, including `https://www.googleapis.com/auth/adwords` and `https://www.googleapis.com/auth/content`. Depending on the features you use, we may store OAuth access tokens, refresh tokens, granted scopes, token expiration data, accessible Google Ads customer account identifiers, account names, manager-account status, and selected account bindings. We may also access and process Google Ads campaign, ad group, ad, creative, asset, budget, bidding, targeting, performance metric, conversion value, ROAS, and change-history data, including the user email associated with a Google Ads account change, as well as Google Merchant Center account identifiers and account names.
### How we use Google user data
We use Google user data only to provide or improve user-facing Runner AI features that you request, including signing you in, connecting and refreshing your Google integrations, listing selectable Google Ads and Merchant Center accounts, showing ads dashboards and reports, generating requested AI ads analysis or campaign drafts, publishing or updating campaigns you approve, syncing account access, and troubleshooting or securing those features.
We do not sell Google user data. We do not use Google user data for retargeting, personalized advertising unrelated to your requested Runner AI ads features, credit-worthiness, lending, or transfer to data brokers or information resellers.
### With whom we share, transfer, or disclose Google user data
We share, transfer, or disclose Google user data only in the following circumstances:
- **Google LLC.** We send authorization codes, OAuth tokens, developer-token-authenticated requests, campaign settings, Merchant Center identifiers, and related API request data to Google APIs so that we can authenticate your account, read the Google Ads or Merchant Center data you authorized, and perform the Google Ads or Merchant Center actions you request.
- **Your authorized Runner AI organization users.** Google Ads account metadata, reports, metrics, creatives, change history, Merchant Center account metadata, and campaign drafts may be visible to users in your Runner AI organization according to their workspace permissions.
- **Service providers and subprocessors.** We may share Google user data with service providers that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI, subject to confidentiality and data-processing obligations. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- **Legal, safety, and business-transfer recipients.** We may disclose Google user data when required by law, to protect rights, safety, and security, to investigate abuse, or in connection with a merger, acquisition, financing, reorganization, bankruptcy, or sale of assets, as described elsewhere in this Privacy Policy.
Except as described above or with your explicit direction, we do not share, transfer, or disclose Google user data to third-party advertising platforms, data brokers, information resellers, or other third parties.
### Retention and user control
We retain connected Google integration tokens and account metadata while the integration remains enabled or as needed to provide the Services, comply with law, resolve disputes, enforce agreements, maintain security, or keep backups. Disconnecting Google Ads in Runner AI deletes the active Google Ads integration record, including stored OAuth tokens and account metadata. You can also revoke Runner AI's Google access from your Google account settings.
Runner AI's use and transfer of information received from Google APIs will adhere to the [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy), including the Limited Use requirements.
## Combien de temps conservons-nous vos informations
Nous ne conserverons vos données personnelles que pendant la durée nécessaire pour atteindre les finalités pour lesquelles nous les avons collectées. Pour déterminer la période de conservation appropriée, nous prenons en compte la quantité, la nature et la sensibilité de vos données personnelles, le risque potentiel de préjudice résultant d'une utilisation ou d'une divulgation non autorisée de vos données personnelles, les finalités pour lesquelles nous traitons vos données personnelles et si nous pouvons atteindre ces finalités par d'autres moyens, ainsi que les exigences légales applicables. Nous conserverons et utiliserons également vos informations personnelles dans la mesure nécessaire pour nous conformer à nos obligations légales, résoudre les litiges et appliquer nos politiques. Si vous cessez d'utiliser nos services ou si vous supprimez votre compte chez nous, nous supprimerons vos informations ou stockerons vos informations sous une forme agrégée et anonymisée.
Selon que vous êtes un commerçant, un client, un utilisateur ou un visiteur, veuillez vous référer à nos politiques de confidentialité supplémentaires, le cas échéant, pour plus de détails sur la conservation de vos informations personnelles.
## Notre utilisation de l'apprentissage automatique
Pour fournir nos fonctionnalités avancées alimentées par l'IA pour les opérations automatisées et la croissance, notre plateforme utilise l'apprentissage automatique. Nous utilisons ces technologies pour fournir des services tels que l'analyse prédictive, les suggestions de campagnes marketing et les recommandations d'optimisation des conversions.
Nos fonctionnalités d'IA sont conçues comme des outils d'aide à la décision. Elles génèrent des suggestions basées sur les données pour votre considération. Ce ne sont pas des décisions automatisées. Vous, le commerçant, conservez le contrôle total et êtes seul responsable de l'examen, de l'approbation et de la mise en œuvre de toute suggestion fournie par notre IA. Le Service n'exécutera des actions qu'après votre approbation explicite ou en fonction des paramètres que vous avez préconfigurés. Notre base juridique pour l'utilisation de vos données à ces fins est détaillée dans nos Conditions de service sous la clause "Utilisation des données pour l'amélioration de l'IA".
## Comment nous protégeons vos informations
Nos équipes travaillent sans relâche pour protéger vos informations et pour assurer la sécurité et l'intégrité de notre plateforme. Nous avons également des auditeurs indépendants qui évaluent la sécurité de notre stockage de données et des systèmes qui traitent les informations financières. Cependant, nous savons tous qu'aucune méthode de transmission sur Internet et aucune méthode de stockage électronique ne peuvent être sûres à 100 %. Cela signifie que nous ne pouvons pas garantir la sécurité absolue de vos informations personnelles.
## Comment nous utilisons les "cookies" et autres technologies de suivi
Nous utilisons des cookies et des technologies de suivi similaires sur notre site Web et lors de la fourniture de nos services. Pour plus d'informations sur la façon dont nous utilisons ces technologies, y compris une liste d'autres entreprises qui placent des cookies sur nos sites, une liste de cookies que nous plaçons lorsque nous alimentons la boutique d'un commerçant, et une explication de la façon dont vous pouvez refuser certains types de cookies, veuillez consulter notre Politique en matière de cookies.
## Comment nous contacter
Si vous souhaitez poser des questions, faire une demande concernant, ou vous plaindre de la façon dont nous traitons vos informations personnelles, veuillez contacter le Support de Runner AI par e-mail à support@adaptivemachines.ai, ou nous envoyer un courrier aux adresses ci-dessous :
Adaptive Machines, Inc.
2911 Noyce Place, 189, Santa Clara, CA 95051, USA
Si vous achetez quelque chose ou fournissez vos informations à une boutique alimentée par Runner AI, le commerçant est votre responsable du traitement des données et nous agissons en tant que sous-traitant en son nom.
Si vous avez des questions sur la façon dont un commerçant ou une boutique traite vos informations personnelles, vous devez contacter le commerçant ou consulter sa politique de confidentialité.
## Avis de confidentialité régional pour les États-Unis
Cet Avis de confidentialité régional pour les États-Unis ("Avis américain") complète notre Politique de confidentialité et toutes les politiques de confidentialité supplémentaires sur /fr/legal/policies (ensemble, les "Politiques de confidentialité de Runner AI").
Cet Avis américain s'adresse aux personnes résidant dans certains États américains et est conçu pour vous aider à mieux comprendre comment nous collectons, utilisons et divulguons vos informations personnelles et, selon la façon dont vous utilisez Runner AI et où vous résidez, comment exercer les droits disponibles en vertu de diverses lois applicables sur la confidentialité aux États-Unis, en particulier la California Consumer Privacy Act, la Colorado Privacy Act, la Connecticut Act Concerning Personal Data Privacy and Online Monitoring, la Utah Consumer Privacy Act et la Virginia Consumer Data Protection Act (collectivement, les "Lois américaines sur la confidentialité").
### 11.1 Quelles informations nous collectons et partageons à votre sujet
Pour vous fournir nos services, nous devons traiter des informations vous concernant, y compris des informations personnelles.
Nous ne "vendons" pas vos informations personnelles tel que ce terme est défini en vertu des Lois américaines sur la confidentialité.
Voici un résumé des catégories d'informations personnelles que nous pouvons collecter à votre sujet à l'avenir et avec qui nous avons pu divulguer ces informations, selon la façon dont vous utilisez Runner AI.
| Catégories d'informations personnelles collectées | Destinataires des informations personnelles |
|----------------------------------------------|-------------------------------------|
| Identifiants, y compris nom, adresse e-mail, adresse postale, numéro de téléphone ; | Entreprises qui nous aident à vous fournir nos services, y compris les fournisseurs de stockage cloud, les processeurs de paiement, les partenaires d'exécution, les fournisseurs de sécurité, les fournisseurs de courrier électronique, les places de marché et les fournisseurs d'analyse de données ; |
| Catégories d'informations personnelles répertoriées dans le statut des dossiers clients de Californie, y compris nom, adresse postale et de facturation, numéro de téléphone, informations de carte de crédit ou de débit ; | Annonceurs et fournisseurs de marketing ; |
| Informations commerciales, y compris les produits que vous achetez, placez dans votre panier, favoris ou évaluez (si vous êtes un client) et les informations que vous nous fournissez sur vous et votre entreprise (si vous êtes un commerçant) ; | Commerçants dont vous visitez les boutiques ou auprès desquels vous effectuez des achats ; |
| Photos et vidéos, qui peuvent inclure des images de visage, si vous choisissez de les fournir. | Partenaires qui vous aident à utiliser nos Services, tels que les fournisseurs de paiement ou de logistique que vous choisissez d'intégrer à votre Boutique. |
| Informations sur l'activité du réseau Internet ou électronique, y compris les informations concernant l'appareil et le navigateur que vous utilisez, la connexion réseau, l'adresse IP et la façon dont vous naviguez sur nos sites ; | Forces de l'ordre ou autres tiers en relation avec des demandes légales, pour se conformer à la loi applicable ou pour prévenir tout préjudice. |
| Données de géolocalisation, y compris votre adresse postale et de facturation ; | |
| Inférences, ou informations dérivées d'autres informations personnelles vous concernant, qui pourraient inclure vos préférences, intérêts et autres informations utilisées pour personnaliser votre expérience ; | |
| Autres informations que vous fournissez ; et | |
| Informations personnelles sensibles, qui peuvent inclure : Identifiants émis par le gouvernement, y compris numéro de sécurité sociale, permis de conduire, carte d'identité d'État ou numéro de passeport ; Vos identifiants d'accès au compte (tels que la connexion au compte, le compte financier, le numéro de carte de débit ou de crédit en combinaison avec tout code d'accès de sécurité requis, mot de passe ou identifiants permettant l'accès à un compte) ; | |
### 11.2 Pourquoi nous collectons et partageons vos informations personnelles
Nous utilisons et partageons vos informations personnelles aux fins énoncées dans les Politiques de confidentialité de Runner AI. Pour les catégories d'informations personnelles sensibles que nous collectons, nous n'utilisons ou ne divulguons ces informations qu'avec votre consentement spécifique lorsque cela est requis, ou comme autrement permis par la loi.
### 11.3 Sources d'informations personnelles
Pour rendre le commerce meilleur pour tous chez Runner AI, nous collectons et utilisons des informations personnelles fournies par :
**Vous :** Nous collectons les informations que vous fournissez lorsque vous utilisez notre plateforme, y compris lorsque vous vous inscrivez à Runner AI en tant que commerçant, visitez une boutique alimentée par Runner AI, remplissez des informations de commande, visitez l'un des sites Web de Runner AI ou contactez le Support de Runner AI. Nous collectons les informations de compte et de paiement que vous nous fournissez (y compris des informations sur votre entreprise si vous êtes un commerçant), les boutiques Runner AI ou les articles que vous enregistrez dans vos favoris, les achats que vous effectuez, les avis que vous publiez, et la façon dont vous interagissez ou communiquez autrement avec les boutiques ou d'autres utilisateurs sur nos services. Nous collectons également des informations sur la façon dont vous naviguez sur nos sites, y compris les termes de recherche que vous pouvez entrer.
**Vos appareils :** Nous collectons des informations provenant de et concernant les appareils que vous utilisez, y compris les ordinateurs, les téléphones et autres appareils connectés au Web que vous utilisez pour accéder à nos services, et nous combinons ces informations sur différents appareils que vous utilisez.
**Tiers :** Nous recevons des informations de partenaires qui nous aident à vous fournir nos services, notamment les suivants :
- **Fournisseurs de services.** Nous recevons des informations de nos fournisseurs de services, qui nous aident à fournir des services à nos commerçants, comme l'examen des comptes pour fraude ou autres préoccupations.
- **Sous-traitants.** Nous travaillons avec des sous-traitants tiers pour l'hébergement cloud, la diffusion de contenu, l'analyse de données, la journalisation interne, les services d'exécution et la transmission d'e-mails, entre autres, pour vous fournir nos services. Pour plus d'informations, consultez les sous-traitants de Runner AI.
- **Fournisseurs d'analyses et de cookies.** Nous recevons des informations grâce à notre utilisation de cookies, de plugins sociaux (tels que le bouton "j'aime" de Facebook), de pixels et de balises à des fins commerciales, comme fournir des informations pour aider à mesurer comment les utilisateurs interagissent avec le contenu de notre site Web. Pour plus d'informations sur la façon dont nous utilisons ces technologies, consultez notre Politique en matière de cookies.
### 11.4 Combien de temps conservons-nous vos informations
Parce que nous avons besoin de vos informations personnelles pour fournir les services de Runner AI, nous conservons généralement vos informations personnelles, y compris les informations personnelles sensibles, tant que vous utilisez les produits ou services de Runner AI ou jusqu'à ce que vous nous demandiez de supprimer vos informations. Nous pouvons également conserver des informations personnelles pour nous conformer à des obligations légales ou protéger nos intérêts ou ceux d'autres personnes.
Si vous êtes un commerçant exploitant une boutique alimentée par Runner AI, et que vous fermez la boutique, cessez de payer vos frais d'abonnement, ou que nous résilions votre compte, nous conservons les informations de la boutique pendant deux ans avant de commencer le processus de suppression.
Lorsque vous visitez ou effectuez un achat dans une boutique alimentée par Runner AI d'un commerçant, nous agissons en tant que fournisseur de services ou sous-traitant pour le commerçant, et le commerçant, et non Runner AI, décide combien de temps vos informations sont conservées.
### 11.5 Vos droits sur vos informations
Selon l'endroit où vous vivez, la façon dont vous utilisez Runner AI, et sous réserve de certaines exceptions, vous pouvez avoir certains ou tous les droits suivants :
- **Droit de savoir :** Le droit de demander que nous vous divulguions les informations personnelles que nous collectons, utilisons ou divulguons à votre sujet, les sources à partir desquelles nous collectons vos informations personnelles et les informations sur nos pratiques en matière de données.
- **Droit de demander une correction :** Le droit de demander que nous corrigions les informations personnelles inexactes que nous conservons à votre sujet.
- **Droit de demander la suppression :** Le droit de demander que nous supprimions toutes les informations personnelles que nous avons collectées à votre sujet.
Pour exercer vos droits, y compris le "droit de savoir" et le "droit de suppression", veuillez soumettre une demande via support@adaptivemachines.ai.
Si vous avez visité ou effectué un achat dans une boutique alimentée par Runner AI d'un commerçant, veuillez contacter directement le commerçant spécifique. Si vous nous faites une demande, nous transmettrons votre demande au commerçant concerné.
Veuillez noter que pour protéger vos informations et l'intégrité de nos produits et services, nous pouvons avoir besoin de vérifier votre identité avant de traiter votre demande. Dans certains cas, nous pouvons avoir besoin de collecter des informations supplémentaires pour vérifier votre identité, telles que votre adresse e-mail ou une pièce d'identité émise par le gouvernement.
En vertu des Lois américaines sur la confidentialité, vous pouvez également désigner un agent autorisé pour faire ces demandes en votre nom. Si vous utilisez un agent autorisé pour soumettre une demande, nous pouvons avoir besoin de collecter des informations supplémentaires, telles qu'une pièce d'identité émise par le gouvernement, pour vérifier votre identité avant de traiter votre demande afin de protéger vos informations.
Dans certains États, vous pouvez avoir le droit de faire appel de notre décision concernant une demande liée à ces droits. Si vous souhaitez faire appel d'une décision, veuillez contacter le Support de Runner AI.
Nous ne ferons pas de discrimination à votre encontre pour avoir exercé l'un de ces droits.
## Informations supplémentaires pour les utilisateurs de certaines régions
### Pour les utilisateurs de l'Espace économique européen (EEE), du Royaume-Uni et de la Suisse :
Si vous êtes dans l'EEE, au Royaume-Uni ou en Suisse, nous ne traitons vos données personnelles que lorsque nous avons une base juridique valide. Pour les informations où nous sommes le Responsable du traitement (par exemple, pour nos Commerçants et Visiteurs de sites Web), nos bases juridiques comprennent :
- **Exécution d'un contrat :** Pour vous fournir nos Services tels que décrits dans nos Conditions de service.
- **Intérêt légitime :** Pour des finalités telles que la sécurité, l'amélioration de la plateforme et le marketing, lorsque nos intérêts ne sont pas supplantés par vos droits en matière de protection des données.
- **Consentement :** Pour des utilisations spécifiques, telles que l'envoi d'e-mails marketing ou le placement de cookies non essentiels, où nous demandons votre consentement.
- **Obligation légale :** Pour nous conformer à nos obligations légales.
### Pour les utilisateurs en Californie :
Si vous êtes un résident de Californie, vous avez des droits en vertu du CCPA/CPRA, y compris le droit de savoir, de supprimer, de corriger et le droit de refuser la vente ou le partage de vos informations personnelles à des fins de publicité comportementale intercontextuelle. Vous pouvez exercer ce droit à tout moment en cliquant sur le lien "Ne pas vendre ou partager mes informations personnelles" dans le pied de page de notre site Web ou en gérant vos préférences en matière de cookies.
---
# Politique de confidentialité pour les consommateurs
Source: https://www.runnerai.com/docs/fr/legal/policies/consumers
## Table des matières
1. [Introduction](#introduction)
2. [Quelles données personnelles nous recevons](#quelles-données-personnelles-nous-recevons)
3. [Comment nous utilisons vos données personnelles](#comment-nous-utilisons-vos-données-personnelles)
4. [Comment nous traitons vos données personnelles au nom des commerçants Runner AI](#comment-nous-traitons-vos-données-personnelles-au-nom-des-commerçants-runner-ai)
5. [Tiers qui peuvent recevoir des données personnelles](#tiers-qui-peuvent-recevoir-des-données-personnelles)
6. [Partenaires et intégrations tiers](#partenaires-et-intégrations-tiers)
7. [Vos droits et choix en matière de confidentialité](#vos-droits-et-choix-en-matière-de-confidentialité)
8. [Conservation](#conservation)
9. [Comment nous contacter](#comment-nous-contacter)
10. [Modifications de cette politique de confidentialité](#modifications-de-cette-politique-de-confidentialité)
## Introduction
Cette politique de confidentialité décrit les données personnelles que Runner AI reçoit et/ou traite (ce qui peut inclure la collecte, l'organisation, la structuration, le stockage, l'utilisation ou la divulgation) lorsque vous interagissez avec Runner AI ou utilisez les Services aux consommateurs Runner AI, tels que définis dans les Conditions de service pour les consommateurs, y compris lors de vos achats auprès d'un commerçant qui utilise ou est alimenté par la plateforme de Runner AI ("Commerçants Runner AI" ou "Commerçants"). De plus, veuillez consulter notre [politique de confidentialité générale](/fr/legal/policies) qui s'applique à toute personne dont nous traitons les informations. Si des dispositions de cette politique entrent en conflit avec des dispositions de la politique de confidentialité générale, les dispositions de cette politique s'appliqueront.
## Quelles données personnelles nous recevons
Les Données personnelles désignent toute information provenant de ou concernant une personne identifiée ou identifiable, mais n'incluent pas les informations agrégées ou anonymisées. Nous recevons des Données personnelles lorsque vous utilisez ou interagissez avec Runner AI ou les services Runner AI, qui peuvent inclure les catégories suivantes :
### 1. Informations de profil et de contact
Nous recevons des informations de contact ou d'autres informations de profil lorsque vous vous inscrivez ou interagissez avec les Services aux consommateurs Runner AI, qui peuvent inclure le numéro de téléphone, l'adresse e-mail ou d'autres informations que vous choisissez de nous fournir. Nous pouvons lier ces informations aux différents appareils ou comptes que vous utilisez lorsque vous interagissez avec Runner AI ou utilisez les Services aux consommateurs Runner AI.
### 2. Informations sur l'appareil
Nous recevons des informations sur les ordinateurs, téléphones et autres appareils que vous utilisez ou avec lesquels vous interagissez avec Runner AI ou les Services aux consommateurs Runner AI, y compris l'adresse IP (qui peut être utilisée pour déterminer l'emplacement général), les identifiants d'appareil, les identifiants de cookies, le navigateur que vous utilisez, votre connexion réseau ou d'autres identifiants uniques ou informations sur l'appareil.
### 3. Informations de paiement
Nous recevons des informations de paiement lorsque vous effectuez un achat via Runner AI ou les Commerçants Runner AI, telles que votre numéro de carte de paiement et sa date d'expiration.
### 4. Utilisation des Services aux consommateurs Runner AI
Nous recevons des informations concernant votre utilisation ou vos interactions avec les Services aux consommateurs Runner AI, que vous soyez connecté ou non à Runner AI, telles que vos interactions avec les Commerçants Runner AI, la ou les Boutique(s) que vous visitez, les produits que vous consultez et visitez, les avis et évaluations de produits que vous publiez et partagez, votre historique de commandes, d'autres activités marketing liées aux Services aux consommateurs Runner AI, et les Boutiques mises en favoris.
### 5. Paramètres et préférences de confidentialité
Nous recevons des informations sur vos paramètres et préférences sur Runner AI et chez nos Commerçants, ainsi que des informations sur les paramètres de confidentialité de votre navigateur et de votre appareil.
### 6. Communications avec Runner AI
Nous recevons des informations, y compris le contenu des messages et des e-mails, lorsque vous communiquez avec Runner AI (par exemple pour les demandes de support client, la participation à des enquêtes, la participation à des promotions ou des recherches).
### 7. Comptes de réseaux sociaux
Si vous choisissez de lier, connecter ou vous connecter aux Services aux consommateurs Runner AI via un service en ligne tiers, vous demandez à ce service de nous envoyer certaines informations vous concernant contrôlées par ce service, telles que des informations de profil. Ce partage est soumis aux avis de confidentialité applicables et aux paramètres de confidentialité de ce service.
## Comment nous utilisons vos données personnelles
Runner AI utilise les Données personnelles aux fins suivantes selon la façon dont vous interagissez avec nous ou quels services Runner AI vous utilisez et en fonction de votre activité sur tous les appareils où vous vous connectez ou interagissez avec Runner AI ou les services Runner AI :
### 1. Fournir, améliorer et personnaliser les services Runner AI
Pour vous fournir des services Runner AI personnalisés, notamment en affichant votre historique d'achat et l'état de vos commandes en un seul endroit, en fournissant des options de paiement faciles lorsque vous faites des achats, en recommandant des produits, des Commerçants et des Boutique(s) et en personnalisant les produits mis en avant pour vous, et pour améliorer les services Runner AI, notamment en fonction de votre utilisation des Services aux consommateurs Runner AI et de votre activité avec nos Commerçant(s).
### 2. Suivre et mettre en œuvre vos préférences et paramètres de confidentialité
Pour suivre et mettre en œuvre vos paramètres et préférences de confidentialité avec Runner AI et nos Commerçants.
### 3. Effectuer des recherches et développement de produits
Pour développer, tester et améliorer les services Runner AI, y compris le dépannage de nos produits et services, le développement de services Runner AI nouveaux ou améliorés, et l'analyse de votre utilisation et de vos interactions avec les services Runner AI.
### 4. Faire de la publicité, du marketing et de la promotion pour Runner AI
Pour commercialiser, faire de la publicité et promouvoir les services Runner AI sur et en dehors de Runner AI, y compris pour des communications ou des publicités personnalisées relatives aux services Runner AI sur des services tiers.
### 5. Fournir de la publicité personnalisée pour nos Commerçants
Pour fournir des services publicitaires à nos Commerçants, qui peuvent inclure de la publicité personnalisée.
### 6. Communiquer avec vous
Pour communiquer avec vous au sujet des services Runner AI, y compris les mises à jour de produits, votre compte et les modifications de nos politiques et conditions. Nous utilisons également vos informations pour vous répondre lorsque vous nous contactez.
### 7. Authentification, intégrité, sécurité et sûreté
Pour authentifier votre compte, fournir une expérience de paiement et d'achat sécurisée, et pour détecter, enquêter et prévenir les comportements malveillants, les activités frauduleuses ou les expériences dangereuses, traiter les menaces de sécurité, protéger la sécurité publique et sécuriser les Services Runner AI pour vous et nos Commerçants.
### 8. Raisons légales
Pour nous conformer à la loi applicable ou répondre à des procédures légales valides, y compris les demandes des forces de l'ordre ou des agences gouvernementales, pour enquêter ou participer à des découvertes civiles, des litiges ou d'autres procédures judiciaires contradictoires, et pour faire respecter ou enquêter sur d'éventuelles violations de nos conditions ou politiques.
Runner AI peut également agréger, dé-identifier et/ou anonymiser toute information collectée via les services Runner AI de telle sorte que nous ne pouvons raisonnablement pas lier les informations à vous ou à votre appareil. Nous pouvons utiliser ces informations agrégées, dé-identifiées ou anonymes à toute fin, y compris, par exemple, pour améliorer le service Runner AI.
## Comment nous traitons vos données personnelles au nom des commerçants Runner AI
Runner AI traite également vos Données personnelles provenant des Commerçants avec lesquels vous interagissez ou chez lesquels vous achetez afin d'aider les Commerçants à gérer leur(s) Boutique(s) et à fournir des services commerciaux à nos Commerçants. Lorsque Runner AI traite des Données personnelles de cette manière, nous agissons selon les instructions du Commerçant, et les conditions de service et la politique de confidentialité du Commerçant s'appliquent - pas celles de Runner AI. Pour plus d'informations sur la façon dont les Commerçants collectent et utilisent les informations personnelles lorsque vous visitez et effectuez des achats dans leur(s) Boutique(s), consultez les conditions et la politique de confidentialité du Commerçant.
De plus, certains Commerçants peuvent nous demander d'utiliser les Données personnelles qu'ils partagent avec nous pour de la publicité ciblée pour ces Commerçants et d'autres utilisant ces services sur des sites tiers. Vous pouvez avoir la possibilité de refuser qu'un Commerçant partage vos informations avec nous à ces fins directement sur le site de ce Commerçant.
## Tiers qui peuvent recevoir des données personnelles
Selon les services Runner AI que vous utilisez ou avec lesquels vous interagissez, Runner AI peut fournir des Données personnelles aux catégories de tiers suivantes :
### 1. Fournisseurs
Runner AI travaille avec des fournisseurs de services tiers pour fournir, soutenir et améliorer les services Runner AI et l'infrastructure technique, pour des services commerciaux tels que le traitement des paiements, y compris en relation avec les achats effectués lorsque vous utilisez les Services Runner AI, et pour le marketing et l'analyse commerciale.
### 2. Partenaires marketing, publicitaires et d'analyse
Nous pouvons utiliser des partenaires tiers de marketing, de publicité et d'analyse commerciale pour diffuser de la publicité personnalisée et pour nous aider à comprendre comment les gens utilisent ou interagissent avec les services Runner AI et nos Commerçants. Ces partenaires peuvent recevoir des informations sur votre utilisation ou vos interactions avec les services Runner AI, y compris par le biais de cookies tiers ou d'autres technologies.
### 3. Changement de contrôle
Nous pouvons partager des Données personnelles avec des acquéreurs potentiels ou réels, leurs représentants et d'autres participants pertinents dans, ou lors de négociations de, toute vente, fusion, acquisition, restructuration ou changement de contrôle impliquant tout ou partie de l'activité ou des actifs de Runner AI, y compris en relation avec une faillite ou des procédures similaires.
### 4. Raisons légales
Nous pouvons partager des Données personnelles selon les besoins pour : (1) faire respecter ou enquêter sur d'éventuelles violations de ses Conditions de service ou de ses politiques ; (2) nous conformer à la loi applicable ou répondre à, enquêter sur ou participer à des procédures et processus légaux valides, y compris des forces de l'ordre ou des agences gouvernementales ; (3) protéger nos droits et propriétés ainsi que ceux de nos Commerçants et utilisateurs ; (4) respecter nos engagements en matière de responsabilité sociale et d'entreprise ; (5) détecter, prévenir ou enquêter sur d'éventuelles fraudes, abus ou problèmes de sécurité et de sûreté, y compris les menaces pour le public ; et (6) résoudre les litiges et faire respecter les accords.
### 5. Partage à votre discrétion
Lorsque vous donnez votre consentement, nous partageons vos informations comme décrit au moment du consentement, par exemple lors de la connexion avec une application ou un site Web tiers.
## Partenaires et intégrations tiers
Certaines parties des services Runner AI peuvent renvoyer à des services tiers. Runner AI ne possède ni ne contrôle ces tiers. Lorsque vous interagissez avec ces tiers et choisissez d'utiliser leurs services, votre utilisation est soumise aux politiques de confidentialité de ces fournisseurs.
## Vos droits et choix en matière de confidentialité
Vous pouvez avoir certains droits pour gérer vos Données personnelles selon l'endroit où vous vivez. Selon votre juridiction, les droits suivants peuvent s'appliquer, sous réserve de certaines exceptions :
### 1. Accès et portabilité
Droit de demander l'accès à vos Données personnelles.
### 2. Correction / Rectification
Droit de corriger les Données personnelles inexactes ou incomplètes dans certaines circonstances.
### 3. Suppression / Effacement
Droit de supprimer les Données personnelles vous concernant.
### 4. Droit de refuser le "partage" pour la publicité comportementale intercontextuelle ou la publicité ciblée
Droit de refuser le "partage" de vos Données personnelles pour la publicité comportementale intercontextuelle ou la publicité ciblée (tel que décrit plus en détail dans la section Tiers qui peuvent recevoir des Données personnelles).
Vous pouvez également mettre à jour les informations de votre compte dans vos paramètres de l'application. Pour désactiver ou supprimer votre compte, envoyez un e-mail à support@adaptivemachines.ai. Vous pouvez avoir des droits supplémentaires disponibles. La demande peut être soumise par e-mail à support@adaptivemachines.ai. De plus, veuillez consulter notre [politique de confidentialité générale](/fr/legal/policies) pour plus d'informations.
## Conservation
Nous conservons les Données personnelles aussi longtemps que nous avons un besoin commercial continu de le faire (par exemple, pour fournir les services Runner AI, pour nous conformer aux exigences légales, fiscales ou comptables applicables, pour la sécurité et la détection ou la prévention de la fraude, ou en relation avec les processus de sauvegarde ou de reprise après sinistre), sauf si une période de conservation différente est autorisée ou requise par la loi applicable.
Les critères utilisés pour déterminer nos périodes de conservation comprennent les éléments suivants :
1. La durée pendant laquelle nous avons une relation continue avec vous et vous fournissons les services Runner AI (par exemple, tant que vous avez un compte chez nous ou continuez à utiliser nos services) ;
2. Si vous modifiez ou supprimez vos informations via vos comptes ;
3. Si Runner AI a une obligation légale de conserver les données (par exemple, certaines lois obligent Runner AI à conserver des enregistrements de vos transactions pendant une certaine période) ; ou
4. Si la conservation est conseillée compte tenu de notre position juridique (par exemple en ce qui concerne l'exécution de nos accords, la résolution de litiges, les délais de prescription applicables, les litiges ou les enquêtes réglementaires).
## Comment nous contacter
Si vous souhaitez exercer vos droits, ou si vous avez des questions ou des préoccupations liées à cette Politique de confidentialité, vous pouvez nous contacter par support@adaptivemachines.ai.
## Modifications de cette politique de confidentialité
Nous pouvons mettre à jour cette Politique de confidentialité périodiquement pour tenir compte des changements dans notre collecte et/ou traitement de Données personnelles, et nous publierons la Politique de confidentialité mise à jour sur notre site Web, avec une date "Dernière mise à jour" en haut.
---
# Politique de confidentialité pour les commerçants
Source: https://www.runnerai.com/docs/fr/legal/policies/merchants
## Table des matières
1. [Introduction](#introduction)
2. [Quelles informations nous collectons à votre sujet et pourquoi](#quelles-informations-nous-collectons-à-votre-sujet-et-pourquoi)
3. [Quand et pourquoi nous partageons vos informations avec d'autres](#quand-et-pourquoi-nous-partageons-vos-informations-avec-dautres)
4. [Google Ads and Google Merchant Center integrations](#google-ads-and-google-merchant-center-integrations)
5. [Vos droits concernant vos informations](#vos-droits-concernant-vos-informations)
6. [Combien de temps conservons-nous vos informations](#combien-de-temps-conservons-nous-vos-informations)
7. [Les informations de vos clients](#les-informations-de-vos-clients)
## Introduction
Si vous êtes un commerçant utilisant Runner AI pour soutenir votre entreprise, nous collectons et utilisons vos informations personnelles pour vous donner accès à notre plateforme et à ses services, et généralement pour vous aider à mieux gérer votre entreprise et vos relations avec les clients.
Lorsque nous traitons les informations personnelles de vos clients ("Utilisateurs finaux"), nous le faisons en tant que Sous-traitant en votre nom, vous le Commerçant. Vous, le Commerçant, êtes le Responsable du traitement pour les informations de vos Utilisateurs finaux. Cela signifie que vous êtes responsable de la conformité légale avec les lois applicables en matière de protection des données, y compris la fourniture de votre propre politique de confidentialité et l'obtention de tout consentement nécessaire de vos Utilisateurs finaux.
De plus, veuillez consulter notre [politique de confidentialité générale](/fr/legal/policies), qui s'applique à toute personne dont nous traitons les informations.
## Quelles informations nous collectons à votre sujet et pourquoi
Nous collectons des informations personnelles lorsque vous vous inscrivez à Runner AI, lorsque vous utilisez notre plateforme ou lorsque vous nous fournissez des informations autrement. Nous pouvons également utiliser des fournisseurs de services tiers pour nous aider à examiner les comptes pour détecter la fraude ou d'autres problèmes. En général, nous avons besoin d'informations vous concernant pour vous permettre d'utiliser notre plateforme. Nous traitons vos données personnelles pour remplir notre contrat avec vous, ou parce que le maintien de notre relation commerciale, la prévention des risques et de la fraude, la fourniture de services efficaces, l'amélioration de nos produits et services, et la réponse à vos demandes de service correspondent à nos intérêts légitimes. Dans certains cas, nous ne traiterons vos informations personnelles qu'avec votre consentement.
| Ce que nous collectons | Comment nous l'utilisons |
|-----------------|---------------|
| Informations que vous nous fournissez sur vous et votre entreprise, comme votre nom, le nom de votre personnel ou d'autres personnes associées à votre entreprise, le nom de l'entreprise, l'adresse, l'adresse e-mail et le numéro de téléphone. | Pour vous fournir l'utilisation de notre plateforme et d'autres services connexes (par exemple, pour confirmer votre identité, pour vous contacter concernant des problèmes avec la plateforme, pour vous facturer) Pour faire de la publicité et commercialiser des produits ou des fonctionnalités auprès de vous Pour se conformer aux exigences légales Pour prévenir l'utilisation frauduleuse de nos services |
| Informations de paiement que vous nous fournissez, telles que votre numéro de carte de crédit ou de débit ou votre numéro de compte bancaire. | Pour vous fournir l'utilisation de notre plateforme et d'autres services connexes Pour facturer nos services |
| Informations sur la façon dont vous accédez aux sites Web de Runner AI, à votre compte et à notre plateforme, y compris des informations sur l'appareil et le navigateur que vous utilisez, votre connexion réseau, votre adresse IP et des détails sur la façon dont vous naviguez sur nos sites Web et notre plateforme. Nous collectons certaines de ces informations en utilisant des "cookies" ou d'autres technologies similaires directement depuis votre appareil. Pour plus d'informations sur la façon dont nous utilisons ces technologies, consultez notre Politique en matière de cookies. | Pour vous fournir l'utilisation de notre plateforme et d'autres services connexes et pour les améliorer (par exemple, identifier des moyens de rendre notre plateforme plus facile à utiliser ou à naviguer) Pour faire de la publicité et commercialiser des produits ou des fonctionnalités auprès de vous Pour prévenir l'utilisation frauduleuse de nos services |
| Copies de documents d'identité émis par le gouvernement et/ou une photo de vous-même tenant votre identification que vous nous fournissez | Si nous devons vérifier votre identité (par exemple, pour vous protéger contre le vol d'identité ou la fraude) Pour vérifier que nous parlons avec vous si vous nous contactez Pour nous aider à déterminer ou à vérifier la propriété du compte Pour se conformer aux exigences légales |
| Google account, Google Ads, and Google Merchant Center information you authorize Runner AI to access, such as Google sign-in profile information, OAuth tokens and granted scopes, accessible Google Ads customer accounts, account names, manager-account status, selected account bindings, campaign and creative data, performance metrics, change history, and Merchant Center account identifiers and names. | To sign you in, connect and refresh your Google integrations, list selectable ad and Merchant Center accounts, show ads dashboards and reports, generate requested AI ads analysis or campaign drafts, publish or update campaigns you approve, sync account access, troubleshoot issues, and secure the integration. |
Nous travaillons également avec des entreprises qui nous fournissent des informations sur les commerçants ou les commerçants potentiels (par exemple, pour se protéger contre la fraude ou si nous parrainons un événement).
## Quand et pourquoi nous partageons vos informations avec d'autres
Gérer une entreprise est difficile, et nous travaillons avec plusieurs entreprises pour nous aider à vous fournir une gamme de services pour soutenir votre entreprise. Nous partageons parfois vos informations personnelles avec ces entreprises pour nous aider à vous fournir les services Runner AI.
Nous partageons également vos informations personnelles avec d'autres :
- Pour prévenir ou enquêter sur une fraude présumée, des menaces pour la sécurité physique, des activités illégales ou des violations de contrat ou de nos autres accords de site Web.
- Pour nous aider avec le marketing et la publicité.
- Pour nous conformer aux exigences légales, ou répondre à des ordonnances judiciaires ou à des demandes gouvernementales similaires.
- Pour les ventes ou achats d'actifs, les ventes, achats ou fusions d'actions, les faillites ou d'autres transactions commerciales ou réorganisations, nous partagerons vos données personnelles avec les acheteurs potentiels, les vendeurs, les nouveaux propriétaires ou d'autres tiers pertinents selon les besoins lors des négociations ou en relation avec un changement de contrôle de l'entreprise (tel qu'une réorganisation, une fusion ou une vente de nos actifs).
De plus, presque tous les commerçants utilisant la plateforme Runner AI utilisent également des services non-Runner AI pour soutenir leur entreprise (canaux de vente, passerelles de paiement ou fournisseurs d'expédition).
Runner AI n'a aucun contrôle sur la façon dont ces services utilisent vos informations personnelles, et vous devriez vérifier tous les autres services que vous utilisez pour vous assurer qu'ils répondent à vos attentes en matière de confidentialité.
## Google Ads and Google Merchant Center integrations
If you connect Google Ads or Google Merchant Center to Runner AI, we use the Google user data you authorize only to provide the connected ads features you request. We share, transfer, or disclose that Google user data only with:
- Google LLC, to exchange OAuth codes and tokens, call Google Ads and Merchant Center APIs, read the data you authorized, and perform the Google Ads or Merchant Center actions you request.
- Authorized users in your Runner AI organization, according to their workspace permissions.
- Service providers and subprocessors that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- Legal, safety, and business-transfer recipients when required by law or as described in our overall Privacy Policy.
We do not sell Google user data, and we do not share it with third-party advertising platforms, data brokers, or information resellers except as described above or with your explicit direction. For more detail, see [Google user data and Google integrations](/fr/legal/policies#google-user-data-and-google-integrations) in our overall Privacy Policy.
## Vos droits concernant vos informations
Vous pouvez accéder et corriger une grande partie de vos informations personnelles directement via votre administration Runner AI. Pour les informations que vous ne pouvez pas accéder ou corriger directement dans votre administration Runner AI, veuillez soumettre une demande de droit d'accès via notre support@adaptivemachines.ai. Pour plus d'informations, veuillez consulter notre [politique de confidentialité générale](/fr/legal/policies). Veuillez noter que certains droits d'accès ne s'appliquent que dans des circonstances spécifiques, et tous ces droits peuvent être limités par la loi.
## Combien de temps conservons-nous vos informations
Étant donné que nous avons besoin de vos informations personnelles pour fournir les services Runner AI, nous conservons généralement vos informations personnelles aussi longtemps que vous utilisez les produits ou services Runner AI. Si vous fermez votre boutique, cessez de payer les frais d'abonnement ou si nous résilions votre compte, nous conserverons les informations de la boutique pendant deux ans avant de commencer à supprimer ou à anonymiser les informations personnelles. Nous ne le ferons pas immédiatement si vous réactivez votre compte ou s'il y a des plaintes juridiques ou des audits liés à votre entreprise. Si vous nous contactez pour demander la suppression des informations de votre boutique, nous commencerons le processus de suppression ou d'anonymisation des informations personnelles après 90 jours, sauf si nous sommes tenus par la loi de conserver des informations spécifiques. Si vous avez des questions sur ce processus, veuillez contacter notre équipe de support par support@adaptivemachines.ai. Veuillez vous rappeler qu'après avoir anonymisé vos informations personnelles, nous pouvons continuer à utiliser des informations non identifiantes pour améliorer nos services.
## Les informations de vos clients
Pour aider à développer votre entreprise, nous collectons et utilisons des informations personnelles sur vos clients. En général, nous collectons et utilisons ces informations personnelles selon vos instructions. Légalement, nous sommes un "sous-traitant" et un "fournisseur de services", tels que ces termes sont utilisés dans certaines lois applicables sur la confidentialité, y compris celles des États-Unis, du Canada, de l'Europe et du Royaume-Uni.
Étant donné que vous décidez comment utiliser les informations personnelles de vos clients, vous devez vous assurer que vos clients comprennent comment vous (et comment nous en votre nom) collectez et traitons leurs informations personnelles. Pour ce faire, vous devriez au moins publier une politique de confidentialité dans votre boutique qui décrit les informations que vous collectez, comment vous les utilisez et avec qui vous les partagez.
Si vous collectez des informations personnelles "sensibles" auprès des clients (par exemple, des informations sur le numéro de sécurité sociale d'un consommateur, le permis de conduire, la carte d'identité d'État ou le numéro de passeport ; les informations de connexion au compte, les informations de compte financier, les numéros de carte de débit ou de crédit et tous les codes de sécurité ou mots de passe requis ; les informations de géolocalisation précise ; les données de santé ou génétiques, l'origine raciale ou ethnique, les croyances religieuses ou philosophiques ou l'appartenance syndicale ; le contenu du courrier, des e-mails ou des messages texte d'un consommateur ; ou les données d'infractions pénales), vous devriez obtenir le consentement explicite du client pour utiliser et traiter ces informations.
---
# Politique de confidentialité pour les visiteurs
Source: https://www.runnerai.com/docs/fr/legal/policies/visitors
## Table des matières
1. [Introduction](#introduction)
2. [Informations que nous collectons à votre sujet et pourquoi](#informations-que-nous-collectons-à-votre-sujet-et-pourquoi)
3. [Quand et pourquoi nous partageons vos informations avec d'autres](#quand-et-pourquoi-nous-partageons-vos-informations-avec-dautres)
4. [Vos droits concernant vos informations](#vos-droits-concernant-vos-informations)
## Introduction
Si vous visitez un site Web de Runner AI ou contactez le support client de Runner AI, nous utilisons généralement vos informations personnelles pour vous fournir le service spécifique que vous utilisez. De plus, veuillez consulter notre [Politique de confidentialité générale](/fr/legal/policies), qui s'applique à toute personne dont nous traitons les informations.
## Informations que nous collectons à votre sujet et pourquoi
Lorsque vous visitez nos sites Web ou contactez le support de Runner AI, nous collectons les informations personnelles suivantes vous concernant. Nous traitons vos données personnelles pour remplir nos obligations contractuelles envers vous, pour maintenir notre relation commerciale, prévenir les risques et la fraude, fournir des services efficaces, améliorer nos produits et services, et répondre à vos demandes conformément à nos intérêts légitimes. Dans certains cas, nous traitons vos informations personnelles uniquement avec votre consentement.
| Ce que nous collectons | Comment nous l'utilisons |
|-----------------|---------------|
| Informations que vous nous fournissez sur vous-même, comme votre nom, adresse, adresse e-mail et numéro de téléphone. | Pour vous fournir l'utilisation de l'application ou du service que vous essayez d'utiliser et pour l'améliorer (par exemple, pour confirmer votre identité, pour vous contacter concernant des problèmes avec la plateforme, pour vous facturer) Pour vérifier que nous parlons avec vous Pour faire de la publicité et commercialiser des produits ou des fonctionnalités auprès de vous Pour se conformer aux exigences légales |
| Informations de paiement que vous nous fournissez, telles que votre numéro de carte de paiement ou votre numéro de compte bancaire. | Pour vous permettre d'effectuer un paiement |
| Informations sur la façon dont vous accédez et utilisez les sites Web de Runner AI et d'autres services, y compris des informations sur l'appareil et le navigateur que vous utilisez, votre connexion réseau, votre adresse IP et des détails sur la façon dont vous naviguez sur nos sites, y compris les termes de recherche que vous pouvez saisir. Nous collectons certaines de ces informations en utilisant des "cookies" ou d'autres technologies similaires directement depuis votre appareil. Pour plus d'informations sur la façon dont nous utilisons ces technologies, consultez notre Politique en matière de cookies. | Pour vous fournir l'utilisation de nos sites Web et services connexes et pour les améliorer (par exemple, identifier des moyens de rendre notre plateforme plus facile à utiliser ou à naviguer) Pour personnaliser votre expérience d'utilisation de nos sites Web (par exemple, en modifiant la mise en page de nos pages Web) Pour faire de la publicité et commercialiser des produits ou des fonctionnalités auprès de vous |
## Quand et pourquoi nous partageons vos informations avec d'autres
Nous partageons vos informations personnelles avec des entreprises qui nous aident à vous fournir des services. Nous pouvons également partager vos informations :
- Pour prévenir ou enquêter sur la fraude, les menaces pour la sécurité, les activités illégales ou les violations de contrats (par exemple, nos Conditions de service).
- Pour soutenir les efforts de marketing et de publicité.
- Pour nous conformer aux obligations légales ou répondre à des ordonnances judiciaires, des demandes gouvernementales.
- Lors de transactions commerciales (par exemple, fusions, acquisitions, ventes d'actifs, faillite), nous partageons des données avec les acheteurs potentiels, les vendeurs ou les tiers pertinents impliqués dans les négociations ou la restructuration.
## Vos droits concernant vos informations
Veuillez soumettre une demande de droit d'accès via support@adaptivemachines.ai si vous souhaitez accéder à vos informations personnelles ou demander que nous les supprimions. Veuillez garder à l'esprit qu'après avoir anonymisé vos informations, nous continuerons à utiliser des informations non identifiables pour améliorer nos services. Veuillez noter que certains droits d'accès ne s'appliquent que dans certaines circonstances, et tous ces droits peuvent être limités par la loi.
---
# Liste des Sous-traitants
Source: https://www.runnerai.com/docs/fr/legal/subprocessors
## Liste des Sous-traitants
Pour soutenir la fourniture de nos Services, Adaptive Machines, Inc. ("Runner AI", "nous" ou "notre") utilise des prestataires de services tiers en tant que sous-traitants pour traiter les données personnelles. Les entités affiliées à Runner AI et les sous-traitants tiers aident Runner AI à traiter les données personnelles pour les commerçants conformément à notre [Accord de Traitement des Données](/fr/legal/dpa).
Les Sous-traitants utilisés par Runner AI pour l'exécution des Services en vertu des Conditions sont énumérés ci-dessous.
## Sous-traitants tiers
| Sous-traitant | Service fourni | Siège social | Données pouvant être traitées |
|--------------|------------------|------------------------|----------------------------|
| Vercel Inc. | Services d'hébergement et de déploiement | États-Unis | Données de plateforme nécessaires pour héberger et servir l'application |
| Google LLC | Hébergement cloud et traitement de données | États-Unis | Toutes les données de la plateforme |
| Google DeepMind | Services d'intelligence artificielle conversationnelle | États-Unis | Données personnelles si saisies dans la boîte de dialogue Runner AI |
| OpenRouter, Inc. | Services d'intelligence artificielle conversationnelle | États-Unis | Données personnelles si saisies dans la boîte de dialogue Runner AI |
| Klaviyo, Inc. | Transmission d'e-mails | États-Unis | Données personnelles nécessaires pour fournir Runner AI Email |
---
# Conditions d'Utilisation
Source: https://www.runnerai.com/docs/fr/legal/tos
## Conditions d'Utilisation
### Table des Matières
1. [Conditions de Compte](#1-conditions-de-compte)
2. [Activation du Compte](#2-activation-du-compte)
3. [Droits de Runner AI](#3-droits-de-runner-ai)
4. [Vos Responsabilités](#4-vos-responsabilités)
5. [Paiement des Frais et Taxes](#5-paiement-des-frais-et-taxes)
6. [Confidentialité](#6-confidentialité)
7. [Limitation de Responsabilité et Indemnisation](#7-limitation-de-responsabilité-et-indemnisation)
8. [Propriété Intellectuelle et Vos Contenus](#8-propriété-intellectuelle-et-vos-contenus)
9. [Services Supplémentaires](#9-services-supplémentaires)
10. [Commentaires et Avis](#10-commentaires-et-avis)
11. [Procédure d'Avis et de Retrait DMCA](#11-procédure-davis-et-de-retrait-dmca)
12. [Confidentialité et Protection des Données](#12-confidentialité-et-protection-des-données)
13. [Partie Contractante de Runner AI](#13-partie-contractante-de-runner-ai)
14. [Durée et Résiliation](#14-durée-et-résiliation)
15. [Modifications](#15-modifications)
16. [Conditions Générales](#16-conditions-générales)
**Dernière mise à jour le : 15 octobre 2025**
Bienvenue sur Runner AI ! En vous inscrivant à un Compte Runner AI (tel que défini dans la Section 1) ou en utilisant tout Service Runner AI (tel que défini ci-dessous), vous acceptez d'être lié par les termes et conditions suivants (les "Conditions d'Utilisation").
Tel qu'utilisé dans ces Conditions d'Utilisation, "Société", "nous", "notre" et "nos" se réfèrent à Adaptive Machines, Inc. (tel que défini dans la Section 13). "Vous" désigne l'Utilisateur Runner AI (si vous vous inscrivez ou utilisez un Service Runner AI en tant qu'individu), ou l'entreprise employant l'Utilisateur Runner AI (si vous vous inscrivez ou utilisez un Service Runner AI en tant qu'entreprise) et toutes ses sociétés affiliées.
Runner AI fournit une plateforme de commerce complète qui permet aux commerçants d'unifier leurs activités commerciales. Entre autres fonctionnalités, cette plateforme comprend une gamme d'outils permettant aux commerçants de créer et personnaliser des boutiques en ligne, de vendre à plusieurs endroits (y compris web, mobile, médias sociaux, places de marché en ligne et autres emplacements en ligne ("Services en Ligne")), de gérer les produits, l'inventaire, les paiements, l'exécution, l'expédition, les opérations commerciales, le marketing et la publicité, et d'interagir avec les clients existants et potentiels. Tout service ou services offerts par Runner AI sont appelés dans ces Conditions d'Utilisation le(s) "Service(s)". Toute nouvelle fonctionnalité ou outil ajouté aux Services actuels sera également soumis aux Conditions d'Utilisation. Vous pouvez consulter la version actuelle des Conditions d'Utilisation à tout moment sur https://www.runnerai.com/docs/fr/legal/tos.
Vous devez lire, accepter et accepter tous les termes et conditions contenus ou expressément référencés dans ces Conditions d'Utilisation, y compris la [Politique d'Utilisation Acceptable](/fr/legal/aup) ("PUA") et la [Politique de Confidentialité](/fr/legal/policies), et l'[Accord de Traitement des Données](/fr/legal/dpa) ("ATD") de Runner AI avant de pouvoir vous inscrire à un Compte Runner AI ou utiliser tout Service Runner AI.
Veuillez lire les Conditions d'Utilisation, y compris tout document référencé dans ces Conditions d'Utilisation, pour avoir une vue complète de vos exigences légales. En utilisant Runner AI ou tout service Runner AI, vous acceptez ces termes. Assurez-vous de vérifier occasionnellement les mises à jour.
## 1. Conditions de Compte
### Ce qui signifie
Vous êtes responsable de votre Compte, des Contenus que vous téléchargez sur le Service Runner AI et de l'exploitation de votre Boutique Runner AI. Si vous violez les conditions d'utilisation de Runner AI, nous pouvons annuler votre accès au service. Si nous devons vous contacter, nous communiquerons via l'Adresse E-mail Principale.
(1) Pour accéder et utiliser les Services, vous devez vous inscrire à un compte Runner AI ("Compte"). Pour compléter l'inscription de votre Compte, vous devez nous fournir votre nom légal complet, l'adresse de votre entreprise, un numéro de téléphone, une adresse e-mail valide et toute autre information indiquée comme requise. Runner AI peut rejeter votre demande de Compte, ou annuler un Compte existant, pour quelque raison que ce soit, à notre seule discrétion.
(2) Vous devez être le plus âgé de : (i) 18 ans, ou (ii) au moins l'âge de la majorité dans la juridiction où vous résidez et d'où vous utilisez les Services pour ouvrir un Compte.
(3) Vous confirmez que vous recevez tout Service fourni par Runner AI dans le but d'exercer une activité commerciale et non pour un usage personnel, domestique ou familial.
(4) Vous reconnaissez que Runner AI utilisera l'adresse e-mail que vous fournissez lors de l'ouverture d'un Compte ou telle que mise à jour par vous de temps à autre comme méthode principale de communication avec vous ("Adresse E-mail Principale"). Vous devez surveiller l'Adresse E-mail Principale que vous fournissez à Runner AI et votre Adresse E-mail Principale doit être capable d'envoyer et de recevoir des messages. Vos communications par e-mail avec Runner AI ne peuvent être authentifiées que si elles proviennent de votre Adresse E-mail Principale.
(5) Vous êtes responsable de la sécurité de votre mot de passe. Runner AI ne peut pas et ne sera pas responsable de toute perte ou dommage résultant de votre manquement à maintenir la sécurité de votre Compte et de votre mot de passe. Nous pouvons demander des mesures de sécurité supplémentaires à tout moment et nous nous réservons le droit d'ajuster ces exigences à notre discrétion.
(6) Le support technique concernant les Services est uniquement fourni aux Utilisateurs Runner AI. Les questions concernant les Conditions d'Utilisation doivent être envoyées au Support Runner AI.
(7) Vous acceptez de ne pas reproduire, dupliquer, copier, vendre, revendre ou exploiter toute partie du Service, l'utilisation des Services ou l'accès aux Services sans l'autorisation écrite expresse de Runner AI.
(8) Vous acceptez de ne pas contourner, contourner ou contourner l'une des limitations techniques des Services, d'utiliser tout outil pour activer des fonctionnalités ou des fonctionnalités autrement désactivées dans les Services, ou de décompiler, désassembler ou effectuer une rétro-ingénierie des Services.
(9) Vous acceptez de ne pas accéder aux Services ou surveiller tout matériel ou information des Services en utilisant un robot, une araignée, un grattoir ou tout autre moyen automatisé.
(10) Vous comprenez que vos Contenus peuvent être transférés non cryptés et impliquer (a) des transmissions sur divers réseaux ; et (b) des modifications pour se conformer et s'adapter aux exigences techniques des réseaux ou appareils de connexion. "Contenus" désigne Vos Marques, le contenu protégé par le droit d'auteur, tous les produits ou services que vous vendez via les Services (y compris la description et le prix), et toutes photos, images, vidéos, graphiques, contenus écrits, fichiers audio, code, informations ou autres données fournies ou rendues disponibles par vous ou vos affiliés à Runner AI ou à ses affiliés.
## 2. Activation du Compte
### Ce qui signifie
Une seule personne peut être le "Propriétaire de Boutique", généralement la personne qui s'inscrit au Service Runner AI. Le Propriétaire de Boutique est responsable du Compte, est lié par ces Conditions d'Utilisation et est responsable des actions d'autres personnes accédant au Compte. Si vous vous inscrivez au nom de votre employeur, votre employeur est le Propriétaire de Boutique responsable de votre Compte.
### 2.1 Propriétaire de Boutique
(1) Sous réserve de la Section 2.1.2, la personne qui s'inscrit au Service en ouvrant un Compte sera la partie contractante ("Propriétaire de Boutique") aux fins de nos Conditions d'Utilisation et sera la personne autorisée à utiliser tout Compte correspondant que nous pouvons fournir au Propriétaire de Boutique dans le cadre du Service. Vous êtes responsable de vous assurer que le nom du Propriétaire de Boutique (y compris le nom légal de la société propriétaire de la Boutique, le cas échéant) est clairement visible sur le site web de la Boutique.
(2) Si vous vous inscrivez aux Services au nom de votre employeur, votre employeur sera le Propriétaire de Boutique. Si vous vous inscrivez aux Services au nom de votre employeur, vous devez utiliser votre adresse e-mail fournie par l'employeur et vous déclarez et garantissez que vous avez l'autorité pour lier votre employeur à nos Conditions d'Utilisation.
(3) Votre Boutique Runner AI ne peut être associée qu'à un seul Propriétaire de Boutique. Un Propriétaire de Boutique peut avoir plusieurs Boutiques Runner AI. "Boutique" désigne la boutique en ligne (qu'elle soit hébergée par Runner AI ou sur un site web tiers), ou l'(les) emplacement(s) de vente au détail physique associé(s) au Compte.
### 2.2 Comptes du Personnel
(1) En fonction de votre plan tarifaire Runner AI, vous pouvez créer un ou plusieurs comptes du personnel ("Comptes du Personnel") permettant à d'autres personnes d'accéder au Compte. Chaque Compte du Personnel doit inclure un nom légal complet et un compte e-mail valide. Avec les Comptes du Personnel, le Propriétaire de Boutique peut définir des autorisations et laisser d'autres personnes travailler dans leur Compte tout en déterminant le niveau d'accès des Comptes du Personnel à des informations commerciales spécifiques (par exemple, vous pouvez limiter l'accès du Compte du Personnel aux informations de vente sur la page Rapports ou empêcher les Comptes du Personnel de modifier les paramètres généraux de la boutique).
(2) Le Propriétaire de Boutique est responsable de : (a) s'assurer que ses employés, agents et sous-traitants, y compris via les Comptes du Personnel, se conforment à ces Conditions d'Utilisation ; et (b) toute violation de ces Conditions d'Utilisation par les employés, agents ou sous-traitants du Propriétaire de Boutique. Le Propriétaire de Boutique reconnaît et accepte que le Propriétaire de Boutique sera responsable de l'exécution de toutes ses obligations en vertu de l'Accord, que le Propriétaire de Boutique sous-licence ou sous-traite de telles obligations à un tiers, y compris mais sans s'y limiter à toute société affiliée ou filiale du Propriétaire de Boutique.
(3) Le Propriétaire de Boutique et les utilisateurs sous les Comptes du Personnel sont chacun appelés un "Utilisateur Runner AI".
### 2.3 Fournisseurs de Paiement Tiers
Nos Services s'intègrent à divers fournisseurs de paiement tiers pour vous permettre de traiter les paiements pour vos transactions. Votre relation avec ces fournisseurs de paiement est régie par leurs termes et conditions respectifs. Vous êtes seul responsable de la création et du maintien de vos comptes auprès de ces fournisseurs et de toutes les activités liées à votre traitement des paiements.
## 3. Droits de Runner AI
### Ce qui signifie
Runner AI a le droit de contrôler à qui nous rendons nos Services disponibles et nous pouvons les modifier à tout moment. Nous avons également le droit de refuser ou de supprimer des Contenus de toute partie des Services, y compris votre Boutique. Nous pouvons offrir nos services à vos concurrents, mais nous ne partagerons jamais vos informations confidentielles avec eux en le faisant. En cas de litige concernant la propriété d'un Compte Runner AI, nous pouvons geler un Compte Runner AI ou le transférer au propriétaire légitime, tel que déterminé par nous.
(1) Les Services ont une gamme de fonctionnalités et de fonctionnalités. Tous les Services ou fonctionnalités ne seront pas disponibles pour tous les Commerçants à tout moment et nous ne sommes pas obligés de rendre tout Service ou fonctionnalité disponible dans toute juridiction. Sauf lorsque cela est interdit dans ces Conditions d'Utilisation ou par la loi applicable, nous nous réservons le droit de modifier les Services ou toute partie de ceux-ci pour quelque raison que ce soit.
(2) Runner AI ne présélectionne pas les Contenus et il est à notre seule discrétion de refuser ou de supprimer tout Contenu de toute partie des Services, y compris si nous déterminons à notre seule discrétion que les biens ou services que vous offrez via les Services, ou les Contenus téléchargés ou publiés sur les Services, violent ces Conditions d'Utilisation.
(3) L'abus verbal ou écrit de toute nature (y compris les menaces d'abus ou de représailles) envers tout employé, membre ou dirigeant de Runner AI entraînera la résiliation immédiate du Compte.
(4) Nous nous réservons le droit de fournir nos Services à vos concurrents et ne promettons aucune exclusivité. Vous reconnaissez et acceptez en outre que les employés et sous-traitants de Runner AI peuvent également être des clients ou commerçants Runner AI et qu'ils peuvent être en concurrence avec vous, bien qu'ils ne puissent pas utiliser vos Informations Confidentielles (telles que définies dans la Section 6) en le faisant.
(5) En cas de litige concernant la propriété d'un Compte, nous nous réservons le droit de demander de la documentation pour déterminer ou confirmer la propriété du Compte. La documentation peut inclure, sans s'y limiter, une copie numérisée de votre licence commerciale, une pièce d'identité avec photo émise par le gouvernement, les quatre derniers chiffres de la carte de crédit en dossier ou la confirmation de votre statut d'employé d'une entité.
(6) Runner AI se réserve le droit de déterminer, à notre seule discrétion, la propriété légitime du Compte et de transférer un Compte au Propriétaire de Boutique légitime. Si nous ne sommes pas en mesure de déterminer raisonnablement le Propriétaire de Boutique légitime, sans préjudice de nos autres droits et recours, Runner AI se réserve le droit de suspendre ou désactiver temporairement un Compte jusqu'à ce qu'une résolution ait été déterminée entre les parties en litige.
## 4. Vos Responsabilités
### Ce qui signifie
Vous êtes responsable de votre Boutique Runner AI, des biens ou services que vous vendez et de votre relation avec vos clients, pas nous.
(1) Vous reconnaissez et acceptez de fournir des informations de contact publiques, une politique de remboursement et des délais d'exécution des commandes sur votre Boutique Runner AI.
(2) Vous reconnaissez et acceptez que les Services ne sont pas une place de marché, et tout contrat de vente conclu via les Services est directement entre vous et le client. Vous êtes le vendeur enregistré pour tous les articles que vous vendez via les Services. Vous êtes responsable de la création et de l'exploitation de votre Boutique Runner AI, de vos Contenus, des biens et services que vous pouvez vendre via les Services, et de tous les aspects des transactions entre vous et votre(vos) client(s). Cela inclut, sans s'y limiter, l'autorisation du débit au client concernant l'achat du client, les remboursements, les retours, l'exécution de toute vente ou service client, les transactions frauduleuses, les divulgations légales requises, la conformité réglementaire, la violation alléguée ou réelle des lois applicables (y compris mais sans s'y limiter aux lois sur la protection des consommateurs dans toute juridiction où vous offrez des produits ou services à la vente), ou votre violation de ces Conditions d'Utilisation. Vous déclarez et garantissez que votre Boutique, vos Contenus et les biens et services que vous vendez via les Services seront vrais, exacts et complets, et ne violeront aucune loi, réglementation ou droits de tiers applicables. Pour éviter toute ambiguïté, Runner AI ne sera pas le vendeur ou commerçant enregistré et n'aura aucune responsabilité pour votre Boutique ou les articles vendus aux clients via les Services.
(3) Vous êtes seul responsable des biens ou services que vous pouvez vendre via les Services (y compris la description, le prix, les frais, la taxe que vous calculez, les défauts, les divulgations légales requises, la conformité réglementaire, les offres ou le contenu promotionnel), y compris la conformité avec toutes les lois ou réglementations applicables.
(4) Vous ne pouvez pas utiliser les Services Runner AI à des fins illégales ou non autorisées et vous ne pouvez pas, dans l'utilisation du Service, violer les lois de votre juridiction (y compris mais sans s'y limiter aux lois sur le droit d'auteur), les lois qui vous sont applicables dans la juridiction de votre client, ou les lois de l'État du Delaware. Vous vous conformerez à toutes les lois, règles et réglementations applicables (y compris mais sans s'y limiter l'obtention et le respect des exigences de toute licence ou permis qui peut être nécessaire pour exploiter votre boutique ou qui peut être détenu par vous) dans votre utilisation du Service et votre exécution des obligations en vertu des Conditions d'Utilisation.
## 5. Paiement des Frais et Taxes
### Ce qui signifie
Une méthode de paiement valide (telle qu'une carte de crédit) doit rester en dossier pour payer tous les frais de service, y compris les frais d'abonnement, de transaction et supplémentaires requis pour toutes les boutiques. Vous serez facturé pour vos Frais d'Abonnement tous les 30 jours. Les Frais de Transaction ou Frais Supplémentaires seront débités de votre méthode de paiement. Si nous ne sommes pas en mesure de traiter le paiement des Frais en utilisant votre méthode de paiement, nous pouvons faire des tentatives ultérieures pour traiter le paiement des Frais en utilisant votre méthode de paiement. Si le paiement des Frais échoue dans les 30 jours suivant notre première tentative de traitement du paiement, Runner AI peut geler votre boutique. Vous êtes responsable de toutes les taxes relatives à votre Boutique ou à l'utilisation des Services. Vous pouvez être tenu de remettre les Taxes à Runner AI ou de les auto-remettre à votre autorité fiscale locale. Aucun remboursement.
(1) Vous paierez les Frais applicables à votre abonnement au Service en Ligne et ("Frais d'Abonnement") et tous autres frais applicables, y compris mais sans s'y limiter les frais applicables liés à la valeur des ventes réalisées via votre Boutique lors de l'utilisation d'un fournisseur de paiement tiers pour traiter les paiements des clients. ("Frais de Transaction"), et tous frais liés à votre achat ou utilisation de tout produit ou service tel que l'expédition, le Pack de Boost de Crédit ou les Services Tiers ("Frais Supplémentaires"). Ensemble, les Frais d'Abonnement, les Frais de Transaction et les Frais Supplémentaires sont appelés les "Frais".
(2) Vous devez conserver une méthode de paiement valide en dossier avec nous pour payer tous les Frais encourus et récurrents. Runner AI débitera les Frais applicables sur toute méthode de paiement valide que vous autorisez ("Méthode de Paiement Autorisée"), et Runner AI continuera à débiter la Méthode de Paiement Autorisée pour les Frais applicables jusqu'à ce que les Services soient résiliés, et que tous les Frais impayés aient été payés en totalité. Sauf indication contraire, tous les Frais et autres charges sont en dollars américains, et tous les paiements seront en devise américaine.
(3) Les Frais d'Abonnement sont payés à l'avance et seront facturés par intervalles de 30 jours (chaque date, une "Date de Facturation"). Les Frais de Transaction et les Frais Supplémentaires seront débités de temps à autre à la discrétion de Runner AI. Vous serez débité à chaque Date de Facturation pour tous les Frais impayés qui n'ont pas été précédemment facturés. Les Frais apparaîtront sur une facture, qui sera envoyée au Propriétaire de Boutique via l'Adresse E-mail Principale fournie. De plus, une facture apparaîtra sur la page Compte de la console administrative de votre Boutique. Les utilisateurs ont environ deux semaines pour soulever et régler tout problème avec la facturation des Frais d'Abonnement.
(4) Si nous ne sommes pas en mesure de traiter le paiement des Frais en utilisant une Méthode de Paiement Autorisée, nous pouvons faire des tentatives ultérieures pour traiter le paiement en utilisant toute Méthode de Paiement Autorisée. Si nous ne sommes pas en mesure de traiter avec succès le paiement des Frais en utilisant une Méthode de Paiement Autorisée dans les 30 jours suivant notre première tentative, nous pouvons suspendre et révoquer l'accès à votre Compte et aux Services. Votre Compte sera réactivé lors de votre paiement de tous les Frais impayés, plus les Frais applicables à votre prochain cycle de facturation. Vous ne pourrez peut-être pas accéder à votre Compte ou à votre vitrine pendant toute période de suspension.
(5) Tous les Frais sont exclusifs des taxes fédérales, d'État, locales ou autres taxes gouvernementales applicables sur les ventes, les biens et services, harmonisées ou autres, frais ou charges maintenant en vigueur ou promulgués à l'avenir ("Taxes").
(6) Vous êtes responsable de toutes les Taxes applicables qui découlent de ou résultent de votre abonnement ou de votre achat des produits et services de Runner AI. Dans la mesure où Runner AI facture ces Taxes, elles sont calculées en utilisant les taux d'imposition qui s'appliquent en fonction de l'adresse de facturation que vous nous fournissez. Ces montants s'ajoutent aux Frais pour ces produits et services et seront facturés à votre Méthode de Paiement Autorisée. Si vous êtes exempté du paiement de ces Taxes, vous devez nous fournir la preuve de votre exemption, ce qui dans certaines juridictions comprend un certificat original qui satisfait aux exigences légales applicables attestant du statut d'exonération fiscale. L'exemption fiscale ne s'appliquera qu'à compter de la date à laquelle nous recevons une preuve satisfaisante pour Runner AI de votre exemption. Si vous n'êtes pas facturé de Taxes par Runner AI, vous êtes responsable de déterminer si les Taxes sont payables et, le cas échéant, de l'auto-remise des Taxes aux autorités fiscales appropriées dans votre juridiction.
(7) Pour éviter toute ambiguïté, toutes les sommes payables par vous à Runner AI en vertu de ces Conditions d'Utilisation seront payées sans aucune déduction ou retenue quelle qu'elle soit. Outre les Taxes facturées par Runner AI à vous et remises aux autorités fiscales appropriées en votre nom, toute déduction ou retenue requise par la loi sera supportée par vous et payée séparément à l'autorité fiscale pertinente. Runner AI aura le droit de facturer le montant total des Frais stipulés en vertu de ces Conditions d'Utilisation à votre Méthode de Paiement Autorisée en ignorant toute déduction ou retenue qui peut être requise.
(8) Vous êtes seul responsable de la détermination, de la collecte, de la retenue, de la déclaration et de la remise des taxes, droits, frais, surtaxes et charges supplémentaires applicables qui découlent de ou résultent de toute vente sur votre Boutique Runner AI ou de votre utilisation des Services. Les Services ne sont pas une place de marché. Tout contrat de vente conclu via les Services est directement entre vous et le client.
(9) Vous devez maintenir un emplacement précis dans la console administrative de votre Boutique Runner AI. Si vous changez de juridiction, vous devez rapidement mettre à jour votre emplacement dans la console administrative.
(10) Runner AI ne fournit pas de remboursements.
## 6. Confidentialité
### Ce qui signifie
Vous et Runner AI acceptez d'utiliser les Informations Confidentielles de l'autre uniquement pour exécuter les obligations dans ces Conditions d'Utilisation. Les Informations Confidentielles doivent être protégées et respectées.
(1) Les "Informations Confidentielles" incluront, sans s'y limiter, toutes les informations associées aux activités d'une partie et non publiquement connues, y compris les informations commerciales spécifiques, les processus et formules techniques, les logiciels, les listes de clients, les listes de clients potentiels, les noms, adresses et autres informations concernant les clients et clients potentiels, les conceptions de produits, les ventes, les coûts (y compris les frais de traitement pertinents), les listes de prix et autres informations financières non publiées, les plans d'affaires et les données marketing, et toute autre information confidentielle et propriétaire, qu'elle soit ou non marquée comme confidentielle ou propriétaire. Les Informations Confidentielles de Runner AI incluent toutes les informations que vous recevez nous concernant, ou concernant les Services, qui ne sont pas connues du grand public, y compris les informations liées à notre programme et pratiques de sécurité.
(2) Chaque partie accepte d'utiliser les Informations Confidentielles de l'autre partie uniquement dans la mesure nécessaire pour exécuter ses obligations en vertu de ces Conditions d'Utilisation et conformément à toute autre obligation dans ces Conditions d'Utilisation, y compris cette Section 6. Chaque partie accepte qu'elle prendra toutes les mesures raisonnables, au moins substantiellement équivalentes aux mesures qu'elle prend pour protéger ses propres informations propriétaires, pour empêcher la duplication, la divulgation ou l'utilisation de toute Informations Confidentielles, autre que (i) par ou à ses employés, agents et sous-traitants qui doivent avoir accès à ces Informations Confidentielles pour exécuter les obligations de cette partie en vertu des présentes, qui traiteront chacun ces Informations Confidentielles comme prévu dans les présentes, et qui sont chacun soumis à des obligations de confidentialité envers cette partie qui sont au moins aussi strictes que celles contenues dans les présentes ; ou (ii) tel que requis par toute loi, réglementation ou ordonnance de tout tribunal de juridiction appropriée sur les parties et la matière contenue dans ces Conditions d'Utilisation, à condition que, si légalement permis, la partie destinataire donne à la partie divulgatrice un avis écrit rapide et utilise des efforts commercialement raisonnables pour s'assurer qu'une telle divulgation bénéficie d'un traitement confidentiel. Les Informations Confidentielles n'incluront aucune information que la partie destinataire peut prouver : (A) était déjà dans le domaine public, ou était déjà connue ou en possession de la partie destinataire, au moment de la divulgation de ces informations ; (B) est développée de manière indépendante par la partie destinataire sans utilisation ou référence aux Informations Confidentielles de l'autre partie, et sans violer aucune disposition de ces Conditions d'Utilisation ; ou (C) est ensuite légitimement obtenue par la partie destinataire à partir d'une source autre que la partie divulgatrice sans violer aucune disposition de ces Conditions d'Utilisation.
## 7. Limitation de Responsabilité et Indemnisation
### Ce qui signifie
Nous ne sommes pas responsables des dommages ou poursuites qui surviennent si vous enfreignez la loi, violez cet accord ou allez à l'encontre des droits d'un tiers. Le Service est fourni "tel quel" et "tel que disponible". Nous ne fournissons aucune garantie et notre responsabilité est limitée en cas d'erreurs ou d'interruptions.
(1) Vous comprenez et acceptez expressément que, dans la mesure permise par les lois applicables, Runner AI et ses fournisseurs ne seront pas responsables de tout dommage direct, indirect, accessoire, spécial, consécutif ou exemplaire, y compris mais sans s'y limiter, les dommages pour perte de profits, d'achalandage, d'utilisation, de données ou d'autres pertes intangibles découlant de ou liés à l'utilisation de ou l'incapacité d'utiliser le Service ou ces Conditions d'Utilisation (quelle que soit la manière dont ils surviennent, y compris la négligence).
DANS LA MESURE MAXIMALE PERMISE PAR LA LOI, NONOBSTANT TOUTE DISPOSITION CONTRAIRE CONTENUE DANS LES PRÉSENTES, NOTRE RESPONSABILITÉ ENVERS VOUS POUR TOUT DOMMAGE DÉCOULANT DE OU LIÉ À CES CONDITIONS (POUR TOUTE CAUSE QUE CE SOIT ET QUELLE QUE SOIT LA FORME DE L'ACTION), SERA À TOUT MOMENT LIMITÉE AU MONTANT DES FRAIS QUE VOUS NOUS AVEZ PAYÉS AU COURS DES SIX (6) MOIS PRÉCÉDENTS (OU, SI AUCUN FRAIS N'A ÉTÉ PAYÉ, À UN MAXIMUM DE CINQUANTE DOLLARS AMÉRICAINS (50 $)). L'EXISTENCE DE PLUS D'UNE RÉCLAMATION N'AUGMENTERA PAS CETTE LIMITE.
(2) Vous acceptez d'indemniser et de tenir indemne nous et (le cas échéant) notre société mère, nos filiales, affiliées, partenaires Runner AI, dirigeants, directeurs, agents, employés et fournisseurs de toute réclamation ou demande, y compris les honoraires d'avocat raisonnables, faite par un tiers en raison de ou découlant de (a) votre violation de ces Conditions d'Utilisation ou des documents qu'elles incorporent par référence (y compris la PUA) ; (b) ou votre violation de toute loi ou des droits d'un tiers ; ou (c) tout aspect de la transaction entre vous et votre Client, y compris mais sans s'y limiter les remboursements, les transactions frauduleuses, la violation alléguée ou réelle des lois applicables (y compris mais sans s'y limiter aux lois fédérales et d'État sur la protection des consommateurs), ou votre violation des Conditions d'Utilisation.
(3) Vous serez responsable de toute violation des Conditions d'Utilisation par vos affiliés, agents ou sous-traitants et serez responsable comme s'il s'agissait de votre propre violation.
(4) Votre utilisation des Services est à vos seuls risques. Les Services sont fournis "tel quel" et "tel que disponibles" sans aucune garantie ou condition, expresse, implicite ou légale.
(5) Runner AI ne garantit pas que les Services seront ininterrompus, opportuns, sécurisés ou sans erreur.
(6) Runner AI ne garantit pas que les résultats qui peuvent être obtenus de l'utilisation des Services seront exacts ou fiables.
Plus précisément, vous reconnaissez que les Services utilisent l'intelligence artificielle et des algorithmes d'apprentissage automatique pour fournir des fonctionnalités telles que des opérations automatisées et des suggestions de croissance. Vous comprenez qu'il s'agit de systèmes probabilistes et Runner AI ne fournit aucune garantie concernant la rentabilité, le succès ou les résultats spécifiques de toute action entreprise en fonction des sorties ou suggestions de ces systèmes d'IA.
(7) Runner AI n'est pas responsable de vos obligations ou responsabilités fiscales liées à l'utilisation des Services de Runner AI.
(8) Runner AI ne garantit pas que la qualité de tout produit, service, information ou autre matériel acheté ou obtenu par vous via les Services répondra à vos attentes, ou que toute erreur dans les Services sera corrigée.
(9) En aucun cas Runner AI ne sera tenu responsable de toute perte de revenus, de données ou de bonne volonté des clients résultant de l'utilisation de Expériences ou de la performance de tout expériment généré par l'IA.
## 8. Propriété Intellectuelle et Vos Contenus
### Ce qui signifie
Tout ce que vous téléchargez reste le vôtre (s'il était le vôtre) et est votre responsabilité, mais Runner AI peut utiliser et publier les choses que vous téléchargez. Tout ce qui est téléchargé sur Runner AI reste la propriété et la responsabilité de son propriétaire initial. Cependant, Runner AI recevra une licence des contenus publiés via notre plateforme que nous pouvons utiliser pour exploiter et promouvoir nos Services.
### 8.1 Vos Contenus
(1) Nous ne revendiquons pas la propriété des Contenus que vous fournissez à Runner AI ; cependant, nous exigeons une licence pour ces Contenus. Vous accordez à la société un droit et une licence non exclusifs, transférables, sous-licenciables, gratuits, mondiaux d'héberger, utiliser, distribuer, exposer, modifier, exécuter, copier, stocker, exécuter publiquement, communiquer au public (y compris par télécommunication), diffuser, reproduire, rendre disponible, afficher et traduire, et créer des œuvres dérivées de tout Contenu fourni par vous dans le cadre des Services. Nous pouvons utiliser nos droits en vertu de cette licence pour exploiter, fournir et promouvoir les Services et pour exécuter nos obligations et exercer nos droits en vertu des Conditions d'Utilisation. Vous déclarez, garantissez et acceptez que vous disposez de tous les droits nécessaires dans les Contenus pour accorder cette licence. Vous renoncez irrévocablement à tous les droits moraux que vous pourriez avoir dans les Contenus en faveur de Runner AI et acceptez que cette renonciation puisse être invoquée par quiconque obtient des droits sur les contenus via Runner AI, y compris toute personne à qui Runner AI peut transférer ou accorder (y compris par licence ou sous-licence) tout droit dans les Contenus.
(2) Si vous possédiez les Contenus avant de les fournir à Runner AI, alors, malgré leur téléchargement sur votre Boutique Runner AI, ils restent les vôtres, sous réserve de tous les droits ou licences accordés dans les Conditions d'Utilisation ou ailleurs. Vous pouvez supprimer votre Boutique Runner AI à tout moment en supprimant votre Compte. La suppression de votre Boutique Runner AI ne met pas fin aux droits ou licences accordés aux Contenus que Runner AI exige pour exercer tout droit ou exécuter toute obligation qui est survenue pendant la Durée.
(3) Vous acceptez que Runner AI puisse, à tout moment, examiner et supprimer tout ou partie des Contenus soumis aux Services, bien que Runner AI ne soit pas obligé de le faire.
(4) Vous accordez à Runner AI un droit et une licence non exclusifs, transférables, sous-licenciables, gratuits, mondiaux d'utiliser les noms, marques de commerce, marques de service et logos associés à votre Boutique ("Vos Marques") pour exploiter, fournir et promouvoir les Services et pour exécuter nos obligations et exercer nos droits en vertu des Conditions d'Utilisation. Cette licence survivra à toute résiliation des Conditions d'Utilisation uniquement dans la mesure où Runner AI exige la licence pour exercer tout droit ou exécuter toute obligation qui est survenue pendant la Durée.
### 8.2 Propriété Intellectuelle de Runner AI
(1) Vous acceptez de ne pas utiliser les marques de commerce, logos ou marques de service de Runner AI, qu'ils soient enregistrés ou non, y compris mais sans s'y limiter la marque verbale Runner AI et la marque graphique Runner AI ("Marques de Commerce Runner AI") à moins que vous ne soyez autorisé à le faire par Runner AI par écrit. Vous acceptez de ne pas utiliser ou adopter des marques qui peuvent être considérées comme prêtant à confusion avec les Marques de Commerce Runner AI. Vous acceptez que toute variation ou faute d'orthographe des Marques de Commerce Runner AI serait considérée comme prêtant à confusion avec les Marques de Commerce Runner AI.
(2) Vous acceptez de ne pas acheter, enregistrer ou utiliser des mots-clés de moteur de recherche ou autres mots-clés au paiement par clic (tels que Google Ads), des marques de commerce, des adresses e-mail, des noms de médias sociaux ou des noms de domaine (y compris sans limitation les domaines de premier niveau, les sous-domaines et les URL de page) qui utilisent ou incluent Runner AI ou les Marques de Commerce Runner AI ou qui utilisent ou incluent des termes qui peuvent prêter à confusion avec les Marques de Commerce Runner AI.
(3) Vous reconnaissez et acceptez que les Conditions d'Utilisation ne vous donnent aucun droit de mettre en œuvre les brevets de Runner AI.
### 8.3 Utilisation des Données pour l'Amélioration de l'IA
Pour surveiller, améliorer et protéger nos Services, et pour optimiser nos algorithmes et modèles d'intelligence artificielle, vous nous accordez un droit perpétuel, irrévocable, mondial, gratuit d'utiliser vos 'Contenus' et les données opérationnelles associées sous une forme anonymisée et agrégée. Nous nous engageons à ce qu'une telle utilisation n'identifie aucun individu, commerçant ou leurs clients spécifiques, et sera utilisée uniquement dans le but d'améliorer la qualité globale du service et les capacités techniques de notre plateforme.
## 9. Services Supplémentaires
### 9.1 Intégrations d'Expédition Tierces
Nos Services peuvent s'intégrer à divers transporteurs et services d'expédition tiers pour gérer votre exécution. Votre utilisation de ces services tiers est soumise à leurs termes et conditions respectifs, et vous êtes seul responsable de votre relation avec eux.
### 9.2 Services Bêta
#### Ce qui signifie
Des Services Bêta peuvent être offerts de temps à autre. Ils ne font pas partie des Services réguliers, et ils peuvent avoir des erreurs ou changer à tout moment. Vous utilisez les Services Bêta à vos propres risques, et nous ne sommes pas responsables des pertes ou dommages qui pourraient résulter de l'utilisation d'un Service Bêta. Vous pouvez être tenu de garder votre participation aux Services Bêta confidentielle.
De temps à autre, Runner AI peut, à sa seule discrétion, vous inviter à utiliser, à titre d'essai, des fonctionnalités en pré-lancement ou bêta qui sont en développement et pas encore disponibles pour tous les commerçants ("Services Bêta"). Les Services Bêta ne font pas partie des Services, et les Services Bêta peuvent être soumis à des termes et conditions supplémentaires, que Runner AI vous fournira avant votre utilisation des Services Bêta. Ces Services Bêta et toutes les conversations et matériaux associés y relatifs seront considérés comme des Informations Confidentielles de Runner AI et soumis aux dispositions de confidentialité de cet accord. Sans limiter la généralité de ce qui précède, vous acceptez de ne faire aucune déclaration publique ou de divulguer autrement votre participation aux Services Bêta sans le consentement écrit préalable de Runner AI. Runner AI ne fait aucune déclaration ou garantie que les Services Bêta fonctionneront. Runner AI peut interrompre les Services Bêta à tout moment à sa seule discrétion. Runner AI n'aura aucune responsabilité pour tout préjudice ou dommage découlant de ou dans le cadre d'un Service Bêta. Les Services Bêta peuvent ne pas fonctionner de la même manière qu'une version finale. Runner AI peut modifier ou ne pas publier une version finale ou commerciale d'un Service Bêta à notre seule discrétion.
### 9.3 Gestionnaire de Pixels Runner AI
#### Ce qui signifie
Le Gestionnaire de Pixels Runner AI vous permet ou permet à un tiers de suivre les événements des clients en ajoutant des pixels à votre Boutique Runner AI. Si vous utilisez le Gestionnaire de Pixels Runner AI, vous êtes responsable d'obtenir tous les consentements nécessaires des visiteurs de la boutique et des clients dont vous suivez les événements.
Runner AI vous permet d'ajouter des pixels à votre Boutique Runner AI pour vous permettre ou permettre à un tiers de suivre les événements des clients (le "Gestionnaire de Pixels Runner AI"). Vous pouvez gérer vos pixels depuis l'interface utilisateur dans la console administrative de votre Boutique Runner AI.
(1) En plus des termes applicables à votre utilisation des Services en général (y compris ces Conditions d'Utilisation, la Politique d'Utilisation Acceptable de Runner AI et la Politique de Confidentialité), les termes suivants s'appliquent à votre accès et à votre utilisation du Gestionnaire de Pixels Runner AI :
- a. Vous vous conformerez à toutes les lois applicables et obtiendrez tous les consentements nécessaires de chaque visiteur du site et client dont vous suivez les événements ;
- b. Si vous fournissez à Runner AI des données collectées à l'aide de pixels, y compris des noms, adresses e-mail, numéros de téléphone ou d'autres données qui identifient personnellement un individu, vous obtiendrez tous les droits et consentements nécessaires avant de fournir à Runner AI les informations précédentes ;
- c. Vous acceptez que Runner AI puisse désactiver tous les pixels que Runner AI identifie comme malveillants, à la seule discrétion de Runner AI ; et
- d. Vous ne permettrez pas, et ne permettrez à aucun tiers, d'utiliser les pixels :
- i. pour s'engager dans ou promouvoir toute activité illégale, contrefaisante, diffamatoire ou autrement nuisible ; ou
- ii. pour désactiver, interférer avec ou contourner tout aspect des Services.
(2) Runner AI peut collecter des informations associées au Gestionnaire de Pixels Runner AI, telles que la façon dont les pixels sont utilisés, et comment et quels scripts sont ajoutés. Runner AI peut utiliser ces données pour améliorer, maintenir, protéger et développer le Gestionnaire de Pixels Runner AI.
### 9.4 Expériences (Bêta) et Expériences Automatisées
#### Ce qui signifie
Expériences est une fonctionnalité expérimentale qui utilise l'IA pour tester différentes versions de votre boutique. En l'activant, vous nous autorisez à montrer des variations générées par l'IA de votre boutique à certains de vos visiteurs, y compris mais sans s'y limiter les mises en page, les prix et les règles d'expédition.
Seul l'Administrateur de votre boutique peut activer cette fonctionnalité et décider du pourcentage de trafic à tester (à partir de 10% par défaut). Comme il s'agit d'une fonctionnalité Bêta, il n'y a aucune garantie qu'elle augmentera vos ventes ou fonctionnera parfaitement à chaque fois. Vous l'utilisez à vos propres risques.
(1) **Autorisation pour le Trafic Expérimental** : En activant activement Expériences au sein des Services, vous autorisez expressément Runner AI à mener des expériences automatisées sur votre Boutique. Vous reconnaissez et acceptez que :
- **Allocation du Trafic** : Lors de l'activation, le Système allouera automatiquement dix pour cent (10%) ou le ratio de trafic convenu du trafic web de votre Boutique à un groupe expérimental (le "Groupe Expérimental").
- **Contrôle de l'Utilisateur** : Vous conservez le droit d'augmenter, de diminuer ou de désactiver manuellement cette allocation de trafic à tout moment via le tableau de bord administratif.
- **Variations Expérimentales** : Les visiteurs du Groupe Expérimental peuvent voir des variations, y compris mais sans s'y limiter les mises en page de la boutique, les prix des produits, les frais d'expédition et tout autre contenu ou logique de la boutique, qui diffèrent de votre version principale de la Boutique. Vous êtes responsable de la conformité aux lois locales concernant la tarification dynamique et la divulgation aux consommateurs.
(2) **Contrôle Administratif** : L'accès aux paramètres de Expériences est limité aux Utilisateurs avec des permissions "Admin". Seul un Administrateur autorisé a l'autorité pour :
- Activer ou désactiver la fonctionnalité Expériences ;
- Ajuster les paramètres expérimentaux, y compris les pourcentages d'allocation de trafic.
Runner AI ne sera pas responsable des paramètres modifiés par des personnes auxquelles vous avez accordé un accès administratif.
(3) **Avertissement Bêta et Limitation de Responsabilité** : Expériences est fourni en tant que fonctionnalité "Bêta" et ne fait pas partie des Services standard. Nonobstant toute disposition contraire dans ces Conditions d'Utilisation :
- **Évolution du Service** : La fonctionnalité, les performances et les mises en page de l'interface utilisateur de Expériences peuvent changer, être suspendues ou interrompues par Runner AI à tout moment sans préavis.
- **Aucune Garantie de Résultats** : Runner AI ne fait aucune déclaration ni garantie concernant le résultat de toute expérience. Nous ne garantissons aucun taux de conversion spécifique, augmentation de revenus, classement dans les moteurs de recherche ou autres résultats commerciaux.
- **Acceptation du Risque** : Vous reconnaissez que le contenu expérimental généré par l'IA peut contenir des erreurs. Votre utilisation de Expériences est à vos seuls risques, et Runner AI n'est pas responsable de tout impact négatif sur les performances de votre Boutique, y compris mais sans s'y limiter la perte de revenus, les erreurs de prix ou les litiges avec les clients, résultant de telles expériences.
## 10. Commentaires et Avis
### Ce qui signifie
Nous accueillons les commentaires des clients mais nous ne sommes pas obligés de garantir que les idées et suggestions concernant nos Services ou les services de tiers restent confidentiels et nous pouvons utiliser les commentaires de la manière que nous voulons.
Runner AI accueille toute idée et/ou suggestion concernant les améliorations ou ajouts aux Services. En aucun cas, toute divulgation de toute idée, suggestion ou matériel connexe ou tout avis sur les Services, les Services Tiers ou tout Fournisseur Tiers (collectivement, "Commentaires") à Runner AI ne sera soumise à une obligation de confidentialité ou à une attente de compensation. En soumettant des Commentaires à Runner AI (qu'ils soient soumis directement à Runner AI ou publiés sur tout forum ou page hébergé par Runner AI), vous renoncez à tous les droits dans les Commentaires et Runner AI est libre de mettre en œuvre et d'utiliser les Commentaires s'il le souhaite, tels que fournis par vous ou tels que modifiés par Runner AI, sans obtenir votre permission ou licence ou celle d'un tiers. Tout avis d'un Service Tiers ou Fournisseur Tiers que vous soumettez à Runner AI doit être exact au meilleur de votre connaissance, et ne doit pas être illégal, obscène, menaçant, diffamatoire, invasif de la vie privée, portant atteinte aux droits de propriété intellectuelle, ou autrement préjudiciable à des tiers ou répréhensible. Runner AI se réserve le droit (mais pas l'obligation) de supprimer ou modifier les Commentaires sur les Services Tiers ou Fournisseurs Tiers, mais n'inspecte pas régulièrement les Commentaires publiés.
## 11. Procédure d'Avis et de Retrait DMCA
### Ce qui signifie
Runner AI respecte les droits de propriété intellectuelle et vous devriez le faire aussi. Si nous recevons un Avis DMCA, nous pouvons désactiver l'accès ou supprimer le contenu prétendument contrefaisant de votre Boutique. Si vous ne pensez pas que la réclamation est valide, vous pouvez envoyer une contre-notification. Si vous pensez qu'un de nos commerçants viole vos droits de propriété intellectuelle, vous pouvez envoyer un Avis DMCA à Runner AI. Nous désactiverons rapidement l'accès ou supprimerons le contenu et notifierons le commerçant.
Runner AI soutient la protection de la propriété intellectuelle et demande aux commerçants Runner AI de faire de même. C'est notre politique de répondre à tous les avis d'infraction présumée au droit d'auteur. Si quelqu'un pense qu'un de nos commerçants viole ses droits de propriété intellectuelle, il peut envoyer un Avis DMCA à l'agent désigné de Runner AI en utilisant support@adaptivemachines.ai. Après réception d'un Avis DMCA, nous pouvons supprimer ou désactiver l'accès aux Contenus prétendument constituer une violation du droit d'auteur. Une fois qu'un avis de retrait est fourni, le commerçant peut répondre avec une contre-notification en utilisant l'e-mail s'il s'oppose à la plainte. Le plaignant d'origine a 14 jours ouvrables après que nous recevons une contre-notification pour demander une ordonnance du tribunal empêchant le commerçant de s'engager dans l'activité contrefaisante, sinon nous restaurons le matériel.
## 12. Confidentialité et Protection des Données
### Ce qui signifie
L'utilisation et la collecte d'informations personnelles par Runner AI sont régies par notre Politique de Confidentialité. L'utilisation et la collecte par Runner AI d'informations personnelles de clients sont en outre régies par notre Accord de Traitement des Données.
Runner AI s'engage fermement à protéger la confidentialité de vos informations personnelles et des informations personnelles de vos clients. En utilisant le Service, vous reconnaissez et acceptez que la collecte, l'utilisation et la divulgation de ces informations personnelles par Runner AI sont régies par notre [Politique de Confidentialité](/fr/legal/policies).
Dans la mesure où Runner AI traite les informations personnelles de vos clients en tant que "sous-traitant" ou "prestataire de services" en vertu de certaines lois sur la confidentialité ou la protection des données, y compris le Règlement Général sur la Protection des Données de l'UE ou du RU et la California Consumer Privacy Act, la collecte et l'utilisation d'informations personnelles par Runner AI sont également soumises à notre [Accord de Traitement des Données](/fr/legal/dpa).
## 13. Partie Contractante de Runner AI
"Partie Contractante" désigne Adaptive Machines, Inc., une société du Delaware, dont le siège social principal est situé au 131 Continental Dr Suite 305 Newark, DE, 19713 US
Les parties se soumettent irrévocablement et inconditionnellement à la juridiction exclusive des tribunaux d'État et fédéraux situés dans l'État du Delaware en ce qui concerne tout litige ou réclamation découlant de ou dans le cadre des Conditions d'Utilisation. La Convention des Nations Unies sur les Contrats de Vente Internationale de Marchandises ne s'appliquera pas à ces Conditions d'Utilisation et est expressément exclue par les présentes.
## 14. Durée et Résiliation
### Ce qui signifie
Vous pouvez annuler votre abonnement à tout moment depuis les paramètres de votre compte. Nous pouvons résilier votre compte à tout moment. Pour les Boutiques sur un plan gratuit, Runner AI se réserve le droit de supprimer définitivement la Boutique et toutes les données associées si la Boutique reste inactive pendant une période de quatorze (14) jours consécutifs.
(1) La durée de ces Conditions d'Utilisation commencera à la date de votre inscription complète à l'utilisation d'un Service et se poursuivra jusqu'à sa résiliation par nous ou par vous, tel que prévu ci-dessous (la "Durée").
(2) Vous pouvez annuler votre Compte et résilier les Conditions d'Utilisation à tout moment en accédant aux paramètres de votre compte.
(3) Sans limiter nos autres recours, nous pouvons suspendre ou résilier votre Compte ou les Conditions d'Utilisation pour quelque raison que ce soit, sans préavis et à tout moment (sauf si autrement requis par la loi), y compris si nous soupçonnons que vous (par condamnation, règlement, enquête d'assurance ou de dépôt fiduciaire, ou autrement) vous êtes engagé dans une activité frauduleuse dans le cadre de l'utilisation des Services. La résiliation des Conditions d'Utilisation sera sans préjudice de tous droits ou obligations qui sont survenus avant la date de résiliation.
(4) À la résiliation des Services par l'une ou l'autre partie pour quelque raison que ce soit :
- Runner AI cessera de vous fournir les Services et vous ne pourrez plus accéder à votre Compte ;
- sauf indication contraire dans les Conditions d'Utilisation, vous n'aurez droit à aucun remboursement de Frais, au prorata ou autrement ;
- tout solde impayé dû à Runner AI pour votre utilisation des Services jusqu'à la date effective de cette résiliation deviendra immédiatement exigible et payable en totalité ; et
- votre Boutique Runner AI sera mise hors ligne.
(5) S'il y a des Frais impayés dus par vous à la date de résiliation du Service, vous recevrez une facture finale par e-mail. Une fois cette facture payée en totalité, vous ne serez plus facturé.
(6) Comptes Gratuits Inactifs : Pour les Boutiques sur un plan d'abonnement gratuit (à l'exclusion des « essais gratuits » temporaires d'un plan payant), Runner AI se réserve le droit de supprimer définitivement la Boutique et toutes les données associées si la Boutique reste inactive pendant une période de quatorze (14) jours consécutifs. Runner AI fournira un avis via l'Adresse E-mail Principale avant une telle suppression. Vous reconnaissez que Runner AI n'aura aucune responsabilité pour toute perte de données résultant de la suppression d'une Boutique inactive en vertu de cette Section.
## 15. Modifications
### Ce qui signifie
Si nous apportons un changement important aux Conditions d'Utilisation qui affecte négativement vos droits en vertu des Conditions d'Utilisation ou votre utilisation de nos Services de manière importante, nous vous en informerons à l'avance (sauf si le changement concerne des exigences légales ou pour prévenir les abus de nos Services, entre autres).
(1) Nous nous réservons le droit, à notre seule et absolue discrétion, de mettre à jour ou de modifier toute partie des Conditions d'Utilisation à tout moment. Nous vous fournirons un préavis raisonnable des modifications des Conditions d'Utilisation qui affectent matériellement et négativement votre utilisation des Services ou vos droits en vertu des Conditions d'Utilisation en envoyant un e-mail à l'Adresse E-mail Principale, en fournissant un avis via la console administrative Runner AI, ou par des moyens similaires. Cependant, Runner AI peut apporter des modifications qui affectent matériellement et négativement votre utilisation des Services ou vos droits en vertu des Conditions d'Utilisation à tout moment et avec effet immédiat (i) pour des raisons légales, réglementaires, de prévention de la fraude et des abus, ou de sécurité ; ou (ii) pour restreindre des produits ou activités que nous jugeons dangereux, inappropriés ou offensants. Sauf indication contraire dans notre avis (le cas échéant), tout changement aux Conditions d'Utilisation sera effectif immédiatement lors de la publication de ces conditions mises à jour à cet emplacement. Votre accès continu aux ou votre utilisation des Services après que nous fournissons un tel avis, le cas échéant, ou après que nous publions ces conditions mises à jour, constitue votre acceptation des changements et votre consentement à être lié par les Conditions d'Utilisation telles que modifiées. Si vous n'êtes pas d'accord avec les Conditions d'Utilisation modifiées, vous devez cesser d'accéder et d'utiliser les Services.
(2) Runner AI peut modifier les Frais pour les Services de temps à autre. Nous vous fournirons un préavis de 30 jours avant tout changement de Frais en envoyant un e-mail à l'Adresse E-mail Principale, en fournissant un avis via la console administrative Runner AI, ou par des moyens similaires. Runner AI ne sera pas responsable envers vous ou envers un tiers pour toute modification, changement de prix, suspension ou interruption des Services (ou de toute partie de ceux-ci).
## 16. Conditions Générales
(1) Les Conditions d'Utilisation, y compris les documents qu'elles incorporent par référence, constituent l'intégralité de l'accord entre vous et Runner AI et régissent votre utilisation des Services et de votre Compte, remplaçant tout accord antérieur entre vous et la société (y compris, mais sans s'y limiter, toute version antérieure des Conditions d'Utilisation).
(2) Le manquement de Runner AI à exercer ou à faire respecter tout droit ou disposition des Conditions d'Utilisation ne constituera pas une renonciation à ce droit ou cette disposition. Si une disposition des Conditions d'Utilisation, y compris tous les termes et conditions et autres documents qu'elles incorporent par référence, est jugée contraire à la loi par un tribunal compétent, cette disposition sera modifiée et interprétée de manière à réaliser au mieux les objectifs de la disposition originale dans toute la mesure permise par la loi, et les dispositions restantes des Conditions d'Utilisation resteront pleinement en vigueur et de plein effet.
(3) À l'exception de Runner AI et de ses affiliés, vous ou toute personne accédant aux Services Runner AI conformément à ces Conditions d'Utilisation, sauf indication contraire dans ces Conditions d'Utilisation, aucune personne ou entité qui n'est pas partie à ces Conditions d'Utilisation n'aura le droit de faire respecter toute condition des Conditions d'Utilisation, que cette personne ou entité ait été identifiée par son nom, en tant que membre d'une classe ou en répondant à une description particulière. Pour éviter toute ambiguïté, cela n'affectera pas les droits de tout cessionnaire ou transféré autorisé de ces Conditions.
(4) Ces Conditions d'Utilisation et tout litige ou réclamation découlant de ou dans le cadre de celles-ci seront régis par et interprétés conformément aux lois de l'État du Delaware, sans égard à ses principes de conflits de lois.
(5) Les Conditions d'Utilisation peuvent être disponibles dans des langues autres que l'anglais. Dans la mesure où il existe des incohérences ou des conflits entre ces Conditions d'Utilisation en anglais et les Conditions d'Utilisation de Runner AI disponibles dans une autre langue, la version anglaise la plus récente des Conditions d'Utilisation prévaudra. Tout litige découlant de ces Conditions d'Utilisation sera résolu en anglais sauf si autrement déterminé par Runner AI (agissant à sa seule discrétion) ou tel que requis par la loi applicable.
(6) Tous les termes et dispositions des Conditions d'Utilisation seront contraignants et profiteront aux parties aux Conditions d'Utilisation et à leurs héritiers, successeurs, cessionnaires autorisés et représentants légaux respectifs. La société sera autorisée à céder ces Conditions d'Utilisation sans préavis à vous ou consentement de votre part. Vous n'aurez aucun droit de céder ou de transférer autrement les Conditions d'Utilisation, ou l'un de vos droits ou obligations en vertu des présentes, à un tiers sans le consentement écrit préalable de Runner AI, qui sera donné ou refusé à la seule discrétion de Runner AI.
(7) Si une disposition, ou une partie de la disposition, de ces Conditions d'Utilisation est, pour quelque raison que ce soit, jugée invalide, illégale ou inapplicable à quelque égard que ce soit, alors cette invalidité, illégalité ou inapplicabilité n'affectera aucune autre disposition (ou la partie non affectée de la disposition) des Conditions d'Utilisation, et les Conditions d'Utilisation seront interprétées comme si cette disposition invalide, illégale ou inapplicable, ou partie de la disposition, n'avait jamais été contenue dans les Conditions d'Utilisation.
(8) À la résiliation, tous les droits et obligations connexes en vertu des Conditions d'Utilisation prennent immédiatement fin, sauf que (a) vous resterez responsable de l'exécution de toutes vos obligations dans le cadre des transactions conclues avant la résiliation et de toutes les responsabilités qui ont été accumulées avant ou en raison de la résiliation ; et les Sections 1 (Conditions de Compte), 5 (Paiement des Frais), 6 (Confidentialité), 7 (Limitation de Responsabilité et Indemnisation), 8.1 (Propriété Intellectuelle et Vos Contenus), 10 (Commentaires et Avis), 12 (Confidentialité et Protection des Données), 13 (Partie Contractante de Runner AI), 14 (Annulation et Résiliation), 15 (Modifications) et 16 (Conditions Générales) survivront à la résiliation ou à l'expiration de ces Conditions d'Utilisation.
---
Adaptive Machines, Inc.
131 Continental Dr Suite 305 Newark, DE, 19713 US
---
# Account e Impostazioni
Source: https://www.runnerai.com/docs/it/guides/account-and-settings
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Runner raggruppa le impostazioni in base a chi o cosa influenzano: lo spazio di lavoro, il negozio corrente o tu. Ciò mantiene la fatturazione condivisa e i membri separati dai domini specifici del negozio e dal tuo profilo personale.
## Cosa copre questa guida
Saprai dove vive ogni gruppo di impostazioni e quali pagine richiedono un ruolo, un piano, un negozio pubblicato o una funzione in fase.
## Disponibilità e prerequisiti
- Devi essere connesso.
- Apri **Impostazioni** dal menu dello spazio di lavoro o del progetto.
- Le impostazioni del negozio appaiono solo quando apri Impostazioni dall'interno di un progetto.
- Prima di modificare qualcosa, verifica il nome dello spazio di lavoro o del negozio nella barra laterale delle impostazioni. I controlli personali compaiono sotto il nome del tuo account.
- Per terminare le sessioni su altri dispositivi o eliminare il tuo account, contatta il supporto di Runner. Consulta [Sicurezza e sessioni](/it/guides/account-and-settings/security-and-sessions).
- Alcuni controlli richiedono il permesso di proprietario dello spazio di lavoro o amministratore.
- Le pagine Dominio, Chiave API e Esperimenti possono essere nascoste o controllate da piano, stato di pubblicazione o disponibilità in fase.
## Apri Impostazioni
1. Apri il menu dello spazio di lavoro o del progetto desiderato.
2. Seleziona **Impostazioni**.
3. Controlla il selettore **Spazio di lavoro: _nome dello spazio_**, poi scegli una pagina sotto quel gruppo, **Negozio: _nome del negozio_** o il nome del tuo account. Aprendo Impostazioni da un negozio, puoi partire da Generali del negozio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Controlla le intestazioni dello spazio di lavoro e del negozio prima di scegliere una pagina. I controlli dell'account si trovano sotto questi gruppi.
## Mappa delle impostazioni
| Gruppo e pagina | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| Spazio di lavoro → **Generale** | Rinomina o descrivi lo spazio di lavoro. | Le modifiche valide vengono salvate automaticamente. La zona di pericolo contiene anche Elimina spazio di lavoro. |
| Spazio di lavoro → **Membri** | Invita persone e gestisci l'accesso attivo o in sospeso. | I proprietari possono invitare, annullare gli inviti o rimuovere i membri; i membri idonei possono uscire. |
| Spazio di lavoro → **Piano e fatturazione** | Rivedi il piano corrente e le azioni di fatturazione disponibili. | Le schede del piano, la conferma, il checkout, la gestione della fatturazione e le opzioni di credito extra appaiono in base allo stato dell'account. |
| Spazio di lavoro → **Utilizzo e crediti** | Comprendi il saldo, le fonti e la spesa. | Un controllo di intervallo di date aggiorna il riepilogo, il grafico, le schede di categoria e il feed di attività. |
| Negozio → **Generale** | Gestisci l'identità del negozio corrente e l'aspetto della ricerca. | Appaiono i controlli Nome, Titolo pagina, Descrizione, favicon, filigrana e Elimina negozio. |
| Negozio → **Dominio** | Connetti, acquista, rinnova o trasferisci un dominio. | La disponibilità dipende da piano, pubblicazione, permesso e stato del dominio. |
| Negozio → **Script personalizzati** | Aggiungi JavaScript alla vetrina. | Le modifiche rimangono non salvate fino a quando non selezioni **Salva modifiche**. |
| Negozio → **Agente** | Scegli le Skill disponibili in questo progetto. | Puoi aggiungere o disabilitare Skill configurabili per questo negozio. |
| Negozio → **Esperimenti** | Configura gli obiettivi dell'esperimento automatizzato e il traffico. | Questa pagina Beta appare solo quando abilitata e richiede un negozio pubblicato. |
| Nome del tuo account → **Le mie impostazioni** | Scegli lingua, email settimanali sulle prestazioni e suoni dell'interfaccia. | Le preferenze vengono salvate; un cambio di lingua ricarica la pagina nella lingua selezionata. |
| Nome del tuo account → **Chiavi API** | Crea credenziali per l'accesso tramite programmi. | Il segreto completo compare una sola volta; la revoca è distruttiva. La pagina è disponibile solo in alcuni casi. |
## Scegli l'ambito giusto
1. Usa **Spazio di lavoro** per membri, crediti condivisi, piano e fatturazione.
2. Usa **Negozio** per la vetrina corrente, il dominio, gli script e le impostazioni dell'Agent del progetto.
3. Usa **Personale** per profilo, lingua e chiavi API personali.
4. Prima di un'azione sensibile, conferma i nomi dello spazio di lavoro e del negozio mostrati nella finestra di dialogo.
## Stati comuni e limiti
- **Salvataggio in corso…** seguito da **Salvato** conferma che un campo di salvataggio automatico è terminato.
- Un controllo disabilitato può indicare permesso mancante, un gate del piano, un prerequisito del negozio o un'operazione già in corso.
- Le pagine di fatturazione e dominio mostrano i termini e l'importo correnti. Non fare affidamento su uno screenshot vecchio o su un prezzo copiato.
- Le azioni distruttive richiedono conferma, ma la conferma esatta differisce per azione.
- Le pagine nascoste non devono essere aperte tramite link copiati a meno che l'interfaccia corrente non le esponga per il tuo account.
## Risoluzione dei problemi
- Se il gruppo Negozio è mancante, chiudi Impostazioni, accedi al progetto previsto e apri di nuovo Impostazioni.
- Se una pagina mostra uno stato di aggiornamento o pubblicazione-prima, completa solo quel prerequisito se si adatta al tuo flusso di lavoro previsto.
- Se un salvataggio automatico non riesce, il valore precedente rimane o ritorna; correggi il campo e riprova.
- Se non sei sicuro di quale spazio di lavoro viene modificato, chiudi la finestra di dialogo e riapri Impostazioni da quello spazio di lavoro.
- Se hai bisogno di aiuto per la sicurezza dell'account ma nessun accesso approvato è visibile, contatta il supporto di Runner invece di indovinare un percorso diretto.
## Guide correlate
- [Spazio di lavoro generale](/it/guides/account-and-settings/workspace-general)
- [Membri e inviti](/it/guides/workspace/members-and-invitations)
- [Piani di abbonamento](/it/guides/plans-and-billing/subscription-plans)
- [Negozio generale](/it/guides/account-and-settings/store-general)
- [Sicurezza e sessioni](/it/guides/account-and-settings/security-and-sessions)
---
# Impostazioni Esperimenti
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/ai-lab
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le impostazioni di Esperimenti configurano esperimenti automatizzati della vetrina per un negozio pubblicato idoneo. Usalo quando desideri intenzionalmente che Runner ottimizzi un obiettivo aziendale selezionato con parte del tuo traffico live.
## Cosa copre questa guida
Saprai come abilitare l'impostazione Beta, scegliere un obiettivo e un'allocazione del traffico, salvarla e riconoscere gli stati di avvio o arresto.
## Disponibilità e prerequisiti
- La funzionalità **Esperimenti** è una pagina Beta condizionale ed è nascosta a meno che non sia abilitata per l'account.
- Il negozio deve essere pubblicato. Una bozza mostra uno stato non disponibile di pubblicazione-prima.
- L'abilitazione di Esperimenti richiede l'accettazione dei **termini degli Esperimenti** collegati.
- La modifica delle impostazioni dell'esperimento live può influire sui visitatori della vetrina. Rivedi l'obiettivo selezionato e il traffico prima di salvare.
## Percorso di accesso
In un progetto idoneo, seleziona **Impostazioni → Negozio: _nome del negozio_ → Esperimenti**.
## Controlli
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Abilita Esperimenti** switch | Rivela o interrompi la configurazione di Esperimenti del negozio. | L'attivazione rivela i controlli di obiettivo e traffico; Salva invia la configurazione abilitata. La disattivazione di una configurazione attiva inizia ad arrestarla. |
| **termini degli Esperimenti** | Rivedi i termini allegati all'abilitazione della Beta. | La sezione legale si apre in una nuova scheda. |
| **Definisci il tuo obiettivo** | Comunica a Runner quale metrica l'esperimento dovrebbe migliorare. | La selezione di un obiettivo contrassegna quella scheda come attiva. |
| **Traffico** slider/input | Scegli la quota di traffico della vetrina allocata agli esperimenti. | Il valore rimane entro il minimo visualizzato e il 100%. |
| Pulsanti percentuale rapida | Scegli un valore di traffico comune. | Lo slider e il valore numerico si aggiornano insieme. |
| **Salva** | Applica le impostazioni di obiettivo e traffico abilitate. | Runner avvia l'operazione di configurazione e disabilita i controlli fino al completamento. |
Gli obiettivi disponibili includono Tasso di conversione, Tasso di aggiunta al carrello, Tasso di checkout avviato, Tasso di coinvolgimento del banner, Tasso di clic del pulsante e Valore medio dell'ordine.
I passaggi di configurazione seguenti sono disponibili solo dopo la pubblicazione. Se compare un selettore del modello, controlla il modello disponibile prima di salvare: le opzioni dipendono dal tuo account. Consulta la [pubblicazione](/it/guides/storefront-and-publishing) se il negozio è ancora una bozza.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il negozio non pubblicato mostra un prerequisito al posto dei controlli degli esperimenti. Non è stato avviato né misurato alcun esperimento.
## Configura Esperimenti
1. Pubblica il negozio, quindi apri **Negozio → Esperimenti**.
2. Leggi la descrizione Beta e i **termini degli Esperimenti**.
3. Attiva **Abilita Esperimenti**.
4. Seleziona un obiettivo.
5. Scegli un'allocazione del traffico pari o superiore al minimo visualizzato.
6. Rivedi l'obiettivo selezionato e la percentuale.
7. Seleziona **Salva**.
8. Attendi il completamento dello stato di avvio e conferma lo stato salvato prima di uscire.
## Arresta Esperimenti
1. Torna alle impostazioni Esperimenti dello stesso negozio.
2. Disattiva **Abilita Esperimenti**.
3. Attendi **Arresto dell'esperimento, attendere…**.
4. Conferma lo stato disabilitato dopo il completamento dell'operazione.
Non ripetere l'interruttore mentre un'operazione è in corso.
## Stati e limiti
- Un negozio non pubblicato mostra che la funzione non è attualmente disponibile e ti chiede di pubblicare prima.
- **Avvio dell'esperimento, attendere…** blocca le modifiche simultanee.
- **Arresto dell'esperimento, attendere…** blocca le modifiche simultanee.
- L'obiettivo è obbligatorio prima di Salva.
- Il traffico è vincolato al minimo visualizzato fino al 100%.
- L'intera voce di impostazioni può essere assente per gli account senza la funzione.
## Risoluzione dei problemi
- Se Esperimenti è mancante, non fare affidamento su un collegamento diretto copiato; la funzione non è abilitata per l'account.
- Se la pagina ti chiede di pubblicare, completa la pubblicazione prima di configurare un esperimento live.
- Se Salva segnala che un obiettivo è obbligatorio, seleziona una scheda di obiettivo e riprova.
- Se i controlli sono disabilitati, attendi il completamento dell'operazione di avvio o arresto corrente.
- Se lo stato salvato non è chiaro, riapri la pagina prima di attivare di nuovo.
## Guide correlate
- [Negozio generale](./store-general)
- [Piani di abbonamento](../plans-and-billing/subscription-plans)
- [Panoramica di Account e Impostazioni](/it/guides/account-and-settings)
---
# Chiavi API
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/api-keys
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le chiavi API sono segreti personali per l'accesso programmatico a Runner. Creane una solo per un'applicazione di cui ti fidi, conservala in modo sicuro e revocala quando non è più necessaria.
## Cosa copre questa guida
Saprai come creare e salvare il segreto una tantum, identificare le chiavi esistenti senza esporle e revocare una chiave con conferma.
## Disponibilità e prerequisiti
- **Chiavi API** è condizionale e appare solo quando abilitata per il tuo account.
- La pagina indica **Ogni chiave agisce come te**. Le chiavi appartengono al tuo account personale, non a un singolo negozio.
- Non confonderle con le **Chiavi API Analytics** di sola lettura in [Generali dello spazio di lavoro](/it/guides/account-and-settings/workspace-general).
- Non mettere mai una chiave completa in chat, Agent Memory, una Skill, uno screenshot, il controllo del codice sorgente o la documentazione del prodotto.
## Percorso di accesso
Seleziona **Impostazioni → nome del tuo account → Chiavi API**. Se la voce non compare, la funzione non è disponibile per l'account attuale.
## Controlli
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Genera nuova chiave** | Crea una nuova credenziale. | Si apre una finestra di dialogo con un campo Nome facoltativo. |
| **Nome** | Identifica l'applicazione in seguito senza esporre il segreto. | Il nome appare nella tabella delle chiavi; vuoto crea una chiave senza titolo. |
| **Crea chiave** | Genera la credenziale. | Runner apre **Chiave API generata** e visualizza il segreto completo una sola volta. |
| Icona occhio | Controlla il valore completamente generato di recente prima di archiviarlo. | Il valore una tantum viene mostrato o mascherato nella finestra di dialogo di successo. |
| Icona copia | Copia la nuova chiave con precisione. | Runner la copia negli appunti e mostra la conferma. |
| **L'ho salvata** | Chiudi la visualizzazione del segreto una tantum. | Il valore completo viene cancellato dalla finestra di dialogo e non può essere mostrato di nuovo lì. |
| Tabella chiave esistente | Identifica le chiavi in modo sicuro. | Runner mostra Nome, Prefisso, Creato e Ultimo utilizzo, non il segreto completo. |
| Icona Elimina | Revoca una chiave esistente. | Una conferma spiega che la revoca non può essere annullata. |
| **Revoca** | Disabilita la chiave selezionata. | Dopo il successo, la chiave viene rimossa dall'elenco e non può più autenticarsi. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg0z7QP9dmUDVzwn9xNJv4t2isec7IFkOaWAro)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
L'elenco vuoto è lo stato iniziale. In questo esempio non è stato generato né mostrato alcun segreto.
## Esamina la finestra prima di creare una credenziale
1. Seleziona **Genera nuova chiave**.
2. Individua il campo facoltativo **Nome**: un'etichetta come `Reporting integration` aiuta a riconoscere l'applicazione in seguito.
3. Se stai solo esplorando, seleziona **Annulla**. La chiave viene creata solo selezionando **Crea chiave**.
La procedura seguente si applica quando Chiavi API è disponibile e sei pronto a conservare un nuovo segreto.
## Genera e archivia una chiave
1. Apri **nome del tuo account → Chiavi API**.
2. Seleziona **Genera nuova chiave**.
3. Inserisci un Nome descrittivo, ad esempio l'applicazione o l'ambiente. Non mettere un segreto nel nome.
4. Seleziona **Crea chiave**.
5. In **Chiave API generata**, rivela la chiave solo se necessario e seleziona Copia.
6. Archiviala in un gestore di segreti affidabile.
7. Conferma il valore archiviato prima di selezionare **L'ho salvata**.
8. Usa il Prefisso della tabella per identificare la chiave in seguito senza esporre il valore completo.
Runner avverte che la chiave completa non verrà più mostrata. Se chiudi la finestra di dialogo senza salvarla, revoca quella chiave e crea una sostituzione piuttosto che cercare di recuperare il segreto.
## Revoca una chiave
1. Abbina la chiave prevista per Nome e Prefisso.
2. Seleziona la sua icona Elimina.
3. Rivedi la conferma **Revoca**.
4. Seleziona **Revoca** solo quando l'applicazione dipendente è pronta a smettere di usarla.
5. Conferma **Chiave API revocata** e rimuovi il vecchio segreto dall'applicazione.
La revoca è distruttiva e non può essere annullata. Crea una nuova chiave se l'accesso è necessario di nuovo.
## Stati e limiti
- **Nessuna chiave API ancora** è lo stato vuoto normale.
- Il valore completo di una nuova chiave appare solo nella sua finestra di dialogo di successo.
- Le righe esistenti mostrano un prefisso e le date di utilizzo, non una chiave recuperabile.
- **Mai** sotto Ultimo utilizzo significa che Runner non ha registrato una richiesta per quella chiave.
- I pulsanti Crea e Revoca mostrano lo stato di avanzamento e non devono essere inviati ripetutamente.
## Risoluzione dei problemi
- Se Chiavi API è mancante, non usare un collegamento diretto copiato; la funzione è disabilitata per questo account.
- Se la copia negli appunti non riesce, rivela il nuovo valore e copialo manualmente in un gestore di segreti sicuro, quindi nascondilo di nuovo.
- Se hai perso una chiave completa, revoca la sua riga e genera una sostituzione.
- Se un'applicazione smette di funzionare dopo la revoca, aggiornala con una chiave appena creata; la vecchia chiave non può essere ripristinata.
- Se è stata selezionata la chiave sbagliata, Annulla la conferma e confronta di nuovo Nome e Prefisso.
## Guide correlate
- [Sicurezza e sessioni](./security-and-sessions)
- [Impostazioni personali e spazi di lavoro](./personal-settings-and-workspaces)
- [Sicurezza della memoria](../agent/memory)
---
# Script personalizzati e Store Agent
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/custom-scripts-and-store-agent
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Gli script personalizzati modificano il comportamento della vetrina, mentre Store Agent modifica quali Skill Runner può utilizzare per il progetto corrente. Entrambi sono impostazioni specifiche del negozio e devono essere riviste con cura extra.
## Cosa copre questa guida
Sarai in grado di aggiungere e salvare uno script, metterlo in pausa senza eliminarlo e aggiungere o disabilitare una Skill solo per il progetto corrente.
## Disponibilità e prerequisiti
- Apri Impostazioni dall'interno del progetto previsto.
- JavaScript personalizzato può modificare il comportamento della vetrina. Aggiungi solo codice che comprendi e di cui ti fidi.
- Le azioni Skill dipendono dalle Skill dello spazio di lavoro disponibili e dal fatto che una Skill di sistema sia configurabile.
- La pagina Agent completa e il gate del piano controllano ancora la disponibilità più ampia della Skill.
## Percorsi di accesso
- Script: **Impostazioni → Negozio: _nome del negozio_ → Script personalizzati**
- Competenze del progetto: **Impostazioni → Negozio: _nome del negozio_ → Agente**
## Controlli Script personalizzati
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Aggiungi script** | Crea una voce di script della vetrina. | Una nuova riga Script abilitata si apre con codice JavaScript vuoto. |
| Riga script | Espandi o comprimi il suo editor. | **Nome script** e **Codice JavaScript** diventano visibili. |
| Icona occhio / occhio nascosto | Abilita o disabilita uno script. | La riga locale cambia stato; seleziona Salva modifiche per applicarla. |
| Icona Elimina | Rimuovi uno script dall'elenco in sospeso. | La riga scompare senza una seconda finestra di dialogo; Salva modifiche applica la rimozione. |
| **Salva modifiche** | Applica ogni modifica di script in sospeso. | Runner salva l'elenco completo degli script e mostra un messaggio di successo o errore. |
Runner consente fino a dieci voci di script. Il pulsante Salva modifiche rimane disabilitato quando non c'è nulla da modificare.
L'editor vuoto permette di esaminare i campi prima dell'installazione. In questo esempio non è stato salvato alcuno script di tracciamento.
## Aggiungi o modifica uno script
1. Apri **Negozio → Script personalizzati**.
2. Seleziona **Aggiungi script**.
3. Inserisci un **Nome script** chiaro e un **Codice JavaScript** affidabile.
4. Lascia lo script abilitato solo se dovrebbe essere eseguito sulla vetrina.
5. Rivedi tutte le altre righe perché **Salva modifiche** applica l'intero elenco.
6. Seleziona **Salva modifiche** e attendi **Salvato**.
7. Controlla la vetrina in modo sicuro dopo il salvataggio.
Runner tenta di impedire che un errore di uno script arresti la pagina, ma ciò non rende il codice sconosciuto sicuro. Uno script può comunque influire sulla privacy, le prestazioni, il tracciamento e l'esperienza del cliente.
### Esamina prima una bozza dello script
Per iniziare, seleziona **Aggiungi script**, chiamalo `Store analytics` e disattiva il controllo con l'icona dell'occhio. Lascia vuoto il codice e non selezionare **Salva modifiche**. Puoi così riconoscere l'editor e lo stato disabilitato prima di aggiungere codice di un fornitore affidabile. Quando salvi uno script reale, riapri l'elenco e controlla sia il codice sia lo stato di attivazione.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Per le competenze del progetto, scegli **Agente** sotto l'intestazione del negozio. L'immagine mostra la voce di accesso, non l'aggiunta o la disattivazione di una competenza.
## Controlli Store Agent
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| Riga Skill attiva | Vedi quale Skill è disponibile in questo progetto. | La riga mostra nome, descrizione e tipo Sistema o Personalizzato. |
| **Disabilita** | Rimuovi una Skill configurabile da questo progetto solo. | La Skill esce dall'elenco attivo di questo progetto; non viene eliminata globalmente. |
| **Aggiungi competenza** | Aggiungi una Skill dello spazio di lavoro disponibile a questo progetto. | La selezione di una Skill elencata la abilita per il progetto corrente. |
| **Crea competenza personalizzata…** | Crea una nuova capacità personalizzata. | L'editor Skill si apre, quindi l'elenco del progetto si aggiorna dopo il successo. |
## Configura Skill del progetto
1. Apri **Negozio → Agent**.
2. Rivedi le Skill attualmente attive.
3. Seleziona **Aggiungi competenza**, quindi scegli una Skill disponibile o **Crea competenza personalizzata…**.
4. Attendi il messaggio di successo e conferma che la Skill appare.
5. Usa **Disabilita** quando una Skill configurabile dovrebbe smettere di applicarsi a questo progetto.
6. Apri **Agente** nella navigazione del progetto per consultare i dettagli completi delle competenze e le azioni di sospensione, modifica, importazione o eliminazione.
## Stati e limiti
- Le modifiche dello script rimangono locali fino al completamento di **Salva modifiche**.
- La rimozione di una riga di script non ha una conferma separata prima di Salva modifiche.
- Il raggiungimento di dieci script disabilita **Aggiungi script**.
- Store Agent può mostrare caricamento, un errore, **Nessuna skill abilitata** o l'elenco attivo.
- Le Skill di sistema fisse non mostrano **Disabilita**.
- La disabilitazione in Store Agent modifica l'ambito di questo progetto; non elimina o mette in pausa globalmente la Skill.
## Risoluzione dei problemi
- Se uno script continua a essere eseguito, conferma che il suo stato disabilitato è stato seguito da **Salva modifiche**.
- Se Salva non riesce, l'elenco precedentemente salvato rimane invariato; correggi il codice o riprova dopo l'errore.
- Se **Aggiungi competenza** non ha la voce prevista, controlla la pagina Agent completa e il piano corrente.
- Se **Disabilita** è assente, la Skill di sistema non è configurabile per questo progetto.
- Se una nuova Skill appare globalmente ma non qui, aggiungila al progetto da Store Agent.
## Guide correlate
- [Negozio generale](./store-general)
- [Skill Agent](../agent/skills)
- [Crea, importa e gestisci Skill](../agent/create-import-manage-skills)
- [Sicurezza della chiave API](./api-keys)
---
# Elimina, recupera e esci
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/delete-recover-and-leave
Runner utilizza diversi flussi di conferma per eliminare un negozio, eliminare uno spazio di lavoro, uscire da uno spazio di lavoro e richiedere l'eliminazione dell'account. Rivedi l'ambito esatto prima di qualsiasi azione distruttiva.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Prima di aprire un’azione di rimozione, verifica in **Settings** se riguarda lo spazio di lavoro o il negozio. Questa immagine mostra solo la navigazione; non è stata eseguita alcuna eliminazione o operazione di recupero.
Le annotazioni sono in inglese. Seleziona l’immagine per ingrandirla.
## Cosa copre questa guida
Saprai cosa rimuove ogni azione, quale conferma richiede e quando il recupero condizionale del negozio potrebbe apparire.
## Disponibilità e prerequisiti
- Hai bisogno del permesso per l'elemento che stai modificando.
- L'ultimo spazio di lavoro non può essere eliminato.
- Il recupero dei negozi è una funzione precedente disponibile solo in alcuni casi. Usala solo se Runner mostra **Eliminati di recente** e il negozio vi compare. La navigazione attuale non garantisce questa destinazione.
- Non trattare il recupero condizionale come una garanzia quando approvi l'eliminazione.
- La pagina dell'account protetto di sicurezza globale corrente avatar e menu Impostazioni non espongono. Usa l'eliminazione dell'account solo quando Runner o il supporto di Runner ti fornisce un accesso approvato.
## Percorsi di accesso e mappa delle azioni
| Azione e percorso di accesso | Conferma | Cosa succede dopo il successo |
| --- | --- | --- |
| Impostazioni → Negozio: _nome del negozio_ → **Generale → Elimina** | Digita il nome esatto del negozio, poi seleziona **Elimina**. | Il negozio viene rimosso. Se elimini quello attuale, Runner apre un altro negozio disponibile o la schermata per crearne uno. |
| Selezione multipla condizionale → **Elimina selezionati** | Digita `DELETE`, quindi seleziona **Elimina tutto**. | I negozi selezionati escono dalla griglia attiva dopo il completamento dell'operazione. |
| Elenco negozi precedente, se disponibile → **Eliminati di recente → Recupera progetto** | Non serve una conferma distruttiva: seleziona Recupera progetto. | Il negozio torna nell'elenco dei progetti attivi e le sue risorse ricominciano a prepararsi. |
| Impostazioni → Spazio di lavoro → Generale → **Elimina spazio di lavoro** | Il proprietario digita il nome esatto dello spazio di lavoro, quindi seleziona **Elimina**. | Runner rimuove lo spazio di lavoro e passa a un altro spazio di lavoro disponibile. |
| Impostazioni → Spazio di lavoro → Membri → la tua riga → **Esci** | Rivedi la finestra di dialogo dello spazio di lavoro denominato, quindi seleziona **Esci**. | Perdi l'accesso ai suoi progetti e Runner ti reindirizza a un altro spazio di lavoro disponibile o al selettore. |
| Eliminazione dell'account → email a support@adaptivemachines.ai | Invia la richiesta dall'indirizzo email del tuo account Runner. | Il supporto di Runner risponde con il passaggio successivo. |
## Elimina un negozio
1. Nel negozio desiderato, apri **Impostazioni → Negozio: _nome del negozio_ → Generale** e controlla i nomi dello spazio di lavoro e del negozio.
2. Seleziona **Elimina**.
3. Leggi l'avvertimento sui dati del negozio.
4. Digita il nome esatto del negozio.
5. Seleziona il pulsante distruttivo **Elimina**.
6. Attendi l'esito dell'eliminazione. Verifica che Runner abbia aperto un altro negozio o la schermata di creazione, poi controlla che il negozio eliminato non sia più disponibile.
La conferma avverte che l'azione non può essere invertita. Sebbene alcuni account mostrino una funzione di recupero separata, potrebbe essere assente o non disponibile; non eliminare supponendo che Recupera apparirà.
## Recupera un negozio dalla vista precedente, se disponibile
1. Continua solo se lo spazio di lavoro mostra l'elenco negozi precedente e la voce **Eliminati di recente**.
2. Apri **Eliminati di recente**; non cercarla nella navigazione attuale e non tentare un collegamento diretto inventato.
3. Abbina il negozio per nome e data di eliminazione.
4. Seleziona **Recupera progetto** una sola volta.
5. Attendi **Progetto recuperato** e conferma che il negozio ritorna all'elenco attivo.
6. Aprilo solo dopo che le sue risorse dello spazio di lavoro richieste diventano disponibili.
Se **Eliminati di recente** non compare, quella vista non offre un percorso di recupero. Contatta l'assistenza se ti serve aiuto: questa guida non garantisce la disponibilità della funzione né un termine di recupero.
## Elimina uno spazio di lavoro
1. Come proprietario dello spazio di lavoro, apri **Impostazioni → Spazio di lavoro → Generale** per lo spazio di lavoro esatto.
2. Seleziona **Elimina spazio di lavoro**.
3. Leggi l'avvertimento di rimozione permanente.
4. Digita il nome esatto dello spazio di lavoro.
5. Seleziona **Elimina**.
6. Conferma che Runner passa a un altro spazio di lavoro.
L'unico spazio di lavoro non può essere eliminato. L'eliminazione di uno spazio di lavoro è presentata come permanente e non recuperabile.
## Esci da uno spazio di lavoro
1. Apri **Impostazioni → Spazio di lavoro → Membri**.
2. Trova la tua riga contrassegnata **(tu)**.
3. Seleziona **Esci** se disponibile.
4. Conferma il nome dello spazio di lavoro e seleziona **Esci** nella finestra di dialogo.
5. Conferma che sei reindirizzato e non hai più accesso ai suoi progetti.
L'uscita non elimina lo spazio di lavoro per i suoi membri rimanenti. La riga Proprietario non offre questa azione Esci sulla pagina Membri.
## Richiedi eliminazione dell'account
1. Scrivi a support@adaptivemachines.ai dall'indirizzo email del tuo account Runner.
2. Chiedi di eliminare l'account.
3. Segui le istruzioni nella risposta del supporto di Runner.
Questa richiesta è più ampia dell'eliminazione di un negozio o di uno spazio di lavoro. Rivedi [Sicurezza e sessioni](./security-and-sessions) prima di continuare.
## Risoluzione dei problemi
- Un pulsante finale disabilitato significa che il testo di conferma non corrisponde esattamente o l'azione è ancora in corso.
- Un errore di eliminazione non dimostra che nulla sia cambiato. Aggiorna l'elenco attivo e controlla l'elemento prima di riprovare.
- **Recupero in corso…** blocca altri pulsanti Recupera fino al completamento della richiesta corrente.
- Se il recupero segnala un errore, controlla gli elenchi degli elementi attivi ed eliminati di recente prima di riprovare.
- Se l'uscita segnala un errore, verifica l'accesso attuale e lo spazio di lavoro prima di riprovare.
- Se non ricevi risposta sull'eliminazione dell'account, non inviare più richieste. Rispondi invece nella stessa conversazione email.
## Guide correlate
- [Negozio generale](./store-general)
- [Spazio di lavoro generale](./workspace-general)
- [Membri e inviti](../workspace/members-and-invitations)
- [Sicurezza e sessioni](./security-and-sessions)
---
# Impostazioni personali e spazi di lavoro
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/personal-settings-and-workspaces
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le Mie Impostazioni modifica le preferenze di Runner in tutti i progetti. Usa separatamente il selettore dello spazio di lavoro quando vuoi lavorare con un altro team.
## Cosa copre questa guida
Scegli lingua dell'interfaccia, email settimanali sulle prestazioni e suoni senza modificare le impostazioni dello spazio di lavoro.
## Disponibilità e prerequisiti
- Devi essere connesso.
- La vista **Le mie impostazioni** esaminata mostra Lingua, Email settimanali sulle prestazioni e Suoni dell'interfaccia. I controlli del profilo possono variare in base all'account o alla schermata.
- Le azioni di creazione dello spazio di lavoro e di appartenenza possono essere limitate dal permesso dell'account o dallo stato dello spazio di lavoro attuale.
## Percorsi di accesso
- Preferenze: **Impostazioni → nome del tuo account → Le Mie Impostazioni**
- Cambio di spazio di lavoro: segui la [navigazione dello spazio di lavoro](/it/guides/workspace).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBH6DLmxmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Seleziona **Le mie impostazioni** per le preferenze dell'interfaccia. **Chiavi API** apre la pagina separata delle credenziali personali.
## Controlli Le mie impostazioni
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Lingua** | Modifica la lingua dell'interfaccia di Runner. | Runner salva la scelta e ricarica la pagina attuale in quella lingua. |
| **Email settimanali sulle prestazioni** | Ricevi una volta alla settimana il report sulle prestazioni del negozio nella posta in arrivo. | L'interruttore salva se Runner invia il report; è attivo per impostazione predefinita. |
| **Suoni dell'interfaccia** | Ascolta un leggero clic quando tocchi, attivi un'opzione o ricevi un avviso. | L'interruttore salva la preferenza; disattivalo per eliminare i suoni. |
## Cambia lingua o email dei report
1. Apri **Le mie impostazioni** sotto il nome del tuo account.
2. Scegli **Lingua** quando sei pronto a ricaricare la pagina.
3. Dopo il ricaricamento, controlla che l'interfaccia usi la lingua selezionata.
4. Modifica **Email settimanali sulle prestazioni** solo se vuoi cambiare l'invio dei report del negozio.
5. Attendi il salvataggio della preferenza, poi riapri la pagina per verificarla.
## Controlla una preferenza senza modificare il profilo
1. Apri **Le mie impostazioni** e trova **Suoni dell'interfaccia**.
2. Scegli se clic e avvisi devono emettere un suono.
3. Attendi il salvataggio, poi chiudi e riapri **Le mie impostazioni**.
4. Controlla che l'interruttore corrisponda ancora alla tua scelta.
Per cambiare o creare spazi di lavoro, usa la [guida allo spazio di lavoro](/it/guides/workspace). La barra laterale attuale di Impostazioni non contiene una destinazione pubblica **Workspace**. Per uscire da uno spazio, segui [Membri e inviti](/it/guides/workspace/members-and-invitations).
## Stati e limiti
- Un aggiornamento della lingua mantiene il controllo occupato fino al completamento della persistenza e della navigazione.
- Le mie impostazioni non espongono i controlli per sessioni, eliminazione dell'account o chiave API. Consulta [Sicurezza e sessioni](./security-and-sessions) e [Chiavi API](./api-keys).
## Risoluzione dei problemi
- Se la lingua non cambia, attendi il completamento dell'aggiornamento attuale, quindi selezionala di nuovo una volta.
- Se hai aperto le impostazioni dello spazio di lavoro sbagliato, chiudi la finestra, cambia spazio e riapri Impostazioni.
- Se hai bisogno di uscire, apri la pagina Membri di quello spazio di lavoro invece di cercare Esci qui.
## Guide correlate
- [Membri e inviti](../workspace/members-and-invitations)
- [Spazio di lavoro Generale](./workspace-general)
- [Sicurezza e sessioni](./security-and-sessions)
- [Elimina, recupera e esci](./delete-recover-and-leave)
---
# Sicurezza e sessioni
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/security-and-sessions
Runner non ha una pagina nell'app che elenca le tue sessioni o elimina il tuo account. Esci dal menu dell'avatar. Il supporto di Runner gestisce le richieste per terminare le sessioni su altri dispositivi e per eliminare il tuo account.
## Cosa copre questa guida
Saprai come uscire sul dispositivo che stai usando e come chiedere al supporto di Runner di terminare altre sessioni o eliminare il tuo account.
## Disponibilità e prerequisiti
- Devi essere connesso per uscire.
- Invia le richieste al supporto dall'indirizzo email del tuo account Runner, così il supporto può confermare che l'account è tuo.
- L'eliminazione dell'account è permanente. Rimuove tutti i dati che appartengono all'account.
## Esci su questo dispositivo
1. Seleziona il tuo avatar nella navigazione in alto.
2. Seleziona **Esci**.
3. Verifica che Runner mostri la home page per utenti non connessi.
## Termina le sessioni su altri dispositivi
1. Esci su ogni dispositivo a cui hai ancora accesso.
2. Se non puoi raggiungere un dispositivo, o non riconosci un accesso, scrivi a support@adaptivemachines.ai.
3. Indica quale account è interessato e cosa hai visto.
## Richiedi eliminazione dell'account
1. Scrivi a support@adaptivemachines.ai dall'indirizzo email del tuo account Runner.
2. Chiedi di eliminare l'account.
3. Segui le istruzioni nella risposta del supporto di Runner.
Eliminare un negozio o uno spazio di lavoro non elimina il tuo account. Per queste azioni, consulta [Elimina, recupera e esci](./delete-recover-and-leave).
## Risoluzione dei problemi
- Se Runner ti mostra ancora come connesso dopo **Esci**, ricarica la pagina.
- Se il supporto non riesce ad associare la tua richiesta a un account, inviala di nuovo dall'indirizzo email che usi per accedere.
## Guide correlate
- [Chiavi API](./api-keys)
- [Impostazioni personali e spazi di lavoro](./personal-settings-and-workspaces)
- [Elimina, recupera e esci](./delete-recover-and-leave)
---
# Negozio Generale
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/store-general
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
I controlli Negozio Generale controllano la vetrina attuale piuttosto che l'intero spazio di lavoro. Usalo per rinominare il negozio, aggiornare il suo aspetto nel browser e nella ricerca, o rivedere il suo limite di eliminazione.
## Cosa copre questa guida
Sarai in grado di aggiornare i campi di identità del negozio, salvare una favicon, comprendere il controllo della filigrana gestito dal piano e evitare di eliminare il negozio sbagliato.
## Disponibilità e prerequisiti
- Apri Impostazioni dall'interno del progetto desiderato; altrimenti il gruppo Negozio non viene mostrato.
- I campi di ricerca richiedono il caricamento delle impostazioni del backend del negozio.
- La rimozione della filigrana di Runner richiede il piano mostrato accanto a quel controllo.
- Elimina negozio è distruttivo e richiede il nome esatto del negozio.
## Percorso di accesso
Nel progetto desiderato, seleziona **Impostazioni → Negozio: _nome del negozio_ → Generale**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Seleziona **Generale** sotto l'intestazione del negozio, non dello spazio di lavoro. Questo dettaglio della navigazione non mostra campi modificati o salvati.
## Controlli
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| Spazio di lavoro associato, Creatore, Ora di creazione | Conferma quale negozio e contesto di proprietà stai visualizzando. | Questi dettagli sono di sola lettura. |
| **Nome** | Rinomina il negozio all'interno di Runner. | Una modifica valida viene salvata automaticamente. |
| **Titolo pagina** | Imposta il titolo mostrato nelle schede del browser e nei risultati di ricerca. | Una modifica valida viene salvata automaticamente e aggiorna l'anteprima. |
| **Descrizione** | Imposta la breve descrizione di ricerca del negozio. | Una modifica valida viene salvata automaticamente. |
| Pulsante favicon | Modifica l'icona della scheda del browser. | Si apre un popover con le scelte **Carica** e **Generato da IA**. |
| **Carica immagine** | Usa il tuo file favicon. | Runner convalida il file e mostra un'anteprima prima di **Salva**. |
| **Esegui** | Genera una favicon dal prompt. | Runner mostra un'anteprima generata; non viene applicata fino a **Salva**. |
| Interruttore Rimuovi filigrana | Controlla la filigrana della vetrina di Runner. | La modifica è disponibile solo sul piano mostrato accanto al controllo. |
| **Chat per gli acquirenti** | Consenti agli acquirenti di ottenere risposte immediate nella vetrina. | L'interruttore salva la preferenza del negozio e aggiorna un'anteprima aperta. È attivo per impostazione predefinita. |
| **Elimina** | Rimuovi il negozio attuale. | **Elimina negozio** si apre e richiede il nome esatto del negozio. |
## Aggiorna l'identità del negozio
1. Apri **Negozio → Generale** e conferma lo spazio di lavoro associato e il nome del negozio.
2. Modifica **Nome**, **Titolo pagina** o **Descrizione**.
3. Attendi **Salvato** dopo ogni campo di salvataggio automatico.
4. Controlla l'anteprima in stile browser accanto alla sezione favicon.
Titolo pagina e Descrizione applicano i limiti di caratteri attuali mostrati dai loro campi. Se un campo smette di accettare più testo, accorcialo piuttosto che incollare intorno al limite.
### Esempio: separa il nome del negozio dal titolo per la ricerca
Per un negozio di candele, il **Nome** in Runner potrebbe essere `Candle Studio`, mentre **Titolo della pagina** è `Candle Studio | Hand-poured candles`. Scrivi una breve **Descrizione** dei prodotti che vendi davvero. Dopo ogni messaggio **Salvato**, riapri Generali e controlla il valore. I motori di ricerca possono impiegare tempo ad aggiornarsi e scegliere un testo diverso nei risultati.
## Modifica la favicon
1. Seleziona il pulsante favicon attuale.
2. Scegli **Carica** o **Generato da IA**.
3. Per Carica, seleziona un file ICO, PNG o SVG sotto il limite di dimensione file visualizzato.
4. Per Generato da IA, inserisci un prompt facoltativo e seleziona **Esegui**.
5. Rivedi l'anteprima.
6. Seleziona **Salva** per applicarla. Chiudere il popover scarta un'anteprima non salvata.
## Stati e limiti
- I campi di salvataggio automatico mostrano il feedback di salvataggio, successo o errore.
- Il caricamento della favicon rifiuta i formati non supportati e i file di dimensioni eccessive.
- **Generazione in corso…** e **Caricamento in corso…** sono stati di progresso; attendi un'anteprima.
- Il controllo della filigrana può mostrare un badge del piano e bloccare la modifica.
- Elimina negozio rimane non disponibile finché il progetto e il suo nome non vengono caricati.
## Zona di pericolo
La selezione di **Elimina** apre una conferma che avverte che tutti i dati del negozio andranno persi. Il pulsante finale rimane disabilitato finché non digiti il nome esatto del negozio. Alcuni account espongono separatamente il recupero condizionale, ma non devi fare affidamento sul recupero quando decidi di eliminare.
## Risoluzione dei problemi
- Se il gruppo Negozio è assente, riaprire Impostazioni dall'interno del progetto.
- Se un titolo o una descrizione torna indietro, correggi il suo problema di convalida e attendi Salvato.
- Se il caricamento della favicon non riesce, controlla il tipo e la dimensione, quindi scegli di nuovo il file.
- Se la creazione della favicon generata non riesce, rivedi il prompt e riprova solo dopo il completamento del tentativo precedente.
- Se Rimuovi filigrana è bloccato, usa il badge del piano per rivedere la disponibilità.
## Guide correlate
- [Connetti un dominio personalizzato](../storefront-and-publishing/custom-domains)
- [Script personalizzati e agente del negozio](./custom-scripts-and-store-agent)
- [Elimina, recupera e esci](./delete-recover-and-leave)
---
# Spazio di lavoro Generale
Source: https://www.runnerai.com/docs/it/guides/account-and-settings/workspace-general
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Spazio di lavoro Generale controlla l'identità condivisa di uno spazio di lavoro Runner. Usalo quando il nome del team o la descrizione cambia, o quando hai bisogno di rivedere la zona di pericolo dello spazio di lavoro.
## Cosa copre questa guida
Sarai in grado di aggiornare i dettagli dello spazio di lavoro e riconoscere quando una modifica è stata salvata con successo.
## Disponibilità e prerequisiti
- Un amministratore dello spazio di lavoro o proprietario è necessario per modificare il Nome o la Descrizione condivisi.
- Solo il proprietario dello spazio di lavoro può completare l'eliminazione dello spazio di lavoro.
- Runner non consente l'eliminazione dell'ultimo spazio di lavoro rimanente.
## Percorso di accesso
Apri **Impostazioni**, controlla **Spazio di lavoro: _nome dello spazio_** nella barra laterale, poi seleziona **Generale** in quel gruppo.
## Controlli
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Nome** | Imposta il nome completo dello spazio di lavoro visibile agli altri membri. | Una modifica valida viene salvata automaticamente dopo la modifica. |
| **Descrizione** | Spiega a cosa serve lo spazio di lavoro o il team. | Una modifica valida viene salvata automaticamente. |
| **Elimina spazio di lavoro** | Rimuovi uno spazio di lavoro che non ti serve più. | Si apre un popover di conferma del nome. Il pulsante è disabilitato per l'ultimo spazio di lavoro. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTBoRI6D7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Lo spazio di lavoro di esempio non ha chiavi Analytics elencate. Modificare l'identità dello spazio e creare una credenziale Analytics sono azioni separate.
## Aggiorna i dettagli dell'area di lavoro
1. Apri **Impostazioni → Spazio di lavoro → Generale**.
2. Modifica **Nome** o **Descrizione**.
3. Lascia il campo e guarda lo stato.
4. Attendi **Salvato** prima di chiudere Impostazioni o cambiare spazio di lavoro.
5. Riaprire la pagina se hai bisogno di verificare il valore persistente.
**Verifica:** chiudi Impostazioni, riapri Generali per lo stesso spazio di lavoro e controlla il Nome o la Descrizione salvati. Un campo che mostra ancora **Salvataggio…** non supera questa verifica.
## Stati e limiti
- Il nome non può essere vuoto e deve rimanere entro i limiti di convalida visualizzati.
- La descrizione accetta un breve riepilogo dello spazio di lavoro e ha un limite di caratteri visualizzato.
- **Salvataggio in corso…** significa che la modifica è ancora in corso.
- **Salvato** conferma che il valore attuale è stato accettato.
- Un errore di salvataggio ripristina o mantiene il valore salvato precedente.
- **Elimina spazio di lavoro** è disabilitato quando questo è il tuo ultimo spazio di lavoro.
## Le chiavi API Analytics hanno un ambito separato
Generali dello spazio di lavoro può includere **Chiavi API Analytics** per strumenti di reportistica esterni con accesso in sola lettura alle analisi. Sono diverse dalle [Chiavi API personali](/it/guides/account-and-settings/api-keys), che agiscono come il tuo account connesso. Controlla l'ambito prima di creare o condividere credenziali. Un elenco Analytics vuoto indica che qui non sono elencate chiavi: non è l'elenco delle chiavi personali.
## Limite di eliminazione
La selezione di **Elimina spazio di lavoro** non elimina immediatamente. Runner chiede a un proprietario di digitare il nome esatto dello spazio di lavoro, quindi abilita il pulsante distruttivo **Elimina**. L'eliminazione non può essere ripristinata da questo schermo e rimuove i dati e le impostazioni dello spazio di lavoro.
## Risoluzione dei problemi
- Se un Nome vuoto torna al valore precedente, inserisci un nome valido non vuoto.
- Se **Salvato** non appare mai, mantieni la finestra di dialogo aperta, controlla l'errore e riprova.
- Se Elimina spazio di lavoro è disabilitato, probabilmente questo è l'ultimo spazio di lavoro o lo spazio di lavoro non ha caricato.
- Se hai aperto le impostazioni dello spazio di lavoro sbagliato, chiudi la finestra di dialogo e riaprila dallo spazio di lavoro desiderato.
## Guide correlate
- [Membri e inviti](../workspace/members-and-invitations)
- [Impostazioni personali e spazi di lavoro](./personal-settings-and-workspaces)
- [Elimina, recupera e esci](./delete-recover-and-leave)
---
# Funzioni avanzate
Source: https://www.runnerai.com/docs/it/guides/advanced
Runner include modi avanzati per ricercare clienti, pianificare il lavoro, costruire flussi di lavoro riutilizzabili e ricevere eventi. Queste pagine sono intenzionalmente separate dal percorso di negozio principale perché la disponibilità e i punti di accesso possono differire per area di lavoro.
> **Disponibilità:** **Cerca** può comparire sotto **Misura**, **Fly** nella navigazione principale e **Webhook** sotto **Crea**. **Workflow** resta disponibile solo in alcuni casi: usalo solo se Runner mostra una voce per lo spazio di lavoro o se l'assistenza la fornisce. Non inventare o modificare un URL per raggiungere una pagina nascosta. Se manca una voce prevista, consulta [Disponibilità delle funzioni](/it/guides/advanced/feature-availability).
| Funzione | Usala per | Guida |
| --- | --- | --- |
| Ricerca | Trasforma una domanda commerciale in uno studio strutturato e un rapporto. | [Ricerca](/it/guides/advanced/research) |
| Fly | Imposta una missione e segui uno spazio di lavoro di pianificazione aziendale guidato. | [Fly](/it/guides/advanced/fly) |
| Flusso di lavoro | Visualizza ed esegui flussi multi-step riutilizzabili quando Runner fornisce una voce. | [Flusso di lavoro](/it/guides/advanced/workflows) |
| Webhook | Configura i recapiti di eventi supportati quando Runner fornisce una voce. | [Webhook](/it/guides/advanced/webhooks) |
Per gli strumenti raggruppati sotto **Cresci** e **Misura**, consulta [Automatizza, testa e crea](/it/guides/automate-test-and-create).
---
# Disponibilità delle funzioni
Source: https://www.runnerai.com/docs/it/guides/advanced/feature-availability
Runner può mostrare diverse funzioni in base all'area di lavoro, al ruolo, al piano, al tipo di negozio, allo stato di pubblicazione, ai servizi connessi, ai dati e all'accesso al rilascio in fasi.
**Percorso di accesso:** Documentazione di Runner → **Funzioni avanzate** → **Disponibilità delle funzioni**.
## Limitazioni di disponibilità comuni
| Cosa vedi | Requisito probabile | Cosa fare |
| --- | --- | --- |
| La voce è mancante | La funzione è in fase, disabilitata o non disponibile per questa area di lavoro. | Controlla l'area di lavoro e chiedi a un proprietario o al supporto. Non utilizzare un URL indovinato. |
| Messaggio di aggiornamento | Il piano attuale non include l'azione o il suo limite è stato raggiunto. | Apri **Piano e fatturazione** e rivedi l'offerta attuale visualizzata. |
| Requisito di pubblicazione | Lo strumento necessita di un negozio live o di dati del sito pubblicati. | Completa la lista di controllo della pubblicazione, quindi ritorna dopo una pubblicazione riuscita. |
| Pulsante Connetti | Un provider o un account deve essere connesso prima. | Apri l'app denominata e completa il suo flusso di connessione ufficiale. |
| Dashboard vuota | La funzione è disponibile ma non ha dati per il negozio, il filtro o il periodo selezionato. | Conferma il negozio, l'intervallo di date, la pubblicazione e la raccolta di eventi. |
| Messaggio di autorizzazione | Il tuo ruolo nell'area di lavoro non può eseguire l'azione. | Chiedi a un proprietario di completarla o modifica l'accesso. |
| Pagina non trovata | La route non è disponibile, è stata ritirata o non è valida per questo contesto. | Ritorna attraverso la navigazione visibile e contatta il supporto se la voce stessa è interrotta. |
## Controlla in ordine
1. Conferma il workspace e il negozio selezionati.
2. Espandi **Crea**, **Cresci** e **Misura** nella navigazione del progetto prima di concludere che una voce manchi. Su mobile, apri prima il menu del progetto.
3. Controlla se la pagina nomina un prerequisito.
4. Controlla il tuo ruolo e il piano attuale dalle impostazioni dell'area di lavoro.
5. Conferma la pubblicazione, i dati o la connessione dell'app richiesti.
6. Ricarica una volta dopo una modifica recente dell'accesso o della connessione.
7. Contatta il supporto con la pagina esatta, lo stato visibile, l'area di lavoro e il nome del negozio.
### Cosa non assumere
- Una voce nascosta non prova che la funzione sia stata rimossa da ogni account.
- Una pagina vuota non prova che la raccolta sia interrotta.
- Una route di origine non prova che la tua area di lavoro possa utilizzare la funzione.
- Una connessione riuscita non prova il checkout, l'evasione o la segnalazione downstream senza un risultato end-to-end.
## Quando la pagina mostra solo un'anteprima
L'anteprima di una funzione può mostrare schede di esempio mentre un avviso di upgrade impedisce le azioni reali. Leggi l'avviso prima di interpretarle come dati del negozio. Per il dizionario completo degli stati, consulta [Stati e disponibilità](../help-and-reference/states-and-availability).
## Guide correlate
- [Stati e disponibilità](../help-and-reference/states-and-availability)
- [Piani di abbonamento](../plans-and-billing/subscription-plans)
- [Risolvi i problemi di pubblicazione, checkout e app](../help-and-reference/troubleshoot-publishing-checkout-apps)
- [Supporto e comunità](../help-and-reference/support-and-community)
---
# Fly
Source: https://www.runnerai.com/docs/it/guides/advanced/fly
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Fly è uno spazio di lavoro guidato per trasformare un obiettivo del negozio in una missione, esaminare il lavoro proposto e seguire i progressi da un unico dashboard.
## Percorso di accesso
Apri un progetto di negozio e seleziona **Fly** quando è disponibile. Se la voce manca, consulta [Disponibilità delle funzioni](./feature-availability).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOvxtCXuJCcW62zHrU8smjSnqvixd1twlAf4u)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Esamina la prima missione e le fasi di avvio prima di scegliere Avvia questa missione. Questa vista mostra la preparazione, non una missione attiva.
## Prima di iniziare
- Fly deve essere abilitato per il progetto corrente.
- Esamina il negozio, la missione e i compiti della proposta interessati prima di approvare il lavoro.
- Le azioni di proposta, interruzione e missione successiva possono modificare il lavoro del progetto reale; utilizza il testo di conferma come autorità finale.
## Avvia la prima missione
I progetti senza una missione aprono l'onboarding automaticamente.
1. Apri **Fly** e leggi l'obiettivo proposto per il negozio.
2. Se la dashboard mostra già una missione, esaminala invece di avviarne un'altra.
3. Esamina la missione suggerita e le sue fasi. L'introduzione **Ottieni il tuo primo ordine pagato** presenta cinque fasi e l'azione **Avvia questa missione**. Selezionala solo per avviare davvero la missione; altrimenti chiudi l'introduzione.
4. Controlla che la dashboard mostri la missione desiderata prima di esaminare le proposte.
**Verifica:** aprire l'introduzione mostra soltanto la proposta di una missione. La missione esiste dopo la conferma e quando la dashboard la mostra.
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Avvia la tua prima missione** | Riapre l'onboarding quando il progetto non ha ancora una missione. |
| **Avvia questa missione** | Avvia la missione descritta nell'introduzione. Controlla obiettivo e fasi prima di confermare. |
| **Imposta questa missione**, se compare nella configurazione | Crea la missione proposta per il progetto attuale e apre la dashboard Fly. Controlla negozio e obiettivo prima di confermare. |
Chiudere l'introduzione senza confermare lascia il progetto senza una nuova missione. Puoi tornare con **Avvia la tua prima missione**.
Dopo l'onboarding, **Ottieni la tua prima proposta** può aprire una lista di controllo di lancio di sola lettura. Quando **Visualizza dettagli** appare su **Crea vetrina**, apre la prima conversazione Runner del progetto. Il pulsante è assente quando non è registrata alcuna prima conversazione.
## Leggi la dashboard
Il dashboard riunisce la missione corrente e l'attività del negozio. Su schermi più piccoli, le stesse sezioni sono impilate verticalmente.
| Sezione | Cosa mostra |
| --- | --- |
| Progresso della missione | L'obiettivo attivo e i progressi verso di esso. |
| Ordini, Ricavi e Sessioni | I segnali principali del negozio di oggi. Questi sono riepiloghi di sola lettura. |
| **Feed** | Segnali recenti e osservazioni attuali di Fly. Seleziona una storia per aprire il suo visualizzatore. |
| **Lavoro in corso** | Proposte approvate che sono in esecuzione o in attesa della tua azione. Seleziona una scheda per aprire i dettagli della proposta. |
| **Lavoro passato** | Proposte completate o non riuscite. Seleziona una scheda per esaminarla; **Mostra di più** carica voci più vecchie. |
| **I tuoi compiti** | Compiti che richiedono la tua attenzione. **Precedente** e **Successivo** si spostano attraverso più di una pagina di elementi. |
| Anteprima del negozio | Mostra lo stato di pubblicazione corrente quando disponibile. Selezionalo per aprire **Negozio**. |
| **Apri chat** | Apre la chat di Fly in modo da poter fare domande sulla missione o sul lavoro visibile. **Chiudi chat** la chiude. |
| **Tutto risolto** | Appare quando nessun compito o proposta richiede una decisione. Conferma che Fly sta ancora monitorando il negozio; non significa che ogni compito in esecuzione sia terminato. |
| **Esplora Runner** | Quando la coda è vuota, offre **Apri Studio Creativo** quando abilitato, **Sfoglia Competenze** e **Esplora Automazioni**. Ogni pulsante apre quello strumento del progetto senza avviare il lavoro da solo. |
Una sezione **Lavoro in corso** o **Lavoro passato** vuota potrebbe essere nascosta. Ciò significa che non c'è nulla in quello stato, non che la cronologia del progetto sia stata cancellata.
Nella chat di Fly, **Nuova conversazione** avvia un nuovo thread, mentre la cronologia riapre uno precedente. Il primo messaggio crea la conversazione. Se l'invio non riesce, la bozza rimane nel compositore in modo da poter riprovare senza riscriverla.
### Leggi una storia di Fly
Il visualizzatore di storie mostra **elemento corrente di totale** nell'intestazione. Utilizza le frecce precedente e successiva per spostarti tra gli elementi, o chiudi il visualizzatore per tornare al dashboard. Quando una storia include una scheda di origine collegata, selezionandola apre quella fonte esatta in una nuova scheda del browser. Se la storia non può essere caricata, seleziona **Riprova** senza uscire da Fly. Le schede di notizie di mercato possono scomparire dopo che non sono più recenti.
## Esamina una proposta
Apri una proposta dal dashboard prima di consentire l'inizio del lavoro. Una proposta può contenere diversi compiti; selezionare un compito può includere anche i prerequisiti da cui dipende.
| Controllo o stato | Cosa accade dopo |
| --- | --- |
| Selezione del compito | Sceglie quali compiti approvare. I compiti prerequisiti richiesti sono inclusi in modo che il lavoro selezionato possa essere eseguito in ordine. |
| **Approva ed Esegui** | Approva i compiti selezionati e avvia l'esecuzione. Non è disponibile quando nessun compito è selezionato. Le azioni collegate possono avere effetti reali. |
| **Rifiuta** | Apre una conferma. La conferma chiude la proposta e non esegue nessuno dei suoi compiti; questo non può essere annullato. |
| **Interrompi** | Apre **Interrompere questa proposta?** mentre il lavoro è in esecuzione. **Conferma interruzione** arresta i compiti non terminati; il lavoro completato viene mantenuto. **Continua l'esecuzione** chiude la conferma. |
| **Anteprima** | Apre il risultato del flusso di lavoro completato quando un'anteprima è disponibile. |
| **Visualizza dettagli** | Su un compito della prima proposta supportato, apre la conversazione Runner correlata in modo da poter esaminare il contesto del lavoro. |
| In attesa della tua azione | L'esecuzione è in pausa fino a quando non completi l'azione manuale richiesta e seleziona **Risolvi**. |
| **Utile** / **Non utile** | **Utile** viene salvato immediatamente. **Non utile** apre motivi e dettagli modificabili; chiudendoli il feedback esistente rimane invariato e le modifiche vengono salvate solo dopo **Invia**. |
Alcune pagine di proposta in fase di revisione mostrano anche un pannello di chat della proposta. Usalo per fare domande su quella proposta; non sostituisce **Approva ed Esegui**, **Rifiuta**, **Interrompi** o **Risolvi** quando l'azione applicabile è mostrata.
La sezione **Risultati** rimane nascosta mentre una proposta è in revisione, in esecuzione o in verifica. Può apparire dopo il completamento o il fallimento solo quando i dati dei risultati sono pronti. Una sezione Risultati mancante durante il lavoro attivo non è prova che la proposta sia fallita.
Per i risultati di documenti e media, **Scarica** salva il risultato disponibile, **Ripristina media** tenta di recuperare i media non disponibili e **Continua nella chat** apre istruzioni di follow-up modificabili. Queste azioni non cambiano lo stato di accettazione o revisione della proposta.
Quando una proposta include la generazione di video di Fly, il compito corrente produce un video 720p di 6 secondi con audio. Chiedere una durata diversa nel prompt del compito non cambia la lunghezza dell'output.
## Risolvi un compito di proprietà dell'utente
Quando un compito contrassegnato **Il tuo compito** si interrompe per un'azione che solo tu puoi completare, leggi le istruzioni, completa l'azione al di fuori della scheda, quindi seleziona **Risolvi**.
**Risolvi** è la tua conferma che hai completato l'azione richiesta; Runner non verifica indipendentemente quel risultato esterno. Mentre Runner controlla lo stato, la scheda mostra **Caricamento azione compito**. Mentre invia, il pulsante mostra **Risoluzione in corso…**. **Questo compito non è più in attesa della tua azione.** significa che non può essere risolto dalla scheda corrente. Se vedi **Impossibile risolvere questo compito. Riprova.**, controlla la connessione e riprova. Non contrassegnare un compito come risolto prima che l'azione richiesta sia effettivamente completata.
## Risolvi i compiti
Seleziona **Risolvi** solo su un compito con un clic idoneo. Runner registra quindi la tua conferma dal dashboard. I compiti più dettagliati, inclusi i compiti con output di file, rimangono di sola lettura nell'elenco dei compiti; apri la proposta correlata per esaminare le istruzioni e lo stato attuale.
Se la risoluzione non riesce, mantieni il compito aperto e riprova dopo aver controllato la connessione. Non dare per scontato che il compito sia completato fino a quando il suo stato non cambia.
## Segui il lavoro in corso e passato
1. Apri una scheda in **Lavoro in corso** per vedere i suoi stati di proposta e compito attuali.
2. Se dice **In attesa della tua azione**, completa l'azione manuale richiesta e seleziona **Risolvi** invece di approvare di nuovo la proposta.
3. Usa Interrompi solo quando il lavoro non terminato deve fermarsi. Il lavoro già completato non viene ripristinato.
4. Apri **Lavoro passato** per esaminare i risultati e le proposte non riuscite.
5. Per un fallimento, mantieni il titolo della proposta e l'errore del compito visibile prima di chiedere aiuto.
## Completa una missione e scegli la successiva
Quando Runner riconosce che una missione è raggiunta, **Missione completata** apre un flusso guidato. Se lo chiudi prima di scegliere un altro obiettivo, **Scegli la tua prossima missione** può riaprire il flusso.
1. Seleziona **Esamina il viaggio** per vedere il riepilogo della missione, i momenti importanti e il lavoro che Fly ha completato insieme a te.
2. Seleziona **Vedi cosa c'è dopo** per esaminare la missione successiva suggerita.
3. Regola l'obiettivo con il preset disponibile o i controlli di aumento/diminuzione, quindi seleziona **Continua**.
4. Leggi attentamente il riepilogo del rollout.
5. Seleziona **Inizia Missione** solo quando il nuovo obiettivo è corretto.
6. Quando la prossima missione è attiva, seleziona **Vai al Controllo Missione** per tornare al dashboard.
**Inizia Missione** ha effetti reali sul progetto: i compiti già in esecuzione continuano, la generazione di proposte riprende rispetto al nuovo obiettivo e le proposte su cui non hai agito vengono chiuse in modo che Fly possa rigenerarle per il nuovo obiettivo. I progressi attuali vengono mantenuti.
## Risoluzione dei problemi
| Stato | Passaggio successivo |
| --- | --- |
| L'onboarding si apre automaticamente | Imposta la missione o chiudi l'onboarding e torna più tardi. |
| Appare il dashboard | Esiste una missione; utilizza il dashboard piuttosto che crearne un duplicato. |
| **In attesa della tua azione** | Apri la proposta, completa l'azione manuale specifica, quindi seleziona **Risolvi**. |
| Conflitto di interruzione o stato modificato altrove | Aggiorna la proposta e utilizza il suo stato attuale. |
| L'anteprima completata non riesce a caricarsi | Seleziona **Riprova** nell'Anteprima del Flusso di Lavoro, o riapri la proposta completata per il risultato più recente. |
| Proposta non riuscita | Aprila da **Lavoro passato** e mantieni l'errore del compito visibile. |
| La verifica finale non può recuperare | La proposta si risolve come non riuscita invece di rimanere nel lavoro in corso. Aprila da **Lavoro passato** e mantieni l'errore visibile prima di riprovare. |
| La prossima missione non può iniziare | Riprova. Se un'altra sessione l'ha già avviata, il dashboard si aggiorna alla missione attiva. |
| Voce mancante o pagina non trovata | Fly non è disponibile in questo contesto. Consulta [Disponibilità delle funzioni](./feature-availability). |
## Guide correlate
- [Disponibilità delle funzioni](./feature-availability)
- [Stati e dettagli dei compiti](../work-with-runner/task-states-and-details)
- [Risolvi i problemi dei compiti di Runner](../help-and-reference/troubleshoot-runner-tasks)
---
# Ricerca
Source: https://www.runnerai.com/docs/it/guides/advanced/research
La ricerca fornisce un luogo con ambito di progetto per indagare le esigenze degli acquirenti, i concetti, il posizionamento e altre decisioni commerciali.
## Percorso di accesso
Apri un progetto di negozio, espandi **Misura** e seleziona **Cerca** quando la funzione è disponibile. Su mobile, apri prima il menu del progetto. Se **Cerca** non compare, quello spazio non espone la funzione; consulta [Disponibilità delle funzioni](./feature-availability).
## Prima di iniziare
- La ricerca deve essere abilitata per il progetto attuale.
- Prepara una domanda commerciale con almeno cinque caratteri e rimuovi i dati dei clienti non necessari.
- Lo scouting live, i pannelli e i rapporti possono utilizzare dati esterni o crediti; rivedi ogni azione disponibile prima di avviarla.
## Avvia o riapri uno studio
La home della ricerca ha due modalità: **Nuovo studio** e **Pannelli salvati**.
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Nuovo studio** | Apre il modulo della domanda e gli studi recenti del progetto. |
| Campo della domanda | Accetta la decisione aziendale da approfondire. **Avvia studio** resta indisponibile finché la domanda non è valida. |
| Scheda scenario | Inserisce una direzione di ricerca suggerita nel campo della domanda in modo da poterla modificare. |
| **Avvia studio** | Crea uno studio reale dalla domanda attuale e apre il suo spazio guidato. |
| **Guarda prima un esempio completato** | Apre un esempio in sola lettura. Non crea uno studio reale e le azioni che lo richiedono possono non essere disponibili. |
| Scheda studio recente | Riapre lo studio esistente di quel progetto. |
| **Pannelli salvati** | Apre i pannelli salvati per il riutilizzo. |
| **Avvia studio** | Seleziona quel panel salvato e torna a **Nuovo studio**. Inserisci una nuova domanda di ricerca, poi seleziona **Inizia studio** per creare lo studio. |
| **Carica di più** | Carica studi o pannelli salvati aggiuntivi. |
| **Riprova** | Richiede la libreria attuale o la fase non riuscita di nuovo. |
Utilizza una decisione focalizzata come domanda. Una domanda come "Quale affermazione di prodotto dovremmo evidenziare per i nuovi acquirenti?" dà allo studio un lavoro più chiaro rispetto a un argomento ampio come "marketing".
## Muoviti attraverso le fasi guidate
Il lato sinistro di uno studio pone domande e offre scelte. Seleziona le scelte rilevanti, aggiungi una risposta personalizzata quando necessario, quindi utilizza l'azione principale per la fase attuale.
| Azione | Cosa avvia Runner |
| --- | --- |
| **Costruisci piano di ricerca** | Trasforma la tua domanda e le risposte in un piano di studio. |
| **Modifica input** | Riapre gli input di pianificazione prima che inizi lo scouting. |
| **Ricostruisci piano di ricerca** | Sostituisce il piano attuale con un nuovo piano basato sugli input modificati. |
| **Avvia scouting [fonte]** (ad esempio, **Avvia scouting X**) | Avvia lo scouting sulla fonte denominata dal piano approvato. |
| **Costruisci il pannello di convalida** | Costruisce il pannello del pubblico utilizzato per sfidare e convalidare i risultati. |
| **Avvia discussione del pannello** | Inizia la conversazione del pannello. |
| **Genera riepilogo, verbali e rapporto** | Produce gli artefatti scritti finali dalla discussione completata. |
| **Riprova** seguito da un nome di fase | Ripete la fase non riuscita. Rivedi il fallimento prima in modo da non ripetere ciecamente lo stesso input. |
L'azione principale esatta cambia man mano che ogni fase diventa pronta. Non selezionare un'azione di fase successiva fino a quando non sei soddisfatto del piano, dei risultati o del pannello attuale.
## Rivedi gli artefatti dello studio
Su desktop, la chat guidata e la tela degli artefatti si trovano fianco a fianco e possono essere ridimensionate. Su dispositivi mobili, utilizza **Chat di studio** e **Artefatti** per passare tra loro.
| Scheda artefatto | Cosa contiene |
| --- | --- |
| **Panoramica** | La cronologia dello studio e quali fasi sono pronte o in sospeso. Selezionando un elemento pronto si apre il suo artefatto. |
| **Piano** | L'approccio di ricerca approvato. Rimane vuoto fino al completamento della pianificazione. |
| **[Fonte] Scout** (ad esempio, **X Scout**) | Il progresso dello scouting e le fonti per la fonte attuale dello studio. |
| **Risultati** | Temi e prove prodotti dopo lo scouting. |
| **Pannello** | Il pubblico di convalida costruito dai risultati. |
| **Discussione** | La conversazione del pannello e le risposte di follow-up. |
| **Rapporto** | Lo spazio di lavoro del rapporto finale dopo il completamento della discussione. |
Una scheda in sospeso non è un errore: il suo stato vuoto spiega quale fase precedente deve terminare per prima. La cronologia della panoramica contrassegna anche le fasi non disponibili come in sospeso.
## Salva un pannello utile
Apri **Pannello** e seleziona **Salva pannello** quando il suo pubblico è utile per studi futuri. Inserisci il nome del pannello e la descrizione facoltativa nel modulo di salvataggio, quindi conferma. Runner segnala **Pannello salvato per studi futuri** e il pannello appare sotto **Pannelli salvati**.
Il salvataggio preserva il pannello per il riutilizzo; non avvia un altro studio. In un'anteprima di esempio, il salvataggio non è disponibile perché l'esempio non è dati di progetto live.
## Leggi e condividi il rapporto
Lo spazio di lavoro del rapporto finale separa tre visualizzazioni:
- **Rapporto** presenta il risultato della ricerca completa.
- **Riepilogo** fornisce la versione più breve focalizzata sulla decisione.
- **Verbali** registra la discussione del pannello.
Seleziona **Condividi** per condividere il collegamento dello studio attuale con il pannello di condivisione del dispositivo quando supportato. Se la condivisione nativa non è disponibile, Runner copia il collegamento e mostra **Collegamento dello studio copiato**. La condivisione invia un collegamento, non un rapporto statico scaricato; il destinatario ha ancora bisogno dell'accesso appropriato.
## Continua la discussione del pannello
Durante la fase di discussione, utilizza il compositore di follow-up per chiedere una risposta più chiara o testare un angolo diverso.
| Controllo | Risultato |
| --- | --- |
| **Sfida un risultato** | Riempie il compositore con un prompt di sfida che puoi modificare. |
| **Chiedi al pannello** | Riempie il compositore con una domanda diretta al pannello. |
| **Cambia il pubblico** | Riempie il compositore con una richiesta di considerare un pubblico diverso. |
| **Invia follow-up** | Invia il messaggio attuale nella discussione del pannello live. |
I chip di suggerimento preparano il testo; non inviano nulla fino a quando non selezioni **Invia follow-up**. Se il compositore supera il limite o lo studio non è pronto, l'azione di invio rimane non disponibile.
## Risoluzione dei problemi
| Stato | Significato e passo successivo |
| --- | --- |
| Esempio | Una dimostrazione completata, non ricerca di progetto live. Ritorna a **Nuovo studio** per crearne una tua. |
| Artefatto in sospeso | Una fase precedente non è terminata. Ritorna a Panoramica o Chat di studio e continua la fase disponibile. |
| La fase è in esecuzione | Runner sta preparando l'artefatto successivo. Puoi tornare attraverso studi recenti in seguito. |
| Fallimento riprovabile | Leggi l'errore visibile, quindi utilizza **Riprova** specifico della fase una volta. |
| Il recupero è bloccato | Seleziona **Aggiorna studio** per caricare lo stato del server attuale prima di continuare. |
| Il follow-up non riesce | Mantieni il messaggio, utilizza Riprova quando offerto, o aggiorna lo studio prima di inviare di nuovo. |
| Lo studio o la libreria del pannello non riesce | Seleziona **Riprova**. Preserva la domanda e l'errore visibile se si ripete. |
| Cronologia dello studio vuota | Questo progetto non ha ancora uno studio. Inizia con una domanda focalizzata. |
## Percorso consigliato
1. Apri **Nuovo studio** e inserisci una domanda focalizzata sulla decisione.
2. Seleziona **Avvia studio** e rispondi alle scelte guidate.
3. Rivedi il Piano; utilizza **Modifica input** prima dello scouting se l'ambito è sbagliato.
4. Muoviti attraverso Scout, Risultati, Pannello e Discussione, rivedendo ogni artefatto pronto.
5. Salva il pannello solo quando il suo pubblico sarà utile di nuovo.
6. Genera e leggi il Rapporto, il Riepilogo e i Verbali.
7. Condividi il collegamento dello studio solo con persone che dovrebbero avere accesso.
8. Utilizza i follow-up per lacune specifiche invece di avviare uno studio duplicato.
## Prova l'esempio prima di uno studio reale
1. Apri **Misura** → **Cerca** → **Nuovo studio**.
2. Seleziona **Guarda prima un esempio completato**.
3. Leggi il piano e il report di esempio usando le schede dei materiali disponibili.
4. Torna a **Nuovo studio** e scrivi una decisione da approfondire.
5. Seleziona **Avvia studio** solo quando sei pronto a creare uno studio reale.
**Verifica:** l'esempio permette di vedere il formato del risultato senza creare uno studio. Per il tuo studio, controlla che la domanda compaia nel relativo spazio; le successive ricerche e i report hanno progressi ed esiti propri.
## Guide correlate
- [Disponibilità delle funzioni](./feature-availability)
- [Esperimenti](../automate-test-and-create/experiments)
- [Panoramica di Analytics](../analytics-and-seo/analytics-overview)
- [Supporto e comunità](../help-and-reference/support-and-community)
---
# Webhook
Source: https://www.runnerai.com/docs/it/guides/advanced/webhooks
I webhook consentono a un altro servizio di ricevere eventi selezionati da un progetto di Runner. Questa è una funzione avanzata e sensibile alla sicurezza: usala solo quando sai quale servizio dovrebbe ricevere gli eventi e come quel servizio li verifica.
## Percorso di accesso
Apri **Crea** → **Webhook** quando Runner rende la voce disponibile nello spazio di lavoro. Se non compare, non inventare un URL: consulta [Disponibilità delle funzioni](./feature-availability) o chiedi all'assistenza se la funzione è abilitata.
## Prima di iniziare
- Utilizza Webhook solo quando Runner o il supporto espone una voce approvata.
- Conosci il servizio ricevente previsto e come verifica gli eventi.
- Tratta gli indirizzi degli endpoint, i segreti di firma e i dati consegnati come sensibili.
## Cosa mostra Runner
Lo spazio di lavoro può mostrare gli strumenti webhook di Runner oppure un portale del fornitore incorporato. Segui la sezione corrispondente alla tua schermata.
### Esamina gli strumenti di Runner
**Disponibilità condizionata:** quando gli strumenti integrati sono abilitati, usa queste schede:
| Scheda | Cosa controllare |
| --- | --- |
| **Endpoint** | Destinazioni di ricezione configurate e relativo stato. |
| **Catalogo** | Tipi di evento disponibili, prima di scegliere cosa riceverà una destinazione. |
| **Registri** | Consegne registrate e stato restituito. |
| **Attività** | Attività webhook recente. |
1. Apri **Endpoint** e individua la destinazione da esaminare.
2. Leggi **Catalogo** per controllare il tipo di evento pertinente.
3. Apri **Registri** ed esamina una consegna disponibile per quella destinazione.
4. Confronta lo stato con la registrazione del servizio ricevente prima di considerare la consegna riuscita.
**Verifica:** un endpoint salvato conferma la configurazione; una consegna riuscita e la registrazione corrispondente del destinatario confermano quell'evento specifico. Un log vuoto non dimostra che la consegna funzioni. Test, reinvio e replay inviano eventi: usali solo per un test voluto.
### Portale del fornitore incorporato
Runner prepara il servizio webhook prima di visualizzare il portale di gestione incorporato.
| Stato della pagina o controllo | Cosa significa o fa |
| --- | --- |
| **Caricamento in corso…** | Runner sta controllando se il servizio webhook è pronto. |
| **La piattaforma webhook si sta inizializzando** | La configurazione è ancora in corso. Aspetta e mantieni la pagina aperta, o ritorna più tardi. |
| **L'inizializzazione sta richiedendo più tempo del previsto** | La configurazione non è stata completata dopo l'attesa normale. **Riprova** chiede a Runner di eseguire di nuovo il provisioning del servizio. |
| **Riprovando in corso…** | Il tentativo è in corso; il pulsante rimane non disponibile fino al completamento della richiesta. |
| Messaggio di errore | Runner non ha potuto preparare il servizio. Mantieni il messaggio visibile per il supporto. |
| Portale webhook incorporato | Il servizio è pronto. Le etichette e i controlli esatti all'interno di questo portale gestito dal provider possono cambiare, quindi segui le istruzioni mostrate lì piuttosto che fare affidamento su nomi di pulsanti fissi in questa guida. |
| **Riconnetti Shopify** | Apre la pagina di integrazione di Shopify quando una connessione Shopify più vecchia necessita di nuove autorizzazioni webhook. Riconnetti prima di aspettarti che gli eventi di Shopify arrivino. |
## Recupera da un'inizializzazione lunga
1. Aspetta che il messaggio di inizializzazione finisca.
2. Se **L'inizializzazione sta richiedendo più tempo del previsto** appare, seleziona **Riprova** una volta.
3. Aspetta che il portale incorporato sostituisca la schermata di inizializzazione.
4. Se un errore appare di nuovo, salva il nome del progetto e il messaggio esatto, quindi contatta il supporto invece di riprovare ripetutamente.
## Riconnetti Shopify quando richiesto
1. Leggi l'avviso **Riconnetti il tuo negozio Shopify**.
2. Seleziona **Riconnetti Shopify**.
3. Completa il flusso di connessione sulla pagina di integrazione di Shopify.
4. Ritorna a Webhook e conferma che l'avviso di riconnessione è scomparso prima di fare affidamento sulla consegna degli eventi.
La riconnessione modifica l'autorizzazione di integrazione del negozio. Solo una persona autorizzata a gestire quella connessione del negozio dovrebbe continuare.
## Note sulla sicurezza
- Tratta gli indirizzi degli endpoint, i segreti di firma e i contenuti degli eventi come sensibili.
- Aggiungi o modifica una destinazione solo quando il suo proprietario ha fornito l'indirizzo sicuro corretto.
- Rivedi ogni conferma mostrata all'interno del portale incorporato; le sue azioni possono influire sulle consegne future.
- Se un valore di firma è esposto, sostituiscilo sia nel servizio webhook di Runner che nel sistema ricevente prima di inviare altri eventi.
## Risoluzione dei problemi
| Problema | Passo successivo |
| --- | --- |
| Nessuna voce Webhook | La funzione non è esposta in questa area di lavoro. Controlla [Disponibilità delle funzioni](./feature-availability). |
| L'inizializzazione non finisce | Utilizza **Riprova** una volta, quindi segnala lo stato esatto se si ripete. |
| Appare un messaggio di errore | Mantieni il messaggio completo e il nome del progetto per il supporto. |
| L'avviso di riconnessione di Shopify rimane | Completa la riconnessione dalla pagina di integrazione, quindi ricarica Webhook una volta. |
| Il portale incorporato è vuoto o si comporta diversamente | Ricarica una volta. Se persiste, cattura cosa è visibile; l'interfaccia del provider incorporato potrebbe differire per account o rilascio. |
## Guide correlate
- [Disponibilità delle funzioni](./feature-availability)
- [Sicurezza e sessioni](../account-and-settings/security-and-sessions)
- [Risoluzione dei problemi delle app](../apps-and-integrations/troubleshooting)
- [Supporto e comunità](../help-and-reference/support-and-community)
---
# Flusso di lavoro
Source: https://www.runnerai.com/docs/it/guides/advanced/workflows
Il flusso di lavoro trasforma un processo ripetibile in passaggi connessi che Runner può eseguire con gli stessi input e regole ancora.
> **Condizionale:** L'interfaccia del flusso di lavoro esiste, ma la navigazione standard del progetto attuale non espone una voce di flusso di lavoro. Usala solo quando Runner visualizza una voce di flusso di lavoro approvata per il tuo workspace o il supporto di Runner fornisce un percorso approvato. Non indovinare o modificare un URL per raggiungerla. Se il tuo piano consente solo un'anteprima, Runner può mostrare la pagina mantenendo i suoi controlli bloccati.
## Percorso di accesso
Apri la voce **Flusso** solo quando Runner la presenta nel tuo workspace. La pagina elenca i flussi di lavoro per il progetto attuale. Se non è presente alcuna voce, utilizza [Disponibilità delle funzioni](./feature-availability) o contatta il supporto invece di provare un URL diretto.
## Prima di iniziare
- L'accesso al flusso di lavoro dipende dal rollout delle funzioni attuale e dal piano.
- Conferma il progetto e i servizi connessi prima di testare o distribuire un flusso di lavoro.
- Un'anteprima o una bozza salvata non è attiva; la distribuzione e l'attivazione sono azioni separate e consequenziali.
## Elenco dei flussi di lavoro
Quando non ci sono flussi di lavoro, seleziona **Crea workflow**. Quando l'elenco contiene già elementi, utilizza **Nuovo workflow**.
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Crea workflow** o **Nuovo workflow** | Apre **Crea un workflow**. |
| **Workflow vuoto** | Crea un **Workflow senza titolo** e apre il suo builder. |
| Scheda modello | Crea un flusso di lavoro da quel modello e apre il suo builder. Se i modelli non si caricano, **Riprova** li richiede di nuovo. |
| Nome del flusso di lavoro | Apre quel flusso di lavoro nel builder. |
| **Rinomina** | Rende il nome modificabile. Premere Invio o fare clic altrove lo salva; Esc annulla la modifica. |
| **Fissa in alto** / **Rimuovi fissaggio** | Sposta il flusso di lavoro dentro o fuori dal gruppo bloccato. Non esegue il flusso di lavoro. |
| **Duplica** | Crea una copia e apre la copia nel builder. |
| **Esporta** | Scarica il flusso di lavoro come file JSON. Non distribuisce o esegue nulla. |
| **Elimina** | Apre una conferma. La conferma rimuove permanentemente quel flusso di lavoro e non può essere annullata. |
Utilizza il menu Altro di ogni riga per trovare **Rinomina**, **Fissa in alto** o **Rimuovi fissaggio**, **Duplica**, **Esporta** e **Elimina**.
Le etichette delle righe possono anche mostrare se una versione è nello stato **In produzione**, ha una **Bozza più recente**, espone un endpoint, o è associata a una pianificazione o un evento. Un'etichetta in pausa o bloccata dal piano significa che l'attivazione automatica non è attualmente attiva.
### Lavora con più flussi di lavoro
Seleziona la casella di controllo accanto a una o più righe. La barra di selezione mostra quanti sono selezionati e offre:
- **Esporta** per scaricare i flussi di lavoro selezionati.
- **Elimina** per aprire una conferma in blocco. La conferma rimuove permanentemente ogni flusso di lavoro selezionato.
- **Cancella** per rimuovere la selezione senza modificare alcun flusso di lavoro.
**Seleziona tutto** seleziona i flussi di lavoro mostrati nell'elenco attuale. Ricontrolla sempre il conteggio prima dell'eliminazione in blocco.
## Costruisci e salva
L'area di disegno del builder è dove aggiungi passaggi, li connetti e configuri cosa riceve e fa ogni passaggio. **Aggiungi componente** apre la libreria di componenti ricercabile. I controlli dell'area di disegno ingrandiscono, rimpiccioliscono, adattano il flusso di lavoro allo schermo e dispongono automaticamente i passaggi connessi.
Le modifiche vengono salvate automaticamente; non c'è un pulsante Salva separato. La freccia Indietro completa un salvataggio in sospeso prima di tornare all'elenco dei flussi di lavoro.
| Stato di salvataggio | Cosa fare |
| --- | --- |
| **Salvataggio in corso...** | Attendi prima di chiudere la pagina o distribuire. |
| **Salvato** | L'ultima modifica dell'area di disegno è archiviata. |
| **Salvataggio non riuscito** | Seleziona **Riprova** dopo aver controllato la connessione. |
| **Conflitto — le modifiche non sono state salvate** | Una versione salvata è più recente. **Ricarica** scarta le modifiche locali in conflitto e carica la versione salvata. |
Il pannello inferiore contiene **Area di prova** ed **Esecuzioni**. Nell'Area di prova, completa gli input di testo, prodotto o media richiesti prima di eseguire. Il controllo di esecuzione rimane non disponibile mentre gli input richiesti mancano. I risultati vengono visualizzati nell'area di output.
Il menu Altro del builder fornisce anche **Esporta JSON** e **Importa JSON…**. L'esportazione scarica l'area di disegno attuale. L'importazione sostituisce immediatamente l'area di disegno attuale e attiva il salvataggio automatico senza una conferma, quindi esporta un backup e controlla il file selezionato prima di importare.
## Scegli il test giusto
Il test può avere conseguenze molto diverse.
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Simula** | Apre una [finestra di dialogo di simulazione](/it/guides/automate-test-and-create/simulations). Utilizza dati di esempio generati o incolla JSON, quindi seleziona **Esegui simulazione**. Le azioni sul lato della scrittura come email, post Slack e modifiche dello store sono simulate. |
| **Test in tempo reale** | Apre una finestra di dialogo di test live. Utilizza dati generati, JSON incollato o un evento recente quando disponibile. **Esegui test in tempo reale** effettua chiamate API reali e può inviare messaggi o modificare i servizi connessi. L'esecuzione è contrassegnata come test nella cronologia. |
| **Salta le attese** | Durante un test live, salta i periodi di attesa configurati in modo che il test possa continuare prima. Non rimuove altri effetti reali. |
| **Esegui workflow** | Avvia il flusso di lavoro configurato immediatamente e apre Esecuzioni. I suoi passaggi possono avere effetti reali; rivedi ogni passaggio e input prima. |
| **Interrompi** | Richiede che l'esecuzione attuale si fermi. Il lavoro già completato non viene invertito. |
| **Cache** | In una riesecuzione, salta i nodi idonei i cui input non sono cambiati in modo da poter concentrarti sul lavoro modificato a valle. |
Utilizza la simulazione per controllare la ramificazione e il flusso dei dati. Utilizza il test live solo quando gli effetti collaterali reali sono accettabili negli account connessi.
Entrambi i test usano il trigger scelto, anche prima della distribuzione. Per un trigger **Pianificazione** o **Una tantum**, il test avvia l'esecuzione come se il trigger scattasse in quel momento, così puoi testare un workflow una tantum prima della data pianificata.
## Rivedi la cronologia di esecuzione
Apri **Esecuzioni** nel pannello inferiore per vedere le esecuzioni precedenti. Filtra l'elenco con **Live**, **Test** o **Tutte le esecuzioni**, quindi seleziona un'esecuzione per ispezionare i risultati dei nodi, l'output, i tempi e gli errori. Gli stati includono Completato, Non riuscito, In esecuzione e Annullato.
Se l'elenco dice **Ancora nessuna esecuzione**, il flusso di lavoro attuale non ha alcuna esecuzione registrata. Avviare un'altra esecuzione non è una soluzione per una non riuscita; apri prima l'esecuzione non riuscita e leggi il suo errore.
Alcuni nodi non riusciti idonei offrono **Riprova da "nodo"**. Questo avvia un nuovo tentativo immediatamente, senza un'altra conferma. Le azioni a valle possono essere eseguite di nuovo, quindi controlla prima i messaggi o le modifiche dello store già prodotte dall'esecuzione non riuscita.
## Distribuisci e attiva
Seleziona **Distribuisci** per aprire **Distribuisci workflow**. Rivedi il riepilogo delle modifiche, la compatibilità del contratto API, i risultati della convalida e il changelog facoltativo prima di continuare.
Puoi facoltativamente associare il flusso di lavoro distribuito a un evento, una pianificazione ricorrente o un'esecuzione una tantum. Solo uno di questi tipi di trigger può essere selezionato alla volta. Un'esecuzione una tantum richiede una data e un'ora future, inserite nel tuo fuso orario.
- **Distribuisci workflow** pubblica una versione con le impostazioni selezionate.
- **Attiva e distribuisci** appare quando una nuova associazione di evento, pianificazione o esecuzione una tantum renderebbe l'automazione attiva. La conferma pubblica la versione e consente ai trigger futuri di eseguirsi automaticamente con effetti reali.
Un errore di salvataggio, un conflitto irrisolto o un problema di convalida può bloccare la distribuzione. Risolvilo invece di selezionare ripetutamente Distribuisci.
Lo stato di produzione mostra **Non distribuito**, **Bozza più recente** o **In produzione**, più il trigger. Prima della prima distribuzione, è il trigger scelto (**Evento**, **Pianificazione**, **Una tantum** o **Manuale**) oppure **Nessun trigger**. Dopo una distribuzione, è **Manuale** se non è associato alcun trigger, altrimenti lo stato dell'associazione, ad esempio **Attivo**, **Pianificato**, **Completato** o **In pausa**. L'apertura di un'associazione esistente offre controlli consequenziali:
- **Metti in pausa** interrompe i trigger automatici ma mantiene il flusso di lavoro e l'associazione.
- **Riattiva trigger** consente all'associazione conservata di attivarsi di nuovo.
- **Rimuovi trigger** elimina permanentemente l'associazione ma non elimina il flusso di lavoro.
Ogni azione apre una conferma e può includere un motivo. La rimozione del segno di spunta da un'associazione esistente durante la distribuzione mette in pausa tale associazione anziché rimuoverla permanentemente.
## Cronologia delle versioni e rollback
Seleziona **Cronologia delle versioni** per aprire il pannello **Cronologia delle versioni**.
| Azione | Risultato |
| --- | --- |
| **Rollback delle recensioni** | Apre **Eseguire il rollback a questa versione?**. **Conferma rollback** rende la versione distribuita selezionata supersede la versione distribuita attuale. Questo può cambiare cosa fanno le esecuzioni future, ma non sostituisce l'area di disegno della bozza attuale. |
| **Ripristina** nella cronologia delle bozze | Sostituisce l'area di disegno attuale con la bozza salvata selezionata dopo la conferma. Le modifiche dell'area di disegno non salvate o più recenti possono andare perse. |
Aggiungi un motivo di rollback facoltativo in modo che gli altri membri del workspace comprendano il cambiamento. Rivedi l'area di disegno ripristinata e lo stato di distribuzione prima di avviare un'altra esecuzione.
## Elenco di controllo per il funzionamento sicuro
1. Conferma di essere nel progetto e nel flusso di lavoro corretto.
2. Attendi **Salvato** prima di testare o distribuire.
3. Completa e rivedi ogni input richiesto.
4. Inizia con **Esegui simulazione** quando possibile.
5. Utilizza il test live o il flusso di lavoro di esecuzione solo quando i loro effetti di servizio connesso sono accettabili.
6. Ispeziona **Esecuzioni** e output prima di distribuire.
7. Tratta **Attiva e distribuisci**, rollback, ripristino e eliminazione come azioni consequenziali che richiedono una revisione finale.
## Risoluzione dei problemi
| Problema | Passaggio successivo |
| --- | --- |
| Nessuna voce **Flusso** è visibile | Questo è previsto nella navigazione standard. Non indovinare un URL; vedi [Disponibilità delle funzioni](./feature-availability) o chiedi al supporto di Runner se il tuo workspace ha una voce approvata. |
| I controlli sono bloccati da un'anteprima del piano | Segui il messaggio del piano sullo schermo o chiedi a un proprietario del workspace l'accesso. |
| L'elenco dei modelli non riesce | Seleziona **Riprova** o crea un **Workflow vuoto**. |
| Il pulsante di esecuzione non è disponibile | Completa ogni input richiesto e correggi qualsiasi valore non valido. |
| Appare un conflitto di salvataggio | Decidi se la versione salvata dovrebbe vincere prima di selezionare **Ricarica**, perché le modifiche locali in conflitto vengono scartate. |
| L'esecuzione non riesce | Aprilo in **Esecuzioni**, mantieni l'errore e gli input visibili e evita di avviare esecuzioni identiche ripetutamente. |
| La distribuzione è bloccata | Risolvi i messaggi di salvataggio, conflitto, contratto o convalida mostrati nella finestra di dialogo di distribuzione. |
## Controlla il risultato prima della fase successiva
Dopo il salvataggio, riapri lo stesso workflow e controlla che passaggi e dati siano presenti. Un workflow salvato è pronto da esaminare, ma non è necessariamente stato eseguito. Quando lo spazio offre controlli di test o distribuzione, esamina lo stato e il risultato dell'esecuzione prima di procedere alla distribuzione. Se un'esecuzione fallisce, correggi i dati o il passaggio in errore prima di riprovare.
## Guide correlate
- [Automazioni](../automate-test-and-create/automations)
- [Stati e dettagli delle attività](../work-with-runner/task-states-and-details)
- [Risolvi i problemi delle attività di Runner](../help-and-reference/troubleshoot-runner-tasks)
- [Disponibilità delle funzioni](./feature-availability)
---
# Personalizzazione dell'agente
Source: https://www.runnerai.com/docs/it/guides/agent
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La pagina **Agente**, intitolata **Insegna a Runner come lavori**, riunisce Competenze e Memoria in un unico spazio ricercabile. Usala per far ripetere a Runner un metodo utile, ricordare un fatto stabile o interrompere l'uso di una funzionalità che non serve più.
## Cosa copre questa guida
Saprai come aprire la personalizzazione dell'agente, trovare una capacità esistente e scegliere se una competenza o una memoria è lo strumento giusto.
## Disponibilità e prerequisiti
- Hai bisogno dell'accesso a un progetto di store.
- Le competenze possono dipendere dal tuo piano attuale. Se il tuo piano non include le competenze, Runner mostra il percorso di aggiornamento disponibile invece di abilitare l'azione.
- La memoria appare solo quando la funzione di memoria unificata è abilitata per il tuo account.
- I vecchi link **Competenze**, **Memoria** e **Personalizza** reindirizzano a questa pagina dell'agente.
## Apri personalizzazione dell'agente
Da un progetto, seleziona **Agente** nella barra laterale. Usa i filtri **Tutto**, **Competenze** e **Memoria** per restringere la pagina. **Consigliate per te**, **Aggiunte** e **Scopri** sono sezioni della stessa pagina, non schede di navigazione separate.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Usa i filtri per concentrarti su Competenze o Memoria. Le competenze già attive compaiono in **Aggiunte**; sfogliare un consiglio non lo installa.
## Controlli principali
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Cerca competenze e memoria** | Trova una funzionalità senza esaminare ogni sezione. | La pagina filtra competenze e memorie corrispondenti. Il pulsante di cancellazione ripristina l'elenco completo. |
| Scheda in inglese **All** | Rivedi tutto ciò che è disponibile per la pagina dell'agente. | Runner mostra l'area competenze e, quando abilitata, memoria. |
| Scheda in inglese **Skills** | Concentrati su istruzioni e abilità riutilizzabili. | Runner mostra competenze consigliate, aggiunte, in pausa e scopribili. |
| Scheda in inglese **Memory** | Concentrati sui fatti che Runner dovrebbe conservare. | Runner mostra memorie raggruppate per ambito. Questa scheda è nascosta quando la memoria non è disponibile. |
| **Aggiungi** | Installa o riattiva una competenza. | La competenza si sposta in **Aggiunte** dopo che Runner completa l'azione. |
| **Aggiunte** | Vedi che una competenza è attiva. | Per le competenze configurabili, selezionarla mette in pausa quella competenza. |
| **Importa** | Porta una competenza compatibile da un URL. | Runner controlla l'origine, quindi apre un'importazione modificabile o un selettore multi-competenza. |
| **Crea competenza** | Scrivi un'istruzione riutilizzabile personalizzata. | L'editor di competenze si apre. I campi obbligatori devono essere completi prima di poter essere salvati. |
| **Aggiungi una memoria** | Salva un fatto stabile o una preferenza. | La finestra di dialogo **Nuova memoria** si apre. |
## Scegli tra una competenza e una memoria
1. Usa una **Competenza** quando Runner dovrebbe seguire un processo ripetibile, un formato o un insieme di istruzioni.
2. Usa **Memoria** quando Runner dovrebbe conservare un fatto conciso, una preferenza, una correzione, una convenzione o una decisione.
3. Mantieni i segreti fuori da entrambi. Non archiviare mai password, chiavi API, dettagli di pagamento o credenziali private.
4. Torna alla scheda in inglese **All** e cerca un termine per confermare che il nuovo elemento appaia.
## Stati e limiti
- **Consigliato per te** mostra un piccolo insieme di competenze di tendenza.
- **Aggiunte** contiene competenze attive; **In pausa** contiene competenze inattive.
- **Scopri** può mostrare righe di caricamento, risultati di ricerca o un messaggio senza risultati.
- Una competenza di sistema può essere di sola lettura o fissa. Una competenza personalizzata può offrire azioni di modifica ed eliminazione.
- Un'area di memoria vuota offre **Aggiungi una memoria**. Una ricerca senza corrispondenza offre **Cancella ricerca** senza eliminare nulla.
- Gli stati di caricamento, piano e non disponibile non significano che una capacità sia stata aggiunta.
## Risoluzione dei problemi
- Se la scheda in inglese **Memory** è mancante, la funzione non è abilitata per l'account attuale. Continua a usare le competenze o controlla di nuovo dalla navigazione visibile in seguito.
- Se **Aggiungi** apre una schermata di aggiornamento, confronta i piani prima di prendere una decisione di fatturazione.
- Se la ricerca non trova nulla, cancella la query e controlla separatamente le schede in inglese **All**, **Skills** e **Memory**.
- Se una modifica non riesce, mantieni la finestra di dialogo aperta, correggi il problema visualizzato e riprova. Non assumere che un toast o uno stato di caricamento significhi che la modifica sia stata completata.
## Guide correlate
- [Usa e metti in pausa le competenze](/it/guides/agent/skills)
- [Crea, importa e gestisci competenze](/it/guides/agent/create-import-manage-skills)
- [Aggiungi e modifica memoria](/it/guides/agent/memory)
- [Usa la tavolozza dei comandi dell'agente](/it/guides/agent/command-palette)
---
# Tavolozza dei comandi dell'agente
Source: https://www.runnerai.com/docs/it/guides/agent/command-palette
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La tavolozza dei comandi dell'agente è un collegamento incentrato sulla tastiera per le capacità dell'agente. È utile quando sai cosa ti serve e non vuoi sfogliare la pagina completa dell'agente.
## Cosa copre questa guida
Sarai in grado di aprire la tavolozza, cercare i suoi tre gruppi di capacità, utilizzare la tastiera e comprendere cosa fa la selezione di ogni risultato.
## Disponibilità e prerequisiti
- Devi essere all'interno di un progetto.
- Le competenze rimangono soggette all'accesso al piano e allo stato configurabile di ogni competenza.
- I risultati della memoria vengono visualizzati solo quando la memoria unificata è abilitata.
- Questa tavolozza è diversa dalla ricerca di navigazione del progetto: **Command/Ctrl + K** cerca destinazioni e conversazioni, mentre **Command/Ctrl + Shift + K** apre le capacità dell'agente.
## Percorso di accesso
In un progetto dove la tavolozza è disponibile, premi **Command + Shift + K** su macOS oppure **Ctrl + Shift + K** su Windows e Linux. Prima di selezionare un risultato, controlla che la finestra mostri i filtri **Competenze** e **Memoria**. Se si apre invece la Ricerca di navigazione, chiudila e usa **Agente** nella barra laterale.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Se la scorciatoia non apre la tavolozza delle funzionalità, usa questa pagina **Agente** per trovare le stesse competenze. L'immagine mostra la pagina alternativa, non la tavolozza dei comandi.
## Controlli
| Voce o tasto | Perché è utile | Cosa accade dopo |
| --- | --- | --- |
| Campo di ricerca | Trova competenze per nome, descrizione, categoria o tipo e memorie per contenuto, tag, tipo o ambito. | I risultati si aggiornano in Aggiunte, Scopri e Memoria. |
| Scheda in inglese **All** | Cerca ogni tipo di capacità disponibile. | Le competenze e, quando disponibili, la memoria vengono visualizzate insieme. |
| Scheda in inglese **Skills** | Limita i risultati alle competenze installate e scopribili. | Le righe di memoria sono nascoste. |
| Scheda in inglese **Memory** | Limita i risultati alle memorie salvate. | Questa scheda è nascosta quando la memoria non è disponibile. |
| Frecce su/giù | Sposta tra i risultati senza un mouse. | La riga evidenziata cambia. |
| Invio | Seleziona la riga evidenziata. | Il risultato esegue la sua azione specifica del tipo. |
| Esc | Esci senza cambiare nulla. | La tavolozza si chiude. |
## Cosa fa la selezione
| Tipo di risultato | Cosa accade quando selezionato |
| --- | --- |
| Competenza configurabile aggiunta | Runner attiva/disattiva lo stato attivo della competenza quando il tuo piano lo consente. |
| Competenza di sistema fissa | La riga rimane invariata se quella competenza non può essere attivata/disattivata. |
| Scopri competenza | Runner inizia ad aggiungere la competenza; la riga può mostrare **Aggiunta in corso…**. |
| Risultato in inglese **Memory** | La tavolozza si chiude e apre **Agente → Memory** con una ricerca basata su quella memoria. |
| Competenza senza accesso al piano | Runner apre **Agente → Skills**, dove il gate del piano spiega il prossimo passo disponibile. |
## Usa la tavolozza
1. Premi **Command/Ctrl + Shift + K**.
2. Digita una parola distintiva dal nome della competenza, dalla fonte o dal contenuto della memoria.
3. Se necessario, seleziona la scheda in inglese **Skills** o **Memory** per restringere l'elenco.
4. Usa i tasti freccia per evidenziare una riga.
5. Rivedi il testo dell'azione sulla destra, come **Aggiungi** o **Apri**.
6. Premi Invio solo quando è l'azione che desideri.
7. Conferma il risultato nella pagina dell'agente o nello stato della tavolozza aggiornato.
## Stati e limiti
- **Niente da mostrare** significa che la scheda attuale e la query non hanno restituito righe.
- **Aggiunta in corso…** è uno stato di progresso, non una conferma che l'installazione sia terminata.
- La tavolozza è ottimizzata per la selezione rapida; creare, modificare, eliminare, ambito della memoria e impostazioni dettagliate della competenza rimangono nella pagina completa dell'agente.
- La selezione di una competenza attiva può metterla in pausa. Leggi lo stato della riga prima di premere Invio.
## Risoluzione dei problemi
- Se la scorciatoia apre Ricerca del progetto o più finestre, premi Escape per chiuderle e usa **Agente** nella barra laterale per gestire le stesse funzionalità.
- Se la memoria è assente, l'account non ha attualmente la superficie di memoria unificata.
- Se Invio apre la pagina dell'agente invece di attivare/disattivare una competenza, segui il gate del piano visualizzato.
- Se non ci sono risultati, cancella la ricerca o seleziona la scheda in inglese **All**.
- Se una competenza rimane invariata, potrebbe essere una competenza di sistema fissa.
## Guide correlate
- [Panoramica della personalizzazione dell'agente](/it/guides/agent)
- [Competenze](./skills)
- [Memoria](./memory)
- [Piani di abbonamento](../plans-and-billing/subscription-plans)
---
# Crea, importa e gestisci competenze
Source: https://www.runnerai.com/docs/it/guides/agent/create-import-manage-skills
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le competenze personalizzate ti permettono di confezionare le tue istruzioni per un uso ripetuto. L'importazione è utile quando una competenza compatibile esiste già e vuoi rivederla prima di aggiungerla a Runner.
## Cosa copre questa guida
Saprai come creare o importare una competenza, comprendere ogni controllo dell'editor e distinguere la pausa reversibile dall'eliminazione permanente.
## Disponibilità e prerequisiti
- Apri un progetto con accesso a **Agente → Competenze**.
- Le competenze richiedono accesso al piano.
- L'importazione richiede un URL di origine compatibile che Runner possa leggere.
- Non importare istruzioni di cui non ti fidi. Rivedi il nome, la descrizione, il contenuto, le impostazioni e i file inclusi prima di salvare.
## Percorsi di accesso
- Creazione: **Agente** nella barra laterale → filtro **Competenze** → **Crea competenza** nella sezione **Scopri**.
- Importazione: **Agente** nella barra laterale → filtro **Competenze** → **Importa** in **Scopri**.
- Modifica o eliminazione: **Agente** nella barra laterale → filtro **Competenze** → una riga in **Aggiunte** → **Altre azioni**.
## Controlli dell'editor di competenze
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Nome** | Dà alla competenza la sua identità negli elenchi e nei comandi. | Runner convalida che un nome sia presente prima di salvare. |
| **Descrizione** | Spiega quando la competenza dovrebbe essere utilizzata. | La descrizione appare negli elenchi e nei selettori di competenze. |
| **Contenuto** | Conserva le istruzioni riutilizzabili. | Scrivi in **Modifica** e usa **Anteprima** per controllare la formattazione. |
| **Configurazione avanzata** | Mostra impostazioni facoltative di invocazione e organizzazione. | Espandila solo quando devi modificarle. |
| **Passa a Markdown** / **Passa al modulo** | Cambia il modo di modificare la competenza. | Apre l'editor Markdown o a campi; cambiare vista non salva la competenza. |
| **Categoria** | Raggruppa le competenze correlate. | Questa etichetta facoltativa influisce su come le competenze sono organizzate. |
| **Etichetta di scelta rapida** | Dà alla competenza un'etichetta di comando più chiara. | L'etichetta facoltativa appare con i controlli orientati ai comandi. |
| **Abilitato** | Sceglie se la competenza nuova o modificata parte attiva. | Per una nuova competenza è attivo. Disattivalo prima della creazione se deve partire sospesa. |
| **Disabilita auto-invocazione dell'IA** | Impedisce a Runner di scegliere la competenza automaticamente. | La competenza rimane disponibile per l'uso manuale. |
| **Invocabile dall'utente** | Consente l'uso manuale del comando slash. | Disattivarla rimuove l'invocazione manuale mantenendo altri usi consentiti. |
| **Suggerimento argomento** | Mostra l'input previsto dopo un comando. | Il suggerimento può visualizzare esempi come un URL o un numero di problema. |
| Area file | Aggiungi testo di supporto o risorse necessarie dalla competenza. | Runner convalida i limiti di file individuali e totali prima di salvare. |
| **Annulla** | Esci senza applicare la modifica attuale. | La finestra di dialogo si chiude; le modifiche non salvate vengono scartate. |
| **Crea** / **Salva** | Memorizza una competenza valida. | Dopo il successo, Runner chiude l'editor e aggiorna l'elenco. |
## Crea una competenza personalizzata
1. Apri **Agente** nella barra laterale e seleziona il filtro **Competenze**.
2. In **Scopri**, seleziona **Crea competenza**.
3. Inserisci un **Nome** minuscolo con trattini, come `homepage-copy-review`, una **Descrizione** concisa e il **Contenuto** della competenza. Questi campi sono obbligatori.
4. Seleziona **Anteprima** in Contenuto per controllare le istruzioni. Espandi **Configurazione avanzata** solo se servono impostazioni facoltative.
5. Controlla **Abilitato** e le impostazioni avanzate di invocazione che hai modificato. Determinano come Runner può usare la competenza.
6. Seleziona **Crea**.
7. Conferma che la competenza appaia in **Aggiunte** o **In pausa**, a seconda dell'impostazione Abilitato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4coukNWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
L'esempio mostra l'anteprima delle istruzioni prima di **Crea**. La bozza non è stata salvata.
### Guarda: esamina una bozza di competenza
La registrazione passa dall'esempio Markdown all'Anteprima del modulo, poi annulla. Per conservare la tua competenza, seleziona **Crea** e controlla che compaia nell'elenco.
## Importa una competenza
1. Apri **Agente**, seleziona il filtro **Competenze** e trova **Importa** in **Scopri**.
2. Incolla l'URL di origine compatibile.
3. Seleziona **Importa**.
4. Per una competenza scoperta, Runner apre l'editor con i campi importati compilati. Per un'origine contenente più competenze, Runner apre un selettore.
5. Rivedi ogni campo importato e qualsiasi avviso di file escluso o dimensione.
6. Apporta le modifiche necessarie, poi seleziona **Crea**.
7. Conferma che la competenza appaia nella pagina dell'agente prima di chiudere il tuo flusso di lavoro.
L'importazione non rende il contenuto non revisionato affidabile. Tratta le istruzioni importate come qualsiasi altro contenuto che può influenzare il lavoro di Runner.
## Modifica, metti in pausa o elimina
1. Seleziona una riga di competenza personalizzata o apri **Altre azioni → Modifica**.
2. Modifica i campi necessari e seleziona **Salva**. Riapri la competenza per controllare le istruzioni aggiornate.
3. Per smettere di usarla senza perderla, seleziona **Aggiunte** per spostarla in **In pausa**.
4. Per rimuoverla, apri **Altre azioni → Elimina**.
5. Rivedi la finestra di dialogo di conferma denominata e seleziona **Elimina** solo quando intendi rimuovere la competenza.
**L'eliminazione è distruttiva.** Non è la stessa cosa della pausa e la pagina non la presenta come un'azione annullabile. Le competenze di sistema non offrono l'eliminazione.
## Stati e limiti
- Nome, descrizione o contenuto mancanti bloccano il salvataggio e mostrano un messaggio di convalida.
- Un nome di competenza importato duplicato può essere rifiutato o contrassegnato come già presente.
- I file che superano i limiti accettati possono essere saltati; un avviso di dimensione totale può bloccare il salvataggio fino a quando il contenuto non viene ridotto.
- Mentre il salvataggio, l'importazione o l'eliminazione è in corso, attendi il messaggio di successo o errore prima di intraprendere un'altra azione.
- Le competenze di sistema di sola lettura possono mostrare i dettagli ma non espongono i controlli di modifica della competenza personalizzata.
## Risoluzione dei problemi
- Se **Importa** rimane non disponibile, attendi il completamento del controllo della competenza esistente e conferma che il campo URL non sia vuoto.
- Se l'importazione apre un selettore batch, seleziona solo le competenze che riconosci e di cui hai bisogno.
- Se il salvataggio è bloccato, controlla i campi obbligatori e qualsiasi avviso di file nella parte superiore dell'editor.
- Se una competenza è scomparsa dopo aver selezionato **Aggiunte**, controlla **In pausa** prima di ricrearla.
- Se l'eliminazione non riesce, la competenza rimane; chiudi l'errore e riprova dopo aver controllato le tue autorizzazioni.
## Guide correlate
- [Competenze](./skills)
- [Panoramica della personalizzazione dell'agente](/it/guides/agent)
- [Usa la tavolozza dei comandi dell'agente](./command-palette)
- [Archivia le impostazioni dell'agente](../account-and-settings/custom-scripts-and-store-agent)
---
# Memoria
Source: https://www.runnerai.com/docs/it/guides/agent/memory
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La Memoria è per fatti concisi che Runner dovrebbe conservare, come una preferenza di scrittura, una regola di business corretta o una decisione approvata. Riduce le spiegazioni ripetute tra le attività.
## Cosa copre questa guida
Sarai in grado di aggiungere, trovare, modificare ed eliminare in sicurezza una memoria.
## Disponibilità e prerequisiti
- Hai bisogno di un progetto di negozio.
- La scheda **Memoria** appare solo quando la Memoria unificata è abilitata per il tuo account.
- La Memoria è separata dal gate del piano Skills.
- Non salvare mai password, chiavi API, dettagli di pagamento, credenziali private o altri segreti in Memoria.
## Percorso di accesso
Seleziona **Agente** nella barra laterale, poi il filtro **Memoria**.
## Controlli della memoria
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Aggiungi una memoria** | Salva un nuovo fatto per Runner. | Si apre la finestra di dialogo **Nuova memoria**. |
| **Contenuto** | Dichiara il fatto che Runner dovrebbe conservare. | Questo testo diventa la memoria visibile. |
| **Ambito** | Scegli dove il fatto dovrebbe applicarsi. | Seleziona **Questo negozio**, **Personale** o **Organizzazione**. |
| **Tipo** | Spiega che tipo di fatto è. | Seleziona Preferenza, Correzione, Convenzione, Conoscenza o Decisione. |
| **Tag** | Rendi la memoria più facile da trovare e raggruppare. | Inserisci uno o più tag separati da virgole. Almeno un tag è obbligatorio per salvare. |
| **Importanza** | Comunica a Runner quanto fortemente pesare il fatto. | Seleziona Bassa, Media o Alta. |
| **Aggiungi memoria** | Salva una nuova memoria valida. | La finestra di dialogo si chiude dopo il successo e la memoria appare nel suo gruppo di ambito. |
| Icona di modifica | Correggi o perfeziona una memoria. | **Modifica memoria** si apre con i valori correnti. |
| **Salva** | Applica una modifica. | La riga si aggiorna dopo il successo dell'aggiornamento. |
| Icona di eliminazione o **Elimina** | Rimuovi una memoria. | Runner apre una finestra di dialogo di conferma distruttiva. |
## Aggiungi una memoria
1. Apri **Agente** nella barra laterale, poi seleziona il filtro **Memoria**.
2. Seleziona **Aggiungi una memoria**.
3. Scrivi un fatto chiaro in **Contenuto**, ad esempio «Usa la maiuscola solo all'inizio dei titoli in questo negozio».
4. Scegli l'**Ambito** più ristretto corretto.
5. Scegli il **Tipo** più vicino.
6. Aggiungi **Tag** utili separati da virgole, ad esempio `copy, headings`.
7. Imposta **Importanza**. Usa Alta con parsimonia per i fatti che Runner dovrebbe prioritizzare quando le informazioni competono.
8. Seleziona **Aggiungi memoria**.
9. Conferma che la nuova riga appaia nell'ambito previsto.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
L'esempio è una preferenza non salvata. Scegli l'ambito più ristretto prima di selezionare **Aggiungi memoria**.
### Guarda: scegli l'ambito di una memoria
La registrazione esamina gli ambiti di una preferenza di esempio, poi annulla. Non salva una memoria. Segui i passaggi precedenti e controlla la nuova riga per confermare il tuo salvataggio.
## Modifica o elimina una memoria
1. Trova la memoria sfogliando il suo gruppo di ambito o usando la ricerca.
2. Seleziona l'icona di modifica, aggiorna i campi e seleziona **Salva**. Riapri la riga per verificare contenuto e ambito nuovi.
3. Per rimuoverla, seleziona l'icona di eliminazione o **Elimina** nella finestra di dialogo di modifica.
4. Rivedi **Elimina memoria** e seleziona **Elimina** per confermare.
L'eliminazione di una memoria non può essere annullata da questa finestra di dialogo. Annulla chiude la conferma senza rimuoverla.
## Stati e limiti
- Un nuovo account può mostrare **Nessuna memoria ancora** con un'azione **Aggiungi una memoria**.
- Una ricerca senza corrispondenza dice quante memorie sono nascoste e offre **Cancella ricerca**.
- Il Contenuto e almeno un tag sono obbligatori prima che il pulsante di salvataggio diventi disponibile.
- Le memorie sono raggruppate per ambito e mostrano il loro tipo, ambito, conteggio di utilizzo e ora di utilizzo recente.
- La Memoria rende un fatto disponibile a Runner; non è una garanzia che il fatto sovrascriverà ogni istruzione o limite di sicurezza.
## Risoluzione dei problemi
- Se la scheda **Memoria** è assente, usa la navigazione visibile piuttosto che un vecchio collegamento diretto. La funzione non è abilitata per l'account corrente.
- Se **Aggiungi memoria** è disabilitato, aggiungi Contenuto e almeno un tag separato da virgole.
- Se l'elenco sembra vuoto dopo la ricerca, seleziona **Cancella ricerca**.
- Se una modifica non riesce, la memoria precedente rimane. Correggi il problema visualizzato e riprova.
- Se una memoria viene applicata troppo ampiamente, modificala e scegli un ambito più ristretto.
## Guide correlate
- [Tipi di memoria e ambiti](./memory-types-and-scopes)
- [Panoramica della personalizzazione dell'Agente](/it/guides/agent)
- [Usa la tavolozza dei comandi dell'Agente](./command-palette)
- [Sicurezza della chiave API](../account-and-settings/api-keys)
---
# Tipi di memoria e ambiti
Source: https://www.runnerai.com/docs/it/guides/agent/memory-types-and-scopes
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
L'ambito impedisce a un fatto di raggiungere il lavoro sbagliato, mentre il Tipo e l'Importanza aiutano Runner a interpretarlo. Usa questa pagina quando una memoria dovrebbe applicarsi a più di un'attività ma non necessariamente a ogni negozio o persona.
**Percorso di accesso:** **barra laterale → Agente → Memoria → Aggiungi una memoria**, oppure apri una memoria esistente per modificarla.
## Cosa copre questa guida
Sarai in grado di scegliere l'ambito più ristretto corretto, classificare una memoria e utilizzare tag e importanza senza archiviare dati sensibili.
## Disponibilità e prerequisiti
- La Memoria unificata deve essere abilitata per l'account.
- Apri **barra laterale → Agente → Memoria → Aggiungi una memoria**, oppure modifica una memoria esistente.
- Non utilizzare alcun ambito per password, chiavi API, dati di carte, codici di autenticazione o altri segreti.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Usa **Ambito** per indicare dove vale il fatto e **Tipo** per ciò che rappresenta. L'esempio non è salvato; [Aggiungi e modifica Memoria](/it/guides/agent/memory) include la procedura completa e la registrazione.
## Scelte di ambito
| Ambito | Usalo quando | Cosa succede dopo |
| --- | --- | --- |
| **Questo negozio** | Il fatto è specifico della vetrina, del catalogo, del marchio o del flusso di lavoro corrente. | Runner raggruppa la memoria nell'ambito del negozio e può applicarla al lavoro per questo negozio. Per impostazione predefinita, una nuova memoria usa questo ambito, il tipo **Preferenza** e l'importanza **Media**. |
| **Personale** | Il fatto descrive la tua preferenza di lavoro personale. | Runner la raggruppa come Personale piuttosto che condividerla come regola a livello di workspace. |
| **Organizzazione** | Il fatto è una regola o una convenzione approvata condivisa nell'area di lavoro. | Runner la raggruppa sotto Organizzazione in modo che possa informare il lavoro oltre un singolo negozio. |
Scegli l'ambito più ristretto che sia ancora utile. Una regola di spedizione specifica del negozio, ad esempio, non dovrebbe essere una memoria Organizzazione a meno che non si applichi veramente ovunque.
## Scelte di tipo
| Tipo | Buon uso | Esempio |
| --- | --- | --- |
| **Preferenza** | Uno stile desiderato o una scelta di lavoro | "Usa descrizioni di prodotti concise e editoriali." |
| **Correzione** | Un fatto che Runner ha precedentemente sbagliato | "La finestra di reso è indicata nel documento della politica approvata." |
| **Convenzione** | Una regola di denominazione o formattazione ripetibile | "Usa maiuscole iniziali per i titoli delle collezioni." |
| **Conoscenza** | Un fatto stabile di business o prodotto | "La collezione di punta si chiama Studio Essentials." |
| **Decisione** | Una scelta approvata che il lavoro futuro dovrebbe rispettare | "Mantieni il checkout per ospiti abilitato." |
Non includere un segreto in un esempio o memoria. Fai riferimento alla posizione di una credenziale protetta invece di archiviarne il valore.
## Importanza e tag
| Controllo | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Bassa** | Mantieni disponibile un fatto utile ma facoltativo. | Runner gli dà meno peso quando le informazioni competono. |
| **Media** | Usa la priorità normale per i fatti di lavoro stabili. | Runner gli dà il peso medio predefinito. |
| **Alta** | Contrassegna una regola o una decisione approvata importante. | Runner gli dà più peso quando sceglie tra memorie rilevanti. |
| **Tag** | Rendi la ricerca e il raggruppamento più facili. | I tag separati da virgole vengono salvati con la memoria; almeno uno è obbligatorio. |
L'importanza è un suggerimento di priorità, non un'istruzione per ignorare la richiesta corrente, i permessi dell'account o le restrizioni di sicurezza.
## Classificare una memoria
1. Scrivi il fatto come una frase chiara e singola.
2. Chiedi dove dovrebbe applicarsi: solo questo negozio, solo a te o in tutta l'organizzazione.
3. Seleziona il Tipo più vicino in base al motivo per cui il fatto esiste.
4. Aggiungi un piccolo set di tag specifici.
5. Inizia con importanza Media a meno che non ci sia un motivo chiaro per scegliere Bassa o Alta.
6. Salva e conferma che la riga appaia sotto l'intestazione dell'ambito previsto.
## Stati e limiti
- L'elenco visualizza il Tipo, l'Ambito, quante volte la memoria è stata utilizzata e un'ora di utilizzo recente relativa.
- La modifica dell'Ambito sposta la memoria in un gruppo diverso dopo il salvataggio riuscito.
- La selezione della memoria dipende dalla rilevanza e dalla priorità; una memoria Alta non è garantita che appaia in ogni risposta.
## Risoluzione dei problemi
- Se una memoria influenza il negozio sbagliato, cambia il suo Ambito a **Questo negozio** nel progetto corretto.
- Se due memorie entrano in conflitto, modifica o elimina quella obsoleta invece di elevare entrambe ad Alta.
- Se la ricerca non trova una memoria, prova le parole dal suo Contenuto o Tag, quindi cancella il filtro.
- Se una convenzione condivisa non è visibile ai collaboratori, conferma che sia stata salvata come **Organizzazione**, non Personale.
## Guide correlate
- [Aggiungi e modifica Memoria](./memory)
- [Panoramica della personalizzazione dell'Agente](/it/guides/agent)
- [Sicurezza e sessioni](../account-and-settings/security-and-sessions)
---
# Skills
Source: https://www.runnerai.com/docs/it/guides/agent/skills
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le Skills danno a Runner un set ripetibile di istruzioni per un tipo di lavoro. Sono utili quando vuoi che un processo affidabile sia disponibile nelle conversazioni future invece di riscrivere lo stesso prompt ogni volta.
## Cosa copre questa guida
Sarai in grado di aggiungere una Skill, determinare se è attiva, metterla in pausa e comprendere quali azioni sono disponibili per le Skill di Sistema e Personalizzate.
## Disponibilità e prerequisiti
- Apri un progetto di negozio dove hai il permesso di gestire le capacità dell'Agente.
- L'uso di Skill è controllato dal piano. Runner mostra un percorso di aggiornamento quando il piano corrente non lo include.
- Alcune Skill di Sistema non possono essere messe in pausa, modificate o eliminate.
## Percorso di accesso
Seleziona **Agente** nella barra laterale, poi il filtro **Competenze**. Scorri fino a **Consigliate per te**, **Aggiunte** o **Scopri** nella stessa pagina.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Leggi la fonte e lo stato della competenza prima di selezionare **Aggiungi** o **Aggiunta**. Lo screenshot mostra competenze esistenti, non il risultato di una nuova installazione.
## Sezioni e controlli delle Skill
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Consigliato per te** | Rivedi rapidamente un piccolo set di Skill di tendenza. | Selezionare **Aggiungi** avvia l'installazione. |
| **Aggiunte** | Vedi quali Skill sono attive. | Ogni riga mostra il nome della Skill, la descrizione, il tipo e le azioni disponibili. |
| **In pausa** | Trova le Skill che sono attualmente disattivate. | Selezionare **Aggiungi** riattiva una Skill configurabile. |
| **Scopri** | Sfoglia o cerca Skill aggiuntive. | Un nome di Skill può aprire la sua fonte in una nuova scheda; **Aggiungi** la installa nel tuo workspace. |
| Riga di Skill | Leggi i dettagli della Skill. | Una Skill Personalizzata si apre in modalità di modifica. Una Skill di Sistema si apre in modalità di visualizzazione. |
| Pulsante **Aggiunte** | Metti in pausa una Skill configurabile attiva. | La Skill si sposta a **In pausa** dopo il successo dell'aggiornamento. |
| Pulsante **Aggiungi** | Installa o riattiva una Skill. | Il pulsante mostra lo stato di avanzamento, quindi la Skill appare sotto **Aggiunte**. |
| Altre azioni | Trova azioni di modifica, visualizzazione o eliminazione. | Le azioni disponibili dipendono dal fatto che la Skill sia di Sistema o Personalizzata. |
## Aggiungi una Skill scoperta
1. Seleziona **Agente** nella barra laterale, poi il filtro **Competenze**. Scorri fino a **Consigliate per te**, **Aggiunte** o **Scopri** nella stessa pagina.
2. Cerca l'attività o il formato di cui hai bisogno.
3. Rivedi il nome della Skill, la fonte e la descrizione.
4. Seleziona **Aggiungi**.
5. Attendi il completamento dello stato di avanzamento.
6. Conferma che la Skill appaia sotto **Aggiunte** prima di affidarti a essa nella chat.
## Metti in pausa o riattiva una Skill
1. Trova la Skill sotto **Aggiunte**.
2. Seleziona il suo pulsante **Aggiunte**.
3. Conferma che si sposti a **In pausa**.
4. Per riattivarlo, seleziona **Aggiungi** nella sezione In pausa.
Mettere in pausa è reversibile. Interrompe l'attivazione della Skill senza eliminarne la definizione.
## Skill di Sistema e Personalizzate
| Tipo di Skill | Azioni tipiche | Limite importante |
| --- | --- | --- |
| **Sistema** | Visualizza dettagli; metti in pausa solo quando la Skill lo consente | Le Skill di Sistema fisse non offrono eliminazione e potrebbero non offrire pausa. |
| **Personalizzata** | Modifica, metti in pausa, riattiva o elimina | L'eliminazione richiede conferma e rimuove la Skill piuttosto che semplicemente metterla in pausa. |
## Stati e limiti
- **Aggiunta in corso...** significa che l'installazione è ancora in esecuzione. Attendi **Aggiunte**.
- I risultati della ricerca possono provenire dalla directory pubblica delle Skill così come dalle Skill già nel tuo workspace.
- Un gate del piano blocca l'attivazione; non rimuove le definizioni di Skill esistenti.
- Il contenuto importato può omettere file che superano i limiti accettati. Rivedi eventuali avvisi prima di salvare.
- **Nessun risultato skills.sh per questa ricerca** significa che nessun risultato di scoperta compatibile è stato restituito; non influisce sulle Skill aggiunte.
## Risoluzione dei problemi
- Se **Aggiungi** non si completa, riprova una volta dopo aver controllato l'errore visualizzato. Evita di fare clic ripetutamente mentre il pulsante è occupato.
- Se una Skill non può essere messa in pausa, è probabilmente una Skill di Sistema fissa. Apri i suoi dettagli per confermare.
- Se la Skill prevista è assente, cancella la ricerca e controlla sia **Aggiunte** che **In pausa**.
- Se una Skill appena aggiunta non è disponibile in un progetto, controlla **Impostazioni → Negozio → Agente** per la selezione di Skill di quel progetto.
## Guide correlate
- [Crea, importa e gestisci Skills](./create-import-manage-skills)
- [Panoramica della personalizzazione dell'Agente](/it/guides/agent)
- [Usa la tavolozza dei comandi dell'Agente](./command-palette)
- [Impostazioni dell'Agente del negozio](../account-and-settings/custom-scripts-and-store-agent)
---
# Analisi e SEO
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo
Parti da **Misura** → **Analytics** per il comportamento registrato nel negozio, oppure **Cresci** → **SEO** per la panoramica **SEO e GEO**. Scegli la guida adatta alla tua domanda.
> **Disponibilità:** **Analisi** dipende dal tuo piano e dai dati del negozio registrati. **SEO** richiede un piano a pagamento: **Plus** o superiore, oppure AppSumo License Tier 2, 3 o 4. Può dipendere anche da una vetrina pubblicata, dall'accesso del provider e da dati pubblici sufficienti per l'analisi.
| Obiettivo | Inizia qui |
| --- | --- |
| Comprendi l'intera pagina di prestazioni | [Panoramica di Analytics](/it/guides/analytics-and-seo/analytics-overview) |
| Cambia la finestra di reporting | [Metriche e filtri](/it/guides/analytics-and-seo/metrics-filters) |
| Trova l'attrito dell'imbuto o del carrello | [Traffico e conversione](/it/guides/analytics-and-seo/traffic-and-conversion) |
| Avvia una revisione della visibilità della vetrina | [Panoramica SEO](/it/guides/analytics-and-seo/seo-overview) |
| Leggi le stime di ricerca organica | [Prestazioni di ricerca](/it/guides/analytics-and-seo/search-performance) |
| Ispeziona link e problemi tecnici | [Backlink e audit del sito](/it/guides/analytics-and-seo/backlinks-and-site-audit) |
| Comprendi la visibilità nelle risposte AI | [Visibilità AI](/it/guides/analytics-and-seo/ai-visibility) |
| Testa prompt e ispeziona le fonti | [Prompt, parole chiave e citazioni](/it/guides/analytics-and-seo/prompts-keywords-citations) |
| Recupera da pagine vuote o bloccate | [Risolvi i problemi di dati e pubblicazione](/it/guides/analytics-and-seo/troubleshoot-data-and-publication) |
Queste visualizzazioni segnalano o analizzano i dati disponibili. L'apertura di un rapporto non modifica la vetrina e una schermata di configurazione non è la prova che il traffico, i ranking o le menzioni AI siano migliorati.
---
# Visibilità AI
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/ai-visibility
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La visibilità AI ti aiuta a ispezionare se i dati di ricerca AI disponibili menzionano il tuo marchio, i concorrenti o le fonti pubbliche.
> **Condizionale:** La visibilità AI può dipendere dall'accesso al workspace, dal piano, dalla disponibilità del provider, da una vetrina pubblica e da dati sufficienti. Il completamento della configurazione non crea menzioni o migliora la visibilità di per sé.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **SEO** → **Visibilità IA** → **Apri**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un nuovo negozio deve soddisfare il prerequisito di pubblicazione SEO prima di usare i report. L'anteprima con dati di esempio è illustrativa: non mostra risultati di analisi.
## Prima di iniziare
Se SEO mostra la lista di configurazione del primo negozio, completa la pubblicazione prima di aspettarti dati nei report. I valori **Anteprima · dati di esempio** non sono risultati del negozio. I passaggi seguenti valgono quando il relativo report diventa disponibile.
- Pubblica la vetrina e completa il passaggio di idoneità SEO principale.
- Verifica che Runner rilevi il dominio della vetrina pubblica che intendi tracciare; la configurazione non fornisce un campo marchio separato modificabile.
- Aggiungi solo concorrenti rilevanti in modo che i confronti di quota di voce rimangono utili.
- Connetti Google Search Console solo se la voce facoltativa è disponibile e desideri autorizzarla.
## Controlli e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Vetrina rilevata | Mostra il negozio pubblico che la configurazione utilizzerà come target iniziale. |
| Campi concorrenti nella configurazione | Aggiunge marchi di confronto alle scelte di configurazione; l'inserimento di un nome non esegue una ricerca. |
| Anteprima del prompt iniziale | Mostra idee di prompt di esempio per la configurazione. L'anteprima non esegue o salva i risultati del prompt. |
| Google Search Console → **Connetti** | Apre **App** per la connessione facoltativa di Google Search Console. |
| **Continua** | Avanza al passaggio di configurazione successivo quando l'input corrente è valido. |
| **Salta per ora** | Chiude la configurazione senza avviare la Ricerca marchio o creare uno snapshot. |
| **Esegui Brand Lookup** | Apre la configurazione in tre passaggi di Visibilità AI per la vetrina rilevata. |
| **Completa configurazione** | Invia la vetrina rilevata e le scelte dei concorrenti, chiude la configurazione e avvia la Ricerca marchio. I risultati rimangono in sospeso fino al completamento della ricerca. |
| **Chiedi a Runner di risolvere questo** | Apre una nuova conversazione Runner con le prove di visibilità AI salvate e il miglioramento consigliato. Non modifica o pubblica il negozio di per sé. |
| **Vedi lacune di citazione** | Apre una conversazione Runner basata su prove focalizzata sulle opportunità di citazione mancanti; rivedi i suoi suggerimenti prima di apportare modifiche. |
## Completa la configurazione
1. Apri **Cresci** → **SEO**, poi la scheda **Visibilità IA**.
2. Seleziona **Esegui Brand Lookup** per aprire la configurazione.
3. Conferma che la vetrina pubblica rilevata sia il negozio che intendi rivedere.
4. Aggiungi un piccolo set di concorrenti rilevanti, quindi seleziona **Continua**.
5. Rivedi l'anteprima del prompt iniziale senza considerarlo un test completato, quindi continua.
6. Connetti Search Console solo se l'opzione è utile e sei autorizzato a connettere l'account.
7. Seleziona **Completa configurazione** per inviare e avviare la Ricerca marchio.
8. Attendi uno stato completato; non avviare una ricerca duplicata mentre è in sospeso.
9. Leggi menzioni, volume di ricerca AI stimato, quota di voce, query e fonti citate insieme.
## Leggi la dashboard
- **Menzioni** conta le risposte disponibili o i record che fanno riferimento al marchio tracciato.
- **Share of voice** confronta i marchi tracciati all'interno del set di dati disponibile; non è l'intero internet.
- **Query** mostrano le domande associate ai risultati raccolti.
- **Fonti citate** mostrano le pagine a cui si fa riferimento nelle risposte disponibili e possono includere siti che non controlli.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| In sospeso | La ricerca è stata accettata ma non è terminata. Attendi prima di avviarla di nuovo. |
| Completato senza menzioni | Il risultato non contiene menzioni del marchio. Rivedi le query e le fonti piuttosto che assumere che la configurazione sia fallita. |
| Non riuscito | Apri l'errore visibile, conferma il target pubblico e riprova più tardi. |
| Provider non disponibile o accesso mancante | Il modello o la fonte di dati richiesta non può essere utilizzata ora. Usa le sezioni completate e riprova più tardi. |
| Dati insufficienti | Il provider non ha potuto produrre una visualizzazione affidabile per il target. Mantieni il sito pubblico e rivedi dopo che ha più contenuti rilevabili. |
## Controlla prima di avviare la ricerca
La configurazione permette di esaminare la vetrina rilevata e i concorrenti. **Completa configurazione** avvia la ricerca e può consumare capacità a pagamento. Per esaminare il modulo senza eseguire nulla, usa **Salta per ora**. Dopo una ricerca completata, controlla obiettivo ed evidenze restituite prima di interpretare la dashboard.
## Guide correlate
- [Prompt, parole chiave e citazioni](./prompts-keywords-citations)
- [Panoramica SEO](./seo-overview)
- [Prestazioni di ricerca](./search-performance)
---
# Panoramica di Analytics
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/analytics-overview
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Analytics collega visite registrate, attività di acquisto e vendite del negozio selezionato.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Analytics**.
## Prima di iniziare
- Il piano deve includere la relativa area di report. L'anteprima del piano non mostra risultati misurati del negozio.
- Per report significativi su traffico e vendite servono un negozio pubblicato e attività dei clienti registrata.
- Confronta report dello stesso negozio, periodo e filtri.
## Scegli il layout che vedi
Se vedi **Vendite Nette**, **GMV**, **Sessioni** e **Tasso di conversione** sopra un'unica pagina scorrevole, segui le [istruzioni della dashboard precedente](#if-you-see-the-earlier-dashboard) più sotto. Se vedi una navigazione per gruppi di report, usa le istruzioni successive. Se sopra il grafico vedi **Report di questa settimana** e **Altri report**, segui le [istruzioni per quel layout](#if-you-see-the-sections-layout). I layout hanno controlli diversi.
## Scegli un report
**Disponibilità condizionata:** se la schermata mostra **Analisi del negozio online**, usa l'area raggruppata seguente. Alcuni spazi mostrano ancora la dashboard a pagina unica descritta più avanti.
| Controllo | Cosa apre |
| --- | --- |
| **Panoramica** | Riepilogo dell'attività del negozio selezionato. Usa **Vedi dettagli**, quando disponibile, per esaminare il report sottostante. |
| **Commercio** | Report su commercio, funnel, prodotti, acquisizione e obiettivi. |
| **Comportamento** | Report su pagine, eventi, percorsi e altre attività di navigazione supportate. |
| **Pubblico** | Report su visitatori, utenti, segmenti e caratteristiche. |
| **Pagina live** | Vista dell'attività in tempo reale disponibile. |
| **Configura** | Strumenti di tracciamento e configurazione Analytics. Aprirli non crea eventi. |
| Selettore delle date | Aggiorna il report selezionato per il periodo scelto. |
| **Confronta**, se disponibile | Aggiunge il periodo di confronto supportato. |
## Esamina il tuo primo report
1. Apri **Panoramica** e verifica il negozio selezionato.
2. Scegli un periodo con attività nota, ad esempio **7g** o **30 g**.
3. Leggi il riepilogo, poi apri **Commercio** per esaminare vendite e funnel.
4. Apri il report specifico per la domanda. Ad esempio, confronta le fasi del funnel prima di indagare un possibile problema di checkout.
5. Apri **Comportamento** per esaminare una pagina o un percorso interessato quando ci sono dati.
6. Torna a **Panoramica** per confrontare i dettagli con il riepilogo.
**Verifica:** sai identificare report, periodo attivo ed eventi dietro un risultato. Un report vuoto non conferma né la raccolta funzionante degli eventi né un negozio guasto.
## Se vedi Altri report [#if-you-see-the-sections-layout]
La panoramica mostra **Visitatori**, **Ricavi**, **Ordini**, **Visitatori che hanno acquistato**, **Ricavi per visitatore** e **Online ora**, poi il grafico dell’andamento ed elenchi di canali, prodotti e luoghi. Il periodo, **Giornaliero** / **Settimanale** e **Filtra** sono sopra.
Seleziona **Altri report** per aprire **Tutti i report**, che raggruppa ogni report:
| Gruppo | Report |
| --- | --- |
| **Vendite** | **Ricavi**, **Prodotti**, **Funnel**, **Canali** e **Obiettivi**. |
| **Clienti** | **Visitatori**, **Persone**, **Segmenti**, **Live** e **Mappa** quando è disponibile. |
| **Salute del negozio** | **Pagine**, **Eventi**, **Velocità ed errori**, **Sessioni**, **Registrazioni** e **Stato del tracciamento**. |
| **Configurazione** | **Tracciamento**, **Feature flag**, **Dashboard personalizzate**, **API**, **Utilizzo** e **Impostazioni**. Aprirli non crea eventi. |
Cerca nell’elenco per nome del report, come **Funnel** o **Mappa**. Dentro un report, le schede passano agli altri report del suo gruppo e la freccia indietro torna alla panoramica.
1. Controlla il periodo sopra il grafico.
2. Leggi insieme i numeri in alto. Un tasso di acquisto dice poco senza il numero di visitatori accanto.
3. Seleziona **Report di questa settimana** per l’ultima settimana completa: ricavi per dispositivo, visite e giorni prima dell’acquisto, gli orari di acquisto e i paesi principali.
4. Seleziona **Altri report** e apri il report della tua domanda, ad esempio **Canali** per sapere da dove arrivano gli acquirenti.
Un negozio nuovo mostra **Nuovo negozio** e un conteggio delle visite finché non sono arrivate abbastanza persone per disegnare i grafici. Il badge **Dati di esempio · non è il tuo negozio** indica che i numeri sono un esempio, non i tuoi risultati. Un pannello con **In arrivo** non ha ancora una fonte di dati; non è un problema del tuo negozio.
## Se vedi la dashboard precedente [#if-you-see-the-earlier-dashboard]
Usa il selettore dell'intervallo e leggi insieme **Vendite Nette**, **GMV**, **Sessioni** e **Tasso di conversione**. Scorri alle sezioni prodotti, fonti, funnel, abbandoni e rimborsi.
## Risoluzione dei problemi
| Stato | Passaggio successivo |
| --- | --- |
| Trattino, zero o grafico vuoto | Rimuovi i filtri facoltativi, prova un periodo più lungo e verifica l'esistenza di visite o ordini reali. |
| Avviso di upgrade o anteprima del piano | Controlla l'accesso in Piano e fatturazione prima di diagnosticare la raccolta. |
| Report in caricamento | Attendi la fine della richiesta prima di cambiare nuovamente i filtri. |
| Un report contiene dati e un altro no | Controlla gli eventi richiesti da ciascuno. Le visite possono precedere gli ordini. |
| Il report non si carica | Ricarica una volta e conserva nome del report, periodo ed errore se fallisce ancora. |
| **Questo pannello non si è caricato.** | Seleziona **Riprova** se compare, oppure ricarica la pagina. Gli altri pannelli mostrano ancora i tuoi dati. |
| Voce di navigazione assente | Espandi **Misura** e controlla lo spazio selezionato. Consulta [Disponibilità delle funzioni](../advanced/feature-availability). |
## Guide correlate
- [Metriche e filtri](./metrics-filters)
- [Traffico e conversione](./traffic-and-conversion)
- [Risolvi i problemi di dati e pubblicazione](./troubleshoot-data-and-publication)
---
# Backlink e audit del sito
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/backlinks-and-site-audit
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
I Backlink e l'Audit del sito ti aiutano a ispezionare i riferimenti fuori sito e i problemi tecnici in sito dallo stesso workspace SEO.
> **Condizionale:** Entrambe le sezioni richiedono un target analizzato idoneo. I dati di link e scansione possono essere incompleti e i risultati facoltativi di Lighthouse dipendono da un controllo di pagina riuscito.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **SEO** → scheda **Backlink** o **Stato del sito** → **Apri**. Il report tecnico può chiamarsi **Audit del sito** nella vista aperta.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un nuovo negozio deve soddisfare il prerequisito di pubblicazione SEO prima di usare i report. L'anteprima con dati di esempio è illustrativa: non mostra risultati di analisi.
## Prima di iniziare
Se SEO mostra la lista di configurazione del primo negozio, completa la pubblicazione prima di aspettarti dati nei report. I valori **Anteprima · dati di esempio** non sono risultati del negozio. I passaggi seguenti valgono quando il relativo report diventa disponibile.
- Pubblica e apri la vetrina target con successo.
- Completa l'analisi SEO iniziale.
- Decidi se hai bisogno del contesto dei link, di una scansione tecnica o di entrambi.
- Non rimuovere o reindirizzare le pagine solo da un'etichetta di problema automatizzata; ispeziona prima la pagina interessata.
## Controlli e risultati dei backlink
| Controllo o sezione | Cosa mostra o fa |
| --- | --- |
| **Backlink** | Apre link totali, domini di riferimento, domini principali e pagine collegate principali. |
| Visualizzazione Follow / Nofollow | Separa i tipi di link quando il provider include quell'informazione. |
| Cronologia Nuovo / Perso | Mostra i cambiamenti di link registrati dal provider. |
| Backlink interrotti | Elenca i link che sembrano portare a una destinazione non disponibile. |
| Punteggio spam | Fornisce un segnale del provider per la revisione; non è la prova che un dominio sia dannoso. |
| **Chiedi a Runner di controllare questi** | Apre una nuova conversazione Runner con le prove di backlink salvate e una richiesta di controllo. Non rimuove link o modifica il negozio. |
## Controlli e risultati dell'audit del sito
| Controllo o sezione | Cosa mostra o fa |
| --- | --- |
| **Avvia nuovo audit** | Apre la configurazione della scansione. Non modifica la vetrina. |
| Controllo pagine massime | Limita quanto del sito pubblico l'audit tenta di scansionare. |
| **Includi Lighthouse** | Aggiunge controlli di prestazioni, accessibilità, best practice e SEO supportati. |
| **Esegui audit** | Avvia la scansione configurata. |
| **Problemi** | Elenca i risultati raggruppati in modo da poter aprire la spiegazione, la raccomandazione e le pagine interessate. |
| **Pagine** | Mostra ogni URL scansionato con stato, titolo, H1, conteggio parole, conteggio immagini e tempo di risposta. |
| **Risolvi tutto con Runner** | Apre una nuova conversazione Runner con le prove di audit salvate e una richiesta di correzione ampia. Non modifica o pubblica il negozio di per sé. |
| Riga del problema | Apre il motivo per cui il problema è importante, la raccomandazione e le pagine interessate. |
| **Risolvi con Runner** | Apre una nuova conversazione Runner con il problema selezionato, gli URL interessati e una richiesta di correzione. Non modifica o pubblica il negozio di per sé. |
## Esegui un audit mirato
1. Apri **Audit del sito**.
2. Seleziona **Avvia nuovo audit**.
3. Scegli un limite di pagine appropriato per il negozio pubblico.
4. Abilita Lighthouse solo quando hai bisogno dei controlli di qualità della pagina extra.
5. Seleziona **Esegui audit** e attendi il completamento.
6. Usa **Problemi** per iniziare con i risultati ad alto impatto, quindi usa **Pagine** per ispezionare gli URL interessati e i dati a livello di pagina.
7. Apri un problema e verifica manualmente le sue pagine interessate.
8. Usa **Risolvi con Runner** per un risultato appropriato, o **Risolvi tutto con Runner** per una richiesta di revisione ampia; entrambi aprono una conversazione Runner e richiedono di rivedere qualsiasi lavoro proposto prima di accettare o pubblicare modifiche.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Nessun backlink | Il provider non ha trovato dati di link per il target; questo non è la prova che non esistono link. |
| Link perso | Il provider non vede più un link precedente. Apri la fonte e la destinazione prima di agire. |
| Scansione non riuscita | Conferma che l'URL pubblico è raggiungibile e non bloccato, quindi esegui un audit più piccolo. |
| Lighthouse non disponibile | Usa i risultati della scansione che si sono completati e riprova il controllo facoltativo più tardi. |
| Il conteggio dei problemi è zero | Nessun problema corrispondente è stato restituito da questo audit; continua la revisione normale della vetrina. |
## Esamina i risultati esistenti prima di un'altra scansione
1. Apri **Backlink** per esaminare link e domini di provenienza disponibili.
2. Torna alla panoramica SEO e apri **Stato del sito**.
3. Se esiste un audit, seleziona un problema e leggi raccomandazione e URL interessati.
4. Apri una pagina pubblica interessata e controlla che il problema si applichi.
5. Se compare una coda di correzioni, esamina quella selezionata prima di affidarla a Runner.
**Verifica:** hai un URL interessato, evidenze a supporto e una correzione proposta. Selezionare un risultato o aprire una conversazione con Runner non applica né pubblica la correzione.
## Guide correlate
- [Panoramica SEO](./seo-overview)
- [Prestazioni di ricerca](./search-performance)
- [Risolvi i problemi di dati e pubblicazione](./troubleshoot-data-and-publication)
---
# Metriche e filtri
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/metrics-filters
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa gli stessi periodi e filtri per confrontare in modo significativo traffico, ordini e vendite.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Analytics** → controlli dei report.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEkGsXzhdR6T0uwqnz73letZimQpFvYfSrhLM)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Scegli Ultime 24 ore, Ultimi 7 giorni o Ultimi 30 giorni nel menu delle date di Analytics a pagina unica.
## Prima di iniziare
- Decidi a quale domanda deve rispondere il periodo: attività attuale, ultima settimana o tendenza più ampia.
- Una giornata attuale incompleta non è direttamente confrontabile con una giornata passata completa.
- I filtri variano in base al report e al layout Analytics disponibile nello spazio di lavoro.
## Controlli e risultati dei clic
Controlla prima il layout visibile. La dashboard a pagina unica offre **Ultime 24 ore**, **Ultimi 7 giorni** e **Ultimi 30 giorni**. Se invece vedi **Analisi del negozio online**, usa i controlli seguenti:
| Controllo | Risultato |
| --- | --- |
| **Oggi** / **Ieri** | Seleziona il giorno attuale o precedente. |
| **7g** / **30 g** | Seleziona un intervallo settimanale o mensile recente. |
| Date personalizzate | Permette di scegliere data iniziale e finale del report. |
| **Confronta**, se disponibile | Aggiunge o rimuove un periodo di confronto. |
| **Segmento**, se disponibile | Restringe il report al pubblico selezionato. |
| Filtri aggiuntivi | Restringono eventi o record corrispondenti. Usa solo le condizioni necessarie e rispetta il limite indicato nel modulo. |
Se lo spazio mostra la dashboard precedente, il selettore offre **Ultime 24 ore**, **Ultimi 7 giorni** e **Ultimi 30 giorni**.
### Controlli accanto ad Altri report
Se la pagina Analisi mostra **Report di questa settimana** e **Altri report** sopra il grafico, usa questi controlli:
| Controllo | Risultato |
| --- | --- |
| Periodo | Scegli **Oggi**, **Ieri**, **Ultimi 7 giorni**, **Ultimi 30 giorni**, **Ultimi 90 giorni**, **Questo mese** o **Personalizzato…**. Le frecce passano al periodo precedente o successivo. |
| Opzione di confronto nel periodo | Mostra ogni numero accanto al periodo di uguale durata appena prima. Con 30 giorni l’opzione si chiama **Confronta con i 30 giorni precedenti**. |
| **Filtra** | Restringe i report per **Fonte**, **Paese**, **Dispositivo** o **Prodotto visto**. Il pulsante in basso mostra quanti visitatori corrispondono, ad esempio **Mostra 136 visitatori**; selezionalo per applicare il filtro. |
| Chip dei filtri | Ogni filtro attivo compare sopra il report, accanto a un conteggio come **40 visitatori su 136**. Rimuovilo dal suo chip o seleziona **Cancella tutto**. |
| **Giornaliero** / **Settimanale** | Cambia come il grafico dell’andamento raggruppa i giorni. |
**Prodotto visto** tiene i visitatori che hanno guardato quel prodotto, quindi ogni report descrive quei clienti. Alcuni report, come **Prodotti** e **Live**, ignorano il periodo o i filtri; lì quei controlli sono nascosti.
## Confronta un periodo
1. Apri il report e scegli **Ultimi 7 giorni** o **Ultimi 30 giorni** nella dashboard a pagina unica. Nell'area raggruppata scegli **7g**, **30 g** o date personalizzate.
2. Attendi l'aggiornamento e controlla che l'etichetta delle date corrisponda alla scelta.
3. Abilita **Confronta**, se disponibile, e controlla quale periodo usa.
4. Applica un segmento o filtro solo se la domanda riguarda quel pubblico o evento.
5. Controlla che la condizione selezionata resti visibile prima di interpretare i dati.
6. Rimuovi la condizione e disattiva il confronto per tornare alla vista più ampia.
**Verifica:** sai indicare date e condizioni che hanno prodotto i dati mostrati. Rimuovere i filtri deve ripristinare la ricerca più ampia, anche se entrambe sono vuote.
## Leggi le metriche insieme ai conteggi
- Controlla sessioni e acquisti registrati prima di interpretare le percentuali di conversione.
- Leggi GMV e vendite nette separatamente: descrivono misure diverse delle vendite.
- Un forte cambio percentuale su un campione piccolo richiede altre evidenze.
- Allinea durata, filtri e definizioni delle metriche prima di confrontare un altro servizio.
## Risoluzione dei problemi
| Stato | Passaggio successivo |
| --- | --- |
| Il nuovo periodo è ancora vuoto | Rimuovi i filtri e verifica che il negozio abbia avuto attività pertinente nel periodo. |
| Un filtro non è disponibile | Usa i controlli supportati dal report; non presumere che tutte le viste abbiano gli stessi campi. |
| Limite dei filtri raggiunto | Rimuovi una condizione superflua prima di aggiungerne un'altra. |
| I valori cambiano in modo inatteso | Ricontrolla date personalizzate, segmento attivo, confronto e ordini o rimborsi insoliti. |
| Il report non si aggiorna | Ricarica una volta e conserva periodo selezionato ed errore visibile per l'assistenza. |
## Guide correlate
- [Panoramica di Analytics](./analytics-overview)
- [Traffico e conversione](./traffic-and-conversion)
- [Risoluzione dei problemi di dati e pubblicazione](./troubleshoot-data-and-publication)
---
# Prompt, parole chiave e citazioni
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/prompts-keywords-citations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le sezioni di dettaglio della visibilità AI ti aiutano a imparare quali domande fanno emergere il tuo marchio e quali fonti supportano le risposte disponibili.
> **Condizionale:** Prompt Explorer e i suoi modelli possono essere limitati dal piano o dal provider. L'esecuzione di un prompt richiede un nuovo output del modello e può utilizzare capacità a pagamento; rivedi l'avviso dell'area di lavoro corrente prima di eseguirlo.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **SEO** → **Visibilità IA** → **Apri** → **Prompt**, **Parole chiave** o **Citazioni**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un nuovo negozio deve soddisfare il prerequisito di pubblicazione SEO prima di usare i report. L'anteprima con dati di esempio è illustrativa: non mostra risultati di analisi.
## Prima di iniziare
Se SEO mostra la lista di configurazione del primo negozio, completa la pubblicazione prima di aspettarti dati nei report. I valori **Anteprima · dati di esempio** non sono risultati del negozio. I passaggi seguenti valgono quando il relativo report diventa disponibile.
- Completa la configurazione della visibilità AI.
- Scrivi una domanda dell'acquirente focalizzata.
- Seleziona almeno un modello disponibile.
- Usa la ricerca web solo quando desideri che il modello consulti fonti pubbliche attuali.
## Controlli e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Campo prompt | Accetta la domanda da testare e avvisa quando l'input è troppo lungo. |
| Selettore modello | Sceglie quali risposte del modello disponibile richiedere. |
| **Consenti ricerca web** | Consente ai modelli supportati di consultare fonti web pubbliche per questa esecuzione. |
| Evidenziazione marchio | Dice alla visualizzazione dei risultati quale menzione del marchio evidenziare. Non forza il modello a menzionare il marchio. |
| **Esegui Prompt Explorer** | Avvia le richieste del modello selezionato. Non modifica il negozio o salva un miglioramento della visibilità. |
| **Prompt** | Mostra le domande tracciate o esplorate e i loro risultati disponibili. |
| **Parole chiave** | Mostra i termini associati al dataset di visibilità AI. |
| **Citazioni** | Mostra le fonti citate nelle risposte del modello disponibile. |
| **Menzioni** | Mostra le risposte o i record in cui è stato rilevato il marchio tracciato. |
## Esplora una domanda dell'acquirente
1. Apri **Prompt**.
2. Inserisci una domanda in linguaggio naturale che un acquirente potrebbe fare.
3. Seleziona il modello o i modelli disponibili di cui hai bisogno.
4. Decidi se abilitare **Consenti ricerca web**.
5. Facoltativamente scegli il marchio tracciato per l'evidenziazione.
6. Seleziona **Esegui Prompt Explorer** una volta.
7. Attendi che ogni modello richiesto finisca o fallisca.
8. Confronta la risposta, lo stato **Marchio menzionato** o **Marchio non menzionato**, le citazioni e le query correlate.
9. Apri **Parole chiave** e **Citazioni** per trovare argomenti e fonti ricorrenti.
## Interpreta i risultati in modo sicuro
- Una risposta è un campione, non una classifica stabile.
- "Marchio non menzionato" descrive quella risposta, non ogni possibile risposta.
- Una citazione significa che il modello ha fatto riferimento a una fonte; non significa che Runner approvi la fonte.
- I risultati con ricerca web disattivata e con ricerca web attivata rispondono a domande diverse e non devono essere trattati come test identici.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Pulsante Esegui disabilitato | Inserisci un prompt valido e seleziona almeno un modello. |
| Un modello fallisce | Usa i risultati del modello completato e riprova il provider non riuscito in seguito. |
| Nessuna citazione | La risposta potrebbe non aver utilizzato o restituito fonti pubbliche. Riprova con la ricerca web solo se corrisponde al tuo obiettivo. |
| Risultati non correlati | Rendi il prompt più specifico riguardo al prodotto, al pubblico o all'esigenza di acquisto. |
| Errore di accesso al provider | Scegli un modello disponibile o chiedi a un proprietario dell'area di lavoro informazioni sull'accesso. |
## Esamina prima le evidenze salvate
1. Apri **Visibilità IA** dalla panoramica SEO e scegli **Citazioni**.
2. Esamina una fonte disponibile e la risposta associata. Segui il link della fonte, se presente.
3. Torna a Runner e confronta la fonte con il prompt o la parola chiave correlati.
4. Avvia una nuova esecuzione di **Esplora prompt** solo se la ricerca salvata non risponde alla domanda.
**Verifica:** sai individuare risposta e pagina citata dietro un risultato. Una ricerca del marchio salvata e una nuova esecuzione di Esplora prompt sono campioni separati; aprire evidenze salvate non esegue un altro prompt.
## Guide correlate
- [Visibilità AI](./ai-visibility)
- [Prestazioni di ricerca](./search-performance)
- [Risoluzione dei problemi di dati e pubblicazione](./troubleshoot-data-and-publication)
---
# Prestazioni di ricerca
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/search-performance
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le prestazioni di ricerca ti aiutano a identificare quali query e pagine sembrano più importanti nei dati disponibili per Runner.
> **Condizionale:** Queste stime appaiono solo dopo che un'analisi SEO idonea restituisce dati del provider. Un dominio nuovo o con poco traffico potrebbe avere pochi o nessun dato.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **SEO** → scheda **Prestazioni nella ricerca** → **Apri**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un nuovo negozio deve soddisfare il prerequisito di pubblicazione SEO prima di usare i report. L'anteprima con dati di esempio è illustrativa: non mostra risultati di analisi.
## Prima di iniziare
Se SEO mostra la lista di configurazione del primo negozio, completa la pubblicazione prima di aspettarti dati nei report. I valori **Anteprima · dati di esempio** non sono risultati del negozio. I passaggi seguenti valgono quando il relativo report diventa disponibile.
- Completa un'analisi SEO riuscita per il target pubblico.
- Usa il dominio analizzato mostrato da Runner, soprattutto quando il progetto ha più di un dominio.
- Leggi le stime del provider come segnali direzionali; potrebbero non corrispondere esattamente alle analitiche di prima parte.
## Sezioni principali
| Sezione | Cosa significa |
| --- | --- |
| Traffico organico stimato | Una stima del provider di visite dalla ricerca non a pagamento. |
| Parole chiave organiche | Termini di ricerca per i quali il dominio ha dati di visibilità disponibili. |
| Classificazione del dominio | Una misura di autorità o visibilità comparativa dal provider disponibile. |
| Prime 3 parole chiave | Parole chiave stimate per classificarsi vicino alla parte superiore dei risultati di ricerca. |
| **Parole chiave principali** | Query con le loro informazioni di posizione o traffico disponibili. |
| **Pagine principali** | Pagine pubbliche che ricevono la visibilità organica stimata più forte. |
| **Chiedi a Runner** | Crea una nuova conversazione Runner con le prove del rapporto salvato e una richiesta di miglioramento suggerita. Non modifica o pubblica il negozio da solo. |
| **Vedi 5 quick win** | Crea lo stesso passaggio Runner basato su prove in modo da poter chiedere opportunità prioritarie in chat. Rivedi qualsiasi lavoro proposto prima di applicarlo o pubblicarlo. |
| **Analizza di nuovo** | Richiede una nuova istantanea; non cambia contenuto o classificazione. |
## Rivedi le opportunità di ricerca
1. Apri **Prestazioni nella ricerca** dopo il completamento dell'analisi.
2. Conferma che il dominio analizzato è la vetrina pubblica che intendevi.
3. Leggi le metriche di riepilogo come base di riferimento, non come promessa.
4. Scansiona **Parole chiave principali** per i termini che corrispondono ai prodotti e al pubblico.
5. Apri o annota le **Pagine principali** corrispondenti.
6. Confronta il contenuto della pagina con la domanda dell'acquirente dietro ogni parola chiave utile.
7. Apporta modifiche alla vetrina tramite Runner o l'editor del negozio, quindi pubblicale separatamente.
8. Ritorna in seguito e seleziona **Analizza di nuovo** quando è trascorso abbastanza tempo affinché le fonti pubbliche cambino.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Nessun dato organico | Il provider potrebbe non avere informazioni sufficienti per il dominio. Conferma la pubblicazione e riprova in seguito. |
| Parola chiave ma nessuna pagina corrispondente | Apri l'elenco delle pagine e il sito pubblico; il provider potrebbe attribuire la query a un URL diverso. |
| La stima differisce da Analytics | Analytics registra gli eventi del negozio; SEO utilizza stime di ricerca esterne. Allinea la domanda prima di confrontarle. |
| Il contenuto appena pubblicato è assente | La scoperta di ricerca non è immediata. Conferma che la pagina è pubblica e attendi prima di aggiornare. |
## Scegli un miglioramento verificabile
Usa **Parole chiave** e **Pagine** nel report aperto per collegare una ricerca utile a una pagina pubblica. Se compare **Apri la coda di correzioni**, esamina la proposta e la pagina interessata prima di avviare il lavoro con Runner.
**Verifica:** sai indicare ricerca, pagina e modifica da controllare. I dati di ricerca esterni sono stime. Un collegamento facoltativo a Google Search Console può fornire clic diretti, quando disponibile; non è automatico e non va confuso con le stime.
## Guide correlate
- [Panoramica SEO](./seo-overview)
- [Backlink e audit del sito](./backlinks-and-site-audit)
- [Traffico e conversione](./traffic-and-conversion)
---
# Panoramica SEO
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/seo-overview
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
SEO ti aiuta a ispezionare come una vetrina pubblica può essere scoperta nei risultati di ricerca e nelle risposte generate da AI.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **SEO**. La panoramica **SEO e GEO** collega i singoli report.
## Se è la prima visita a SEO
Il tour introduttivo spiega lo spazio; **Salta il tour** apre la panoramica. Per un nuovo negozio, **Facciamo trovare il tuo negozio** mostra tre fasi: pubblicazione della vetrina, controlli AI automatici e monitoraggio automatico delle parole chiave. Inizia dalla pubblicazione.
Le metriche **Anteprima · dati di esempio** illustrano il formato del report. Non sono misure del tuo negozio. Le istruzioni seguenti valgono dopo la configurazione richiesta, quando sono disponibili risultati reali.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un nuovo negozio deve soddisfare il prerequisito di pubblicazione SEO prima di usare i report. L'anteprima con dati di esempio è illustrativa: non mostra risultati di analisi.
## Prima di iniziare
- Pubblica la vetrina a meno che Runner non offra un target personalizzato idoneo nella tua area di lavoro.
- Conferma che la pagina pubblica si carica prima di avviare l'analisi.
- Consenti tempo ai provider di ricerca e AI di avere dati su un sito appena pubblicato.
- Tratta l'analisi come un'istantanea delle fonti disponibili, non come una garanzia di classificazione o menzioni.
## Controlli principali e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Schede dei report nella panoramica → **Apri** | Apre **Prestazioni nella ricerca**, **Visibilità IA**, **Backlink** o **Stato del sito**. |
| Coda delle correzioni o pannello di revisione, se disponibile | Permette di esaminare una correzione proposta e le pagine interessate prima di iniziare. |
| **Prestazioni nella ricerca** | Apre le stime di traffico organico, parola chiave, classificazione, parola chiave principale e pagina principale. |
| **Backlink** | Apre i link, i domini di riferimento, la cronologia dei link e le visualizzazioni della qualità dei link. |
| **Audit del sito** | Apre i risultati di scansione tecnica e problemi. |
| Sezioni di visibilità AI | Apre il dashboard, i prompt, le parole chiave, le citazioni o le menzioni quando disponibili. |
| **Analizza** | Avvia l'analisi per il target idoneo. Non modifica o pubblica la vetrina. |
| **Analizza di nuovo** | Richiede un'analisi aggiornata e sostituisce i risultati obsoleti quando l'aggiornamento è completato. |
| **Pubblica** | Avvia il percorso di preparazione alla pubblicazione separato quando il negozio è ancora una bozza. |
| Google Search Console → **Connetti** | Apre **App** filtrate per Google Search Console quando quella connessione è disponibile. |
## Avvia una revisione SEO
1. Apri **Cresci** → **SEO** e controlla l'obiettivo nella panoramica.
2. Se vedi il gate di pubblicazione, usa il percorso di pubblicazione e ritorna solo dopo che l'URL live funziona.
3. Leggi prima i report esistenti. Seleziona **Analizza** solo se serve una nuova analisi, dopo aver letto l'avviso di consumo attuale.
4. Attendi il completamento dello stato di analisi; non avviare ripetutamente la stessa analisi.
5. Apri le schede **Prestazioni nella ricerca**, **Backlink** e **Stato del sito** per esaminare i report disponibili.
6. Torna alla panoramica, apri **Visibilità IA** ed esamina le sezioni di dettaglio disponibili.
7. Esegui di nuovo con **Analizza di nuovo** dopo modifiche pubbliche significative o quando Runner contrassegna il risultato come obsoleto.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Gate di pubblicazione | La vetrina corrente non è idonea per l'analisi pubblica. Pubblica e verifica prima l'URL live. |
| Analisi in corso | Runner sta raccogliendo i dati disponibili. Attendi il completamento. |
| Aggiornato | L'istantanea visualizzata è stata completata con successo. |
| Obsoleto | I dati pubblici potrebbero essere cambiati; usa **Analizza di nuovo** quando un aggiornamento è utile. |
| Risultato parziale | Alcuni provider hanno restituito dati e altri no. Usa le sezioni disponibili e riprova in seguito. |
| Target non raggiungibile | L'analizzatore non ha potuto caricare la pagina pubblica. Apri l'URL pubblico direttamente, risolvi i problemi di accesso o pubblicazione, quindi analizza di nuovo. |
## Guide correlate
- [Prestazioni di ricerca](./search-performance)
- [Backlink e audit del sito](./backlinks-and-site-audit)
- [Visibilità AI](./ai-visibility)
- [Risoluzione dei problemi di dati e pubblicazione](./troubleshoot-data-and-publication)
---
# Traffico e conversione
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/traffic-and-conversion
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le visualizzazioni di traffico e conversione ti aiutano a vedere dove arrivano gli acquirenti, quanto progrediscono e dove un percorso potrebbe aver bisogno di attenzione.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Analytics** → **Panoramica**, **Commercio** o **Comportamento** nell'area raggruppata. Nella dashboard precedente, scorri sotto le schede riepilogative.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvR648EFhEHcK82Y0dyL6sSr9NUGjnQeMWZJk)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Layout Analytics a pagina unica in un negozio tutorial senza attività registrata. L'illustrazione diagnostica Alpha non dimostra un problema del negozio.
## Prima di iniziare
- Seleziona un intervallo di tempo e mantienilo attivo mentre confronti le sezioni.
- Il negozio ha bisogno di sessioni registrate per l'analisi del traffico e ordini per l'analisi di vendite o rimborsi.
- Usa l'imbuto come prova di dove ispezionare, non come prova del motivo per cui gli acquirenti se ne sono andati.
## Apri il report adatto alla tua domanda
Nella dashboard a pagina unica, mantieni lo stesso periodo e scorri a **Sessioni Traffico**, fonti, vendite nel tempo, funnel, abbandoni e rimborsi. Le destinazioni raggruppate seguenti valgono solo quando lo spazio mostra la nuova area Analytics.
| Domanda | Destinazione nell'area Analytics |
| --- | --- |
| Dove si interrompe l'acquisto? | **Commercio** → report del funnel |
| Quali prodotti o fonti hanno contribuito? | **Commercio** → report prodotti o acquisizione |
| Quale pagina o percorso va esaminato? | **Comportamento** → report pagine o percorsi |
Usa **Vedi dettagli** dalla panoramica quando collega il report pertinente. Disponibilità e dati variano da negozio a negozio.
Se la pagina Analisi mostra **Report di questa settimana** e **Altri report** sopra il grafico, apri invece questi report da **Altri report**:
| Domanda | Report |
| --- | --- |
| Dove si è fermato l’acquisto? | **Funnel** |
| Quali canali e campagne hanno portato acquirenti? | **Canali**. Passa tra **Ultimo clic** e **Prima visita** per confrontare quale visita riceve il merito. |
| Quali prodotti vendono, e da dove? | **Prodotti**, poi seleziona un prodotto per vederne fonti, luoghi e prodotti acquistati insieme. |
| Quali fonti e pagine di ingresso trasformano le visite in ordini? | **Visitatori**. Leggi il tasso di acquisto di ogni fonte accanto al suo numero di visite. |
| Dove vivono gli acquirenti? | **Mappa** |
| Da quale pagina se ne vanno le persone? | **Pagine** → **Pagine di uscita** |
## Sezioni e risultati dei clic
| Sezione o controllo | Cosa mostra o fa |
| --- | --- |
| **Sessioni Traffico** | Mostra la tendenza delle visite nel periodo selezionato. |
| Visualizzazione fonte di vendita | Suddivide le vendite registrate per fonte quando i dati di origine sono disponibili. |
| Visualizzazione vendite nette del prodotto | Confronta il contributo del prodotto alle vendite nette. |
| Imbuto **Tasso di conversione** | Mostra il progresso attraverso **Traffico**, **Aggiungi al carrello**, **Checkout** e **Acquisto**. |
| **Tasso di abbandono del carrello della spesa** | Riassume i carrelli che non hanno raggiunto un acquisto completato. |
| **Tasso di rimborso** | Mostra l'attività rimborsata per la finestra di reporting. |
| Selettore intervallo di tempo | Ricalcola ogni sezione per il nuovo periodo. |
## Diagnostica un calo di conversione
1. Scorri al funnel nella dashboard a pagina unica oppure apri il report **Commercio** pertinente nell'area raggruppata. Seleziona un periodo con sessioni sufficienti. Se non ci sono dati, controlla raccolta e periodo prima di diagnosticare la conversione.
2. Verifica se il traffico è aumentato, diminuito o è rimasto stabile.
3. Confronta le fonti di traffico per vedere se il mix è cambiato.
4. Trova il calo più grande tra le fasi dell'imbuto adiacenti.
5. Se **Traffico → Aggiungi al carrello** cala, ispeziona le informazioni sul prodotto, i prezzi, la fiducia e la chiarezza della pagina del prodotto.
6. Se **Aggiungi al carrello → Checkout** cala, ispeziona i costi del carrello, la chiarezza della spedizione e il percorso verso il checkout.
7. Se **Checkout → Acquisto** cala, testa il percorso di pagamento e checkout senza effettuare un ordine reale non necessario.
8. Rivedi i rimborsi separatamente in modo che i problemi post-acquisto non siano nascosti all'interno delle vendite di primo livello.
**Verifica:** indica fase, pagina, periodo e conteggio a supporto prima di proporre una modifica. Apri la pagina della vetrina interessata per verificare la spiegazione: il funnel indica dove cercare, non la causa del calo.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| La fase dell'imbuto è zero | Nessun evento corrispondente ha raggiunto quella fase nell'intervallo selezionato. Conferma il tracciamento con una passeggiata sicura della vetrina. |
| Il traffico esiste ma le vendite no | Il negozio ha ricevuto visite senza un acquisto registrato. Ispeziona il primo grande calo dell'imbuto. |
| Le vendite esistono ma la fonte è vuota | L'attribuzione della fonte non era disponibile per quelle vendite; non assegnare una fonte per indovinare. |
| Il tasso di rimborso cambia drasticamente | Verifica il periodo dell'ordine sottostante e il numero di ordini prima di trarre una conclusione. |
| I grafici non concordano con un altro servizio | Allinea intervalli di date, fusi orari, definizioni di eventi e filtri prima di confrontare i totali. |
## Guide correlate
- [Metriche e filtri](./metrics-filters)
- [Panoramica di Analytics](./analytics-overview)
- [Prestazioni di ricerca](./search-performance)
---
# Risoluzione dei problemi di dati e pubblicazione
Source: https://www.runnerai.com/docs/it/guides/analytics-and-seo/troubleshoot-data-and-publication
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa questa pagina per identificare se un risultato mancante proviene dallo stato del negozio, dall'intervallo di date, dall'accesso al piano, dall'accesso alle funzioni o da un'origine dati esterna.
## Percorsi di accesso
- Progetto di negozio → **Misura** → **Analytics** per i dati degli eventi del negozio.
- Progetto di negozio → **Cresci** → **SEO** per dati di ricerca pubblica e visibilità AI.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Questo requisito di pubblicazione spiega perché un nuovo negozio non ha report SEO. I dati di esempio non sono un'analisi completata.
## Prima di iniziare
- Annota la pagina esatta, il negozio, il periodo selezionato e il messaggio visibile.
- Verifica se il problema riguarda una sezione o l'intera pagina.
- Per SEO, apri la vetrina pubblica direttamente prima di avviare un'altra analisi.
- Per Analytics, conferma che il periodo selezionato potrebbe contenere l'evento che ti aspetti.
## Controlli e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Intervallo di tempo di Analisi | Aggiorna il rapporto per il periodo selezionato; non crea eventi di traffico o ordini mancanti. |
| **Analizza** | Avvia l'analisi SEO o di visibilità AI disponibile per il target pubblico corrente. |
| **Analizza di nuovo** | Richiede una nuova istantanea dopo una modifica significativa del sito pubblico. |
| **Riprova** | Ripete la sezione o la richiesta non riuscita quando offerta; non risolve i prerequisiti di pubblicazione, accesso o provider. |
## Risoluzione dei problemi
| Cosa vedi | Significato probabile | Passaggio successivo |
| --- | --- | --- |
| Schermata di aggiornamento o piano | Il piano corrente non include la pagina. | Rivedi l'accesso al piano; i ricaricamenti ripetuti non lo sbloccheranno. |
| La voce di navigazione è mancante | La funzione non è abilitata per questa area di lavoro. | Trattala come condizionale e chiedi a un proprietario dell'area di lavoro o al supporto. |
| **Pubblica la tua vetrina per iniziare l'analisi** | SEO non ha un target pubblico idoneo. | Completa la pubblicazione, apri l'URL live, quindi ritorna a SEO. |
| Dashboard Analytics, zero o grafico vuoto | Nessun evento corrispondente esiste per il periodo selezionato. | Prova una finestra più lunga e verifica che il negozio abbia visite o ordini. |
| **Nuovo negozio** con un conteggio delle visite | I grafici partono quando sono arrivate abbastanza persone perché i numeri abbiano senso. | Condividi il link del negozio; il conteggio mostra quante visite mancano. |
| **Dati di esempio · non è il tuo negozio** | La pagina mostra numeri di esempio, non i tuoi risultati. | Se hai selezionato **Visualizza dati di esempio**, seleziona **Torna ai dati del progetto**. Se la pagina offre **Passa a Pro**, il tuo piano non include questi report e gli esempi restano finché non passi a Pro. |
| **In arrivo** su un pannello | Quel pannello non ha ancora una fonte di dati. | Usa gli altri pannelli; non è un problema del negozio o del tracciamento. |
| **Questo pannello non si è caricato.** | Una richiesta non è riuscita. | Seleziona **Riprova** se compare, oppure ricarica la pagina. Gli altri pannelli mostrano ancora i tuoi dati. |
| Target non raggiungibile | L'analizzatore non ha potuto caricare la pagina pubblica. | Apri l'URL esatto direttamente e risolvi i problemi di pubblicazione, dominio o accesso. |
| Dati insufficienti | Il provider non può restituire una stima utile ancora. | Mantieni il sito pubblico e riprova dopo più attività o scoperta pubblica. |
| Sezioni parziali | Alcuni provider hanno completato e altri no. | Usa i risultati completati; riprova solo la sezione mancante in seguito. |
| Etichetta obsoleta | L'istantanea salvata potrebbe non riflettere più il sito pubblico. | Seleziona **Analizza di nuovo** dopo modifiche significative. |
## Verifica i dati di Analisi
1. Apri **Analisi** e annota il periodo selezionato.
2. Scegli **30 g** (o **Ultimi 30 giorni** nel layout precedente), poi rimuovi i filtri facoltativi per escludere una ricerca troppo ristretta.
3. Conferma che il negozio live ha ricevuto sessioni reali.
4. Conferma che gli ordini o i rimborsi esistono prima di aspettarsi metriche di vendita o rimborso.
5. Confronta le fasi dell'imbuto per vedere quali eventi sono presenti.
6. Ricarica una volta. Se l'intera pagina continua a non funzionare, registra il negozio e l'ora per il supporto.
## Verifica la pubblicazione e l'analisi SEO
1. Apri la vetrina pubblica in una scheda separata.
2. Conferma che si carica senza un'anteprima privata o un requisito di accesso.
3. Ritorna a **SEO** e conferma il dominio o il target previsto.
4. Seleziona **Analizza** o **Analizza di nuovo** una volta.
5. Attendi un risultato terminale invece di avviare lavori ripetuti.
6. Se una sezione fallisce, conserva le sezioni riuscite e riprova in seguito.
## Cosa una configurazione riuscita non prova
- La pubblicazione non garantisce l'indicizzazione della ricerca.
- L'indicizzazione della ricerca non garantisce traffico o una posizione in alto.
- La configurazione della visibilità AI non garantisce una menzione.
- Un'esecuzione di prompt riuscita non prevede ogni risposta futura del modello.
- Un evento di Analytics non spiega perché un acquirente ha agito.
## Separa accesso ai report e raccolta
Espandi **Misura** o **Cresci** prima di considerare assente una voce. L'anteprima del piano non è un report reale. Nell'area Analytics, **Configura** contiene strumenti di tracciamento e impostazioni; aprirla non crea eventi dei clienti. Controlla negozio, periodo, filtri e attività reale prima di modificare la raccolta.
**Verifica:** identifica se l'accesso è bloccato, la ricerca è vuota o una richiesta specifica è fallita. Un report vuoto da solo non distingue assenza di attività e raccolta mancante.
## Guide correlate
- [Panoramica di Analytics](./analytics-overview)
- [Panoramica SEO](./seo-overview)
- [Visibilità AI](./ai-visibility)
- [Documentazione di Runner](../product-guide)
---
# App e integrazioni
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le app portano i servizi del tuo negozio e le app Agent opzionali in un unico posto. Usalo quando desideri che Runner accetti pagamenti, invii email del negozio, lavori con provider di spedizione o adempimento, connetta Shopify o consenta all'Agent di utilizzare un altro servizio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
La pagina mostra gli stati delle connessioni esistenti e i controlli disponibili. Aprirla non crea una connessione.
## Apri le app
Da un negozio aperto, seleziona **App** nella navigazione del progetto.
**Percorso di accesso:** **Progetto → App**
La pagina può mostrare due sezioni:
- **Gestisci il tuo negozio** contiene i servizi usati dalla vetrina e dalle operazioni del negozio.
- **Collega i tuoi strumenti** contiene i servizi che l'Agente Runner può usare durante il lavoro.
Le app Agent e Shopify sono condizionali. Potrebbero essere nascoste o non disponibili per alcune aree di lavoro. I requisiti del provider possono anche impedire a una scheda visibile di essere connessa.
## Controlli della pagina
| Controllo o stato | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Cerca strumenti** | Trova un servizio senza esaminare tutte le schede. | Runner filtra il catalogo; svuotando il campo ripristini l'elenco. |
| **Connetti** | Avvia una nuova connessione. | Runner apre la finestra di dialogo delle credenziali specifica del provider o il flusso di autorizzazione. La connessione non è completa fino a quando la scheda non cambia stato. |
| **Connessione in corso...** | Mostra che Runner sta elaborando la richiesta. | L'azione rimane non disponibile fino a quando la richiesta non riesce, non ha esito negativo o non viene annullata al di fuori di Runner. |
| **Connesso** o un'azione connessa | Conferma che Runner riconosce la connessione. | Le schede specifiche del provider possono esporre un collegamento al dashboard, un controllo di disconnessione, un interruttore o una finestra di dialogo di gestione. |
| **Gestisci** | Apre una connessione dell'app Agent esistente. | Puoi rivedere i suoi strumenti o disconnetterlo. |
| **Riconnetti** | Ripara una connessione che ha bisogno di autorizzazione di nuovo. | Runner riavvia il flusso di connessione del provider. |
| **In attesa di revisione** | Mostra che Stripe sta ancora rivedendo l'account. | Attendi che lo stato cambi o segui qualsiasi richiesta di azione mostrata sulla scheda. |
| Elimina o **Disconnetti** | Rimuove una connessione dopo la conferma. | L'avviso specifico del provider spiega quali progetti e azioni future saranno interessati. |
## Trova una connessione esistente o richiedi uno strumento
Usa la sezione **Collegati** per aprire un'app già connessa e consultarne i controlli. Per una nuova app dell'Agente, scorri a **Collega i tuoi strumenti** e usa **Cerca strumenti**. Svuota la ricerca prima di concludere che un'app manchi.
**Richiedi un’app** apre un modulo. Inviare una richiesta non collega il fornitore e non lo rende subito disponibile. Le connessioni CJ partono da [Dropshipping](/it/guides/apps-and-integrations/cj-dropshipping), non da una scheda App.
## Connetti un'app in modo sicuro
1. Apri **Progetto → App**.
2. Cerca il servizio o trovalo sotto **Gestisci il tuo negozio** o **Collega i tuoi strumenti**.
3. Seleziona **Connetti**.
4. Leggi la finestra di dialogo prima di inserire un dominio, una chiave API, un segreto o credenziali del provider.
5. Completa qualsiasi passaggio di autorizzazione sul sito del provider.
6. Torna alle app e controlla la scheda. Tratta solo uno stato connesso confermato, come un badge connesso o controlli connessi, come una connessione completata.
7. Se Runner mostra **Riconnetti**, **In attesa di revisione** o un avviso di azione, segui quello stato invece di ripetere ciecamente la configurazione iniziale.
:::warning
Non incollare mai chiavi API o segreti in una chat di Runner. Inseriscili solo nella finestra di dialogo di integrazione che li richiede.
:::
## Scegli una guida
- [Connetti, gestisci, ricollega o disconnetti un'app](/it/guides/apps-and-integrations/connect-manage-reconnect)
- [Connetti Stripe per i pagamenti](/it/guides/apps-and-integrations/stripe-payments)
- [Abilita l'email del negozio](/it/guides/apps-and-integrations/resend-email)
- [Connetti Shippo per la spedizione](/it/guides/apps-and-integrations/shippo-shipping)
- [Connetti Shopify](/it/guides/apps-and-integrations/shopify)
- [Collega CJ da Dropshipping](/it/guides/apps-and-integrations/cj-dropshipping)
- [Connetti l'adempimento 4PX](/it/guides/apps-and-integrations/4px-fulfillment)
- [Connetti e controlla le app Agent](/it/guides/apps-and-integrations/agent-apps)
- [Risolvi i problemi di connessione di un'app](/it/guides/apps-and-integrations/troubleshooting)
---
# Connetti l'evasione 4PX
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/4px-fulfillment
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Connetti 4PX quando desideri che Runner utilizzi il tuo account 4PX per la spedizione transfrontaliera e
l'evasione. Questa connessione richiede sia una chiave API che un segreto API.
## Prima di iniziare
**Percorso di accesso:** **Progetto → App → Gestisci il tuo negozio → 4PX**
Hai bisogno di:
- un account 4PX con una chiave API e un segreto API attuali;
- l'autorizzazione a usare quelle credenziali per questo negozio Runner; e
- la consapevolezza che la disconnessione rimuove entrambe le credenziali e disattiva 4PX solo per questo negozio. Gli altri negozi mantengono la propria connessione 4PX.
Tratta entrambi i campi come segreti. Non incollarli nella chat di Runner.
Su mobile, seleziona prima la riga del fornitore **4PX** per aprire i dettagli, poi usa i controlli della finestra. Un modulo visibile mostra solo da dove iniziare; i passaggi di connessione e utilizzo seguenti valgono dopo l'autorizzazione del servizio.
## Controlli e risultati 4PX
| Controllo | Perché è utile | Cosa accade dopo |
| --- | --- | --- |
| **Connetti** | Apre la configurazione 4PX. | Runner chiede **Chiave API 4PX** e **Segreto API 4PX**. |
| Campi chiave API e segreto | Identificano e autorizzano l'account 4PX. | Runner invia solo dopo che entrambi i campi contengono un valore. |
| Icone occhio | Aiutano a verificare un errore di digitazione in uno dei due campi. | Ogni icona attiva/disattiva indipendentemente quel campo tra testo nascosto e visibile. |
| **Connetti** della finestra di dialogo | Invia entrambe le credenziali. | Se ha successo, Runner cancella entrambi i campi, chiude la finestra di dialogo e contrassegna 4PX come connesso. |
| **Annulla** o chiudi | Si ferma prima dell'invio. | Runner cancella entrambi i campi dalla finestra di dialogo. |
| Elimina o **Disconnetti** | Avvia la rimozione. | Runner apre **Disconnetti 4PX?**. |
| **Disconnetti** di conferma | Rimuove le credenziali di questo negozio. | Runner disattiva 4PX per questo negozio. Gli altri negozi non sono interessati. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGp76tmTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Controlla i due campi delle credenziali prima di collegare il servizio. L'esempio si ferma prima dell'invio: non verifica evasione o spedizione.
## Connetti 4PX
1. Apri **Progetto → App**.
2. Trova **4PX** e seleziona **Connetti**.
3. Copia la chiave API e il segreto API dall'account 4PX che intendi utilizzare.
4. Incolla i valori in **Chiave API 4PX** e **Segreto API 4PX**.
5. Verifica che i due valori siano nei campi corretti.
6. Seleziona **Connetti**.
7. Attendi **4PX connesso con successo** e conferma che la scheda mostra il suo controllo di disconnessione.
8. Verifica uno scenario di spedizione transfrontaliera o evasione sicura prima di utilizzarlo per un ordine cliente live.
## Disconnetti o sostituisci le credenziali
Seleziona il controllo di disconnessione e leggi **Disconnetti 4PX?**. Conferma solo quando è accettabile disattivare 4PX per questo negozio. Gli altri negozi dello spazio di lavoro mantengono la propria connessione.
Per ruotare le credenziali, disconnetti la connessione corrente, conferma che la scheda non è più connessa, quindi riconnetti con la chiave e il segreto di sostituzione.
## Se 4PX non si connette
- Conferma che la chiave e il segreto provengono dallo stesso account 4PX.
- Ricopia entrambi i valori invece di modificare uno dei segreti per indovinare.
- **Impossibile connettere 4PX** significa che Runner non ha completato la connessione del provider. Verifica le credenziali in 4PX e riprova.
- Se la scheda si connette ma l'evasione fallisce, verifica l'accesso all'account, il supporto della destinazione e i dati dell'ordine richiesti da 4PX.
- Se la disconnessione fallisce, presumi che le credenziali correnti rimangono attive.
## Guide correlate
- [Connetti, gestisci e riconnetti un'app](./connect-manage-reconnect)
- [Connetti Shippo per la spedizione](./shippo-shipping)
- [Risoluzione dei problemi di una connessione app](./troubleshooting)
---
# Connetti e controlla le app Agent
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/agent-apps
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Le app Agent consentono all'Agent Runner di utilizzare un servizio esterno mentre lavora sul tuo progetto. Puoi ispezionare gli strumenti dell'app e disattivare gli strumenti che non desideri che l'Agent utilizzi.
## Prima di iniziare
**Percorso di accesso:** **Progetto → App → Collega i tuoi strumenti**
Le app Agent sono condizionali. La sezione può essere nascosta, un'app singola può non essere disponibile o il catalogo può non riuscire a caricarsi. La disponibilità può variare in base all'area di lavoro, al progetto, al provider e all'accesso al prodotto in fase.
Hai bisogno di:
- accesso al progetto;
- un account o una credenziale accettati dal provider selezionato; e
- autorizzazione per consentire a Runner di utilizzare gli strumenti che lasci abilitati.
Rivedi ogni strumento prima di connetterti. L'accesso agli strumenti si applica al progetto corrente e può consentire all'Agent di leggere o modificare i dati nel servizio esterno.
La connessione dell'account esterno appartiene al tuo account Runner con accesso effettuato, mentre gli interruttori degli strumenti vengono salvati per il progetto corrente. La disconnessione può quindi rimuovere la connessione utilizzata da altri progetti anche se le loro scelte di strumenti sono separate.
Parti da **Collega i tuoi strumenti**. Apri un'app, leggi l'elenco degli strumenti e chiudi i dettagli se vuoi solo confrontare le funzionalità. L'autorizzazione è una scelta separata: consultare gli strumenti non collega l'account esterno.
## Trova e ispeziona un'app
| Controllo o stato | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Cerca strumenti** | Filtra il catalogo degli strumenti. | Il catalogo mostra nomi e descrizioni corrispondenti. |
| Selettore di categoria | Restringe il catalogo delle app Agent. | Scegli **Tutto** per rimuovere il filtro di categoria. |
| **Precedente** e **Successivo** | Si sposta attraverso un catalogo lungo. | Runner mostra la pagina precedente o successiva delle app corrispondenti. |
| Scheda app | Mostra il nome dell'app, la descrizione e lo stato della connessione. | Selezionandola si apre **Dettagli app**. |
| **Nessun'app trovata** | Mostra che i filtri correnti non hanno corrispondenze. | **Cancella ricerca** ripristina la ricerca e la categoria. |
| Segnaposti di caricamento | Mostra che Runner sta recuperando il catalogo. | Attendi le schede prima di scegliere un'app. |
## Controlli dei dettagli dell'app
| Controllo o stato | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| Descrizione dell'app e categoria | Aiuta a confermare che hai aperto il servizio desiderato. | Nessun accesso esterno viene concesso visualizzando i dettagli. |
| Interruttore dello strumento | Limita ciò che Runner può chiedere all'app connessa di fare. | Prima di connetterti, Runner salva le tue scelte con la connessione. Dopo la connessione, una modifica viene salvata immediatamente. |
| **Precedente** e **Successivo** nell'elenco degli strumenti | Rivede le app con molti strumenti. | Si sposta attraverso gli strumenti senza chiudere la finestra di dialogo. |
| Campi credenziali richiesti | Supporta le app che non utilizzano l'autorizzazione del browser. | **Connetti** rimane non disponibile fino a quando i campi richiesti non vengono compilati. I campi simili a segreti sono mascherati. |
| **Connetti** | Invia le credenziali del provider quando quella strategia è richiesta. | Runner tenta la connessione con l'accesso agli strumenti scelto. |
| **Connetti e autorizza** | Avvia l'autorizzazione del provider. | Runner apre una finestra di autorizzazione. |
| **Connessione in corso...** | Mostra che l'autorizzazione è in corso. | L'azione rimane non disponibile fino a quando Runner riceve un risultato. |
| **Connesso** | Conferma che Runner riconosce l'account. | Chiudi la finestra di dialogo o gestisci l'accesso agli strumenti. |
| **Gestisci** | Riapre un'app connessa. | Rivedi e modifica i suoi strumenti abilitati o disconnettilo. |
| **Disconnetti** | Avvia la rimozione. | Runner chiede **Disconnettere? Runner perde l’accesso a questa app finché non la ricolleghi.** |
| **Annulla** o **Conferma** | Risolve l'avviso di disconnessione. | Annulla mantiene l'accesso; Conferma rimuove la connessione dell'app Agent a livello di account da Runner. Le impostazioni degli strumenti del progetto sono separate. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgkttueHjXIfFwWx7Qu1lJBZMSPHcazYdR0voC)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Esamina una pagina di strumenti alla volta con **Avanti**. Aprire l'elenco non autorizza Notion: **Connetti e autorizza** avvia quel passaggio separato.
## Connetti un'app Agent
1. Apri **Progetto → App** e scorri a **Collega i tuoi strumenti**.
2. Cerca l'app o scegli una categoria.
3. Seleziona la scheda dell'app per aprire **Dettagli app**.
4. Leggi la descrizione ed esamina ogni strumento disponibile.
5. Disattiva gli strumenti che Runner non deve usare nel progetto.
6. Inserisci le credenziali richieste o seleziona **Connetti e autorizza**.
7. Completa il passaggio del fornitore. Se il browser blocca la finestra di autorizzazione, consenti il
popup per Runner e ricomincia.
8. Torna alla finestra e controlla che indichi **Collegato**.
9. In seguito seleziona **Gestisci** per esaminare l'accesso agli strumenti o scollegare l'app.
La finestra di dialogo di connessione afferma che le credenziali del provider vengono inviate attraverso il servizio di connessione e non vengono archiviate da Runner. Dovresti comunque trattare ogni credenziale come un segreto e inserirla solo nei campi credenziali dell'app.
## Modifica l'accesso agli strumenti
1. Seleziona **Gestisci** sull'app connessa.
2. Trova lo strumento che desideri modificare.
3. Attiva o disattiva il suo interruttore.
4. Attendi **Strumento abilitato** o **Strumento disabilitato**.
5. Se Runner mostra **La modifica non è stata salvata: l’azione resta invariata. Riprova.**, lascia la finestra di dialogo aperta, controlla lo stato dell'interruttore corrente dopo l'aggiornamento e riprova solo se lo stato salvato è chiaro.
Disabilitare uno strumento limita l'uso di quello strumento da parte di Runner. Non elimina i dati creati in precedenza nel servizio esterno.
## Ripara o disconnetti una connessione
Se il catalogo non mostra più una connessione utilizzabile, apri l'app e avvia **Connetti** o **Connetti e autorizza** di nuovo, quindi conferma **Connesso**.
Per rimuovere l'accesso, seleziona **Gestisci → Disconnetti**, rivedi la conferma e seleziona **Conferma**. Questo rimuove la connessione dell'app Agent dell'account con accesso effettuato, non solo l'accesso agli strumenti del progetto corrente. Se la disconnessione non riesce, Runner mantiene lo stato connesso; non presumere che l'account esterno sia stato rimosso.
## Se le app Agent mancano
- La funzione potrebbe non essere abilitata per l'area di lavoro.
- Cancella la ricerca e imposta la categoria su **Tutto**.
- Aggiorna le app se il catalogo non esce mai dal suo stato di caricamento.
- Un'app singola può segnalare che non è ancora disponibile per la connessione.
- Se l'elenco degli strumenti non riesce, seleziona **Riprova** all'interno di **Dettagli app**.
- Nessuna voce di catalogo specifica dovrebbe essere promessa fino a quando non appare nell'area di lavoro corrente.
## Guide correlate
- [Panoramica di app e integrazioni](../apps-and-integrations)
- [Connetti, gestisci e ricollega un'app](./connect-manage-reconnect)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
---
# Collega CJ Dropshipping
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/cj-dropshipping
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Collega CJ Dropshipping per cercare, importare e gestire i prodotti del fornitore usando il tuo account CJ.
## Prima di iniziare
**Percorso di accesso:** **Progetto → Dropshipping → Collega fornitore**
Se il progetto usa la navigazione precedente, apri invece **Operazioni negozio → Dropshipping**. La pagina App attuale non elenca CJ: usa la voce del fornitore.
Hai bisogno di:
- un account CJ Dropshipping e la sua chiave API attuale;
- l'autorizzazione a collegarlo all'organizzazione; e
- un prodotto di esempio sicuro per verificare la connessione prima di farvi affidamento.
Mantieni privata la chiave API e inseriscila solo nella finestra di connessione CJ di Runner. La disconnessione rimuove l'autorizzazione del fornitore dalle importazioni CJ del commerciante finché non ti ricolleghi.
## Controlli CJ e risultati
| Controllo | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Collega fornitore** | Apre le scelte dei fornitori da Dropshipping. | Scegli CJ Dropshipping per configurare la chiave API. |
| Scelta del fornitore **CJ Dropshipping** | Apre la configurazione CJ da Dropshipping. | Runner richiede **Chiave API CJ**. |
| **Chiave API CJ** | Collega il tuo account del fornitore. | La finestra accetta una chiave non vuota per l'invio. |
| Icona dell'occhio | Aiuta a controllare errori di digitazione. | Mostra o nasconde la chiave. Nascondila prima di condividere lo schermo. |
| **Collega** nella finestra | Invia la chiave. | Dopo il successo Runner svuota il campo, chiude la finestra e indica CJ come collegato. |
| **Annulla** o chiusura | Esce senza collegare. | Runner rimuove la chiave dalla finestra. |
| Elimina o **Scollega** | Avvia la rimozione. | Runner apre una conferma prima di rimuovere la connessione. |
| **Scollega** nella conferma | Rimuove la tua chiave. | Ricerca, importazione, checkout e operazioni CJ autorizzate dal commerciante restano bloccate finché non viene ripristinata una connessione valida. |
Per esaminare la configurazione senza autorizzare CJ, apri la scelta del fornitore e il modulo vuoto della chiave, poi seleziona **Annulla**. Connessione e importazione richiedono il tuo account valido; l'anteprima del catalogo non verifica nessuna delle due.
## Collega il tuo account CJ
1. Apri **Progetto → Dropshipping** (oppure la voce precedente in Operazioni negozio, se compare).
2. Seleziona **Collega fornitore**, poi **CJ Dropshipping**.
3. Copia la chiave API dall'account CJ che Runner deve usare.
4. Incollala in **Chiave API CJ**.
5. Seleziona **Collega** nella finestra.
6. Attendi la conferma della connessione di Runner.
7. Esegui una ricerca sicura o apri un prodotto CJ di esempio in Dropshipping per verificare l'accesso al catalogo desiderato.
Le connessioni dei fornitori sono condivise dall'organizzazione. In **Gestisci fornitori**, controlla CJ e AliExpress separatamente: collegarne uno non collega l'altro.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
L'esempio mostra fornitori già collegati e dove controllare ogni connessione. Per questa guida non sono state effettuate connessioni, importazioni o disconnessioni.
## Disconnetti o sostituisci la chiave
Leggi attentamente la conferma di disconnessione. Scollegare rimuove la chiave API CJ. Non trasferisce automaticamente le importazioni del commerciante a un altro account CJ.
Dopo la disconnessione, ricerca e importazione CJ richiedono una connessione. Checkout e completamento degli ordini delle importazioni interessate vengono bloccati se Runner non può verificare connessione, prodotto, variante, inventario, prezzo o trasporto attuali. Ricollega lo stesso account CJ e ricontrolla l'articolo. Se identità del fornitore o dati attuali non corrispondono più, rimuovi il prodotto e importalo nuovamente.
Per sostituire la chiave, scollega quella attuale, verifica che Runner non la indichi più come collegata e collega la nuova. Ricontrolla i prodotti CJ esistenti prima di accettare ordini: cambiare account può rendere un'importazione non disponibile.
## Se CJ non si collega
- Ricopia la chiave API dall'account CJ desiderato; non modificarla per tentativi.
- **Connessione a CJ Dropshipping non riuscita** indica che Runner non ha accettato la connessione. Controlla la chiave in CJ e riprova.
- Se la finestra si chiude senza uno stato collegato, aggiorna la pagina prima di inviare ancora.
- Se ricerca o importazione falliscono dopo la connessione, verifica che l'account CJ possa eseguire quell'operazione.
- Se la disconnessione fallisce, considera ancora attivi chiave e account esistenti finché Runner non conferma la rimozione.
- Se il checkout si blocca dopo la riconnessione, verifica che prodotto e varianti appartengano all'account CJ collegato; in caso contrario reimporta l'articolo.
## Guide correlate
- [Connetti, gestisci e ricollega un'app](./connect-manage-reconnect)
- [Connetti l'adempimento 4PX](./4px-fulfillment)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
---
# Connetti, gestisci e ricollega un'app
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/connect-manage-reconnect
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza questa guida per portare un'app attraverso il suo ciclo di vita di connessione: avvia la connessione, conferma il suo stato reale, ripara l'autorizzazione quando necessario e disconnettila in modo sicuro.
**Percorso di accesso:** **Progetto → App**
## Prima di iniziare
Usalo quando:
- un'app dice **Connetti**, **Connessione in corso...**, **Riconnetti** o **In attesa di revisione**;
- hai bisogno di verificare se un flusso del provider precedente è davvero terminato;
- un'app Agent ha bisogno di un accesso agli strumenti diverso; o
- intendi rimuovere una connessione e hai bisogno di comprendere prima l'avviso.
Hai bisogno di accesso al progetto e di qualsiasi account, credenziale o approvazione richiesti dal provider esterno. Alcune app sono condizionali e potrebbero non apparire in ogni area di lavoro.
Su mobile, tocca la riga del fornitore per aprire i dettagli prima di scegliere **Collega**. Le app dell'Agente sono sotto **Collega i tuoi strumenti**; i fornitori del negozio sotto **Gestisci il tuo negozio**. Per CJ, usa la [guida alla connessione del fornitore](/it/guides/apps-and-integrations/cj-dropshipping).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Identifica il fornitore e il suo stato prima di aprire la configurazione. I controlli di una connessione esistente non dimostrano una nuova autorizzazione.
## Leggi la scheda prima di agire
| Stato della scheda o controllo | Significato | Cosa fare |
| --- | --- | --- |
| Indicatore di caricamento | Runner sta controllando la connessione salvata. | Attendi prima di selezionare un'altra azione. |
| **Connetti** | Runner non ha una connessione utilizzabile per questa app. | Apri la finestra di dialogo di configurazione o il flusso di autorizzazione del provider. |
| **Connessione in corso...** | Una richiesta di connessione è in corso. | Completa il flusso del provider o attendi che Runner restituisca un risultato. |
| **Connesso** | Runner riconosce una connessione utilizzabile. | Utilizza il suo controllo di gestione o disconnessione se hai bisogno di una modifica. |
| **Gestisci** | L'app Agent connessa ha strumenti configurabili. | Apri i dettagli dell'app e rivedi l'accesso agli strumenti. |
| **Riconnetti** | L'autorizzazione è mancante, scaduta o altrimenti ha bisogno di attenzione. | Avvia di nuovo l'autorizzazione. Non presumere che la vecchia connessione funzioni ancora. |
| **In attesa di revisione** | Stripe ha l'account ma non l'ha reso pronto. | Segui lo stato o l'avviso di azione; l'etichetta non è un pulsante Connetti. |
| **Continua l'onboarding** | Stripe ha ancora bisogno di informazioni. | Continua la configurazione esistente invece di creare un altro account. |
| Elimina o **Disconnetti** | Una connessione può essere rimossa. | Leggi e conferma l'impatto specifico del provider. |
## Collega o ripara una connessione
1. Apri **App** e trova l'app desiderata.
2. Seleziona **Collega**.
3. Fornisci solo i campi mostrati. A seconda dell'app, possono essere un dominio del negozio,
una chiave API, una chiave con segreto, credenziali del fornitore o un'autorizzazione esterna.
4. Completa il passaggio del fornitore, poi torna ad App.
5. Verifica che la scheda mostri lo stato collegato o i controlli della connessione.
Una finestra chiusa non dimostra il successo.
6. Se compare **Riconnetti** o **Continua configurazione**, seleziona l'azione e
prosegui con la connessione esistente.
## Scollega solo se vuoi rimuovere l'accesso
1. Per rimuovere l'app, seleziona il controllo di disconnessione, leggi la conferma e scegli
**Scollega** o **Conferma** solo se accetti l'effetto indicato sull'intero spazio di lavoro.
2. Riapri App e verifica che la scheda sia tornata allo stato scollegato.
La registrazione apre i moduli vuoti di Shippo, 4PX e Shopify, poi li chiude. Non vengono inserite credenziali né collegati fornitori.
## Fornitori del negozio e app dell'Agente sono diversi
I fornitori sotto **Gestisci il tuo negozio** usano controlli specifici:
- **Email** usa un interruttore.
- **Stripe** può mostrare controlli di configurazione, revisione, azioni richieste, dashboard e
disconnessione.
- **Shippo**, **4PX** e **Shopify** richiedono dati di configurazione specifici
e mostrano una conferma di disconnessione distruttiva.
## Sicurezza della connessione
- Tratta chiavi e segreti dei fornitori come password.
- Leggi se una connessione appartiene allo spazio di lavoro o solo al progetto attuale.
- Il completamento nella finestra del fornitore non garantisce che Runner abbia ricevuto un risultato utilizzabile.
- Non scollegare fornitori di spedizione, pagamento, email o evasione durante le operazioni
del negozio senza leggere l'avviso e controllare gli ordini attuali.
- Se la disconnessione segnala un errore, aggiorna e verifica lo stato prima di riprovare. Non presumere che il fornitore sia stato rimosso.
## Guide correlate
- [Panoramica di app e integrazioni](../apps-and-integrations)
- [Connetti e controlla le app Agent](./agent-apps)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
---
# Abilita l'email del negozio
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/resend-email
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
L'app **Email** Store abilita i messaggi transazionali dal tuo negozio quando il servizio email è disponibile per l'area di lavoro. Usalo per gli eventi del negozio che hanno bisogno di un messaggio cliente automatizzato piuttosto che una campagna manuale.
## Prima di iniziare
**Percorso di accesso:** **Progetto → App → Gestisci il tuo negozio → Email**
La scheda è etichettata **Email** in Runner. Non inserisci una chiave API Resend in questo flusso. La disponibilità può variare con la configurazione dell'area di lavoro, la preparazione del negozio e il supporto email.
Prima di abilitarla:
- conferma che stai lavorando nell'area di lavoro desiderata;
- rivedi il contenuto email rivolto ai clienti del negozio dove quell'editor è disponibile; e
- pianifica di verificare il percorso email completo con un indirizzo che controlli.
Su mobile, seleziona prima la riga **Email** per aprire i dettagli, poi usa i controlli della finestra. Il modulo visibile mostra solo da dove iniziare; connessione e operazioni successive valgono dopo l'autorizzazione del servizio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg6MPN0nfm1L4Nb8EwQVWDZqtHAfICiKG0kaMP)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Trova **Email** sotto **Gestisci il tuo negozio**. La panoramica mostra la voce: non è stata modificata alcuna impostazione email né inviato un messaggio a clienti.
## Controlli e risultati email
| Controllo o stato | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| Indicatore di caricamento | Impedisce le modifiche prima che Runner conosca lo stato salvato. | L'interruttore appare dopo il caricamento dell'impostazione corrente. |
| Interruttore email spento | Mostra che le notifiche email del negozio sono disabilitate. | Attivarlo crea o abilita la connessione email dell'area di lavoro. |
| Interruttore email acceso | Mostra che Runner ha abilitato l'integrazione email. | Disattivarlo disconnette l'integrazione. |
| Stato di caricamento dell'interruttore | Mostra che la modifica viene salvata. | Ulteriori modifiche attendono fino a quando Runner non riesce o non ha esito negativo. |
| Messaggio di successo | Conferma che Runner ha accettato la modifica dell'impostazione. | L'interruttore rimane nel nuovo stato. |
| Messaggio di errore | Mostra che Runner non poteva abilitare o disabilitare l'email. | L'interruttore torna allo stato salvato in modo che tu possa riprovare. |
## Abilita l'email
1. Apri **Progetto → App**.
2. Trova **Email** sotto **Gestisci il tuo negozio**.
3. Attiva l'interruttore.
4. Attendi **Notifiche email abilitate** e verifica che l'interruttore resti attivo.
5. Se Runner indica altrove che serve una nuova pubblicazione, pubblica
l'ultima versione del negozio prima di provare il risultato live.
6. Attiva un evento appropriato con dati di test sicuri e verifica l'arrivo del messaggio.
## Disattiva l'email
Disattiva l'interruttore solo dopo aver verificato se altri negozi nell'area di lavoro si affidano alla stessa connessione. Runner mostra **Notifiche email disabilitate** dopo il successo della modifica. Se il salvataggio non riesce, Runner mostra un errore e ripristina lo stato precedente.
Disabilitare l'integrazione non descrive cosa succede ai messaggi già inviati. Cambia solo se Runner può utilizzare la connessione email corrente per gli eventi del negozio futuri.
## Se l'email non funziona
- Se la scheda continua a caricarsi, aggiorna le app prima di modificare di nuovo l'interruttore.
- Se l'abilitazione non riesce, verifica che l'email sia disponibile per l'area di lavoro e riprova una volta.
- Se l'interruttore è acceso ma nessun messaggio arriva, verifica l'evento del negozio, l'indirizzo del destinatario, la configurazione del messaggio e la versione pubblicata più recente.
- Controlla lo spam o il filtraggio utilizzando un indirizzo che controlli; non testare con l'ordine di un cliente reale.
- Se la disabilitazione non riesce, presumi che lo stato precedente sia ancora attivo.
## Guide correlate
- [Connetti, gestisci e riconnetti un'app](./connect-manage-reconnect)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
- [Panoramica di app e integrazioni](../apps-and-integrations)
---
# Connetti Shippo per la spedizione
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/shippo-shipping
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Connetti Shippo quando desideri che Runner utilizzi il tuo account Shippo per la spedizione e l'adempimento. La connessione utilizza una chiave API fornita da Shippo.
## Prima di iniziare
**Percorso di accesso:** **Progetto → App → Gestisci il tuo negozio → Shippo**
Hai bisogno di:
- un account Shippo e una chiave API Shippo corrente;
- l'autorizzazione a collegare quell'account a questo negozio Runner; e
- la consapevolezza che scollegare Shippo rimuove la sua chiave e lo disattiva solo per questo negozio. Gli altri negozi mantengono la propria connessione Shippo.
Non incollare la chiave API in chat o documentazione.
Su mobile, seleziona prima la riga **Shippo** per aprire i dettagli, poi usa i controlli della finestra. Il modulo mostra solo da dove iniziare; connessione e operazioni seguenti valgono dopo l'autorizzazione del servizio.
## Controlli e risultati Shippo
| Controllo | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Connetti** | Apre la configurazione Shippo. | Runner chiede la **chiave API Shippo**. |
| **Chiave API Shippo** | Identifica il tuo account Shippo. | Runner controlla il formato della chiave e mostra un errore mentre il valore non è valido. |
| Icona occhio | Ti consente di ispezionare il valore per errori di digitazione. | Attiva/disattiva il campo tra testo nascosto e visibile. Nascondilo di nuovo prima di condividere lo schermo. |
| Finestra di dialogo **Connetti** | Invia la chiave. | In caso di successo, Runner chiude la finestra di dialogo, cancella il campo e cambia la scheda in connessa. |
| **Annulla** o chiudi | Esce dalla configurazione senza inviare. | Runner cancella la chiave inserita dalla finestra di dialogo. |
| Elimina o **Disconnetti** | Avvia la rimozione. | Runner apre **Disconnettere Shippo?** per questo negozio. |
| Conferma **Disconnetti** | Rimuove la connessione di questo negozio. | Runner rimuove la chiave API da questo negozio e vi disattiva Shippo. Gli altri negozi non sono interessati. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg2lkPdDEah7FSPqAV903v8Lem6fdQJcxZEiXo)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il modulo vuoto mostra dove inserire la chiave Shippo. Seleziona **Annulla** per uscire senza inviare credenziali; le operazioni di spedizione richiedono una verifica separata dopo la connessione.
## Connetti Shippo
1. Apri **Progetto → App**.
2. Trova **Shippo** e seleziona **Connetti**.
3. Copia la chiave API dall'account Shippo che intendi utilizzare.
4. Incollala in **Chiave API Shippo**.
5. Se Runner segnala una chiave non valida, torna a Shippo e copia di nuovo invece di modificare il segreto per supposizione.
6. Seleziona **Connetti** nella finestra di dialogo.
7. Attendi il messaggio di successo e conferma che la scheda mostra il suo controllo di disconnessione connesso.
8. Utilizza dati di test sicuri per verificare il flusso di spedizione prima di affidarti a esso per gli ordini dei clienti.
## Disconnetti o sostituisci la chiave
Seleziona il controllo di disconnessione della scheda e leggi **Disconnettere Shippo?**. Conferma solo quando è accettabile rimuovere la chiave e disattivare Shippo per questo negozio. Gli altri negozi dello spazio di lavoro mantengono la propria connessione.
Per utilizzare una chiave diversa, disconnetti l'integrazione corrente, conferma che la scheda non è più connessa, quindi completa il flusso di connessione con la chiave di sostituzione.
## Se Shippo non si connette
- **Chiave API non valida** significa che il valore non corrisponde al formato della chiave Shippo accettato.
- **Impossibile connettere Shippo** significa che Runner non ha terminato la connessione del provider. Mantieni la chiave privata, conferma che è corrente in Shippo e riprova dalla scheda.
- Se la finestra di dialogo si chiude ma la scheda non si connette, aggiorna le app prima di inviare di nuovo.
- Se la disconnessione non riesce, presumi che la chiave esistente sia ancora attiva.
- Una scheda connessa non prova che tariffe, etichette, vettori o una spedizione specifica funzionano. Verifica quelle operazioni separatamente con dati di test sicuri.
## Guide correlate
- [Connetti, gestisci e ricollega un'app](./connect-manage-reconnect)
- [Connetti l'adempimento 4PX](./4px-fulfillment)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
---
# Connetti Shopify
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/shopify
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Connetti Shopify quando il tuo negozio online o il flusso di lavoro Runner ha bisogno di accesso a un negozio Shopify esistente. Runner avvia l'autorizzazione dal dominio `myshopify.com` del negozio e Shopify ti chiede di installare e autorizzare l'app Runner.
## Prima di iniziare
**Percorso di accesso:** **Progetto → App → Gestisci il tuo negozio → Shopify**
Puoi anche scegliere **Connetti Shopify** quando crei un negozio dallo spazio di lavoro. Questa guida si concentra sulla scheda di connessione in App.
Hai bisogno di:
- disponibilità dell'integrazione Shopify nello spazio di lavoro;
- un dominio del negozio Shopify nel formato `your-store.myshopify.com`;
- autorizzazione per installare e autorizzare l'app Runner in quel negozio Shopify; e
- autorità per connettere il negozio allo spazio di lavoro Runner.
Uno spazio di lavoro che ha già un negozio Shopify connesso potrebbe richiedere di disconnetterlo prima di connettere un altro.
Su mobile, seleziona prima la riga **Shopify** per aprire i dettagli, poi usa i controlli della finestra. Il modulo mostra solo da dove iniziare; connessione e operazioni seguenti valgono dopo l'autorizzazione del servizio.
## Controlli e risultati di Shopify
| Controllo | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Connetti** | Apre la configurazione di Shopify. | Runner chiede il **Dominio del negozio**. |
| **Dominio del negozio** | Identifica il negozio Shopify esatto. | Runner accetta il formato `your-store.myshopify.com` e mostra un errore per un dominio non valido. |
| **Continua verso Shopify** | Avvia l'autorizzazione del provider. | Runner reindirizza a Shopify per installare l'app Runner e autorizzare l'accesso. |
| **Annulla** o chiudi | Si ferma prima dell'autorizzazione. | Runner chiude la finestra di dialogo e cancella il dominio inserito. |
| **Connessione in corso...** | Mostra che il reindirizzamento dell'autorizzazione sta iniziando. | L'azione rimane non disponibile mentre Runner si sposta verso Shopify. |
| Elimina o **Disconnetti** | Avvia la rimozione. | Runner apre **Disconnetti Shopify?**. |
| Conferma **Disconnetti** | Rimuove la connessione Shopify di Runner. | Runner rimuove il token della vetrina Shopify da tutti i progetti dello spazio di lavoro. Il negozio Shopify e i suoi ordini non vengono eliminati. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgzy8MJHxvQbMAZ2hlg7w6ye8S5vnLIHkGPOqr)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Inserisci il dominio Shopify permanente quando sei pronto ad autorizzare l'accesso. L'esempio si ferma prima di **Continua su Shopify**.
## Connetti Shopify
1. Apri **Progetto → App** e trova **Shopify**.
2. Seleziona **Connetti**.
3. Inserisci il dominio `myshopify.com` esatto del negozio in **Dominio del negozio**.
4. Correggi qualsiasi messaggio di dominio non valido prima di continuare.
5. Seleziona **Continua verso Shopify**.
6. Su Shopify, verifica il nome del negozio e l'accesso richiesto prima di autorizzare l'app Runner.
7. Torna a Runner e conferma che la scheda Shopify mostra il suo controllo di disconnessione connesso.
8. Verifica i dati del negozio previsto e il percorso di checkout prima di apportare modifiche in diretta.
## Disconnetti o cambia negozi
Seleziona il controllo di disconnessione e leggi **Disconnetti Shopify?**. La conferma rimuove il token della vetrina Shopify da tutti i progetti nello spazio di lavoro. Non elimina il negozio Shopify o gli ordini Shopify esistenti.
Per connettere un negozio Shopify diverso, disconnetti prima la connessione dello spazio di lavoro esistente, conferma che la scheda non è più connessa, quindi ripeti la configurazione con il dominio dell'altro negozio.
## Se Shopify non si connette
- Usa il dominio permanente `myshopify.com`, non un dominio di vetrina personalizzato.
- Se Runner dice che lo spazio di lavoro ha già un negozio connesso, rivedi quella connessione prima di rimuoverla.
- Se Shopify rifiuta l'autorizzazione, ricomincia dalla scheda Shopify.
- Se il negozio restituito non corrisponde al dominio che hai inserito, fermati e verifica quale account Shopify e negozio sono aperti.
- Se il collegamento di connessione è scaduto, ricomincia da **Connetti** piuttosto che riutilizzare la vecchia pagina del provider.
- Se Runner segnala che l'accesso richiesto è mancante, rivedi i permessi dell'app in Shopify.
- Se la disconnessione non riesce, presumi che la connessione esistente sia ancora attiva.
## Guide correlate
- [Connetti, gestisci e riconnetti un'app](./connect-manage-reconnect)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
- [Panoramica di app e integrazioni](../apps-and-integrations)
---
# Connetti Stripe per i pagamenti
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/stripe-payments
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Connetti Stripe quando desideri che un negozio Runner pubblicato accetti pagamenti dei clienti. Runner mostra lo stato della connessione, mentre Stripe raccoglie e rivede le informazioni aziendali necessarie per accedere ai pagamenti e ai bonifici.
## Prima di iniziare
**Percorso di accesso:** **Progetto → App → Gestisci il tuo negozio → Stripe**
Dopo la pubblicazione, Runner può anche mostrare **Connetti Stripe** nel passaggio del negozio. Quel pulsante apre lo stesso percorso di configurazione dei pagamenti.
Hai bisogno di:
- autorizzazione per gestire la connessione dello spazio di lavoro;
- le informazioni aziendali e di identità che Stripe richiede; e
- un browser che consenta l'apertura della finestra di configurazione di Stripe.
La vetrina può essere pubblicata mentre il checkout è ancora in pausa o in fase di verifica. Un URL di negozio live non è una prova che i pagamenti siano disponibili.
Su mobile, seleziona prima la riga **Stripe** per aprire i dettagli, poi usa i controlli della finestra. Il modulo mostra solo da dove iniziare; connessione e operazioni seguenti valgono dopo l'autorizzazione del servizio.
## Controlli e risultati di Stripe
| Controllo o stato | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Connetti** | Avvia l'onboarding dei pagamenti. | Runner apre un flusso di configurazione ospitato da Stripe in una nuova finestra. |
| **Connessione in corso...** | Mostra che Runner sta preparando l'account Stripe o il collegamento di configurazione. | L'azione rimane non disponibile fino a quando Runner non restituisce un risultato. |
| **Riconnetti** | Riprende un account che esiste ma non è pronto. | Runner apre un collegamento di onboarding aggiornato per l'account esistente. |
| **In attesa di revisione** | Mostra che Stripe sta rivedendo i dettagli inviati. | L'etichetta è informativa; segui qualsiasi avviso di azione separato. |
| **Azioni Stripe richieste** | Elenca le informazioni o la verifica che necessita di attenzione. | Rivedi i dettagli **Da fare ora**, **Da fare più tardi**, **In revisione**, **Pagamenti sospesi** o **Bonifici sospesi**. |
| **Continua onboarding** | Completa i requisiti Stripe in sospeso. | Runner apre Stripe per l'account esistente. |
| Icona Apri dashboard Stripe | Ti consente di gestire un account abilitato su Stripe. | Apre il dashboard Stripe connesso in una nuova scheda. |
| Icona Elimina | Avvia la disconnessione. | Apre **Disconnetti Stripe?** invece di rimuoverlo immediatamente. |
| **Disconnetti** | Conferma la rimozione da Runner. | Runner disconnette Stripe dallo spazio di lavoro. Gli ordini esistenti non sono interessati. |
## Connetti Stripe
1. Apri **Progetto → App**.
2. Trova **Stripe** sotto **Gestisci il tuo negozio**.
3. Seleziona **Collega**. Runner apre Stripe in una nuova finestra.
4. Completa solo i passaggi mostrati da Stripe.
5. Torna a Runner e riapri App.
6. Controlla che la scheda mostri i controlli della connessione e che Runner indichi i pagamenti
pronti prima di aspettarti che il checkout li accetti.
7. Se vedi **Riconnetti**, **Continua configurazione**, **In revisione** o **Azioni
Stripe richieste**, segui quello stato invece di ricominciare.
8. Prova il checkout live solo dopo che Runner indica i pagamenti pronti.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgdRbFueMh3McYFndyrWQxNbi4IRHOVuEC8JtX)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Una connessione esistente può mostrare questi controlli. Lo screenshot non verifica checkout, pagamenti o accrediti: mostra dove esaminare la connessione.
## Comprendi il risultato
| Stato | Cosa significa per te |
| --- | --- |
| Non connesso | Il checkout ha ancora bisogno di un provider di pagamento. |
| Riconnessione richiesta | Un account Stripe esiste, ma l’autorizzazione o l’onboarding non sono completi. |
| In attesa di revisione | Stripe ha ricevuto i dettagli ma non ha reso l'account pronto. |
| Azioni richieste | Stripe ha bisogno di informazioni specifiche, oppure i pagamenti o i bonifici potrebbero essere sospesi. |
| Connesso | Runner riconosce la connessione Stripe. Verifica il checkout live prima di annunciare che i pagamenti sono disponibili. |
## Disconnetti o riconnetti
Per disconnettere, seleziona l'icona Elimina, leggi **Disconnetti Stripe?**, quindi scegli **Disconnetti**. La conferma afferma che gli ordini esistenti rimangono. I nuovi pagamenti di checkout possono rimanere non disponibili fino a quando non viene ripristinata una connessione di pagamento utilizzabile.
Per riconnettere, seleziona **Riconnetti** o **Continua onboarding**. Runner riutilizza l'account esistente quando possibile; non creare una seconda configurazione semplicemente perché la prima finestra del provider è stata chiusa.
## Se Stripe non si connette
- Se la finestra di configurazione si chiude presto, torna a App e usa **Riconnetti**.
- Se Runner mostra **Azioni Stripe richieste**, completa i requisiti del provider elencati.
- Se l'account rimane **In attesa di revisione**, non creare ripetutamente nuovi tentativi di onboarding.
- Se Runner mostra un errore di connessione o collegamento, riprova dalla scheda Stripe dopo aver confermato che il tuo browser consente la nuova finestra.
- Non inviare mai documenti di identità, ID account o dettagli di pagamento nella chat di Runner.
## Guide correlate
- [Connetti, gestisci e riconnetti un'app](./connect-manage-reconnect)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)
- [Panoramica di app e integrazioni](../apps-and-integrations)
---
# Risolvi i problemi di connessione delle app
Source: https://www.runnerai.com/docs/it/guides/apps-and-integrations/troubleshooting
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa questa guida quando un'app non si carica, non si connette, non si riconnette, non salva l'accesso ai suoi strumenti o non si disconnette come previsto. Inizia dallo stato che Runner mostra effettivamente piuttosto che ripetere ciecamente un flusso del provider.
**Percorso di accesso:** **Progetto → App**
## Prima di iniziare
1. Controlla di aver aperto App per il progetto e lo spazio di lavoro desiderati.
2. Svuota **Cerca strumenti** e rimuovi i filtri di categoria delle app dell'Agente.
3. Aggiorna la pagina una volta e attendi il caricamento degli stati.
4. Leggi lo stato esatto: **Collega**, **Connessione in corso...**, **Collegato**, **Riconnetti**,
**In revisione** o un avviso di azione richiesta.
5. Apri solo l'azione di recupero adatta a quello stato.
6. Non includere chiavi API, segreti, documenti d'identità, dati di pagamento o URL completi
di callback del fornitore in messaggi all'assistenza o screenshot.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgJFpud5MziL9zFEdkGCVveD1jTZUlSay3IctK)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
La ricerca restringe il catalogo. Se manca uno strumento, svuota ricerca e filtri prima di richiedere un'app; un risultato non è una connessione autorizzata.
## Controlli e risultati importanti
| Controllo | Cosa succede dopo averlo selezionato |
| --- | --- |
| **Cancella ricerca** | Rimuove la ricerca corrente delle App Agent in modo che il catalogo disponibile possa apparire di nuovo. |
| **Connetti** / **Connetti e autorizza** | Apre il flusso di configurazione o autorizzazione esterna per quell'app. |
| **Riconnetti**, quando mostrato | Riavvia l'autorizzazione per una connessione del provider esistente. |
| **Riprova** | Ripete la richiesta del catalogo, dell'elenco degli strumenti o della connessione non riuscita mostrata dal pannello corrente. |
| **Continua onboarding** | Ritorna al flusso di onboarding Stripe esistente quando è richiesta un'azione. |
| **Disconnetti** | Apre una conferma o avvia il flusso di rimozione documentato; verifica lo stato salvato prima di modificare le credenziali dal lato del provider. |
## Tabella sintomi e recupero
| Cosa vedi | Significato probabile | Azione successiva sicura |
| --- | --- | --- |
| L'app è mancante | La ricerca, una categoria, l'accesso allo spazio di lavoro o una funzione condizionale la sta nascondendo. | Cancella la ricerca, scegli **Tutto**, quindi conferma che la funzione è disponibile per questo spazio di lavoro. |
| La scheda continua a caricarsi | Runner non ha risolto la connessione salvata. | Aggiorna App una volta. Evita di inviare un'altra connessione mentre lo stato è sconosciuto. |
| **Nessuna app trovata** | Nessuna Agent App corrisponde ai filtri correnti. | Seleziona **Cancella ricerca**. |
| **Connetti** non fa nulla | Un campo obbligatorio è vuoto o non valido, oppure il flusso del provider non ha potuto avviarsi. | Leggi gli errori dei campi, ricopia il valore richiesto e consenti i popup del provider se applicabile. |
| **Connessione in corso...** non finisce | L'autorizzazione esterna è stata chiusa, bloccata o non ha mai restituito un risultato. | Torna a App, aggiorna lo stato, quindi usa **Riconnetti** se Runner lo offre. |
| Il provider dice successo ma Runner no | Runner non ha confermato una connessione utilizzabile. | Riapri App. Tratta solo **Connesso** come successo; usa **Riconnetti** invece di creare duplicati. |
| **Riconnetti** | L'autorizzazione esistente ha bisogno di attenzione. | Selezionalo e completa di nuovo il flusso del provider. |
| **In attesa di revisione** | Stripe sta rivedendo i dettagli inviati. | Segui gli avvisi di azione; non avviare un altro account solo per rimuovere l'etichetta. |
| **Azioni Stripe richieste** | Stripe ha bisogno di informazioni o ha messo in pausa una capacità. | Rivedi i dettagli **Dovuto ora**, **Dovuto dopo**, **In revisione**, pagamento e pagamento, quindi usa **Continua onboarding** quando mostrato. |
| Chiave API o segreto rifiutato | Il valore è sbagliato, scaduto, da un account sbagliato o non accettato per questa integrazione. | Ricopia dal provider. Non modificare i segreti per congettura. |
| Dominio Shopify non valido | Il valore non è il dominio permanente del negozio Shopify. | Usa `your-store.myshopify.com`, non un dominio di vetrina personalizzato. |
| La finestra di autorizzazione di Agent App è bloccata | Il browser ha impedito il flusso esterno. | Consenti i popup per Runner e avvia di nuovo **Connetti e autorizza**. |
| Gli strumenti di Agent App non si caricano | Runner non ha potuto recuperare l'elenco degli strumenti di quell'app. | Seleziona **Riprova** in **Dettagli app**. |
| L'interruttore dello strumento segnala un errore | La nuova impostazione dello strumento non è stata salvata. | Attendi l'aggiornamento dell'interruttore, conferma il suo stato attuale, quindi riprova una volta. |
| La disconnessione segnala un errore | Runner non ha confermato la rimozione. | Presumi che la connessione esistente sia ancora attiva e riapri App prima di riprovare. |
## Controlli specifici del provider
### Stripe
- Continua un tentativo di onboarding esistente con **Riconnetti** o **Continua onboarding**.
- Leggi i requisiti di azione invece di fare affidamento solo sul colore della scheda.
- Una vetrina pubblicata può ancora avere pagamenti in pausa o non disponibili.
- Usa l'azione del dashboard Stripe solo dopo che Runner ha un account associato.
### Email
- Un cambio di interruttore non riuscito ritorna allo stato salvato.
- Un interruttore abilitato non prova che un'email particolare sia stata consegnata.
- Verifica l'evento del negozio, il destinatario, la configurazione dell'email e la versione attualmente pubblicata con dati di test sicuri.
### Shippo
- Ricopia la chiave API Shippo dall'account previsto.
- Una scheda connessa non verifica tariffe, vettori, etichette o creazione di spedizioni.
### Shopify
- Usa il dominio permanente `myshopify.com`.
- Se uno spazio di lavoro ha già un negozio connesso, revisionalo prima di disconnetterlo.
- Riavvia l'autorizzazione quando il collegamento di connessione scade o il negozio restituito non corrisponde al dominio che hai inserito.
### CJ Dropshipping
- Conferma che la chiave API appartiene all'account CJ che intendi utilizzare.
- Dopo la disconnessione, ricerche, importazioni, checkout e operazioni CJ future con il tuo account commerciante restano bloccati finché non ripristini una connessione valida.
- Riconnetti lo stesso account CJ e controlla le importazioni esistenti. Se l'identità del fornitore o i dati in tempo reale di un articolo non corrispondono più, rimuovilo e importalo di nuovo.
### 4PX
- Conferma che la chiave API e il segreto appartengono allo stesso account e sono nei campi corretti.
- Una scheda connessa non prova che una destinazione o un ordine sia idoneo per l'evasione.
### App Agent
- L'intera sezione o un'app individuale può essere condizionatamente non disponibile.
- Cancella i filtri prima di trattare un'app come assente.
- Rivedi gli interruttori degli strumenti prima di riconnettere; non concedere più accesso solo per semplificare la configurazione.
## La disconnessione non è riuscita o ha prodotto un risultato incerto
1. Mantieni l'account del provider e le operazioni del negozio attuale invariate.
2. Riapri **Progetto → App** e controlla lo stato della scheda.
3. Se mostra ancora connesso, tratta la connessione come attiva.
4. Non eliminare le credenziali dal lato del provider fino a quando non capisci se il checkout attivo, l'email, la spedizione, il fornitore o il lavoro di evasione dipendono ancora da esse.
5. Riprova la disconnessione di Runner solo dopo che lo stato è chiaro.
## Chiedi aiuto in sicurezza
Fornisci:
- il nome dell'app;
- lo stato visibile esatto e il testo dell'errore;
- se il problema si verifica durante la connessione, il ritorno, la gestione degli strumenti o la disconnessione;
- l'URL del progetto senza valori di query segreti; e
- uno screenshot sicuro per la privacy se mostra materialmente il problema.
Non fornire la chiave API effettiva, il segreto, la password del provider, il documento di identità, i dettagli di pagamento, i dati dei clienti o i parametri di autorizzazione nascosti.
Se lo strumento resta assente dopo aver rimosso ricerca e filtri, usa **Richiedi un’app** (o **Richiedi questa app** nel risultato vuoto). Il modulo richiede il supporto di un fornitore, non lo collega. Per problemi CJ, apri [Configurazione fornitori Dropshipping](/it/guides/apps-and-integrations/cj-dropshipping).
## Guide correlate
- [Panoramica di app e integrazioni](../apps-and-integrations)
- [Connetti, gestisci e riconnetti un'app](./connect-manage-reconnect)
- [Connetti e controlla le App Agent](./agent-apps)
---
# Automatizza, testa e crea
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create
Apri **Cresci** per Automazioni, Studio creativo, Libreria multimediale e Annunci. Apri **Misura** per Simulazione ed Esperimenti. Queste guide portano dalla configurazione alla verifica del lavoro risultante.
> **Disponibilità:** Ogni funzione in questa sezione può dipendere da un piano, accesso all'area di lavoro, ruolo, stato del negozio, crediti, dati o connessione del provider. Una voce mancante è uno stato di disponibilità, non una prova che il progetto sia rotto.
| Obiettivo | Inizia qui |
| --- | --- |
| Trova e comprendi il lavoro ricorrente | [Automazioni](/it/guides/automate-test-and-create/automations) |
| Attiva un'automazione o personalizza la sua email | [Crea e gestisci automazioni](/it/guides/automate-test-and-create/create-and-manage-automations) |
| Configurare un test di acquisto o, quando disponibile, una previsione di campagna | [Simulazioni](/it/guides/automate-test-and-create/simulations) |
| Leggi percorsi, funnel, risultati e raccomandazioni | [Esecuzioni e risultati della simulazione](/it/guides/automate-test-and-create/simulation-runs-and-results) |
| Avvia un esperimento controllato del negozio | [Esperimenti](/it/guides/automate-test-and-create/experiments) |
| Leggi le prestazioni e decidi cosa applicare | [Misurazione dell'esperimento](/it/guides/automate-test-and-create/experiment-measurement) |
| Genera o modifica immagini e video | [Creative Studio](/it/guides/automate-test-and-create/creative-studio) |
| Trova e riutilizza i media generati | [Libreria media](/it/guides/automate-test-and-create/media-library) |
| Connetti account pubblicitari e comprendi le campagne | [Runner Ads](/it/guides/automate-test-and-create/runner-ads) |
| Rivedi le prestazioni creative e salva l'ispirazione | [Creatività pubblicitaria e tendenze](/it/guides/automate-test-and-create/ad-creatives-and-trending) |
---
# Creatività pubblicitarie e tendenze
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/ad-creatives-and-trending
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Creativity ti aiuta a confrontare i media dalle campagne connesse, mentre Trending ti aiuta a scoprire e organizzare l'ispirazione pubblicitaria pubblica.
> **Disponibilità condizionata:** entrambe le pagine richiedono accesso a Runner Ads e un piano idoneo. Le prestazioni delle creatività richiedono un account supportato collegato e dati delle campagne restituiti. **Di tendenza** può cercare nelle librerie pubbliche Meta o TikTok senza collegare l'account pubblicitario; i risultati dipendono dalla fonte esterna.
## Percorsi di accesso
- Progetto di negozio → **Cresci** → **Annunci** → **Creativi**.
- Progetto di negozio → **Cresci** → **Annunci** → **Di tendenza**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEooJlJchdR6T0uwqnz73letZimQpFvYfSrhL)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Di tendenza apre una ricerca nella libreria pubblica. Risultati della ricerca e prestazioni delle campagne collegate sono dati distinti.
## Prima di iniziare
- Conferma che lo spazio di lavoro e il piano possono aprire Runner Ads.
- Connetti un account Google o Meta autorizzato prima di aspettarti dati di prestazione creativa.
- Scegli una domanda di prestazione o un tema di ispirazione in modo che i filtri rimangono utili.
- Tratta i dati di tendenza esterna come materiale di riferimento, non come il risultato misurato del tuo negozio.
## Controlli di creatività e risultati dei clic
| Controllo | Cosa succede dopo averlo selezionato |
| --- | --- |
| Intervallo di tempo | Aggiorna le metriche creative per l'ultima settimana, il mese o un periodo recente più ampio. |
| Selettore account | Filtra i dati creativi quando sono connessi più account supportati. |
| Ordina | Ordina le schede per spesa, ritorno sulla spesa pubblicitaria, clic, impressioni, ricavi, punteggio di clic o punteggio di conversione. |
| Chip metriche | Aggiunge, rimuove o riordina le metriche mostrate sulle schede creative. |
| Scheda creativa | Apre l'anteprima creativa e i dettagli di prestazione disponibili. |
## Rivedi le creatività connesse
1. Apri **Annunci** → **Creativi**.
2. Se viene visualizzato il prompt di connessione, connetti prima l'account Google o Meta autorizzato.
3. Seleziona la finestra di reporting e l'account.
4. Scegli l'ordinamento che corrisponde alla tua domanda.
5. Mantieni visibile un piccolo set di chip metriche in modo che i confronti rimangono leggibili.
6. Apri una scheda creativa per ispezionare l'asset e le sue metriche disponibili.
7. Confronta diverse creatività prima di decidere che un'immagine o un video ha causato il risultato.
## Controlli di tendenza e risultati dei clic
| Controllo | Cosa succede dopo averlo selezionato |
| --- | --- |
| **Meta** / **TikTok** | Cambia la libreria di annunci esterna in fase di navigazione. |
| **Cerca** per parola chiave | Richiede annunci corrispondenti alla parola chiave inviata. |
| Paese, media, stato o filtri temporali | Restringe la libreria corrente quando supportato da quella fonte. |
| Ordina | Riordina i risultati utilizzando il segnale di recency, impressione, pubblicazione o portata disponibile. |
| **Cancella** | Rimuove i filtri attivi e ritorna alla query della libreria predefinita. |
| Scheda annuncio | Apre un'anteprima più grande con i dettagli restituiti dalla fonte. |
| **Indice impressioni** in un dettaglio Meta | Mostra l'indice non negativo fornito per quello snapshot esterno quando uno è disponibile. Non è la prestazione della campagna misurata del tuo negozio. |
| Stella / **Salva nella raccolta** | Apre le raccolte esistenti per lo snapshot dell'annuncio. |
| **Nuova raccolta** | Crea una raccolta denominata e salva l'annuncio selezionato in essa dopo il successo. |
| **Raccolte** | Apre l'ispirazione salvata; selezionando una raccolta mostra i suoi snapshot di annunci salvati. |
| **Torna a Tendenze** | Ritorna dalle raccolte alla vista di scoperta. |
## Salva l'ispirazione pubblicitaria
1. Apri **Annunci** → **Tendenze**.
2. Scegli **Meta** o **TikTok**.
3. Cerca un prodotto, un pubblico o un tema di messaggio.
4. Restringe i risultati con solo i filtri necessari per la domanda.
5. Apri un annuncio per ispezionarlo.
6. Seleziona la stella per aprire **Salva nella raccolta**.
7. Scegli una raccolta esistente o creane una nuova chiaramente denominata.
8. Apri **Raccolte** per confermare che lo snapshot è stato salvato.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Prompt di connessione in Creatività | Nessun account di prestazione supportato è connesso. Completa prima la connessione. |
| Griglia creativa vuota | L'account selezionato, il periodo o il provider non ha restituito creatività. Amplia il filtro e conferma che le campagne esistono. |
| Risultati di tendenza vuoti | Cancella i filtri o usa una parola chiave più ampia; la fonte potrebbe non avere dati corrispondenti. |
| Il dettaglio Meta non ha **Indice impressioni** | Lo snapshot esterno corrente non ha un valore utilizzabile. Mancante non significa zero. |
| Raccolta vuota | Nessuno snapshot salvato è in quella raccolta. Torna a Tendenze e salva un annuncio. |
| Salvataggio non riuscito | Lo snapshot o la raccolta non è stata confermata. Riprova dopo aver ricaricato la scheda di origine. |
| Annuncio di tendenza forte | È ispirazione, non prova che la stessa creatività funzionerà per il tuo negozio. Crea e misura la tua campagna separatamente. |
## Controlla cosa rappresenta la scheda
In **Creativi**, controlla account e periodo prima di confrontare le metriche di una scheda. In **Di tendenza**, controlla libreria esterna e filtri prima di usare un annuncio come ispirazione pertinente.
**Verifica:** dopo un salvataggio riuscito, l'ispirazione compare nella raccolta selezionata. È un riferimento salvato, non una campagna pubblicata o un risultato misurato del negozio.
## Guide correlate
- [Runner Ads](./runner-ads)
- [Creative Studio](./creative-studio)
- [Libreria media](./media-library)
---
# Automazioni
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/automations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Automazioni ti aiuta a trovare il lavoro ricorrente che Runner può eseguire quando si verifica un trigger elencato.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **Automazioni**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgUokxtnwmWbL01zqS4swQkOHahZevAM9fnVpR)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Le schede mostrano lo stato configurato delle automazioni. La sola etichetta Attivo non conferma un'esecuzione o la consegna di un'email.
## Prima di iniziare
- **Order Confirmation**, **Welcome Email** e **Account Closed Email** funzionano con ogni piano. Le altre automazioni richiedono un piano che includa le automazioni; senza, attivarle apre un invito a passare a un piano superiore.
- Ogni scheda di automazione ha la sua disponibilità e stato.
- Attivare un'automazione non la esegue immediatamente; attende il trigger descritto da quell'automazione.
## Controlli della libreria e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Cerca** | Filtra le schede per parole nel nome o nella descrizione dell'automazione. |
| **Tutte** o una categoria | Mostra tutte le automazioni o solo categorie come **Gestione clienti**, **Operazioni negozio** o **Rapporto e analisi**. Le categorie dipendono dalla libreria disponibile. |
| Filtro di stato | Mostra **Tutti gli stati**, **Live**, **In pausa**, **Bloccato dal piano** o schede **Prossimamente**. |
| Interruttore della scheda | Richiede **Live** quando attivato e **In pausa** quando disattivato, se l'automazione è disponibile. |
| Pulsante Info | Apre **Dettagli automazione** con descrizione, stato, categoria e ultima esecuzione. |
| Pulsante Modifica | Apre **Componi email** per le automazioni che supportano un modello di email. |
| **Riprova** | Ricarica la libreria dopo un errore di caricamento. |
> **Dimensione dello schermo:** I pulsanti Info e modifica email vengono mostrati su layout desktop più ampi. Se non li vedi su uno schermo di dimensioni telefoniche, riapri Automazioni in una finestra più ampia.
## Trova l'automazione giusta
1. Apri **Automazioni**.
2. Cerca il risultato di cui hai bisogno, come un messaggio al cliente o un report.
3. Restringe l'elenco con una categoria quando il risultato è ampio.
4. Usa il filtro di stato per trovare elementi live o bloccati.
5. Seleziona il pulsante info su una scheda.
6. Leggi la descrizione, lo stato, la categoria e l'ultima esecuzione prima di modificare l'interruttore.
7. Se viene visualizzato un pulsante di modifica email, rivedi il modello prima di abilitare l'automazione.
## Significati dello stato
| Stato | Significato e passaggio successivo |
| --- | --- |
| **Live** | L'automazione è abilitata e attende il suo trigger. Questo non significa che sia già stata eseguita. |
| **In pausa** | L'automazione è disponibile ma non avvierà nuovo lavoro attivato fino a quando non sarà abilitata. |
| **Bloccato dal piano** | Il piano attuale impedisce l'esecuzione dell'automazione. Rivedi l'accesso prima di fare affidamento su di essa. |
| **Prossimamente** | La scheda è visibile per la scoperta ma non può essere abilitata. |
| **Mai eseguito** o **Ultima esecuzione —** | Non è disponibile un orario di esecuzione completata per il progetto. |
## Risoluzione dei problemi
- Se nessuna scheda corrisponde, cancella **Cerca**, scegli **Tutto** e scegli **Tutti gli stati**.
- Se un interruttore è disabilitato, leggi lo stato della scheda e il motivo della disponibilità.
- Se un interruttore ritorna al suo stato precedente, leggi il messaggio di errore e ricarica la libreria prima di riprovare.
- Se la libreria non si carica, seleziona **Riprova** una volta e contatta il supporto se si ripete.
## Verifica prima dell'attivazione
Il pannello dei dettagli deve spiegare attivazione e stato dell'automazione selezionata. Chiudilo per tornare alla stessa scheda. **Attivo** autorizza gli eventi futuri: controlla l'ultima esecuzione e il messaggio o report reale risultante per verificarne l'esito.
### Guarda: esamina un'automazione sospesa
La registrazione filtra per Sospese, apre i dettagli di Richiesta recensione e li chiude. Non attiva l'automazione, non modifica l'email e non invia messaggi.
## Guide correlate
- [Crea e gestisci automazioni](./create-and-manage-automations)
- [Runner Ads](./runner-ads)
- [Panoramica di analitiche](../analytics-and-seo/analytics-overview)
---
# Crea e gestisci automazioni
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/create-and-manage-automations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza i controlli di automazione per decidere quali flussi di lavoro disponibili possono essere eseguiti e quale contenuto email del cliente supportato deve contenere.
> **Condizionale:** La pagina corrente gestisce le schede di automazione fornite da Runner; non presenta un generatore di flussi di lavoro vuoto per creare alcuna automazione arbitraria. La modifica email appare solo su schede supportate.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **Automazioni** → scegli una scheda.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgu7RtXsbqHvBxClMcD3zm6P2XTVQw91N0sga5)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Richiesta recensione è sospesa e non mostra l'ultima esecuzione. Esamina questi dettagli prima di attivare l'automazione.
## Prima di iniziare
- Leggi la descrizione dell'automazione e il trigger prima di abilitarla.
- Conferma che il piano attuale consente l'automazione.
- Per l'email del cliente, verifica mittente, oggetto, variabili, link e dettagli del marchio prima di salvare.
- Il salvataggio di un modello modifica la sua configurazione archiviata; non invia un'email di test o del cliente da solo.
## Controlli della scheda e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Attiva | Cambia lo stato richiesto a **Live**. I trigger corrispondenti futuri possono avviare l'automazione. |
| Disattiva | Cambia lo stato richiesto a **Sospeso**. I nuovi trigger corrispondenti non dovrebbero avviarla. |
| Pulsante Info | Apre la descrizione dell'automazione, lo stato, la categoria, il motivo della disponibilità e l'ora dell'ultima esecuzione. |
| Pulsante modifica email | Apre **Componi email** quando la scheda ha un modello personalizzabile. |
> **Dimensione dello schermo:** I pulsanti Info e modifica email vengono visualizzati su layout desktop più ampi. Se assenti su uno schermo di dimensioni telefoniche, utilizza una finestra più ampia prima di seguire i passaggi seguenti.
## Controlli email e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Da** | Cambia il valore del mittente archiviato per questo modello. |
| **Oggetto** | Modifica l'oggetto dell'email. |
| **Corpo** | Modifica il contenuto dell'email. |
| **Inserisci variabile** | Apre i segnaposti supportati e inserisce quello selezionato nella posizione corrente. |
| **Anteprima** | Esegue il rendering di un'anteprima della bozza corrente; non invia l'email. |
| URL logo e colore accento | Aggiorna gli input di branding utilizzati dal modello. |
| **Salva** | Archivia le impostazioni email correnti e cambia **Non salvato** a **Salvato** dopo il successo. |
| **Riprova** anteprima | Tenta di eseguire nuovamente il rendering della bozza corrente dopo un errore di anteprima. |
## Abilita e personalizza in sicurezza
1. Seleziona il pulsante info e conferma quando viene eseguita l'automazione.
2. Se è disponibile un pulsante di modifica email, apri **Componi email**.
3. Modifica l'oggetto e il corpo in linguaggio semplice rivolto al cliente.
4. Inserisci solo variabili offerte dal menu.
5. Seleziona **Anteprima** e controlla il contenuto renderizzato.
6. Torna a **Modifica** se manca qualcosa o non è chiaro.
7. Seleziona **Salva** e attendi **Salvato**.
8. Chiudi il compositore, quindi attiva l'interruttore della scheda solo quando il trigger e il messaggio sono pronti.
9. Torna più tardi per controllare il valore **Ultima esecuzione**; un badge **Live** da solo non prova l'esecuzione.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| **Non salvato** | La bozza differisce dal modello archiviato. Salva o chiudi senza fare affidamento sulla bozza. |
| **Salvato** | Le impostazioni del modello corrente sono state archiviate. Nessuna email è stata inviata dall'azione di salvataggio. |
| Anteprima non riuscita | Seleziona **Riprova**. Se si ripete, controlla la sintassi della variabile e conserva la bozza prima di ricaricare. |
| Modello email non trovato | Questa scheda non ha personalizzazione recuperabile. Chiudi la finestra di dialogo e ricarica la libreria. |
| Interruttore bloccato | Controlla **Bloccato dal piano**, **Prossimamente** o il motivo della disponibilità sulla scheda. |
## Controlla l'email prima di salvare
In **Anteprima**, controlla oggetto, marchio, link e valori delle variabili. Torna a **Modifica** per correggere la bozza. Chiudere senza salvare mantiene il modello memorizzato.
**Verifica:** **Salvato** conferma la configurazione del modello. La consegna richiede un evento corrispondente e un'esecuzione completata; anteprima e salvataggio non inviano email ai clienti.
### Guarda: esamina un'automazione sospesa
La registrazione filtra per Sospese, apre i dettagli di Richiesta recensione e li chiude. Non attiva l'automazione, non modifica l'email e non invia messaggi.
## Guide correlate
- [Automazioni](./automations)
- [Libreria media](./media-library)
- [Risoluzione dei problemi di dati e pubblicazione](../analytics-and-seo/troubleshoot-data-and-publication)
---
# Creative Studio
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/creative-studio
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Creative Studio ti offre una tela visiva per creare media di campagne e prodotti da un prompt, immagini selezionate o entrambi.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **Studio creativo**. Si apre l'area di lavoro di **Studio creativo**.
Quando la funzione è abilitata, una visualizzazione dettagliata dell'immagine generata nella chat di Runner può anche offrire **Apri immagine generata in Creative Studio**, che apre la tela con quell'output selezionato.
Il selettore immagine-immagine mostra requisiti del modello e fonte di pagamento prima di Esegui. Aprirlo non avvia la generazione.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggKevjc4IC4NbwvYeKD2nM5xTZ76dBjp0auiy)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un'immagine di esempio esistente è selezionata nell'area di lavoro, con prompt, modello e controlli Esegui. Controlla questi dati prima di avviare la generazione.
## Prima di iniziare
- Decidi se hai bisogno di una nuova immagine, una modifica di immagine, un nuovo video o un'animazione da un'immagine.
- Controlla input, output, qualità, limiti e fonte di pagamento del modello. Il selettore può mostrare **Crediti Runner** o la tua chiave Fal: scegli la fonte desiderata.
- Per una modifica, aggiungi l'immagine di origine alla tela e selezionala prima.
- Mantieni l'asset originale disponibile fino a quando non approvi il risultato.
## Controlli di generazione e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Prompt | Descrive l'immagine, la modifica, il movimento o il video che desideri. |
| Pulsante del modello | Apre **Scegli un modello**, con quattro schede: testo-immagine, immagine-immagine, testo-video e immagine-video. |
| Ricerca e filtri del modello | Restringe i modelli per nome, tipo di generazione o caso d'uso. |
| Stella su un modello | Aggiunge o rimuove quel modello da **Preferiti**. |
| Carica immagini | Apre il selettore file e aggiunge immagini supportate per l'uso sulla tela. |
| **Esegui** | Avvia un lavoro con il prompt corrente, il modello selezionato e gli input della tela selezionati. |
| **Generazioni** | Apre la coda di background con lavori in esecuzione, completati, non riusciti e interrotti. |
| **Cancella completati** | Rimuove le voci della coda completate dalla visualizzazione della coda; non elimina i media salvati. |
## Controlli della tela e degli asset
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Vassoio asset | Apre gli asset generati dalla conversazione corrente o tutti gli asset del progetto. |
| Ricerca asset | Filtra il vassoio asset. |
| **Aggiungi alla tela** | Posiziona l'asset disponibile selezionato sulla tela. |
| **Metti a fuoco sulla tela** | Sposta il viewport su quell'asset quando è già presente. |
| **Libreria media** | Apre la pagina completa dei media salvati. |
| Annulla / Ripeti | Annulla o riapplica le modifiche della tela supportate. |
| Controlli zoom e minimappa | Cambia il viewport senza modificare i media stessi. |
| Seleziona elemento/i, quindi fai clic con il pulsante destro | Apre il menu contestuale della tela. Le azioni disponibili cambiano con il numero e il tipo di elementi selezionati. |
| **Strumenti prodotto** | Per le selezioni di immagini supportate, apre Fotografia di prodotto, Scena di prodotto, Posizionamento di prodotto, Tenuta di prodotto, Prova virtuale, Rimuovi o sostituisci sfondo, Illuminazione, Concetto di materiale e Upscale. Gli strumenti a una immagine e due immagini rimangono disabilitati fino a quando non viene selezionato il numero richiesto. |
| **Imposta come miniatura del prodotto** | Con un'immagine selezionata, apre il selettore di prodotto. Scegliendo **Usa come miniatura** carica l'immagine e aggiorna la miniatura e l'elenco di immagini di quel prodotto. |
| **Estendi video** / **Rimuovi sfondo video** | Con un video selezionato, apre il flusso di lavoro video corrispondente quando è disponibile. |
| **Esporta GIF** | Converte il video selezionato in una GIF scaricabile; un errore di conversione lascia il video originale invariato. |
| Duplica / Ritaglia / Combina immagini / Ordine livelli / Scarica | Applica l'operazione della tela selezionata quando i suoi requisiti di conteggio immagini e tipo di media sono soddisfatti. |
| **Elimina** | Rimuove solo l'elemento selezionato dalla tela. Non elimina l'asset salvato dalla Libreria media. |
## Crea media
1. Apri **Creative Studio**.
2. Scegli un modello e leggi i suoi requisiti di input.
3. Per da testo a immagine o da testo a video, lascia vuota la selezione della tela e scrivi un prompt specifico.
4. Per modificare un'immagine, usa **Aggiungi alla tela** sulla sorgente, selezionala e scegli un modello **Immagine-immagine**. Ad esempio, **Nano Banana 2 Edit** compare quando disponibile; controlla i requisiti senza presumere che tutti i modelli accettino gli stessi dati.
5. Per da immagine a video, seleziona la singola immagine che il modello animerà.
6. Rivedi l'etichetta di finanziamento del modello e l'avviso di credito corrente.
7. Seleziona **Esegui** una sola volta.
8. Apri **Generazioni** per seguire l'avanzamento mentre continui altri lavori sulla tela.
9. Ispeziona l'output completato sulla tela. I media generati vengono salvati nella libreria media dopo la generazione riuscita.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Nulla in coda | Nessuna generazione di background corrente è elencata. |
| In sospeso o in esecuzione | Il lavoro è ancora in elaborazione. Continua a lavorare e attendi il completamento. |
| Riuscito | L'output generato è disponibile sulla tela e nei media salvati. Revisionalo prima del riutilizzo. |
| Non riuscito | Il lavoro non ha prodotto l'output previsto. Leggi il messaggio, correggi gli input e riprova deliberatamente. |
| Interrotto | L'elaborazione è terminata prima del successo. Conferma il finanziamento e l'accesso al provider prima di riprovare. |
| Esecuzione non disponibile | Controlla prompt, immagini selezionate, conteggio input esatto, accesso al modello e crediti. |
| Asset non disponibile | Riprova a caricare il vassoio o scegli un altro asset salvato; non fare affidamento su un'anteprima interrotta. |
## Controlla la configurazione senza avviare un lavoro
1. Apri **Scegli un modello** e confronta il tipo di input supportato con l'attività.
2. Chiudi il selettore dopo aver scelto un modello adatto.
3. Controlla prompt e immagini selezionate nell'area di lavoro.
4. Leggi l'avviso sulla fonte di pagamento prima di **Esegui**.
**Verifica:** modello, prompt e sorgente selezionata descrivono il lavoro desiderato. La generazione parte solo dopo **Esegui**; la coda mostra poi lo stato, e il risultato completato richiede comunque un controllo visivo.
### Guarda: esamina un modello di modifica delle immagini
La registrazione esamina i requisiti immagine-immagine e torna a un'immagine di esempio esistente. Non avvia una generazione.
## Guide correlate
- [Libreria media](./media-library)
- [Creatività pubblicitaria e tendenze](./ad-creatives-and-trending)
- [Runner Ads](./runner-ads)
---
# Misurazione dell'esperimento
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/experiment-measurement
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La misurazione dell'esperimento ti aiuta a confrontare il controllo con la variazione attiva prima di prendere una decisione per il negozio live.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Esperimenti** → scegli un esperimento → **Prestazioni**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
La pubblicazione è necessaria prima che un esperimento reale raccolga dati. Qui non vengono mostrate misure di esperimenti.
## Prima di iniziare
- Conferma l'obiettivo dell'esperimento e l'allocazione del traffico corrente.
- Attendi un campione utile prima di interpretare piccoli cambiamenti percentuali.
- Rivedi le modifiche della variazione nella scheda **Esperimenti** prima di considerare **Applica modifiche**.
- Chiedi al proprietario dell'area di lavoro prima di un'azione che distribuisce modifiche o interrompe i test live.
## Controlli e risultati delle prestazioni
| Controllo o sezione | Cosa accade o appare |
| --- | --- |
| **Esperimenti** | Apre messaggi di ciclo, piani, anteprima, modifiche e richieste in sospeso. |
| **Prestazioni** | Apre runtime, dimensione del campione, divisione del traffico, grafico e tabella delle metriche. |
| Selettore metrica | Cambia il grafico in una misura supportata come conversione, aggiungi al carrello, checkout, acquisto, valore dell'ordine, ricavi per visitatore, clic su banner, abbandono del carrello o tasso di errore. |
| Grafico Controllo / Variazione | Confronta la serie registrata per la versione originale e dell'esperimento. |
| Controllo traffico → **Aggiorna** | Salva una nuova allocazione dell'esperimento entro l'intervallo consentito. |
| **Insight IA** → **Consenti** | Approva il suggerimento di traffico visualizzato. |
| **Insight IA** → **Annulla** | Ignora quel suggerimento senza approvarlo. |
| **Chiedi a Runner AI** | Invia un messaggio all'interno dell'area di lavoro dell'esperimento. |
| **Visualizza piano** | Apre il piano del ciclo corrente e l'elenco delle cose da fare. |
## Rivedi la misurazione
1. Apri **Prestazioni**.
2. Conferma runtime, dimensione del campione e divisione del traffico prima di leggere la tendenza.
3. Seleziona la metrica che corrisponde all'obiettivo dell'esperimento.
4. Confronta il controllo e la variazione nello stesso periodo.
5. Controlla le metriche di supporto per errore, abbandono o compromessi di ricavi.
6. Torna a **Esperimenti** e rivedi le modifiche esatte che hanno prodotto la variazione.
7. Leggi qualsiasi richiesta di **Insight IA** prima di consentire un cambio di traffico.
8. Scegli di continuare a misurare, regolare il traffico, interrompere o preparare l'applicazione solo dopo aver rivisto sia il comportamento che l'implementazione.
## Azioni ad alto impatto
| Azione | Cosa fa il primo clic | Cosa significa la conferma |
| --- | --- | --- |
| **Applica modifiche** | Apre **Applica modifiche esperimento**. | La conferma applica le modifiche dell'esperimento al percorso del negozio principale e avvia la distribuzione in produzione. Rivedi prima l'esperimento denominato. |
| **Interrompi** | Apre **Interrompi esperimento** con avvisi. | La conferma termina l'esperimento corrente. Se l'autorizzazione dell'esperimento rimane abilitata, Runner potrebbe avviarne un altro; utilizza le impostazioni del progetto quando intendi disabilitare completamente gli esperimenti. |
| Traffico **Aggiorna** | Invia la nuova allocazione. | Il traffico idoneo futuro utilizza la divisione aggiornata dopo il successo. |
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Nessun dato del ciclo | La misurazione non ha ancora prodotto un risultato del ciclo. Mantieni l'esperimento in esecuzione o ispeziona il suo stato. |
| Impossibile caricare le metriche | Ricarica **Prestazioni** e riprova più tardi; non applicare modifiche da dati mancanti. |
| Risultato piatto o misto | Le prove disponibili non mostrano un chiaro miglioramento. Continua a misurare o interrompi senza applicare. |
| Aggiornamento del traffico non riuscito | Il valore corrente non è stato archiviato. Ricarica prima di riprovare un'allocazione valida. |
| Applicazione non riuscita | Nessuna applicazione di produzione riuscita è stata confermata. Conserva l'errore e verifica il negozio live prima di riprovare. |
## Verifica prima di modificare il traffico
Prima di scegliere un'azione devi saper indicare obiettivo, dimensione del campione, ripartizione attiva e variante esatta. Se un gruppo non ha dati utili, considera il risultato inconcludente. Aprire **Prestazioni** o una conferma non interrompe l'esperimento né applica modifiche: serve il successo dell'azione corrispondente.
## Guide correlate
- [Esperimenti](./experiments)
- [Esecuzioni e risultati della simulazione](./simulation-runs-and-results)
- [Metriche e filtri](../analytics-and-seo/metrics-filters)
---
# Esperimenti
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/experiments
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Gli esperimenti ti permettono di testare variazioni controllate della vetrina rispetto a un obiettivo aziendale selezionato.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Esperimenti**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Pubblica la vetrina prima di avviare un esperimento. Questa schermata di prerequisiti non mostra un esperimento avviato.
## Prima di iniziare
- Pubblica il negozio e conferma che può ricevere traffico reale.
- Scegli un obiettivo primario che corrisponda alla priorità attuale del negozio.
- Scegli un'allocazione del traffico che sei a tuo agio nell'assegnare alle variazioni dell'esperimento.
- Comprendi che l'avvio avvia un processo di esperimento; non garantisce un guadagno di prestazioni.
## Controlli di avvio e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Scheda obiettivo | Seleziona la metrica che Runner dovrebbe ottimizzare, come conversione, aggiungi al carrello, checkout avviato, coinvolgimento del banner, click-through del pulsante o valore medio dell'ordine. |
| Cursore del traffico o preset | Imposta la quota di traffico idoneo assegnato all'esperimento entro l'intervallo consentito. |
| **Avvia Esperimenti** | Autorizza e avvia l'esperimento per il negozio, l'obiettivo e il valore del traffico selezionati. |
| Titolo dell'esperimento o **Visualizza esperimento** | Apre l'area di lavoro dei dettagli dell'esperimento. |
| **Tutti gli esperimenti**, **In esecuzione** o **Interrotto** | Filtra l'elenco degli esperimenti per stato. |
## Avvia un esperimento
1. Apri **Esperimenti**.
2. Se appare il muro di pubblicazione, pubblica e verifica prima il negozio.
3. Leggi ogni obiettivo e seleziona quello legato alla decisione di cui hai bisogno.
4. Imposta l'allocazione del traffico.
5. Rivedi il negozio, l'obiettivo e il traffico ancora una volta.
6. Seleziona **Avvia Esperimenti** una sola volta.
7. Attendi che la scheda dell'esperimento appaia.
8. Apri l'esperimento per seguire la pianificazione, le modifiche, i cicli e le misurazioni.
## Controlli della scheda dell'esperimento
| Controllo o sezione | Cosa mostra o fa |
| --- | --- |
| Badge di stato | Mostra **In sospeso**, **In esecuzione**, **Completato**, **Non riuscito** o **Annullato**. Il filtro dell'elenco **Interrotto** raggruppa esperimenti completati, non riusciti e annullati. |
| Ciclo e traffico | Mostra il conteggio del ciclo corrente e l'allocazione. |
| Anteprima | Mostra la variazione dell'esperimento quando un'anteprima è disponibile. |
| **Modifiche** | Elenca le modifiche della vetrina associate al ciclo più recente. |
| **Insight IA** | Apre un suggerimento in sospeso come un aggiustamento del traffico. |
| **Consenti** | Approva il suggerimento visualizzato con il suo valore corrente. |
| **Annulla** | Ignora quel suggerimento in sospeso. |
| Menu altre azioni | Apre **Interrompi** e **Applica modifiche** quando quelle azioni sono disponibili. |
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Muro di pubblicazione | Il negozio non ha una distribuzione live riuscita. Pubblica prima di abilitare Esperimenti. |
| Schermata di lista d'attesa o aggiornamento | La funzione o il piano non è disponibile per questa area di lavoro. |
| Preparazione o pianificazione | Runner sta configurando il ciclo successivo. Attendi un piano o una richiesta visibile. |
| In attesa di approvazione | Runner ha bisogno di una decisione prima di poter continuare quel suggerimento. Leggilo prima di scegliere **Consenti**. |
| Nessuna modifica ancora | L'esperimento corrente non ha prodotto una modifica di variazione visibile. |
| Non riuscito | Apri l'esperimento e conserva l'errore visibile per il supporto prima di avviare una sostituzione. |
## Controlla l'accesso prima di preparare l'avvio
Se Runner mostra un'anteprima del piano, le schede di esempio illustrano la funzione: non sono esperimenti attivi nel negozio. Risolvi il requisito di accesso prima dell'avvio. Il vincolo di pubblicazione è separato e richiede un negozio live funzionante.
**Verifica:** dopo un avvio idoneo, la scheda dell'esperimento reale deve identificare obiettivo e ripartizione desiderati. Attendi traffico registrato prima di interpretare le prestazioni: una scheda creata non dimostra misurazione o miglioramento.
## Guide correlate
- [Misurazione dell'esperimento](./experiment-measurement)
- [Simulazioni](./simulations)
- [Traffico e conversione](../analytics-and-seo/traffic-and-conversion)
---
# Libreria media
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/media-library
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La Libreria media ti offre un record visivo filtrabile di immagini e video di progetto generati che possono essere riutilizzati in seguito.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **Libreria multimediale**. Si apre la pagina **Libreria multimediale**.
Puoi anche aprirla dal vassoio asset in [Creative Studio](./creative-studio).
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgPzvLcwpojWS3a1ps2R0mnEqK6T9PkBh7u5zQ)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Una libreria di immagini di esempio. Scegli un'immagine per esaminarne i dettagli salvati; aprire la libreria non genera nuovi contenuti.
Il dettaglio di un'immagine di esempio mostra prompt, modello e controlli di riutilizzo. Nessuna miniatura prodotto è stata modificata.
## Prima di iniziare
- Genera o salva media in un flusso di lavoro Runner supportato.
- Sappi se stai cercando un'immagine o un video.
- Per le miniature dei prodotti, conferma quale prodotto dovrebbe cambiare prima di completare la finestra di dialogo di selezione.
## Controlli della libreria e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Tutto** | Mostra ogni immagine e video salvato disponibile. |
| **Immagini** | Filtra la griglia in immagini. |
| **Video** | Filtra la griglia in video. |
| Scheda media | Apre **Dettagli immagine** o **Dettagli video**. |
| **Carica altri** | Recupera media aggiuntivi quando sono disponibili più elementi. |
## Controlli dei dettagli e risultati dei clic
| Controllo o campo | Cosa accade o appare |
| --- | --- |
| Tipo, Origine e Creato | Spiega cosa è l'elemento, da dove proviene e quando è stato salvato. |
| Prompt e Modello | Mostra il contesto di generazione quando è disponibile. |
| Titolo | Ti permette di inserire un nome riutilizzabile più chiaro. |
| **Salva** | Archivia un titolo modificato; non è disponibile quando nulla è cambiato. |
| **Chiudi** | Chiude i dettagli senza salvare un titolo non salvato. |
| **Imposta come miniatura del prodotto** | Apre il flusso di selezione e conferma del prodotto per un'immagine. Non si applica ai video. |
| **Elimina** | Apre una conferma irreversibile; solo il secondo **Elimina** rimuove l'elemento. |
| Elimina **Annulla** | Torna ai dettagli senza eliminare l'elemento. |
## Trova ed esamina i contenuti multimediali
1. Apri **Libreria media**.
2. Scegli **Immagini** o **Video** quando la griglia è grande.
3. Seleziona una scheda per aprire i dettagli.
4. Rivedi origine, data, prompt e modello per confermare che è l'asset previsto.
5. Chiudi i dettagli per tornare alla griglia filtrata.
**Verifica:** il dettaglio mostra il contenuto desiderato e il contesto di generazione disponibile. Se la griglia è vuota, torna a **Tutti** prima di presumere che manchino contenuti.
## Rinomina o applica un'immagine
1. Riapri il contenuto desiderato, inserisci un titolo utile e seleziona **Salva**.
2. Per usarlo come miniatura prodotto, seleziona **Imposta come miniatura del prodotto**.
3. Scegli il prodotto desiderato e leggi la conferma prima di applicare la modifica.
4. Apri il prodotto e verifica che compaia l'immagine corretta.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| **Nessun media ancora** | Nessun media supportato è disponibile. Crea prima un'immagine o un video in Creative Studio. |
| Visualizzazione filtrata vuota | La libreria non ha elementi di quel tipo. Torna a **Tutto**. |
| Nessuna modifica da salvare | Il titolo corrisponde al valore archiviato. Chiudi la finestra di dialogo o modificalo. |
| Salvataggio non riuscito | Il nuovo titolo non è stato confermato. Conservalo, ricarica e riprova. |
| Azione miniatura assente | Solo le immagini possono utilizzare il flusso di miniatura del prodotto. |
| Conferma eliminazione | L'azione non può essere annullata. Scegli **Annulla** a meno che la rimozione permanente non sia intenzionale e autorizzata. |
## Guide correlate
- [Creative Studio](./creative-studio)
- [Runner Ads](./runner-ads)
- [Automazioni](./automations)
---
# Runner Ads
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/runner-ads
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Runner Ads porta la reportistica degli account pubblicitari supportati e i controlli delle campagne nel progetto del negozio.
## Percorso di accesso
Apri un progetto di negozio → **Cresci** → **Annunci** → **Panoramica**. Il sottomenu apre anche **Creativi** e **Di tendenza**: sono viste separate.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglh1549efCuYB97EiQHRN3LVKtUonPdvTgIM4)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
La panoramica Annunci non collegata offre l'autorizzazione Google, Meta e TikTok. Selezionare un fornitore avvia la connessione; questa schermata non conferma un account collegato.
## Prima di iniziare
- Conferma che l'area di lavoro ha accesso a Pubblicità e un piano idoneo.
- Utilizza un account autorizzato a connettere il provider pubblicitario.
- Sappi quale provider e account pubblicitario appartengono a questa azienda.
- La connessione avvia il flusso di autorizzazione del provider; non è completa fino a quando Runner non mostra l'account connesso.
## Controlli di connessione e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Connetti Google Ads** | Apre il flusso di autorizzazione sicuro di Google. |
| **Connetti Facebook & Instagram** | Apre il flusso di autorizzazione Meta. |
| **Connetti TikTok Ads** | Apre l'autorizzazione TikTok quando quel canale è abilitato. |
| **Annulla connessione** | Annulla un tentativo di autorizzazione del provider ancora in sospeso. |
| Impostazioni di connessione | Apre lo stato del canale connesso più i controlli supportati da quel provider, come connetti, sincronizza, riautorizza o disconnetti. |
| Sincronizza | Richiede un elenco di account aggiornato per quella connessione. Non crea una campagna. |
| **Riautorizza** | Per TikTok, avvia di nuovo l'autorizzazione quando questo controllo appare e la connessione lo richiede. |
| Disconnetti | Apre una conferma prima di rimuovere la connessione del provider di Runner. |
## Connetti un account
1. Apri **Pubblicità** → **Panoramica**.
2. Seleziona il pulsante del provider corretto.
3. Completa l'autorizzazione nella finestra del provider.
4. Torna a Runner e attendi la sincronizzazione dell'account.
5. Conferma che il nome del provider e dell'account appaiono nelle impostazioni di connessione o nel selettore di account.
6. Se la connessione rimane in sospeso, attendi la sincronizzazione o utilizza il percorso di ripetizione visibile.
7. Non trattare il clic del pulsante iniziale come una connessione completata.
## Controlli e risultati della dashboard
| Controllo o sezione | Cosa accade o appare |
| --- | --- |
| Intervallo di tempo | Aggiorna la reportistica per la settimana passata, il mese o un periodo recente più ampio. |
| Selettore account | Filtra i risultati quando è disponibile più di un account connesso. |
| Schede KPI | Riassumono le metriche pubblicitarie disponibili per gli account e il periodo selezionati. |
| Tabella campagne | Elenca le metriche della campagna e i controlli di stato supportati. |
| Campagna **Pausa** / **Abilita** | Per le campagne Google Ads o TikTok supportate, richiede il corrispondente cambio di stato esterno. Le campagne Meta non mostrano questo controllo. Utilizzalo solo quando autorizzato e conferma lo stato restituito. |
| Grafico di tendenza | Confronta le prestazioni della campagna e dell'account selezionati nel tempo. |
| Feed attività | Mostra l'attività recente disponibile dell'account pubblicitario. |
| **Crea campagna** | Apre una scelta di provider o una destinazione di campagna solo quando un canale di creazione supportato è connesso. |
## Percorsi di creazione della campagna
- Con Google Ads connesso, **Crea campagna** apre il flusso in quattro passaggi di Runner: **Canale e obiettivo**, **Piano**, **Modifica campagne** e **Rivedi e pubblica**.
- Con TikTok Ads connesso, la creazione apre TikTok Ads Manager in una nuova scheda piuttosto che una procedura guidata TikTok in-app.
- Con entrambi disponibili, il pulsante apre una scelta di provider.
- Una connessione solo Meta può fornire reportistica ma non mostra una destinazione di creazione della campagna nel flusso corrente.
- Nel flusso Google, **Avanti** avanza dopo che i campi obbligatori sono validi, **Indietro** torna a un passaggio completato e **Pubblica campagna** invia la campagna rivista al provider.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Lista d'attesa | Ads è disabilitato per l'area di lavoro. Aderire o visualizzare la lista d'attesa non la sblocca immediatamente. |
| Schermata di aggiornamento | Il piano attuale non può aprire l'area di lavoro Ads. |
| Autorizzazione in sospeso | La finestra del provider non ha completato o restituito. Completala o annulla il tentativo. |
| Riautorizzazione richiesta | Per TikTok, apri le impostazioni di connessione e seleziona **Riautorizza** quando mostrato prima di aspettarti dati aggiornati. |
| Dati temporaneamente ritardati | Mantieni i dati parziali disponibili e riprova più tardi; evita richieste ripetute al provider. |
| Reportistica non disponibile per un canale | Quella connessione non può fornire la reportistica richiesta. Utilizza i canali supportati o la reportistica del provider. |
| Pulsante Crea assente | Nessun canale attualmente connesso supporta una destinazione di creazione. |
## Identifica la schermata prima di collegare
Una lista d'attesa indica che Annunci non è disponibile nello spazio di lavoro. L'anteprima del piano può mostrare report di esempio mentre le azioni reali sono bloccate. La schermata di connessione richiede l'account del fornitore necessario ai report. Segui la procedura solo quando la pagina offre una connessione utilizzabile.
**Verifica:** dopo l'autorizzazione, controlla fornitore e account esatti selezionati in Runner. Una tabella campagne vuota può semplicemente indicare che non ci sono campagne o dati corrispondenti nel periodo scelto.
## Guide correlate
- [Creatività pubblicitaria e tendenze](./ad-creatives-and-trending)
- [Creative Studio](./creative-studio)
- [Traffico e conversione](../analytics-and-seo/traffic-and-conversion)
---
# Esecuzioni di simulazione e risultati
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/simulation-runs-and-results
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La pagina di esecuzione trasforma l'attività degli acquirenti generata in prove che puoi ispezionare prima di decidere se il negozio deve cambiare.
> **Condizionale:** Una pagina di esecuzione esiste solo dopo che una simulazione idonea è stata avviata. I risultati possono essere parziali, non disponibili o non riusciti, e i consigli generati non vengono applicati automaticamente.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Simulazione** → scegli una simulazione recente.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Le simulazioni di clienti e pagine richiedono la pubblicazione prima dell'esecuzione. Questa schermata di configurazione non contiene percorsi completati o risultati.
## Prima di iniziare
- Attendi che l'esecuzione raggiunga uno stato completato o non riuscito prima di trattare i suoi totali come finali.
- Tieni a mente la pagina di destinazione e la modalità selezionata durante l'interpretazione dei risultati.
- Non trattare il comportamento della persona generata come comportamento osservato da veri acquirenti.
## Controlli di esecuzione e risultati dei clic
| Controllo o sezione | Cosa accade o appare |
| --- | --- |
| Collegamento indietro | Ritorna alla pagina di destinazione Simulazione e alle esecuzioni recenti. |
| **Percorsi** | Apre i percorsi individuali della persona, le decisioni, i passaggi e gli screenshot disponibili. |
| **Tavola dell'imbuto** | Raggruppa le sessioni degli acquirenti per la fase di percorso più lontana raggiunta. |
| **Risultati** | Riassume le sessioni terminali, le uscite esplicite, i limiti di turno e i guasti tecnici. |
| Scheda persona o sessione | Apre il percorso dell'acquirente generato. |
| **Visualizza dettagli del passaggio** | Apre l'azione selezionata, la pagina, l'intenzione, la logica e lo screenshot quando disponibile. |
| **Invia a Runner** | Crea un passaggio di chat Runner contenente il contesto del consiglio. Non applica il cambiamento. |
| **Convalida acquirenti** | Avvia un'esecuzione di confronto dello stesso acquirente per un consiglio idoneo. |
## Leggi un'esecuzione di comportamento dell'acquirente
1. Conferma che lo stato è **Completato** o nota quali parti sono ancora in esecuzione.
2. Leggi i totali della sessione e il riepilogo della portata del checkout.
3. Apri **Tavola dell'imbuto** per trovare il calo comune più precoce.
4. Apri **Percorsi** e ispeziona le sessioni rappresentative a quel punto.
5. Usa **Visualizza dettagli del passaggio** per rivedere l'operazione tentata e lo stato della pagina visibile.
6. Apri **Risultati** per separare le uscite degli acquirenti dai guasti tecnici o dai limiti di turno.
7. Leggi ogni consiglio di ottimizzazione con le sue prove, l'area interessata, il rischio e il piano di convalida.
8. Usa **Invia a Runner** solo quando desideri un'attività di chat revisionabile; ispeziona l'attività prima di accettare i cambiamenti.
## Leggi un audit di stimolo della pagina
1. Attendi il rapporto aggregato.
2. Leggi il punteggio di intento e il numero di prospettive degli acquirenti insieme.
3. Rivedi le differenze dei segmenti e la distribuzione dei punteggi.
4. Leggi i temi di attrito e i commenti di supporto.
5. Usa il risultato per formare un'ipotesi testabile, non una previsione di conversione garantita.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Risultati in sospeso | Le sessioni non sono terminate. Attendi più sessioni terminali. |
| Nessun rapporto disponibile | L'esecuzione è terminata senza il rapporto aggregato previsto. Conserva l'ID di esecuzione e contatta il supporto. |
| Riproduzione non disponibile | Una riproduzione o uno screenshot firmato non poteva essere caricato. Ricarica l'esecuzione per richiedere un accesso aggiornato. |
| Guasto tecnico | L'automazione non poteva completare quel percorso; escludilo dalle conclusioni comportamentali. |
| Convalida in coda o in esecuzione | Il confronto non è pronto. Attendi prima di giudicare il consiglio. |
| Migliorato, peggiorato o inconcludente | Il confronto dello stesso acquirente favorisce, danneggia o non può distinguere il cambiamento suggerito all'interno di quel test generato. |
## Collega il risultato alla sua modalità
Le istruzioni precedenti su percorsi e funnel valgono per le simulazioni dei clienti. **Previsione della campagna**, quando disponibile, offre invece **Società**, **Chat** e **Rapporto**. Leggi ipotesi sul pubblico e dati della campagna prima del report.
**Verifica:** identifica se il risultato deriva da un percorso generato, una reazione a una pagina o una previsione di campagna. Nessuno è un acquisto registrato di un cliente reale. Separa i guasti tecnici dalle reazioni del pubblico.
## Guide correlate
- [Simulazioni](./simulations)
- [Esperimenti](./experiments)
- [Traffico e conversione](../analytics-and-seo/traffic-and-conversion)
---
# Simulazioni
Source: https://www.runnerai.com/docs/it/guides/automate-test-and-create/simulations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La simulazione ti consente di inviare persone acquirenti generate attraverso un percorso di negozio live o chiedere loro di valutare una pagina pubblica.
## Percorso di accesso
Apri un progetto di negozio → **Misura** → **Simulazione**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOPqFQfJCcW62zHrU8smjSnqvixd1twlAf4uK)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Le simulazioni di clienti e pagine richiedono la pubblicazione prima dell'esecuzione. Questa schermata di configurazione non contiene percorsi completati o risultati.
## Prima di iniziare
- Per **Comportamento degli acquirenti** e **Audit dello stimolo della pagina**, pubblica il negozio e verifica il caricamento delle pagine pubbliche.
- **Previsione della campagna**, se disponibile, usa dati della campagna e non richiede una vetrina pubblicata.
- Rivedi il piano attuale o l'avviso di utilizzo prima di avviare il lavoro a pagamento.
- Scegli una vera domanda di vetrina e una pagina di destinazione.
- Tratta gli acquirenti generati come test direzionali, non come vera domanda dei clienti.
## Modalità
| Modalità | Quando usarla | Cosa fa Runner dopo l'avvio |
| --- | --- | --- |
| **Comportamento dell'acquirente** | Vuoi osservare la navigazione, le decisioni e l'attrito del percorso. | Avvia più percorsi di acquirenti sulla pagina live selezionata e prepara le visualizzazioni di imbuto, percorso, risultato e consiglio. |
| **Audit di stimolo della pagina** | Vuoi reazioni mirate a una pagina. | Raccoglie valutazioni degli acquirenti generati per l'intento di acquisto, i segmenti e l'attrito su quella pagina. |
## Controlli e risultati dei clic
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| Selettore della modalità | Sceglie **Comportamento degli acquirenti**, **Audit dello stimolo della pagina** o **Previsione della campagna**, quando abilitata. |
| Guida della persona | Aggiunge una direzione del pubblico opzionale, come sensibilità ai prezzi o preoccupazioni di spedizione. |
| **Pagina di destinazione** | Apre le pagine della vetrina pubblica scoperte come Home, Collezione, Prodotto, Carrello, Checkout o una pagina personalizzata. |
| Viewport del dispositivo | Sceglie solo mobile, solo desktop o un mix ponderato per il comportamento dell'acquirente. |
| Dimensione del pannello | Cambia il numero di percorsi degli acquirenti generati che l'esecuzione richiede all'interno dell'intervallo consentito. |
| **Avvia simulazione** | Avvia l'esecuzione configurata e apre la sua pagina di esecuzione. È disabilitato fino a quando non viene selezionata una pagina di destinazione. |
| Scheda di simulazione recente | Apre un'esecuzione precedente e il suo stato attuale o i risultati. |
| **Visualizza tutto** | Espande l'elenco di esecuzioni recenti quando esistono più esecuzioni. |
| **Riprova** | Ricarica le pagine di destinazione o le esecuzioni dopo un guasto visibile. |
## Avvia una simulazione mirata
1. Apri **Simulazione**.
2. Seleziona **Comportamento dell'acquirente** o **Audit di stimolo della pagina**.
3. Aggiungi una guida della persona concisa solo quando un pubblico specifico è importante.
4. Seleziona **Pagina di destinazione** e scegli una pagina live scoperta.
5. Per il comportamento dell'acquirente, scegli il mix di dispositivi e la dimensione del pannello.
6. Rivedi l'avviso di utilizzo attuale.
7. Seleziona **Avvia simulazione** una sola volta.
8. Segui la pagina di esecuzione fino al completamento o al fallimento.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Muro di pubblicazione | Nessuna distribuzione live riuscita è disponibile. Pubblica e verifica il negozio prima. |
| Nessuna pagina di destinazione | Runner non poteva scoprire le pagine pubbliche. Apri il negozio live e riprova il caricamento della pagina. |
| Nessuna simulazione ancora | Configura il pannello e la destinazione per creare la prima esecuzione. |
| In coda o in sospeso | L'esecuzione è stata accettata ma non ha avviato tutto il lavoro. Attendi piuttosto che avviare un duplicato. |
| In esecuzione | Il lavoro dell'acquirente è ancora in corso; i risultati possono rimanere incompleti. |
| Non riuscito | Apri l'errore mostrato nell'esecuzione e avvia una nuova esecuzione solo dopo aver corretto la destinazione o il guasto temporaneo. |
## Previsione campagna, quando disponibile
Questa modalità chiede a un pubblico generato di valutare una campagna anziché navigare in un negozio pubblicato.
1. Apri **Misura** → **Simulazione** e scegli **Previsione della campagna**, se compare.
2. Esamina i dati della campagna richiesti dal modulo.
3. Aggiungi la campagna da valutare e leggi l'avviso di consumo attuale.
4. Avvia la previsione solo quando dati e spesa richiesta sono corretti.
5. Apri lo spazio risultante ed esamina le viste disponibili **Società**, **Chat** e **Rapporto**.
**Verifica:** un report completato è una previsione generata per la campagna fornita. Non avvia annunci né misura prestazioni reali. Se la modalità manca, usane una disponibile o consulta [Disponibilità delle funzioni](../advanced/feature-availability).
## Guide correlate
- [Esecuzioni di simulazione e risultati](./simulation-runs-and-results)
- [Esperimenti](./experiments)
- [Panoramica di Analytics](../analytics-and-seo/analytics-overview)
---
# Aiuto e riferimento
Source: https://www.runnerai.com/docs/it/guides/help-and-reference
Inizia qui quando conosci il risultato che desideri ma lo schermo attuale non lo corrisponde.
| Situazione | Guida |
| --- | --- |
| Un pulsante è disabilitato, una pagina è vuota, una voce è mancante o Runner ti chiede di caricare la versione più recente | [Stati e disponibilità](/it/guides/help-and-reference/states-and-availability) |
| Un task di chat di Runner è in attesa, interrotto o non riuscito | [Risolvi i problemi dei task di Runner](/it/guides/help-and-reference/troubleshoot-runner-tasks) |
| La build o l'anteprima del negozio è sbagliata | [Risolvi i problemi delle build del negozio](/it/guides/help-and-reference/troubleshoot-storefront-builds) |
| La pubblicazione, il checkout o un'app non funzionano | [Risolvi i problemi di pubblicazione, checkout e app](/it/guides/help-and-reference/troubleshoot-publishing-checkout-apps) |
| Hai bisogno di una persona o vuoi segnalare un problema | [Supporto e comunità](/it/guides/help-and-reference/support-and-community) |
| Vuoi rivedere gli aggiornamenti del prodotto Runner | [Registro delle modifiche](/it/guides/help-and-reference/changelog) |
| Hai una breve domanda sul prodotto | [FAQ](/it/guides/help-and-reference/faq) |
| Un termine di Runner non ti è familiare | [Glossario](/it/guides/help-and-reference/glossary) |
## Scegli il percorso più breve
Usa una guida ai problemi quando qualcosa fallisce, **Assistenza e community** per questioni private di account o progetto, FAQ, glossario o riferimento degli stati per una definizione. Per la configurazione iniziale, parti da [Crea il tuo primo negozio](/it/guides/start-here/first-store-quickstart).
---
# Registro delle modifiche
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/changelog
Il registro delle modifiche raccoglie i rilasci dei prodotti in un unico posto, così puoi vedere cosa è cambiato senza lasciare Runner.
## Leggere il Changelog pubblico
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRzXySfwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXk)
Nel [Changelog pubblico](https://www.runnerai.com/changelog), leggi il mese accanto a **Monthly Update** e la sezione **What’s New**, poi scorri verso il basso per gli aggiornamenti precedenti. Non è necessario accedere. Il mese è una data, non un filtro.
Seleziona l’immagine per ingrandirla. Le annotazioni sono in inglese.
Le sezioni seguenti descrivono il Changelog del workspace quando disponibile. Filtri, indicatore dei contenuti non letti e controlli di ritorno appartengono a quella versione e non compaiono nella cronologia pubblica qui sopra.
## Cosa copre questa guida
Aprirai gli aggiornamenti recenti, li filtrerai per tipo, comprenderai il marcatore non letto e tornerai al negozio o all'area di lavoro corretta.
## Disponibilità e prerequisiti
- Solo il Changelog del workspace o del progetto richiede l’accesso; la pagina pubblica è disponibile senza account.
- Il punto non letto appare solo quando Runner ha un aggiornamento che non hai aperto.
- Un filtro cambia solo i rilasci mostrati su questa pagina; non cambia alcuna funzione del prodotto.
## Percorsi di accesso
| Accesso | Cosa accade dopo averlo selezionato |
| --- | --- |
| Barra laterale dell'area di lavoro → **Novità** | Apre tutti gli aggiornamenti dei prodotti disponibili all'interno dell'area di lavoro attuale. |
| Avatar del progetto desktop → **Novità** | Apre lo stesso registro delle modifiche mantenendo il progetto attuale come destinazione di ritorno. |
| Avatar del progetto mobile → **Novità** | Apre il registro delle modifiche dal foglio **Profilo e impostazioni**. |
| Barra laterale dell'area di lavoro compressa → anteprima dell'icona Novità → **Visualizza tutto** | Apre il registro delle modifiche completo dopo aver visualizzato in anteprima il rilascio più recente. |
Aprire il registro delle modifiche completo cancella il punto non letto. Questo contrassegna gli aggiornamenti come visti; non esegue o abilita le funzioni descritte in un rilascio.
## Filtra i rilasci
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Tutto** | Mostra ogni rilascio disponibile. |
| **In evidenza** | Mostra i rilasci categorizzati come nuove funzioni. |
| **Miglioramento** | Mostra i rilasci categorizzati come miglioramenti. |
| **Correzione** | Mostra i rilasci categorizzati come correzioni. |
| Scheda di rilascio | Mostra il titolo, la data, il tipo, la descrizione e i media disponibili di quel rilascio. |
| **Torna al negozio** | Ritorna al progetto attuale quando il registro delle modifiche è stato aperto lì; altrimenti ritorna all'elenco dei negozi dell'area di lavoro. |
Su mobile all'interno di un progetto, la shell del progetto fornisce il controllo indietro, quindi l'azione **Torna al negozio** a livello di pagina può essere nascosta.
## Rivedi un aggiornamento
1. Apri **Novità** dalla barra laterale dell'area di lavoro o dal menu dell'avatar.
2. Inizia con **Tutto** per vedere i rilasci in ordine di data.
3. Seleziona **In evidenza**, **Miglioramento** o **Correzione** quando hai bisogno di un tipo di cambiamento.
4. Leggi il titolo del rilascio, la data, la descrizione e i media inclusi.
5. Usa il controllo indietro per tornare al negozio o all'area di lavoro da cui sei venuto.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Punto rosso non letto | Un aggiornamento più recente non è stato aperto. Apri **Novità** per cancellarlo. |
| **Oggi** | La data di rilascio corrisponde al giorno attuale. |
| Nessun elemento sotto un filtro | Nessun rilascio disponibile ha quella categoria. Torna a **Tutto**. |
| Anteprima del rilascio più recente | Passare il mouse sull'icona desktop compresso può mostrare l'aggiornamento più recente. Seleziona **Visualizza tutto** per la cronologia completa. |
| Indietro ritorna a un ambito diverso | Riapri l'area di lavoro o il progetto previsto, quindi apri **Novità** da lì in modo che Runner abbia il contesto di ritorno corretto. |
## Usa una nota di rilascio per trovare il passo successivo
1. Apri **Registro modifiche** e scegli **In evidenza**, **Miglioramento**, **Correzione** o **Tutto**.
2. Leggi la voce datata che corrisponde al comportamento da imparare.
3. Torna con **Torna al negozio** e apri lo strumento dalla navigazione del progetto.
**Verifica:** l'elenco filtrato mostra la categoria scelta. Le note descrivono modifiche; piano e accesso attuali dello spazio determinano se puoi usarle.
## Guide correlate
- [Supporto e comunità](/it/guides/help-and-reference/support-and-community)
- [Navigazione e ricerca dell'area di lavoro](/it/guides/workspace/navigation-and-search)
- [Disponibilità delle funzioni](/it/guides/advanced/feature-availability)
---
# Domande frequenti
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/faq
**Percorso di accesso:** Documentazione di Runner → **Aiuto e riferimento** → **Domande frequenti**.
### Posso iniziare senza esperienza tecnica?
Sì. Descrivi l'azienda e l'esperienza cliente desiderata in linguaggio semplice. Runner potrebbe fare domande di follow-up prima di iniziare il lavoro. Vedi [Scrivi richieste efficaci](../work-with-runner/write-effective-requests).
### Devo creare un nuovo negozio o connettere Shopify?
Scegli **Crea nuovo** quando Runner dovrebbe creare il progetto del negozio e la sua configurazione di commercio. Scegli **Connetti Shopify** quando Shopify dovrebbe rimanere il sistema di negozio connesso e il percorso di checkout. Vedi [Crea un negozio Runner](../start-here/create-runner-store) e [Connetti Shopify](../start-here/connect-shopify).
### Un'attività completata di Runner significa che il mio negozio è live?
No. Il completamento dell'attività, il successo dell'anteprima, la pubblicazione, lo storefront live, il catalogo e il checkout sono risultati separati. Verifica ogni livello rilevante.
### Qual è la differenza tra Pubblica e Ripubblica?
**Pubblica** crea la prima versione live dopo il completamento dei requisiti. **Ripubblica** invia le modifiche bozza più recenti a un negozio che ha già una versione live. Vedi [Pubblica e ripubblica](../storefront-and-publishing/publish-and-republish).
### Perché un pulsante è disabilitato?
Potrebbe mancare input richiesto, autorizzazione, accesso al piano, stato del negozio, dati o una connessione. Leggi il testo vicino e vedi [Stati e disponibilità](./states-and-availability).
### Perché una voce di navigazione è mancante?
Alcune funzioni sono condizionali o in fase. Conferma l'area di lavoro, il negozio, il ruolo, il piano, la pubblicazione e le connessioni. Vedi [Disponibilità delle funzioni](../advanced/feature-availability).
### Dove gestisco i prodotti e gli ordini?
Apri il progetto del negozio, seleziona **Operazioni del negozio**, quindi scegli **Prodotti** o **Ordini**. Vedi [Operazioni del negozio](../store-operations).
### Dove connetto pagamenti, email o spedizione?
Apri il progetto e seleziona **App**. Scegli il provider e segui il suo flusso di connessione ufficiale. Vedi [App e integrazioni](../apps-and-integrations).
### Come annullo una modifica dello storefront?
Prima invia una correzione mirata o usa [Cronologia versioni](../storefront-and-publishing/version-history). Il ripristino di una versione cambia lo stato del progetto, quindi rivedi la versione selezionata prima di confermare.
### Perché Analytics o SEO sono vuoti?
Il negozio selezionato, l'intervallo di date, la pubblicazione o la raccolta di eventi potrebbero non avere ancora dati. Uno stato vuoto è diverso da uno stato di caricamento o errore. Vedi [Analytics e SEO](../analytics-and-seo).
### Dove vedo crediti e utilizzo?
Apri le impostazioni dell'area di lavoro e seleziona la destinazione di utilizzo o fatturazione disponibile per il tuo ruolo. Vedi [Crediti e utilizzo](../plans-and-billing/credits-and-usage).
### Come ottengo aiuto?
Usa [Supporto e comunità](./support-and-community). Includi la pagina esatta, l'azione, lo stato visibile e uno screenshot sicuro per la privacy.
## Da dove comincio?
Per una prima creazione guidata con screenshot e registrazioni, segui [Crea il tuo primo negozio](../start-here/first-store-quickstart). Se il lavoro è già in corso, usa [Risolvi i problemi delle attività Runner](./troubleshoot-runner-tasks) prima di inviare di nuovo la stessa richiesta.
---
# Glossario
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/glossary
**Percorso di accesso:** Documentazione di Runner → **Aiuto e riferimento** → **Glossario**.
| Termine | Significato in Runner |
| --- | --- |
| Agente | Capacità di Runner che utilizzano competenze riutilizzabili e la memoria del progetto o dello spazio di lavoro. |
| App | Una connessione tra Runner e un altro servizio, o una capacità a livello di agente mostrata nella pagina App. |
| Artifact | Un output prodotto durante un'attività o un flusso di lavoro, come un report, file, anteprima o risultato di attività precedente. |
| Automazione | Un'azione configurata che viene eseguita da un trigger o programma quando disponibile. |
| Chat | Una conversazione di progetto in cui richiedi e rivedi il lavoro. |
| Checkout | Il percorso cliente che raccoglie spedizione e pagamento per creare un ordine. |
| Crediti | Quota di utilizzo dello spazio di lavoro mostrata nel prodotto corrente. La pagina di fatturazione online è autorevole. |
| Modalità Design | Una vista di modifica della vetrina per selezionare e modificare il contenuto visibile. |
| DNS | I record internet che collegano un nome di dominio alla vetrina corretta. Runner mostra i valori da copiare presso il fornitore del dominio. |
| Bozza | Un negozio senza una pubblicazione online corrente. |
| Endpoint | Un indirizzo di destinazione utilizzato da un'integrazione, come un ricevitore webhook. Tratta gli indirizzi degli endpoint e le loro credenziali come sensibili. |
| Esperimento | Un confronto controllato utilizzato per misurare una modifica quando la funzione è disponibile. |
| Fly | Un'area di lavoro di missione guidata condizionale. |
| Evasione | Il lavoro di preparazione e invio degli articoli di un ordine, inclusi eventuali passaggi supportati del fornitore o del corriere. |
| Memoria | Contesto salvato che Runner può riutilizzare nel suo ambito definito. |
| Libreria multimediale | L'area del progetto per le risorse visive generate o caricate. |
| Anteprima | La vista della vetrina del progetto corrente prima o indipendentemente dalla pubblicazione. |
| Progetto | Lo spazio di lavoro Runner specifico del negozio che contiene chat, vetrina, operazioni, app e strumenti. |
| Fornitore | Un servizio esterno connesso a Runner per pagamenti, spedizione, email, approvvigionamento, analisi o un'altra attività supportata. |
| Pubblica | Crea la prima versione online dopo il superamento dei requisiti. |
| Ripubblica | Invia le modifiche di bozza più recenti a un negozio che ha già una versione online. |
| Ricerca | Un'area di lavoro condizionale per studi e report aziendali strutturati. |
| Sessione (Analisi) | Una visita registrata alla vetrina utilizzata nei report di traffico e conversione. È diversa da una sessione autenticata dell'account. |
| Sessione (Account) | Una connessione autenticata a Runner su un browser o dispositivo che può essere rivista o revocata nelle impostazioni di sicurezza. |
| Simulazione | Uno strumento per eseguire uno scenario configurato e rivedere il suo risultato quando disponibile. |
| Competenza | Un insieme riutilizzabile di istruzioni o un flusso di lavoro che Runner può applicare al lavoro. |
| SKU | Un codice definito dal negozio utilizzato per identificare un prodotto o variante per inventario e operazioni. |
| Operazioni del negozio | Pagine di prodotto, ordine, cliente, promozione, spedizione, approvvigionamento e gestione del negozio. |
| Attività | Un'unità di lavoro che Runner traccia all'interno di una conversazione. |
| Variante | Una versione acquistabile di un prodotto, come una particolare taglia o colore, con il suo prezzo o inventario. |
| Versione | Uno stato salvato della vetrina mostrato nella Cronologia versioni. |
| Webhook | Una consegna configurata di un evento di progetto supportato a un altro servizio. |
| Workflow | Un flusso di progetto multi-step riutilizzabile quando la funzione è abilitata. |
| Spazio di lavoro | Il confine di team e fatturazione che contiene negozi, membri, impostazioni, crediti e notifiche. |
## Usa i termini in una procedura reale
Segui [Crea il tuo primo negozio](../start-here/first-store-quickstart) per vedere conversazione, attività, anteprima e controlli di pubblicazione nel loro contesto. Per un messaggio di stato, usa [Stati e disponibilità](./states-and-availability) e scegli l'azione successiva.
## Guide correlate
- [Ti diamo il benvenuto in Runner AI](../product-guide)
- [Stati e disponibilità](./states-and-availability)
- [Disponibilità delle funzioni](../advanced/feature-availability)
---
# Stati e disponibilità
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/states-and-availability
Runner utilizza gli stati per dirti se un'azione è pronta, in attesa, completata, bloccata o non disponibile. Leggi lo stato prima di riprovare o modificare le impostazioni.
**Percorso di accesso:** Documentazione di Runner → **Aiuto e riferimento** → **Stati e disponibilità**.
## Stati del negozio e della pubblicazione
| Stato | Significato | Passo successivo sicuro |
| --- | --- | --- |
| Bozza | Il progetto attualmente non ha una versione pubblicata live. | Continua a costruire e completa i requisiti di pubblicazione. |
| Distribuzione in corso | Runner sta preparando una pubblicazione. | Attendi il completamento dello stato; non avviare pubblicazioni ripetute. |
| Pubblicato | Esiste una versione live. | Apri l'URL live e verifica il cambiamento previsto. |
| Pubblicazione bloccata | Uno o più elementi di configurazione richiesti sono incompleti. | Apri il requisito denominato e completalo. |
| Ripubblicazione disponibile | La bozza contiene modifiche più recenti della versione live. | Rivedi l'anteprima, quindi ripubblica quando sei pronto. |
## Stati dei compiti
| Stato | Significato | Passo successivo sicuro |
| --- | --- | --- |
| In attesa di te | Runner ha bisogno di una risposta, scelta, approvazione o dettaglio mancante. | Apri la domanda e rispondi una volta. |
| In corso | Il task attuale è ancora in esecuzione. | Segui i suoi dettagli invece di avviare una richiesta duplicata. |
| Completato | Runner ha raggiunto lo stato di successo terminale del task. | Verifica il risultato visibile nella pagina interessata. |
| Interrotto | Il lavoro è terminato prima del completamento. | Leggi perché è stato interrotto, correggi la causa, quindi continua o invia un follow-up mirato. |
| Non riuscito | Il task non è riuscito a terminare. | Salva l'errore visibile e riprova solo dopo aver controllato la causa. |
## Stati di pagina e controllo
| Cosa vedi | Significato |
| --- | --- |
| Pulsante disabilitato | Input richiesto, autorizzazione, piano o stato mancante. Il testo vicino di solito lo nomina. |
| Scheletro di caricamento o spinner | I dati vengono richiesti. Uno stato di caricamento persistente necessita di un ricaricamento o un controllo di supporto. |
| Stato vuoto | La pagina è disponibile ma il contesto selezionato non ha ancora elementi. Usa l'azione di creazione o connessione offerta. |
| Messaggio di aggiornamento | Il piano attuale o il limite non consente l'azione. Rivedi l'offerta live in **Piano e fatturazione**. |
| Connetti o riconnetti | Il servizio esterno non è connesso o ha bisogno di autorizzazione di nuovo. |
| Pagina non trovata | L'URL non è disponibile per il contesto attuale, è ritirato o è bloccato. Ritorna attraverso la navigazione visibile. |
## Recupero della versione di Runner
Se Runner è stato aggiornato mentre la tua scheda era aperta, una pagina di recupero a schermo intero può sostituire la vista attuale. Non puoi chiuderla o usare la pagina dietro di essa finché Runner non carica una copia attuale.
| Cosa vedi | Cosa succede dopo |
| --- | --- |
| **Una versione più recente di Runner è pronta** | Seleziona **Carica la versione più recente** per ricaricare la scheda attuale con la versione più recente di Runner. |
| **Sei offline** | **Carica la versione più recente** non è disponibile. Riconnettiti a Internet; l'azione diventa disponibile senza lasciare la pagina di recupero. |
| **Caricamento della versione più recente…** | Runner sta ricaricando la scheda. Mantienila aperta mentre l'azione finisce. |
| **Non è stato possibile caricare la versione più recente** | Controlla la connessione, quindi seleziona **Riprova**. |
| **Dettagli tecnici** | Espande il codice di errore, il motivo e l'ora di rilevamento per la risoluzione dei problemi. Non riprova o ripara la pagina. |
## Diagnostica in ordine
1. Conferma il workspace e il negozio selezionati.
2. Espandi **Crea**, **Cresci** o **Misura** per trovare lo strumento, poi leggi lo stato, l'avviso o il prerequisito più vicino.
3. Controlla se il task rilevante è già in esecuzione.
4. Conferma il tuo ruolo, piano, stato di pubblicazione e connessione app richiesta.
5. Ricarica una volta se lo stato dovrebbe essere appena cambiato.
6. Usa la guida di risoluzione dei problemi pertinente prima di ripetere un'azione ad alto impatto.
## Guide correlate
- [Disponibilità delle funzionalità](../advanced/feature-availability)
- [Stati e dettagli dei task](../work-with-runner/task-states-and-details)
- [Stati del negozio](../workspace/store-statuses)
- [Supporto e comunità](./support-and-community)
---
# Supporto e comunità
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/support-and-community
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa la documentazione per i flussi di lavoro noti, la comunità per l'apprendimento condiviso e il supporto per problemi specifici dell'account o problemi di prodotto riproducibili.
## Cosa copre questa guida
Saprai dove si apre ogni azione di aiuto, come prenotare una demo o inviare feedback e cosa includere quando hai bisogno di supporto.
## Disponibilità e prerequisiti
- Devi essere firmato per utilizzare i menu dell'avatar dell'area di lavoro o del progetto.
- **Invia feedback** appare solo nelle visualizzazioni dell'area di lavoro o del progetto desktop che espongono l'azione di feedback.
- **Prenota una demo** utilizza un servizio di pianificazione esterno all'interno di Runner e ha bisogno di una connessione di rete funzionante.
- Il foglio dell'avatar mobile ha un set di azioni più piccolo rispetto al menu dell'avatar desktop.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgNbwG0GU2bm17vuEiZydJjwfYlOaXgBTsQ69k)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il menu di aiuto Chat collega la guida contestuale e il Centro assistenza. La miniatura del tutorial è oscurata in questa illustrazione; non è stato riprodotto alcun video né inviata alcuna segnalazione all’assistenza.
## Percorsi di accesso
| Accesso | Cosa succede dopo che lo selezioni |
| --- | --- |
| Pulsante di aiuto della pagina → **Centro assistenza** | Apre la documentazione Runner. |
| Pannello di aiuto → **In questa pagina — Chat** | Apre la guida alla pagina Chat attuale quando questo contesto compare. |
| Pannello di aiuto → **Il tuo primo negozio in cinque minuti** | Apre il tutorial introduttivo collegato. |
| Barra laterale dello spazio → **Centro assistenza**, se compare | Apre la documentazione Runner. |
| Barra laterale dell'area di lavoro → **Comunità** | Apre la comunità di Runner nella sua destinazione corrente. |
| Barra laterale dell'area di lavoro → **Blog** | Apre articoli educativi e aziendali. |
| Barra laterale dell'area di lavoro → **Novità** | Apre i recenti aggiornamenti del prodotto Runner. |
| Menu dell'avatar desktop → **Prenota una demo** | Apre il pannello di pianificazione all'interno di Runner. |
| Menu dell'avatar desktop → **Invia feedback** | Apre il modulo di feedback quando tale azione è disponibile nella visualizzazione corrente. |
| Menu dell'avatar desktop → **Aiuto** | Apre la documentazione di Runner. |
| Menu dell'avatar del progetto → **Comunità**, **Blog** o **Novità** | Apre la risorsa selezionata; Novità rimane all'interno di Runner, mentre Comunità e Blog aprono le loro destinazioni correnti. |
| Documentazione → **Supporto** | Apre l'azione di supporto email configurata. |
## Parti dalla guida della pagina attuale
1. Apri il pulsante di aiuto della pagina.
2. Scegli la guida **In questa pagina** se risponde alla domanda, oppure **Centro assistenza** per sfogliare la documentazione.
3. Se stai creando un negozio, scegli **Il tuo primo negozio in cinque minuti**, quando offerto.
**Verifica:** si apre una destinazione di aiuto; non viene inviata una richiesta di assistenza o prenotazione. I link contestuali variano con la vista attuale.
## Prenota una demo
1. Su desktop, apri il menu dell'avatar e seleziona **Prenota una demo**.
2. Attendi il caricamento dello scheduler.
3. Scegli una data e un'ora disponibili, quindi completa i dettagli di contatto richiesti dallo scheduler.
4. Conferma la prenotazione nello scheduler.
5. Attendi il messaggio di successo di Runner e la chiusura del pannello.
La chiusura del pannello prima che lo scheduler confermi l'incontro non crea una prenotazione. Se lo scheduler rimane vuoto o segnala che non è disponibile, chiudilo, controlla la connessione e riprova una volta. Usa l'azione di supporto della documentazione se ripetutamente non riesce.
## Invia feedback
1. Su desktop, apri il menu dell'avatar e scegli **Invia feedback**, se compare.
2. Descrivi pagina, azione, risultato atteso e risultato effettivo.
3. Aggiungi una categoria facoltativa e uno screenshot dopo aver rimosso le informazioni private.
4. Rileggi la segnalazione prima di **Invia**. Chiudi il modulo se vuoi solo esaminarlo.
5. Dopo l'invio, attendi la conferma prima di considerare inviata la segnalazione.
| Controllo | Cosa succede dopo che lo usi |
| --- | --- |
| **Descrivi il tuo feedback** | Registra la spiegazione richiesta. Invia rimane non disponibile fino a quando questo campo non contiene testo. |
| **Problemi di usabilità** / **Funzioni mancanti** | Aggiunge una categoria facoltativa in modo che il report sia più facile da instradare. |
| Caricamento screenshot | Allega un'immagine facoltativa al report. Usa il controllo di rimozione per scartare l'allegato prima di inviare. |
| **Invia** | Invia il report. Mentre viene inviato, l'azione non può essere inviata di nuovo. |
| Chiudi | Chiude il modulo senza inviare un nuovo report. |
Descrivi un comportamento, la pagina in cui è accaduto e cosa ti aspettavi. Aggiungi uno screenshot solo dopo aver rimosso le informazioni sui clienti, le email, i dettagli di pagamento, le credenziali e altri dati privati. Dopo un invio riuscito, Runner mostra una conferma e chiude il modulo. Se l'invio non riesce, mantieni la descrizione, controlla l'allegato e la connessione e riprova una volta.
## Menu dell'avatar mobile
Su mobile, l'avatar del progetto apre **Profilo e impostazioni**. Include **Lingua**, **Posta in arrivo**, **Aiuto**, **Comunità**, **Blog**, **Novità** ed **Esci**. **Prenota una demo** e **Invia feedback** non sono elencati in questo foglio mobile. Usa una visualizzazione desktop più ampia per queste due azioni, o usa l'azione di supporto della documentazione per un problema privato.
## Invia un utile rapporto di supporto
Includi:
1. Il nome dell'area di lavoro e del negozio, senza segreti.
2. La pagina e il percorso di accesso esatto.
3. Cosa hai selezionato e cosa è successo.
4. Cosa ti aspettavi invece.
5. Il testo di stato o errore visibile.
6. Se il problema si ripete dopo un ricaricamento.
7. Uno screenshot con dati cliente, email, dettagli di pagamento e segreti rimossi.
Per un'attività di Runner, includi la conversazione e lo stato dell'attività. Per la pubblicazione, includi lo stato dell'anteprima, lo stato della pubblicazione e se l'URL live è cambiato. Per un'app, includi il fornitore e lo stato di connessione visualizzato, ma mai credenziali o chiavi API.
## Scegli il canale
| Necessità | Punto di partenza migliore |
| --- | --- |
| Imparare un normale flusso di lavoro del prodotto | Cerca queste guide. |
| Confrontare approcci con altri utenti | Comunità. |
| Seguire una modifica del prodotto rilasciata | Registro delle modifiche. |
| Risolvere accesso, fatturazione, dati, errori ripetuti o comportamento privato del progetto | Supporto. |
## Risoluzione dei problemi
| Stato | Significato e passo successivo |
| --- | --- |
| Lo scheduler della demo è in caricamento | Attendi i suoi controlli di data e ora prima di interagire. |
| Demo confermata | Runner mostra un messaggio di successo e chiude il pannello. Controlla i dettagli di conferma inviati dallo scheduler. |
| L'invio del feedback non è disponibile | Aggiungi la descrizione richiesta o attendi il completamento dell'invio corrente. |
| Il caricamento del feedback non riesce | Rimuovi l'allegato e riprova con un'immagine supportata e sicura per la privacy, o invia il testo senza di essa. |
| L'invio del feedback non riesce | Il report non è stato confermato. Mantieni il testo e riprova una volta prima di utilizzare il supporto. |
## Guide correlate
- [Risolvi i problemi delle attività di Runner](./troubleshoot-runner-tasks)
- [Risolvi i problemi delle compilazioni dello storefront](./troubleshoot-storefront-builds)
- [Risolvi i problemi di pubblicazione, checkout e app](./troubleshoot-publishing-checkout-apps)
- [Registro delle modifiche](/it/guides/help-and-reference/changelog)
---
# Risolvi i problemi di pubblicazione, checkout e app
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/troubleshoot-publishing-checkout-apps
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Una compilazione riuscita non prova di per sé la pubblicazione, i dati del catalogo, il checkout o un provider esterno. Verifica ogni livello separatamente.
**Percorsi di accesso:** negozio interessato → **Negozio online** → **Pubblica** per i controlli; **Crea** → **App** per le connessioni dei fornitori.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il controllo di compilazione passa, ma la configurazione incompleta lascia Conferma disabilitato. Risolvi il requisito indicato prima di riprovare la pubblicazione.
## Prima di iniziare
- Registra il negozio interessato, l'URL pubblico, il provider e lo stato visibile esatto.
- Fermati prima di un addebito reale, ordine, disconnessione del provider o altra azione consequenziale a meno che il test non sia autorizzato.
- Verifica un livello alla volta; un'anteprima funzionante non prova la pubblicazione o il checkout.
## Controlli e risultati importanti
| Controllo | Cosa succede dopo che lo selezioni |
| --- | --- |
| **Riprova il controllo** | Esegue di nuovo il controllo di pubblicazione o disponibilità di checkout non riuscito. Non corregge la causa denominata. |
| **Pubblica** / **Ripubblica** | Avvia la pubblicazione dopo il superamento dei controlli richiesti; non prova il comportamento del catalogo o del checkout. |
| **Connetti Stripe** | Apre il percorso di connessione del pagamento. Nessun pagamento viene accettato fino a quando il provider e il checkout live non sono utilizzabili. |
| **Riconnetti** in App | Riavvia il flusso di autorizzazione ufficiale del provider per la connessione esistente. |
## Identifica il livello che non funziona
| Livello | Prova da cercare | Se manca |
| --- | --- | --- |
| Anteprima | La pagina e l'interazione previste funzionano in **Negozio online**. | Correggi la compilazione o il contenuto prima di pubblicare. |
| Pubblicazione | Runner mostra uno stato pubblicato riuscito e un URL live. | Apri lo stato di pubblicazione e risolvi il requisito o l'errore denominato. |
| Vetrina online | L'URL live mostra la versione prevista in una visita nuova. | Controlla se le modifiche più recenti richiedono **Ripubblica**. |
| Catalogo | Il prodotto, il prezzo, la disponibilità e la scelta di spedizione previsti sono visibili. | Correggi i dati di Operazioni del negozio e la disponibilità della vetrina. |
| Checkout | Un test sicuro può raggiungere il checkout previsto e le scelte di pagamento/spedizione. | Controlla lo stato di pagamento, spedizione, modalità negozio e provider. Non effettuare un ordine reale a meno che non sia autorizzato. |
| Fornitore | L'app risulta connessa e il fornitore conferma l'account previsto. | Riconnetti attraverso il flusso ufficiale dell'app e ricontrolla le autorizzazioni. |
## Recupero della pubblicazione
1. Apri **Negozio online** → **Pubblica** e leggi i controlli. Fermati se mancano Stripe, spedizioni o altri requisiti indicati; risolvili con [Preparati a pubblicare](../storefront-and-publishing/prepare-to-publish) prima di riprovare.
2. Controlla se un'altra pubblicazione è già in **Distribuzione**.
3. Se la pubblicazione non riesce, preserva l'errore visualizzato.
4. Riprova una sola volta dopo che la causa denominata è stata risolta.
5. Apri l'URL live dopo il successo e verifica la pagina prevista.
## Recupero del checkout
1. Conferma che almeno un prodotto vendibile è visibile nel negozio live.
2. Conferma che la spedizione si applica alla destinazione del test.
3. Conferma che l'app di pagamento è connessa alla modalità e all'account previsti.
4. Raggiungi il checkout attraverso lo storefront live piuttosto che un URL indovinato diretto.
5. Fermati prima di un addebito reale o ordine a meno che il test non sia esplicitamente autorizzato.
## Recupero dell'app
1. Apri **Crea** → **App** e seleziona il fornitore.
2. Leggi lo stato visualizzato: non connesso, connesso, ha bisogno di attenzione o non disponibile.
3. Riconnetti solo attraverso la finestra di autorizzazione ufficiale del provider.
4. Conferma l'account e le autorizzazioni restituite.
5. Verifica il risultato effettivo a valle; un badge di connessione verde da solo non è prova end-to-end.
### Guarda: esamina un blocco della pubblicazione
La registrazione esamina i controlli e sceglie Annulla. Non pubblica il negozio né completa un checkout.
## Guide correlate
- [Pubblica e ripubblica](../storefront-and-publishing/publish-and-republish)
- [Negozio live e checkout](../storefront-and-publishing/live-store-and-checkout)
- [Connetti, gestisci e riconnetti app](../apps-and-integrations/connect-manage-reconnect)
- [Risoluzione dei problemi delle app](../apps-and-integrations/troubleshooting)
---
# Risolvi i problemi dei task di Runner
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/troubleshoot-runner-tasks
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Risolvi i problemi a partire dai dettagli del task corrente. Ripetere la stessa richiesta senza controllarne lo stato può creare lavoro duplicato e nascondere la causa originale.
## Percorso di accesso
Apri il negozio interessato, torna alla conversazione, quindi apri lo stato o i dettagli del task corrente.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Una domanda in attesa richiede una risposta prima che il lavoro prosegua. Controlla l'ultima domanda prima di reinviare la stessa richiesta.
## Prima di iniziare
- Mantieni la conversazione originale aperta per non perdere lo stato visibile o l'errore.
- Attendi che qualsiasi azione attiva si stabilizzi prima di riprovare.
- Non includere segreti, dettagli di pagamento o dati dei clienti nelle prove copiate.
## Elenco di controllo per il recupero
1. Conferma di essere nella conversazione in cui il lavoro è iniziato.
2. Leggi il messaggio più recente di Runner e lo stato del task.
3. Se Runner ha fatto una domanda, rispondi a quella domanda prima di inviare una nuova richiesta.
4. Se il task è interrotto, identifica se ha bisogno di input, accesso, crediti o una richiesta corretta.
5. Se non è riuscito, copia l'errore visibile senza includere segreti o dati dei clienti.
6. Riprova una sola volta quando la pagina offre un tentativo e la causa è transitoria.
7. Altrimenti invia un follow-up mirato che indichi il risultato desiderato e cosa non va attualmente.
8. Verifica il negozio interessato, l'impostazione o l'asset dopo che Runner segnala il completamento.
## Problemi comuni
| Problema | Cosa fare |
| --- | --- |
| Nulla accade dopo l'invio | Conferma che il messaggio appaia nella conversazione e controlla i dettagli del task per uno stato di attesa. |
| Runner pone domande ripetute | Rispondi a ogni campo obbligatorio direttamente ed evita di cambiare l'obiettivo nella stessa risposta. |
| Il task si interrompe per crediti | Apri le impostazioni di utilizzo o piano; non riprendere ripetutamente il lavoro invariato. |
| Il risultato è incompleto | Nomina il risultato visibile mancante in un follow-up. Allega uno screenshot quando aiuta a individuare il problema. |
| La pagina sbagliata è stata modificata | Usa la cronologia delle versioni quando appropriato, quindi identifica la pagina o la sezione esatta nella correzione. |
| Un tentativo fallisce allo stesso modo | Smetti di riprovare e contatta il supporto con la conversazione, lo stato del task e l'errore. |
## Pulsanti e risultati
| Controllo | Risultato |
| --- | --- |
| Dettagli del task | Apre lo stato, l'avanzamento e qualsiasi informazione di risultato disponibile. |
| Controllo di risposta o opzione | Invia la decisione richiesta e consente al task di continuare. |
| Interrompi, quando disponibile | Termina l'esecuzione corrente; il lavoro non completato può rimanere incompleto. |
| Riprova o continua | Avvia un altro tentativo dallo stato che Runner supporta. Usalo solo dopo aver controllato la causa. |
| Nuova chat | Avvia una conversazione separata; non ripara automaticamente il task originale. |
## Conferma il recupero prima di un'altra richiesta
Dopo aver risposto, controlla che la risposta compaia e l'attività esca dallo stato di attesa. Dopo una correzione, ripeti l'azione interessata nel negozio. Se Runner non può sapere se un'azione esterna è stata completata, verificane l'esito prima di riprovare per evitare duplicati. Consulta [Stati e dettagli delle attività](../work-with-runner/task-states-and-details) per i controlli della conversazione attuale.
## Guide correlate
- [Chat con Runner](../work-with-runner/chat-with-runner)
- [Quando Runner pone una domanda](../work-with-runner/answer-runner-questions)
- [Scrivi richieste efficaci](../work-with-runner/write-effective-requests)
- [Supporto e comunità](./support-and-community)
---
# Risolvi i problemi delle build del negozio
Source: https://www.runnerai.com/docs/it/guides/help-and-reference/troubleshoot-storefront-builds
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
L'anteprima è il posto più sicuro per trovare i problemi del negozio. Non pubblicare finché le pagine importanti e le interazioni non funzionano lì.
**Percorso di accesso:** negozio interessato → **Negozio online** → controlli dell'anteprima.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Usa l'anteprima attuale della Vetrina e i controlli dei dispositivi per riprodurre la pagina interessata prima di pubblicare.
## Prima di iniziare
- Apri il negozio interessato e identifica la pagina e la larghezza del dispositivo in cui appare il problema.
- Lascia che l'ultimo task di Runner si completi prima di confrontare il suo risultato con l'anteprima.
- Usa prima l'anteprima; non pubblicare un risultato interrotto o incerto come test.
## Inizia nel negozio
1. Apri il negozio interessato e seleziona **Negozio**.
2. Conferma che l'anteprima mostra il progetto previsto e la versione più recente.
3. Ricarica l'anteprima una volta.
4. Controlla le visualizzazioni desktop e dispositivi mobili.
5. Apri la pagina interessata attraverso la navigazione dell'anteprima.
6. Confronta il risultato con l'ultimo task di Runner e la cronologia delle versioni.
## Problemi comuni
| Cosa vedi | Cosa controllare |
| --- | --- |
| Anteprima vuota o di errore | Attendi il completamento della build attiva, ricarica una volta e ispeziona il task corrente per un errore. |
| Contenuto vecchio | Conferma che l'ultimo task sia completato e che l'anteprima sia sulla versione più recente. |
| Il layout si interrompe a una larghezza | Riproducilo con i controlli del dispositivo e comunica a Runner la pagina, la sezione e la larghezza. |
| Immagine mancante | Controlla la libreria multimediale, la selezione dell'asset e se l'immagine stessa si carica. |
| Il collegamento apre la pagina sbagliata | Nomina il pulsante di origine e la destinazione prevista in una correzione mirata. |
| Il prodotto è mancante | Verifica che il prodotto esista e sia disponibile per il negozio, non solo che la pagina appaia raffinata. |
| La modifica della modalità di progettazione è assente | Conferma che la modifica sia stata salvata o applicata, quindi riapri la stessa pagina nell'anteprima. |
## Controlli utili
| Controllo | Risultato |
| --- | --- |
| Aggiorna anteprima | Ricarica l'anteprima corrente senza pubblicarla. |
| Selettore dispositivo | Cambia la larghezza dell'anteprima in modo da poter ispezionare i layout reattivi. |
| Apri anteprima o visualizzazione esterna | Apre un'anteprima più grande; non rende il negozio attivo. |
| Modalità di progettazione | Ti consente di selezionare e regolare il contenuto del negozio visibile. |
| Cronologia delle versioni | Mostra le versioni salvate e i controlli di ripristino. Il ripristino cambia lo stato del progetto, quindi rivedi prima. |
## Escalation con prove utili
Includi il nome del progetto, la pagina, la dimensione del dispositivo, il risultato previsto, il risultato visibile, lo stato del task più recente e uno screenshot senza dati personali o dei clienti.
## Verifica la correzione
Dopo la riparazione, ricarica la stessa pagina e ripeti l'interazione alla larghezza originale. Controlla una seconda larghezza prima di pubblicare. Una homepage funzionante non verifica la riparazione di una pagina prodotto o di un carrello guasti.
### Guarda: confronta le larghezze dell'anteprima
La registrazione passa tra anteprime PC, Tablet e Telefono. Mostra come confrontare le larghezze, non una riparazione o una modifica pubblicata.
## Guide correlate
- [Visualizza l'anteprima del tuo negozio](../storefront-and-publishing/preview-your-store)
- [Modalità di progettazione](../storefront-and-publishing/design-mode)
- [Cronologia delle versioni](../storefront-and-publishing/version-history)
- [Risolvi i problemi dei task di Runner](./troubleshoot-runner-tasks)
---
# Apri il tuo primo negozio
Source: https://www.runnerai.com/docs/it/guides/open-your-first-store
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Questa guida è un unico percorso ordinato, da un'idea di business a un negozio in grado di incassare denaro. È scritta per chi non ha mai venduto nulla online, quindi spiega i concetti di e-commerce lungo il percorso.
È la prima volta che usi Runner? Segui [Crea il tuo primo negozio](./start-here/first-store-quickstart), con screenshot e brevi video, poi torna qui per configurare prodotti, spedizioni, pagamenti e dati dell’attività.
Per iniziare servono un'idea e un indirizzo email. Partita IVA, dominio e account Stripe arrivano più avanti, nei passaggi in cui servono davvero.
Vendi già su Shopify? Usa invece [Collega Shopify](./start-here/connect-shopify). Questa guida descrive la creazione di un negozio da zero.
## Tre stati e perché sono distinti
Un negozio attraversa tre stati, che non avvengono nello stesso momento. Sapere in quale ti trovi evita gran parte della confusione di questo processo.
| Stato | Cosa significa | Cosa non significa |
| --- | --- | --- |
| **Anteprima** | Runner ha creato la tua vetrina e puoi guardarla. | Non è pubblica. |
| **Pubblicato** | Il negozio ha un indirizzo web pubblico e chiunque può visitarlo. | La sola pubblicazione non dimostra che il checkout sia pronto; occorre verificare anche la configurazione dei pagamenti e del fornitore. |
| **Checkout pronto** | Stripe è collegato e un ordine può essere pagato. | Questo è il momento in cui il negozio è aperto al pubblico. |
La pubblicazione è il passaggio 7. I pagamenti sono il passaggio 9. Un negozio online non è necessariamente un negozio funzionante.
## Come usare questa guida
Undici passaggi in quattro gruppi.
| Gruppo | Passaggi |
| --- | --- |
| **Creare** | 1. Decidere cosa vendere · 2. Creare la vetrina |
| **Configurare** | 3. Dati del negozio · 4. Prodotti · 5. Spedizione · 6. Policy e fiducia |
| **Andare online** | 7. Verificare e pubblicare · 8. Dominio personalizzato (facoltativo) · 9. Collegare i pagamenti |
| **Crescere** | 10. Primi visitatori · 11. Gestione settimanale |
Segui l'ordine. Diversi passaggi successivi falliscono silenziosamente se uno precedente è incompleto: la spedizione non si salva senza una posizione di magazzino, i prodotti non mostrano prezzi senza un mercato, e il passaggio del dominio richiede prima una pubblicazione riuscita. Il passaggio 8 fa eccezione: è facoltativo e puoi farlo in qualsiasi momento dopo la pubblicazione.
Ogni passaggio termina con qualcosa che puoi verificare da solo. La **Checklist di lancio** alla fine di questa guida le raccoglie tutte in un unico punto.
Runner non si limita a creare la vetrina. Può fare ricerche su cosa vendere, suggerire prodotti, scrivere descrizioni, creare e aggiornare i record del catalogo e redigere le tue pagine di policy. Ogni passaggio include prompt da copiare in chat. Se qualcosa non funziona, descrivilo: Runner può leggere lo stato attuale del negozio e indicare cosa manca.
Le competenze forniscono a Runner istruzioni ripetibili per un tipo di lavoro. Apri **Agente** nella barra laterale, seleziona **Competenze**, poi usa **Scopri** e cerca l'attività, come `market research`, `product description`, `policy` o `SEO`. Consulta [Competenze](./agent/skills).
**Se compare prima un assistente di configurazione.** I nuovi negozi possono aprire una configurazione guidata che chiede in un'unica sequenza i dati di base, la spedizione, un primo prodotto, il pagamento e la visibilità. Copre parti dei passaggi 3, 4, 5 e 9 in un ordine diverso. Completa ciò che puoi, scegli **Salta** per il resto, e usa i passaggi seguenti per completare correttamente gli elementi saltati. Vedi [Onboarding e impostazioni generali](./store-operations/onboarding-and-general-settings).
## Passaggio 1 — Decidere cosa vendere
Il resto del processo è più veloce una volta chiarito questo punto. Metti in conto un pomeriggio.
Servono tre risposte: cosa vendi, chi lo compra e da dove proviene. La terza influenza diversi passaggi successivi.
- **Gestire magazzino proprio.** Acquisti o produci gli articoli e spedisci ogni ordine da solo. Margine più alto, più lavoro e denaro speso prima della prima vendita.
- **Dropshipping.** Un fornitore tiene la merce e spedisce ogni ordine per tuo conto. Avvio più rapido e nessun magazzino da acquistare, con margini più sottili e meno controllo sui tempi di consegna.
Runner supporta entrambi e puoi cambiare in seguito. Vedi [Dropshipping](./store-operations/dropshipping).
**Chiedi a Runner**
> Voglio aprire un negozio online ma non ho ancora deciso cosa vendere. Mi interessa
> [argomento] e posso investire circa [budget]. Cosa sta vendendo bene, e quali sono
> i pro e i contro di ogni opzione?
> Per [prodotto] conviene il dropshipping o tenere magazzino mio? È il mio primo negozio.
> Chi compra [prodotto]? A cosa tiene, e quale prezzo si aspetta?
**Fatto quando** sai dire cosa vendi, chi lo compra e da dove proviene. Conserva questa descrizione: la incollerai in chat al passaggio 2.
**Rimanda:** dominio, logo e apertura della partita IVA. Ognuno costa meno da decidere una volta definito il prodotto.
## Passaggio 2 — Creare la vetrina
Usa il [tutorial illustrato del primo negozio](./start-here/first-store-quickstart) per crearlo, inviare la descrizione del passaggio 1, controllare l’anteprima e chiedere una modifica specifica.
Prima di continuare, verifica che:
- Il nuovo negozio compaia nella tua area di lavoro.
- Le pagine principali dell’anteprima si aprano su desktop e mobile.
- La modifica richiesta sia visibile nell’anteprima.
Un’anteprima funzionante non pubblica il negozio. Continua con la configurazione dell’attività qui sotto; la pubblicazione è il passaggio 7.
## Passaggio 3 — Configurare i dati del negozio
L'identità pubblica del negozio e dove vende. Circa 10 minuti, e diversi passaggi successivi dipendono da questo.
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Operazioni del negozio → Generale**
1. Apri **Operazioni del negozio → Generale**.
2. Inserisci il nome del negozio, un'email di contatto e l'indirizzo aziendale. Il nome è limitato a 30 caratteri e l'email deve essere un indirizzo valido.
3. In **Mercati** aggiungi i paesi in cui vendi e imposta la valuta.
4. In **Posizioni di magazzino** aggiungi l'indirizzo da cui partono gli ordini. Un indirizzo privato è valido.
5. Seleziona **Salva** e attendi lo stato salvato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Dettagli: [Onboarding e impostazioni generali](./store-operations/onboarding-and-general-settings).
**Chiedi a Runner**
> Vendo verso [paesi]. Quali impostazioni di mercato e valuta dovrei usare?
**Fatto quando** Generale è salvato con nome del negozio, email di contatto valida, almeno un mercato e una posizione di magazzino.
**Da sapere**
- La valuta si imposta per mercato, non per prodotto. Un prodotto con prezzo in una valuta esterna ai mercati salvati mostra un avviso e può non visualizzare il prezzo in vetrina.
- La visibilità del negozio e la pubblicazione sono cose diverse. **Visibile ai clienti** controlla se la vetrina mostra il negozio, ma non pubblica il codice della vetrina: quello è il passaggio 7.
- Questo è un buon momento per avviare Stripe. I pagamenti sono il passaggio 9, ma la verifica dei tuoi dati da parte di Stripe può richiedere tempo. Iniziando ora, l'attesa avviene in background e non il giorno del lancio.
## Passaggio 4 — Aggiungere i prodotti
Serve almeno un prodotto completo e vendibile. La durata dipende interamente dal tuo approvvigionamento.
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Operazioni del negozio → Prodotti**
Tre strade, combinabili tra loro.
| Strada | Quando usarla | Dove |
| --- | --- | --- |
| **Creazione manuale** | Hai prodotti tuoi | **Prodotti → Aggiungi** |
| **Dropshipping** | Un fornitore tiene la merce e spedisce | **Operazioni del negozio → Dropshipping** |
| **Importazione CSV** | Hai già il catalogo in un foglio di calcolo | **Prodotti → Importa** |
Un catalogo vuoto mostra **Aggiungi primo prodotto** invece di **Aggiungi** e **Importa**.
Un prodotto completo richiede nome e descrizione, un prezzo in una valuta corrispondente a un mercato salvato, almeno un'immagine, giacenza e stato **Pubblicato**. Un prodotto in **Bozza** non appare ai clienti. I beni fisici richiedono anche peso e dimensioni, da cui dipendono spedizione e logistica.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Dettagli: [Prodotti](./store-operations/products) · [Dropshipping](./store-operations/dropshipping) · [Importa prodotti](./store-operations/import-products) · [Giacenze e varianti](./store-operations/inventory-and-variants)
**Chiedi a Runner.** Non devi compilare tu questi moduli. Runner può creare e aggiornare prodotti, giacenze e immagini dalla chat, e aiutarti a scegliere da cosa partire.
> Con quale dovrei partire? [elenco] — considera margine e facilità di spedizione.
> Scrivi una descrizione per [prodotto]. Ai clienti interessa soprattutto [aspetto].
> Imposta la giacenza di [prodotto] a 50 e segna la variante blu come esaurita.
> Controlla il catalogo e dimmi quali prodotti non hanno immagini, prezzi o giacenza.
Indica il record e il risultato esatto che vuoi, e autorizza esplicitamente le modifiche distruttive.
**Fatto quando** almeno un prodotto è **Pubblicato**, con prezzo in una valuta di mercato salvata, immagine e giacenza, e compare nell'anteprima della vetrina.
**Da sapere**
- Le modifiche di giacenza vengono mantenute solo dopo aver salvato una posizione di magazzino. Fa parte del passaggio 3: aggiungila lì se l'hai saltata.
- I prodotti in dropshipping possono comportarsi diversamente da quelli gestiti manualmente per costi e giacenze. Prima di aggiungere un articolo, conferma destinazione, un metodo di spedizione utilizzabile e un prezzo di vendita per ogni variante.
- L'importazione CSV richiede il modello attuale di Runner. `Product Handle` e `Product Title` sono obbligatori, e le righe delle varianti richiedono `Variant SKU` e i valori delle opzioni.
## Passaggio 5 — Configurare la spedizione
Runner deve sapere da dove partono gli ordini e quanto addebiti per consegnarli. Circa 15 minuti.
Qui l'ordine conta. La spedizione non si salva senza la posizione di magazzino e il mercato salvati al passaggio 3.
**Percorso di accesso:** **Operazioni del negozio → Generale → Spedizione**
1. Apri **Operazioni del negozio → Generale**.
2. Verifica che la **posizione di magazzino** salvata al passaggio 3 sia ancora presente. È l'indirizzo da cui partono gli ordini.
3. Verifica che in **Mercati** sia salvato almeno un paese.
4. Vai a **Spedizione** e seleziona **Aggiungi**.
5. Dai all'opzione un nome riconoscibile per i clienti, ad esempio la velocità o il metodo di consegna.
6. Scegli il paese di destinazione in **Spedisci a**, poi apri **Costo di spedizione**. La tariffa fissa è l'opzione più semplice. Inserisci `0` perché la consegna risulti gratuita.
7. Seleziona **Salva** nella finestra, poi **Salva** sulla pagina, e attendi lo stato salvato.
Per le fasce di prezzo e gli altri tipi di tariffa vedi [Spedizione](./store-operations/shipping). Se la consegna è gestita da un corriere o da un fornitore, può servire anche una connessione in **App**: vedi [Shippo](./apps-and-integrations/shippo-shipping), [CJ Dropshipping](./apps-and-integrations/cj-dropshipping) o [Logistica 4PX](./apps-and-integrations/4px-fulfillment).
**Chiedi a Runner**
> Spedisco da [luogo] verso [paesi]. Quali opzioni di spedizione dovrei configurare?
> Conviene offrire la spedizione gratuita su un prodotto da [prezzo] o è meglio addebitarla?
**Fatto quando** al checkout compare un'opzione di consegna con un prezzo. Aggiungi un prodotto al carrello e verifica lì, non nella pagina delle impostazioni.
**Da sapere**
- Un negozio senza un'opzione di spedizione valida sembra normale ovunque tranne che al checkout, dove il cliente non può completare l'ordine. È un motivo frequente per cui un negozio apparentemente finito non vende.
- Le opzioni di spedizione usano la posizione di magazzino salvata in Generale. Non esiste un selettore **Spedisci da** per singola riga.
- Il salvataggio fallisce senza una regione di mercato predefinita. Salva Mercati prima di Spedizione.
- Prodotti digitali, prenotazioni e articoli gestiti dal fornitore possono seguire regole diverse.
## Passaggio 6 — Rendere il negozio conforme e affidabile
Sono le pagine che dicono ai clienti chi sei e cosa succede se qualcosa va storto. Runner può redigerle tutte. Il tuo compito è verificare che corrispondano a come operi davvero.
La maggior parte dei negozi ha bisogno di una policy di reso e rimborso, una policy di spedizione con tempi realistici, un'informativa sulla privacy, i termini di servizio, un recapito di contatto e una pagina "chi siamo".
**Chiedi a Runner**
> Redigi una policy di reso e rimborso. Vendo [cosa], spedisco da [luogo] e voglio
> una finestra di reso di [numero] giorni.
> Redigi le pagine di informativa privacy e termini di servizio e aggiungile al footer
> della vetrina.
> Scrivi una pagina "chi siamo" basata su quello che ti ho raccontato dell'attività.
Poi rivedi le bozze:
1. Leggi ogni pagina e correggi ciò che non corrisponde alle tue condizioni reali: finestra di reso, chi paga la spedizione di ritorno e quanto dura davvero la consegna.
2. Verifica che le pagine siano visibili in vetrina e collegate nel footer. Vedi [Modificare contenuti, pagine e media](./storefront-and-publishing/edit-content-pages-and-media).
3. Verifica che il recapito coincida con l'email di contatto salvata al passaggio 3.
**Fatto quando** ogni pagina di policy si apre dal footer della vetrina e riflette le tue condizioni reali.
**Da sapere.** Le bozze sono un punto di partenza, non consulenza legale. Registrazione fiscale, norme sulla tutela dei consumatori e informative obbligatorie dipendono da dove operi e da cosa vendi. In caso di dubbio, consulta un professionista locale prima del lancio.
Le recensioni prodotto sono un segnale di fiducia a parte e si configurano in Generale. Attivare le recensioni non aggiunge i componenti mancanti a una vetrina più vecchia: chiedi a Runner di aggiungere la funzionalità e pubblica quella modifica. Vedi [Recensioni](./store-operations/reviews-and-advanced-admin).
## Passaggio 7 — Verificare e pubblicare
La pubblicazione mette il negozio online a un indirizzo pubblico. I controlli richiedono pochi minuti. Correggere ciò che emerge può richiedere di più.
**Percorso di accesso:** **Area di lavoro → seleziona un negozio → Vetrina → Pubblica**
1. Completa prima la [checklist di preparazione alla pubblicazione](./storefront-and-publishing/prepare-to-publish).
2. Apri **Negozio online** e seleziona il pulsante di pubblicazione. In base allo stato mostra **Pubblica**, **Pubblica modifiche** o **Ripubblica**.
3. Leggi **Conferma Distribuzione** e attendi la fine del controllo di build.
4. Risolvi ogni avviso mostrato, oppure accettalo consapevolmente.
5. Seleziona **Conferma** solo dopo che il controllo è riuscito.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Dettagli: [Pubblica e ripubblica](./storefront-and-publishing/publish-and-republish).
**Chiedi a Runner**
> Controlla se il mio negozio è pronto per la pubblicazione ed elenca cosa manca.
> Il controllo di pubblicazione è bloccato su [elemento]. Cosa devo fare?
**Fatto quando** l'URL pubblico del negozio si apre in una finestra di navigazione in incognito.
**Da sapere.** Due cose sorprendono in questo passaggio. Il negozio è pubblico ma non può ancora incassare: quello è il passaggio 9, quello che apre davvero il negozio al pubblico. E le modifiche successive non sono online finché non pubblichi di nuovo: salvare una modifica in Modalità Design, ripristinare una versione o vedere un'anteprima corretta non aggiorna da solo il negozio pubblico.
Le modifiche in Operazioni del negozio funzionano diversamente. Prodotti, prezzi, giacenze e spedizione si applicano senza ripubblicare.
**Se un controllo ti blocca,** usa l'azione mostrata sull'elemento: **Apri Operazioni del negozio**, **Correggi con l'IA** o **Riprova il controllo**. Se persiste, vedi [Risolvere pubblicazione, checkout e app](./help-and-reference/troubleshoot-publishing-checkout-apps) e [Risolvere le build della vetrina](./help-and-reference/troubleshoot-storefront-builds).
## Passaggio 8 — Collegare un dominio personalizzato (facoltativo)
**Questo passaggio è facoltativo.** Il negozio funziona già all'indirizzo che Runner ha assegnato alla pubblicazione. Un dominio personalizzato riguarda il marchio, non la funzionalità. Saltarlo non blocca i pagamenti né i passaggi successivi, e puoi tornarci quando vuoi.
La configurazione richiede circa 10 minuti, seguiti dall'attesa della propagazione DNS. Il negozio deve essere già stato pubblicato con successo, e l'accesso dipende dal piano.
**Percorso di accesso:** **Negozio online** → menu del sito pubblicato → **Impostazioni del dominio**. Su mobile, o quando quel menu non è visibile, usa **Impostazioni → Negozio: _nome del negozio_ → Dominio** nell'area di lavoro.
1. Apri **Impostazioni del dominio** da uno dei due percorsi.
2. Acquista un dominio tramite Runner, oppure aggiungine uno che possiedi già.
3. Se aggiungi un dominio tuo, copia i record DNS mostrati da Runner nelle impostazioni del tuo provider.
4. Attendi la verifica. La riga del dominio mostra un avviso finché i record non si risolvono.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Dettagli: [Connetti un dominio personalizzato](./storefront-and-publishing/custom-domains).
**Fatto quando** il tuo dominio apre il negozio, oppure quando hai deciso di rimandare.
**Da sapere**
- **Dominio aggiunto correttamente** conferma solo che il dominio è collegato al negozio, non che il DNS funzioni. Sono controlli separati e le modifiche DNS possono richiedere diverse ore.
- Acquistare o rinnovare un dominio avvia un flusso di pagamento esterno. Verifica i dati prima di continuare.
- Se il lancio è imminente, collega prima i pagamenti. Un negozio all'indirizzo predefinito che incassa vale più di uno con dominio proprio che non incassa.
## Passaggio 9 — Collegare i pagamenti
È il passaggio che apre il negozio al pubblico. Tutto ciò che precede era preparazione.
Il negozio può essere già online e sembrare finito. Finché questo passaggio non è completo, un cliente che prova ad acquistare non può concludere.
**Percorso di accesso:** **App → Gestisci il tuo negozio → Stripe**. Dopo la pubblicazione, Runner può mostrare **Collega Stripe** nel passaggio finale del negozio, che apre la stessa configurazione.
Stripe raccoglie dati aziendali, informazioni di identità e coordinate bancarie per i versamenti. Tienili a portata di mano e usa un browser che consenta l'apertura della finestra Stripe.
1. Apri **App → Gestisci il tuo negozio → Stripe** e seleziona **Collega**.
2. Completa la configurazione di Stripe nella nuova finestra.
3. Torna in Runner e verifica che la connessione risulti abilitata.
| Stato | Cosa significa |
| --- | --- |
| **Connessione in corso...** | Runner sta preparando l'account o il link di configurazione. Attendi un risultato. |
| **In revisione** | Stripe sta verificando i tuoi dati. È un processo di Stripe, non un errore di Runner, e può richiedere tempo. |
| **Azioni Stripe richieste** | C'è qualcosa di specifico in sospeso. Aprilo per vedere cosa è **Dovuto ora**, **Dovuto dopo** o **In revisione**. |
| **Riconnetti** o **Continua onboarding** | Un account esiste ma non è completo. Selezionandolo si riprende lo stesso account. |
Dettagli: [Connetti Stripe per i pagamenti](./apps-and-integrations/stripe-payments).
Apri il negozio su un telefono. Controlla un prodotto, aggiungilo al carrello, inserisci un indirizzo di consegna e verifica che compaiano un'opzione di spedizione e il pagamento. Fermati prima di inviare il pagamento.
Se scegli di provare un pagamento reale, effettua intenzionalmente un ordine di prova e controllalo in [Ordini](./store-operations/orders). Un addebito reale e un eventuale rimborso possono comportare commissioni; è facoltativo e separato dalla configurazione guidata.
**Chiedi a Runner**
> Stripe mostra [stato]. Cosa significa e cosa devo fare adesso?
> Un cliente dice che il checkout non funziona. Cosa devo controllare?
**Hai finito quando** Stripe non mostra azioni bloccanti e prodotto, carrello, spedizione e pagamento funzionano insieme. Questi controlli verificano che il checkout sia pronto; solo un pagamento completato conferma una transazione reale.
**Da sapere.** Un URL online non dimostra che i pagamenti siano disponibili. La vetrina può essere pubblicata mentre il checkout è ancora sospeso o in verifica. Vedi [Negozio online e checkout](./storefront-and-publishing/live-store-and-checkout).
## Passaggio 10 — Ottenere i primi visitatori
Nessuno arriva da solo. Parti da ciò che non costa nulla e non spendere in pubblicità finché il passaggio 9 non è confermato.
- **Cerca.** Per un negozio nuovo, titoli e descrizioni dei prodotti pesano di più. Vedi [Panoramica SEO](./analytics-and-seo/seo-overview) e [Performance di ricerca](./analytics-and-seo/search-performance).
- **Analisi.** Verifica che le visite vengano registrate prima di giudicare qualsiasi cosa. Vedi [Panoramica analisi](./analytics-and-seo/analytics-overview).
- **Visibilità IA.** Come appare il negozio quando qualcuno chiede consigli agli assistenti IA. Vedi [Visibilità IA](./analytics-and-seo/ai-visibility).
- **Creativi.** Immagini e varianti di annunci da [Creative Studio](./automate-test-and-create/creative-studio), e campagne tramite [Runner Ads](./automate-test-and-create/runner-ads).
**Chiedi a Runner**
> Migliora i titoli e le descrizioni SEO delle mie pagine prodotto.
> Crea tre creatività pubblicitarie per [prodotto] rivolte a [pubblico].
> Il negozio è online da una settimana senza vendite. Cosa devo controllare per primo?
**Fatto quando** le analisi mostrano sessioni di persone diverse da te.
**Da sapere.** Poco traffico e bassa conversione sono problemi diversi con soluzioni diverse. Controlla prima il traffico: la conversione non si diagnostica con dieci visite. Vedi [Traffico e conversione](./analytics-and-seo/traffic-and-conversion). Se le analisi non mostrano nulla, verifica che il negozio sia pubblicato e la fonte dati collegata prima di cambiare altro. Vedi [Risolvere dati e pubblicazione](./analytics-and-seo/troubleshoot-data-and-publication).
## Passaggio 11 — Gestire il negozio ogni settimana
Una breve routine mantiene il negozio in salute quando iniziano ad arrivare gli ordini.
1. Controlla gli [Ordini](./store-operations/orders) ed evadi ciò che è in sospeso.
2. Rispondi ai messaggi dei clienti e gestisci i resi. Vedi [Clienti](./store-operations/customers).
3. Controlla le giacenze in [Giacenze e varianti](./store-operations/inventory-and-variants).
4. Guarda le [Analisi](./analytics-and-seo/analytics-overview) per capire cosa è cambiato rispetto alla settimana precedente.
Quando hai abbastanza traffico, verifica le modifiche invece di tirare a indovinare con gli [Esperimenti](./automate-test-and-create/experiments), affida il lavoro ripetitivo alle [Automazioni](./automate-test-and-create/automations) e attiva [Promozioni](./store-operations/promotions) su prodotti o periodi specifici.
**Chiedi a Runner**
> Riassumi gli ordini di questa settimana e segnala cosa richiede attenzione.
> Quali prodotti hanno venduto meglio questo mese e quali non si muovono?
**Da sapere.** Le modifiche alla vetrina vanno ripubblicate prima che i clienti le vedano. Le modifiche in Operazioni del negozio si applicano senza ripubblicare. Prima di autorizzare dalla chat un'azione distruttiva o legata al ciclo di vita di un ordine, chiedi a Runner di ispezionare lo stato attuale, poi autorizza l'effetto esatto che desideri.
## Checklist di lancio
Ogni voce è qualcosa che puoi verificare da solo. Se confermi tutte e otto le voci obbligatorie, il negozio è aperto al pubblico.
**Obbligatorie**
- [ ] Sai dire cosa vendi, chi lo compra e da dove proviene. (Passaggio 1)
- [ ] L'anteprima della vetrina si carica e le pagine principali funzionano su desktop e mobile. (Passaggio 2)
- [ ] Generale è salvato con nome del negozio, email di contatto valida, almeno un mercato e una posizione di magazzino. (Passaggio 3)
- [ ] Almeno un prodotto è pubblicato, con prezzo in una valuta di mercato salvata, immagine e giacenza. (Passaggio 4)
- [ ] Al checkout compare un'opzione di consegna con prezzo quando aggiungi un prodotto al carrello. (Passaggio 5)
- [ ] Le pagine di policy si aprono dal footer della vetrina e corrispondono alle tue condizioni reali. (Passaggio 6)
- [ ] L'URL pubblico del negozio si apre in una finestra in incognito. (Passaggio 7)
- [ ] Stripe non mostra azioni bloccanti e il carrello raggiunge il pagamento con la spedizione prevista. (Passaggio 9)
**Facoltativa, in qualsiasi momento dopo la pubblicazione**
- [ ] Il tuo dominio personalizzato apre il negozio. (Passaggio 8)
**Dopo il lancio**
- [ ] Le analisi mostrano sessioni di persone diverse da te. (Passaggio 10)
- [ ] Hai una routine settimanale per ordini, giacenze e clienti. (Passaggio 11)
Se una voce non si conferma, descrivi in chat quello che vedi.
> Controlla il mio negozio rispetto alla checklist di lancio e dimmi cosa manca ancora.
## Guide correlate
- [Inizia con Runner](./start-here)
- [Chatta con Runner](./work-with-runner/chat-with-runner)
- [Operazioni del negozio](./store-operations)
- [App e integrazioni](./apps-and-integrations)
- [Aiuto e riferimento](./help-and-reference)
- [Glossario](./help-and-reference/glossary)
---
# Piani e fatturazione
Source: https://www.runnerai.com/docs/it/guides/plans-and-billing
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Runner misura il lavoro in crediti e vende capacità sotto forma di abbonamento. Queste due pagine separano la decisione dall'uso quotidiano: in una scegli e gestisci un piano, nell'altra leggi e sfrutti il saldo che ne deriva.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
L'immagine mostra Free, Plus e Pro. Scorri nel prodotto per vedere Max; usa i valori attuali di account e checkout, non i prezzi fotografati qui.
| Il tuo obiettivo | Inizia da qui |
| --- | --- |
| Confrontare Gratuito, Plus, Pro e Max, o modificare un abbonamento | [Piani di abbonamento](/it/guides/plans-and-billing/subscription-plans) |
| Vedere cosa consente di fare un saldo, leggere l'utilizzo o guadagnare crediti | [Crediti e utilizzo](/it/guides/plans-and-billing/credits-and-usage) |
Apri il menu dello spazio desiderato → **Impostazioni → Piano e fatturazione** per confrontare i piani, oppure **Utilizzo e crediti** per la spesa. La [pagina Prezzi](https://www.runnerai.com/pricing), il tuo account e la conferma prima del pagamento mostrano i valori applicabili.
---
# Crediti e utilizzo
Source: https://www.runnerai.com/docs/it/guides/plans-and-billing/credits-and-usage
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
I crediti sono l'unità di utilizzo universale di Runner. Le operazioni idonee di LLM, immagini, video, automazione, workflow, simulazione, competenze e distribuzione vengono tutte detratte da un unico saldo mostrato.
## Cosa copre questa guida
Stimare cosa consente di fare un saldo, selezionare un intervallo di reporting e leggere ogni blocco rispetto a esso, guadagnare crediti bonus e capire come viene registrato l'utilizzo.
## Disponibilità e prerequisiti
- L'utilizzo è limitato allo spazio di lavoro attuale, non a un negozio.
- I dati possono essere vuoti quando lo spazio di lavoro non ha utilizzato crediti nell'intervallo selezionato.
- Le concessioni di crediti, la scadenza e l'idoneità all'acquisto dipendono dalla concessione o dal piano mostrato nel tuo account.
- Usa **Utilizzo e crediti** per saldo e spesa registrata; consulta la conferma d'acquisto attuale per i prezzi.
## Percorso di accesso
Apri lo spazio desiderato e seleziona **Impostazioni → Utilizzo & Crediti**. Controlla il nome nella barra laterale.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Apri **Utilizzo e crediti** sotto lo spazio desiderato. L'immagine mostra la voce, non un saldo o consumo registrato: controlla quei valori nel tuo spazio.
## Cosa consente di fare un saldo
Usa le tue attività recenti per stimare una modifica simile. Parti da una richiesta piccola e definita, poi controlla i Crediti registrati in Attività dello spazio. Modello, contesto, lunghezza dell'output, media, tentativi e complessità cambiano il totale; non esistono un prezzo fisso per messaggio o un numero garantito di negozi per saldo.
### Stima la prossima creazione di un negozio
1. Apri **Impostazioni → Utilizzo & Crediti** nello spazio in cui lavorerai.
2. Esegui una richiesta piccola e rappresentativa, poi trova la spesa in **Attività dello spazio di lavoro**.
3. Confronta attività recenti di ambito e modello simili. Stima separatamente generazione iniziale e revisioni.
4. Aggiungi il lavoro da ripetere e considera media, nuovi tentativi e modifiche più grandi. Ricontrolla la spesa dopo ogni fase.
Ad esempio, **se la tua attività** registra 200 Crediti per la generazione e 20 per ciascuna di tre revisioni simili, il totale è **260 Crediti**. I numeri illustrano il calcolo: non sono costi tipici, un benchmark o un preventivo per il prossimo negozio.
**Verifica:** la stima deriva da attività registrate comparabili. Un saldo Crediti non garantisce un numero fisso di negozi o revisioni.
Per la quota mensile inclusa in ogni piano, consulta [Piani di abbonamento](./subscription-plans).
## Controlli e report
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **7 giorni** | Ispeziona l'attività recente. | Ogni grafico, riepilogo, categoria e blocco di attività si aggiorna a sette giorni. |
| **Questo ciclo** | Rivedi la finestra del ciclo di fatturazione attuale. | La pagina utilizza il ciclo attuale trascorso mostrato per lo spazio di lavoro. |
| **90 giorni** | Cerca un trend più lungo. | Ogni blocco di utilizzo si aggiorna all'intervallo più lungo. |
| Scheda crediti rimasti | Vedi i crediti rimasti e totali per il piano/concessioni attuali. | La barra di avanzamento e la data di aggiornamento visualizzate spiegano lo stato del saldo attuale. |
| **Aggiorna** | Confronta i piani quando è necessaria più capacità inclusa. | Runner apre **Piano e fatturazione**. |
| **Acquista crediti** | Rivedi un acquisto di crediti extra idoneo. | Runner apre **Piano e fatturazione**; nessun acquisto si verifica fino al completamento della sua conferma. |
| Crediti al giorno | Trova date occupate o tranquille. | Passando il mouse su una barra viene mostrato l'utilizzo di quel giorno. |
| Da dove provengono i tuoi crediti | Comprendi il piano, il giorno, l'iscrizione, l'acquisto e altre concessioni che si applicano. | Ogni riga mostra fonte, cadenza, nota e crediti. |
| Da dove sono andati i tuoi crediti | Confronta le categorie di spesa e i conteggi di esecuzione. | Le barre mostrano la quota di ogni categoria per l'intervallo selezionato. |
| Attività dello spazio di lavoro | Ispeziona i compiti recenti dietro la spesa. | Le schede di categoria filtrano le stesse colonne Compito, Progetto, Tipo, Crediti e Ora. |
## Rivedi l'utilizzo
1. Apri **Spazio di lavoro → Utilizzo & Crediti**.
2. Seleziona **7 giorni**, **Questo ciclo** o **90 giorni**.
3. Leggi **Crediti rimasti** prima di interpretare la spesa.
4. Confronta **Utilizzato nell'intervallo**, **Media giornaliera** e **Giorno più occupato**.
5. Usa **Crediti al giorno** per trovare quando l'utilizzo è cambiato.
6. Confronta le fonti con le categorie di spesa.
7. Filtra **Attività dello spazio di lavoro** per identificare i compiti coinvolti.
8. Se hai bisogno di più capacità, apri **Aggiorna** o **Acquista crediti**, quindi rivedi la conferma di fatturazione separata.
## Guadagna crediti bonus
Apri il [check-in o la missione](/it/guides/start-here/welcome-tour-and-daily-credits) mostrati nel tuo account e leggi il premio prima di richiederlo. Dopo il successo, torna a **Utilizzo e crediti** e controlla origine e saldo.
Check-in giornalieri, bonus consecutivi e missioni introduttive hanno requisiti e limiti separati. Leggi il limite attuale e la scadenza di ogni accredito: il tetto mensile di guadagno e il saldo bonus massimo sono limiti diversi. Non considerare i Crediti bonus un saldo riportabile senza scadenza.
## Come viene registrato l'utilizzo
- L'utilizzo viene registrato al termine di un'operazione e può richiedere un po' di tempo prima di comparire.
- Una singola richiesta può produrre più record quando Runner usa più modelli, strumenti, operazioni sui media, simulazioni o distribuzioni.
- Se un totale sembra inatteso, confronta data e ora, progetto, tipo di azione, modello o provider ed eventuali nuovi tentativi prima di contattare il supporto.
## Comprendi i numeri
- Il saldo rimasto e la spesa dell'intervallo selezionato rispondono a domande diverse; non devono essere uguali.
- Il grafico dei crediti al giorno segnala la spesa giornaliera, mentre la scheda della fonte segnala le concessioni e il saldo rimasto.
- Una categoria può mostrare esecuzioni con spesa di crediti pari a zero.
- Le righe di attività mostrano compiti recenti per la scansione, non un registro di audit permanente completo.
- Le date utilizzano il fuso orario sul tuo dispositivo attuale.
## Domande frequenti
| Domanda | Risposta |
| --- | --- |
| Perché due prompt simili hanno consumato importi diversi? | Possono aver usato dimensioni di contesto, lunghezze di output, strumenti, modelli, passaggi dell'agente, nuovi tentativi, ripieghi, media, simulazioni o distribuzioni differenti. |
| Inviare un messaggio consuma un numero fisso di crediti? | No. I crediti seguono le operazioni misurate effettivamente eseguite per la richiesta. |
| Le modifiche manuali consumano crediti? | Modificare tu stesso contenuti o codice non genera utilizzo del modello. Chiedere a Runner di eseguire o spiegare la modifica può farlo. |
| Le richieste fallite sono sempre gratuite? | Non necessariamente. Un errore senza utilizzo segnalato dal provider non ha costi di modello, ma l'utilizzo segnalato prima di un errore, o durante un altro tentativo riuscito, può comunque essere registrato. |
| Una competenza viene addebitata separatamente? | No. Attivare una competenza non aggiunge alcun costo fisso; le operazioni che esegue vengono detratte dallo stesso saldo. |
| I Crediti bonus si accumulano? | Leggi la scadenza di ogni accredito. Limiti dei check-in, saldo massimo e bonus consecutivi possono seguire regole diverse. |
| Come funziona il bonus del settimo check-in? | Ogni check-in giornaliero idoneo assegna 10 crediti e ogni settima riscossione consecutiva aggiunge un bonus serie. La schermata di riscossione mostra l'importo attuale prima che tu lo raccolga. |
| Un Boost Pack è un abbonamento? | No. È un acquisto una tantum di 350 crediti a 9,90 USD. |
## Stati e limiti
- **Crediti esauriti** evidenzia un saldo rimasto pari a zero e mantiene disponibili le azioni di fatturazione.
- L'attività vuota dice che non ci sono registri per il filtro o l'intervallo attuale.
- Una fonte può mostrare zero quando è utilizzabile ma non ancora rivendicata.
- I tipi di concessione passiva appaiono solo quando hanno contribuito crediti.
- Il caricamento copre sia i dati di saldo che di consumo; attendi tutti i blocchi prima di confrontarli.
## Risoluzione dei problemi
- Se due numeri sembrano incoerenti, conferma che ogni blocco utilizza lo stesso intervallo selezionato.
- Se un compito è mancante, cancella il filtro della categoria di attività e prova un intervallo più lungo.
- Se il saldo non è cambiato dopo un acquisto, torna a [Piano e fatturazione](/it/guides/plans-and-billing) e conferma che l'acquisto ha raggiunto uno stato completato prima di aggiornare.
- Se non appare alcun utilizzo, verifica di aver aperto lo spazio di lavoro in cui è stato eseguito il compito.
- Se hai bisogno di una decisione di addebito o piano, usa Piano e fatturazione piuttosto che uno screenshot di utilizzo precedente.
- Per un addebito imprevisto o un requisito sul trattamento dei dati, scrivi a team@adaptivemachines.ai indicando spazio di lavoro, progetto, data e ora approssimative e i dettagli dell'evento di utilizzo.
## Guide correlate
- [Piani di abbonamento](./subscription-plans)
- [Spazio di lavoro Generale](../account-and-settings/workspace-general)
- [Personalizzazione dell'agente](../agent)
---
# Piani di abbonamento
Source: https://www.runnerai.com/docs/it/guides/plans-and-billing/subscription-plans
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Piano e fatturazione è il luogo a livello di spazio di lavoro per abbonamenti, modifiche di piano, gestione della fatturazione e acquisti di crediti extra idonei. Usa i valori mostrati lì perché i nomi dei piani, i limiti e i prezzi possono cambiare.
## Cosa copre questa guida
Confrontare i piani Runner e ciò che ciascuno include, rivedere un'azione di piano prima del pagamento, riconoscere modifiche programmate o in sospeso e aprire la gestione della fatturazione sicura.
## Disponibilità e prerequisiti
- Apri lo spazio di lavoro il cui piano intendi gestire.
- Le azioni di fatturazione possono richiedere il permesso di fatturazione dello spazio di lavoro.
- I Boost Pack richiedono un abbonamento attivo idoneo.
- Un abbonamento scaduto o legacy può mostrare controlli diversi o bloccare una nuova azione.
## Percorso di accesso
Apri lo spazio desiderato, poi **Impostazioni → Piano e fatturazione**. Controlla il nome nella barra laterale.
La pagina pubblica dei prezzi e Piano e fatturazione si aprono su **Mensile** per impostazione predefinita. Un abbonamento esistente o un link esplicito a un periodo di fatturazione può invece aprire il periodo corrispondente.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvBPMrkzFhEHcK82Y0dyL6sSr9NUGjnQeMWZJ)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Nell'immagine compaiono Free, Plus e Pro; scorri per Max. I prezzi sono un esempio dell'interfaccia alla data di acquisizione. Controlla periodo e totale attuali prima di pagare.
## Confronta i piani
Questa tabella riassume i piani. Fanno fede la [pagina Prezzi](https://www.runnerai.com/pricing) attuale e la conferma mostrata prima del pagamento.
| Piano | Crediti inclusi | Accesso a modelli e funzionalità | Ideale per |
| --- | --- | --- | --- |
| Gratuito | 150 crediti alla registrazione, più fino a 250 tramite le missioni introduttive | Runner Lite e anteprime limitate di alcune funzionalità avanzate | Provare Runner e generare un primo negozio |
| Plus | 1.000 crediti ricaricati ogni mese | Runner Lite e anteprime limitate di alcune funzionalità avanzate | Piccole modifiche regolari e iterazione costante su un negozio |
| Pro | 2.500 crediti ricaricati ogni mese | Runner Pro, più Creative Studio, automazioni, workflow, simulazioni, Esperimenti e Ads | Costruzioni complesse e il set di funzionalità avanzate |
| Max | 10.000 crediti ricaricati ogni mese | Runner Max, più limiti di output più elevati ed elaborazione prioritaria nei periodi di traffico intenso | Lavoro impegnativo o urgente, in base alla disponibilità |
Disponibilità, durata e limiti delle anteprime possono variare durante il rilascio e compaiono nel tuo account. Per capire cosa consentono di fare questi crediti nella pratica, vedi [Crediti e utilizzo](./credits-and-usage).
## Modelli Runner
Runner offre tre modelli per scegliere il compromesso tra qualità, velocità e crediti senza gestire gli ID modello dei provider.
| Modello | Incluso con | Compromesso previsto |
| --- | --- | --- |
| Runner Lite | Gratuito e Plus | Lavoro rapido ed economico per attività semplici |
| Runner Pro | Pro | Capacità equilibrata per costruzioni complesse e funzionalità avanzate |
| Runner Max | Max | Massima capacità, limiti di output più elevati e accesso prioritario quando il traffico è intenso |
Usa il selettore del modello per vedere le scelte disponibili per l'attività. La disponibilità può cambiare: un piano non garantisce un elenco permanente di modelli dei fornitori.
## Controlli
| Voce o pulsante | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| Banner del piano attuale | Conferma quale piano dello spazio di lavoro è attivo e il suo stato visualizzato. | Runner può mostrare informazioni su rinnovo, fine, validità o modifica in sospeso. |
| **Mensile / Annuale · Risparmia il 20%** | Confronta i piani nel periodo desiderato. | Le schede si aggiornano. Mensile può essere disabilitato durante un impegno annuale attivo. |
| Scheda del piano | Confronta le funzionalità incluse e i limiti. | La selezione di un'azione disponibile passa a un passaggio di conferma del piano. |
| Azione **Aggiorna** o cambio periodo | Avvia una modifica del piano. | Runner mostra una conferma, programma la modifica, richiede il pagamento o apre il checkout in base allo stato dell'account. |
| **Gestisci** / **Gestisci fatturazione** | Aggiorna i metodi di pagamento, rivedi le fatture o gestisci l'annullamento. | Runner apre il portale di fatturazione sicuro. |
| **Annulla** accanto a una modifica in sospeso | Ritira una modifica del piano programmata. | Runner aggiorna l'abbonamento attuale dopo il successo. |
| Pacchetto di potenziamento crediti | Acquista crediti aggiuntivi quando idoneo. | La quantità e il totale vengono mostrati prima di **Conferma acquisto**. |
## Rivedi una modifica del piano
1. Apri **Spazio di lavoro → Piano e fatturazione**.
2. Conferma lo spazio di lavoro e il banner del piano attuale.
3. Seleziona **Mensile** o **Annuale · Risparmia il 20%** se entrambi sono disponibili.
4. Rivedi le schede del piano attuale, i limiti delle funzionalità e l'importo visualizzato.
5. Seleziona l'azione del piano desiderato.
6. Leggi attentamente la conferma. Per Annuale, confronta il totale annuo, non solo l'equivalente mensile. Chiudi o annulla se vuoi solo confrontare; non proseguire se piano, periodo o importo sono errati.
7. Completa il pagamento solo nella pagina di checkout o fatturazione sicura.
8. Torna a Piano e fatturazione e conferma lo stato risultante. Un caricamento o un reindirizzamento al checkout da solo non è la prova che il piano è cambiato.
## Gestisci la fatturazione o l'annullamento
1. Seleziona **Gestisci** o **Gestisci fatturazione** sull'abbonamento attuale.
2. Usa il portale di fatturazione sicuro per i metodi di pagamento, le fatture e le opzioni di annullamento presentate al tuo account.
3. Rivedi la conferma finale del portale prima di inviare un'azione finanziaria o di annullamento.
4. Torna a Runner e verifica il banner del piano attuale, l'avviso di fine/rinnovo o la modifica in sospeso.
## Acquista un Boost Pack
Un Boost Pack è un acquisto una tantum di 350 crediti a 9,90 USD, più le imposte applicabili. Non è un abbonamento e i suoi crediti si sommano allo stesso saldo universale.
1. Conferma che è mostrato un abbonamento attivo.
2. Apri il pacchetto di potenziamento crediti.
3. Scegli la quantità.
4. Rivedi i crediti totali e il prezzo totale.
5. Seleziona **Conferma acquisto** solo quando entrambi sono corretti.
6. Attendi **Acquisto completato** e verifica il saldo in [Crediti e utilizzo](./credits-and-usage).
Questa è un'azione finanziaria. Chiudere la conferma lascia l'acquisto non inviato. Il checkout mostra prezzo attuale, quantità, scadenza e condizioni di pagamento prima dell'acquisto.
## Stati e limiti
- Gli stati **Attivo**, **Scaduto**, **Annullamento in corso**, inattivo, legacy e modifica in sospeso possono esporre azioni diverse.
- Un abbonamento precedente scaduto può mostrare **Rinnova** al posto delle scelte di uno spazio Free mai pagante. Attendi i dettagli di fatturazione prima di selezionarlo.
- Un impegno annuale può disabilitare le scelte Mensile.
- Una modifica del piano può essere immediata, programmata o in sospeso di pagamento aggiuntivo. Usa lo stato che Runner mostra dopo la richiesta.
- **Configurazione dell'abbonamento** significa che Runner sta ancora confermando lo stato di pagamento restituito.
- Un timeout di elaborazione ti chiede di aggiornare e verificare; non prova il fallimento o il successo.
- L'acquisto di crediti extra non è disponibile senza un abbonamento attivo idoneo.
## Risoluzione dei problemi
- Se lo spazio di lavoro sbagliato è mostrato, chiudi Impostazioni e riaprilo dallo spazio di lavoro desiderato.
- Se l'interruttore Mensile è disabilitato, rivedi l'impegno annuale attuale mostrato sulla pagina.
- Se la gestione della fatturazione non si apre, riprova una volta e consenti al portale di fatturazione sicuro di aprirsi.
- Se l'abbonamento è Scaduto, segui l'azione di fatturazione visualizzata prima di tentare un'altra modifica del piano.
- Se il pagamento torna a uno stato di elaborazione, aggiorna e verifica prima di inviare di nuovo per evitare un tentativo duplicato.
## Guide correlate
- [Crediti e utilizzo](./credits-and-usage)
- [Spazio di lavoro Generale](../account-and-settings/workspace-general)
- [Elimina, recupera e esci](../account-and-settings/delete-recover-and-leave)
- [Competenze dell'agente](../agent/skills)
---
# Ti diamo il benvenuto in Runner AI
Source: https://www.runnerai.com/docs/it/guides/product-guide
Runner ti aiuta a trasformare un'idea di business in un negozio online funzionante, quindi gestire il negozio da un'unica area di lavoro. Queste guide spiegano ogni pagina principale, voce, pulsante, stato e passo successivo sicuro in linguaggio semplice.
**[Crea il tuo primo negozio, passo dopo passo](./start-here/first-store-quickstart)**
Segui gli screenshot e i brevi video per creare un negozio, inviare la prima richiesta, controllare l’anteprima e preparare la pubblicazione.
## Inizia con il percorso che corrisponde al tuo obiettivo
**Inizia**
- [Esplora Runner prima di creare un account](./start-here/explore-runner-before-sign-in)
**Esplora Runner prima dell'accesso** — Comprendi la navigazione pubblica corrente, la lingua, la demo e le azioni di accesso.
- [Valuta un modello di negozio finito](./start-here/browse-and-remix-templates)
**Sfoglia e remixa modelli di negozio** — Confronta le anteprime pubbliche e comprendi se il remixing è attualmente disponibile.
- [Costruisci il tuo primo negozio Runner](./start-here/create-runner-store)
**Crea un negozio Runner** — Crea un progetto, invia la prima richiesta e raggiungi l'area di lavoro del negozio.
- [Usa un negozio Shopify esistente](./start-here/connect-shopify)
**Connetti Shopify** — Avvia il percorso di connessione di Shopify e comprendi cosa rimane in Shopify.
**Crea**
- [Chiedi a Runner di costruire o cambiare qualcosa](./work-with-runner/chat-with-runner)
**Chat con Runner** — Invia una richiesta chiara, rispondi alle domande di follow-up e segui l'avanzamento del compito.
- [Rivedi la vetrina](./storefront-and-publishing/preview-your-store)
**Anteprima del tuo negozio** — Apri l'anteprima corrente e controlla i layout desktop o mobile.
- [Metti il negozio online](./storefront-and-publishing/prepare-to-publish)
**Preparati a pubblicare** — Completa la configurazione richiesta prima di selezionare **Pubblica**.
**Gestisci**
- [Aggiungi e gestisci prodotti](./store-operations/products)
**Prodotti** — Trova i controlli dei prodotti e comprendi il risultato di ogni azione.
- [Connetti pagamenti, spedizione o email](./apps-and-integrations)
**App e integrazioni** — Connetti, ispeziona, riconnetti o disconnetti servizi supportati.
**Migliora**
- [Comprendi le prestazioni](./analytics-and-seo)
**Analisi e SEO** — Leggi le visualizzazioni di negozio, traffico, conversione, ricerca e visibilità AI.
- [Trova una funzionalità mancante o bloccata](./advanced/feature-availability)
**Disponibilità delle funzionalità** — Identifica i prerequisiti e il passo successivo più sicuro senza indovinare.
- [Recupera da un problema](./help-and-reference)
**Aiuto e riferimento** — Diagnostica gli stati di compito, build, pubblicazione, checkout o integrazione.
## Il percorso usuale
1. [Accedi](./start-here/sign-in) e entra nella tua area di lavoro.
2. Apri il menu con il nome del negozio nella barra laterale e seleziona **Crea negozio**. In un’area di lavoro vuota, usa **Crea negozio** o **+ Negozio**, se presente. Scegli **Crea nuovo** o **Connetti Shopify** solo se compare la scelta del tipo di negozio.
3. [Dì a Runner cosa vuoi](./work-with-runner/write-effective-requests).
4. Segui lo stato del compito e rispondi a qualsiasi domanda mostri Runner.
5. Rivedi il risultato in [Vetrina](./storefront-and-publishing/preview-your-store).
6. Apporta modifiche visive in [Modalità di progettazione](./storefront-and-publishing/design-mode) o invia una richiesta di follow-up.
7. Configura prodotti, spedizione, pagamenti e dettagli del negozio.
8. Completa la [lista di controllo della pubblicazione](./storefront-and-publishing/prepare-to-publish), quindi pubblica.
9. Usa i gruppi **Crea**, **Cresci** e **Misura** nella barra laterale per gestire e migliorare l'attività.
## Sfoglia tutta la documentazione
### Inizia
- [Inizia qui](./start-here)
accedi, crea o connetti un negozio e completa il primo flusso di lavoro utile.
- [Area di lavoro](./workspace)
gestisci negozi, stati, compagni di squadra, notifiche e navigazione dell'area di lavoro.
- [Lavora con Runner](./work-with-runner)
usa chat, cronologia, ricerca, immagini, profili, skill e dettagli dei compiti.
### Costruisci e gestisci il negozio
- [Vetrina e pubblicazione](./storefront-and-publishing)
anteprima, progettazione, modifica del codice condizionale, versioni, pubblicazione, checkout e domini.
- [Operazioni del negozio](./store-operations)
impostazioni generali, spedizione, prodotti, ordini, clienti, promozioni, sourcing e recensioni.
- [App e integrazioni](./apps-and-integrations)
pagamenti, email, spedizione, Shopify, fulfillment e connessioni di agenti.
### Misura, automatizza e crea
- [Analisi e SEO](./analytics-and-seo)
metriche, traffico, conversione, prestazioni di ricerca, salute del sito e visibilità AI.
- [Automatizza, testa e crea](./automate-test-and-create)
automazioni, simulazioni, esperimenti, Creative Studio, Media Library e Ads.
- [Agente](./agent)
skill riutilizzabili, memoria e la tavolozza dei comandi.
### Configura e risolvi i problemi
- [Account e impostazioni](./account-and-settings)
area di lavoro, fatturazione, utilizzo, negozio, personale, chiave API e impostazioni di sicurezza.
- [Funzionalità avanzate](./advanced)
Research condizionale, Fly, Workflows, Webhooks e regole di disponibilità.
- [Aiuto e riferimento](./help-and-reference)
stati, risoluzione dei problemi, supporto, Changelog, FAQ e glossario.
## Come leggere queste guide
Ogni pagina di compito segue lo stesso modello:
### Mostra la struttura della pagina
1. **Percorso di ingresso** ti dice esattamente dove iniziare in Runner.
2. **Prima di iniziare** elenca lo stato del negozio richiesto, l'accesso, il piano o la connessione.
3. **Controlli** spiega cosa fa ogni pulsante importante dopo averlo selezionato.
4. **Passaggi** descrive il flusso di lavoro più breve e sicuro.
5. **Stati e risoluzione dei problemi** spiega cosa è cambiato e cosa provare dopo.
6. **Guide correlate** si collega al prossimo compito probabile.
## Confini di sicurezza
Prima di un clic ad alto impatto:
:::warning
- leggi la conferma e il nome del negozio o dell'area di lavoro interessato;
- salva il lavoro che dovrebbe rimanere disponibile;
- controlla se l'azione modifica il negozio in tempo reale, la fatturazione, la comunicazione con i clienti, i segreti o l'accesso del team;
- chiedi a un proprietario dell'area di lavoro quando il tuo ruolo non consente l'azione.
:::
---
# Inizia con Runner
Source: https://www.runnerai.com/docs/it/guides/start-here
**Cosa copre questa guida:** Saprai quale percorso di configurazione seguire e dove Runner ti porta dopo ogni passaggio.
Utilizza questa sezione quando accedi per la prima volta, avvii uno store basato su Runner,
o connetti uno store Shopify esistente.
**[Crea il tuo primo negozio, passo dopo passo](/it/guides/start-here/first-store-quickstart)**
Segui gli screenshot e i brevi video per creare un negozio, inviare la prima richiesta, controllare l’anteprima e preparare la pubblicazione.
**Percorso di accesso:** Accedi → area di lavoro → menu con il nome del negozio nella barra laterale → **Crea negozio**.
## Scegli il tuo percorso
| La tua situazione | Inizia qui | Cosa accade dopo |
| --- | --- | --- |
| Vuoi la procedura dettagliata completa più breve | [Crea il Tuo Primo Store](/it/guides/start-here/first-store-quickstart) | Passa da un'idea di store all'anteprima e ai controlli di pubblicazione. |
| Vuoi esplorare Runner prima di accedere | [Esplora Runner Prima di Accedere](/it/guides/start-here/explore-runner-before-sign-in) | Esamina la navigazione pubblica, la lingua, la demo e le azioni dell'account disponibili nel rollout corrente. |
| Vuoi valutare un modello di negozio | [Sfoglia e remixa modelli di negozio](/it/guides/start-here/browse-and-remix-templates) | Confronta le anteprime desktop, mobile e screenshot, quindi verifica la disponibilità di remix corrente. |
| Non hai un account Runner | [Accedi](/it/guides/start-here/sign-in) | Verifica il tuo account, quindi accedi a uno spazio di lavoro. |
| Vuoi che Runner crei la vetrina e il backend dello store | [Crea uno Store Runner](/it/guides/start-here/create-runner-store) | Runner crea un progetto e apre la sua conversazione. |
| Vendi già tramite Shopify | [Connetti Shopify](/it/guides/start-here/connect-shopify) | Runner avvia una connessione Shopify o riutilizza una connessione esistente idonea. |
| Vedi una finestra di dialogo introduttiva o un premio di credito | [Tour di Benvenuto e Crediti Giornalieri](/it/guides/start-here/welcome-tour-and-daily-credits) | Scopri le aree principali o reclama il premio attualmente mostrato. |
## Il percorso della prima esecuzione
1. [Accedi](/it/guides/start-here/sign-in) e apri la tua area di lavoro.
2. Completa il breve questionario aziendale se Runner lo mostra.
3. Apri il menu con il nome del negozio nella barra laterale e seleziona **Crea negozio**. In un’area di lavoro vuota, usa **Crea negozio** o **+ Negozio**, se presente.
4. Se compare la scelta del tipo di negozio, seleziona **Crea nuovo** per un nuovo negozio Runner oppure **Connetti Shopify** per un negozio Shopify esistente.
5. Compila il campo **Nome del negozio**, seleziona **Crea** e attendi che si apra il nuovo negozio.
6. Utilizza la conversazione del progetto per dire a Runner cosa vuoi costruire.
## Prima di iniziare
- Hai bisogno dell'accesso all'account email o Google utilizzato per accedere.
- Uno spazio di lavoro può avere limiti di store e posti. Runner mostra un percorso di aggiornamento quando un limite
blocca un'azione.
- **Connetti Shopify** potrebbe non apparire per ogni spazio di lavoro.
- Un'anteprima generata, una vetrina pubblicata e un checkout funzionante sono stati separati.
## Se rimani bloccato
- Se un codice email non riesce, richiedi un nuovo codice dopo che **Invia di nuovo il codice di verifica** diventa disponibile.
- Se **Crea negozio** apre un messaggio di aggiornamento, esamina il piano dell'area di lavoro corrente prima di riprovare.
- Se Shopify non è mostrato, crea uno store Runner o verifica se l'accesso a Shopify è abilitato per
il tuo spazio di lavoro.
## Guide correlate
- [Accedi](/it/guides/start-here/sign-in)
- [Esplora Runner Prima di Accedere](/it/guides/start-here/explore-runner-before-sign-in)
- [Sfoglia e remixa modelli di negozio](/it/guides/start-here/browse-and-remix-templates)
- [Crea uno Store Runner](/it/guides/start-here/create-runner-store)
- [Connetti Shopify](/it/guides/start-here/connect-shopify)
- [Crea il Tuo Primo Store](/it/guides/start-here/first-store-quickstart)
---
# Sfoglia e remixa i modelli di negozio
Source: https://www.runnerai.com/docs/it/guides/start-here/browse-and-remix-templates
La pagina pubblica dei modelli di negozio di Runner ti consente di ispezionare i modelli pubblicati prima di accedere e, quando il remixing è disponibile, richiedere una copia nel tuo workspace.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgR0WXr5OLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Scegli una categoria e un modello, esamina **Desktop**, **Mobile** o **Screenshot**, quindi seleziona **Usa questo modello** per iniziare a creare una copia. L’immagine mostra l’azione iniziale, non un remix completato.
Seleziona l’immagine per ingrandirla. Le annotazioni sono in inglese.
## Percorso di accesso
Apri la pagina pubblica **Modelli di negozio** di Runner su [www.runnerai.com/templates](https://www.runnerai.com/templates) o segui un link a un modello di negozio di Runner. Non è richiesto un account per sfogliare la galleria o aprire un modello.
## Prima di iniziare
- Hai bisogno di un account Runner e di un workspace attivo se il remixing diventa disponibile.
- Un'anteprima dal vivo, uno screenshot e un remix sono diversi: l'anteprima è di sola lettura; solo un remix riuscito crea lavoro di progetto.
- I modelli disponibili, le descrizioni e i conteggi di remix possono cambiare.
## Sfoglia la galleria
Usa il filtro delle categorie per restringere la galleria, inclusi i modelli di **Animazione 3D**. Ogni scheda mostra il titolo del modello, la miniatura quando disponibile e una breve descrizione. Seleziona una scheda per aprire la sua pagina di dettaglio. Se la pagina dice **Nessun modello di negozio ancora**, nessun modello pubblico è disponibile in quel momento; torna più tardi invece di trattarlo come un problema di account.
## Rivedi un modello
| Controllo o sezione | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Desktop** | Apre l'anteprima del modello dal vivo in una cornice a forma di desktop. Non modifica il modello. |
| **Mobile** | Mostra la stessa anteprima dal vivo in una cornice a forma di telefono stretto. |
| **Screenshot** | Mostra l'immagine della pagina completa salvata quando disponibile. È un'immagine statica, non il negozio dal vivo. |
| **Informazioni su questo modello** | Spiega lo scopo del modello. |
| **Progettato per** | Elenca i tipi di pubblico o di negozio a cui il modello è destinato. |
| **Evidenziazioni e capacità** | Riassume le idee principali dimostrate dal modello. |
| Conteggio remix | Mostra quante copie Runner ha registrato. Non misura i negozi attivi o le vendite. |
| **Torna alla galleria** | Torna all'elenco pubblico di modelli. |
Se un'anteprima dal vivo non è disponibile, usa **Screenshot** quando il modello ne ha uno. Uno screenshot o un'anteprima mancante non ti impedisce di leggere i dettagli del modello.
## Remixa il modello
1. Rivedi il modello in **Desktop**, **Mobile** e **Screenshot** come disponibili.
2. Seleziona **Usa questo modello** solo quando vuoi che Runner crei un progetto da esso.
3. Se sei disconnesso, completa il flusso di accesso. Runner mantiene il modello selezionato per il percorso di remix.
4. Dopo l'accesso, se la configurazione non è iniziata automaticamente, torna al dettaglio del modello e seleziona **Usa questo modello** di nuovo. Quindi attendi mentre il pulsante mostra **Configurazione del tuo negozio in corso…**.
5. La copia riesce quando Runner apre un nuovo progetto nello spazio di lavoro. Se compare un errore o si perde la connessione, controlla l'elenco dei negozi prima di riprovare: il messaggio da solo non dimostra che il progetto non sia stato creato.
6. Rivedi il negozio copiato, i prodotti, le impostazioni e lo stato di pubblicazione prima di renderlo attivo.
Un remix riuscito diventa il tuo progetto; modificarlo non altera il modello pubblico. È un punto di partenza, non una prova che pagamenti, spedizione, dati del catalogo, pubblicazione o checkout siano pronti.
## Risoluzione dei problemi
| Stato | Cosa fare |
| --- | --- |
| **Anteprima non disponibile** | Passa a **Screenshot** o leggi i dettagli del modello. |
| **Nessuno screenshot disponibile per questo modello** | Usa **Desktop** o **Mobile** se l'anteprima dal vivo funziona. |
| L'accesso si apre dopo **Usa questo modello** | Completa l'accesso con l'account che possiede il workspace previsto. Se la configurazione non inizia, torna al modello e seleziona **Usa questo modello** di nuovo. |
| **Configurazione del tuo negozio in corso…** | Mantieni la pagina aperta mentre Runner crea il progetto. Non avviare lo stesso remix di nuovo. |
| **Impossibile remixare questo negozio. Riprova.** | Controlla nel menu del negozio se esiste un nuovo progetto prima di riprovare. Se il remix resta indisponibile, esplora il modello o crea un nuovo negozio Runner. |
| Modello non trovato | Torna alla galleria; il modello potrebbe non essere più pubblicato. |
## Guide correlate
- [Esplora Runner prima dell'accesso](./explore-runner-before-sign-in)
- [Accedi](./sign-in)
- [Crea un negozio Runner](./create-runner-store)
- [Visualizza l'anteprima del tuo negozio](../storefront-and-publishing/preview-your-store)
---
# Connetti un negozio Shopify
Source: https://www.runnerai.com/docs/it/guides/start-here/connect-shopify
**Cosa copre questa guida:** Avvierai l'autorizzazione di Shopify o riutilizzerai una connessione Shopify idonea per un nuovo progetto Runner.
Usa questo percorso quando il tuo catalogo e il checkout vivono già in Shopify.
**Percorso di accesso:** menu del nome del negozio → **Crea negozio** → **Collega Shopify**, quando disponibile.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Apri il menu del nome del negozio e scegli **Create Store**. Prosegui con **Connect Shopify** solo se il tuo spazio di lavoro mostra questa opzione.
Le annotazioni sono in inglese. Seleziona l’immagine per ingrandirla.
## Prima di iniziare
- **Connetti Shopify** deve essere abilitato per il tuo workspace.
- Hai bisogno del dominio permanente del negozio che termina con `.myshopify.com`.
- Per una nuova connessione, hai bisogno del permesso di approvare l'accesso in Shopify.
- Il tuo workspace Runner deve avere spazio per un altro negozio.
## Controlli di Crea negozio
| Controllo | Perché è utile | Cosa accade dopo averlo selezionato |
| --- | --- | --- |
| Tipo di progetto **Connetti Shopify** | Mantiene il sistema di commerce Shopify esistente. | Mostra le scelte di connessione Shopify e il campo del dominio del negozio. |
| **Nome del negozio** | Nomina il progetto Runner. | Usato nel workspace Runner; non rinomina il negozio Shopify. |
| **Usa connessione esistente: _dominio_** | Evita di ripetere l'autorizzazione per una connessione idonea. | Seleziona quella connessione Shopify per il nuovo progetto Runner. |
| **Connetti un negozio diverso** | Inizia con un altro negozio Shopify. | Mostra **Dominio del negozio**. |
| **Dominio del negozio** | Identifica il negozio Shopify. | Accetta un dominio come `your-store.myshopify.com`. |
| Pulsante di invio **Connetti Shopify** | Avvia una nuova autorizzazione. | Ti invia a Shopify; Runner termina il passaggio solo dopo che Shopify ritorna con successo. |
| **Crea** | Usa la connessione esistente selezionata. | Crea il progetto Runner e lo apre. |
| **Annulla** | Lascia senza connettere o creare. | Chiude la finestra di dialogo. |
## Connetti un nuovo negozio Shopify
1. Apri il menu del negozio, seleziona **Crea negozio**, poi **Collega Shopify**.
2. Inserisci un **Nome del negozio** per il progetto Runner.
3. Scegli **Connetti un negozio diverso** se vengono mostrate scelte di connessione.
4. Inserisci il dominio completo `.myshopify.com` in **Dominio del negozio**.
5. Seleziona **Connetti Shopify**.
6. Rivedi la richiesta di accesso su Shopify e continua solo se nomina il negozio che ti aspetti.
7. Dopo che Shopify ritorna a Runner, conferma che il nuovo progetto appaia nel workspace.
## Riutilizza una connessione esistente
1. Scegli **Connetti Shopify** in **Crea negozio**.
2. Inserisci il **Nome del negozio** di Runner.
3. Seleziona **Usa connessione esistente: _dominio_**.
4. Seleziona **Crea**.
5. Controlla che Runner apra il nuovo progetto con il nome del negozio e la connessione Shopify desiderati.
## Risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| L'opzione Shopify è mancante | La funzione non è abilitata per questo workspace. | Usa **Costruisci nuovo** o controlla la disponibilità del workspace. |
| **Connetti Shopify** è disabilitato | Il nome del negozio o il dominio `.myshopify.com` è incompleto. | Correggi il campo evidenziato. |
| Connessione già collegata | Quella connessione Shopify appartiene a un altro negozio Runner. | Scegli un'altra connessione idonea o un negozio diverso. |
| Connessione non trovata | Una connessione salvata non è più disponibile. | Seleziona un'altra connessione o avvia una nuova autorizzazione. |
| L'autorizzazione di Shopify è annullata | Shopify non ha restituito una connessione approvata. | Torna a **Crea negozio** e riprova quando sei pronto. |
Il checkout rimane in Shopify per questo tipo di progetto. Una connessione riuscita non prova che
il negozio Runner sia costruito o pubblicato; rivedi quegli stati separatamente.
## Guide correlate
- [Crea un negozio Runner](/it/guides/start-here/create-runner-store)
- [Costruisci il tuo primo negozio](/it/guides/start-here/first-store-quickstart)
- [Inizia](/it/guides/start-here)
---
# Crea un negozio Runner
Source: https://www.runnerai.com/docs/it/guides/start-here/create-runner-store
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Creerai un nuovo progetto Runner e arriverai nella sua conversazione di progetto.
Usa **Costruisci nuovo** quando stai iniziando da un'idea e non hai bisogno di mantenere il checkout di Shopify.
**Percorso di accesso:** Spazio di lavoro → nome del negozio in cima alla barra laterale sinistra → **Crea negozio**. Espandi prima la barra laterale se è compressa. In uno spazio di lavoro vuoto, usa **Crea negozio** o **+ Negozio** quando mostrato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Segui [Crea il tuo primo negozio, passo dopo passo](./first-store-quickstart) per un esempio completo con screenshot e brevi registrazioni.
## Prima di iniziare
- Devi essere connesso a un workspace attivo.
- Il tuo workspace deve avere spazio per un altro negozio.
- Inserisci un nome che identifichi chiaramente il negozio al tuo team.
## Controlli di Crea negozio
| Controllo | Perché è utile | Cosa accade dopo averlo selezionato |
| --- | --- | --- |
| **Crea nuovo**, quando mostrato | Sceglie il percorso del negozio nativo di Runner. | Il modulo mantiene solo i campi necessari per un negozio Runner. Se non appare un selettore del tipo di negozio, continua con Nome del negozio. |
| **Nome del negozio** | Nomina il progetto nel tuo workspace. | **Crea** diventa disponibile dopo che il nome è valido. |
| **Crea** | Conferma il nuovo negozio. | Runner crea il progetto e naviga alla sua conversazione. |
| **Annulla** o chiudi | Lascia senza creare un negozio. | La finestra di dialogo si chiude e il workspace rimane invariato. |
## Crea il negozio
1. Apri il menu del nome del negozio nella barra laterale e seleziona **Crea negozio**, oppure usa l’azione di creazione nello spazio di lavoro vuoto.
2. Scegli **Crea nuovo** se il modulo offre questa scelta. Altrimenti, continua con **Nome del negozio**.
3. Inserisci il **Nome del negozio**.
4. Seleziona **Crea**.
5. Attendi che il nuovo progetto si apra.
6. Nella conversazione del progetto, descrivi la tua attività, il pubblico, lo stile visivo e le pagine necessarie. Puoi anche aprire **Negozio online** per inserire la prima richiesta.
Creare il progetto non lo pubblica. Runner ha ancora bisogno della tua richiesta prima di poter costruire un'anteprima del negozio.
Quando Runner completa la prima versione, apri **Negozio online** per controllare l’anteprima. Un’anteprima pronta non è ancora pubblica. Quando sei pronto a rendere pubblico il negozio, seleziona **Pubblica** e risolvi tutti i requisiti prima di confermare.
## Risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| **Crea** è disabilitato | Un valore richiesto è mancante o non valido, o la creazione è già in corso. | Rivedi il **Nome del negozio** e attendi qualsiasi azione in sospeso. |
| Messaggio di aggiornamento | Il workspace ha raggiunto il limite di negozio corrente. | Apri le informazioni sul piano mostrate da Runner o annulla la finestra di dialogo. |
| L'accesso al workspace è scaduto | I nuovi negozi non possono essere creati in quel workspace. | Segui il percorso di riattivazione del workspace o del piano mostrato sullo schermo. |
| La creazione non è riuscita | Runner non ha potuto finire di creare il progetto. | Mantieni il nome previsto, torna al workspace e riprova una volta. |
## Guide correlate
- [Accedi](/it/guides/start-here/sign-in)
- [Costruisci il tuo primo negozio](/it/guides/start-here/first-store-quickstart)
- [Connetti Shopify](/it/guides/start-here/connect-shopify)
- [Tour di benvenuto e crediti giornalieri](/it/guides/start-here/welcome-tour-and-daily-credits)
---
# Esplora Runner Prima di Accedere
Source: https://www.runnerai.com/docs/it/guides/start-here/explore-runner-before-sign-in
Le pagine pubbliche di Runner ti permettono di conoscere il prodotto, confrontare i prezzi e avviare una demo o un flusso di account prima di entrare in uno spazio di lavoro.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1kPfxvrvDHKGRP0BUIpjksTZQ9oN4rSwzeqA)
Usa **Prodotti** e **Risorse** per esplorare Runner, il **selettore della lingua** per scegliere una lingua e **Scopri come funziona** per aprire il video dimostrativo. Questa azione è distinta da **Prenota una demo**, che apre la prenotazione di un incontro quando disponibile.
Seleziona l’immagine per ingrandirla. Le annotazioni sono in inglese.
## Cosa copre questa guida
Ti orienterai tra le pagine pubbliche di Runner, sceglierai una lingua, prenoterai una demo in sicurezza e saprai se l'azione principale avvierà l'accesso o aprirà uno spazio di lavoro.
## Disponibilità e prerequisiti
- Non è richiesto un account per sfogliare le pagine pubbliche.
- Runner può mostrare uno di due layout di navigazione pubblica. Solo la versione assegnata alla visita corrente appare; questo è normale.
- Il pannello di pianificazione **Prenota una Demo** utilizza un servizio esterno e richiede una connessione di rete funzionante.
- L'azione dell'account principale cambia dopo l'accesso.
## Percorso di accesso
Apri la home page pubblica di Runner in un browser. Su dispositivi mobili, seleziona **Apri menu** per rivelare la navigazione e **Chiudi menu** per chiuderla.
## Controlli comuni
| Controllo | Cosa accade dopo la selezione |
| --- | --- |
| Selettore di lingua | Salva la lingua scelta per l'account con accesso effettuato o il browser corrente, quindi ricarica la pagina corrente in quella lingua. |
| **Prenota demo** o **Prenota una demo** | Apre il pannello di pianificazione, il cui titolo accessibile è **Prenota una Demo**. Una riunione viene creata solo dopo la conferma dello scheduler. |
| **Inizia** o **Inizia gratuitamente** | Apre il flusso di accesso o creazione account di Runner. L'etichetta dipende dalla versione della navigazione pubblica. |
| **Apri Spazio di Lavoro** | Appare per un visitatore con accesso effettuato e apre lo spazio di lavoro protetto. |
| Avatar con accesso effettuato | Apre il menu account disponibile invece dell'azione **Inizia** o **Inizia gratuitamente** senza accesso. |
| **Apri menu** / **Chiudi menu** | Mostra o nasconde la navigazione mobile. Selezionando una destinazione si chiude il menu mentre inizia la navigazione. |
Il menu mobile contiene i link e il controllo della lingua per la versione della navigazione pubblica a cui sei stato assegnato. L'azione principale rimane facile da raggiungere vicino al bordo del menu: **Inizia** o **Inizia gratuitamente** quando non hai effettuato l'accesso, o l'azione dello spazio di lavoro con accesso effettuato quando disponibile.
## Scegli il prossimo passaggio
1. Apri [Prezzi](https://www.runnerai.com/pricing) per confrontare piani pubblici e funzionalità incluse.
2. Sfoglia i [Modelli](https://www.runnerai.com/templates) per esaminare un punto di partenza su desktop e mobile.
3. Torna all'azione principale dell'account quando sei pronto a creare.
4. Dopo l'accesso, controlla che Runner apra lo spazio desiderato prima di creare un negozio.
## Cambia la lingua
1. Apri il selettore di lingua.
2. Seleziona la lingua desiderata.
3. Attendi il ricaricamento della pagina.
4. Conferma che la pagina corrente, piuttosto che una destinazione non correlata, si sia riaperta nella lingua selezionata.
Se il salvataggio non riesce, Runner mantiene la lingua precedente e segnala un errore. Riprova una volta dopo aver verificato la connessione. Un cambio di lingua influisce sul testo dell'interfaccia; non traduce il contenuto che hai inserito in un progetto di store.
## Prenota una demo
1. Seleziona **Prenota demo** o **Prenota una demo**, a seconda di quale mostra la tua navigazione.
2. Attendi che lo scheduler mostri le date e gli orari disponibili.
3. Scegli un orario e completa i dettagli di contatto richiesti.
4. Conferma la riunione all'interno dello scheduler.
5. Attendi il messaggio di successo di Runner e la chiusura del pannello.
Chiudere lo scheduler prima della conferma non prenota una riunione. Se rimane vuoto o non disponibile, chiudilo, verifica la connessione e riprova una volta. Utilizza [Supporto e comunità](/it/guides/help-and-reference/support-and-community) se il problema si ripete.
## Avvia o riapri Runner
- Quando non hai effettuato l'accesso, seleziona **Inizia** o **Inizia gratuitamente** e completa i passaggi di accesso o creazione account visualizzati.
- Quando hai già effettuato l'accesso, seleziona **Apri Spazio di Lavoro** per entrare nel prodotto protetto.
- Se un'azione protetta ti riporta all'accesso, completa l'accesso per l'account desiderato prima di continuare.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Link pubblici diversi dal previsto | Runner ha assegnato l'altra versione di navigazione corrente. Utilizza le etichette visibili. |
| I link mobili sono nascosti | Seleziona **Apri menu**. Dopo aver scelto un link, riapri il menu se hai bisogno di un'altra destinazione. |
| I pulsanti dell'account mostrano segnaposti | Runner sta ancora verificando la sessione. Attendi **Inizia**, **Inizia gratuitamente** o **Apri Spazio di Lavoro** prima di decidere se hai effettuato l'accesso. Il controllo della lingua può anche rimanere non disponibile durante questo controllo. |
| La lingua non cambia | La preferenza non è stata confermata. Verifica l'errore e la connessione, quindi riprova una volta. |
| Lo scheduler demo è in caricamento | Attendi i controlli di data e ora prima di inserire i dettagli. |
| Il pannello demo si chiude senza successo | Nessuna prenotazione è stata confermata. Riaprilo e completa la conferma dello scheduler. |
| **Inizia** o **Inizia gratuitamente** è sostituito da **Apri Spazio di Lavoro** | Runner riconosce una sessione con accesso effettuato. Apri lo spazio di lavoro o utilizza il menu avatar per le azioni dell'account. |
## Guide correlate
- [Accedi](/it/guides/start-here/sign-in)
- [Sfoglia e remixa modelli di negozio](/it/guides/start-here/browse-and-remix-templates)
- [Crea uno store Runner](/it/guides/start-here/create-runner-store)
- [Supporto e comunità](/it/guides/help-and-reference/support-and-community)
---
# Crea il tuo primo negozio, passo dopo passo
Source: https://www.runnerai.com/docs/it/guides/start-here/first-store-quickstart
Crea una vetrina che puoi controllare, modificare e preparare per la condivisione. Segui i passaggi in ordine oppure usa l'indice per tornare al passaggio che ti serve.
L'esempio è **Quiet Mornings**, un negozio di candele artigianali. Puoi usare la tua idea di attività al suo posto. Gli screenshot e le registrazioni senza audio mostrano l'interfaccia in inglese; le domande e i controlli disponibili possono variare da un negozio all'altro.
**Percorso di accesso:** [Runner AI](https://www.runnerai.com) → **Inizia gratis** → accedi → il tuo spazio di lavoro.
## Il percorso in breve
1. Apri il menu del nome del negozio → **Crea negozio** (oppure **+ Negozio** in uno spazio di lavoro vuoto). Scegli **Crea nuovo** se disponibile, oppure **Connetti Shopify** per un negozio Shopify esistente.
2. Nella conversazione del progetto, descrivi la tua attività, il pubblico, lo stile visivo e le pagine necessarie. Invia la richiesta e rispondi alle domande di Runner.
3. Quando la prima versione è pronta, apri **Negozio online** e controlla l’anteprima. Un’anteprima pronta non è ancora pubblica.
4. Quando sei pronto per il lancio, seleziona **Pubblica** e risolvi tutti i requisiti prima di confermare. La pubblicazione e il funzionamento del checkout richiedono verifiche separate.
## Prima di iniziare
- Usa un indirizzo email o un account Google a cui puoi accedere.
- Scegli uno spazio di lavoro con un posto disponibile per un negozio e crediti sufficienti per la richiesta. Risolvi eventuali limiti del piano o di accesso prima di creare un altro negozio.
- Prepara una frase su cosa vendi e chi lo acquista. Perfeziona il design dopo la prima anteprima.
Non devi collegare un fornitore di pagamenti per controllare una vetrina. **Anteprima**, **pubblicato** e **pronto ad accettare pagamenti** sono verifiche distinte.
## 1. Accedi [#sign-in]
1. Apri Runner e seleziona **Inizia gratis**. Se hai già effettuato l'accesso, seleziona **Apri il workspace**.
2. Seleziona **Continua con Google** e scegli il tuo account, oppure inserisci la tua **Email**, seleziona **Continua** e inserisci il codice dell'email di Runner.
3. Rispondi alle eventuali domande sull'account. Runner apre il tuo spazio di lavoro o torna alla pagina da cui hai iniziato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
**Verifica:** Puoi aprire il tuo spazio di lavoro senza tornare alla schermata di accesso. Consulta [Accedi](./sign-in) se il codice o la scelta dell'account non funzionano.
## 2. Crea un negozio [#create-store]
1. Seleziona il nome del negozio in cima alla barra laterale sinistra, poi **Crea negozio**. Espandi prima la barra laterale se è compressa. In uno spazio di lavoro vuoto, usa l'azione **Crea negozio** o **+ Negozio** mostrata lì.
2. Scegli **Crea nuovo** se il modulo propone una scelta. Usa invece [Connetti Shopify](./connect-shopify) per mantenere un negozio Shopify esistente.
3. Inserisci **Quiet Mornings** in **Nome del negozio**, oppure usa il tuo nome.
4. Seleziona **Crea** e attendi che il nuovo negozio si apra. Non selezionare di nuovo Crea mentre l'operazione è in corso.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
**Verifica:** La barra laterale mostra il nome del nuovo negozio. Creare il negozio non ne costruisce né pubblica ancora la vetrina.
## 3. Descrivi la prima versione [#first-request]
1. Seleziona **Negozio online**. Se non esiste ancora una versione creata, Runner mostra un campo in cui descrivere l'aspetto desiderato. Puoi anche usare la conversazione del nuovo negozio.
2. Copia questo esempio nel campo e modifica i dettagli dell'attività:
~~~text
Build a store for Quiet Mornings, a handmade candle brand for people
who enjoy slow mornings. Use warm cream colors, forest-green accents,
and spacious product photography. Include a homepage, product pages,
About, and Contact. Start with three sample candles: Morning Light,
Cedar Cabin, and Lavender Dusk. Keep the store unpublished.
~~~
3. Seleziona la freccia di invio (**Invia messaggio**). Se la schermata iniziale mostra **Inizia a costruire**, usa quell'azione.
4. Runner apre la conversazione di creazione e inizia a lavorare. Rimani in questo negozio mentre controlli il risultato.
**Verifica:** La richiesta appare nella conversazione. Sotto compare un indicatore di avanzamento o una domanda di approfondimento. I prodotti di esempio servono per fare pratica; sostituiscine i dettagli prima di venderli.
## 4. Rispondi alle domande e segui il lavoro [#follow-progress]
1. Leggi ogni domanda. Seleziona una risposta oppure usa **Altro…** per scriverne una tua.
2. Rispondi alle domande rimanenti. In questo esempio scegliamo il prezzo delle candele e lo stile delle fotografie.
3. Attendi che Runner continui. Apri **Dettagli** se devi capire un passaggio non riuscito o bloccato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
### Guarda: rispondere alle domande di approfondimento
La registrazione mostra la scelta del prezzo, il passaggio alla domanda sulle fotografie e la scelta di uno stile visivo. **Risposto** conferma le scelte e Runner riprende il lavoro. Le domande dipendono dalla tua richiesta.
**Verifica:** Nessuna domanda è ancora in attesa di risposta. Un messaggio completato da solo non è la verifica finale: apri la vetrina e controlla cosa viene effettivamente caricato.
## 5. Controlla l'anteprima e apporta una modifica [#preview-and-change]
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
1. Apri **Negozio online** oppure seleziona **Anteprima** sulla scheda della creazione completata, quando disponibile.
2. Attendi che appaia il negozio stesso. **Preparazione anteprima…** significa che non è ancora pronto per il controllo.
3. Apri la homepage, un prodotto, About e Contact. Controlla testi, immagini, prezzi e navigazione.
4. Usa il controllo del dispositivo per verificare **PC**, **Tablet** e **Telefono**. Cerca testo tagliato, pulsanti sovrapposti e scorrimento orizzontale.
5. Torna alla conversazione e chiedi una modifica specifica:
~~~text
Change the homepage headline to “Make room for a slower morning.”
Keep the colors, layout, and product information unchanged.
~~~
6. Attendi la modifica, riapri l'anteprima corrente e verifica che il nuovo titolo sia visibile. Controlla di nuovo Telefono.
**Verifica:** Puoi individuare la modifica richiesta nell'anteprima. Il negozio non è ancora pubblicato. Se disponibile, la [Modalità design](../storefront-and-publishing/design-mode) permette anche di selezionare un elemento per una modifica mirata.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
### Guarda: controllare i layout desktop e telefono
Il controllo del dispositivo passa da **PC** a **Tablet**, poi a **Telefono** e torna a **PC**. Cambia solo il riquadro dell’anteprima; questa azione non pubblica né modifica il negozio.
## 6. Esamina i controlli di pubblicazione [#publish-checks]
La pubblicazione può richiedere un piano a pagamento o ulteriori autorizzazioni nello spazio di lavoro. Se **Pubblica** apre un messaggio di upgrade, controlla i [piani attuali](https://www.runnerai.com/pricing) oppure torna all’anteprima. Risolvi questo requisito prima di aspettarti la conferma di pubblicazione.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
1. Seleziona **Pubblica** nella barra degli strumenti della Vetrina. Questo avvia i controlli di accesso e preparazione; non dimostra che il negozio sia online.
2. Leggi **Conferma Distribuzione** e attendi il controllo della build.
3. Risolvi gli elementi mostrati. **Correggi con IA** richiede una riparazione, **Riprova il controllo** esegue nuovamente il controllo e **Apri Operazioni del negozio** porta alla configurazione, quando disponibile.
4. Se stai facendo pratica, seleziona **Annulla**. Per rendere pubblica questa versione, esamina gli avvisi e seleziona **Conferma** solo quando è abilitato.
5. Dopo la conferma, attendi un risultato di pubblicazione riuscita, apri l'URL pubblico e controlla le pagine online. Se la pubblicazione non riesce, non presumere che le modifiche siano online.
Nello screenshot, il controllo della build è superato, ma la configurazione richiede ancora attenzione. **Pubblica comunque: completerò la configurazione più tardi.**, quando disponibile, conferma che hai preso atto della configurazione incompleta elencata; non completa quel lavoro.
### Guarda: uscire dai controlli senza pubblicare
La registrazione mostra l’esame del risultato della build e dell’avviso di configurazione, poi la selezione di **Annulla** per tornare all’Anteprima. Il negozio di esempio non viene pubblicato.
**Verifica:** Un'anteprima funzionante dimostra che la build è visibile a te. Una pubblicazione riuscita e un URL pubblico funzionante dimostrano che i visitatori possono raggiungerla. Prima di accettare ordini, occorre ancora completare il collegamento dei pagamenti e i controlli del checkout.
Usa [Preparati alla pubblicazione](../storefront-and-publishing/prepare-to-publish) per prodotti, spedizioni, politiche e altre impostazioni. Continua con [Pubblica e ripubblica](../storefront-and-publishing/publish-and-republish) e [Negozio online e checkout](../storefront-and-publishing/live-store-and-checkout).
## Se un passaggio non si conclude
| Cosa vedi | Il prossimo passo |
| --- | --- |
| Nessun negozio ancora | Apri il menu del nome del negozio o l'azione di creazione nello spazio di lavoro vuoto. |
| Un limite di negozi o del piano | Controlla il piano dello spazio di lavoro oppure scegline uno con spazio disponibile. Ripetere Crea non rimuove il limite. |
| Una domanda in attesa di risposta | Rispondi prima di aspettarti che Runner continui. |
| Preparazione dell'anteprima | Lascia aperta la versione corrente. Usa Aggiorna, se disponibile, quando la preparazione smette di avanzare. |
| Risultati non riusciti, interrotti o contraddittori | Apri Dettagli, leggi il problema rimasto e controlla l'anteprima effettiva. Chiedi a Runner di correggere il problema specifico invece di affidarti solo al riepilogo di successo. |
| Conferma è disabilitato | Completa la build o l'attività in corso e risolvi i requisiti elencati. “Nessuna modifica” richiede una nuova modifica salvata; non è un avviso da ignorare. |
| Un negozio online non accetta pagamenti | Completa il collegamento dei pagamenti e la configurazione del checkout indicati in Apps o nel flusso di pubblicazione. |
## Guide correlate
- [Crea un negozio Runner](./create-runner-store)
- [Scrivi richieste efficaci](../work-with-runner/write-effective-requests)
- [Visualizza l'anteprima del negozio](../storefront-and-publishing/preview-your-store)
- [Apri il tuo primo negozio ai clienti](../open-your-first-store)
---
# Accedi a Runner
Source: https://www.runnerai.com/docs/it/guides/start-here/sign-in
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Accederai e tornerai alla pagina di Runner o allo spazio di lavoro che ha avviato il flusso di accesso.
Utilizza l'email quando desideri un codice monouso senza password. Utilizza Google quando quell'account è già
disponibile nel tuo browser.
**Percorso di accesso:** Home di Runner → **Inizia gratis**, oppure **Apri il workspace** se hai già effettuato l’accesso.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgO6kRwpJCcW62zHrU8smjSnqvixd1twlAf4uK)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Per il percorso completo illustrato, segui [Crea il tuo primo negozio, passo dopo passo](./first-store-quickstart).
## Prima di iniziare
- Utilizza un account email che puoi aprire sullo stesso dispositivo attendibile.
- Se la tua organizzazione ti ha invitato, accedi con l'indirizzo email invitato.
- Non condividere un codice monouso o lasciarlo visibile in uno screenshot.
## Controlli di accesso
| Controllo | Perché è utile | Cosa accade dopo la selezione |
| --- | --- | --- |
| **Continua con Google** | Utilizza il tuo account Google. | Apre il flusso di account e consenso di Google. Runner riprende dopo che Google ritorna con successo. |
| **Email** | Ti permette di accedere senza password. | Accetta l'indirizzo che riceverà il codice monouso. |
| **Continua** | Richiede un codice email. | Runner invia un codice di verifica a sei cifre e apre il modulo del codice. |
| Campi del codice di verifica | Conferma che controlli l'indirizzo email. | Il modulo si invia automaticamente dopo l'inserimento di tutte e sei le cifre. |
| **Invia di nuovo il codice di verifica** | Sostituisce un codice mancante o scaduto. | Invia un altro codice dopo il completamento del conto alla rovescia visibile. |
## Accedi con email
1. Inserisci il tuo indirizzo email.
2. Seleziona **Continua**.
3. Apri il messaggio da Runner e trova il codice a sei cifre.
4. Inserisci tutte e sei le cifre. Non è necessario selezionare un altro pulsante di invio.
5. Attendi che Runner ti riporti alla destinazione sicura che ha avviato l'accesso.
## Completa le domande del nuovo account
Alcuni nuovi account visualizzano **Raccontaci del tuo store** prima di entrare nello spazio di lavoro.
1. Scegli una risposta per la domanda aperta.
2. Seleziona **Domanda successiva** per continuare.
3. Utilizza **Modifica** per rivedere una domanda a cui hai risposto.
4. Seleziona **Inizia** quando tutte le domande richieste sono complete.
Il questionario chiede il contesto aziendale; non crea o pubblica uno store di per sé.
## Risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| Email non valida | L'indirizzo è incompleto o non può essere utilizzato come inserito. | Correggi l'indirizzo, quindi seleziona **Continua** di nuovo. |
| Invio in corso | Runner sta richiedendo l'email di verifica. | Mantieni la pagina aperta fino a quando non appare il modulo del codice. |
| Codice non corretto | Il codice inserito non è stato accettato. | Reinserisci il codice più recente o richiedine un altro. |
| Conto alla rovescia di reinvio | Un altro codice non può essere inviato ancora. | Attendi fino a quando **Invia di nuovo il codice di verifica** è disponibile. |
| Salvataggio del questionario non riuscito | Runner non ha potuto archiviare le risposte. | Mantieni le tue risposte sullo schermo e riprova l'azione. |
Non condividere un codice di verifica con nessuno. Il supporto di Runner non ne ha bisogno per aiutare con un
problema di account.
## Guide correlate
- [Inizia](/it/guides/start-here)
- [Crea uno Store Runner](/it/guides/start-here/create-runner-store)
- [Crea il Tuo Primo Store](/it/guides/start-here/first-store-quickstart)
---
# Utilizza il Tour di Benvenuto e i Crediti Giornalieri
Source: https://www.runnerai.com/docs/it/guides/start-here/welcome-tour-and-daily-credits
**Cosa copre questa guida:** Lascerai il tour di benvenuto sapendo dove vivono gli strumenti principali e capirai cosa cambia dopo un check-in giornaliero.
Utilizza questa pagina quando Runner apre **Benvenuto in Runner** o quando **Guadagna crediti** è visibile.
## Percorsi di accesso
- **Tour di benvenuto:** Runner apre **Benvenuto in Runner** automaticamente per un account idoneo. Il tour non ha una voce di navigazione permanente.
- **Crediti giornalieri:** **Guadagna crediti** → **Check-in giornaliero**.
## Prima di iniziare
- Il tour di benvenuto e il premio giornaliero possono essere assenti quando l'account non è idoneo o il passaggio è già completato.
- Leggi l'importo, la scadenza e lo stato di reclamo nella finestra di dialogo corrente piuttosto che fare affidamento su uno screenshot più vecchio.
- I crediti di benvenuto sono separati dai check-in giornalieri. Leggi il messaggio attuale per sapere cosa è già stato aggiunto prima di richiedere il premio quotidiano.
## Segui il tour di benvenuto
I sei passaggi del tour introducono la costruzione e l'anteprima, Creative Studio, Skills, Dropshipping,
Operazioni del negozio e Design Mode.
| Controllo | Cosa accade |
| --- | --- |
| Punti dei passaggi | Salta direttamente al passaggio del tour selezionato. |
| **Indietro** | Ritorna al passaggio precedente. È disabilitato al primo passaggio. |
| **Avanti** | Apre il passaggio successivo. |
| **Ingrandisci video** | Apre la dimostrazione corrente a una dimensione più grande quando il video è pronto. |
| **Salta il tour** o chiudi | Chiude il tour senza modificare lo store. |
| **Inizia a costruire** | Termina l'ultimo passaggio e chiude il tour. |
1. Leggi lo scopo dell'area corrente.
2. Riproduci o ingrandisci la dimostrazione se aiuta.
3. Seleziona **Avanti**, **Indietro** o un punto del passaggio per muoverti attraverso il tour.
4. Seleziona **Inizia a costruire** nel passaggio finale, o **Salta il tour** quando sei pronto a lavorare.
Il tour è istruttivo. Non esegue una Skill, importa un prodotto o modifica una vetrina.
## Reclama un premio giornaliero
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsiEEL0uaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Nell’immagine: 1. Apri **Guadagna crediti**. 2. Trova **Check-in giornaliero**. 3. **Done** nell’immagine significa che il premio di oggi è già stato riscattato. I valori dell’account sono oscurati. Seleziona l’immagine per ingrandirla. Le annotazioni usano l’interfaccia desktop in inglese.
La finestra di dialogo può mostrare la sequenza corrente, i crediti disponibili oggi, la data di scadenza del premio,
i crediti concessi nel ciclo corrente e il prossimo traguardo.
Quando Runner mostra **Regalo di benvenuto**, conferma che i crediti indicati sono già nel saldo. Il pulsante giornaliero richiede un premio separato, non accredita di nuovo il regalo.
Chiudere **Regalo di benvenuto** non rimuove i crediti di benvenuto che sono già nel saldo. Chiudere un check-in giornaliero ancora reclamabile lascia quel premio giornaliero separato non reclamato.
1. Conferma che la finestra di dialogo dice che un premio è reclamabile.
2. Esamina l'importo e la data di scadenza mostrati.
3. Seleziona **Accedi oggi** o il pulsante di reclamo visibile.
4. Attendi lo stato reclamato prima di chiudere la finestra di dialogo.
5. Controlla saldo o cronologia dei premi per verificare che il premio giornaliero sia stato aggiunto una sola volta.
## Risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| Pulsante di reclamo disponibile | Il premio di oggi può essere reclamato per lo spazio di lavoro mostrato. | Selezionalo una volta e attendi la conferma. |
| Acceduto / reclamato | Il premio di oggi è già stato aggiunto. | Ritorna in un altro giorno idoneo. |
| Premio non disponibile | L'account non è attualmente idoneo o nessun reclamo è dovuto. | Chiudi la finestra di dialogo; non presumere che un credito sia stato aggiunto. |
| Reclamo non riuscito | Runner non ha confermato il premio. | Mantieni la finestra di dialogo aperta e riprova più tardi. |
Chiudere un premio reclamabile lo lascia non reclamato. Verifica la scadenza visualizzata prima di decidere di tornare più tardi.
## Guide correlate
- [Inizia](/it/guides/start-here)
- [Crea il Tuo Primo Store](/it/guides/start-here/first-store-quickstart)
- [Crea uno Store Runner](/it/guides/start-here/create-runner-store)
---
# Operazioni del negozio
Source: https://www.runnerai.com/docs/it/guides/store-operations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa Operazioni del negozio per gestire le informazioni e l'attività quotidiane dietro il tuo negozio Runner.
## Perché e quando usare Operazioni del negozio
Apri questa area dopo che Runner ha creato il tuo negozio. È il centro di controllo pratico per i dettagli del negozio, le regole di spedizione, i prodotti, gli ordini, i clienti e le promozioni. Alcuni lavori, come il sourcing dei fornitori o la moderazione delle recensioni, appaiono solo quando la capacità corrispondente è disponibile.
## Disponibilità e prerequisiti
- Accedi e apri un progetto Runner che include un negozio.
- Aspetta se Runner mostra **Per favore aspetta, l'amministratore del negozio sta distribuendo...**. Le pagine si caricano quando il backend del negozio è pronto.
- Il tuo ruolo nell'area di lavoro e lo stato del negozio possono limitare quali controlli vengono mostrati.
- I servizi di pagamento, spedizione, fulfillment, prenotazione e fornitore connessi possono aggiungere controlli specifici dello stato.
## Apri Operazioni del negozio
1. Apri **Area di lavoro**.
2. Scegli il negozio che vuoi gestire.
3. Seleziona **Operazioni del negozio** nella navigazione del progetto.
4. Se compaiono schede di configurazione, [completa i dettagli richiesti e risolvi prodotti e spedizioni](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
5. Scegli una sezione dal menu Operazioni negozio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRKgUAoOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Se compaiono queste schede, completa i dettagli richiesti e risolvi le fasi facoltative prima del menu amministrativo. L'immagine non mostra pubblicazione o configurazione dei pagamenti.
## Chiedi a Runner di aiutare dalla chat
**Percorso di accesso:** apri il progetto → scegli **Nuova attività** o una conversazione esistente.
Puoi chiedere a Runner di ispezionare o aggiornare i record del negozio approvati senza trovare ogni pagina di amministrazione
da solo. Questo include il lavoro comune con prodotti e varianti, clienti, inventario, spedizione,
fulfillment, ordini, resi, promozioni e record correlati.
1. Nomina il record e il risultato esatto che desideri.
2. Chiedi a Runner di ispezionare lo stato corrente per primo quando il cambiamento dipende da uno stato di ordine, inventario o
fulfillment.
3. Autorizza esplicitamente l'effetto esatto prima di un'azione distruttiva o del ciclo di vita dell'ordine. Una richiesta generale
non è il permesso di eliminare un record, annullare un ordine o avanzare il fulfillment.
4. Aspetta il risultato di Runner, quindi aggiorna la pagina Operazioni del negozio pertinente e verifica lo stato aggiornato
prima di riprovare o iniziare un altro cambiamento.
L'accesso all'account, le impostazioni del sistema del negozio, i pagamenti e l'amministrazione fiscale non sono disponibili attraverso
questa capacità di chat. Gli importi di prodotti e altri caricamenti di file utilizzano ancora i loro flussi dedicati.
## Scegli la sezione giusta
| Sezione | Usala per | Cosa mostra la selezione |
| --- | --- | --- |
| **Generale** | Visibilità del negozio, identità, mercati, ubicazioni di stock, spedizione e disponibilità delle recensioni | Apre la pagina delle impostazioni condivise. La maggior parte dei campi utilizza il **Salva** della pagina; l'interruttore **Recensioni dei prodotti** salva immediatamente. |
| **Ordini** | Acquisti dei clienti e avanzamento del fulfillment | Apre l'elenco degli ordini; selezionando una riga si apre il record dell'ordine completo. |
| **Prodotti** | Articoli del catalogo, prezzi, immagini, varianti, inventario e SEO | Apre l'elenco dei prodotti; **Aggiungi** avvia un nuovo prodotto e una riga apre la modifica. |
| **Clienti** | Dettagli di contatto dei clienti, indirizzi e cronologia degli ordini | Apre l'elenco dei clienti; selezionando una riga si apre il record del cliente. |
| **Promozioni** | Sconti automatici e codici promozionali | Apre l'elenco delle promozioni. Usa **Crea** o **Aggiungi prima promozione** in un elenco vuoto per scegliere un tipo di sconto. |
| **Dropshipping** (navigazione del progetto) | Esplorazione del catalogo fornitori, se disponibile | Apri la voce separata del progetto; i layout precedenti possono mostrarla dentro Operazioni negozio. |
| **Stampa su richiesta** (navigazione del progetto) | Prodotti con stampa personalizzata evasi da Printful, se disponibile | Apri la voce separata del progetto. Consulta [Stampa su richiesta con Printful](/it/guides/store-operations/print-on-demand). |
| **Recensioni** | Moderazione delle recensioni condizionale | Appare dopo che le recensioni dei prodotti sono abilitate e supportate dal negozio. |
**Generale qui** gestisce dettagli operativi come Mercati, Sedi inventario e Spedizioni. [Generali del negozio in Impostazioni](/it/guides/account-and-settings/store-general) gestisce nome Runner, anteprima ricerca, favicon e filigrana. Controlla quale pagina hai aperto prima di modificare.
La registrazione attraversa Ordini, Clienti e Recensioni nel negozio tutorial. Mostra stati vuoti e navigazione: non esegue acquisti, creazioni di clienti, rimborsi o evasioni.
## Ordine di configurazione consigliato
1. Completa [onboarding e impostazioni generali](/it/guides/store-operations/onboarding-and-general-settings).
2. Aggiungi un'ubicazione di stock e configura [spedizione](/it/guides/store-operations/shipping).
3. Crea [prodotti](/it/guides/store-operations/products) e controlla [varianti e inventario](/it/guides/store-operations/inventory-and-variants).
4. Connetti un servizio di pagamento da **App** prima di testare il checkout.
5. Usa [ordini](/it/guides/store-operations/orders), [clienti](/it/guides/store-operations/customers) e [promozioni](/it/guides/store-operations/promotions) quando l'attività inizia.
6. Usa [dropshipping](/it/guides/store-operations/dropshipping), [stampa su richiesta](/it/guides/store-operations/print-on-demand) o [recensioni](/it/guides/store-operations/reviews-and-advanced-admin) solo quando quelle voci e i prerequisiti sono disponibili.
## Stati comuni e limiti
- **Nessun dato ancora** è uno stato valido. Prodotti, ordini, clienti, promozioni e recensioni mostrano un messaggio vuoto fino a quando i record non esistono.
- **Il caricamento non è successo.** Aspetta un elenco, una conferma salvata o uno stato aggiornato prima di assumere che un'azione sia terminata.
- **Le modifiche non salvate rimangono sulla pagina.** Usa **Salva** dove mostrato; se Runner avverte di uscire, scegli se rimanere, salvare o uscire senza salvare.
- **Le azioni distruttive richiedono conferma.** L'eliminazione di un prodotto, cliente o promozione non può essere assunta come recuperabile.
- **I risultati della chat hanno ancora bisogno di verifica.** Dopo che Runner modifica un record del negozio, aggiorna la pagina pertinente e conferma il nuovo stato prima di riprovare.
- **Le voci condizionali possono essere assenti.** Non usare un URL copiato come prova che il tuo negozio supporta una funzionalità nascosta.
## Se Operazioni del negozio non si carica
1. Conferma di aver aperto il progetto previsto.
2. Aspetta che il messaggio di distribuzione si cancelli, quindi aggiorna la pagina.
3. Torna al progetto e seleziona di nuovo **Operazioni del negozio**.
4. Se solo una sezione non riesce, prova il suo controllo **Aggiorna** quando disponibile.
5. Se il problema continua, mantieni il nome del progetto, il nome della sezione, l'errore visibile e l'ora approssimativa per il supporto.
## Guide correlate
- [Ti diamo il benvenuto in Runner AI](/it/guides/product-guide)
- [Impostazioni generali e onboarding](/it/guides/store-operations/onboarding-and-general-settings)
- [Prodotti](/it/guides/store-operations/products)
- [Ordini](/it/guides/store-operations/orders)
---
# Clienti
Source: https://www.runnerai.com/docs/it/guides/store-operations/customers
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza Clienti per mantenere i record degli acquirenti accurati e comprendere gli ordini collegati a ogni persona.
## Perché e quando utilizzare Clienti
Apri questa sezione quando hai bisogno di trovare un acquirente, aggiungere un record cliente, correggere le informazioni di contatto o spedizione, o rivedere la cronologia degli ordini della persona.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Un cliente può apparire dopo il checkout o essere aggiunto manualmente.
- L'elenco etichetta i record come **Ospite** o **Registrato** quando le informazioni dell'account sono disponibili.
- Una Posizione di Stock salvata può essere richiesta dai flussi di lavoro dello store correlati agli indirizzi, ma non è un'affermazione che un indirizzo cliente sia un magazzino.
- Utilizza i dati dei clienti solo per lo scopo e l'accesso consentiti dalla tua organizzazione.
## Apri Clienti
**Percorso di accesso:** **Spazio di lavoro → scegli uno store → Operazioni del negozio → Clienti**
Seleziona una riga cliente per aprire profilo, attività e percorsi disponibili e Ordini. Seleziona **Modifica** per mostrare il modulo Generali; Ordini resta nascosto durante la modifica.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4cFKBjWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
L'elenco vuoto è normale prima che esistano clienti. Per questo esempio non è stato creato alcun record.
## Controlli principali
| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| **Cerca clienti...** | Trova un cliente per dettagli noti | Filtra l'elenco dei clienti dopo un breve ritardo. |
| **Aggiorna** | Richiedi dati cliente correnti | Ricarica l'elenco e i dati di posizione correlati. |
| **Crea** / **Aggiungi Cliente** | Aggiungi un cliente manualmente | Apre la finestra di dialogo di creazione del cliente. |
| **Crea** nella finestra di dialogo | Salva il nuovo cliente | Crea un record valido e apre la sua pagina di dettaglio dopo il successo. |
| Riga cliente | Ispeziona un cliente | Apre i dettagli di contatto, l'indirizzo di spedizione, il tipo di account e la cronologia degli ordini. |
| **Modifica** | Corregge i dati del cliente | Apre Generali con nomi, email di sola lettura, azienda, telefono e indirizzo di spedizione. Ordini è nascosto durante la modifica. |
| Sezione **Ordini** | Esamina gli acquisti del cliente | Mostra ordini collegati o **Nessun ordine ancora** nella vista di dettaglio in sola lettura. |
| **Salva** | Applica le modifiche senza uscire | Salva le modifiche valide e mantiene la pagina di dettaglio aperta. |
| Indietro o chiudi con modifiche non salvate | Decidi cosa fare con le modifiche | Apre una finestra di dialogo **Modifiche non salvate** con **Salva ed esci** e **Esci senza salvare**. |
| **Salva ed esci** | Applica le modifiche e ritorna | Dalla finestra di dialogo delle modifiche non salvate, salva le modifiche valide e ritorna all'elenco dei clienti. |
| **Esci senza salvare** | Scarta le modifiche dopo un avviso | Lascia la pagina di dettaglio senza applicare le modifiche non salvate. |
| Icona Elimina desktop / **Elimina** | Rimuovi un record cliente | Apre una conferma; la conferma non può essere annullata. L'elenco mobile corrente non mostra questa azione. |
Un cliente creato manualmente entra in **Tutti i clienti iscritti**. Aggiungi solo record reali che sei autorizzato a gestire; non creare destinatari per esplorare il modulo. Se attività o percorsi sono vuoti, mancano eventi per quel cliente: non significa che il profilo non sia stato salvato.
L'elenco vuoto può mostrare **0 clienti**. Usa ricerca, ordinamento e filtri dei tag quando esistono record. Rimuovi i filtri prima di concludere che un cliente manchi.
Il modulo mostra Email obbligatoria e campi facoltativi. **Crea** resta disabilitato finché non inserisci i dati richiesti; non è stato salvato alcun record.
## Aggiungi un cliente
1. Seleziona **Crea** o **Aggiungi Cliente**.
2. Inserisci **Email**, obbligatoria. Aggiungi Nome e Cognome se noti; controlla tag, indirizzo, azienda, telefono, campi personalizzati e Memoria solo quando hai informazioni pertinenti.
3. Esamina i valori per l'ortografia e il cliente desiderato.
4. Seleziona **Crea** una volta.
5. Nel record aperto, seleziona **Modifica** prima di aggiungere azienda, telefono o indirizzo di spedizione facoltativi.
6. Seleziona **Salva**, quindi ritorna all'elenco e conferma che la nuova riga appare. Se esci con modifiche non salvate, scegli **Salva ed esci** nell'avviso.
7. Un nuovo cliente valido viene iscritto automaticamente a **Tutti i clienti iscritti**.
## Aggiorna un cliente
1. Cerca e seleziona il cliente.
2. Seleziona **Modifica**. In **Generale**, esamina Nome, Cognome, Email di sola lettura, Azienda, Telefono e Indirizzo di spedizione.
3. Utilizza **Aggiungi** per aggiungere le informazioni di indirizzo che Runner richiede, o **Cancella** per rimuovere i valori di indirizzo modificabili correnti.
4. Seleziona **Salva** per rimanere sul record. Per salvare mentre esci, utilizza il controllo indietro o chiudi e scegli **Salva ed esci** nell'avviso.
5. Esci dalla modifica dopo aver salvato, poi controlla **Ordini** per verificare gli acquisti collegati.
## Stati e limiti
- **Ospite** significa che il record non è mostrato come un account cliente registrato; può comunque avere ordini.
- Un ospite che ordina o prenota al checkout non viene iscritto a **Tutti i clienti iscritti**. Viene iscritto solo tramite il modulo della newsletter del negozio o creando un account.
- **Registrato** identifica un record cliente supportato da un account.
- **Nessun cliente ancora** e **Nessun ordine ancora ancora** sono stati vuoti validi.
- La ricerca filtra solo il progetto corrente.
- Gli aggiornamenti dei clienti non modificano i totali degli ordini storici o gli stati dei pagamenti.
- Ricreare un cliente non annulla una precedente disiscrizione né la soppressione di quell'indirizzo da parte di un provider email.
- Elimina è esplicitamente irreversibile e attualmente disponibile solo dall'elenco desktop. Conferma l'email visualizzata prima di continuare e conserva i dati solo secondo la politica della tua organizzazione.
## Risoluzione dei problemi
- **Nessun cliente trovato:** Cancella o accorcia la ricerca e verifica di aver aperto il progetto corretto.
- **Salvataggio non riuscito:** Completa i campi obbligatori, correggi l'email o l'indirizzo e riprova una volta.
- **Non puoi lasciare il record:** Scegli **Salva ed esci** o rispondi alla finestra di dialogo Modifiche non salvate con **Esci senza salvare**.
- **Gli ordini mancano:** Conferma che l'ordine ha utilizzato lo stesso record cliente o email e aggiorna sia Clienti che Ordini.
- **I dettagli del cliente non si caricano:** Ritorna all'elenco, seleziona **Aggiorna** e riapri la riga.
## Guide correlate
- [Ordini](./orders)
- [Promozioni](./promotions)
- [Onboarding e Impostazioni Generali](./onboarding-and-general-settings)
- [Panoramica di Operazioni del negozio](/it/guides/store-operations)
---
# Vendere prodotti digitali
Source: https://www.runnerai.com/docs/it/guides/store-operations/digital-products
Usa i prodotti digitali per vendere file, come ebook, guide in PDF, modelli e altri download. Non si spedisce nulla. Dopo il pagamento, Runner invia all'acquirente un link privato a una pagina di consegna sul tuo negozio, dove scarica i file entro i limiti che imposti.
## Come funziona
1. **Crea un prodotto digitale.** Scegli **Digitale** come tipo di prodotto. I prodotti digitali non hanno spedizione né inventario.
2. **Aggiungi vantaggi.** Un vantaggio è ciò che riceve l'acquirente, per esempio un insieme di file. I vantaggi si possono riutilizzare in tutti i prodotti del tuo negozio.
3. **Scrivi l'email di consegna.** Runner la invia appena il pagamento viene acquisito.
4. **Pubblica.** Runner controlla che ogni vantaggio abbia un file pronto e che l'email del negozio sia attiva.
5. **Gestisci le consegne dall'ordine.** Reinvia l'email, revoca o ripristina l'accesso e decidi cosa succede all'accesso dopo un rimborso.
### Guarda: vendere un prodotto digitale dall'inizio alla fine
La registrazione crea un prodotto **Digitale** e aggiunge un vantaggio per ogni tipo: **Download di file**, **Codici o link monouso**, **Link di invito condiviso** e **Nota**. Scrive l'**Email di consegna**, imposta il prodotto su **Pubblicato** e salva. Poi un acquirente lo compra con una carta, vede l'acquisto nella pagina dell'ordine, apre l'email di consegna, scarica un file, mostra un codice e seleziona **Inviami un nuovo link via email**. Tornando in **Ordini**, la scheda **Consegna digitale** dell'ordine mostra ogni vantaggio, e la registrazione usa **Reinvia**, **Revoca** e **Ripristina**. Infine rimborsa un secondo ordine con **Revoca l'accesso dell'acquirente**. I dati della carta vengono inseriti fuori dalla registrazione. Interfaccia, sottotitoli e voce della registrazione sono in inglese.
## Prima di iniziare
**Percorso:** **Spazio di lavoro → scegli un negozio → Operazioni del negozio → Prodotti**
Se **Digitale** non compare nell'elenco **Tipo di prodotto**, i prodotti digitali non sono ancora attivi per il tuo account. Contatta il [supporto Runner](/it/guides/help-and-reference/support-and-community) per chiedere l'accesso. Se il modulo del prodotto mostra **Il tuo negozio deve essere aggiornato prima di poter vendere prodotti digitali.**, il negozio usa una versione precedente; contatta il supporto per aggiornarlo.
Ti servono:
- un negozio pubblicato, perché gli acquirenti aprono il loro acquisto sul tuo negozio;
- l'email del negozio attiva in **Progetto → App → Gestisci il tuo negozio → Email** finché l'email di consegna è attiva (vedi [Attivare l'email del negozio](/it/guides/apps-and-integrations/resend-email)); e
- un fornitore di pagamenti, perché gli acquirenti possano pagare. Vedi [Pagamenti Stripe](/it/guides/apps-and-integrations/stripe-payments).
## 1. Crea un prodotto digitale
1. Apri **Operazioni del negozio → Prodotti** e seleziona **Aggiungi**.
2. In **Tipo di prodotto**, scegli **Digitale**.
3. Inserisci nome, descrizione, immagini e prezzo come per qualsiasi prodotto.
Un prodotto digitale non ha la sezione spedizione e le sue scorte non vengono monitorate: l'elenco prodotti mostra **-** in **Inventario**. Chi acquista solo prodotti digitali paga senza il passaggio della spedizione.
## 2. Aggiungi vantaggi
La sezione **Vantaggi** elenca ciò che ricevono gli acquirenti. Gli acquirenti ottengono ogni vantaggio dell'elenco.
### Crea un vantaggio
1. Seleziona **Crea vantaggio**.
2. Inserisci un **Nome**, per esempio "File della guida". Gli acquirenti lo vedono nella pagina di consegna e nell'email.
3. Trascina i file su **Trascina qui i file** oppure seleziona **Sfoglia i file**. Un vantaggio contiene fino a 20 file da 5 GB ciascuno. I file restano privati: gli acquirenti li scaricano solo tramite il loro link.
4. In **Regole di accesso**, scegli:
- **Limita i download** e il numero di **Download per articolo**. Un download non riuscito si può ripetere entro 15 minuti senza consumare un altro download.
- **Il link scade** e per quanto **Il link funziona per**, in ore o giorni. Un reinvio dà all'acquirente un link nuovo.
5. Seleziona **Crea** per avviare il caricamento dei file. Tieni aperta la finestra finché i caricamenti non finiscono e il vantaggio compare nell'elenco **Vantaggi** del prodotto.
Per riutilizzare un vantaggio già creato, seleziona **Aggiungi vantaggio esistente**. Trascina i vantaggi, oppure usa **Sposta su** e **Sposta giù**, per stabilire l'ordine che vedono gli acquirenti. Un prodotto digitale mantiene almeno un vantaggio.
### Scegli il tipo di vantaggio
Quando crei un vantaggio, scegli il suo **Tipo**. Non potrai cambiarlo in seguito.
| Tipo | Cosa ricevono gli acquirenti |
| --- | --- |
| **Download di file** | File privati che gli acquirenti scaricano dalla loro pagina di consegna. |
| **Codici o link monouso** | Ogni acquirente riceve un codice o un link diverso da un elenco che incolli. Il prodotto si esaurisce quando l'elenco finisce. |
| **Link di invito condiviso** | Un link che tutti gli acquirenti aprono, come l'invito a una community. |
| **Nota** | Un testo che gli acquirenti vedono dopo l'acquisto, oppure un'etichetta nascosta per ordini che gestisci tu. |
Se **Tipo** mostra solo **Download di file**, il negozio usa una versione precedente; contatta il [supporto Runner](/it/guides/help-and-reference/support-and-community) per aggiornarlo.
#### Codici o link monouso
1. In **Aggiungi codici o link**, incolla un codice o un link per riga, fino a 10.000 alla volta. I duplicati vengono saltati e ogni valore viene salvato cifrato.
2. Il vantaggio mostra quanti valori sono **Pronti per la vendita** e quanti sono **Venduti o riservati per ordini**, e ti avvisa quando ne restano pochi. Quando l'elenco è vuoto, il prodotto risulta esaurito e il checkout lo rifiuta.
3. Ogni unità pagata riceve il suo valore, che l'acquirente rivela nella sua pagina di consegna.
4. Per ritirare un valore che nessuno ha acquistato, rimuovilo da **Valori non usati**.
Nell'ordine, la scheda **Consegna digitale** mostra la parte finale di ogni valore e se l'acquirente l'ha rivelato. Seleziona **Mostra** per vedere il valore intero, oppure **Copia** per copiarlo.
#### Link di invito condiviso
Inserisci il **Link di invito**, che inizi con https:// o http://. Tutti gli acquirenti ricevono lo stesso link, quindi imposta la sua scadenza dove viene gestito il link, per esempio nelle impostazioni della tua community. La scheda dell'ordine mostra se l'acquirente l'ha aperto.
#### Nota
Scrivi la nota in **Nota privata**, poi scegli la sua **Visibilità**:
- **Visibile**: gli acquirenti la vedono dopo l'acquisto, nella conferma dell'ordine e nella loro pagina di consegna.
- **Nascosta**: viene assegnata con l'acquisto ma non viene mai mostrata all'acquirente, per esempio per etichettare gli ordini che gestisci tu.
Un prodotto pubblicato mantiene almeno un vantaggio che gli acquirenti vedono, quindi non puoi nascondere la sua unica nota visibile. Non puoi nascondere nemmeno una nota citata dall'email di consegna di un prodotto: prima rimuovila dall'email. Le note nascoste non hanno variabili email.
### Metti in pausa un vantaggio
Disattiva l'interruttore accanto a un vantaggio per metterlo in pausa per tutti gli acquirenti di tutti i prodotti che lo usano. Gli acquirenti non possono scaricarlo finché non lo riattivi. I nuovi acquisti restano in attesa, e la loro email parte appena riattivi il vantaggio.
### Cambia i file in seguito
Puoi aggiungere file a un vantaggio in qualsiasi momento; gli acquirenti esistenti li vedono nella loro pagina di consegna. Rimuovere un file lo rimuove per tutti gli acquirenti. Un vantaggio venduto dai prodotti mantiene almeno un file: aggiungi prima un altro file oppure rimuovi il vantaggio da quei prodotti.
## 3. Scrivi l'email di consegna
La sezione **Email di consegna** controlla il messaggio che gli acquirenti ricevono appena il pagamento viene acquisito.
| Impostazione | Cosa fa |
| --- | --- |
| **Invia l'email di consegna** | Disattivala per consegnare solo nella pagina di conferma dell'ordine. Gli acquirenti trovano lì il loro acquisto per 24 ore, e il reinvio da parte del cliente è disattivato. |
| **Da** | Il nome del mittente che vedono gli acquirenti. L'email parte dall'indirizzo di Runner e le risposte arrivano all'email di contatto del tuo negozio. |
| **Oggetto** e **Messaggio** | Usa **Inserisci variabile** per aggiungere numero d'ordine, data dell'ordine, nome del prodotto, totale pagato, nome o email dell'acquirente, nome del negozio e **Tutti i vantaggi**, che stampa l'elenco dei vantaggi. Link, scadenza e download appartengono a un singolo vantaggio, quindi sono elencati sotto ciascuno. |
| **URL del logo** e **Colore d'accento** | Tutte le email di consegna usano lo stesso design. Con un **URL del logo**, il tuo logo compare in cima all'email, e il colore d'accento evidenzia il nome e il pulsante di ogni vantaggio. Lascia vuoto **URL del logo** per inviare l'email senza logo. |
Seleziona **Anteprima** per vedere l'email di un ordine di esempio. L'editor rifiuta le variabili che non conosce.
In **Impostazioni avanzate**:
- **I clienti possono reinviare l'email** permette agli acquirenti di richiederla di nuovo dalla pagina di consegna, fino a 3 volte al giorno, all'indirizzo email dell'ordine.
- **Reinvia automaticamente in caso di rimbalzo temporaneo** riprova una volta dopo 30 minuti con lo stesso link.
## 4. Pubblica
Imposta **Stato** su **Pubblicato** e salva. Se manca qualcosa, Runner salva il prodotto come bozza e mostra **Questo prodotto non può ancora essere pubblicato** con cosa sistemare:
| Messaggio | Cosa fare |
| --- | --- |
| **Aggiungi almeno un vantaggio.** | Aggiungi un vantaggio nella sezione **Vantaggi**. |
| **Aggiungi un file a** un vantaggio | Carica almeno un file per quel vantaggio. |
| **Attendi che** un vantaggio **finisca di caricarsi.** | Tieni la pagina aperta finché ogni file mostra **Pronto**. |
| **Attiva l'app Email in App oppure disattiva l'email di consegna di questo prodotto.** | Attiva **Email** in **Progetto → App → Gestisci il tuo negozio** oppure disattiva **Invia l'email di consegna**. |
| **Il tuo negozio deve essere aggiornato prima di poter vendere prodotti digitali.** | Contatta il [supporto Runner](/it/guides/help-and-reference/support-and-community). |
## Cosa ricevono gli acquirenti
1. L'acquirente completa il checkout. Un carrello con soli prodotti digitali non ha il passaggio della spedizione.
2. Appena il pagamento viene acquisito, Runner invia all'acquirente un link alla sua pagina di consegna sul tuo negozio. Anche la pagina di conferma dell'ordine mostra l'acquisto per 24 ore.
3. Nella pagina di consegna, l'acquirente scarica ogni file. Ogni download conta per il limite, e il link smette di funzionare quando scade o quando ne invii uno più recente.
4. Se lo consenti, l'acquirente può richiedere di nuovo l'email dalla pagina di consegna.
## Gestisci le consegne di un ordine
In **Operazioni del negozio → Ordini**, la colonna **Evasione** mostra lo stato di consegna di ogni ordine digitale, con gli stati della tabella qui sotto. Se un ordine ha più vantaggi, la colonna mostra quello che richiede prima il tuo intervento: **Non riuscito**, poi uno stato non ancora consegnato (**In attesa**, **Invio in corso** o **Link pronto**), poi **Consegnato**. **Download esauriti**, **Scaduto** e **Revocato** compaiono solo quando tutti i vantaggi sono terminati. Un ordine mostra **Nessuna spedizione** finché il pagamento non viene acquisito.
Apri **Operazioni del negozio → Ordini** e seleziona un ordine. La scheda **Consegna digitale** mostra ogni vantaggio con il suo stato, **Download usati**, **Il link scade** e **Ultima attività**.
| Stato | Significato |
| --- | --- |
| **In attesa** | La consegna è in attesa, per esempio mentre il vantaggio è in pausa. |
| **Link pronto** | Il link esiste. L'email è in coda, oppure l'email di consegna è disattivata. |
| **Invio in corso** | L'email è in viaggio. |
| **Consegnato** | L'email ha raggiunto l'acquirente. |
| **Non riuscito** | La consegna si è fermata. La scheda spiega perché, per esempio **L'email del negozio è disattivata** oppure **Il negozio non è pubblicato**. |
| **Download esauriti** | L'acquirente ha usato tutti i download. Un reinvio li ripristina. |
| **Scaduto** | Il link è scaduto. Un reinvio dà un link nuovo. |
| **Revocato** | Hai revocato l'accesso. |
Usa le azioni della scheda:
- **Reinvia** invia un link nuovo, eventualmente a un indirizzo corretto. I link precedenti smettono di funzionare e i download esauriti vengono ripristinati.
- **Revoca** blocca i nuovi download per un vantaggio o per l'intero ordine. Un link di download emesso nell'ultimo minuto può ancora completarsi.
- **Ripristina** riattiva un accesso revocato con una nuova quota di download e invia un link nuovo.
**Cronologia di consegna** elenca ogni email con il suo esito, e **Percorso** elenca ogni evento, come **Email aperta**, **Pagina di consegna aperta** e **Scaricato**. Seleziona **Esporta CSV** per scaricare il percorso.
Per trovare gli ordini che richiedono il tuo intervento, attiva il filtro **Richiede attenzione** nell'elenco ordini. Mostra le consegne non riuscite e i rimborsi senza una decisione sull'accesso.
### Rimborsi
Quando rimborsi un ordine con articoli digitali, scegli **Mantieni l'accesso dell'acquirente** oppure **Revoca l'accesso dell'acquirente** nella finestra del rimborso. Un rimborso fatto altrove, per esempio nella dashboard del tuo fornitore di pagamenti, compare nella scheda come rimborsato con l'accesso ancora attivo, con **Mantieni l'accesso** e **Revoca l'accesso**, così puoi decidere più tardi.
## Crea un prodotto digitale in chat
Puoi anche chiederlo a Runner in chat. Allega i file al messaggio e descrivi il prodotto, per esempio "Vendi questo PDF come ebook a 12 €". Runner crea una bozza del prodotto con un vantaggio per i file e prepara l'email di consegna. Si ferma dove solo tu puoi agire, per esempio quando l'email del negozio è disattivata. Controlla la bozza in **Prodotti** prima di pubblicare.
I file allegati in chat sono limitati a ciò che la chat accetta: documenti fino a 10 MB e immagini fino a 32 MB. Carica i file più grandi nel modulo del prodotto.
## Risoluzione dei problemi
| Problema | Cosa fare |
| --- | --- |
| La scheda mostra **Non riuscito** con **L'email del negozio è disattivata** | Attiva **Email** in **Progetto → App → Gestisci il tuo negozio**, poi seleziona **Reinvia**. |
| La scheda mostra **Non riuscito** con **Il negozio non è pubblicato** | Pubblica il negozio, poi seleziona **Reinvia**. |
| L'email risulta **Respinta** | Verifica l'indirizzo con l'acquirente, poi seleziona **Reinvia** e inserisci l'indirizzo corretto. |
| **Nessun file era pronto quando l'ordine è stato pagato.** | Carica un file per il vantaggio, poi seleziona **Reinvia**. |
| **Il vantaggio è in pausa.** | Riattiva il vantaggio. L'email in attesa parte. |
---
# Dropshipping
Source: https://www.runnerai.com/docs/it/guides/store-operations/dropshipping
Il dropshipping ti permette di vendere prodotti dei fornitori senza tenere scorte: quando un cliente acquista, Runner invia l'ordine al tuo fornitore, e tu lo confermi e lo paghi nel tuo account fornitore perché il fornitore lo spedisca al cliente.
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Dropshipping**
I layout precedenti possono mostrare Dropshipping dentro **Operazioni del negozio**. Usa la voce che mostra il tuo progetto.
## Come funziona il dropshipping
| Fase | Cosa fai tu | Cosa fa Runner |
| --- | --- | --- |
| [1. Collega](#1-collega-un-fornitore) | Collega il tuo account CJ Dropshipping o AliExpress. | Usa quell'account per cercare, importare ed effettuare ordini al fornitore. |
| [2. Esplora e scegli](#2-esplora-e-scegli-un-prodotto) | Scegli una destinazione, trova un prodotto e confronta varianti, disponibilità e tempi di consegna stimati. | Carica i dati aggiornati del fornitore per il tuo account collegato. |
| [3. Controlla e pubblica](#3-controlla-e-pubblica-un-prodotto) | Scegli un mercato di destinazione, imposta i prezzi, seleziona le varianti e aggiungi il prodotto. | Crea il prodotto e lo pubblica in quel mercato. |
| [4. Evadi gli ordini](#4-evadi-gli-ordini) | **Paga ogni ordine al fornitore nel tuo account fornitore**, poi registra la spedizione nell'ordine del negozio. | Crea automaticamente l'ordine al fornitore dopo il checkout e ne mostra stato e tracciamento. |
Per smettere di usare un fornitore o cambiare account fornitore, consulta [Disconnetti un fornitore](#disconnetti-un-fornitore). È un'attività separata con i suoi controlli, non fa parte del lavoro quotidiano.
:::warning
Runner effettua gli ordini al fornitore per te, ma **non paga il fornitore**. Un ordine al fornitore resta non pagato, e non viene spedito, finché non lo confermi e lo paghi nel tuo account CJ o AliExpress.
:::
## Prima di iniziare
- **Un tuo account fornitore.** Usa un account CJ Dropshipping o un account acquirente AliExpress con cui puoi pagare gli ordini. Paghi il fornitore per ogni ordine separatamente da ciò che il cliente paga a te.
- **Ruolo di proprietario o amministratore.** Solo un proprietario o un amministratore dell'area di lavoro può collegare o disconnettere un fornitore. Gli altri membri vedono **Solo il proprietario o un amministratore del workspace può collegare questo fornitore. Chiediglielo.**
- **Un mercato del negozio.** Le destinazioni del dropshipping provengono dai mercati del tuo negozio. Senza un mercato, la pagina mostra **Aggiungi un mercato per scegliere una destinazione di spedizione ed esplorare i prodotti.**
- **Un servizio di pagamento.** I clienti possono acquistare solo dopo che hai collegato un servizio di pagamento in **App**.
Le connessioni ai fornitori appartengono alla tua organizzazione, quindi tutti i negozi dell'area di lavoro usano le stesse connessioni CJ e AliExpress. CJ e AliExpress si collegano separatamente: collegarne uno non sostituisce mai l'altro.
## 1. Collega un fornitore
Puoi sfogliare le raccolte di anteprima **Di tendenza**, **Scelte convenienti** e **Sotto i 5 $** senza una connessione. Per cercare, aprire i dati aggiornati dei prodotti e aggiungere prodotti serve un fornitore collegato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTAfhTYD7lIPXqUA4xQWKLGpygc8jMtzfNJri)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Collega fornitore** | Avvia la tua prima connessione a un fornitore. | Apre **Connetti e gestisci fornitori** con pannelli separati per CJ Dropshipping e AliExpress. |
| **Gestisci fornitori** | Controlla, ricollega o disconnetti una connessione esistente. | Sostituisce **Collega fornitore** quando almeno un fornitore è collegato e apre la stessa finestra. |
| **Come funziona** | Confronta i due metodi di connessione. | Spiega che CJ usa una chiave API e AliExpress usa l'accesso ad AliExpress. |
| **Chiave API CJ** | Collega il tuo account CJ. | Accetta la chiave che hai copiato da CJ. Il valore resta nascosto. |
| **Visualizza le istruzioni di CJ** | Trova la tua chiave API in CJ. | Apre in una nuova scheda le istruzioni di CJ sulla chiave API. |
| **Collega CJ Dropshipping** | Invia la chiave. | Runner verifica la chiave con CJ. Se va a buon fine, la finestra si chiude e CJ risulta collegato. |
| **Collega AliExpress** | Collega il tuo account acquirente AliExpress. | Ti porta all'accesso ad AliExpress, poi ti riporta a Dropshipping. |
| **Ricollega AliExpress** | Rinnova l'accesso ad AliExpress prima o dopo la scadenza. | Ripete l'accesso ad AliExpress per l'account collegato. |
### Collega CJ Dropshipping
1. Apri **Dropshipping** e seleziona **Collega fornitore** (o **Gestisci fornitori**).
2. Nel tuo account CJ Dropshipping, apri **Apps → API**, poi seleziona la scheda **API**. Copia la chiave di tipo **API Key** dalla colonna **API Key & MCP Token**. Se non ne hai una, seleziona **Add API** per crearla. Se ti servono i passaggi di CJ, seleziona **Visualizza le istruzioni di CJ** in Runner.
3. Incolla la chiave in **Chiave API CJ** e seleziona **Collega CJ Dropshipping**.
4. Attendi che la finestra si chiuda e che CJ Dropshipping risulti collegato.
5. Cerca un prodotto per verificare che il tuo catalogo CJ venga caricato.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw6oh1NIkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
In CJ, apri **Apps** (1) e **API** (2), seleziona la scheda **API** (3) e copia la chiave da **API Key & MCP Token** (4). Seleziona l’immagine per ingrandirla. Tieni privata la tua chiave; in questo esempio i valori delle chiavi sono nascosti.
Se vedi **Non è stato possibile collegare CJ: ricontrolla la chiave API e riprova.**, copia di nuovo la chiave da CJ e riprova. Questo messaggio significa che CJ ha rifiutato la chiave. Se vedi **CJ non ha risposto. Riprova tra un momento.**, CJ ha avuto un problema durante il controllo della chiave; riprova a breve. Se vedi **CJ sta limitando le richieste per questo account. Attendi qualche minuto, poi riprova.**, la chiave può comunque essere valida: CJ sta limitando le chiamate al tuo account CJ, per esempio perché un’altra app usa la stessa chiave. Attendi qualche minuto, poi riprova.
### Collega AliExpress
1. Apri **Dropshipping** e seleziona **Collega fornitore** (o **Gestisci fornitori**).
2. Seleziona **Collega AliExpress**. Il browser esce da Runner e apre l'accesso ad AliExpress.
3. Accedi con l'account **acquirente** AliExpress che userai per pagare gli ordini al fornitore e approva l'accesso.
4. Quando AliExpress ti riporta a Runner, cerca **AliExpress è connesso**. Se eri partito da una ricerca o da un prodotto, Runner ti riporta lì.
Se vedi **Non siamo riusciti ad aprire l’accesso ad AliExpress. Riprova.**, avvia di nuovo la connessione dallo stesso account Runner.
**L'accesso ad AliExpress scade.** È AliExpress a stabilire quanto dura l'accesso. Runner mostra **La tua autorizzazione AliExpress scade a breve** e invia un'email ai proprietari e agli amministratori dell'area di lavoro 7 giorni e 1 giorno prima della scadenza. Seleziona **Ricollega AliExpress** e accedi con lo **stesso** account AliExpress. Se l'accesso scade, ricerca, importazione e nuovi ordini AliExpress si fermano finché non ricolleghi l'account.
La registrazione esamina le connessioni CJ e AliExpress esistenti, poi torna al catalogo. Non collega, disconnette, acquista né importa nulla.
## 2. Esplora e scegli un prodotto
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgL9CDE0P6BaUgYNS457p8WDbAxIJ2kfdz9Vju)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Di tendenza**, **Scelte convenienti**, **Sotto i 5 $** | Trova idee senza cercare. | Apre una raccolta di anteprima. Le raccolte non garantiscono popolarità, margini o consegna. |
| **Cerca prodotti...** | Trova articoli per parola chiave. Con AliExpress puoi anche incollare l'ID o il link di un prodotto. | Carica i risultati dal fornitore collegato. Senza una connessione, apre la finestra di connessione. |
| **Spedisci a** | Scegli il paese in cui vendi. | Ricarica i prodotti che possono essere spediti lì. Puoi selezionare solo i paesi dei mercati del tuo negozio; gli altri mostrano **Aggiungi** per creare un mercato. |
| Selettore del fornitore | Limita i risultati a un solo fornitore. | Mostra **Tutti i fornitori**, **CJ Dropshipping** o **AliExpress**, a seconda di cosa hai collegato. |
| **Categoria**, **Spedisci da**, **Prezzo** | Restringi i risultati. | Filtra per categoria, paese del magazzino del fornitore e prezzo minimo e massimo. |
| Ordinamento | Cambia l'ordine dei risultati. | CJ offre ordinamenti per prezzo, inserzione e novità. AliExpress offre **Migliore corrispondenza** e **Più ordini (ultimi 180 giorni)**; non può ordinare in modo affidabile per prezzo. |
| Scheda prodotto | Valuta un articolo. | Apre immagini, varianti, disponibilità, prezzo del fornitore e tempi di consegna stimati. |
1. Scegli **Spedisci a**. Parte dagli Stati Uniti se sono uno dei tuoi mercati, altrimenti dal tuo mercato predefinito.
2. Sfoglia una raccolta o cerca. Usa il selettore del fornitore e i filtri per restringere i risultati.
3. Apri una scheda prodotto. Controlla le immagini, le varianti che vuoi vendere, la disponibilità (**disponibile** o **Esaurito**) e il prezzo del fornitore.
4. Per ogni variante, controlla **Metodo di spedizione di riferimento** e **Tempi di consegna stimati**. Sono stime del fornitore, non garanzie di consegna.
5. Seleziona **Indietro** per confrontare altri prodotti. La destinazione resta selezionata.
## 3. Controlla e pubblica un prodotto
La pagina del prodotto riunisce in un unico posto configurazione del prodotto, mercato, prezzi e spedizione. Selezionando **Aggiungi prodotto al negozio** crei il prodotto e lo pubblichi nel mercato selezionato.
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Mercato di destinazione** | Scegli quale mercato vende questo prodotto. | Imposta la valuta dei tuoi prezzi. Parte dalla tua scelta in **Spedisci a**. **Aggiungi mercato** ne crea uno nuovo. |
| **Spese di spedizione del cliente** | Decidi quanto pagano i clienti per la consegna. | **Usa le tariffe di spedizione del negozio** applica al checkout le tariffe di spedizione del tuo mercato. |
| **Imposta il ricarico** | Calcola il prezzo di tutte le varianti con un unico ricarico. | Suggerisce un prezzo di vendita per ogni variante selezionata in base al costo del prodotto e al riferimento di spedizione del fornitore. |
| **Prezzi di vendita** | Imposta il prezzo di vendita di ogni variante. | Aggiorna il profitto e il margine stimati per quella variante. |
| Casella della variante | Scegli quali varianti vendere. | Aggiunge o rimuove la variante. La barra delle azioni mostra quante varianti sono selezionate. |
| **Metodo di spedizione di riferimento** | Stima il costo di spedizione del fornitore. | Aggiorna il dettaglio dei costi: **Costo del prodotto**, **+ Riferimento spedizione del fornitore**, **+ Profitto · margine**. |
| **Aggiungi prodotto al negozio** | Crea e pubblica il prodotto. | Importa le varianti selezionate e pubblica il prodotto nel mercato di destinazione. Mostra **Collega fornitore** se non sei collegato. |
### Configura dettagli e prezzi del prodotto
1. Scegli il **Mercato di destinazione**.
2. Seleziona solo le varianti che intendi vendere. Salta le varianti che mostrano **Esaurito**.
3. Scegli un **Metodo di spedizione di riferimento** per ogni variante e controlla i suoi **Tempi di consegna stimati**.
4. Inserisci un ricarico in **Imposta il ricarico** oppure digita un prezzo per ogni variante in **Prezzi di vendita**.
5. Controlla il dettaglio dei costi e il **Profitto medio stimato per unità**. Assicurati che ogni prezzo copra il costo del prodotto e la spedizione che pagherai al fornitore.
CJ indica i costi del fornitore in dollari statunitensi. Se il tuo mercato usa un'altra valuta, Runner mostra gli importi convertiti solo come riferimento.
### Scegli i mercati di destinazione
- Ogni importazione pubblica in un solo mercato alla volta. I prezzi vengono salvati nella valuta di quel mercato.
- Per vendere lo stesso prodotto in un altro mercato, torna al prodotto in Dropshipping, scegli l'altro **Mercato di destinazione**, inserisci i prezzi in quella valuta e seleziona di nuovo **Aggiungi prodotto al negozio**.
- Ogni variante del prodotto deve avere un prezzo nella valuta del mercato prima di poter essere pubblicata lì.
### Configura la spedizione
- I clienti pagano le **tariffe di spedizione del negozio** del loro mercato, non il costo di spedizione del fornitore. Includi la spedizione stimata del fornitore nel prezzo del prodotto o nella tariffa di spedizione.
- Il **Costo di spedizione** di un nuovo mercato è la tariffa che pagano i clienti. **Inserisci 0 per la spedizione gratuita.** Puoi modificare le opzioni di consegna in seguito in [Spedizione](./shipping).
- I costi del fornitore variano in base all'indirizzo di consegna. Al checkout, Runner ricontrolla connessione al fornitore, disponibilità, prezzo e spedizione per l'indirizzo del cliente. Se il fornitore non può più fornire l'articolo, il checkout si ferma invece di accettare un ordine che non puoi evadere.
### Pubblica e controlla il risultato
1. Seleziona **Aggiungi prodotto al negozio** dopo aver impostato varianti e prezzi.
2. Attendi **Pubblicato. Puoi selezionare un altro mercato in cui pubblicare questo prodotto.** Compare anche un messaggio **Modifiche salvate** con **Anteprima negozio**.
3. Apri **Prodotti** e controlla il prodotto, le varianti, i prezzi, le immagini e la descrizione. Lì puoi modificare titolo, descrizione e immagini.
4. Visualizza l'anteprima del negozio e verifica che il prodotto compaia nel mercato che hai scelto.
I prodotti in dropshipping non tracciano l'inventario in Runner; la disponibilità del fornitore viene controllata al checkout. Per questi prodotti, la colonna **Inventario** in Prodotti mostra un trattino.
Se vedi **Il risultato non è confermato. Riprova la stessa richiesta prima di modificare la selezione.**, seleziona di nuovo la stessa azione senza cambiare le tue scelte, poi controlla **Prodotti**.
I negozi meno recenti possono mostrare una pagina prodotto diversa con **Spedisci da**, **Spedisci a**, un elenco di metodi di spedizione e **Aggiungi al negozio**. Valgono le stesse regole: scegli un percorso e un preventivo, imposta un prezzo per ogni variante selezionata, poi aggiungi il prodotto.
## 4. Evadi gli ordini
Quando un cliente acquista un prodotto in dropshipping, l'evasione ha due parti. Runner effettua l'ordine al fornitore per te. **Poi devi confermarlo e pagarlo nel tuo account fornitore.** Il fornitore non spedisce finché non lo fai.
### Cosa fa Runner automaticamente
- Dopo il checkout, Runner crea un ordine al fornitore nel tuo account CJ o AliExpress collegato. Non devi fare clic su nulla in Runner per inviarlo.
- Un ordine del negozio può creare più ordini al fornitore, uno per ogni fornitore, magazzino o metodo di spedizione.
- Ogni ordine al fornitore compare nella sezione **Evasione dropshipping** dell'ordine del negozio con stato, **Metodo di spedizione**, **Magazzino**, **Articoli** e ora di **Ultimo aggiornamento**. I dati di tracciamento compaiono quando il fornitore spedisce.
- Se un ordine al fornitore non viene creato al primo tentativo, Runner continua a riprovare e nel frattempo mostra **Creazione in sospeso**.
- Runner aggiorna lo stato del fornitore quando apri l'ordine, quando selezioni **Aggiorna stato** e con un controllo giornaliero in background per gli ordini effettuati negli ultimi 90 giorni. Per gli ordini aperti più vecchi, seleziona **Aggiorna stato** o contatta l'assistenza.
Runner **non** paga il fornitore e **non** segna l'ordine del negozio come spedito al posto tuo.
### Evadi un ordine passo per passo
1. Apri **Operazioni del negozio → Ordini** e seleziona l'ordine.
2. Trova **Evasione dropshipping**. Attendi che l'ordine al fornitore mostri **Creato** o **Non pagato**. Se mostra ancora **Creazione in sospeso**, ricontrolla più tardi; Runner sta riprovando.
3. **Paga l'ordine al fornitore nel tuo account fornitore:**
- **CJ Dropshipping:** accedi a CJ, apri i tuoi ordini e trova l'ordine il cui numero contiene il numero d'ordine Runner (ad esempio, `…-1042-0` per l'ordine 1042). Conferma i dati di spedizione e pagalo con il saldo CJ o con il tuo metodo di pagamento.
- **AliExpress:** Runner mostra **Pagamento manuale richiesto** e gli **ID ordine fornitore AliExpress**. Accedi all'account acquirente AliExpress collegato e paga ogni ordine elencato.
4. Torna all'ordine in Runner e seleziona **Aggiorna stato**. Dopo il pagamento, lo stato passa a **In elaborazione**, poi a **Spedito** quando il fornitore lo spedisce.
5. Quando **ogni** ordine al fornitore in **Evasione dropshipping** mostra **Spedito**, seleziona **Segna come preparato** nell'ordine del negozio, poi **Segna come spedito**. Inserisci il **Corriere** e un **Numero di tracciamento** indicati nella sezione Evasione Dropshipping. In questo modo registri la spedizione nell'ordine del negozio che vede il cliente.
6. Quando ogni ordine al fornitore mostra **Consegnato**, seleziona **Segna come consegnato**.
**Segna come preparato** e **Segna come spedito** si applicano all'intero ordine del negozio, inclusi gli articoli che spedisci tu, e puoi segnare un ordine come spedito una sola volta. Se un ordine ha più ordini al fornitore, attendi che siano stati spediti tutti, poi invia direttamente al cliente gli altri numeri di tracciamento.
:::warning
Non effettuare di nuovo tu stesso lo stesso ordine in CJ o AliExpress. Runner l'ha già creato. Un secondo ordine significa che il fornitore spedisce, e ti addebita, due volte.
:::
### Stati degli ordini al fornitore
| Stato | Cosa significa | Cosa fare |
| --- | --- | --- |
| **Creazione in sospeso** | Runner sta ancora creando l'ordine al fornitore. | Attendi. Runner riprova automaticamente. **Aggiorna stato** non è ancora disponibile. |
| **Creato**, **Nel carrello**, **Non pagato** | Il fornitore ha l'ordine, ma non è pagato. | Pagalo nel tuo account CJ o AliExpress. |
| **In elaborazione**, **Altro** | Pagato; il fornitore lo sta preparando. Gli ordini AliExpress in questa fase mostrano **Altro**. | Attendi il tracciamento. Seleziona **Aggiorna stato** per controllare. Se un ordine AliExpress resta su **Altro**, aprilo nel tuo account AliExpress per verificare se richiede qualcosa, ad esempio un indirizzo completo. |
| **Spedito** | Il fornitore l'ha spedito. | Seleziona **Traccia ordine** per seguirlo. Quando tutti gli ordini al fornitore per l'ordine del negozio sono stati spediti, registra la spedizione con **Segna come spedito**. |
| **Consegnato** | Il fornitore segnala la consegna. | Seleziona **Segna come consegnato** nell'ordine del negozio. |
| **Annullamento in sospeso** | Runner ha chiesto al fornitore di annullarlo. | Attendi, poi seleziona **Aggiorna stato**. |
| **Annullata**, **Annullato** | L'ordine al fornitore non verrà spedito. | Verifica che anche l'ordine del negozio sia annullato o rimborsato. |
| **Fallito** | Runner non è riuscito a creare l'ordine al fornitore. | Cerca l'ordine nel tuo account fornitore. Se non c'è, contatta l'assistenza prima di effettuarlo manualmente. |
| **Revisione manuale necessaria** | Runner non è riuscito a confermare se il fornitore ha ricevuto l'ordine. | Non inviarlo di nuovo. Seleziona **Contatta l’assistenza** perché l'ordine possa essere riconciliato in sicurezza. |
### Annulla o rimborsa un ordine in dropshipping
Quando selezioni **Annulla ordine** in un ordine del negozio, Runner chiede automaticamente al fornitore di annullare i relativi ordini al fornitore. Non serve un passaggio separato in Runner.
- **CJ Dropshipping:** Runner invia l'annullamento a CJ finché l'ordine al fornitore non è stato spedito. È CJ a decidere se può ancora annullarlo.
- **AliExpress:** Runner può fermare l'ordine solo prima che venga creato in AliExpress; AliExpress non accetta annullamenti da Runner. Dopo quel momento, Runner mostra **Annullamento manuale richiesto** e **Non pagare. Annulla questi ID ordine fornitore nell'account acquirente AliExpress collegato.** Annulla quegli ordini nel tuo account AliExpress.
Dopo l'annullamento, apri l'ordine e controlla **Evasione dropshipping**. **Annullamento in sospeso** significa che Runner è in attesa del fornitore; **Annullata** significa che l'operazione è completata. Se lo stato non arriva ad **Annullata**, annulla l'ordine direttamente nel tuo account CJ o AliExpress e non pagarlo.
- **Un rimborso non annulla l'ordine al fornitore.** Se rimborsi un cliente senza annullare l'ordine, il fornitore può comunque spedirlo e addebitartelo.
- **Runner non rimborsa i costi del fornitore.** Se hai già pagato il fornitore, chiedi un rimborso a CJ o AliExpress.
## Disconnetti un fornitore
Disconnetti un fornitore solo quando smetti di usarlo o devi cambiare account fornitore. La disconnessione rimuove dall'organizzazione la tua chiave API CJ o l'accesso ad AliExpress. Riguarda tutti i negozi dell'area di lavoro.
:::warning
**Evadi e chiudi gli ordini in corso prima di disconnettere.** Dopo la disconnessione, Runner smette di aggiornare quegli ordini al fornitore: stato, tracciamento, **Aggiorna stato** e annullamento non funzionano più in Runner, e devi gestirli direttamente in CJ o AliExpress.
:::
### Prima di disconnettere
1. Apri **Operazioni del negozio → Ordini** e controlla ogni ordine con una sezione **Evasione dropshipping** per questo fornitore.
2. Paga ogni ordine al fornitore **Creato**, **Nel carrello** o **Non pagato**, oppure annullalo.
3. Attendi che gli ordini **Creazione in sospeso** e **In elaborazione** vengano creati, spediti o annullati.
4. Registra la spedizione in ogni ordine del negozio con **Segna come spedito** quando tutti i suoi ordini al fornitore sono stati spediti.
5. Imposta i prodotti di questo fornitore su **Bozza** in **Prodotti**, oppure eliminali. Dopo la disconnessione, i clienti non possono completare il checkout con questi prodotti.
### Disconnetti
1. Apri **Dropshipping** e seleziona **Gestisci fornitori**.
2. Seleziona **Disconnetti** per CJ Dropshipping o AliExpress.
3. Leggi **Disconnettere CJ Dropshipping?** o **Disconnettere AliExpress?**: **Non potrai aggiungere nuovi prodotti né ricevere aggiornamenti da questo fornitore. I prodotti e gli ordini già in Runner restano.**
4. Seleziona **Disconnetti** per confermare oppure **Annulla** per mantenere la connessione.
5. Verifica che il fornitore non risulti più collegato.
Se vedi **Non è stato possibile scollegare CJ: è ancora collegato. Riprova.** o **AliExpress è ancora collegato. La disconnessione non è andata a buon fine. Riprova.**, la connessione è ancora attiva. Riprova e non dare per scontato che sia stata rimossa.
### Cosa cambia dopo la disconnessione
| Area | Risultato |
| --- | --- |
| Prodotti | Restano in **Prodotti**, ma il checkout si blocca finché non ricolleghi il fornitore e, se necessario, non li importi di nuovo. |
| Nuovi ordini | I clienti non possono acquistare i prodotti di questo fornitore, quindi non vengono creati nuovi ordini al fornitore. |
| Ordini al fornitore esistenti | Restano nell'ordine, ma non vengono più aggiornati. Gestiscili in CJ o AliExpress. |
| Altro fornitore | Nessun effetto. Disconnettere CJ non disconnette AliExpress, né viceversa. |
## Risoluzione dei problemi
- **La ricerca o Aggiungi prodotto al negozio apre la finestra di connessione:** collega CJ o AliExpress. Le raccolte di anteprima non valgono come connessione.
- **Nessun risultato:** svuota la ricerca e i filtri, verifica **Spedisci a** o cambia fornitore.
- **Non riesci a selezionare un paese in Spedire a:** aggiungi un mercato per quel paese, poi sceglilo di nuovo.
- **Un ordine resta in Non pagato:** Runner non paga mai i fornitori. Paga l'ordine nel tuo account CJ o AliExpress.
- **Il cliente non ha ricevuto il tracciamento:** Runner non copia il tracciamento del fornitore nell'ordine del negozio. Usa **Segna come spedito** con il numero di tracciamento.
- **Aggiorna stato non riesce e mostra "Si è verificato un errore":** la connessione al fornitore potrebbe essere cambiata dopo l'ordine. Controlla **Gestisci fornitori**, poi gestisci l'ordine nel tuo account fornitore.
- **Il checkout si blocca per un prodotto in dropshipping:** connessione al fornitore, disponibilità, prezzo o spedizione sono cambiati. Ricollega il fornitore o importa di nuovo il prodotto.
- **Un prodotto mostra un risultato errato dopo Aggiungi prodotto al negozio:** controlla **Prodotti** prima di riprovare. Uno stato di caricamento non dimostra che l'importazione sia terminata.
- Per i messaggi di errore esatti, consulta il [playbook degli errori del catalogo Dropshipping](/it/guides/help-and-reference/error-playbook-store-and-apps/dropshipping-catalog-and-adding-products).
## Guide correlate
- [Ordini](./orders)
- [Prodotti](./products)
- [Spedizione](./shipping)
- [Inventario e varianti](./inventory-and-variants)
- [Collega CJ Dropshipping](/it/guides/apps-and-integrations/cj-dropshipping)
- [Panoramica di Operazioni del negozio](/it/guides/store-operations)
---
# Importa prodotti
Source: https://www.runnerai.com/docs/it/guides/store-operations/import-products
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Importa prodotti da un CSV preparato quando l'inserimento delle stesse informazioni di catalogo strutturate uno per uno sarebbe inefficiente.
## Perché e quando usare l'importazione
Usa Importa quando hai già dati di prodotto in un foglio di calcolo o in un altro sistema e puoi mapparli al modello CSV di Runner. Usa il modulo [Prodotti](./products) manuale per un catalogo piccolo o quando hai bisogno di imparare prima i campi.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Apri **Operazioni del negozio → Prodotti** in un negozio pronto.
- Completa la configurazione di pubblicazione/preparazione del negozio che crea il suo canale di catalogo della vetrina live; l'attività di importazione non può continuare senza quel canale.
- L'elenco di prodotti desktop popolato mostra **Importa**. In un catalogo vuoto, usa prima **Aggiungi primo prodotto**; la vista mobile enfatizza la creazione manuale.
- L'importazione accetta solo file CSV.
- Usa il modello corrente di Runner. Le colonne richieste sono `Product Handle` e `Product Title`; le righe di variante devono includere il `Variant SKU` richiesto e i valori delle opzioni mostrati dal modello.
- L'avvio di un'importazione modifica il catalogo del negozio. Rivedi il file prima di inviarlo.
## Apri Importa prodotti
**Percorso di accesso:** **Workspace → scegli un negozio → Operazioni del negozio → Prodotti → Importa**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRTPhrLOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
## Controlli principali
| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| **Importa** | Apri il flusso di lavoro di importazione in blocco | Apre la finestra di dialogo Importa prodotti senza avviare un'attività. |
| **Modello** | Inizia dalle colonne previste di Runner | Scarica il file `product-import-template.csv` corrente. |
| **Cronologia** | Controlla le attività di importazione precedenti | Passa a un elenco di file di importazione e i loro ultimi stati. |
| Area di caricamento | Scegli il CSV preparato | Legge il file localmente e lo mostra come pronto quando il contenuto è disponibile. |
| Controllo di rimozione file | Correggi una selezione errata | Cancella il file selezionato in modo da poterne scegliere un altro. |
| **Avvia l'importazione** | Invia il CSV selezionato | Avvia un'attività di importazione, quindi passa a Cronologia quando Runner l'accetta. |
| **Annulla** | Esci senza inviare | Chiude la finestra di dialogo e cancella il file selezionato. |
| **Aggiorna** in Cronologia | Richiedi lo stato dell'attività più recente | Ricarica la cronologia di importazione visibile. |
| **Torna a Importa** | Prepara un altro file | Ritorna da Cronologia alla vista di caricamento. |
| **Chiudi** | Esci da Cronologia | Chiude la finestra di dialogo senza modificare l'attività già inviata. |
## Prepara e invia un CSV
1. Seleziona **Importa**, quindi **Modello**.
2. Apri il CSV scaricato in un editor di fogli di calcolo che preserva la formattazione CSV.
3. Mantieni le intestazioni del modello. Completa `Product Handle` e `Product Title` per i prodotti, più il `Variant SKU` mostrato e i valori delle opzioni per le varianti.
4. Rivedi i handle dei prodotti, i titoli, i prezzi, le varianti e le righe ripetute prima di esportare come CSV.
5. Torna alla finestra di dialogo e scegli o trascina il CSV nell'area di caricamento.
6. Attendi che il file mostri **Pronto per l'importazione**.
7. Seleziona **Avvia l'importazione** una sola volta.
8. In **Cronologia**, segui il file inviato fino a quando non raggiunge uno stato terminale, quindi aggiorna l'elenco Prodotti e ispeziona le righe risultanti.
Per imparare senza modificare il catalogo, scarica **Modello**, controlla le intestazioni e apri **Cronologia**. Torna con **Torna all'importazione** e chiudi. Selezionare un file lo prepara; solo **Avvia l'importazione** invia una modifica del catalogo.
La registrazione esamina requisiti e Cronologia vuota, poi torna ai prodotti in bozza. Nessun CSV viene inviato o importato.
## Comprendi gli stati della cronologia
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| **In sospeso** | L'attività è in attesa di avvio | Lasciala in posizione e controlla di nuovo più tardi; non inviare immediatamente un duplicato. |
| **Elaborazione** | Runner sta elaborando il file | Mantieni la finestra di dialogo aperta o torna a Cronologia più tardi. |
| **Completato** | Runner ha finito di consegnare il file all'importatore di catalogo | L'elaborazione del prodotto può continuare dopo questo stato. Aggiorna Prodotti e ispeziona nomi, varianti, prezzi, stato e inventario. |
| **Non riuscito** | Runner non ha potuto completare l'attività di importazione | La scheda Cronologia corrente registra lo stato non riuscito ma non una causa dettagliata. Controlla i prerequisiti e il CSV di origine prima di inviare un nuovo file. |
| **Annullato** | L'attività non ha continuato | Conferma se sono stati creati prodotti prima di decidere cosa inviare dopo. |
La cronologia può anche mostrare la dimensione del file, il numero totale di righe e un ID transazione quando Runner ha questi valori. Questi dettagli identificano l'attività; non sostituiscono il controllo dei record del prodotto.
## Limiti e risoluzione dei problemi
- **Avvia l'importazione è disabilitato:** Seleziona un file `.csv` e attendi che Runner finisca di leggere il contenuto non vuoto.
- **Tipo di file non valido:** Esporta il foglio di calcolo come CSV; rinominare un altro formato di file non lo converte.
- **Errore di lettura file:** Riesporta il CSV, conferma che si apre normalmente sul tuo dispositivo e sceglilo di nuovo.
- **Importazione non riuscita:** Conferma che la configurazione di pubblicazione/preparazione del negozio ha creato il canale di catalogo della vetrina live, quindi usa il modello fornito, ripristina le colonne richieste e controlla i valori `Variant SKU` e delle opzioni della variante.
- **L'attività sembra bloccata:** Apri Cronologia e seleziona **Aggiorna**. In sospeso e Elaborazione non sono prova di completamento.
- **Righe di prodotto inaspettate appaiono:** Non ripetere ciecamente la stessa importazione. Confronta i handle CSV con l'elenco Prodotti e correggi i record deliberatamente.
## Guide correlate
- [Prodotti](./products)
- [Inventario e varianti](./inventory-and-variants)
- [Onboarding e Impostazioni generali](./onboarding-and-general-settings)
- [Panoramica di Operazioni del negozio](/it/guides/store-operations)
---
# Inventario e varianti
Source: https://www.runnerai.com/docs/it/guides/store-operations/inventory-and-variants
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa varianti e inventario per rappresentare le scelte che i clienti possono acquistare e la quantità che il negozio può vendere.
## Perché e quando usare varianti e inventario
Aggiungi varianti quando un prodotto ha scelte dei clienti come taglia o colore. Inserisci l'inventario quando Runner dovrebbe tracciare quante unità sono disponibili nell'ubicazione di stock del negozio.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Salva un'ubicazione di stock in **Operazioni del negozio → Generale** prima di inserire l'inventario tracciato.
- Salva il mercato e la valuta appropriati prima di impostare i prezzi.
- Apri un prodotto manuale. I prodotti di prenotazione e dropshipping possono utilizzare regole di disponibilità diverse e mostrare un trattino nell'elenco invece dei totali di inventario normali.
- Pianifica i nomi e i valori delle opzioni prima di modificare un prodotto live perché cambiarli può modificare l'insieme di varianti acquistabili.
## Apri varianti e inventario
**Percorso di accesso:** **Spazio di lavoro → scegli un negozio → Operazioni negozio → Prodotti → Aggiungi**, oppure scegli una riga esistente e trova **Variazione** e i campi prezzo e scorte.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzggCsEjzIC4NbwvYeKD2nM5xTZ76dBjp0auiyP)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Controlla prezzo e scorte di ogni variante prima di salvare. Per questo screenshot non sono stati salvati aggiornamenti.
## Controlli principali
| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| Controllo aggiunta opzione in **Variazione** | Aggiungi la prima scelta del cliente | Crea campi per nome dell'opzione e valori. |
| Controllo aggiunta valore | Aggiungi una scelta a un'opzione | Aggiunge un valore combinabile nelle varianti. |
| Un'altra opzione | Aggiungi una seconda dimensione, come il colore | Crea un altro gruppo ed espande le combinazioni. |
| **Rimuovi** | Rimuovi un'opzione o un valore | Rimuove quella scelta dal modulo e può modificare le combinazioni generate. |
| **Raggruppa per** | Organizza un lungo elenco di varianti | Su desktop, cambia il modo in cui le varianti correnti sono raggruppate per la modifica. |
| Prezzo variante | Imposta il prezzo di vendita per una scelta | Associa l'importo e la valuta inseriti a quella variante. |
| **Imposta prezzo di vendita** | Aggiungi un prezzo promozionale più basso | Apre i campi di prezzo di vendita e pianificazione facoltativa per l'articolo o la variante selezionata. |
| Quantità **Disponibile** | Imposta lo stock tracciato per una variante | Aggiorna la quantità di inventario non salvata mostrata per quella variante e ubicazione di stock. |
| **Salva** | Applica la configurazione completa del prodotto | Salva insieme le modifiche valide di opzione, variante, prezzo e inventario. |
## Crea varianti di prodotto
1. Apri Aggiungi prodotto o il prodotto esistente previsto.
2. In **Variazione**, seleziona il controllo per aggiungere un'opzione.
3. Inserisci un nome di opzione facile da usare, quindi aggiungi ogni valore di opzione valido.
4. Aggiungi un'altra opzione solo se il prodotto ha una seconda scelta indipendente.
5. Rivedi ogni variante generata. Rimuovi i valori accidentali prima di inserire prezzi o stock.
6. Imposta il prezzo corretto e la quantità disponibile per ogni variante.
7. Seleziona **Salva**, quindi riapri la riga e conferma il numero di varianti.
### Esempio: due formati di candela
Usa un'opzione `Size` con valori `Small` e `Large`. Sono previste due varianti. Imposta prezzo e scorte di ciascuna, poi **Salva** e riapri il prodotto.
| Opzioni inserite | Varianti da controllare |
| --- | --- |
| Formato: Piccolo, Grande | Piccolo; Grande — 2 varianti |
| Formato: Piccolo, Grande più Profumo: Cedro, Agrumi | Piccolo/Cedro; Piccolo/Agrumi; Grande/Cedro; Grande/Agrumi — 4 varianti |
Aggiungi la seconda opzione solo se vendi tutte e quattro le combinazioni. Controlla le scorte per variante anziché copiare il totale in ogni riga.
## Inserisci inventario
1. Conferma che il prodotto è un articolo manualmente stoccato e che un'ubicazione di stock è salvata.
2. Apri il prodotto e trova **Stock**.
3. Inserisci la quantità disponibile per ogni variante rilevante.
4. Rivedi il valore **Inventario totale presso ubicazione negozio**.
5. Seleziona **Salva**.
6. Torna a Prodotti e conferma che la colonna Inventario riflette il totale salvato.
## Stati e limiti
- Senza un'ubicazione di stock salvata, Runner mostra **Inventario non salvato** e impedisce al prodotto di affermare che lo stock era stato archiviato.
- I valori delle opzioni creano combinazioni. L'aggiunta di molti valori su più opzioni può produrre un lungo elenco di varianti che deve essere controllato individualmente.
- Un prezzo di vendita deve essere inferiore al prezzo regolare. I prodotti del fornitore possono applicare un prezzo minimo di vendita al dettaglio aggiuntivo.
- Una valuta del prodotto al di fuori delle aree salvate del negozio produce un avviso di mancata corrispondenza e impedisce ai prezzi di visualizzarsi correttamente sulla vetrina.
- La rimozione di un'opzione o di un valore modifica le scelte del cliente. Ispeziona le varianti risultanti prima di salvare.
- I prodotti di prenotazione e fornitore possono gestire la disponibilità al di fuori dei campi Stock normali.
## Risoluzione dei problemi
- **Inventario non salvato:** Aggiungi e salva un'ubicazione di stock in Generale, quindi reinserisci la quantità del prodotto.
- **Il numero di varianti è inaspettato:** Controlla i valori duplicati o vuoti e rivedi ogni combinazione di opzioni.
- **Un prezzo di vendita viene rifiutato:** Inserisci un valore inferiore al prezzo regolare e entro qualsiasi minimo del fornitore.
- **I prezzi non appaiono ai clienti:** Allinea la valuta del prodotto con un mercato salvato, quindi verifica la visibilità del prodotto e del negozio.
- **L'inventario mostra un trattino in Prodotti:** Controlla se l'articolo è un prodotto di prenotazione o dropshipping; questi tipi non utilizzano il totale di inventario standard in questo elenco.
## Guide correlate
- [Prodotti](./products)
- [Spedizione](./shipping)
- [Importa prodotti](./import-products)
- [Onboarding e Impostazioni generali](./onboarding-and-general-settings)
---
# Onboarding e impostazioni generali
Source: https://www.runnerai.com/docs/it/guides/store-operations/onboarding-and-general-settings
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Completa la configurazione guidata quando appare, quindi utilizza Impostazioni generali per mantenere accurati i dettagli operativi principali del negozio.
## Perché e quando utilizzare questa pagina
Usa le schede di configurazione quando Runner chiede per la prima volta dettagli, primo prodotto e spedizioni. Torna a Generali quando cambiano dettagli pubblici, regioni di vendita, valuta, sede inventario, spedizioni o disponibilità delle recensioni.
## Disponibilità e prerequisiti
- Apri un progetto Runner con un backend di negozio.
- Se il backend è ancora in fase di preparazione, Runner mostra **Attendere, l'amministratore del negozio sta distribuendo...**.
- L'assistente di configurazione appare solo per i negozi che non lo hanno completato e può variare man mano che Runner implementa l'onboarding aggiornato.
- La connessione dei pagamenti è un'attività separata in **App**. Completare la configurazione non abilita il checkout né pubblica la vetrina.
## Apri Impostazioni generali
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Operazioni del negozio → Generale**
Se Runner apre prima le schede di configurazione, completa i dettagli obbligatori e risolvi le altre fasi. Poi Generali diventa la destinazione normale.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il dettaglio mostra campi di esempio o predefiniti. Non conferma una configurazione salvata di Mercato, Sede inventario o spedizioni.
## Controlli principali
| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| **Configura** | Apre la fase dei dettagli del negozio | Apre il modulo obbligatorio dei dettagli. |
| **Aggiungi un prodotto** | Avvia la fase del primo prodotto | Apre la configurazione del prodotto. |
| **Salta la configurazione dei prodotti** / **Salta la configurazione della spedizione** | Rimanda una fase facoltativa | Risolve la scheda senza configurare la funzionalità saltata. |
| **Configura spedizioni** | Configura la relativa fase | Apre la configurazione delle spedizioni. |
| **Apri Operazioni del negozio** | Esce dalla configurazione completata | Apre l'amministrazione normale dopo la risoluzione di tutte le fasi. |
| **Visibile ai clienti** / **Nascondi il negozio: i visitatori vedono 'Prossimamente'.** | Cambia la visibilità in seguito in Impostazioni generali | Il **Salva** a livello di pagina memorizza lo stato visibile o nascosto selezionato. |
| **Aggiungi** in Mercati o Ubicazioni di magazzino | Aggiungi un'altra riga modificabile | Crea una riga di regione o ubicazione non salvata per te da completare. |
| Interruttore **Recensioni prodotto** | Consenti la funzionalità di revisione quando supportata | Salva questa impostazione immediatamente. Se la richiesta non riesce, l'interruttore torna al valore precedente; il **Salva** a livello di pagina non viene utilizzato per questo interruttore. |
| **Salva** | Applica le modifiche in Impostazioni generali | Diventa disponibile dopo le modifiche con ambito di pagina, le convalida quando selezionato e persiste le modifiche valide di visibilità, identità, mercato, ubicazione e spedizione. |
| **Configura** in un avviso di configurazione | Risolvi un prerequisito di checkout mancante | Si sposta nella sezione Impostazioni generali pertinente o apre la visualizzazione delle integrazioni di pagamento in **App**. |
Parti dai dettagli. **Salva e continua** invia i campi obbligatori; **Annulla** lascia la fase incompleta.
## Completa le tre fasi di configurazione
1. Apri **Operazioni negozio**. Un nuovo negozio mostra **Configura i dati del negozio**, **Aggiungi il primo prodotto** e **Impostazioni di base della spedizione** al posto del menu amministrativo.
2. In **Configura i dati del negozio**, seleziona **Configura**. Compila nome, contatti e indirizzo richiesti da **Completa i dati del tuo negozio**, poi **Salva e continua**. Questa fase obbligatoria non può essere saltata.
3. In **Aggiungi il primo prodotto**, seleziona **Aggiungi un prodotto** e completa la procedura. Scegli **Salta la configurazione dei prodotti** solo se vuoi aggiungere il catalogo in seguito.
4. In **Impostazioni di base della spedizione**, seleziona **Configura spedizioni** e compila i campi. Scegli **Salta la configurazione della spedizione** solo se configurerai la consegna dopo.
5. Attendi **Configurazione del negozio completata**, poi seleziona **Apri Operazioni del negozio**.
6. Controlla che il menu amministrativo sia disponibile. Se hai saltato prodotti o spedizioni, segui la guida corrispondente prima di considerare il negozio pronto a vendere.
Un link diretto a Prodotti non salta una configurazione incompleta. Se un negozio precedente mostra un assistente diverso, segui campi obbligatori e azioni Salta visibili; non cercare pagamenti o Vai online nelle tre schede precedenti.
La registrazione apre il modulo dei dettagli, poi lo chiude e torna alle schede. Mostra accesso e campi richiesti, non configurazione completata, pubblicazione o connessione di pagamento.
## Aggiorna le impostazioni generali in seguito
1. Apri **Operazioni del negozio → Generale**.
2. Scegli la visibilità del negozio desiderata.
3. Rivedi il nome del negozio, l'email di contatto e l'indirizzo aziendale.
4. Rivedi Mercati, inclusi i paesi di vendita, la valuta e l'impostazione fiscale.
5. Rivedi Ubicazioni di magazzino prima di configurare la spedizione o l'inventario.
6. Rivedi Spedizione, quindi seleziona **Salva** e attendi lo stato salvato per quelle impostazioni di pagina.
7. Chiudi e riapri Generali per verificare Mercato, Sede inventario e dettagli salvati.
8. Se necessario, modifica separatamente **Recensioni prodotto**, quando disponibile, e attendi l'aggiornamento immediato.
## Stati e limiti
- Il nome del negozio è obbligatorio e il modulo di configurazione lo limita a 30 caratteri.
- L'email di contatto deve essere un indirizzo email valido.
- La valuta del mercato influisce sulla visualizzazione del prezzo del prodotto. Un prodotto con una valuta al di fuori delle regioni salvate mostra un avviso e potrebbe non mostrare i prezzi sulla vetrina.
- **Visibile ai clienti** controlla la visibilità del negozio. La pubblicazione del codice della vetrina e il collegamento di un dominio sono attività separate.
- L'abilitazione delle recensioni non aggiunge componenti di revisione mancanti a una vetrina più vecchia. Runner può mostrare una guida per chiedere all'agente di aggiungere la funzionalità e pubblicare quelle modifiche della vetrina.
- Il **Salva** a livello di pagina copre visibilità, dettagli del negozio, Mercati, Ubicazioni di magazzino e Spedizione. L'interruttore **Recensioni prodotto** salva separatamente e immediatamente.
## Risoluzione dei problemi
- **Salva è disabilitato:** Apporta una modifica con ambito di pagina; la modifica solo di **Recensioni prodotto** non utilizza questo pulsante.
- **Salva segnala un errore:** Completa i campi denominati dal messaggio di convalida, quindi riprova.
- **Un avviso di configurazione rimane:** Completa il prerequisito denominato, salvalo, quindi aggiorna. Stock, spedizione e pagamento vengono controllati separatamente.
- **Il pagamento è ancora mancante dopo la connessione:** Torna dalla scheda del provider, attendi che Runner mostri l'integrazione come abilitata e aggiorna se necessario.
- **Le recensioni non appaiono nel menu:** L'interruttore, il supporto del backend o la funzionalità della vetrina potrebbero non essere pronti. Consulta la guida di revisione condizionale prima di provare un URL diretto.
- **La pagina avverte di modifiche non salvate:** Rimani e salva, oppure scegli esplicitamente di uscire senza salvare. La navigazione del browser da sola non applica le modifiche.
## Guide correlate
- [Spedizione](./shipping)
- [Prodotti](./products)
- [Recensioni](./reviews-and-advanced-admin)
- [Panoramica di Operazioni negozio](/it/guides/store-operations)
---
# Ordini
Source: https://www.runnerai.com/docs/it/guides/store-operations/orders
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza Ordini per seguire ogni acquisto dal posizionamento attraverso pagamento, adempimento, spedizione, consegna, rimborso o cancellazione.
## Perché e quando utilizzare Ordini
Apri un ordine quando hai bisogno di confermare cosa ha acquistato il cliente, controllare indirizzi e totali, comprendere l'avanzamento del pagamento o dell'adempimento, o eseguire un'azione successiva disponibile. I controlli visibili dipendono dall'ordine, dai servizi connessi e dalle azioni precedenti.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Gli ordini appaiono dopo che i clienti li effettuano. **Nessun ordine ancora ancora** è normale per un negozio nuovo.
- I controlli di pagamento richiedono uno stato di pagamento compatibile e un provider connesso.
- I controlli di adempimento richiedono articoli adempibili e possono dipendere da servizi di spedizione o fornitore.
- Le sezioni di prenotazione appaiono solo su ordini che includono articoli di prenotazione supportati.
- Lo stato di dropshipping, l'aggiornamento e il tracciamento appaiono solo quando l'ordine ha record di adempimento del fornitore collegati.
## Apri Ordini
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Operazioni negozio → Ordini**
Seleziona una riga di ordine per aprire il suo record completo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgw69RBMGkifVF80puGvTa1lBOo7ZUyg6Y4IEb)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Nessun ordine è uno stato iniziale normale. Le azioni condizionate seguenti richiedono un ordine reale; l'esempio non mostra rimborsi o evasioni.
## Controlli principali
| Controllo | Perché lo utilizzi | Cosa accade quando selezionato |
| --- | --- | --- |
| **Cerca ordini...** | Trova un ordine specifico | Filtra l'elenco utilizzando le informazioni sull'ordine o sul cliente inserite. |
| **Aggiorna** nell'elenco degli ordini | Richiedi i dati dell'ordine corrente | Ricarica l'elenco e i dati di stato di prenotazione o dropshipping disponibili. |
| Riga di ordine | Ispeziona un acquisto | Apre Riepilogo, cliente, indirizzo, articolo, pagamento, adempimento, attività e sezioni condizionali. |
| **Copia indirizzo** | Riutilizza un indirizzo visualizzato con precisione | Copia quell'indirizzo negli appunti. |
| **Cattura pagamento** | Cattura un pagamento autorizzato | Apre una conferma; la conferma chiede al servizio connesso di catturarlo. |
| **Rimborso** (finestra di dialogo: **Rimborso pagamento**) | Restituisci un importo idoneo | Apre i campi dell'importo del rimborso e della nota facoltativa; il successo aggiorna lo stato del pagamento. |
| **Contrassegna come adempito** | Adempì tutti gli articoli attualmente non adempiti | Invia immediatamente l'adempimento e aggiorna l'ordine dopo il successo. |
| **Contrassegna come spedito** | Registra l'avanzamento della spedizione | Richiede informazioni sul vettore e sul tracciamento facoltativo, quindi aggiorna l'adempimento dopo il successo. |
| **Contrassegna come consegnato** | Registra il completamento della consegna | Conferma l'adempimento idoneo come consegnato dopo il successo. |
| **Annulla adempimento** | Interrompi un adempimento idoneo | Apre una conferma e aggiorna quell'adempimento se la richiesta ha successo. |
| **Annulla ordine** | Annulla permanentemente un ordine idoneo | Su desktop, apre una conferma irreversibile; tutti gli adempimenti devono essere annullati per primi. |
| **Aggiorna stato** | Controlla un ordine di dropshipping collegato | Richiede lo stato del fornitore più recente per quel record. |
| **Traccia ordine** | Apri il tracciamento del fornitore disponibile | Apre il tracciamento solo quando è presente una destinazione di tracciamento utilizzabile. |
| Azioni di prenotazione | Aggiorna una prenotazione confermata supportata | **Contrassegna come completato** o **Contrassegna come non presentato** appare solo per uno stato di prenotazione idoneo. |
## Rivedi un ordine in sicurezza
1. Cerca l'ordine o selezionalo dall'elenco.
2. Conferma l'ID di visualizzazione, la data, il cliente, gli articoli, i totali, l'indirizzo di spedizione e l'indirizzo di fatturazione.
3. Leggi Pagamento e Adempimento come stati separati; uno può progredire senza l'altro.
4. Rivedi Attività per le modifiche precedenti.
5. Se è presente una sezione di prenotazione o dropshipping, rivedi il suo stato e i dettagli separati.
6. Quando un'altra persona o un servizio esterno potrebbe aver modificato l'ordine, torna all'elenco, seleziona **Aggiorna** e riapri il record prima di agire.
In un nuovo negozio con **Nessun ordine ancora**, svuota la ricerca e seleziona **Aggiorna** per confermare l'elenco vuoto. Puoi imparare a navigare senza creare un acquisto. Le azioni seguenti richiedono un ordine esistente e stati idonei di pagamento ed evasione.
## Esegui un'azione che cambia lo stato
1. Scegli solo un'azione mostrata per lo stato attuale. **Contrassegna come adempito** si applica immediatamente a tutti gli articoli non adempiti; altre azioni possono aprire una conferma o campi obbligatori.
2. Quando appare una finestra di dialogo, verifica l'ordine, le quantità di articoli, l'importo, il vettore o le informazioni di tracciamento che mostra.
3. Invia o conferma una volta.
4. Attendi il messaggio di successo e lo stato aggiornato.
5. Aggiorna prima di riprovare. Un timeout o un indicatore di caricamento non è la prova che la prima richiesta non è riuscita.
## Comprendi gli stati comuni
| Area | Stati di esempio | Come leggerli |
| --- | --- | --- |
| Pagamento | In attesa di pagamento, Autorizzato, Pagato, Pagato parzialmente, Rimborsato, Rimborsato parzialmente, Annullato, Richiede azione | Descrive il movimento del denaro, non l'avanzamento della spedizione. |
| Adempimento | Non adempito, Parzialmente adempito, Adempito, Spedito, Parzialmente spedito, Consegnato, Parzialmente consegnato, Annullato | Descrive la preparazione e la consegna, non se il pagamento è stato regolato. |
| Prenotazione | Confermato, Completato, Non presentato, Annullato | Appare solo per articoli di prenotazione supportati. |
| Dropshipping | Creazione in sospeso, Creato, In elaborazione, Spedito, Consegnato, Non riuscito, Annullato o altri stati del fornitore | Proviene da un record del fornitore collegato e potrebbe aggiornarsi separatamente dall'ordine del negozio. |
## Limiti e risoluzione dei problemi
- **Un'azione è mancante:** Lo stato dell'ordine, il tipo di articolo, il provider o il tuo accesso attualmente non lo consente. Non utilizzare un URL diretto per aggirare il controllo mancante.
- **Annulla ordine non è disponibile:** Questo controllo è solo per desktop e richiede che ogni adempimento sia annullato per primo.
- **Un rimborso articolo non è disponibile:** Utilizza solo il metodo di rimborso che Runner espone per l'ordine corrente; non assumere che ogni articolo supporti il rimborso diretto.
- **Lo stato non è cambiato:** Attendi la conferma, torna all'elenco degli ordini, seleziona **Aggiorna**, riapri il record e controlla Attività prima di riprovare.
- **Dropshipping dice Non riuscito o non ha ordine:** Rivedi i dettagli del fornitore collegato e la connessione prima di modificare l'ordine del negozio.
- **Ordine non trovato:** Cancella la ricerca, verifica il progetto e controlla l'identificatore dell'ordine.
## Guide correlate
- [Clienti](./customers)
- [Spedizione](./shipping)
- [Dropshipping](./dropshipping)
- [Panoramica di Operazioni negozio](/it/guides/store-operations)
---
# Stampa su richiesta con Printful
Source: https://www.runnerai.com/docs/it/guides/store-operations/print-on-demand
Usa Stampa su richiesta per vendere prodotti personalizzati, come t-shirt, felpe con cappuccio, tazze e poster, senza tenere scorte. Crei il design su un prodotto base Printful in Runner e lo pubblichi nel negozio. Printful stampa e spedisce ogni ordine dopo che lo hai confermato in Printful.
## Come funziona
1. **Collega Printful.** Autorizza una sola volta il tuo account Printful per la tua organizzazione.
2. **Scegli un prodotto base e crea il design.** Scegli un prodotto, i colori, le taglie e la tecnica di stampa, poi aggiungi la grafica.
3. **Controlla e pubblica.** Scegli i mockup, scrivi la scheda prodotto, imposta prezzi, mercati e spedizione, poi pubblica.
4. **Evadi gli ordini.** Ogni ordine pagato crea una bozza di ordine in Printful. Per avviare la produzione, confermi la bozza in Printful.
Se in seguito devi smettere di usare Printful, consulta [Disconnetti Printful](#disconnetti-printful).
## Prima di iniziare
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Stampa su richiesta**
**Stampa su richiesta** compare nel gruppo **Crea** della navigazione del progetto, accanto a **Operazioni del negozio** e **Dropshipping**. Se non la vedi, la funzionalità non è ancora abilitata per il tuo account. Contatta l'[assistenza Runner](/it/guides/help-and-reference/support-and-community) per richiedere l'accesso.
Ti servono:
- un progetto Runner con un negozio;
- un account [Printful](https://www.printful.com) con la fatturazione configurata, perché Printful addebita sul tuo account Printful ogni ordine che confermi;
- il ruolo di **amministratore** o **proprietario** nell'organizzazione Runner per collegare o disconnettere Printful;
- almeno un mercato e una valuta del negozio in **Operazioni del negozio → Generale**; e
- un'ubicazione di stock e una configurazione di spedizione prima di pubblicare. Consulta [Spedizione](/it/guides/store-operations/shipping).
## 1. Collega Printful
Puoi esplorare il catalogo prima di collegarti. Finché Printful non è collegato, la pagina mostra **Modalità anteprima**. Devi collegare Printful prima di poter progettare, salvare o pubblicare.
1. Apri **Stampa su richiesta**.
2. Seleziona **Collega Printful**. Puoi anche aprire un prodotto base e selezionare **Collega il tuo account Printful**.
3. Accedi a Printful se richiesto e controlla le autorizzazioni che Runner richiede.
4. Nel selettore dei negozi di Printful, scegli il negozio che Runner deve usare. Il selettore propone per impostazione predefinita di creare un nuovo negozio Printful (**Create a new Printful store**); cambialo se vuoi usare un negozio esistente.
5. Approva l'accesso. Printful ti riporta a **Stampa su richiesta** e la pagina mostra **Collegato**.
Il collegamento appartiene alla tua **organizzazione** Runner, quindi tutti i negozi di quell'organizzazione usano lo stesso negozio Printful. Un'organizzazione può avere un solo collegamento Printful e un negozio Printful può essere collegato a una sola organizzazione Runner.
Per controllare quale negozio Printful è collegato, apri il menu **Gestisci negozio** e scegli **Gestisci connessione**. La finestra mostra il nome del negozio collegato e l'ID del negozio Printful.
### Ricollega Printful
Se Printful non accetta più l'autorizzazione di Runner, Runner mostra **Ricollega Printful per continuare a elaborare gli ordini**. Di solito significa che il negozio è stato eliminato in Printful o che l'app Runner è stata disinstallata da quel negozio. Seleziona **Ricollega Printful** e scegli **lo stesso negozio Printful** nel selettore dei negozi di Printful. Runner rifiuta un nuovo collegamento a un negozio diverso finché il collegamento è ancora attivo.
## 2. Scegli un prodotto base e inizia a progettare
### Scegli un prodotto base
1. Esplora **Tutti i prodotti base**, filtra per **Tipi di prodotto** oppure cerca per prodotto, brand, metodo di stampa o SKU.
2. Apri un prodotto per vedere immagini, colori disponibili, taglie, posizionamenti di stampa, tecniche, costo base, spedizione stimata e tempi di consegna stimati per i tuoi mercati.
3. Scegli una **Tecnica**: **Stampa** o **Ricamo**, quando sono disponibili entrambe. In **Stampa**, scegli il **Tipo di stampa** che Printful offre per quel prodotto, come DTG, DTF, sublimazione o stampa all-over.
4. Scegli uno o più **colori** e **taglie**. Puoi selezionare fino a **20 varianti** (combinazioni di colore e taglia) per un prodotto.
5. Usa il cursore **Ricarico** per vedere in anteprima il prezzo di vendita e il profitto. Il prezzo parte da quello suggerito, un margine del 35% sopra il punto di pareggio: il costo base di Printful più la spedizione stimata. Il profitto è il prezzo meno entrambi e compare quando arriva la stima di spedizione. Puoi modificare di nuovo i prezzi durante la revisione.
6. Seleziona **Inizia a progettare**. L'editor si apre con le opzioni scelte.
Se Runner modifica la tua selezione, ad esempio con "La taglia è stata cambiata per adattarsi a questo colore.", Printful non offre esattamente quella combinazione. Controlla le opzioni modificate prima di continuare.
### Aggiungi il tuo design
Ogni posizionamento di stampa, come fronte, retro o manica, ha una propria scheda nell'editor. Aggiungi la grafica a ogni posizionamento che vuoi stampare.
| Origine del design | Cosa fa |
| --- | --- |
| **Carica un file** | Carica file JPEG, PNG, WebP o SVG fino a 18 MB. I file SVG vengono convertiti in PNG. Sono consigliati 300 DPI. |
| **Dalla galleria multimediale** | Riusa immagini che hai già creato o caricato in Runner. |
| **Progetta con Runner AI** | Descrivi la tua idea. **Crea immagine** crea una nuova grafica; **Modifica grafica attuale** modifica la grafica già presente sul prodotto. |
| **Ispirazioni → Testo** | Scegli uno stile di lettering, come College grassetto, Serif classico o Corsivo leggero. Runner AI trasforma le tue parole in una grafica di testo pronta per la stampa. |
| **Ispirazioni → Etichette e badge** | Scegli una forma, come Distintivo circolare, Stemma a scudo o Etichetta biglietto. Runner AI crea il badge con il tuo testo. |
| **Ispirazioni → Arte** | Inserisci direttamente sul prodotto un'opera selezionata e di libero utilizzo (CC0) dell'Art Institute of Chicago. |
Seleziona un livello di grafica per modificarlo nel pannello di ispezione:
- sposta, ridimensiona, ruota e modifica l'opacità;
- usa **Ritaglio** per ritagliare la grafica senza modificare l'immagine originale;
- usa **Rimuovi sfondo** per stampare solo il tuo design;
- usa **Ripeti motivo** con un layout a blocchi, a mattone o a mezzo scarto, con spaziatura e sfalsamento regolabili;
- **Duplica**, **Blocca** e riordina i livelli; e
- usa **Annulla** e **Ripeti** sulle modifiche.
### Controlla la qualità di stampa
Prima di salvare, controlla gli indicatori di qualità di ogni livello:
- **Qualità di stampa** confronta la risoluzione della grafica alle dimensioni attuali con i DPI richiesti da Printful. Se indica che la grafica verrà stampata sfocata, riducila o carica un file più nitido.
- Gli avvisi su **area di stampa** e **area sicura** indicano che parte della grafica potrebbe essere tagliata o rifilata. Sposta o ridimensiona la grafica finché non si trova all'interno di entrambe.
### Salva il design
L'editor non salva automaticamente. Quando hai finito, seleziona **Salva design**. Lo stato mostra **Modifiche non salvate** finché non salvi. Se esci con modifiche non salvate, Runner ti chiede se salvarle o annullarle.
I design salvati compaiono in **Design salvati** nella pagina Stampa su richiesta. Aprine uno per continuare a modificarlo o per trasformarlo in un prodotto. L'eliminazione di un design salvato non elimina le immagini dalla tua libreria multimediale.
## 3. Controlla e pubblica il prodotto
Quando il design è pronto, seleziona **Pubblica** nell'editor. Runner salva il design e apre **Pubblica prodotto**.
### Configura il prodotto
| Sezione | Cosa fare |
| --- | --- |
| **Mockup del prodotto** | Seleziona **Genera mockup** per creare foto del tuo design sul prodotto. Seleziona almeno un mockup e fino a otto. Trascinali per riordinarli; la prima immagine è quella della scheda prodotto. |
| **Dettagli** | Controlla il **Titolo del prodotto** e la **Descrizione del prodotto** preparati da Runner. Usa **Crea con l’IA** per una nuova descrizione, poi controlla ogni parola. |
| **Mercati** | Seleziona **Scegli i mercati** per indicare i paesi e le valute in cui vendi questo prodotto. Sono elencati solo i mercati in cui Printful può spedire. Scegli almeno un mercato. |
| **Prezzi** | Ogni variante parte dal prezzo suggerito, un margine del 35% sopra il suo punto di pareggio: il costo base di Printful più la spedizione che paghi tu. Usa **Ricarico** per impostare un ricarico diverso sul punto di pareggio, oppure inserisci un prezzo per ogni variante. I guadagni sono il prezzo meno il costo base di Printful e la spedizione che paghi; un prezzo sotto il punto di pareggio compare come perdita. Per ogni mercato la tabella mostra prezzo di vendita, spedizione, tasse e guadagni stimati della variante che rende meno. |
| **Spese di spedizione a carico del cliente** | Scegli **Usa le tariffe di spedizione del negozio** perché gli acquirenti paghino le tariffe di spedizione del tuo negozio, oppure **Applica le tariffe di spedizione di Printful** perché paghino al checkout la tariffa calcolata da Printful per il loro indirizzo. |
La stima di spedizione in questa pagina è un riferimento per i prezzi: la tariffa standard più economica di Printful, non quella express o prioritaria. Il costo di spedizione effettivo di Printful dipende dall'indirizzo di consegna di ogni cliente. Con **Usa le tariffe di spedizione del negozio** gli acquirenti pagano le tariffe del tuo negozio e Printful addebita a te la spedizione, quindi la stima rientra nel punto di pareggio, nel prezzo suggerito e nei tuoi guadagni. Con **Applica le tariffe di spedizione di Printful** gli acquirenti pagano la tariffa di Printful al checkout, quindi conta solo il costo base di Printful.
Questo prodotto è evaso da Printful, quindi si applica la politica di reso di Printful. Consultala dal link nella pagina di revisione.
### Crea la bozza
1. Seleziona **Crea prodotto**.
2. Attendi mentre Runner prepara i file di produzione e crea il prodotto. Puoi controllare lo stato in qualsiasi momento.
3. Quando vedi **Il tuo prodotto ora è una bozza nel negozio. Pubblicalo quando vuoi iniziare a vendere.**, seleziona **Visualizza prodotto**.
Il prodotto ora è una **Bozza** in **Prodotti**. Gli acquirenti non possono ancora vederlo. Puoi modificarne l'URL e l'anteprima nei motori di ricerca in Prodotti.
### Pubblica
1. Apri la bozza del prodotto in **Prodotti**.
2. Controlla **Spedizione al checkout** e assicurati che sia selezionata una modalità di spedizione.
3. Seleziona **Pubblica prodotto**.
4. Attendi **Sincronizzato con Printful.** Il prodotto ora è online nel tuo negozio e sincronizzato con il tuo negozio Printful.
Per pubblicare, il negozio ha bisogno di un collegamento Printful attivo, di un'ubicazione di stock, di un'opzione di spedizione e di una modalità di spedizione per il prodotto. Se manca qualcosa, Runner indica cosa correggere prima di riprovare.
Quando un design diventa un prodotto, resta legato a quel prodotto. Se lo modifichi di nuovo, Runner crea una copia, e il salvataggio della copia non modifica il prodotto esistente.
## 4. Evadi gli ordini
Runner **non** invia automaticamente gli ordini in produzione. Ogni ordine pagato crea una **bozza di ordine** nel tuo negozio Printful, che devi confermare in Printful per avviare la produzione.
1. Un acquirente paga un ordine che contiene un prodotto con stampa su richiesta.
2. Runner crea una bozza di ordine corrispondente nel tuo negozio Printful. Questo avviene automaticamente per gli ordini con pagamento acquisito.
3. Apri **Operazioni del negozio → Ordini** e seleziona l'ordine. La sezione **Gestione Printful** mostra lo stato della bozza e il costo di produzione Printful, una volta che Printful lo ha calcolato.
4. Quando lo stato è **Bozza pronta**, seleziona **Effettua l’ordine in Printful**. Printful apre l'ordine in una nuova scheda.
5. Controlla l'ordine in Printful e confermalo. Printful addebita l'importo sul tuo account Printful e avvia la produzione.
6. Torna all'ordine in Runner e seleziona **Aggiorna stato**. Runner aggiorna lo stato anche automaticamente quando Printful invia aggiornamenti.
| Stato | Significato |
| --- | --- |
| **Preparazione bozza** | Runner sta creando la bozza in Printful. |
| **Bozza pronta** | La bozza è in Printful e attende che tu la confermi lì. |
| **Inviato** / **In produzione** | Hai confermato l'ordine e Printful lo sta producendo. |
| **Completato parzialmente** / **Completato** | Printful ha spedito alcuni o tutti gli articoli. |
| **Azione richiesta** | Printful ha bisogno di un aggiornamento prima di poter continuare. Apri l'ordine in Printful. |
| **Richiede attenzione** | Runner non è riuscito a confermare lo stato di evasione. Aggiorna lo stato o contatta l'assistenza. |
| **Annullato** / **Eliminato** | L'ordine Printful è stato annullato oppure la bozza è stata eliminata. |
Tieni presenti queste regole:
- **Conferma solo gli ordini che intendi evadere.** La conferma in Printful avvia una produzione irreversibile e addebita l'importo sul tuo account Printful.
- **Rimborsi e annullamenti non modificano la bozza Printful.** Se rimborsi o annulli l'ordine di un cliente, elimina o annulla tu stesso la bozza in Printful e non confermarla.
- **L'eliminazione di una bozza Printful non annulla né rimborsa l'ordine del cliente.** Gestisci l'ordine del cliente separatamente in Runner.
- Se Runner mostra **Riprova bozza**, Printful non ha creato la bozza e puoi riprovare in sicurezza.
- Se Runner indica che Printful ha creato l'ordine ma Runner non è riuscito a leggerlo, **non inviarlo di nuovo**. Runner lo riconcilia automaticamente, quindi ricontrolla più tardi.
## Disconnetti Printful
La disconnessione impedisce subito a Runner di usare il tuo negozio Printful. **Completa o chiudi tutti gli ordini in corso prima di disconnettere.** Gli ordini non completati vengono disattivati in Runner e non vengono ritentati, anche se in seguito colleghi un altro negozio Printful.
### Prima di disconnettere
1. In **Operazioni del negozio → Ordini**, trova ogni ordine con una sezione **Gestione Printful** che non sia **Completato**, **Annullato** o **Eliminato**.
2. Per ogni ordine in stato **Bozza pronta**, confermalo in Printful oppure annulla e rimborsa l'ordine del cliente in Runner ed elimina la bozza Printful.
3. Attendi che gli ordini confermati mostrino **Completato**, oppure continua a seguirli direttamente in Printful.
4. Annulla la pubblicazione o rimuovi i prodotti con stampa su richiesta che non vuoi più mostrare agli acquirenti.
### Disconnetti
1. Apri **Stampa su richiesta**.
2. Apri il menu **Gestisci negozio** e scegli **Gestisci connessione**.
3. Seleziona **Disconnetti**.
4. Leggi le conseguenze, poi seleziona **Disconnetti Printful**.
Dopo la disconnessione:
- i tuoi prodotti e le bozze con stampa su richiesta restano visibili in **Prodotti**, ma gli acquirenti non possono aggiungerli al carrello né completare il checkout;
- quei prodotti mostrano **Questo prodotto POD non è disponibile** e non possono essere venduti né modificati tramite Printful;
- le evasioni Printful in corso vengono disattivate in Runner; e
- il tuo negozio Printful e i relativi ordini restano nel tuo account Printful.
**Un nuovo collegamento non ripristina i prodotti.** Se in seguito colleghi di nuovo Printful, i prodotti del collegamento precedente restano non disponibili. Crea nuovi prodotti dai tuoi design salvati.
## Limiti
| Elemento | Limite |
| --- | --- |
| Varianti per prodotto | 1–20 combinazioni di colore e taglia |
| Immagini della scheda per prodotto | Fino a 8 mockup |
| Mercati per prodotto | Fino a 51 |
| Ricarico | 0–500% |
| Titolo del prodotto | Fino a 255 caratteri |
| Dimensione del file caricato | 18 MB (JPEG, PNG, WebP o SVG) |
| Collegamenti Printful | Uno per organizzazione |
Il tuo piano può anche limitare il numero di prodotti che puoi creare. Se raggiungi il limite, Runner mostra **Hai raggiunto il limite di prodotti print-on-demand del tuo piano. Esegui l’upgrade per aggiungerne altri.**
## Risoluzione dei problemi
- **Stampa su richiesta non compare nella navigazione:** la funzionalità non è abilitata per il tuo account. Contatta l'assistenza.
- **Collega Printful non riesce o non hai l'autorizzazione per collegarti:** chiedi a un amministratore o proprietario dell'organizzazione di collegare Printful.
- **La consegna degli eventi Printful attende la configurazione di Runner:** Runner deve completare una configurazione una tantum. Non devi modificare nulla nel tuo negozio.
- **Un mockup, un prezzo o una stima di spedizione non si carica:** riprova dalla stessa pagina. Il design salvato non viene modificato.
Per i messaggi di errore esatti e i passaggi di ripristino, consulta:
- [Printful connection and catalog](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-connection-and-catalog) (in inglese)
- [Printful design conflicts and unavailable artwork](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-design-conflicts-and-unavailable-artwork) (in inglese)
- [Printful product review, mockups, and publication](/en/guides/help-and-reference/error-playbook-store-and-apps/printful-product-review-mockups-and-publication) (in inglese)
- [Orders and fulfillment errors](/en/guides/help-and-reference/error-playbook-store-and-apps/orders-and-fulfillment) (in inglese)
## Guide correlate
- [Operazioni del negozio](/it/guides/store-operations)
- [Prodotti](/it/guides/store-operations/products)
- [Ordini](/it/guides/store-operations/orders)
- [Spedizione](/it/guides/store-operations/shipping)
- [Dropshipping](/it/guides/store-operations/dropshipping)
---
# Prodotti
Source: https://www.runnerai.com/docs/it/guides/store-operations/products
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza Prodotti per trasformare un articolo in un elenco di negozio completo con informazioni rivolte ai clienti, prezzi, media e stato.
## Perché e quando utilizzare Prodotti
Crea un prodotto quando desideri vendere un articolo direttamente, quindi torna per regolare il suo nome, descrizione, categoria, immagini, prezzi, varianti, inventario, elenco di ricerca o stato Bozza/Pubblicato.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Apri un progetto Runner con un backend di negozio pronto.
- Salva almeno un Mercato in modo che la valuta del prodotto possa corrispondere a una regione di vendita.
- Salva un'Ubicazione di magazzino prima di aspettarti che le modifiche dell'inventario vengano archiviate.
- **Importa** appare nell'elenco desktop popolato; un catalogo nuovo vuoto inizia con **Aggiungi primo prodotto**.
- I prodotti di dropshipping possono mostrare un comportamento di costo e inventario diverso dai prodotti gestiti manualmente.
## Apri Prodotti
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Operazioni del negozio → Prodotti**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgX7xafZQoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Le righe in bozza mostrano record modificabili del catalogo. Non dimostrano che gli articoli siano pubblicati o acquistabili.
## Controlli principali
| Controllo | Perché lo utilizzi | Cosa accade quando selezionato |
| --- | --- | --- |
| **Aggiorna** | Ricarica i dati del catalogo corrente | Recupera i prodotti e le informazioni di mercato; non crea o pubblica nulla. |
| **Aggiungi** / **Aggiungi primo prodotto** | Crea un prodotto manuale | Apre un modulo Aggiungi prodotto vuoto. |
| **Importa** | Aggiungi prodotti da un CSV supportato | Apre la finestra di dialogo di importazione con Modello e Cronologia. |
| Riga di prodotto | Rivedi o modifica un articolo | Apre Modifica prodotto per quel prodotto. |
| Icona matita | Modifica un prodotto senza selezionare la sua riga | Apre lo stesso modulo Modifica prodotto. |
| Icona elimina | Rimuovi un prodotto | Apre una conferma distruttiva; la conferma rimuove il prodotto e non può essere assunta reversibile. |
| **Bozza** | Mantieni l'elenco fuori dal catalogo pubblicato | Salva il prodotto con lo stato Bozza. |
| **Pubblicato** | Rendi l'elenco idoneo a comparire nel catalogo | Salva lo stato Pubblicato; la visibilità effettiva della vetrina dipende ancora dallo stato del negozio e della vetrina. |
| **Salva** | Archivia le modifiche valide del prodotto | Salva il prodotto e torna all'elenco aggiornato dopo il successo. |
| **Annulla** o controllo indietro | Esci dal modulo | Torna verso l'elenco; le modifiche del modulo non salvate non vengono applicate. |
## Crea un prodotto
1. Seleziona **Aggiungi** o **Aggiungi primo prodotto**.
2. Scegli una Categoria di prodotto e inserisci un Nome e una Descrizione chiari.
3. Aggiungi immagini e scegli la miniatura desiderata.
4. Scegli **Bozza** mentre prepari l'elenco o **Pubblicato** quando è pronto per il catalogo.
5. Inserisci il Prezzo regolare. Aggiungi un Prezzo di vendita inferiore e date di inizio/fine valide solo quando desideri una vendita programmata.
6. Configura [varianti e inventario](./inventory-and-variants) se l'articolo ha opzioni o stock tracciato.
7. Rivedi il titolo della pagina SEO, la meta descrizione, l'handle e l'URL del negozio visualizzato.
8. Seleziona **Salva** e attendi che l'elenco Prodotti ritorni con la riga aggiornata.
### Esercitati con una bozza
Per una candela inserita manualmente, usa un nome chiaro come `Cedar Candle`, aggiungi la descrizione reale e mantieni **Bozza**. Usa un prezzo nella valuta del Mercato salvato. Se Runner chiede prima il tipo, scegli il prodotto manuale prima di inserire questi dati.
Dopo **Salva**, riapri la riga e confronta nome, prezzo e stato Bozza con i dati inseriti. Questo verifica il salvataggio del catalogo; pubblicazione e checkout richiedono controlli separati.
## Modifica o rimuovi un prodotto
1. Seleziona la riga o l'icona della matita. **Modifica prodotto** mostra il Tipo prodotto esistente in sola lettura.
2. Modifica solo i campi che dovrebbero influire sull'elenco.
3. Seleziona **Salva** e conferma che la riga riflette il nuovo stato o le nuove informazioni.
4. Per rimuovere il prodotto, torna all'elenco e seleziona la sua icona di eliminazione.
5. Leggi il nome del prodotto nella conferma. Continua solo se l'eliminazione permanente è intenzionale.
## Stati e limiti
- I badge **Bozza** e **Live** nell'elenco riassumono lo stato del prodotto. Il modulo utilizza **Bozza** e **Pubblicato**.
- Un avviso di mancata corrispondenza di valuta significa che la valuta del prodotto è al di fuori delle regioni salvate del negozio; i suoi prezzi non verranno visualizzati sulla vetrina fino a quando non vengono corretti.
- Il Prezzo di vendita deve essere inferiore al Prezzo regolare. Gli articoli del fornitore possono anche applicare un prezzo minimo consigliato.
- Le immagini accettano solo i formati e le dimensioni mostrati dal modulo. La compressione o il caricamento non riuscito lascia l'immagine del prodotto invariata.
- Le righe di prenotazione e dropshipping possono mostrare un trattino invece dei totali di inventario o variante normali.
- Il salvataggio dello stato Pubblicato non è lo stesso che pubblicare o distribuire la vetrina.
## Risoluzione dei problemi
- **Inventario non salvato:** Aggiungi e salva un'Ubicazione di magazzino, quindi riapri il prodotto e inserisci di nuovo lo stock.
- **Il prezzo non viene visualizzato:** Fai corrispondere la valuta del prodotto a una regione di Mercato salvata.
- **Salva rimane disabilitato o non riesce:** Apporta una modifica, quindi completa il Nome e lo stato obbligatori e correggi qualsiasi errore inline. Aggiungi una categoria e un prezzo adatti prima di aspettarti un elenco completo rivolto ai clienti, ma non sono prerequisiti per abilitare **Salva**.
- **Il caricamento dell'immagine non riesce:** Utilizza JPEG, PNG, GIF o WebP entro la dimensione mostrata nel suggerimento dell'immagine, quindi riprova.
- **Il prodotto manca dalla vetrina:** Controlla lo stato Pubblicato, la visibilità del negozio, la pubblicazione della vetrina e il mercato pertinente. Una riga di amministrazione salvata da sola non è la prova della visibilità del cliente.
## Guide correlate
- [Importa prodotti](./import-products)
- [Inventario e varianti](./inventory-and-variants)
- [Dropshipping](./dropshipping)
- [Onboarding e impostazioni generali](./onboarding-and-general-settings)
---
# Promozioni
Source: https://www.runnerai.com/docs/it/guides/store-operations/promotions
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza Promozioni per definire uno sconto, l'esperienza del cliente, le regole di idoneità e se è attivo o ancora una bozza.
## Perché e quando utilizzare Promozioni
Crea una promozione per una campagna pianificata, un incentivo per i clienti, un'offerta di spedizione gratuita o un'offerta di acquista e ricevi. Inizia in Bozza mentre controlli i dettagli; utilizza Attivo solo quando lo sconto dovrebbe essere idoneo al checkout.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Apri un progetto Runner con un backend di negozio pronto.
- Crea i prodotti a cui fa riferimento una regola Acquista X Ricevi Y prima di costruire quella promozione.
- Conferma la valuta del mercato pertinente e la configurazione della spedizione prima di offrire sconti basati su importo o spedizione gratuita.
- Testa il comportamento del checkout con un ordine di prova appropriato prima di condividere un codice pubblicamente.
## Apri Promozioni
**Percorso di accesso:** **Area di lavoro → scegli un negozio → Operazioni negozio → Promozioni**
## Controlli principali
| Controllo | Perché lo utilizzi | Cosa accade quando selezionato |
| --- | --- | --- |
| **Crea** / **Aggiungi prima promozione** | Scegli un nuovo tipo di sconto | Apre un menu per Importo sconto ordine, Percentuale sconto ordine, Acquista X Ricevi Y o Spedizione gratuita. L'elenco vuoto utilizza **Aggiungi prima promozione**. |
| **Importo sconto ordine** | Sconta il totale dell'ordine di un importo fisso | Apre un modulo con importo, metodo, stato e impostazioni di idoneità. |
| **Percentuale sconto ordine** | Sconta il totale dell'ordine di una percentuale | Apre un modulo con un valore percentuale e le impostazioni condivise. |
| **Acquista X Ricevi Y** | Dai prodotti selezionati dopo un acquisto qualificante | Apre i selettori di quantità e prodotto per ciò che il cliente acquista e riceve. |
| **Spedizione gratuita** | Rimuovi le spese di spedizione idonee | Apre una promozione il cui sconto si applica alla spedizione. |
| **Sconto automatico** | Applica la promozione senza chiedere al cliente un codice | Il checkout valuta automaticamente le regole, ma il modulo richiede comunque un valore di codice per identificare la promozione. |
| **Codice promozione** | Richiedi un codice inserito dal cliente | I clienti devono inserire il codice richiesto al checkout. |
| **Attivo** / **Bozza** | Controlla se la promozione è utilizzabile | Salva lo stato operativo scelto con la promozione. |
| **Aggiungi condizione** | Limita chi può utilizzare la promozione | Aggiunge campi di attributo cliente, operatore e valore. |
| **Salva** | Applica un modulo di creazione o modifica valido | Crea o aggiorna la promozione e torna all'elenco delle promozioni dopo il successo. |
| Riga di promozione | Ispeziona una promozione | Apre tipo, metodo, stato, codice, utilizzo e azioni disponibili. |
| **Modifica** | Modifica la promozione selezionata | Apre il modulo di modifica per quel tipo di promozione esistente. |
| **Elimina** | Rimuovi permanentemente la promozione | Dall'elenco desktop, apre una conferma irreversibile che nomina il codice promozionale. La visualizzazione mobile corrente non mostra questa azione. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBOjWz1xmaXn1xqodiYlA9g46Lh3VyHFBkOze)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il dettaglio mostra Bozza, codice o sconto automatico, valore e idoneità. Non mostra salvataggio o attivazione.
## Crea una promozione
1. Seleziona **Crea**, o **Aggiungi prima promozione** quando l'elenco è vuoto.
2. Scegli il tipo che corrisponde all'offerta.
3. Scegli **Sconto automatico** o **Codice promozione**.
4. Inserisci il valore del codice richiesto. Per **Codice promozione**, inserisci il codice esatto che i clienti dovrebbero utilizzare; per **Sconto automatico**, i clienti non lo inseriscono.
5. Scegli **Bozza** mentre prepari o **Attivo** quando dovrebbe essere idoneo.
6. Inserisci il valore dello Sconto, o seleziona i prodotti Acquista e Ricevi e le quantità.
7. Lascia l'idoneità per tutti i clienti o seleziona **Aggiungi condizione** e completa ogni campo di condizione.
8. Rivedi il riepilogo, quindi seleziona **Salva**.
9. Torna all'elenco e conferma il Tipo, il Metodo, lo Stato, il Codice e i valori Utilizzati.
### Esempio: prepara un codice del 10%
Scegli **Sconto percentuale sull'ordine**, **Codice promozione**, codice `WELCOME10`, **Bozza** e valore `10`. Controlla l'idoneità prima di salvare. Se stai imparando, esci senza salvare: un modulo non salvato non crea promozioni.
Dopo aver salvato una bozza desiderata, riapri la riga e controlla Codice, Metodo e Bozza. Mantienila tale finché non hai verificato separatamente il checkout previsto. Anche uno sconto automatico richiede un codice interno, ma i clienti non lo digitano.
## Modifica o rimuovi una promozione
1. Seleziona una riga di promozione.
2. Scegli **Modifica**, modifica i campi desiderati e seleziona **Salva**.
3. Testa la regola aggiornata prima di condividerla con i clienti.
4. Per rimuoverla, torna all'elenco desktop, seleziona **Elimina** e leggi il codice nella conferma.
5. Continua solo se l'eliminazione permanente è intenzionale.
## Stati e limiti
- **Bozza** è archiviata ma non intesa per essere utilizzabile al checkout.
- **Attivo** è idoneo ad applicarsi quando il suo metodo e le sue condizioni corrispondono.
- **Inattivo** può apparire nell'elenco quando una promozione esistente non è attualmente attiva.
- Un valore percentuale deve essere compreso tra 1 e 100.
- Il modulo richiede un valore di codice per entrambi i metodi. I clienti lo inseriscono solo quando è selezionato **Codice promozione**.
- Acquista X Ricevi Y richiede sia il prodotto qualificante che il prodotto gratuito.
- Ogni condizione aggiunta ha bisogno di un attributo, un operatore e un valore.
- Con uno sconto automatico, il checkout decide se le sue regole corrispondono; il cliente non inserisce il valore del codice del modulo.
## Risoluzione dei problemi
- **Salva è disabilitato o mostra un errore:** Completa il valore, il codice, il prodotto, la quantità o i campi di condizione denominati dal modulo.
- **Un codice non funziona al checkout:** Conferma l'ortografia esatta, lo stato Attivo, l'idoneità del cliente, i requisiti del prodotto, il mercato e il checkout corrente.
- **Uno sconto automatico non si applica:** Controlla che l'ordine soddisfi ogni condizione e che un'altra promozione non stia cambiando il risultato previsto.
- **Una promozione di spedizione gratuita non ha effetto visibile:** Conferma che l'ordine ha un'opzione di spedizione salvata idonea e che la promozione è Attiva.
- **L'elenco delle promozioni non riesce a caricarsi:** Aggiorna la pagina e conferma il progetto corretto prima di provare a creare un duplicato.
## Guide correlate
- [Prodotti](./products)
- [Clienti](./customers)
- [Spedizione](./shipping)
- [Ordini](./orders)
---
# Recensioni
Source: https://www.runnerai.com/docs/it/guides/store-operations/reviews-and-advanced-admin
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa Recensioni per moderare il feedback dei clienti quando la funzionalità è abilitata.
## Perché e quando usare Recensioni
Abilita Recensioni quando il tuo storefront è pronto a raccogliere feedback sui prodotti e qualcuno modererà gli invii.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
### Recensioni
- Apri **Operazioni del negozio → Generale** e cerca **Recensioni prodotti**.
- La voce Recensioni e i controlli dipendono dal supporto del negozio e dal layout. Se manca o è bloccata, controlla Recensioni prodotto in Generali invece di forzare un percorso diretto.
- Uno storefront più vecchio può mancare dei componenti di recensione anche dopo l'abilitazione dell'opzione. Quando Runner mostra l'hint della funzionalità, chiedi all'agente di aggiungere la funzionalità di recensione dei prodotti e pubblica le modifiche dello storefront risultanti.
- Le recensioni appaiono solo dopo che i clienti le inviano tramite uno storefront supportato.
## Percorsi di accesso
**Percorso di accesso Recensioni:** **Workspace → scegli uno store → Operazioni del negozio → Generale → Recensioni prodotti**, attiva l'interruttore, quindi seleziona **Operazioni del negozio → Recensioni** quando quella voce di menu appare.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglTicdyefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il ritaglio annotato evidenzia i filtri di moderazione. Apri Generale per gestire le impostazioni di raccolta; in questo esempio non è stata approvata alcuna recensione.
## Controlli principali
| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| Interruttore **Recensioni prodotti** | Richiedi la raccolta di recensioni per lo store | Salva l'impostazione immediatamente. Se la richiesta fallisce, l'interruttore torna al valore precedente; non è necessario un **Salva** a livello di pagina per questo interruttore. |
| **Tutte** | Rivedi ogni stato di moderazione caricato | Cancella il filtro di stato. |
| **Approvate** | Rivedi gli invii accettati | Filtra l'elenco su Approvate. |
| **Rifiutate** | Rivedi gli invii declinati | Filtra l'elenco su Rifiutate. |
| **In sospeso** | Trova le recensioni in attesa di una decisione | Filtra l'elenco su In sospeso. |
| Casella di controllo della riga | Seleziona le recensioni per una decisione in blocco | Aggiunge o rimuove quella recensione dalla selezione attuale. |
| **Approva** | Accetta una recensione | Aggiorna il suo stato su Approvata dopo il successo. |
| **Rifiuta** | Declina una recensione | Aggiorna il suo stato su Rifiutata dopo il successo. |
| **Approva selezionate** | Accetta tutte le recensioni selezionate | Applica Approvata alla selezione attuale dopo il successo. |
| **Rifiuta selezionate** | Declina tutte le recensioni selezionate | Applica Rifiutata alla selezione attuale dopo il successo. |
## Abilita le recensioni e modera gli invii esistenti
1. Apri **Operazioni del negozio → Generale**.
2. Attiva **Recensioni prodotti**.
3. Attendi che l'impostazione finisca di salvarsi. Se l'interruttore torna su off, la richiesta è fallita; riprova dopo aver controllato la disponibilità dello store.
4. Se Runner dice che lo storefront manca dei componenti di recensione, chiedi all'agente Runner di aggiungere la funzionalità di recensione dei prodotti, rivedi la modifica dello storefront e pubblicala.
5. Torna a Operazioni del negozio e apri **Recensioni** dopo che il menu appare.
6. Seleziona **In sospeso**.
7. Leggi il prodotto, il revisore, la valutazione, il contenuto e la data per ogni invio.
8. Seleziona **Approva** o **Rifiuta**, oppure seleziona diverse righe e usa l'azione selezionata corrispondente.
9. Attendi il messaggio di successo e verifica la colonna Stato.
## Stati e limiti
- **In sospeso** ha bisogno di una decisione di moderazione; **Approvata** e **Rifiutata** registrano la decisione attuale.
- **Nessuna recensione ancora** è valido fino a quando non esistono invii di clienti supportati.
- L'attivazione dell'impostazione non crea recensioni o prova che lo storefront contiene un modulo di recensione.
## Risoluzione dei problemi
- **Il menu Recensioni è mancante:** Conferma l'interruttore in Generale, la disponibilità del backend e l'hint della funzionalità dello storefront. Aggiorna dopo che l'impostazione è confermata.
- **I clienti non possono lasciare recensioni:** Verifica che lo storefront includa i componenti di recensione e che quelle modifiche dello storefront siano state pubblicate.
- **Un'azione di moderazione fallisce:** Mantieni la recensione selezionata, aggiorna una volta e riprova solo dopo aver controllato il suo stato attuale.
## Guide correlate
- [Onboarding e impostazioni generali](./onboarding-and-general-settings)
- [Prodotti](./products)
- [Ordini](./orders)
- [Panoramica di Operazioni del negozio](/it/guides/store-operations)
---
# Spedizione
Source: https://www.runnerai.com/docs/it/guides/store-operations/shipping
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Configura da dove spediscono gli ordini, dove i clienti possono riceverli e come il checkout calcola le spese di spedizione.
## Perché e quando usare le impostazioni di spedizione
Configura la spedizione prima di testare il checkout o rendere disponibile un prodotto fisico ai clienti. Torna quando aggiungi una posizione di adempimento, vendi a un nuovo paese o cambi l'importo che i clienti pagano per la consegna.
## Disponibilità e prerequisiti
Se compaiono schede di configurazione al posto del menu amministrativo, [completa prima la configurazione](/it/guides/store-operations/onboarding-and-general-settings), poi seleziona **Apri Operazioni del negozio**.
- Crea e salva prima una Posizione di stock.
- Mantieni almeno una regione di Mercato salvata. Quando esiste una regione predefinita, Runner può aggiungere una destinazione di spedizione appena selezionata quando salvi; senza una regione predefinita, il salvataggio fallisce.
- Le scelte di spedizione mostrate qui sono regole dello store. I servizi specifici del vettore o dell'app possono richiedere una connessione separata in **App**.
- I flussi di prodotti digitali, prenotazione, fornitore o altri speciali possono seguire regole di adempimento diverse.
## Apri Spedizione
**Percorso di accesso:** **Workspace → scegli uno store → Operazioni del negozio → Generale → Spedizione**
Se Runner mostra un avviso di configurazione della spedizione, seleziona **Configura**. Ti sposta alla sezione Spedizione su Generale. La spedizione non è un elemento permanente nella barra laterale di Operazioni del negozio.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtMoXR2q0HWgOalkhv5dfRGQjiY7nSITscAEm)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Usa Mercato e Sede inventario salvati prima di aggiungere un'opzione di spedizione. L'esempio non mostra un salvataggio completato o una tariffa al checkout.
## Controlli principali
| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| **Aggiungi** | Crea un'opzione di spedizione | Aggiunge una riga **Spedizione gratuita** non salvata con una destinazione **Spedisci a** vuota e un costo di spedizione gratuito. |
| **Nome** | Dai ai clienti una scelta di consegna riconoscibile | Imposta l'etichetta utilizzata per l'opzione di spedizione. |
| **Spedisci a** | Scegli il paese di destinazione del cliente | Limita l'opzione a quella destinazione. |
| **Costo di spedizione** | Definisci come il checkout calcola l'addebito | Apre la finestra di dialogo Spedizione per **Tariffa fissa** o **Tariffa per prezzo**. |
| **Tariffa fissa** | Addebita un importo | Mostra un singolo campo di prezzo di spedizione. |
| **Tariffa per prezzo** | Varia la spedizione in base al totale degli articoli del carrello | Mostra righe di minimo, massimo e prezzo di spedizione. |
| **Aggiungi** nella finestra di dialogo della tariffa | Aggiungi un'altra fascia di prezzo | Aggiunge un intervallo di totale del carrello non salvato. |
| **Salva** nella finestra di dialogo della tariffa | Accetta la bozza della tariffa | Chiude la finestra di dialogo e restituisce la tariffa configurata alla pagina Generale. |
| **Annulla** nella finestra di dialogo della tariffa | Scarta le modifiche della finestra di dialogo | Chiude la finestra di dialogo senza applicare quelle modifiche della tariffa. |
| **Salva** su Generale | Rendi persistente l'opzione di spedizione | Salva la spedizione completata e le modifiche Generale correlate nello store. |
## Aggiungi un'opzione a tariffa fissa o gratuita
1. In Generale, conferma che una regione di Mercato e una Posizione di stock sono salvate.
2. Scorri fino a Spedizione e seleziona **Aggiungi**.
3. Inserisci un Nome chiaro, come la velocità di consegna o il metodo che i clienti riconosceranno.
4. Scegli **Spedisci a**. Le opzioni di spedizione utilizzano la Posizione di stock salvata in Generale; non c'è un selettore **Spedisci da** separato in ogni riga.
5. Apri **Costo di spedizione**.
6. Scegli **Tariffa fissa** e inserisci un prezzo di spedizione. Inserisci `0` quando la consegna dovrebbe visualizzarsi come **Gratuita**.
7. Seleziona **Salva** nella finestra di dialogo.
8. Seleziona il **Salva** a livello di pagina e attendi lo stato salvato.
**Esempio:** chiama l'opzione `Standard shipping`, scegli una destinazione nel Mercato salvato e imposta **Tariffa fissa** a `0` per la consegna gratuita. Seleziona **Salva** nella finestra, poi **Salva** in Generali. Riapri Generali e controlla destinazione e tariffa. Il primo Salva chiude soltanto l'editor: non memorizza le impostazioni. Servizio del corriere e importo al checkout richiedono una verifica separata.
## Aggiungi tariffe basate sul prezzo
1. Apri **Costo di spedizione** per l'opzione prevista.
2. Scegli **Tariffa per prezzo**.
3. Inserisci un totale minimo o massimo degli articoli del carrello e il prezzo di spedizione per quell'intervallo.
4. Seleziona **Aggiungi** per ogni intervallo aggiuntivo.
5. Assicurati che gli intervalli non si sovrappongano e che ogni riga abbia un prezzo di spedizione.
6. Seleziona **Salva** nella finestra di dialogo, quindi **Salva** su Generale.
## Stati e limiti
- Ogni intervallo di prezzo ha bisogno di almeno un totale minimo o massimo degli articoli del carrello.
- Gli intervalli di prezzo sovrapposti vengono rifiutati.
- Un prezzo di spedizione è richiesto per i metodi fissi e basati sul prezzo.
- Una destinazione senza una regione salvata mostra **Non vendi ancora in questo paese: aggiungilo prima in 'Mercati'.**.
- Quando esiste una regione di Mercato predefinita, il salvataggio può aggiungere automaticamente il paese di destinazione selezionato a quella regione.
- Il **Salva** della finestra di dialogo prepara l'opzione sulla pagina; usa il **Salva** della pagina Generale per rendere persistente la modifica delle impostazioni complete.
## Risoluzione dei problemi
- **Aggiungi prima una posizione di stock:** Aggiungine una e salvala in Generale, quindi torna a Spedizione.
- **Nessuna regione predefinita è disponibile:** Crea e salva una regione di Mercato, quindi riprova il **Salva** della pagina Generale.
- **Salva prima la posizione di stock:** Usa il **Salva** della pagina Generale, quindi riapri la riga di spedizione.
- **Intervalli di prezzo sovrapposti rilevati:** Regola i valori minimo e massimo in modo che ogni totale del carrello corrisponda a una sola riga.
- **La spedizione è mancante al checkout:** Conferma che la destinazione corrisponda a un mercato salvato, la riga di spedizione sia salvata, il prodotto richieda la spedizione e qualsiasi servizio connesso sia pronto.
## Guide correlate
- [Onboarding e impostazioni generali](./onboarding-and-general-settings)
- [Inventario e varianti](./inventory-and-variants)
- [Ordini](./orders)
- [Panoramica di Operazioni del negozio](/it/guides/store-operations)
---
# Vetrina e pubblicazione
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Utilizza questa sezione per spostare un negozio da un'anteprima in-app a un negozio live verificato. Ogni pagina copre un'attività e spiega cosa fa ogni controllo importante.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Inizia controllando l'anteprima attuale, poi segui la guida per la modifica o la fase di lancio necessaria.
## Cosa copre questa guida
Scegli la guida che corrisponde al tuo attuale compito di negozio, senza confondere un'anteprima modificabile con un negozio live e acquistabile.
## Comprendi i quattro stati del negozio
| Stato | Cosa significa | Cosa non prova |
| --- | --- | --- |
| **Anteprima** | Runner sta mostrando una copia di lavoro all'interno del tuo progetto. Puoi rivedere pagine e layout. | Il negozio non è necessariamente pubblico. |
| **Pubblica** | Runner controlla e invia la versione corrente a un URL di negozio pubblico per la prima volta. | Prodotti, stock, spedizione, pagamenti e checkout non vengono verificati automaticamente. |
| **Pubblica modifiche** | Un negozio live esiste già e Runner può inviare modifiche più recenti. | Le modifiche non salvate o incomplete non sono ancora live. |
| **Ripubblica** | Runner può riprovare dopo una pubblicazione non riuscita o una pubblicazione completata che non ha restituito un URL utilizzabile. | Non è l'etichetta normale per la pubblicazione di nuove modifiche a un negozio live sano. |
## Scegli un'attività
| Cosa vuoi fare | Guida | Risultato |
| --- | --- | --- |
| Rivedi il negozio corrente | [Anteprima del tuo negozio](/it/guides/storefront-and-publishing/preview-your-store) | Controlla pagine, percorsi, comportamento di aggiornamento e layout reattivi. |
| Apporta modifiche visive | [Usa Modalità Design](/it/guides/storefront-and-publishing/design-mode) | Seleziona un elemento e apri i controlli di modifica. |
| Cambia testo, spaziatura, tipo o immagini | [Modifica contenuti, pagine e media](/it/guides/storefront-and-publishing/edit-content-pages-and-media) | Aggiorna una pagina visibile e salva il risultato. |
| Ispeziona o modifica un file del negozio | [Ispeziona e modifica il codice del negozio](/it/guides/storefront-and-publishing/inspect-and-edit-code) | Apri l'editor di codice condizionale, salva una modifica di file focalizzata e rivedi il suo stato Git. |
| Confronta o recupera uno stato precedente | [Usa la cronologia delle versioni](/it/guides/storefront-and-publishing/version-history) | Visualizza in anteprima una versione o ripristinala come nuova versione corrente. |
| Controlla se il negozio è pronto | [Preparati per la pubblicazione](/it/guides/storefront-and-publishing/prepare-to-publish) | Risolvi o riconosci esplicitamente i controlli mostrati da Runner. |
| Metti le modifiche online | [Pubblica e ripubblica](/it/guides/storefront-and-publishing/publish-and-republish) | Avvia il flusso di pubblicazione corretto per lo stato corrente. |
| Prova il percorso del cliente | [Verifica il negozio live e il checkout](/it/guides/storefront-and-publishing/live-store-and-checkout) | Conferma il catalogo pubblico, il carrello e il checkout separatamente. |
| Utilizza il tuo indirizzo web | [Connetti un dominio personalizzato](/it/guides/storefront-and-publishing/custom-domains) | Aggiungi, acquista, trasferisci, rinnova o diagnostica un dominio idoneo. |
| Recupera da uno stato bloccato | [Risolvi i problemi di anteprima e pubblicazione](/it/guides/storefront-and-publishing/troubleshoot-preview-and-publishing) | Abbina il messaggio sullo schermo all'azione successiva più sicura. |
## Ordine consigliato per un primo lancio
1. Rivedi la versione più recente in [Anteprima](/it/guides/storefront-and-publishing/preview-your-store).
2. Apporta e salva eventuali modifiche visive in [Modalità Design](/it/guides/storefront-and-publishing/design-mode).
3. Controlla i [prerequisiti di pubblicazione](/it/guides/storefront-and-publishing/prepare-to-publish).
4. Seleziona **Pubblica** e segui il flusso di conferma.
5. Apri l'URL pubblico e [verifica il catalogo e il checkout](/it/guides/storefront-and-publishing/live-store-and-checkout).
6. Aggiungi un [dominio personalizzato](/it/guides/storefront-and-publishing/custom-domains) solo dopo la prima pubblicazione riuscita.
## Disponibilità e sicurezza
- **Modalità Design** è condizionale. È destinata a una versione più recente pronta su un layout desktop e potrebbe non essere disponibile mentre Runner sta lavorando.
- **Apri editor di codice** è condizionale. Il salvataggio, il commit, il push, la pubblicazione e la verifica del negozio live sono risultati separati.
- La pubblicazione può essere limitata dal piano o dallo stato del negozio. Segui il messaggio mostrato nella tua area di lavoro piuttosto che assumere che ogni account abbia lo stesso accesso.
- Una conferma di pubblicazione può permetterti di riconoscere la configurazione incompleta. Quella scelta può mettere un negozio navigabile online mentre il checkout rimane in pausa o incompleto.
## Guide correlate
- [Ti diamo il benvenuto in Runner AI](/it/guides/product-guide)
- [Ispeziona e modifica il codice del negozio](/it/guides/storefront-and-publishing/inspect-and-edit-code)
- [Risolvi i problemi di anteprima e pubblicazione](/it/guides/storefront-and-publishing/troubleshoot-preview-and-publishing)
---
# Connetti un dominio personalizzato
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/custom-domains
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Percorso di accesso:** **Impostazioni** nella barra laterale → **Negozio: _nome del negozio_** → **Dominio**. Su desktop, il menu del sito pubblicato in **Negozio online** può offrire anche **Impostazioni del dominio**.
## Cosa copre questa guida
Apri Impostazioni dominio per uno store pubblicato, scegli il flusso di lavoro del dominio corretto e comprendi cosa cambia ogni azione ad alto impatto prima di continuare.
## Perché e quando usare un dominio personalizzato
Un dominio personalizzato dà ai clienti un indirizzo con marchio per lo store pubblicato. Connettine uno dopo la prima pubblicazione riuscita e dopo che lo store funziona al suo URL pubblico esistente. Questo isola i problemi di dominio dai problemi di storefront, catalogo e checkout.
## Disponibilità e prerequisiti
- L'accesso a **Dominio personalizzato** dipende dal piano.
- Lo store deve avere una pubblicazione riuscita prima che i controlli del dominio diventino disponibili.
- Hai bisogno dell'accesso alle impostazioni del progetto.
- L'aggiunta di un dominio che già possiedi richiede il permesso di modificare i suoi record DNS presso il tuo provider DNS.
- L'acquisto o il rinnovo di un dominio avvia un flusso di pagamento esterno.
- Il trasferimento di un dominio tra store nello stesso workspace è limitato ai proprietari e agli amministratori dello workspace.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgj47Uwq6IQ3D84warl6z9RO5sLdoxCUgTn1v2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un negozio non pubblicato mostra questo prerequisito. Pubblica e verifica l'URL pubblico prima di seguire i passaggi DNS.
## Apri Impostazioni dominio
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Dopo la pubblicazione, apri il menu accanto a **Pubblica modifiche**: 1. Menu del sito pubblicato. 2. **Visualizza sito** apre il negozio live; **Copia URL** copia l’indirizzo. 3. **Impostazioni dominio** apre la gestione degli indirizzi. Questa immagine non verifica il checkout. Seleziona l’immagine per ingrandirla. Le annotazioni usano l’interfaccia desktop in inglese.
1. Controlla il nome del negozio attuale.
2. Apri **Impostazioni** nella barra laterale.
3. Sotto **Negozio: _nome del negozio_**, seleziona **Dominio**.
4. Se la pagina chiede di pubblicare prima, completa e verifica la prima pubblicazione prima di aggiungere un dominio.
## Controlli del dominio
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Come connettere un dominio personalizzato?** | Apri l'aiuto della connessione attuale. | La pagina di aiuto si apre in una nuova scheda. |
| Inserisci il tuo dominio + **Continua** | Associa un dominio che possiedi. | Runner convalida e associa l'indirizzo, poi controlla il fornitore DNS. **Dominio aggiunto con successo** conferma solo l'associazione; DNS e proprietà vengono verificati separatamente. Il controllo non è disponibile prima della prima pubblicazione riuscita. |
| **Continua su Cloudflare** | Consenti a Runner di aggiungere i record richiesti per un dominio compatibile gestito da Cloudflare. | Runner apre la pagina di autorizzazione di Cloudflare. Scegli l'account che contiene il dominio e autorizza l'accesso DNS di Runner. Al ritorno, Runner scrive i record esatti richiesti e avvia un nuovo controllo della connessione. Questa opzione appare solo quando la configurazione automatica è disponibile. |
| **Usa record manuali** | Passa da un flusso automatico proposto alla configurazione DNS manuale. | Seleziona questa opzione per mostrare i record esatti **Tipo / Host / Valore**. Se la configurazione automatica non è disponibile, Runner mostra direttamente questi record. Aggiungi ogni record visualizzato presso il tuo provider DNS, quindi torna in Runner. |
| **Ho aggiunto i record** | Controlla subito il DNS dopo aver salvato i record manuali. | Runner controlla automaticamente; selezionando questo pulsante salti l’attesa iniziale e controlli subito sia i record di routing sia qualsiasi verifica della proprietà. L'autorizzazione riuscita del provider, da sola, non contrassegna il dominio come connesso. |
| Icona di cancellazione nel campo del dominio | Rimuovi il valore digitato. | L'input viene cancellato; nessun dominio viene modificato. |
| Ricerca **Acquista un dominio** + **Cerca** | Trova i domini offerti per l'acquisto. | Runner elenca i risultati disponibili o spiega che il dominio richiesto non è disponibile. |
| **Acquista** | Inizia ad acquistare un dominio disponibile selezionato. | Runner apre **Informazioni di contatto** con il dominio e il prezzo visualizzati. Nessun acquisto avviene ancora. |
| **Procedi al pagamento** | Continua un acquisto o rinnovo di dominio. | Runner reindirizza a un checkout esterno. Questo può creare un addebito se lo completi. Rivedi prima i dettagli visualizzati. |
| **Trasferisci un dominio** / **Scegli un dominio da trasferire** | Sposta un dominio idoneo da un altro store nello stesso workspace. | La selezione di un dominio apre una conferma che nomina gli store di origine e destinazione. La conferma avvia il trasferimento; lo store di origine perde quel dominio. |
| Indirizzo del dominio sotto **I tuoi domini** | Apri il sito a quell'indirizzo. | Il dominio si apre in una nuova scheda del browser. |
| Copia accanto a **Host** o **Valore** | Usa il record DNS esatto che Runner consiglia. | L'**Host** o il **Valore** selezionato viene copiato per l'uso presso il tuo provider DNS. Inserisci il **Tipo** visualizzato separatamente. |
| Rimuovi dominio | Scollega un dominio personalizzato. | Runner apre **Rimuovi dominio**. La selezione di **Rimuovi** conferma una modifica che la finestra di dialogo descrive come irreversibile. |
| **Rinnova** | Estendi un dominio acquistato idoneo mostrato vicino alla scadenza. | Runner apre le opzioni di rinnovo e un totale prima di **Procedi al pagamento**. |
| **Riprova** in un trasferimento fallito | Avvia un altro tentativo di trasferimento. | Runner avvia un tentativo nuovo per lo stesso dominio selezionato. |
| **Chiudi** in un trasferimento fallito | Esci dalla finestra di dialogo del trasferimento fallito. | La finestra di dialogo si chiude senza avviare il nuovo tentativo. |
| Chiudi o X durante **Trasferimento in corso** | Chiudi la finestra di dialogo di avanzamento | Il trasferimento lato server continua; chiudere la finestra di dialogo non lo annulla. Torna più tardi per ispezionare lo stato e non avviare un altro trasferimento. |
## Connetti un dominio che già possiedi
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgZ2r91sLs2uca0GtIiU9nYkyS5gVNx1R6HoWd)
Questo esempio mostra il negozio pubblicato e i controlli del dominio sbloccati. 1. Inserisci un dominio che possiedi. 2. Seleziona **Continua**. 3. Se vuoi, cerca in **Acquista un dominio**. 4. Apri l’indirizzo pubblicato in **I tuoi domini**. **Trasferisci un dominio** è un’opzione separata. L’indirizzo è oscurato; non è stato aggiunto alcun dominio. Seleziona l’immagine per ingrandirla. Le annotazioni usano l’interfaccia desktop in inglese.
1. Conferma che lo store funziona al suo URL pubblico attuale.
2. Apri **Impostazioni del dominio**.
3. Inserisci il dominio completo che controlli, quindi seleziona **Continua**.
4. **Dominio aggiunto con successo** significa che Runner ha accettato e associato l'indirizzo. Non conferma DNS configurato o sito online.
5. Scegli un metodo di configurazione:
- Se Runner rileva una configurazione Cloudflare compatibile, seleziona **Continua su Cloudflare**, scegli l'account Cloudflare che contiene il dominio e autorizza l'accesso DNS di Runner. Al ritorno, Runner scrive i record esatti mostrati nelle impostazioni del dominio.
- Se viene proposto un flusso automatico e preferisci la configurazione manuale, seleziona **Usa record manuali**. Se la configurazione automatica non è disponibile, i record sono già visualizzati. Aggiungi ogni record **Tipo / Host / Valore** visualizzato presso il tuo provider DNS.
6. Dopo aver salvato i record manuali, seleziona **Ho aggiunto i record** per saltare l’attesa iniziale e controllare subito. Runner controlla anche automaticamente mentre una connessione è in sospeso e quando torni da Cloudflare.
7. Attendi lo stato di connessione. Runner richiede che siano verificati sia i record di routing sia la proprietà del dominio; completare l'autorizzazione Cloudflare da solo non dimostra la connessione.
8. Apri il dominio da **I tuoi domini**, quindi verifica di nuovo lo storefront pubblico, il prodotto, il carrello e il checkout all'indirizzo personalizzato.
## Acquista, trasferisci, rinnova o rimuovi con cautela
- **Acquista:** Cerca, seleziona **Acquista**, rivedi il dominio e il prezzo attuale, inserisci informazioni di contatto accurate, quindi continua al pagamento solo quando intendi acquistarlo.
- **Trasferisci:** Leggi gli store di origine e destinazione nominati. La conferma dice che lo store di origine perde il dominio e che l'annullamento immediato non è disponibile. Non confermare mentre quello store di origine ha ancora bisogno dell'indirizzo. Chiudere la finestra di dialogo di avanzamento non annulla un trasferimento attivo.
- **Rinnova:** Rivedi il periodo di rinnovo e il totale prima di continuare al pagamento.
- **Rimuovi:** Assicurati che esista un altro dominio funzionante e registra la configurazione attuale prima di selezionare **Rimuovi**. La conferma avverte che la rimozione non può essere annullata.
## Stati, limiti e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| **Pubblica prima** | Il progetto non ha ancora una pubblicazione riuscita. | Pubblica e verifica l'URL pubblico esistente prima di aggiungere un dominio personalizzato. |
| **Nessun dominio trovato** | Nessun dominio è attualmente allegato. | Aggiungi un dominio che possiedi o cercane uno da acquistare. |
| **Inserisci un dominio valido** | Runner ha rifiutato il formato dell'indirizzo. | Correggi l'indirizzo e riprova. |
| **Il dominio è già allegato a un altro store** | Un altro store in questo workspace lo usa. | Un proprietario o amministratore può selezionare **Trasferiscilo invece?**; gli altri membri dovrebbero contattare un amministratore. |
| **Dominio aggiunto con successo** | Runner ha accettato e associato l'indirizzo. La configurazione DNS viene controllata separatamente. | Leggi la riga del dominio prima di considerare pronto l'indirizzo. |
| **Continua su Cloudflare** non è visualizzato | La configurazione automatica non è attualmente disponibile per questo dominio oppure il servizio di connessione Cloudflare non è pronto. | Usa i record DNS manuali mostrati nella riga del dominio. Non aspettare che appaia un'opzione automatica. |
| Record DNS manuali e **Ho aggiunto i record** | Il dominio di proprietà è collegato, ma il routing o la verifica della proprietà non è ancora riuscita. | Aggiungi esattamente tutti i record visualizzati, attendi la propagazione DNS, quindi seleziona **Ho aggiunto i record** per controllare subito. Runner continua a controllare automaticamente. |
| Stato di controllo o verifica dopo il ritorno da Cloudflare | Runner sta leggendo lo stato DNS e della proprietà effettivo. | Lascia aperta la pagina o torna più tardi. Se non si connette, usa i record manuali e verifica di nuovo. |
| Segno di spunta blu e scomparsa dei controlli DNS del dominio | Sia la configurazione DNS corrente sia la verifica della proprietà sono riuscite. | Apri il dominio e verifica l'intero percorso del cliente; il segno di spunta da solo non dimostra che lo storefront o il checkout funzionino. |
| Indicatore di caricamento con **Configurazione dominio in corso — disponibile in pochi minuti** | Un dominio acquistato tramite Runner è ancora in configurazione. | Non applicare a questo stato le istruzioni DNS manuali dei domini di proprietà. Torna più tardi; non è garantito un tempo di completamento fisso. |
| **Trasferimento in corso** | Un trasferimento di dominio dello workspace ha iniziato. | Evita di avviare un altro trasferimento per lo stesso dominio. Chiudere la finestra di dialogo la chiude solo; il trasferimento continua sul server. Torna più tardi per ispezionare il risultato. |
| Il trasferimento è fallito | Lo spostamento non è stato completato. | Leggi l'errore, quindi seleziona **Riprova** o **Chiudi**. Conferma quale store ancora contiene il dominio prima di un'altra azione. |
| L'acquisto o il rinnovo è fallito | L'acquisto esterno non è stato completato. | Segui lo stato visualizzato da Runner e conferma qualsiasi stato di rimborso prima di provare un altro pagamento. |
## Guide correlate
- [Pubblica e ripubblica](./publish-and-republish)
- [Verifica lo store live e il checkout](./live-store-and-checkout)
- [Risolvi i problemi di anteprima e pubblicazione](./troubleshoot-preview-and-publishing)
---
# Usa Modalità Design
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/design-mode
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Percorso di accesso:** Area di lavoro → seleziona un negozio → **Negozio online** → **Modalità Design**
## Cosa copre questa guida
Apri Modalità Design sulla versione più recente della vetrina, seleziona un elemento visibile, fai una modifica controllata e salvala come parte del progetto attuale.
## Perché e quando usare Modalità Design
Usa Modalità Design per modifiche visive mirate che sono più facili da indicare che descrivere da zero: riscrivi un titolo, sostituisci un'immagine, regola la spaziatura, cambia la tipografia o rimuovi un elemento visibile.
Usa la chat di Runner per il lavoro più ampio che copre diverse pagine, cambia il comportamento del negozio o richiede nuove funzionalità.
## Disponibilità e prerequisiti
Modalità Design è condizionale. È disponibile quando:
- stai usando un layout desktop;
- la versione più recente della vetrina è pronta e selezionata;
- non stai visualizzando un'anteprima di una versione precedente;
- Runner non sta attualmente elaborando un'altra richiesta; e
- la funzionalità Modalità Design è abilitata per l'area di lavoro.
Se l'anteprima è ancora in preparazione, è selezionata una versione storica o Runner sta lavorando, il pulsante può essere nascosto o disabilitato.
## Apri Modalità Design
1. Apri il tuo progetto.
2. Seleziona **Negozio online**.
3. Assicurati che l'etichetta della versione dica **Attuale** e che l'anteprima sia pronta.
4. Seleziona **Modalità Design** nella barra degli strumenti della vetrina.
5. Se una barra di modifica inferiore appare con un altro controllo **Modalità Design**, selezionalo per abilitare la selezione degli elementi.
6. Sposta il mouse sulla vetrina e seleziona l'elemento che vuoi modificare.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Modalità Design è aperta, ma nessun elemento è selezionato. Seleziona quello da cambiare per mostrare i controlli disponibili; lo screenshot non mostra modifiche o salvataggi.
## Controlli di Modalità Design
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Modalità Design** nella barra degli strumenti della vetrina | Entra nella vista di modifica dedicata. | Runner apre la vetrina attuale nel pannello di progettazione. |
| **Modalità Design** nella barra inferiore | Attiva o disattiva l'ispezione degli elementi. | Quando attivo, gli elementi selezionabili sono delineati e la selezione di uno apre la sua barra di modifica. Disattivarlo cancella la sessione di modifica attuale. |
| Campo **Chiedi a Runner AI** e freccia di invio | Descrivi una modifica per l'elemento selezionato. | Runner riceve l'istruzione con l'elemento selezionato. Quando Runner inizia, cancella la selezione e ripristina le modifiche dirette non salvate e la loro cronologia di annullamento/ripristino, quindi salva le modifiche dirette in sospeso prima di inviare. |
| **Spaziatura** | Cambia lo spazio dentro o intorno all'elemento. | Un pannello si apre per margine e padding orizzontale e verticale. |
| **Immagine** | Sostituisci un'immagine selezionata o un'immagine di sfondo. | Un pannello si apre con le opzioni **Carica** e **Generata da AI** quando quell'elemento supporta la modifica dei media. |
| **Testo** | Cambia lo stile del tipo. | Un pannello si apre per dimensione del carattere, peso, famiglia, colore, opacità e allineamento quando supportato. |
| **Elimina elemento** | Rimuovi l'elemento selezionato dalla modifica attuale. | L'elemento scompare immediatamente nell'editor. Usa **Annulla** se questo era accidentale e rivedi prima di salvare. |
| **Annulla** | Inverti la modifica visiva non salvata più recente. | Runner torna indietro nella cronologia di modifica della sessione corrente di Modalità Design. |
| **Ripristina** | Riapplica una modifica che hai appena annullato. | Runner avanza nella cronologia di modifica della sessione corrente di Modalità Design. |
| **Salva** | Mantieni le modifiche visive attuali. | Runner scrive le modifiche in sospeso, registra uno snapshot di nuova versione quando possibile, cancella la cronologia di annullamento/ripristino di questa sessione e ricarica l'anteprima. Il pulsante è disabilitato quando non c'è nulla da salvare. |
| **Chiudi** | Esci dal pannello di progettazione dedicato. | Runner torna all'anteprima normale della vetrina e cancella le modifiche non salvate e la cronologia dei comandi. Salva prima se vuoi mantenere le modifiche. |
## Fai una modifica visiva sicura
1. Naviga alla pagina di destinazione in Anteprima normale prima di aprire Modalità Design.
2. Entra in Modalità Design e seleziona un elemento.
3. Scegli un percorso per questa modifica:
- Per una modifica diretta, usa **Spaziatura**, **Immagine**, **Testo** o **Elimina elemento**, quindi rivedi con **Annulla** o **Ripristina** e seleziona **Salva**.
- Per una richiesta AI, salva prima le modifiche dirette in sospeso, riseleziona l'elemento se necessario, inserisci l'istruzione in **Chiedi a Runner AI** e inviala. Quando Runner inizia, la selezione e la cronologia di modifica diretta non salvata vengono cancellate.
4. Attendi che il salvataggio o la richiesta di Runner scelti finiscano, quindi rivedi la pagina in Anteprima normale.
5. Controlla ancora la pagina nei layout **PC**, **Tablet** e **Telefono**. Verifica che titolo, immagine o spaziatura salvati restino presenti dopo il ricaricamento.
6. Pubblica solo dopo che l'anteprima salvata ha superato la tua revisione.
## Stati, limiti e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| **Avvio di design mode…** | Runner sta preparando l'anteprima modificabile. | Mantieni la versione più recente selezionata. |
| **Design mode non è stato avviato** | L'anteprima modificabile non è diventata pronta. | Seleziona **Riprova**. Se si ripete, torna all'Anteprima normale e aggiorna. |
| **L’anteprima è ancora in caricamento.** | L'ispezione degli elementi non è pronta. | Attendi il caricamento della vetrina. |
| **Potrai di nuovo modificare visivamente quando Runner avrà finito l’elaborazione.** | Runner sta gestendo un'altra richiesta. | Attendi la fine, poi seleziona nuovamente l'elemento. |
| Runner inizia dopo una richiesta **Chiedi a Runner AI** | L'editor visivo si ripristina per il nuovo compito. | Qualsiasi modifica diretta non salvata e la loro cronologia di annullamento/ripristino vengono scartate. Salva le modifiche dirette prima di inviare la richiesta. |
| **Modifica AI non disponibile per contenuto dinamico** | Il contenuto selezionato non può essere modificato tramite quel controllo. | Descrivi la pagina e il risultato desiderato nella chat regolare di Runner. |
| **Nulla da annullare / ripristinare / salvare** | La sessione corrente di Modalità Design non ha l'azione corrispondente. | Seleziona un elemento modificabile e fai una modifica prima. |
| **Modifiche salvate nei file di origine** | Runner ha completato il salvataggio di Modalità Design. | Attendi che l'anteprima si ricarichi, quindi rivedi di nuovo la pagina modificata. |
| **Impossibile salvare le modifiche al design** | Runner non è riuscito a scrivere una o più modifiche nei file del tuo negozio. Queste modifiche restano nell'editor e **Salva** resta disponibile. Le modifiche già salvate restano salvate. | Seleziona di nuovo **Salva**. Se continua a non riuscire, annulla quella modifica o descrivila nella chat di Runner. |
| La modifica è salvata ma non live | Il salvataggio delle modifiche aggiorna il progetto, non la vetrina pubblicata. | Rivedi la versione attuale, quindi seleziona **Pubblica modifiche**. |
## Guide correlate
- [Modifica contenuto, pagine e media](./edit-content-pages-and-media)
- [Visualizza l'anteprima del tuo negozio](./preview-your-store)
- [Usa la cronologia delle versioni](./version-history)
---
# Modifica contenuti, pagine e media
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/edit-content-pages-and-media
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Percorso di accesso:** Area di lavoro → seleziona un negozio → **Negozio online** → apri la pagina del negozio di destinazione → **Modalità Design** → seleziona un elemento
## Cosa copre questa guida
Apri la pagina del negozio esatta che desideri modificare, modifica un elemento di testo, layout o media supportato e verifica il risultato salvato prima di pubblicare.
## Perché e quando utilizzare questo flusso di lavoro
Utilizza questo flusso di lavoro per il perfezionamento a livello di pagina: correggi il testo, cambia la tipografia, regola la spaziatura, sostituisci una foto, genera un'immagine alternativa o rimuovi un elemento non necessario. Mantiene chiara la pagina di destinazione e l'elemento selezionato.
Per modifiche al comportamento della navigazione, ai dati dei prodotti, al checkout o a più pagine contemporaneamente, invia una richiesta regolare a Runner invece di affidarti solo ai controlli visivi.
## Disponibilità e prerequisiti
- [Usa la Modalità Design](./design-mode) spiega come aprire l'editor, il requisito del layout desktop e quando il controllo non è disponibile.
- Alcuni elementi generati o dinamici non possono essere modificati inline. Runner mostra meno controlli per questi elementi.
- La generazione di immagini AI può utilizzare crediti. Runner mostra l'avviso applicabile nel pannello immagini prima di eseguirla.
## Apri la pagina e l'editor
1. Apri il tuo progetto e seleziona **Negozio online**.
2. In Anteprima normale, seleziona i link del negozio per raggiungere la pagina che desideri.
3. Se conosci il percorso, seleziona il campo percorso, inserisci un percorso dello stesso sito come `/about` e premi **Invio**.
4. Conferma che la pagina corretta è visibile.
5. Seleziona **Modalità Design**, quindi seleziona l'elemento di destinazione.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmCs0BHauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Inizia selezionando l'elemento in questa vista. I controlli delle immagini compaiono solo per media supportati; qui non sono mostrati sostituzioni o salvataggi.
## Controlli media
[Usa la Modalità Design](./design-mode) documenta i controlli condivisi **Chiedi a Runner AI**, **Spaziatura**, **Testo**, **Elimina elemento**, **Annulla**, **Ripeti** e **Salva**. I controlli seguenti appaiono solo quando l'elemento selezionato supporta i media.
| Controllo | Cosa cambia | Cosa accade quando lo utilizzi |
| --- | --- | --- |
| **Immagine → Carica** | Un'immagine selezionata o un'immagine di sfondo supportata. | Seleziona **Carica immagine**, scegli un file immagine e Runner sostituisce il media selezionato dopo il caricamento riuscito. Il limite attuale mostrato dal prodotto è 5 MB per immagine. |
| **Immagine → Generato da IA** | Un'immagine di sostituzione generata. | Inserisci un prompt e seleziona **Esegui**. Dopo il primo risultato, **Esegui di nuovo** richiede un altro risultato e **Cronologia** apre i risultati di questa sessione di modifica. |
| **Cronologia** | Immagini generate dalla sessione di modifica immagini corrente. | Seleziona un elemento per ispezionarlo. **Ripristina questa versione** applica quell'immagine e il suo prompt; l'icona di download scarica un singolo risultato. |
## Modifica una pagina in sicurezza
1. Registra il percorso della pagina corrente in modo da potervi tornare.
2. Seleziona l'elemento e controlla quali controlli appaiono. I controlli variano in base all'elemento.
3. Apporta una modifica alla volta, quindi utilizza **Annulla**, **Ripristina** o **Cronologia** dell'immagine per confrontare il risultato prima di selezionare **Salva**.
4. Attendi il completamento del salvataggio scelto o della richiesta di Runner.
5. Chiudi Modalità Design e riapri la stessa pagina. Verifica che immagine o contenuto nuovi restino dopo il ricaricamento, poi controlla **PC**, **Tablet** e **Telefono**.
6. Ripeti per la pagina successiva solo dopo che la prima pagina è corretta.
## Stati, limiti e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| Un elemento selezionato ha solo alcuni controlli | Runner espone i controlli supportati da quell'elemento. | Utilizza il controllo disponibile o chiedi a Runner in chat per una modifica più ampia. |
| Caricamento rifiutato | Il file è mancante, non è un'immagine, supera il limite visualizzato o il caricamento non è riuscito. | Scegli un'altra immagine e riprova. |
| **Generazione in corso…** | Runner sta creando l'immagine richiesta. | Mantieni il pannello aperto fino al completamento o al rapporto di errore. |
| **Cronologia** è assente | In questa sessione di modifica non esiste ancora alcuna immagine generata dall'IA. | Genera la prima immagine o carica la tua. |
| Il percorso non si apre | Il percorso non è valido, è esterno o non fa parte dell'anteprima. | Torna a `/`, utilizza un link del negozio visibile o chiedi a Runner di creare o riparare la pagina. |
| La pagina salvata differisce su mobile | La modifica ha interessato un layout reattivo. | Riapri la Modalità Design o chiedi a Runner una correzione specifica del dispositivo prima di pubblicare. |
## Guide correlate
- [Usa la Modalità Design](./design-mode)
- [Anteprima del tuo negozio](./preview-your-store)
- [Pubblica e ripubblica](./publish-and-republish)
---
# Ispeziona e modifica il codice del negozio
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/inspect-and-edit-code
L'editor di codice ti consente di ispezionare o apportare una modifica focalizzata ai file del negozio dietro l'anteprima corrente. Utilizzalo solo quando una modifica visiva o una richiesta di Runner non è la scelta migliore.
## Cosa copre questa guida
Apri l'editor di codice condizionale, salva una modifica di file focalizzata, torna all'Anteprima per verificarla e mantieni il commit, il push e la pubblicazione come azioni deliberate separate.
## Percorso di accesso
Apri un progetto di negozio → **Negozio online** → **Apri editor di codice**.
## Prima di iniziare
- Attendi fino a quando l'area di lavoro del progetto e l'anteprima del negozio sono connesse.
- Utilizza l'editor di codice solo se comprendi il file che intendi modificare.
- Salva ogni file modificato prima di chiudere la sua scheda o la finestra di dialogo. La chiusura di un file non salvato non mostra una conferma.
- Un file salvato modifica l'area di lavoro del progetto, ma non viene automaticamente committato, inviato, pubblicato o provato corretto in Anteprima.
- Utilizza **Conferma** e **Invia** solo quando sei autorizzato a modificare il repository Git remoto configurato del progetto.
## Controlli dell'editor e risultati dei clic
| Controllo o stato | Cosa accade dopo averlo utilizzato |
| --- | --- |
| **Apri editor di codice** | Apre la finestra di dialogo **Editor di codice** a tutta altezza. La chiusura della finestra di dialogo riporta il pannello Vetrina all'Anteprima. |
| Icona dei file | Mostra l'albero dei file del negozio ricercabile. L'espansione di una cartella carica il suo contenuto; la selezione di un file lo apre in una scheda. |
| Scheda del file | Passa l'editor a quel file aperto. Un punto arancione significa che la scheda contiene modifiche non salvate. |
| Icona di chiusura in una scheda del file | Chiude quella scheda. Runner non chiede informazioni sulle modifiche non salvate, quindi salva prima. |
| Editor di codice | Ti consente di modificare il file attivo. La digitazione modifica la scheda aperta ma non salva il file da sola. |
| **Command-S** su macOS o **Control-S** su Windows/Linux | Salva il file attivo nell'area di lavoro del progetto connesso. L'indicatore non salvato arancione si cancella dopo il successo. |
| Icona del ramo Git | Apre il ramo corrente, gli elenchi di file modificati, il modulo di commit e i controlli di push. La selezione di un file modificato apre il suo diff. |
| **Prepara** / **Annulla preparazione** | Aggiunge o rimuove un file dal prossimo commit. Non salva una scheda dell'editor non salvata. |
| **Prepara tutto** / **Annulla preparazione** | Applica la stessa scelta di preparazione a ogni file nell'elenco corrispondente. Rivedi l'elenco prima di utilizzare una delle due azioni. |
| **Messaggio di commit** | Registra la spiegazione che verrà allegata al prossimo commit. |
| **Conferma** | Crea un commit dai file preparati quando il messaggio non è vuoto. Le modifiche non preparate e non salvate rimangono al di fuori di quel commit. |
| **Invia** | Invia immediatamente i commit che sono in anticipo rispetto al remoto configurato. Non c'è una seconda conferma in questo pannello. |
| **Aggiorna** | Richiede lo stato Git più recente per l'area di lavoro del progetto connesso. |
## Apporta e verifica una modifica focalizzata
1. Conferma il nome del progetto e il negozio corrente in Anteprima.
2. Seleziona **Apri editor di codice**.
3. Mantieni la vista File aperta, espandi la cartella richiesta e seleziona un file.
4. Leggi il contenuto esistente prima di modificarlo.
5. Apporta la modifica più piccola prevista.
6. Premi **Command-S** o **Control-S** e conferma che il punto arancione scompaia.
7. Riapri il file per controllare il contenuto salvato, poi chiudi l'editor e verifica la pagina interessata in Anteprima.
8. Controlla i layout desktop e mobile quando la modifica può interessare uno dei due.
9. Se il risultato è sbagliato, torna all'editor e correggilo, o chiedi a Runner di riparare il file specifico e il problema visibile.
Il salvataggio prova solo che Runner ha scritto il file. L'Anteprima prova solo che il progetto corrente può visualizzarlo. La pubblicazione e il percorso del cliente live rimangono controlli separati.
## Commit e push solo quando necessario
1. Salva ogni file che intendi includere.
2. Apri la vista del ramo Git.
3. Seleziona ogni file modificato e rivedi il suo diff.
4. Utilizza **Prepara** per i file previsti. Evita **Prepara tutto** quando sono presenti modifiche non correlate.
5. Inserisci un **Messaggio di commit** chiaro.
6. Seleziona **Conferma** e attendi l'aggiornamento dello stato Git.
7. Utilizza **Invia** solo dopo aver confermato il ramo e il flusso di lavoro remoto. L'azione si avvia immediatamente.
8. Torna all'Anteprima e verifica il risultato visibile. Un commit o push riuscito non pubblica il negozio.
## Risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| **Apri editor di codice** è mancante | La funzione non è abilitata per questo progetto. | Utilizza la Modalità Design o chiedi a Runner di apportare la modifica. Non affidarti a un percorso interno copiato. |
| **Connessione alla sandbox...** | L'area di lavoro del progetto non è ancora connessa. | Mantieni il progetto aperto e riprova dopo la riconnessione dell'area di lavoro. |
| Indicatore di caricamento dell'albero dei file | Runner sta caricando la cartella corrente. | Attendi prima di selezionare un'altra cartella ripetutamente. |
| La selezione di un file non fa nulla | Il file non potrebbe essere letto o l'area di lavoro si è disconnessa. | Controlla la connessione, quindi seleziona il file ancora una volta. |
| Il punto arancione rimane dopo il salvataggio | Il file non è stato salvato correttamente. | Mantieni la scheda aperta, leggi il messaggio di errore e riprova dopo la riconnessione se necessario. |
| **Apri un file dall'albero** | Nessun file è attivo. | Seleziona un file nella vista File. |
| **Nessuna modifica** | Git non segnala modifiche ai file salvati. | Salva la scheda dell'editor, quindi seleziona **Aggiorna**. |
| **Conferma** è disabilitato | Nessun file è stato preparato o nessun messaggio di commit è presente. | Prepara il file salvato previsto e inserisci un messaggio. |
| **Invia** è disabilitato | Il ramo non ha alcun commit locale in anticipo rispetto al remoto, o un invio è in esecuzione. | Esegui il commit della modifica prevista o attendi l'invio corrente. |
| **Impossibile caricare lo stato git** | Runner non potrebbe leggere lo stato del repository. | Seleziona **Riprova**. Non preparare né inviare modifiche fino al caricamento dello stato. |
| La freccia giù mostra che il ramo è indietro | Il remoto contiene commit non presenti nell'area di lavoro. | Fermati prima di eseguire il push e chiedi al proprietario del progetto come aggiornare il ramo in sicurezza. |
| Errore di salvataggio, staging, commit o push | L'azione non è stata completata. | Mantieni lo stato corrente, leggi l'errore e riprova solo dopo aver controllato la connessione e l'autorizzazione. |
## Guide correlate
- [Anteprima del tuo negozio](./preview-your-store)
- [Usa Design Mode](./design-mode)
- [Usa la cronologia delle versioni](./version-history)
- [Pubblica e ripubblica](./publish-and-republish)
- [Risolvi i problemi di anteprima e pubblicazione](./troubleshoot-preview-and-publishing)
---
# Verifica il negozio live e il checkout
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/live-store-and-checkout
**Percorso di accesso:** Dopo una pubblicazione riuscita, utilizza l'URL pubblico o **Vedi negozio** quando il passaggio lo offre. Su desktop, quando viene mostrato il menu del sito pubblicato, apri **Negozio online** → menu del sito pubblicato → **Visualizza sito**. La barra degli strumenti mobile della Vetrina corrente nasconde questo menu.
## Cosa copre questa guida
Prova che un cliente può aprire il negozio pubblico, trovare un prodotto reale, aggiungere un'opzione disponibile al carrello e raggiungere un checkout utilizzabile, senza trattare un messaggio di pubblicazione riuscito come prova dell'intero percorso.
## Perché e quando verificare il percorso live
Esegui questo controllo dopo la prima pubblicazione e dopo modifiche a prodotti, navigazione, prezzi, inventario, spedizione, pagamenti o checkout. I quattro risultati sono indipendenti:
1. il negozio può essere pubblico;
2. il catalogo previsto può essere mancante o obsoleto;
3. il carrello può non riuscire anche quando una pagina di prodotto si carica; e
4. il checkout può essere in pausa anche quando il negozio è live.
## Disponibilità e prerequisiti
- Una pubblicazione completata deve fornire un URL pubblico.
- Almeno un prodotto previsto dovrebbe essere attivo, visibile, con prezzo e disponibile per la regione che stai testando.
- La configurazione di spedizione o consegna deve coprire la destinazione del test quando richiesto.
- Per un negozio Runner nativo, collega Stripe se vuoi accettare pagamenti. I negozi Shopify usano checkout e configurazione dei pagamenti di Shopify.
- Non completare un acquisto reale a meno che tu non intenda intenzionalmente effettuare quell'ordine e comprenda l'impatto dell'addebito e dell'evasione.
## Apri il negozio live
Utilizza uno dei due percorsi:
1. Dopo la pubblicazione, seleziona **Vedi negozio** nel passaggio; oppure
2. su desktop, quando mostrato, seleziona il menu del sito pubblicato in **Negozio online**, quindi seleziona **Visualizza sito**; oppure
3. Apri **Impostazioni → Negozio: _nome del negozio_ → Dominio** e seleziona l'indirizzo pubblicato, anche su mobile quando il menu Vetrina è nascosto.
Il menu del sito pubblicato desktop offre anche **Copia URL** quando mostrato, in modo da poter testare lo stesso indirizzo in un'altra sessione del browser.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzglCLETlefCuYB97EiQHRN3LVKtUonPdvTgIM4)
Dopo la pubblicazione, apri il menu accanto a **Pubblica modifiche**: 1. Menu del sito pubblicato. 2. **Visualizza sito** apre il negozio live; **Copia URL** copia l’indirizzo. 3. **Impostazioni dominio** apre la gestione degli indirizzi. Questa immagine non verifica il checkout. Seleziona l’immagine per ingrandirla. Le annotazioni usano l’interfaccia desktop in inglese.
## Controlli e risultati del negozio live
Le etichette Stripe seguenti valgono per negozi Runner nativi. Per un negozio Shopify collegato, verifica il checkout Shopify separatamente.
| Controllo o stato | Cosa accade |
| --- | --- |
| URL pubblicato | Apre il negozio pubblico. Conferma che l'indirizzo è quello che intendi condividere. |
| **Vedi negozio** / **Visualizza sito** | Apre l'URL pubblico in una nuova scheda. Questo è diverso da **Apri in una nuova scheda** all'interno dell'Anteprima. |
| **Copia** / **Copia URL** | Copia l'URL pubblico per la condivisione o un test del browser indipendente. |
| **Vetrina online** | Runner ha trovato un URL di negozio pubblico che i clienti possono sfogliare e condividere. Non conferma il checkout. |
| **Verifica del checkout** | Runner sta controllando se il negozio può accettare pagamenti. |
| **Checkout attivo** | Runner ha trovato una connessione Stripe abilitata. Non testa il prodotto selezionato, la destinazione di spedizione, i campi di checkout o il passaggio di pagamento; verifica quelli separatamente. |
| **Checkout in pausa** | Il negozio pubblico è navigabile, ma i pagamenti non sono disponibili fino a quando Stripe non è connesso. |
| **Stato del checkout non disponibile** | Runner non potrebbe determinare lo stato del pagamento. Seleziona **Ricontrolla lo stato del checkout** prima di affermare che il checkout è pronto. |
| **Connetti Stripe** | Apre il percorso di connessione dei pagamenti. Solo un proprietario o amministratore dell'area di lavoro idoneo può completarlo. |
| **Salta per ora** | Chiude il prompt senza abilitare i pagamenti. |
## Testa il percorso del cliente
1. Apri l'URL pubblico in una scheda nuova. Per un controllo più forte, utilizza una sessione non connessa o di navigazione privata.
2. Conferma che la home page prevista si carica senza controlli del progetto Runner.
3. Segui la navigazione pubblica a una pagina di raccolta o prodotto.
4. Conferma che il prodotto previsto è visibile con il titolo, i media, il prezzo e le opzioni disponibili corretti.
5. Scegli qualsiasi opzione richiesta, come taglia o colore.
6. Seleziona il controllo aggiungi al carrello del negozio e conferma che il conteggio del carrello o il contenuto del carrello cambi.
7. Apri il carrello. Conferma che il prodotto, l'opzione, la quantità, il prezzo e i totali corrispondono a quello che hai selezionato.
8. Avvia il checkout e conferma che la pagina di checkout accetti le informazioni richieste del cliente e della consegna.
9. Conferma che il passaggio di pagamento è disponibile se Runner segnala **Checkout attivo**.
10. Fermati prima dell'azione di acquisto finale a meno che un ordine di test reale non sia autorizzato.
11. Ripeti i passaggi di sfoglia e carrello principali su un viewport di dimensioni telefoniche o su un browser mobile reale.
## Registra ogni risultato separatamente
| Controllo | Condizione di superamento |
| --- | --- |
| URL pubblico | Si apre senza un gate di accesso o uno stato di pagina mancante. |
| Navigazione | I link importanti raggiungono le pagine pubbliche previste. |
| Catalogo | Il prodotto live previsto e i suoi dati correnti sono visibili. |
| Carrello | L'aggiunta di un'opzione disponibile produce lo stato del carrello corretto. |
| Spedizione | La destinazione prevista ha un percorso di consegna previsto quando applicabile. |
| Checkout | Il checkout desiderato raggiunge il pagamento. Lo stato pagamenti Runner o la configurazione Shopify conferma anche un fornitore abilitato. |
| Mobile | I contenuti importanti e i controlli di acquisto rimangono utilizzabili su uno schermo piccolo. |
## Stati, limiti e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| L'anteprima funziona ma l'URL pubblico non riesce | L'anteprima e la pubblicazione sono ambienti o versioni diversi. | Torna a Runner, controlla lo stato della pubblicazione e utilizza **Ripubblica** solo dopo aver risolto il problema denominato. |
| Il sito pubblico si carica ma il prodotto è mancante | Il negozio è live, ma il catalogo previsto non è visibile lì. | Controlla lo stato del prodotto, il mercato, l'inventario e se le modifiche più recenti sono state pubblicate. |
| Aggiungi al carrello è mancante o disabilitato | Il prodotto o l'opzione scelta potrebbe non essere vendibile in questo contesto. | Controlla la disponibilità, le opzioni, il prezzo, lo stock e la configurazione del mercato in Operazioni del negozio. |
| **Checkout in pausa** | I pagamenti non sono connessi. | Seleziona **Connetti Stripe**; non pubblicizzare ancora il negozio come pronto per gli ordini. |
| **Stato del checkout non disponibile** | Runner non può confermare lo stato del pagamento. | Seleziona **Ricontrolla lo stato del checkout** e apri indipendentemente il percorso di checkout. |
| Il checkout si apre ma non può continuare | Il prodotto, la spedizione, il mercato, i campi del cliente o la configurazione del pagamento potrebbero essere incompleti. | Registra il passaggio e il messaggio esatti, correggi quella configurazione, pubblica le modifiche se necessario e ritesta dall'URL pubblico. |
## Guide correlate
- [Pubblica e ripubblica](./publish-and-republish)
- [Preparati per la pubblicazione](./prepare-to-publish)
- [Risolvi i problemi di anteprima e pubblicazione](./troubleshoot-preview-and-publishing)
---
# Preparati per la pubblicazione
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/prepare-to-publish
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Percorso di accesso:** spazio di lavoro → scegli un negozio → **Negozio online** → **Pubblica**, **Pubblica modifiche** o **Ripubblica** (secondo lo stato) → **Conferma Distribuzione**
Quando sono abilitate le schede versione conversazione condizionale, **Pubblica** su una scheda di lavoro **Versione corrente** non pubblicata apre gli stessi controlli di pubblicazione. Le schede versione storica non si pubblicano direttamente.
## Cosa copre questa guida
Raggiungere un controllo di pubblicazione riuscito con i dettagli del negozio che intendi lanciare, oppure prendere una decisione consapevole su qualsiasi configurazione incompleta che Runner ti chiede di riconoscere.
## Perché e quando preparare
Utilizza questa lista di controllo prima della prima **Pubblica** e prima di importanti **Pubblica modifiche**. Riduce il rischio di lanciare una pagina raffinata senza prodotto vendibile, spedizione incompleta, pagamenti in pausa o una build non riuscita.
Runner a volte può permetterti di pubblicare dopo aver riconosciuto una configurazione incompleta. Si tratta di un'eccezione deliberata, non una prova che il negozio sia pronto per ricevere ordini.
I controlli esatti e il passaggio dipendono dall'esperienza di pubblicazione abilitata per l'area di lavoro. Alcune aree di lavoro mostrano un avviso di pagamento prima della pubblicazione e un messaggio di successo dopo; altre mostrano i controlli di Operazioni del negozio prima della pubblicazione e lo stato del checkout dopo la pubblicazione. Segui le etichette mostrate nel tuo flusso.
## Disponibilità e prerequisiti
- Hai bisogno di un progetto con un'anteprima della vetrina pronta.
- La pubblicazione dipende dal piano e dall'accesso al progetto. Se Runner mostra un vincolo del piano, confronta i [piani pubblici](https://www.runnerai.com/pricing) e scegli quello idoneo prima di tornare.
- L'area di lavoro della vetrina deve essere connessa e Runner deve essere inattivo.
- La disponibilità del negozio varia in base all'azienda. Runner può controllare le nozioni di base del negozio, i prodotti, i dettagli di spedizione o stock, la connessione di pagamento, le modifiche rilevate e se la vetrina si compila.
## Apri il flusso di disponibilità
1. Apri il tuo progetto e seleziona **Negozio online**.
2. Rivedi l'ultima versione **Corrente**.
3. Seleziona **Pubblica**, **Pubblica modifiche** o **Ripubblica**, a seconda dell'etichetta mostrata.
4. Runner controlla l'accesso, aggiorna modifiche rilevate e configurazione, poi apre **Conferma Distribuzione**.
## Controlli di preparazione
| Controllo | Quando appare | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Apri Operazioni del negozio** | La conferma dice che la configurazione del negozio è incompleta. | Runner chiude la conferma e apre Operazioni del negozio. |
| **Ricontrolla lo stato della configurazione** | Runner non ha potuto verificare Operazioni del negozio. | Runner controlla di nuovo lo stato della configurazione. |
| **Riprova il controllo** | Runner non ha potuto raggiungere l'area di lavoro della vetrina. | Runner esegue di nuovo il controllo della build di pubblicazione. |
| **Correggi con IA** | Il controllo della build della vetrina non riesce e Runner può ripararlo. | Runner chiude la conferma e invia l'errore di build nella conversazione per la riparazione. Nessuna pubblicazione inizia. |
| Casella di avviso | In base alla procedura, Operazioni negozio incomplete o non verificabili, oppure pagamenti mancanti richiedono conferma esplicita. L'assenza di modifiche non può essere aggirata. | Selezionarla conferma la comprensione del rischio e può abilitare **Conferma** dopo un controllo di compilazione riuscito. |
| **Annulla** | Non sei pronto a continuare. | Runner chiude la conferma senza pubblicare. |
| **Conferma** | Il controllo della build è riuscito e gli avvisi richiesti sono stati risolti o riconosciuti. | Runner avvia la pubblicazione. Il pulsante rimane disabilitato mentre i controlli sono incompleti o Runner sta lavorando. |
## Completa la lista di controllo di lancio
1. In Preview, controlla la home page, la navigazione, la pagina del prodotto, l'ingresso del carrello e il layout del telefono.
2. Apri Operazioni del negozio e conferma che i dettagli aziendali e del negozio mostrati lì sono corretti.
3. Conferma che almeno un prodotto previsto è visibile, vendibile e utilizza il prezzo, le opzioni e i media corretti.
4. Conferma la posizione dello stock e la configurazione della spedizione necessaria per quel prodotto.
5. Decidi se il checkout deve accettare pagamenti al lancio. In Runner nativo collega Stripe; in Shopify controlla i pagamenti del negozio Shopify. Alcuni spazi mostrano l'avviso prima della pubblicazione, altri indicano lo stato dopo: nessuno sostituisce una prova del checkout.
6. Torna a **Negozio online** e seleziona il pulsante di pubblicazione.
7. Attendi **Il tuo negozio è pronto per la pubblicazione!**
8. Risolvi ogni avviso. Usa un riconoscimento solo quando accetti il suo esatto impatto sul cliente.
9. Se volevi solo controllare la preparazione, seleziona **Annulla**. Scegli **Conferma** solo per mettere online questa versione.
10. Dopo la pubblicazione, verifica separatamente la vetrina live, il catalogo, il carrello e il checkout.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
La compilazione passa nell'esempio, ma la configurazione richiede ancora attenzione. Accettare l'avviso non la completa.
### Guarda: controlla e annulla
La registrazione esamina risultato della compilazione e avviso di configurazione, poi seleziona **Annulla**. Non pubblica il negozio di esempio.
## Stati di disponibilità e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| **Verifica che il tuo negozio sia pronto per la pubblicazione...** | Runner sta controllando la build della vetrina corrente. | Attendi il successo o un errore denominato. |
| **Il tuo negozio è pronto per la pubblicazione!** | Il controllo della build è passato. | Risolvi gli avvisi, quindi seleziona **Conferma**. |
| **Il tuo negozio non si compila ancora, quindi non può andare online. Lascia che Runner corregga gli errori, poi pubblica.** | La vetrina attuale non può essere pubblicata. | Seleziona **Correggi con AI**, controlla la riparazione e ripeti i controlli. |
| **Non siamo riusciti a raggiungere il tuo workspace. Riprova il controllo per continuare.** | Il controllo non accede allo spazio attuale. | Seleziona **Riprova il controllo**. Se si ripete, ricollega lo spazio. |
| **Apporta una modifica visibile al tuo negozio prima di pubblicarlo.** | Runner non ha trovato modifiche dall'ultima pubblicazione. | Annulla e apporta la modifica desiderata. **Conferma** resta disabilitato senza modifiche da pubblicare. |
| **Alcuni dettagli operativi richiedono ancora la tua attenzione. Puoi andare online ora e completarli in Operazioni del negozio.** | Dettagli operativi importanti sono incompleti. | Seleziona **Apri Operazioni del negozio**. Pubblica accettando l'avviso solo se accetti le limitazioni. |
| **Impossibile verificare Operazioni del negozio. Riprova oppure conferma e pubblica comunque.** | Lo stato non è disponibile, non necessariamente completo. | Seleziona **Ricontrolla lo stato della configurazione** prima di considerare l'accettazione. |
| **Gli acquirenti possono navigare ma non ancora pagare: collega Stripe nelle Impostazioni per ricevere ordini.** | Nelle procedure che mostrano questo avviso, Runner non ha trovato pagamenti abilitati. | Collega Stripe oppure accetta solo per un lancio intenzionalmente consultabile. Altre procedure riportano lo stato checkout dopo la pubblicazione. |
## Guide correlate
- [Anteprima del tuo negozio](./preview-your-store)
- [Pubblica e ripubblica](./publish-and-republish)
- [Verifica il negozio live e il checkout](./live-store-and-checkout)
---
# Anteprima del tuo negozio
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/preview-your-store
**Percorso di accesso:** Workspace → seleziona un negozio → **Negozio online**
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
## Cosa copre questa guida
Rivedi la vetrina attuale all'interno di Runner, spostati tra le sue pagine e controlla come appare nei layout desktop, tablet e telefono senza pubblicarla.
## Perché e quando usare Anteprima
Usa Anteprima dopo che Runner crea o modifica la vetrina. È il posto più sicuro per individuare testo mancante, rotte interrotte, layout mobile scadenti o sezioni incomplete prima che i clienti le vedano.
Anteprima è separata dal negozio live. Una pagina che sembra corretta qui non prova che l'URL pubblico, i dati del catalogo, l'inventario, la connessione di pagamento o il checkout funzionino.
## Disponibilità e prerequisiti
- Apri un progetto con attività di vetrina esistente o una versione visualizzabile in anteprima.
- Se la pagina mostra **Di’ a Runner come deve essere il tuo negozio online.**, usa il campo su quella pagina per chiedere a Runner di creare la prima versione.
- Se dice **Costruzione della prima versione della tua vetrina…** o **Preparazione dell'anteprima…**, l'anteprima non è ancora pronta.
- Alcuni workspace utilizzano la vetrina più recente basata su checkpoint. I controlli di versione esatti possono variare con la disponibilità graduale.
Quando le schede di versione della conversazione condizionale sono abilitate, selezionando l'immagine della vetrina o **Anteprima** di una scheda di lavoro completata apre la versione pronta esatta creata da quel task. Può essere storica piuttosto che la più recente. Per un progetto più vecchio senza cronologia della versione salvata, **Anteprima** sulla scheda di lavoro della vetrina più recente apre l'anteprima live attuale invece. Controlla le etichette **v…**, **Versione corrente** e **Pubblicato** quando sono disponibili prima di modificare o avviare la pubblicazione.
Un'attività completata o una compilazione riuscita del codice sorgente non significa di per sé che Anteprima sia stata aggiornata. Runner promuove la vetrina completata al termine dell'attività. Se la promozione non riesce, Anteprima mantiene la precedente versione promossa con successo, oppure mostra che non è disponibile alcuna anteprima compilata quando non ne esiste una; verifica quindi la versione visibile e il risultato dell'anteprima.
## Apri Anteprima
1. Apri il tuo workspace di Runner.
2. Seleziona il negozio che desideri rivedere.
3. Seleziona **Negozio online** nella navigazione del progetto.
4. Attendi che la versione attuale appaia nell'area di anteprima.
### Guarda il controllo del dispositivo
Questa registrazione senza audio mostra l'anteprima originale v1 con interfaccia inglese. Seleziona **PC**, **Tablet**, poi **Telefono** per cambiare il riquadro. Seleziona ancora **Telefono** per tornare al desktop. Il negozio resta non pubblicato per tutto l'esempio.
Se il progetto non ha ancora una vetrina:
1. Inserisci ciò che desideri nel campo di descrizione della vetrina. Descrivi l’aspetto, il layout, i prodotti e i contenuti desiderati.
2. Seleziona la freccia di invio (**Invia messaggio**), oppure **Inizia a costruire** se questa azione appare nel tuo spazio di lavoro.
3. Runner crea una conversazione e invia quella descrizione come prima richiesta.
4. Se la creazione non riesce, la descrizione rimane nel campo in modo da poter riprovare.
## Controlli di anteprima
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Indietro** | Torna alla pagina precedente visitata all'interno dell'anteprima. | L'anteprima si sposta indietro nella sua cronologia di pagina. Non lascia il tuo progetto di Runner. |
| **Avanti** | Rivedi una pagina dopo essere tornato indietro. | L'anteprima si sposta in avanti quando esiste una voce di cronologia successiva. |
| **PC / Pad / Telefono** | Controlla i layout reattivi. | Ogni selezione cicla il frame di anteprima alla dimensione del dispositivo successiva. Non modifica la vetrina live. |
| Campo del percorso, come `/` | Apri una rotta di vetrina nota. | Seleziona il percorso, inserisci un altro percorso sullo stesso sito di anteprima e premi **Invio**. Gli indirizzi non validi o esterni vengono ignorati. |
| **Aggiorna** | Ricarica l'anteprima attuale dopo una modifica o un rendering bloccato. | Runner ricarica la pagina visibile e cancella la selezione della Modalità di progettazione attiva e la sessione di annullamento/ripristino. Salva prima le modifiche di progettazione in sospeso. |
| **Apri in una nuova scheda** | Rivedi l'anteprima con più spazio. | Runner apre questo URL di anteprima in un'altra scheda del browser. Questa è ancora un'anteprima, non la prova di un negozio pubblicato. |
| Etichetta di versione, come **v1 · Attuale** | Identifica cosa stai rivedendo. | L'etichetta distingue la versione attuale più recente da un'anteprima storica. |
| **Modalità di progettazione** | Inizia la modifica visiva. | Runner apre lo spazio di lavoro di progettazione quando la versione più recente è idonea. |
| **Cronologia delle versioni** | Confronta le versioni della vetrina precedenti. | Runner apre l'elenco delle versioni senza modificare la vetrina attuale. |
| **Apri editor di codice** | Ispeziona o modifica il codice sorgente della vetrina quando questo controllo avanzato è disponibile. | Runner apre il dialogo **Editor di codice** a piena altezza. Chiuderlo restituisce il pannello Vetrina all'Anteprima; verifica il risultato visibile lì. |
| Moneta / **Guadagna crediti** | Apri l'offerta di referral. | Runner apre il dialogo di referral; nessun credito viene guadagnato semplicemente aprendo. |
| Conteggio crediti / **Esegui l'upgrade** | Rivedi le opzioni di credito, piano o utilizzo. | Runner apre un popover le cui azioni disponibili possono portare a Fatturazione o Utilizzo del workspace. |
| **Pubblica**, **Pubblica modifiche** o **Ripubblica** | Avvia il flusso di pubblicazione appropriato allo stato attuale. | Runner esegue controlli di accesso e disponibilità prima che qualsiasi pubblicazione inizi. |
## Rivedi una pagina della vetrina pagina per pagina
1. Inizia da `/` e scansiona l'intestazione, l'area di annuncio, l'hero, i prodotti in primo piano, le sezioni e il footer.
2. Seleziona ogni link di navigazione visibile. Conferma che la destinazione appare e il percorso di anteprima cambia come previsto.
3. Apri una pagina di prodotto dalla vetrina. Conferma che il titolo, i media, il prezzo, le opzioni, la disponibilità e il controllo di acquisto siano visibili.
4. Usa il campo del percorso per rotte importanti che non sono collegate dalla pagina attuale.
5. Passa tra **PC**, **Tablet** e **Telefono**. Cerca contenuto ritagliato, controlli sovrapposti, testo illeggibile e scorrimento orizzontale.
6. Seleziona **Aggiorna** solo dopo aver salvato le modifiche della Modalità di progettazione.
7. Registra qualsiasi problema nella chat di Runner con il percorso della pagina, la dimensione del dispositivo e il risultato previsto.
## Stati, limiti e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| **Di’ a Runner come deve essere il tuo negozio online.** | Runner non ha ancora una vetrina pronta da mostrare. | Inserisci una richiesta per creare la prima versione. |
| **Costruzione della prima versione…** | La prima versione è ancora in preparazione. | Segui il progresso del task e attendi un risultato terminale. |
| **Preparazione dell'anteprima…** | Runner sta avviando l'anteprima selezionata. | Mantieni la pagina aperta; usa **Aggiorna** solo se lo stato smette di progredire. |
| **Impossibile caricare l'anteprima per questa versione** | Non è stato possibile visualizzare la versione selezionata. | Torna alla versione attuale, aggiorna o segnala la versione e l'errore a Runner. |
| **Riconnessione dell'anteprima** | Runner ha perso la connessione di anteprima e sta ritentando. | Mantieni il progetto aperto e segui il conteggio dei tentativi. Se non riesce a recuperare, riconnetti il workspace. |
| Barra di errore di anteprima con **Correggi** | L'anteprima ha segnalato un errore che Runner può ispezionare. | Seleziona **Correggi** o **Correggi errore** per inviare la diagnostica visualizzata a Runner. Usa **Mostra di più** per espandere i dettagli e **Ignora** solo per nascondere il messaggio. |
| Un controllo è disabilitato | L'anteprima attualmente non supporta quell'azione, il workspace è disconnesso o Runner sta lavorando. | Attendi Runner, riconnetti il workspace se richiesto o torna alla versione pronta più recente. |
| L'anteprima sembra corretta ma il negozio live non lo è | Le modifiche non sono state pubblicate o stai visualizzando versioni diverse. | Controlla l'etichetta di versione, quindi usa [Pubblica modifiche](./publish-and-republish). |
## Guide correlate
- [Crea il tuo primo negozio, passo dopo passo](../start-here/first-store-quickstart)
- [Usa la Modalità di progettazione](./design-mode)
- [Modifica contenuti, pagine e media](./edit-content-pages-and-media)
- [Ispeziona e modifica il codice della vetrina](./inspect-and-edit-code)
- [Usa la cronologia delle versioni](./version-history)
- [Preparati a pubblicare](./prepare-to-publish)
---
# Pubblica e ripubblica
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/publish-and-republish
**Percorso di accesso:** Area di lavoro → seleziona un negozio → **Negozio online** → **Pubblica**, **Pubblica modifiche** o **Ripubblica** (l'etichetta dipende dallo stato di pubblicazione)
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
## Cosa copre questa guida
Utilizza l'azione di pubblicazione che Runner mostra per lo stato del negozio corrente, segui la conferma a un risultato terminale e apri o copia l'URL pubblico quando uno è disponibile.
## Perché e quando pubblicare
La pubblicazione rende la versione del progetto corrente disponibile a un URL del negozio pubblico. Usa **Pubblica** per il primo lancio, **Pubblica modifiche** per un negozio che ha già un URL pubblico sano e **Ripubblica** per riprovare un risultato di pubblicazione non riuscito o incompleto.
Salvare una modifica della modalità di progettazione, ripristinare una versione o vedere un'anteprima corretta non aggiorna il negozio pubblico da solo.
Il passaggio di pubblicazione varia in base al rollout dell'area di lavoro. Alcune aree di lavoro mostrano un avviso di pagamento prima della pubblicazione e solo un messaggio di successo dopo; altre mostrano i controlli di Operazioni del negozio prima della pubblicazione e aprono un passaggio di stato del checkout dopo il successo.
## Disponibilità e prerequisiti
- Completa la [lista di controllo di disponibilità della pubblicazione](./prepare-to-publish).
- Usa l'ultima versione della vetrina **Corrente**.
- Attendi che Runner finisca qualsiasi richiesta attiva.
- Ricollega il workspace della vetrina se il pulsante dice che non è disponibile.
- La pubblicazione può essere limitata dal tuo piano o dall'idoneità del progetto.
- Quando la pubblicazione richiede un piano superiore, **Aggiorna** apre la conferma mensile di Plus. Puoi tornare da questa conferma all'elenco completo dei piani prima dell'acquisto.
## Apri il flusso di pubblicazione
1. Apri il tuo progetto.
2. Seleziona **Negozio online**.
3. Seleziona il pulsante di pubblicazione sul lato destro della barra degli strumenti.
4. Leggi **Conferma Distribuzione** e attendi il controllo della build.
5. Risolvi gli elementi bloccanti. Conferma un avviso solo quando la finestra di dialogo offre questa opzione e ne comprendi l’effetto.
6. Seleziona **Conferma** solo quando è abilitato e intendi rendere pubblica questa versione. Seleziona **Annulla** per uscire senza pubblicare.
### Guarda: esaminare i controlli senza pubblicare
Questa registrazione senza audio, con l’interfaccia in inglese, mostra il risultato della build e l’avviso di configurazione rimasto. Selezionando **Annulla** si torna all’Anteprima. Superare il controllo della build non completa la configurazione operativa del negozio e non abilita il checkout.
## Scegli l'azione corretta
| Etichetta | Quando Runner la mostra | Cosa fa selezionarla |
| --- | --- | --- |
| **Pubblica** | Il negozio non ha completato la sua prima pubblicazione. | Apre i controlli di accesso, configurazione, modifica e build per la versione corrente. |
| **Pubblica modifiche** | Una pubblicazione completata ha un URL pubblico utilizzabile. | Apre gli stessi controlli in modo da poter inviare la versione corrente al negozio live esistente. |
| **Ripubblica** | L'ultima pubblicazione non è riuscita, o è stata completata senza un URL utilizzabile. | Avvia un nuovo tentativo di pubblicazione con i controlli preliminari. |
| **Avvio... / Preparazione... / Compilazione... / Salvataggio checkpoint... / Pubblicazione...** | Un passaggio di pubblicazione è in corso. | Il pulsante è disabilitato e segnala l'avanzamento. Attendi il successo o il fallimento. |
## Controlli di pubblicazione e passaggio
| Controllo | Cosa succede quando lo selezioni |
| --- | --- |
| **Annulla** in **Conferma Distribuzione** | Chiude la finestra di dialogo senza pubblicare questa versione. |
| **Correggi con IA** | Invia un errore di build a Runner per la riparazione, senza pubblicare. |
| **Riprova il controllo** | Esegue di nuovo il controllo della build dopo un errore di accesso all'area di lavoro. |
| **Conferma** | Avvia la pubblicazione dopo il controllo della build e i riconoscimenti richiesti sono completi. |
| **Pubblica comunque: completerò la configurazione più tardi.**, quando disponibile | Conferma che hai preso atto della configurazione incompleta elencata. Non completa queste attività e non pubblica il negozio finché non selezioni anche Conferma. |
| URL pubblicato | Apre la vetrina pubblica in una nuova scheda. |
| **Copia** o **Copia URL** | Copia l'indirizzo del negozio pubblico negli appunti. |
| **Vedi negozio** | Nel passaggio di stato del checkout, apre la vetrina pubblica dopo una pubblicazione riuscita. |
| **Connetti Stripe** | Nei flussi che mostrano lo stato del pagamento, avvia la connessione di pagamento quando il checkout non è pronto. L'accesso può dipendere dal tuo ruolo nell'area di lavoro. |
| **Salta per ora** | Chiude il prompt di pagamento post-pubblicazione quando mostrato. La vetrina può rimanere navigabile mentre il checkout rimane in pausa. |
| **Ricontrolla lo stato del checkout** | Nel passaggio post-pubblicazione, controlla di nuovo una connessione Stripe abilitata quando lo stato non era disponibile. |
| **Chiudi** | Chiude il passaggio di stato del checkout riuscito quando mostrato e il checkout è già connesso. |
| Menu sito pubblicato | Su desktop quando mostrato, apre **Visualizza sito**, **Copia URL**, **Impostazioni del dominio** e le informazioni dell'ultima pubblicazione. |
## Pubblica a un risultato terminale
1. Conferma che l'etichetta del pulsante corrisponda alla tua intenzione.
2. Selezionalo e attendi il controllo della build.
3. Se appare **Correggi con IA**, usalo, rivedi l'anteprima risultante e riavvia la pubblicazione.
4. Se appaiono avvisi, correggi la configurazione sottostante ogni volta che il checkout o le normali operazioni del negozio sono importanti.
5. Seleziona **Conferma**.
6. Mantieni il progetto aperto fino a quando Runner non segnala il successo o il fallimento.
7. Al successo, apri l'URL pubblico. Usa **Vedi negozio** quando appare il passaggio di stato del checkout; un altro rollout può mostrare solo un messaggio di successo prima di tornare alla Vetrina.
8. Se l'URL non è disponibile, chiudi il passaggio e usa **Ripubblica** dopo che l'area di lavoro è pronta.
9. Se la pubblicazione non riesce, leggi il fallimento, riparalo e seleziona **Ripubblica**. Non presumere che le modifiche tentate siano online.
## Stati di pubblicazione e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| **Negozio pubblicato** / **Il tuo negozio è online** | Runner ha completato la pubblicazione e ha un URL pubblico. | Apri l'URL e verifica il percorso del cliente. |
| **Pubblicazione completata** con **Link del negozio non disponibile** | La pubblicazione è terminata senza un link utilizzabile nel passaggio. | Chiudi la finestra di dialogo, assicurati che l'area di lavoro sia pronta, quindi usa **Ripubblica**. |
| **Pubblicazione non riuscita** | La pubblicazione non è stata completata. | Rivedi l'errore o chiedi a Runner di ripararlo, quindi usa **Ripubblica**. |
| **Non è stato possibile compilare il tuo negozio, quindi non è stato pubblicato nulla. Lascia che Runner lo sistemi.** | Il progetto corrente non è riuscito prima della pubblicazione. | Seleziona **Correggi con IA** e non riprovare il lavoro invariato. |
| Il pulsante dice **Il tuo ambiente di lavoro è offline: ricollegalo per pubblicare.** | Runner non può raggiungere l'area di lavoro della vetrina. | Ricollega, quindi esegui di nuovo i controlli. |
| Il pulsante dice **Attendi che Runner finisca** | Una richiesta è ancora attiva. | Attendi il suo risultato terminale prima di pubblicare. |
| **Nessuna modifica** o **Conferma** disabilitato | Non ci sono nuove modifiche salvate, una build è incompleta, un’attività IA è in corso o un controllo obbligatorio è irrisolto. | Completa l’elemento mostrato. Nessuna modifica è uno stato bloccante, non un avviso che puoi ignorare confermandolo. |
| Il negozio pubblico mostra una versione precedente | Le ultime modifiche del progetto non sono state pubblicate con successo. | Controlla la versione corrente, quindi usa **Pubblica modifiche** e verifica di nuovo. |
## Guide correlate
- [Crea il tuo primo negozio, passo dopo passo](../start-here/first-store-quickstart)
- [Preparati per la pubblicazione](./prepare-to-publish)
- [Verifica il negozio live e il checkout](./live-store-and-checkout)
- [Connetti un dominio personalizzato](./custom-domains)
---
# Risolvi i problemi di anteprima e pubblicazione
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/troubleshoot-preview-and-publishing
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Percorso di accesso:** Area di lavoro → seleziona un negozio → **Negozio online** → riproduci lo stato di anteprima o pubblicazione mostrato sullo schermo
## Cosa copre questa guida
Identifica quale livello sta fallendo—versione del progetto, anteprima, controllo della build, pubblicazione, catalogo pubblico, checkout o dominio—e intraprendi l'azione di recupero più piccola e sicura.
## Perché questa distinzione è importante
Il percorso della vetrina ha diversi livelli indipendenti. Ripetere **Pubblica** non può correggere i dati dei prodotti mancanti e aggiornare l'Anteprima non può riparare una connessione di pagamento. Inizia con il messaggio esatto e la superficie che ha fallito.
## Disponibilità e prerequisiti
- Mantieni il progetto aperto e annota l'etichetta della versione corrente.
- Registra il messaggio esatto, il percorso della pagina e se è apparso in Anteprima o sull'URL pubblico.
- Attendi che il lavoro attivo di Runner raggiunga **Completato**, **Non riuscito** o **Interrotto** prima di avviare un'azione di recupero in conflitto.
- Non rimuovere domini, ripristinare versioni o ripetere azioni pagate solo per testare una teoria.
## Trova il livello che sta fallendo
1. In **Negozio online**, controlla se esiste una versione corrente.
2. Conferma se l'Anteprima normale si apre.
3. Se stai pubblicando, leggi il risultato del controllo della build prima di selezionare un'altra azione.
4. Se la pubblicazione ha successo, apri l'URL pubblico piuttosto che l'URL di anteprima.
5. Nel negozio pubblico, testa il catalogo e il carrello.
6. Controlla lo stato del checkout di Runner e il percorso del checkout effettivo.
7. Se solo l'indirizzo personalizzato non riesce, controlla le impostazioni del dominio per ultimo.
## Controlli di recupero importanti
| Controllo | Cosa succede quando selezionato |
| --- | --- |
| **Aggiorna** in Anteprima | Ricarica l'anteprima corrente e cancella la selezione della modalità di progettazione attiva e la sessione di annullamento/ripristino. Salva prima le modifiche dirette in sospeso. |
| **Correggi** / **Correggi errore** | Invia la diagnostica di anteprima visualizzata a Runner come richiesta di riparazione. **Ignora** nasconde solo il messaggio. |
| **Correggi con IA** | Chiude la conferma di pubblicazione e invia il suo errore di build a Runner per la riparazione; la pubblicazione non inizia. |
| **Riprova il controllo** | Esegue di nuovo il controllo della build della vetrina dopo che Runner non ha potuto raggiungere l'area di lavoro. |
| **Apri Operazioni del negozio** | Chiude la conferma di pubblicazione e apre Operazioni del negozio in modo da poter completare la configurazione indicata. |
| **Ricontrolla lo stato della configurazione** | Controlla di nuovo la disponibilità di Operazioni del negozio dopo che il suo stato non era disponibile. |
| **Ripubblica** | Avvia un nuovo tentativo di pubblicazione controllato dopo un risultato non riuscito o senza link. Correggi prima la causa indicata. |
| **Ricontrolla lo stato del checkout** | Controlla di nuovo una connessione di pagamento abilitata; non testa un prodotto, la spedizione o il modulo di checkout. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtIuoqX0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Un controllo di compilazione superato può comparire accanto a un avviso di configurazione. Leggi entrambi prima di decidere se il negozio è pronto.
## Riferimento da stato ad azione
| Messaggio o sintomo | Livello | Cosa significa | Azione più sicura |
| --- | --- | --- | --- |
| Nessuna versione della vetrina pronta | Versione del progetto | Non esiste una versione visualizzabile. | Chiedi a Runner di creare la prima vetrina. |
| **Creazione della prima versione del tuo negozio…** | Versione del progetto | Runner la sta ancora creando. | Segui l'avanzamento dell'attività; non pubblicare ancora. |
| **Compilazione non riuscita** su una versione | Versione del progetto | Quella versione non è pronta. | Apri i dettagli dell'attività e chiedi a Runner di riparare il fallimento. |
| **Preparazione anteprima…** | Anteprima | Runner sta avviando l'anteprima selezionata. | Mantieni la versione più recente selezionata; aggiorna solo se il progresso si ferma. |
| **Non è stato possibile mostrare questa versione: riprova o scegline un’altra.** | Anteprima | La versione selezionata non potrebbe essere visualizzata. | Torna a quella corrente, aggiorna o prova un'altra versione pronta. |
| **Riconnessione dell'anteprima** | Anteprima | Runner ha perso la connessione di anteprima e sta riprovando. | Segui il conteggio dei tentativi; ricollega l'area di lavoro se il recupero non riesce. |
| Barra di errore di anteprima con **Correggi** | Anteprima | La pagina in esecuzione ha segnalato una diagnostica che Runner può usare. | Seleziona **Mostra altro** per ispezionarla, **Correggi** o **Correggi errore** per inviarla a Runner oppure **Ignora** solo per nascondere la barra. |
| **Pagina non trovata** | Percorso di anteprima o pubblico | Il percorso non esiste in quella versione. | Torna a `/`, usa la navigazione visibile e chiedi a Runner di creare o riparare il percorso. |
| **La modalità design non si è avviata. L'anteprima del negozio potrebbe essere ancora in fase di riattivazione: riprova.** | Modalità di progettazione | L'anteprima modificabile non è diventata pronta. | Seleziona **Riprova** oppure torna all'Anteprima corrente e aggiorna. |
| **Potrai di nuovo modificare visivamente quando Runner avrà finito l’elaborazione.** | Modalità Design | Runner gestisce un'altra richiesta. | Attendi che finisca. |
| **Non è stato possibile caricare le versioni: riprova.** | Cronologia versioni | La richiesta dell'elenco delle versioni non è riuscita. | Seleziona **Riprova**. |
| Il ripristino è bloccato | Cronologia versioni | Runner è attivo o la versione non è pronta. | Attendi Runner, quindi scegli una versione pronta. |
| **Non siamo riusciti a raggiungere il tuo workspace. Riprova il controllo per continuare.** | Controllo pubblicazione | Runner non ha potuto eseguire la compilazione. | Seleziona **Riprova il controllo**; ricollega lo spazio se si ripete. |
| **Il tuo negozio non si compila ancora, quindi non può andare online. Lascia che Runner corregga gli errori, poi pubblica.** | Controllo pubblicazione | La vetrina attuale non supera la compilazione. | Seleziona **Correggi con AI**, verifica la riparazione e ripeti il controllo. |
| **Alcuni dettagli operativi richiedono ancora la tua attenzione. Puoi andare online ora e completarli in Operazioni del negozio.** | Configurazione pubblicazione | Operazioni importanti sono incomplete. | Seleziona **Apri Operazioni del negozio**. Accetta l'avviso solo se la limitazione è voluta. |
| **Impossibile verificare Operazioni del negozio. Riprova oppure conferma e pubblica comunque.** | Configurazione pubblicazione | Lo stato non è noto. | Seleziona **Ricontrolla lo stato della configurazione** prima di accettare. |
| **Apporta una modifica visibile al tuo negozio prima di pubblicarlo.** | Modifiche da pubblicare | Runner non ha trovato novità dall'ultima pubblicazione. | Annulla e modifica prima la vetrina. **Conferma** è disabilitato senza modifiche. |
| **Gli acquirenti possono navigare ma non ancora pagare: collega Stripe nelle Impostazioni per ricevere ordini.** | Configurazione checkout | Alcune procedure mostrano l'avviso quando non trovano pagamenti abilitati. | In Runner nativo collega Stripe; accetta solo per un lancio consultabile intenzionale. Altre procedure mostrano lo stato dopo la pubblicazione. |
| **Pubblicazione non riuscita** | Pubblicazione | Il tentativo non è stato completato. | Ripara il problema indicato, quindi seleziona **Ripubblica**. |
| **Link del negozio non disponibile** | Passaggio di pubblicazione | Il tentativo è terminato senza un URL pubblico utilizzabile in Runner. | Chiudi la finestra di dialogo, conferma che l'area di lavoro è pronta, quindi seleziona **Ripubblica**. |
| Il negozio pubblico mostra contenuto precedente | Pubblicazione o versione | Le modifiche del progetto più recente non sono online. | Conferma l'ultima versione corrente, seleziona **Pubblica modifiche** e riapri l'URL pubblico. |
| Prodotto mancante nel negozio pubblico | Catalogo | La pubblicazione è riuscita, ma il prodotto previsto non è visibile. | Controlla lo stato del prodotto, il mercato, il prezzo e l'inventario; pubblica le modifiche se necessario. |
| Azione del carrello mancante o disabilitata | Catalogo o disponibilità | L'elemento selezionato attualmente non può essere aggiunto. | Controlla le opzioni richieste, la disponibilità, lo stock, il prezzo e la regione. |
| **Checkout in pausa** | Pagamento | Il flusso post-pubblicazione non ha trovato una connessione Stripe abilitata. | Seleziona **Connetti Stripe**, quindi riprova il percorso di checkout effettivo. |
| **Stato del checkout non disponibile** | Stato del pagamento | Runner non può confermare la disponibilità del pagamento. | Seleziona **Ricontrolla lo stato del checkout** e testa il checkout pubblico indipendentemente. |
| Il dominio personalizzato di proprietà mostra un avviso rosso e una tabella **Tipo / Host / Valore** | Dominio | Il controllo della configurazione corrente del provider non è ancora riuscito. | Copia esattamente i valori mostrati presso il tuo provider. Runner ricontrolla automaticamente finché le Impostazioni dominio restano aperte; non esiste un pulsante di verifica manuale. |
| **Trasferimento in corso** | Dominio | Un dominio si sta spostando tra negozi. | Non avviare un altro trasferimento; segui lo stato mostrato. |
## Conferma il recupero
Torna alla stessa pagina, versione e dimensione che hanno dato errore. Ripeti una volta il più piccolo passaggio fallito. Controlla il risultato visibile: anteprima pronta, pubblicazione riuscita con pagina prevista all'URL pubblico, carrello corretto o dominio funzionante. Registra separatamente i passaggi ancora in errore.
## Segnala un problema a Runner
Includi questi dettagli in un messaggio:
1. il percorso della pagina esatto o l'URL pubblico;
2. se non è riuscito in Anteprima o nel negozio online;
3. l'etichetta della versione corrente;
4. il testo di errore o stato esatto;
5. l'ultimo pulsante che hai selezionato;
6. il risultato previsto; e
7. se il problema si riproduce dopo l'azione di ripetizione documentata.
Per un problema visivo, includi il layout del dispositivo e uno screenshot. Per il checkout, fermati prima di un addebito reale e segnala l'ultimo passaggio riuscito.
## Confini di recupero
- Non riprendere o ripubblicare ripetutamente uno stato non riuscito invariato. Correggi prima la causa denominata.
- Non ripristinare una versione precedente mentre Runner sta lavorando.
- Non rimuovere un dominio per correggere un problema di vetrina o checkout.
- Non rivendicare il successo del lancio fino a quando l'URL pubblico, il catalogo previsto, il carrello e il passaggio di checkout richiesto non siano stati controllati.
## Guide correlate
- [Anteprima del tuo negozio](./preview-your-store)
- [Preparati per la pubblicazione](./prepare-to-publish)
- [Pubblica e ripubblica](./publish-and-republish)
- [Verifica il negozio live e il checkout](./live-store-and-checkout)
- [Connetti un dominio personalizzato](./custom-domains)
---
# Usa la cronologia delle versioni
Source: https://www.runnerai.com/docs/it/guides/storefront-and-publishing/version-history
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Percorso di accesso:** Area di lavoro → seleziona un negozio → **Negozio online** → **Cronologia versioni** (icona con orologio e freccia)
## Cosa copre questa guida
Confronta le versioni della vetrina, visualizza in anteprima una versione precedente pronta e, se necessario, ripristina il suo contenuto come nuova versione corrente mantenendo la cronologia esistente.
## Perché e quando usare la cronologia delle versioni
Usa la cronologia delle versioni quando hai bisogno di capire cosa è cambiato, rivedere un design precedente o recuperare contenuti che erano migliori prima di una richiesta recente. L'anteprima è di sola lettura. Il ripristino modifica il progetto, quindi rivedi prima la conferma.
## Disponibilità e prerequisiti
- Apri un progetto con almeno una versione della vetrina.
- L'anteprima storica e il ripristino sono disponibili solo per le versioni che Runner può caricare correttamente.
- Attendi che Runner termini una richiesta attiva prima di ripristinare.
- La cronologia delle versioni è condizionata nelle aree di lavoro che utilizzano l'esperienza della vetrina basata su checkpoint.
- Alcune schede di lavoro della conversazione completate mostrano anche un'etichetta di versione condizionata, un'anteprima di versione esatta e un'azione **Pubblica** per una versione corrente non pubblicata. Queste schede sono un accesso rapido; questa pagina rimane la visualizzazione completa di confronto e ripristino.
## Apri la cronologia delle versioni
Apri il negozio che vuoi esaminare e segui le indicazioni numerate qui sotto.
1. **Seleziona Vetrina nella barra laterale sinistra.** Si apre l’anteprima del negozio. Se la barra laterale mostra solo icone, espandila con il pulsante nell’angolo superiore sinistro.
2. **Fai clic sull’icona con orologio e freccia sopra l’anteprima, vicino all’angolo superiore destro.** È **Cronologia versioni**. Passa il cursore sull’icona per vederne il nome. Nell’esempio si trova subito a sinistra dell’indirizzo del sito pubblicato e di **Pubblica modifiche**.
3. **Verifica che il pannello Cronologia versioni si apra a destra.** La versione più recente appare sotto **Versione corrente**. Scorri verso il basso per vedere le versioni precedenti, se il negozio ne ha. Seleziona **Indietro** (la freccia sinistra accanto al titolo del pannello) per chiuderlo.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsx1z1nuaCeknAQbNKhZGRFM2xc5vsoiLrS9q)
Seleziona l’immagine per ingrandirla. Le schermate desktop annotate mostrano dove fare clic. Aprire la cronologia non ripristina né pubblica nulla. Un negozio con una sola versione registrata mostra soltanto **Versione corrente**.
**Su un telefono:** apri **Negozio online**, tocca **Altre azioni** (**…**) accanto al pulsante di pubblicazione in basso, quindi tocca **Cronologia versioni**.
Se non vedi il controllo della cronologia, esci da **Modalità Design** o torna prima all’anteprima più recente. Attendi che la compilazione iniziale sia terminata. La disponibilità può dipendere anche dall’esperienza di vetrina della tua area di lavoro.
### Esempio con una versione precedente
Confronta le etichette prima di scegliere. L'esempio apre solo la cronologia: non ripristina né pubblica versioni.
## Controlli della cronologia delle versioni
| Controllo | Perché lo usi | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Indietro** | Esci dall'elenco delle versioni. | Runner ritorna alla visualizzazione della vetrina. |
| Screenshot della versione | Ispeziona l'aspetto acquisito. | Lo screenshot si apre in un visualizzatore di immagini più grande quando disponibile. |
| **Visualizza differenze complete** | Vedi un record dettagliato di cosa è cambiato. | Runner apre i dettagli delle modifiche per quella versione in una nuova scheda. |
| **Anteprima** / **Visualizza anteprima di questa versione** | Rivedi una versione precedente pronta senza ripristinarla. | La vetrina passa a un'anteprima storica temporanea etichettata **Anteprima v…**. La versione del progetto più recente e il negozio live non cambiano. |
| **Torna alla versione più recente** / **Ritorna alla versione corrente** | Termina un'anteprima storica. | Runner ricarica la versione della vetrina corrente più recente. |
| **Ripristina** | Riutilizza il contenuto di una versione precedente. | Runner apre **Ripristina a v…?**. La conferma crea una nuova versione più recente con quel contenuto; la versione selezionata, le versioni più recenti e la cronologia rimangono. |
| **Altre azioni** | Accedi alle azioni della scheda su layout compatti. | Si apre un menu con le azioni disponibili per quella versione, come Anteprima, Ripristina o Visualizza differenze complete. |
| **Pubblica** sulla versione corrente | Inizia a pubblicare la versione più recente. | Runner apre i controlli di pubblicazione. Non pubblica direttamente un'anteprima storica. |
## Leggi le schede della versione
| Etichetta o stato | Significato |
| --- | --- |
| **Più recente** o **Versione corrente** | Questa è la versione del progetto più recente. |
| **Pubblicato** | Questa versione è associata a una pubblicazione completata. Non prova che il checkout funzioni ora. |
| **Creazione in corso…** | Runner sta ancora creando la versione. L'anteprima e il ripristino potrebbero non essere disponibili. |
| **Creazione non riuscita** | Questa versione non ha raggiunto uno stato pronto. Usa il suo contesto di errore per chiedere a Runner di risolvere. |
| Conteggi delle modifiche ai file | Un riepilogo dei file aggiunti, modificati o rimossi per quella versione. |
| Ora | Quando la versione è stata registrata. |
| Descrizione | Il riepilogo registrato della versione quando disponibile. |
## Visualizza in anteprima e ripristina in sicurezza
1. Seleziona **Anteprima** sulla versione che desideri ispezionare.
2. Conferma che la barra degli strumenti dice **Anteprima v…** in modo da non confonderla con la versione più recente.
3. Controlla il layout della pagina e del dispositivo pertinente.
4. Seleziona **Torna alla versione più recente** se hai solo bisogno di confrontare.
5. Per recuperare il contenuto precedente, seleziona **Ripristina**.
6. Leggi la conferma: Runner aggiungerà una nuova versione e manterrà la cronologia esistente.
7. Conferma il ripristino solo quando Runner è inattivo.
8. Verifica che compaia una nuova **Versione corrente**, poi controlla il contenuto ripristinato in Anteprima prima di pubblicare. La cronologia precedente deve restare disponibile.
## Stati, limiti e risoluzione dei problemi
| Cosa vedi | Significato | Cosa fare |
| --- | --- | --- |
| **Nessuna cronologia delle versioni ancora** | Esiste solo lo stato iniziale corrente o nessuna cronologia è disponibile. | Continua a lavorare; ritorna dopo che Runner registra un'altra versione. |
| **Caricamento cronologia versioni…** | Runner sta recuperando le schede. | Mantieni il pannello aperto fino al completamento. |
| **Non è stato possibile caricare le versioni: riprova.** | La richiesta dell'elenco non è riuscita. | Seleziona **Riprova**. |
| **Impossibile caricare l'anteprima per questa versione** | Quell'anteprima storica non potrebbe iniziare. | Ritorna alla versione corrente e prova un'altra versione pronta. |
| Il ripristino è disabilitato | Runner è attivo o la versione non è ripristinabile. | Attendi che Runner termini o seleziona una versione pronta. |
| **Impossibile ripristinare mentre l'agente sta lavorando** | Il ripristino entrerebbe in conflitto con l'attività attiva. | Lascia che l'attività raggiunga uno stato terminale, quindi riprova. |
| Il contenuto ripristinato non è live | Il ripristino ha creato una versione del progetto, non una pubblicazione. | Revisionalo, quindi seleziona **Pubblica modifiche**. |
## Guide correlate
- [Visualizza in anteprima il tuo negozio](./preview-your-store)
- [Pubblica e ripubblica](./publish-and-republish)
- [Risolvi i problemi di anteprima e pubblicazione](./troubleshoot-preview-and-publishing)
---
# Casi d’uso
Source: https://www.runnerai.com/docs/it/guides/use-cases
È la prima volta su Runner? Segui prima [Crea il tuo primo negozio](/it/guides/start-here/first-store-quickstart), poi scegli il risultato che ti serve.
## Esplora per obiettivo
- [Vetrina e pubblicazione](/it/guides/storefront-and-publishing)
Visualizza in anteprima, modifica, versiona, pubblica e verifica il tuo negozio Runner.
- [Operazioni del negozio](/it/guides/store-operations)
Configura e gestisci il catalogo, gli ordini, i clienti, le promozioni, il sourcing e le recensioni del tuo negozio.
- [App e integrazioni](/it/guides/apps-and-integrations)
Trova, connetti e gestisci i servizi che il tuo negozio Runner e l'Agent possono utilizzare.
- [Analisi e SEO](/it/guides/analytics-and-seo)
Leggi le prestazioni del negozio, diagnostica la conversione e migliora il modo in cui le persone e gli strumenti di ricerca AI trovano la tua vetrina.
- [Automatizza, testa e crea](/it/guides/automate-test-and-create)
Utilizza gli strumenti condizionali di Runner per lavori ricorrenti, test degli acquirenti, esperimenti, generazione di media e pubblicità.
- [Personalizzazione dell'agente](/it/guides/agent)
Aggiungi competenze riutilizzabili e memoria affidabile in modo che Runner possa lavorare in un modo che si adatta al tuo store.
---
# Lavora con Runner
Source: https://www.runnerai.com/docs/it/guides/work-with-runner
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Saprai dove avviare una richiesta, come guidare il lavoro e dove rivedere il risultato.
Usa questa sezione dopo aver aperto un progetto store. Runner mantiene la richiesta, il progresso,
l'anteprima e gli strumenti del progetto correlati insieme in modo che tu possa passare da un'idea a un risultato revisionabile.
**Percorso di accesso:** apri il negozio desiderato dal menu del nome → apri l'attività attuale o seleziona **Nuova attività**.
## Il ciclo quotidiano
1. Apri lo store che desideri modificare.
2. Avvia una **Nuova attività** quando serve una conversazione separata.
3. Descrivi un risultato chiaro nella casella di messaggio.
4. Aggiungi un'immagine di riferimento, scegli un profilo o aggiungi una competenza quando aiuterà.
5. Seleziona **Invia messaggio** e segui lo stato.
6. Rispondi a qualsiasi domanda Runner pone in modo che possa continuare con la scelta giusta.
7. Apri **Dettagli**, l'anteprima o un'altra scheda del canvas di lavoro per rivedere il risultato.
8. Invia una correzione mirata se serve. Termina verificando che l'azione del cliente richiesta funzioni nella pagina o nello strumento risultante.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Quando serve una decisione, rispondi alla scheda attiva prima di aspettarti altro lavoro. La [guida alle domande](/it/guides/work-with-runner/answer-runner-questions) include la registrazione corrispondente.
## Scegli una guida
| Cosa vuoi fare | Guida |
| --- | --- |
| Avvia una richiesta e comprendi il compositore | [Chatta con Runner](/it/guides/work-with-runner/chat-with-runner) |
| Riapri, rinomina o rimuovi una conversazione | [Chat e cronologia](/it/guides/work-with-runner/chats-and-history) |
| Trova uno strumento del progetto o una chat recente | [Navigazione del progetto e ricerca](/it/guides/work-with-runner/project-navigation-and-search) |
| Dai a Runner una direzione più chiara | [Scrivi richieste efficaci](/it/guides/work-with-runner/write-effective-requests) |
| Aggiungi contesto o cambia come Runner affronta un compito | [Immagini, modelli e competenze](/it/guides/work-with-runner/attachments-profiles-and-skills) |
| Rispondi quando Runner ha bisogno di una decisione | [Quando Runner pone una domanda](/it/guides/work-with-runner/answer-runner-questions) |
| Comprendi il progresso e ispeziona il lavoro completato | [Stati dei compiti e dettagli](/it/guides/work-with-runner/task-states-and-details) |
| Aggiungi rapidamente una competenza o memoria | [Tavolozza dei comandi Agent](/it/guides/agent/command-palette) |
## Prima di iniziare
- Devi essere connesso e avere accesso a un progetto store.
- Una chat appena creata è vuota finché non invii un messaggio.
- Alcuni strumenti, profili, competenze e destinazioni di navigazione sono condizionati. Runner mostra solo
ciò che è disponibile per l'account e il progetto correnti.
- La pubblicazione, la fatturazione e le azioni distruttive richiedono i loro percorsi di conferma. Un compito di chat completato non significa di per sé che uno store sia stato pubblicato o che un'azione esterna sia avvenuta.
## Guide correlate
- [Costruisci il tuo primo store](/it/guides/start-here/first-store-quickstart)
- [Gestisci gli store](/it/guides/workspace/manage-stores)
- [Comprendi gli stati dello store](/it/guides/workspace/store-statuses)
---
# Quando Runner pone una domanda
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/answer-runner-questions
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Risponderai o salterai intenzionalmente le domande di Runner senza perdere il contesto dell'attività.
Runner pone una domanda quando la tua decisione può cambiare materialmente il risultato. Le domande possono utilizzare una scelta singola, scelte multiple o una risposta in formato libero.
**Percorso di accesso:** Apri una conversazione il cui stato dell'attività è in attesa di input → scheda della domanda.
## Prima di iniziare
- Rispondi alla domanda più recente attiva; le schede precedenti possono essere di sola lettura.
- Rivedi attentamente l'effetto quando una scelta comporta accesso, denaro, pubblicazione, dati dei clienti o un servizio esterno.
- Usa **Salta** solo quando Runner può scegliere in sicurezza senza la tua preferenza.
## Controlli delle domande
| Controllo o stato | Cosa succede |
| --- | --- |
| Opzione a scelta singola | Seleziona la risposta e può passare alla domanda successiva. L'ultima scelta può inviare automaticamente le risposte. |
| Opzioni a scelta multipla | Ti consente di selezionare più di una risposta consentita. |
| **Altro…** | Apre un campo per una risposta non elencata. |
| Azione di invio o continuazione, se compare | Fa avanzare la scheda o invia le risposte complete. |
| **Salta**, quando offerto | Chiede a Runner di procedere secondo il proprio giudizio. |
| Scheda disabilitata | L'attività è occupata, scaduta, interrotta o la domanda non può più accettare una risposta. |
## Rispondi a una domanda
1. Leggi la domanda e qualsiasi spiegazione sopra le scelte.
2. Leggi ogni scelta prima di selezionarla: una scelta singola può avanzare subito e l'ultima risposta può essere inviata automaticamente.
3. Seleziona la scelta o le scelte che corrispondono alla tua intenzione.
4. Scegli **Altro…** e inserisci una risposta concisa quando nessuna delle scelte elencate si adatta.
5. Usa continua o invia solo se la scheda mostra l'azione.
6. Attendi mentre Runner consegna le risposte.
7. Conferma che Runner riprende l'attività e registra la tua risposta nella conversazione.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbhpPQzGPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Leggi ogni scelta prima di selezionarla; la risposta finale può essere inviata automaticamente.
### Guarda: rispondi alle domande di approfondimento
L'esempio sceglie un prezzo per le candele e uno stile fotografico. **Risposto** conferma le scelte, poi Runner riprende l'attività.
## Salta quando Runner può decidere
1. Leggi cosa sta chiedendo Runner.
2. Se la scheda offre **Salta**, selezionalo solo se accetti che Runner decida secondo il proprio giudizio.
3. Guarda l'attività riprendere.
4. Rivedi il risultato da vicino, perché non hai fornito la preferenza mancante.
Saltare è utile per scelte di presentazione a basso rischio. Dai una risposta esplicita quando la decisione influisce su accesso, denaro, pubblicazione, dati dei clienti o un'azione distruttiva.
## Risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| In attesa di input | Runner non può continuare con sicurezza senza una risposta. | Rispondi o salta intenzionalmente la domanda attiva. |
| La domanda precedente è di sola lettura | Un nuovo messaggio o stato dell'attività l'ha sostituita. | Rispondi invece alla domanda più recente attiva. |
| **L'utente ha interrotto questa domanda** | L'attività è stata interrotta prima del completamento della domanda. | Inizia un nuovo messaggio di follow-up se desideri ancora che Runner continui. |
| L'invio non è disponibile | Una o più risposte richieste sono incomplete o la scheda non è più attiva. | Completa ogni domanda corrente o passa alla scheda della domanda più recente. |
| Errore di risposta | Runner non ha potuto accettare la risposta. | La scheda può tornare allo stato senza risposta. Mantieni aperta la conversazione, controlla l'ultimo stato e rispondi ancora solo quando accetta input. |
## Guide correlate
- [Chat con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Scrivi richieste efficaci](/it/guides/work-with-runner/write-effective-requests)
- [Stati e dettagli dell'attività](/it/guides/work-with-runner/task-states-and-details)
---
# Allegati, modelli e competenze
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/attachments-profiles-and-skills
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Darai a Runner il contesto giusto e gli strumenti di lavoro prima di inviare una richiesta.
Le immagini mostrano a Runner cosa intendi. I modelli e le competenze cambiano le capacità disponibili per
la prossima richiesta. Quando compare **Allega**, puoi fornire anche documenti supportati come contesto. Usali con criterio: una richiesta chiara resta l'input più importante.
**Percorso di accesso:** Apri un progetto del negozio → compositore di conversazione.
## Prima di iniziare
- Usa solo immagini che sei autorizzato a condividere con l'area di lavoro corrente.
- Rimuovi segreti, dati di pagamento e informazioni cliente non necessarie.
- Verifica l'accesso al piano e al browser quando un modello, una Competenza o un'azione di acquisizione dello schermo manca.
## Controlli del compositore
| Controllo | Cosa succede quando lo selezioni |
| --- | --- |
| **Aggiungi** | Su desktop apre **Carica immagine** oppure **Allega** quando i documenti sono abilitati, più **Cattura schermata** se supportato. |
| **Allega**, se disponibile | Apre il selettore di documenti e immagini supportati. |
| **Carica immagine** | Apre il selettore di immagini per file JPG/JPEG, PNG, GIF, WebP, BMP o TIFF. |
| **Dalla libreria multimediale**, se disponibile | Apre media esistenti del progetto per scegliere un riferimento per la bozza. |
| **Cattura schermata** | Avvia l'acquisizione dello schermo quando il browser e l'account lo supportano. Il browser potrebbe chiedere il permesso. |
| **Immagine** su mobile | Apre il selettore di immagini mobile. Se i documenti sono abilitati, compare invece **Allega**. |
| Selettore modello | Elenca i modelli Runner disponibili per l'account. Un modello bloccato apre il percorso **Piano e Fatturazione** pertinente invece di selezionarlo. |
| **Comandi rapidi** o **Competenze** | Apre le scorciatoie disponibili che possono essere aggiunte alla richiesta. |
| **Altre azioni** | Rivela gli strumenti del compositore che non si adattano al layout corrente. |
Nel selettore di sole immagini, Runner ignora un'immagine con nome e dimensione uguali a una già in bozza e mostra
**Immagine duplicata ignorata**. I file non supportati vengono ignorati con **Usa un'immagine JPG, PNG, GIF, WebP, BMP,
o TIFF**. In una selezione mista restano disponibili le immagini supportate. Runner accetta fino a 10 allegati per messaggio. Ogni immagine può arrivare a 32 MB; se i documenti sono abilitati, ciascuno può arrivare a 10 MB.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
In questo spazio i documenti sono abilitati, quindi il menu mostra **Allega**. Aprirlo non carica file e non invia la richiesta.
## Aggiungi un'immagine
1. Scrivi abbastanza della richiesta per spiegare perché il file è importante.
2. Seleziona **Aggiungi** su desktop, o il pulsante di caricamento su mobile.
3. Scegli **Carica immagine**, **Immagine** o **Cattura schermata**, a seconda di cosa è mostrato.
4. Scegli o acquisisci l'immagine pertinente.
5. Verifica che la miniatura corretta compaia nella bozza e che il caricamento sia terminato.
6. Rimuovila prima di inviare se è il riferimento sbagliato.
7. Seleziona **Invia messaggio**.
Se l'acquisizione dello schermo non è disponibile o il permesso è negato, acquisisci uno screenshot con il tuo dispositivo e
carica l'immagine salvata invece.
## Allega un documento quando disponibile
1. Apri **Aggiungi** e seleziona **Allega**. Se compare solo **Carica immagine** o **Immagine**, questo spazio non supporta documenti nel compositore.
2. Scegli un file supportato, come PDF, documento Word, presentazione, foglio di calcolo o CSV.
3. Verifica che l'allegato compaia accanto alla bozza.
4. Spiega cosa usare, ad esempio «Usa nomi e descrizioni dei prodotti in questo CSV per preparare i testi delle collezioni; non cambiare i prezzi».
5. Seleziona **Invia messaggio** e attendi la preparazione del documento.
6. Verifica che la risposta rifletta il documento desiderato prima di chiedere modifiche al negozio.
Se il file non è leggibile, segui l'errore mostrato. Documenti protetti da password, danneggiati, troppo complessi o vuoti possono fallire. Usa un'esportazione sbloccata e più piccola o incolla il testo pertinente; conserva la bozza finché il sostituto viene accettato. Questo flusso non supporta video.
## Scegli un modello
1. Seleziona il modello corrente nel compositore.
2. Esamina i modelli disponibili. L'interfaccia registrata mostra **Runner 2.0 Pro**; usa l'etichetta nel tuo selettore perché i profili possono cambiare.
3. Scegli il modello che corrisponde al compito.
4. Conferma che il modello selezionato sia mostrato prima di inviare.
Se un modello è bloccato, mantieni il modello corrente o segui il percorso di informazioni sul piano che Runner apre. Una
scelta bloccata non viene applicata alla bozza.
## Aggiungi una competenza
1. Apri **Comandi rapidi** o **Competenze** nel compositore, quando disponibili.
2. Cerca o sfoglia la capacità di cui hai bisogno.
3. Seleziona una [competenza disponibile](/it/guides/agent/create-import-manage-skills). **Comandi rapidi** può inserire un comando slash nel compositore, come `/store-seo`: selezionarlo non lo esegue.
4. Torna al compositore e verifica la presenza della competenza o del comando desiderato. Aggiungi le istruzioni specifiche prima di inviare.
5. Invia la richiesta.
La [tavolozza dei comandi dell'Agente](../agent/command-palette) separata gestisce lo stato delle funzionalità: scegliere una riga può installare, attivare o sospendere una competenza. Non equivale a selezionarla nel compositore.
Quando il piano corrente non include una competenza, Runner può aprire il percorso **Agente** o di aggiornamento
invece. Le scelte di memoria appaiono solo quando la memoria è abilitata per l'account.
Selezionare un comando prepara la bozza. Aggiungi la richiesta e controllala prima dell'invio.
### Guarda: prepara un comando rapido
La registrazione seleziona **store-seo** nel compositore e lo lascia non inviato. Non avvia analisi SEO.
## Risoluzione dei problemi
| Problema | Cosa fare |
| --- | --- |
| L'immagine non viene aggiunta | Usa un formato di immagine supportato, mantienila sotto 32 MB e mantieni il messaggio a 10 immagini o meno. |
| **Immagine duplicata ignorata** | La stessa immagine con lo stesso nome e dimensione è già nella bozza. Mantieni la copia esistente o rimuovila prima di selezionare di nuovo l'immagine. |
| Avviso di file non supportato | Scegli JPG/JPEG, PNG, GIF, WebP, BMP o TIFF. Se **Allega** è disponibile, puoi scegliere un documento supportato; altrimenti usa un'immagine o incolla il testo pertinente. |
| **Cattura schermata** manca | Usa un'immagine salvata; l'acquisizione diretta è disponibile solo in determinate condizioni. |
| L'acquisizione dello schermo si interrompe | Consenti il permesso del browser quando appropriato, o allega uno screenshot normale. |
| Una competenza non si attiva/disattiva | Termina qualsiasi azione del compositore in conflitto e conferma che il piano include la competenza. |
| Un modello bloccato apre la fatturazione | Chiudi la schermata del piano per mantenere il modello corrente, o rivedi l'accesso con il proprietario dell'area di lavoro. |
## Guide correlate
- [Scrivi richieste efficaci](/it/guides/work-with-runner/write-effective-requests)
- [Tavolozza dei comandi Agent](../agent/command-palette)
- [Chatta con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Impostazioni dell'area di lavoro](/it/guides/workspace/settings)
---
# Chatta con Runner
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/chat-with-runner
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Invierai una richiesta mirata nel progetto store giusto e saprai cosa fa ogni controllo della chat.
La chat è il posto principale per chiedere a Runner di costruire, modificare, ispezionare o spiegare qualcosa del tuo
store. Mantieni un risultato principale in ogni richiesta in modo che il risultato sia più facile da rivedere.
**Percorso di accesso:** apri il negozio desiderato dal menu del nome → usa l'attività attuale oppure **Nuova attività** nella barra laterale.
## Prima di iniziare
- Conferma lo store e la conversazione prima di inviare una richiesta.
- Mantieni un risultato principale nella bozza e rimuovi segreti o dati cliente non necessari.
- Attendi la fine di un'azione in conflitto nel compositore prima di selezionare **Invia messaggio**.
## Controlli della chat
| Controllo | Perché è utile | Cosa succede quando lo selezioni |
| --- | --- | --- |
| **Nuova attività** | Separa un lavoro dalla discussione precedente. | Runner crea e apre una conversazione vuota. Il lavoro parte solo quando invii un messaggio. |
| Casella di messaggio | Contiene la richiesta e qualsiasi istruzione di follow-up. | Il tuo testo rimane come bozza finché non lo invii. |
| **Aggiungi** | Fornisce contesto visivo. | Apre **Carica immagine** oppure **Allega** se i documenti sono abilitati. **Cattura schermata** è condizionato. Su mobile, il selettore di sole immagini si chiama **Immagine**. Consulta la guida agli allegati per formati e limiti. |
| Selettore profilo | Cambia il profilo di lavoro Runner disponibile. | Il profilo selezionato viene utilizzato per la richiesta successiva; le scelte bloccate aprono il percorso del piano pertinente. |
| **Input vocale** | Trasforma il discorso in testo di bozza. | Richiede l'accesso al microfono, mostra **In ascolto…**, quindi **Elaborazione in corso…**, e aggiunge la trascrizione alla bozza corrente. Non invia la richiesta. |
| **Altre azioni** | Mantiene gli strumenti meno frequentemente utilizzati disponibili su layout più piccoli. | Apre azioni come **Input vocale** o **Migliora prompt** quando non si adattano alla barra degli strumenti. |
| **Invia messaggio** | Avvia la richiesta. | Il messaggio viene aggiunto alla conversazione e l'attività inizia. |
| **Interrompi** | Interrompe un compito in esecuzione. | Runner interrompe il turno corrente e preserva la conversazione in modo che tu possa rivedere o continuare in seguito. |
| **Utile** / **Non utile** | Fornisci un feedback su una risposta di Runner. | Apre un feedback modificabile. **Non utile** richiede un motivo o una descrizione. Nulla viene salvato fino a **Invia**; la condivisione del contesto della conversazione è facoltativa. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Usa **Aggiungi** quando serve un riferimento. Il menu mostrato è aperto prima di caricare file o inviare messaggi.
## Invia una richiesta
1. Conferma che il nome del progetto nella barra laterale o nell'intestazione sia lo store che intendi modificare.
2. Scegli **Nuova attività** se la richiesta è separata dalla conversazione attuale.
3. Inserisci il risultato che desideri nella casella di messaggio.
4. Aggiungi contesto importante, vincoli e immagini di riferimento.
5. Seleziona un profilo o una competenza solo quando aiuta questo compito.
6. Seleziona **Invia messaggio**.
7. Mantieni la conversazione aperta mentre Runner lavora, o ritorna ad essa da **Chat Recenti** in seguito.
8. Se Runner pone una domanda, rispondi per far continuare il compito.
9. Al termine, apri la pagina o lo strumento interessato e controlla il risultato richiesto. Il messaggio finale da solo non lo verifica.
## Scrivi con input vocale
1. Seleziona **Input vocale**. Se il browser chiede, consenti l'accesso al microfono solo su un dispositivo affidabile.
2. Attendi **In ascolto…**, quindi pronuncia un'istruzione mirata.
3. Seleziona **Interrompi input vocale** quando hai finito.
4. Mantieni il compositore aperto mentre Runner mostra **Elaborazione in corso…**.
5. Rivedi il testo aggiunto alla bozza. Runner lo aggiunge dopo il testo già presente.
6. Correggi nomi, numeri, URL e dettagli dei prodotti prima di **Invia messaggio**.
L'input vocale prepara solo testo. La richiesta parte soltanto dopo **Invia messaggio**.
## Mentre Runner sta lavorando
- Un compito in esecuzione mostra il progresso attivo nella conversazione.
- **Dettagli** apre il record del compito passo dopo passo quando è disponibile.
- **Interrompi** è disponibile durante il lavoro che può essere interrotto.
- L'anteprima o altre schede del canvas possono aggiornarsi mentre Runner produce risultati.
- Un compito in attesa di input ha bisogno della tua risposta prima che Runner possa procedere con sicurezza.
## Risoluzione dei problemi
| Cosa vedi | Cosa significa | Cosa fare |
| --- | --- | --- |
| **Invia messaggio** non disponibile | La bozza è vuota, mancano dati obbligatori o un'altra azione è in preparazione. | Aggiungi una richiesta chiara e attendi la fine dell'azione attuale. |
| Un profilo è bloccato | Non è incluso nel piano corrente o nell'accesso all'account. | Mantieni il profilo corrente o segui il percorso **Piano e Fatturazione** che Runner apre. |
| **Input vocale non disponibile** | Il browser o il dispositivo non può registrare attraverso questo controllo. | Digita la richiesta o usa un browser e un dispositivo supportati. |
| Permesso del microfono negato | Il browser ha bloccato la registrazione. | Consenti l'accesso solo se appropriato, quindi avvia di nuovo l'input vocale; altrimenti digita la richiesta. |
| **Nessun discorso rilevato** o trascrizione non riuscita | Runner non ha aggiunto testo utilizzabile alla bozza. | Mantieni la bozza esistente, controlla il microfono e riprova una volta o digita il testo mancante. |
| Attività in attesa | Runner richiede una decisione o altre informazioni. | Rispondi alla domanda oppure scegli **Salta**, se offerto, quando accetti il suo giudizio. |
| Il compito non è riuscito | Runner non ha potuto completare il turno. | Leggi l'errore e **Dettagli**, quindi usa **Riprova** quando offerto o invia una richiesta più ristretta. |
| Hai aperto lo store sbagliato | La conversazione appartiene a un altro progetto. | Torna all'area di lavoro, apri lo store desiderato e avvia la richiesta lì. |
## Guide correlate
- [Scrivi richieste efficaci](/it/guides/work-with-runner/write-effective-requests)
- [Immagini, modelli e competenze](/it/guides/work-with-runner/attachments-profiles-and-skills)
- [Quando Runner pone una domanda](/it/guides/work-with-runner/answer-runner-questions)
- [Stati dei compiti e dettagli](/it/guides/work-with-runner/task-states-and-details)
---
# Chat e cronologia
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/chats-and-history
**Cosa copre questa guida:** Manterrai le conversazioni del progetto organizzate e riaprirai il contesto giusto quando ne hai bisogno.
Ogni negozio ha la sua cronologia di conversazione. Usa chat separate per risultati distinti e mantieni il lavoro di follow-up nella stessa chat quando dipende da decisioni precedenti.
**Percorso di accesso:** apri un negozio → espandi la cronologia delle attività nella barra laterale. L'elenco può chiamarsi **Attività del negozio** o **Chat recenti**. Ricerca mantiene l'intestazione **Chat recenti**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Cerca nel tuo negozio; 2. Avvia una nuova attività; 3. Apri uno strumento del workspace; 4. Riapri un’attività salvata. Seleziona l’immagine per ingrandirla. Le indicazioni numerate si riferiscono all’interfaccia desktop in inglese.
## Prima di iniziare
- Conferma il negozio corrente perché ogni progetto ha la sua cronologia di conversazione.
- Lascia che un'azione di rinomina o attività attiva termini prima di cambiare conversazioni.
- Mantieni una chat quando sei incerto; l'eliminazione rimuove il contesto e richiede una conferma.
## Controlli della conversazione
| Controllo o stato | Cosa succede |
| --- | --- |
| **Nuova attività** | Apre una conversazione vuota. Il lavoro parte solo dopo l'invio di un messaggio. |
| Riga nella cronologia del negozio | Apre la conversazione e la cronologia salvata. |
| Spinner di attività | Indica che la conversazione ha attualmente lavoro in corso. |
| Punto inattivo | Indica che la conversazione non è attualmente in esecuzione. |
| Opzioni della chat → **Rinomina** | Apre una finestra di dialogo in cui puoi inserire e salvare un nome di chat più chiaro. |
| Opzioni della chat → **Elimina** | Apre una conferma prima che la conversazione venga rimossa. |
## Avvia o riapri una chat
1. Apri il progetto di negozio corretto.
2. Espandi la barra laterale e apri l'elenco delle attività del negozio, se compare.
3. Scegli **Nuova attività** per un lavoro separato oppure una chat esistente per continuarne il contesto.
4. Rivedi il titolo della conversazione e i messaggi più recenti prima di inviare nuove istruzioni.
5. Controlla che i messaggi riaperti appartengano all'attività desiderata. Inserisci la richiesta successiva e seleziona **Invia messaggio**.
## Rinomina una chat
1. Trova la conversazione nella cronologia del negozio attuale.
2. Apri il suo menu di opzioni.
3. Scegli **Rinomina**.
4. Inserisci un nome che descriva il risultato, come "Aggiorna la homepage della collezione estiva".
5. Salva la modifica. Il nuovo nome appare nell'elenco delle chat recenti.
## Elimina una chat con attenzione
1. Apri il menu di opzioni della conversazione.
2. Scegli **Elimina**.
3. Leggi la conferma e verifica il nome della chat.
4. Annulla se hai ancora bisogno delle sue istruzioni o risultati. Conferma solo quando intendi rimuoverla.
## Risoluzione dei problemi
| Stato | Cosa fare |
| --- | --- |
| Cronologia vuota o assente | Invia una richiesta in una nuova chat. La sezione compare quando il progetto ha una cronologia di conversazioni. |
| Una chat in esecuzione non si apre istantaneamente | Attendi che la navigazione termini; Runner potrebbe proteggere il lavoro non terminato prima di cambiare visualizzazioni. |
| Non riesci a trovare una chat scansionando l'elenco | Apri la ricerca del progetto con `Command/Control + K` e cerca **Chat recenti**. |
| Un titolo rinominato non si è aggiornato | Riapri l'elenco delle chat e prova di nuovo la rinomina una volta che lo stato dell'attività corrente si stabilizza. |
| Non sei sicuro se eliminare | Mantieni la chat. Rinominarla è il modo più sicuro per ridurre la confusione. |
## Guide correlate
- [Chat con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Navigazione e ricerca del progetto](/it/guides/work-with-runner/project-navigation-and-search)
- [Stati e dettagli dell'attività](/it/guides/work-with-runner/task-states-and-details)
---
# Navigazione e ricerca nel progetto
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/project-navigation-and-search
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
La barra laterale raggruppa gli strumenti in base al lavoro. Ricerca trova una destinazione disponibile o una conversazione nel negozio attuale.
**Percorso di accesso:** apri il negozio desiderato → espandi la barra laterale → **Crea**, **Cresci**, **Misura** o **Cerca**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Cerca nel tuo negozio; 2. Avvia una nuova attività; 3. Apri uno strumento del workspace; 4. Riapri un’attività salvata. Seleziona l’immagine per ingrandirla. Le indicazioni numerate si riferiscono all’interfaccia desktop in inglese.
## Prima di iniziare
- Controlla il nome del negozio prima di navigare o avviare un'attività.
- Conserva una copia della bozza non inviata prima di lasciare la conversazione.
- Gli strumenti variano con tipo di negozio, piano, ruolo e funzioni abilitate. Una voce visibile può comunque aprire un prerequisito o una schermata del piano.
## Trova una destinazione
| Area | Destinazioni disponibili possibili | Utilizzo |
| --- | --- | --- |
| **Negozio online** | Anteprima, modifica, cronologia versioni, pubblicazione | Esamina e aggiorna ciò che vedono i clienti. |
| **Crea** | **Operazioni negozio**, **Dropshipping**, **Stampa su richiesta**, **App**, **Webhook** | Configura negozio, catalogo e connessioni. |
| **Cresci** | **Annunci**, **SEO**, **Email**, **Automazioni**, **Studio**, **Libreria** | Crea e gestisci attività di crescita e media riutilizzabili. |
| **Misura** | **Analytics**, **Esperimenti**, **Simulazione**, **Cerca** | Esamina prestazioni o approfondisci una domanda aziendale. |
| **Agente** | **Competenze**, **Memoria** quando abilitata | Gestisci istruzioni riutilizzabili e fatti conservati. |
| **Fly**, se compare | Missioni aziendali guidate | Segui la procedura disponibile. |
1. Espandi il gruppo corrispondente all'obiettivo.
2. Seleziona la destinazione.
3. Controlla intestazione della pagina e negozio attuale.
4. Segui ogni avviso di configurazione o piano prima di usare la funzione.
Ad esempio, **Dropshipping** può aprire un'esperienza di approvvigionamento dedicata o la sezione Operazioni del negozio correlata, a seconda del negozio. Segui la pagina che vedi effettivamente. La navigazione raggruppata sostituisce il vecchio menu di overflow **Altro**.
## Cerca destinazioni e attività
**Scorciatoia:** `Command + K` su macOS o `Control + K` su Windows e Linux.
1. Seleziona **Cerca** o usa la scorciatoia.
2. Inserisci parte del titolo di una destinazione o attività.
3. Rivedi i risultati sotto **Centro di controllo** e **Chat recenti**.
4. Seleziona un risultato del **Centro di controllo** per aprire uno strumento, o un risultato delle **Chat recenti** per riaprire una conversazione.
5. Conferma che la pagina o i messaggi desiderati siano visibili prima di continuare.
6. Premi `Escape` per chiudere Cerca senza navigare.
L'intestazione **Centro di controllo** appartiene ai risultati di Cerca; non è un'area separata della barra laterale che devi trovare.
## Passa a un altro negozio
1. Apri il menu del nome del negozio corrente in cima alla barra laterale.
2. Seleziona il negozio desiderato.
3. Conferma il nuovo nome del negozio dopo la navigazione.
Il menu offre anche **Crea negozio** e **Impostazioni del workspace**. Non visualizza in anteprima l'elenco dei negozi di un altro workspace. Vedi [Navigazione Workspace](/it/guides/workspace/navigation-and-search) per le impostazioni e la navigazione dell'account.
Cerca mostra le destinazioni disponibili sotto **Centro di controllo**. Seleziona un risultato per navigare, o premi Escape per mantenere la pagina corrente.
### Guarda: filtra la ricerca di navigazione
La registrazione tipizza **Analisi** e ispeziona la destinazione corrispondente. Si ferma prima di aprire il risultato; seleziona un risultato tu stesso per navigare.
## Risoluzione dei problemi
| Cosa vedi | Cosa fare |
| --- | --- |
| Caricamento risultati | Attendi che Cerca finisca di caricare prima di selezionare una riga. |
| **Nessun risultato** | Accorcia la query o usa il nome visibile dello strumento. Cancella la query per ispezionare i risultati disponibili. |
| **Cerca non riuscita** | Seleziona **Riprova** quando mostrato. |
| Lo strumento è assente dal suo gruppo | Controlla Cerca, poi leggi i prerequisiti di quella funzione. La disponibilità può variare a seconda del negozio. |
| La navigazione si interrompe | Mantieni aperta l'attività e segui qualsiasi messaggio riguardante il lavoro non completato. |
| Si apre invece un selettore di abilità | Chiudilo e usa la barra laterale **Cerca**. La [palette comandi Agente](/it/guides/agent/command-palette) gestisce le capacità piuttosto che la navigazione. |
## Guide correlate
- [Chat e cronologia](/it/guides/work-with-runner/chats-and-history)
- [Navigazione e ricerca dell'area di lavoro](/it/guides/workspace/navigation-and-search)
- [Palette comandi Agente](/it/guides/agent/command-palette)
- [Chatta con Runner](/it/guides/work-with-runner/chat-with-runner)
---
# Stati dei Compiti e Dettagli
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/task-states-and-details
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Saprai se un compito sta funzionando, è in attesa, è finito, è stato interrotto o ha bisogno di un altro tentativo.
Gli stati dei compiti ti dicono di cosa ha bisogno Runner in seguito. La vista dettagli e il canvas del progetto ti aiutano a rivedere
il lavoro senza indovinare dal solo ultimo messaggio della chat.
**Percorso di accesso:** Apri un progetto del negozio → seleziona una conversazione → ispeziona la scheda del compito corrente e
scegli **Dettagli** quando disponibile.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgDROEIVBmoeRbFHcSPrynU5Il76xY2q981Nj4)
1. Controlla lo stato del compito. 2. Seleziona Dettagli per esaminare il lavoro. Questa scheda di esempio mostra un compito completato; il completamento da solo non dimostra che il negozio sia pubblicato o che il checkout funzioni. Seleziona l’immagine per ingrandirla.
## Prima di iniziare
- Conferma la conversazione corrente e il compito più recente prima di agire su uno stato.
- Mantieni l'errore visibile o la domanda in attesa disponibile finché il recupero non ha successo.
- Non trattare un compito completato come prova che Anteprima, pubblicazione o un provider esterno abbiano avuto successo.
## Stati dei compiti
| Stato | Significato | Cosa fare dopo |
| --- | --- | --- |
| In esecuzione | Runner sta attivamente lavorando sulla richiesta. | Segui il progresso, apri **Dettagli** o scegli **Interrompi** se il compito non dovrebbe continuare. |
| In attesa di input | Runner ha bisogno della tua scelta o di informazioni mancanti. | Rispondi alla domanda attiva o scegli **Salta**, quando offerto, in modo che Runner possa usare il suo miglior giudizio. |
| Completato | Runner ha finito il turno corrente. | Rivedi il messaggio, i dettagli, l'anteprima e qualsiasi area del progetto modificata. |
| Non riuscito | Runner non ha potuto finire il turno. | Leggi l'errore e i dettagli, quindi scegli **Riprova** quando offerto o invia una richiesta più ristretta. |
| Interrotto | Tu o Runner avete interrotto il turno. | Rivedi il lavoro parziale, quindi invia una nuova istruzione se il compito dovrebbe continuare. |
Un compito completato significa che il turno della conversazione è terminato con successo. Non prova di per sé
che uno store sia stato pubblicato, che un pagamento sia avvenuto o che un servizio esterno abbia accettato una modifica.
## Rivedi il lavoro
1. Seleziona **Dettagli** sul compito.
2. Segui le voci passo dopo passo per capire cosa Runner ha tentato.
3. Apri **Utilizzo** quando mostrato per rivedere i crediti visualizzati, le chiamate di strumenti e l'attività dell'agente.
4. Rivedi il piano di lavoro quando il compito ne include uno.
5. Usa **Anteprima** o **Negozio** per ispezionare il risultato rivolto al cliente.
6. Apri altre schede del canvas pertinenti, come un file o un risultato che Runner ha evidenziato.
7. Usa **Aggiungi scheda** per aprire un'altra vista disponibile e **Chiudi scheda** per rimuovere una vista dal canvas.
8. Rivedi **Cronologia versioni** quando hai bisogno di confrontare o individuare uno stato del progetto precedente.
9. Confronta la pagina effettiva o il risultato dello strumento con il risultato richiesto. Invia un seguito mirato che nomini qualsiasi problema rimanente.
Apri solo le viste delle attività che Runner offre effettivamente. I dettagli disponibili e le viste canvas variano con la richiesta.
## Rivedi una versione del negozio da una scheda di lavoro completata
> **Condizionale:** Le etichette di versione e le anteprime storiche richiedono versioni di vetrina salvate e accesso alle schede di versione. I progetti più vecchi senza cronologia delle versioni salvata possono ancora mostrare **Anteprima** sulla scheda di lavoro della vetrina più recente; quell'azione apre l'anteprima live corrente piuttosto che una versione storica esatta. Se non appare alcuna azione sulla scheda di lavoro, apri direttamente [Anteprima](/it/guides/storefront-and-publishing/preview-your-store).
| Controllo o stato | Cosa significa o fa |
| --- | --- |
| **v…** | Identifica la versione del negozio mostrata sulla scheda di lavoro completata. |
| **Versione corrente** | Contrassegna la versione più recente del progetto. |
| **Pubblicato** | Contrassegna una versione associata a una pubblicazione completata; non prova che il checkout funzioni ancora. |
| **Compilazione in corso…** | La versione non è ancora pronta per l'anteprima. |
| **Compilazione non riuscita** | La versione non ha potuto raggiungere uno stato pronto per l'anteprima. Apri **Dettagli** e mantieni qualsiasi contesto di errore visibile prima di chiedere a Runner di risolverlo. |
| Immagine della vetrina o **Anteprima** | Apre la versione pronta esatta quando i dati della versione esistono. Sulla scheda più recente di un progetto più vecchio senza cronologia delle versioni, apre invece l'anteprima live della vetrina corrente. Le schede non abbinate più vecchie non mostrano **Anteprima**. |
| **Pubblica** | Appare solo per una versione corrente non pubblicata e apre i controlli di pubblicazione. Non è mostrato per una versione storica o già pubblicata. |
| Le informazioni sulla versione si stanno aggiornando | I controlli dell'immagine della vetrina, di **Anteprima** e di **Pubblica** per la versione corrente rimangono al loro posto, ma sono temporaneamente disabilitati. Se li selezioni, non accade nulla finché l'aggiornamento non termina. |
Usa l'etichetta di versione prima di giudicare uno screenshot o selezionare **Pubblica**. Un'anteprima storica pronta è ancora di sola lettura finché non ripristini o pubblichi deliberatamente una versione corrente attraverso il flusso disponibile.
Usa le etichette di versione per distinguere il risultato corrente dal lavoro precedente. Questa immagine mostra la Cronologia delle versioni, non il pannello Dettagli dell'attività, e nessuna versione è stata ripristinata o pubblicata.
## Controlli della conversazione
| Controllo | Cosa succede |
| --- | --- |
| **Dettagli** / **Nascondi Dettagli** | Apre il record del compito passo dopo passo nel canvas, o restituisce il canvas a **Negozio**. Nasconderlo non rimuove il record del compito. |
| **Riprova** | Avvia un altro tentativo per un compito non riuscito quando l'azione è offerta. |
| **Vai al messaggio più recente** | Sposta la conversazione alla voce più nuova. |
| Contorno della trascrizione | Ti permette di spostarti a una sezione visibile di un record di compito più lungo. |
| **Anteprima** o **Negozio** | Apre la vista di lavoro rivolta al cliente del progetto. |
| **Aggiungi scheda** | Apre l'elenco delle viste del canvas disponibili per questo progetto e compito. |
| **Chiudi scheda** | Rimuove la vista selezionata dal canvas; non elimina il contenuto del progetto sottostante. |
## Se il progresso sembra bloccato
- Verifica se una domanda senza risposta è in attesa più in basso nella conversazione.
- Apri **Dettagli** per identificare l'ultimo passaggio completato.
- Usa **Vai al messaggio più recente** se hai fatto scorrere la conversazione lontano dallo stato attivo.
- Non selezionare ripetutamente **Riprova** mentre un altro tentativo è già in esecuzione.
- Se interrompi un compito, rivedi i risultati parziali prima di chiedere a Runner di continuare.
## Guide correlate
- [Quando Runner pone una domanda](/it/guides/work-with-runner/answer-runner-questions)
- [Chatta con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Chat e cronologia](/it/guides/work-with-runner/chats-and-history)
- [Comprendi gli stati del negozio](/it/guides/workspace/store-statuses)
- [Cronologia versioni](/it/guides/storefront-and-publishing/version-history)
---
# Scrivi Richieste Efficaci
Source: https://www.runnerai.com/docs/it/guides/work-with-runner/write-effective-requests
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Scriverai richieste che sono più facili per Runner da agire e più facili per te da rivedere.
Una richiesta utile descrive il risultato, non solo l'argomento. Fornisci abbastanza contesto per rendere la prossima
decisione chiara, quindi usa i messaggi di follow-up per affinamenti mirati.
**Percorso di ingresso:** Apri un negozio → **Nuova attività** o l'attività corrente → casella dei messaggi.
## Prima di iniziare
- Conferma lo store e la pagina o il flusso di lavoro che desideri modificare.
- Decidi un risultato visibile e qualsiasi confine che Runner deve preservare.
- Rimuovi password, segreti, dettagli di pagamento e dati cliente non necessari.
## Controlli del compositore e risultati
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Altre azioni** | Apre gli strumenti del compositore meno frequentemente utilizzati quando non si adattano alla barra degli strumenti. |
| **Migliora prompt** | Genera una bozza raffinata; non invia la richiesta o cambia lo store. |
| **Accetta** | Sostituisce la bozza del compositore con il raffinamento visualizzato. |
| **Scarta** | Chiude il raffinamento e mantiene la bozza esistente. |
| **Rigenera** | Richiede un'altra versione raffinata. |
| **Ripristina originale** | Ripristina la formulazione precedente dopo un raffinamento accettato. |
| **Invia messaggio** | Aggiunge la bozza finale alla conversazione e avvia l'attività. |
## Una struttura di richiesta semplice
Includi questi cinque parti quando importano:
1. **Obiettivo:** Cosa dovrebbe essere diverso quando il lavoro è finito?
2. **Contesto dello store:** Cosa vendi e chi è il cliente?
3. **Problema attuale:** Cosa è confuso, mancante o sottoperformante ora?
4. **Risultato desiderato:** Cosa dovrebbe un cliente essere in grado di vedere o fare?
5. **Confini:** Cosa deve rimanere invariato e cosa dovrebbe Runner verificare?
**Per esempio:**
> Aggiorna l'eroe della homepage per il nostro negozio minimalista di borse da viaggio. Rendi la collezione carry-on il focus principale, mantieni la navigazione e i dati dei prodotti esistenti e fai in modo che l'azione principale porti a quella collezione. Controlla il risultato su mobile e desktop prima di finire.
## Invia una richiesta ben definita
1. Inizia con un risultato coerente.
2. Nomina la pagina, la sezione, il prodotto o il flusso di lavoro coinvolto.
3. Descrivi l'azione del cliente che desideri migliorare.
4. Aggiungi un'immagine di riferimento quando l'aspetto o il contenuto esistente importa.
5. Dichiara qualsiasi cosa Runner non deve cambiare.
6. Chiedi i controlli che ti interessano, come il layout mobile o un percorso di clic specifico.
7. Seleziona **Invia messaggio**.
8. Rivedi il risultato, quindi invia una correzione mirata alla volta.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Controlla il risultato rispetto alla tua richiesta: l'esempio chiede un titolo per una mattinata più lenta mantenendo il layout e i prodotti. Questa immagine mostra l'anteprima risultante, non il dialogo **Migliora il prompt**.
## Usa Migliora prompt quando disponibile
1. Scrivi la richiesta nella casella di messaggio.
2. Apri **Altre azioni** se **Migliora prompt** non è visibile.
3. Seleziona **Migliora prompt**.
4. Attendi mentre il controllo mostra **Miglioramento in corso…**.
5. Rivedi il **Prompt raffinato**. Controlla che preservi la pagina desiderata, l'azione del cliente e qualsiasi cosa tu abbia chiesto a Runner di lasciare invariata.
6. Scegli **Accetta** per usarlo, **Scarta** per mantenere la tua bozza, o **Rigenera** per un'altra versione.
7. Usa **Ripristina originale** se hai accettato il raffinamento e desideri la tua formulazione precedente.
8. Seleziona **Invia messaggio** solo dopo che la richiesta corrisponde ancora alla tua intenzione.
## Evita richieste ambigue
| Invece di | Prova |
| --- | --- |
| "Rendilo migliore." | "Rendi le schede della collezione più facili da scansionare su mobile, mantenendo i loro link ai prodotti attuali." |
| "Ripara il checkout." | "Traccia il percorso Aggiungi al carrello → Carrello → Checkout e dimmi dove si ferma prima di cambiare qualcosa." |
| "Copia questo sito." | "Usa questo come riferimento per la spaziatura e il tono, ma mantieni il nostro branding, i prodotti e la navigazione." |
| Un lungo elenco di modifiche non correlate | Avvia una chat per il risultato principale, quindi creane un'altra per il lavoro separato. |
## Recupero quando il risultato manca l'obiettivo
- Indica la parte esatta che è sbagliata.
- Descrivi il risultato del clic previsto o lo stato visibile.
- Aggiungi un'immagine di riferimento più chiara se quella precedente era poco chiara.
- Rispondi alle domande di Runner piuttosto che ripetere la richiesta completa.
- Per un compito non riuscito, leggi **Dettagli** prima di scegliere **Riprova**.
## Guide correlate
- [Chatta con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Immagini, modelli e competenze](/it/guides/work-with-runner/attachments-profiles-and-skills)
- [Quando Runner pone una domanda](/it/guides/work-with-runner/answer-runner-questions)
- [Stati dei compiti e dettagli](/it/guides/work-with-runner/task-states-and-details)
---
# Area di lavoro
Source: https://www.runnerai.com/docs/it/guides/workspace
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Un workspace raggruppa negozi e compagni di squadra. Dopo l'accesso, Runner può aprire direttamente il tuo negozio attuale. Controlla il suo nome prima di chiedere a Runner di cambiare qualcosa.
**Percorso di ingresso:** Accedi → negozio attuale → menu del nome del negozio o **Impostazioni del workspace**.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Inizia con il menu del nome del negozio per confermare dove stai lavorando.
## Scegli il tuo prossimo compito
| Cosa ti serve | Guida |
| --- | --- |
| Cambia negozi, crea un altro negozio o rivedi l'eliminazione | [Gestisci negozi](/it/guides/workspace/manage-stores) |
| Comprendi **In tempo reale** e **Bozza non pubblicata** | [Stati del negozio](/it/guides/workspace/store-statuses) |
| Trova uno strumento, un compito o un'area delle impostazioni | [Navigazione e ricerca](/it/guides/workspace/navigation-and-search) |
| Aggiungi un compagno di squadra o modifica l'accesso dei membri | [Membri e inviti](/it/guides/workspace/members-and-invitations) |
| Condividi un referral senza concedere l'accesso al workspace | [Invita Amici](/it/guides/workspace/invite-friends) |
| Leggi aggiornamenti di prodotto e account | [Posta in arrivo e notifiche](/it/guides/workspace/inbox-and-notifications) |
| Modifica le preferenze dell'area di lavoro, del negozio o personali | [Impostazioni dello Spazio di Lavoro](/it/guides/workspace/settings) |
## Orientati dopo l'accesso
1. Leggi il nome del negozio in cima alla barra laterale.
2. Apri il suo menu se hai bisogno di un altro negozio o **Impostazioni del workspace**.
3. Espandi **Crea**, **Cresci** o **Misura** per trovare strumenti per il negozio attuale.
4. Usa **Cerca** per trovare uno strumento o una conversazione recente.
5. Controlla **Negozio online** quando hai bisogno di confermare cosa è attualmente in Anteprima o in tempo reale.
Se il workspace è vuoto, segui prima il prompt di creazione del negozio. Completare un compito, preparare un'anteprima e pubblicare il negozio sono risultati separati.
## Accesso e impostazioni
- Il tuo ruolo determina quali cambiamenti ai membri e al workspace puoi fare.
- I limiti di negozio e posti possono sostituire i controlli di creazione o invito con un messaggio di piano.
- Le impostazioni del workspace influenzano il team; la barra laterale **Impostazioni** inizia con il negozio in contesto; **Le mie impostazioni** appartengono al tuo account.
- **Invita Amici** è un referral. Usa **Membri** per dare a qualcuno l'accesso a questo workspace.
## Guide correlate
- [Crea il tuo primo negozio](/it/guides/start-here/first-store-quickstart)
- [Chat con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Utilizza il Tour di Benvenuto e i Crediti Giornalieri](/it/guides/start-here/welcome-tour-and-daily-credits)
---
# Posta in arrivo e notifiche
Source: https://www.runnerai.com/docs/it/guides/workspace/inbox-and-notifications
**Cosa copre questa guida:** Troverai gli aggiornamenti non letti e saprai cosa può succedere quando selezioni una notifica.
La **Posta in arrivo** combina le notifiche in tutte le aree di lavoro a cui puoi accedere. È diversa dalle
notifiche del browser opzionali che annunciano quando un'attività di Runner è terminata.
**Percorso di ingresso:** Barra superiore del desktop → icona della campana. Su mobile, apri il menu dell'account o di navigazione e seleziona **Posta in arrivo** quando viene mostrato.
Su desktop, la campana apre un pannello accanto all'area di lavoro. Su dispositivi mobili, apre un cassetto inferiore. Un
punto blu sulla campana indica che esistono notifiche non lette.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg1IjV7HprvDHKGRP0BUIpjksTZQ9oN4rSwzeq)
Inizia con **All** in Inbox oppure scegli una categoria come **Release**. L’immagine mostra solo i controlli delle categorie.
Seleziona l’immagine per ingrandirla. Le annotazioni sono in inglese.
## Prima di iniziare
- Conferma l'area di lavoro e il progetto interessato prima di seguire una notifica.
- Salva qualsiasi bozza non inviata perché una notifica può navigare verso un'altra pagina o progetto.
- Evita le notifiche di attività del browser su uno schermo condiviso quando il loro testo potrebbe rivelare i dettagli del lavoro.
## Controlli della Posta in arrivo
| Controllo o stato | Cosa succede |
| --- | --- |
| **Tutte** | Mostra ogni categoria di notifica disponibile. |
| **Abbonamento** | Filtra gli aggiornamenti relativi al piano e alla fatturazione. |
| **Rilascio** | Filtra gli aggiornamenti di rilascio del prodotto. |
| **Evento** | Filtra le notifiche di evento. |
| Riga di notifica | Esegue l'azione assegnata a quella notifica, se ne ha una. |
| Chiudi la Posta in arrivo o cambia scheda | Contrassegna le notifiche che erano sufficientemente visibili come lette. Non contrassegna ogni elemento contemporaneamente. |
| Scorri fino in fondo | Carica più notifiche quando ce ne sono altre disponibili. |
La Posta in arrivo non dispone di un controllo **Segna tutte come lette** né di una schermata separata per riprovare una richiesta non riuscita.
## Leggi le notifiche
1. Seleziona l'icona della campana.
2. Inizia con **Tutte** o scegli una categoria.
3. Leggi il titolo, il messaggio, l'ora relativa e il punto non letto.
4. Scorri quando desideri caricare elementi più vecchi.
5. Seleziona una riga solo dopo aver letto quale azione rappresenta.
6. Chiudi la Posta in arrivo o cambia scheda quando hai finito; gli elementi non letti visibili vengono quindi contrassegnati come letti. Riapri la stessa categoria per verificare che quegli elementi non mostrino più un punto non letto.
## Cosa può fare un clic di notifica
Il comportamento del clic dipende dalla notifica:
- Apri una pagina correlata all'interno di Runner.
- Apri un elemento esterno, come una fattura, in una nuova scheda del browser.
- Copia un errore di build o del controllo preliminare in modo da poterlo incollare in una richiesta di supporto o in una chat di Runner.
- Apri un percorso di gestione della fatturazione per un problema di pagamento.
- Non fare nulla quando la notifica è informativa e non ha azione.
Leggi la notifica prima di selezionarla. Una riga non ha una destinazione universale.
## Stati vuoti e di caricamento
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| Caricamento dei segnaposti | Runner sta recuperando le notifiche. | Mantieni aperta la Posta in arrivo fino a quando l'elenco si stabilizza. |
| **Ancora nessuna notifica** | La categoria selezionata non ha elementi. | Ritorna più tardi o prova **Tutte**. |
| **Ti faremo sapere quando succede qualcosa.** | Non c'è nessun aggiornamento corrente su cui agire. | Chiudi la Posta in arrivo e continua a lavorare. |
| Caricamento di più | Gli elementi più vecchi vengono recuperati dopo lo scorrimento. | Aspetta prima di scorrere di nuovo. |
## Notifiche di completamento dell'attività del browser
Alcuni browser desktop mostrano una scheda separata nella barra laterale di Agent espansa:
1. Scegli **Attiva** per consentire al browser di richiedere il permesso di notifica.
2. Consenti il permesso solo se desideri notifiche di sistema per le attività completate.
3. Scegli **Non ora** per posticipare il prompt.
4. Selezionando una notifica di sistema si focalizza Runner e si ritorna alla conversazione correlata.
Questa funzione dipende dal supporto del browser desktop. Non aspettarti lo stesso comportamento su dispositivi mobili o in
ogni configurazione di app installata. I messaggi di completamento del flusso di lavoro dell'area di lavoro e di negozio pronto possono anche apparire
come avvisi temporanei sullo schermo; **Anteprima negozio** su un avviso di negozio pronto apre la sua anteprima.
## Guide correlate
- [Navigazione e Ricerca](/it/guides/workspace/navigation-and-search)
- [Membri e Inviti](/it/guides/workspace/members-and-invitations)
- [Stati dei Compiti e Dettagli](/it/guides/work-with-runner/task-states-and-details)
---
# Invita amici
Source: https://www.runnerai.com/docs/it/guides/workspace/invite-friends
**Invite Friends** crea un link di referral personale che puoi copiare o condividere. È separato dall'invito di un compagno di squadra a un'area di lavoro.
## Cosa copre questa guida
Condividerai il link di referral corretto, comprenderai cosa vede il destinatario e eviterai di confondere un referral con l'accesso all'area di lavoro.
## Disponibilità e prerequisiti
- Devi essere connesso a un'area di lavoro.
- Aspetta che Runner generi il link di referral prima di selezionare un'azione di condivisione.
- L'idoneità al referral e qualsiasi ricompensa sono regolate dai termini mostrati nel pannello al momento della condivisione. Non fare affidamento su un importo o uno screenshot più vecchio.
- Un link di referral non aggiunge il suo destinatario alla tua area di lavoro, ai negozi o ai progetti.
## Percorso di accesso
Apri **Guadagna crediti** e scegli l'azione di referral. Se il tuo layout mostra ancora **Invita Amici** nella barra laterale, apre lo stesso flusso di referral. Runner apre un pannello desktop o un cassetto inferiore mobile con il tuo link di referral e i termini attualmente disponibili.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgRvFfxwOLfUsGWFqTAc4z0vQ3ei5V2nKYpXkI)
Apri **Guadagna crediti**, scorri fino ad **Altri modi per guadagnare** e scegli **Invita amici**. Nell’immagine: 1. Trova il tuo link di invito. 2. Seleziona **Copia link** (**Copia** nelle interfacce precedenti). 3. Usa una condivisione social se necessario. Il link personale è oscurato; non è stato inviato alcun invito. Seleziona l’immagine per ingrandirla. Le annotazioni usano l’interfaccia desktop in inglese.
## Controlli di condivisione
| Controllo | Cosa succede dopo averlo selezionato |
| --- | --- |
| **Copia link** | Copia il link di referral negli appunti. L’etichetta mostra brevemente **Copiato!**, poi torna al testo originale. |
| **X** | Apre il flusso di condivisione di X con il link di referral preparato. |
| **Facebook** | Apre il flusso di condivisione di Facebook con il link di referral preparato. |
| **LinkedIn** | Apre il flusso di condivisione di LinkedIn con il link di referral preparato. |
| Chiudi | Chiude il pannello senza modificare o invalidare il link di referral. |
I pulsanti social aprono la finestra o la scheda di condivisione del provider. Rivedi il pubblico e il messaggio lì prima di pubblicare; aprire un flusso di condivisione non pubblica di per sé.
## Condividi un referral
1. Apri **Guadagna crediti**, scorri fino ad **Altri modi per guadagnare** e seleziona **Invita amici**.
2. Leggi i termini di idoneità e ricompensa attuali.
3. Aspetta fino a quando il link di referral e i pulsanti di condivisione sono pronti.
4. Seleziona **Copia link** per inviare il link privatamente o scegli un provider social.
5. Se l'hai copiato, incolla l'intero link nel messaggio desiderato e verifica che il suo codice di invito rimanga presente.
6. Comunica al destinatario che il link è per iscriversi a Runner, non per unirti alla tua area di lavoro esistente.
Quando un destinatario apre il link, Runner registra il contesto del referral e lo invia per accedere o creare un account. Il contesto del referral viene preservato attraverso quel passaggio di accesso. Qualsiasi idoneità o credito risultante segue comunque i termini mostrati da Runner; semplicemente aprire il link non garantisce una ricompensa.
## Invita un compagno di squadra invece
Per dare a qualcuno l'accesso al workspace attuale, apri il menu del nome del negozio → **Impostazioni del workspace** → **Membri** → **Invita persone**. Un invito a un membro ha i propri stati di attesa, cancellazione e accettazione. Non sostituire un link di referral per quel flusso di accesso.
## Risoluzione dei problemi
| Stato | Significato e passaggio successivo |
| --- | --- |
| Le azioni di condivisione non sono disponibili | Runner sta ancora generando il link. Aspetta che finisca. |
| **Copiato!** | Il link è negli appunti. Incollalo una volta e verifica l'URL completo. |
| La finestra social non si apre | Il browser potrebbe aver bloccato un pop-up. Consenti la finestra di condivisione per Runner o usa **Copia link**. |
| Il link non si carica | Riapri **Invita amici** e copia il link corrente. Se continua a non funzionare, includi l'errore visibile in un rapporto di supporto. |
| Il destinatario raggiunge l'accesso | Questo è previsto. Runner mantiene il contesto del referral mentre il destinatario accede o crea un account. |
## Guide correlate
- [Membri e Inviti](/it/guides/workspace/members-and-invitations)
- [Crediti e utilizzo](/it/guides/plans-and-billing/credits-and-usage)
- [Supporto e comunità](/it/guides/help-and-reference/support-and-community)
---
# Gestisci negozi
Source: https://www.runnerai.com/docs/it/guides/workspace/manage-stores
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Usa il menu del nome del negozio per scegliere su quale negozio Runner dovrebbe lavorare. Ogni negozio ha i propri compiti, vetrina e impostazioni.
**Percorso di ingresso:** Nome del negozio attuale in cima alla barra laterale → menu del negozio.
## Prima di iniziare
- Conferma il workspace e il negozio attuali prima di creare o rimuovere qualsiasi cosa.
- Tieni una copia di una richiesta non inviata prima di cambiare negozi.
- Il tuo piano di workspace controlla quanti negozi puoi creare.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZnyUGHX1SeWCnfPOVJ4KlBMuoAdXFahgI3R)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Apri questo menu per scegliere un negozio o avviare **Crea negozio**. Controlla di nuovo il nome dopo aver cambiato.
## Controlli del negozio
| Controllo | Cosa succede |
| --- | --- |
| Nome del negozio attuale | Apre il menu del negozio. |
| Un altro nome di negozio | Apre quel negozio e i suoi compiti. |
| **Crea negozio** | Apre la finestra di dialogo di creazione; un messaggio di piano può apparire se hai raggiunto il limite di negozi. |
| **Impostazioni del workspace** | Apre le impostazioni per il workspace, piuttosto che per il negozio. |
| **Impostazioni** della barra laterale | Apre le impostazioni per il negozio attuale. |
| **Generale** del negozio → **Elimina negozio** | Apre la conferma di rimozione. Rivedi il negozio nominato prima di procedere. |
## Apri un negozio esistente
1. Seleziona il nome del negozio attuale in cima alla barra laterale.
2. Trova il negozio su cui intendi lavorare.
3. Seleziona il suo nome e attendi che la navigazione finisca.
4. Conferma il nuovo nome del negozio nella barra laterale.
5. Apri il suo compito attuale o la **Negozio online** per verificare di essere nel progetto giusto prima di inviare istruzioni.
Se il tuo account apre invece un workspace vuoto, usa il suo prompt di creazione. Un workspace senza negozi non ha ancora nulla a cui passare.
## Crea un altro negozio
1. Apri il menu del nome del negozio e seleziona **Crea negozio**.
2. Scegli il tipo di negozio disponibile. Usa il percorso di creazione di Runner per un nuovo negozio, o **Connetti Shopify** per un negozio Shopify esistente quando offerto.
3. Inserisci il **Nome del negozio** richiesto e completa quel percorso.
4. Attendi che Runner apra il progetto.
5. Conferma che il nuovo nome appaia nel menu del negozio. La creazione non pubblica il negozio.
Segui [Crea un negozio Runner](/it/guides/start-here/create-runner-store) o [Connetti Shopify](/it/guides/start-here/connect-shopify) per la guida completa.
## Rivedi un'eliminazione del negozio
1. Passa al negozio che intendi rimuovere.
2. Apri le **Impostazioni** della barra laterale e la sezione **Generale** del negozio.
3. Trova **Elimina negozio** e leggi la conferma.
4. Verifica il nome del negozio e le conseguenze elencate.
5. Annulla se hai bisogno di mantenere il negozio. Inserisci il nome del negozio richiesto e conferma solo quando intendi eliminarlo.
6. Dopo un'eliminazione confermata, verifica che il negozio non sia più disponibile nella lista dei negozi attivi.
L'eliminazione è distruttiva. Usa un negozio diverso dal menu se volevi solo cambiare progetto.
## Risoluzione dei problemi
| Cosa vedi | Cosa fare |
| --- | --- |
| La lista dei negozi è in caricamento | Attendi prima di selezionare o creare un altro negozio. |
| Un negozio manca | Conferma la tua appartenenza al workspace e il workspace che hai aperto. Non creare un duplicato solo perché la lista non è stata caricata. |
| La creazione apre un percorso di aggiornamento | Rivedi i [piani pubblici](https://www.runnerai.com/pricing) attuali o chiedi al proprietario del workspace della capacità. |
| La creazione ha restituito un errore | Controlla se un nuovo negozio appare già prima di iniziare un altro tentativo. |
| Le impostazioni del negozio non sono disponibili | Conferma il negozio selezionato e il tuo ruolo. Chiedi accesso a un proprietario o amministratore del workspace. |
| Schermata di rinnovo | Riattiva il workspace se autorizzato, o usa un altro workspace a cui puoi accedere. |
## Guide correlate
- [Stati del negozio](/it/guides/workspace/store-statuses)
- [Navigazione e ricerca](/it/guides/workspace/navigation-and-search)
- [Impostazioni dello spazio di lavoro](/it/guides/workspace/settings)
- [Chat con Runner](/it/guides/work-with-runner/chat-with-runner)
---
# Membri e Inviti
Source: https://www.runnerai.com/docs/it/guides/workspace/members-and-invitations
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre:** Inviterai il compagno di squadra giusto e capirai quali azioni dei membri il tuo ruolo consente.
La pagina **Membri** mostra i membri attivi e gli inviti in sospeso per lo spazio di lavoro selezionato.
Gli inviti del team sono separati dal link di riferimento **Invita Amici** disponibile tramite **Guadagna crediti**.
**Percorso di ingresso:** Menu del nome del negozio → **Impostazioni del workspace** → **Membri**.
## Prima di iniziare
- Conferma lo spazio di lavoro e l'indirizzo email desiderato.
- Rivedi la capacità dei posti e cerca prima un membro esistente o un invito in sospeso.
- Hai bisogno di permessi di proprietario o amministratore per le azioni di gestione dei membri. La gestione degli inviti richiede anche un piano con posti per il team: **Max** oppure AppSumo License Tier 2, 3 o 4. AppSumo License Tier 1 è un piano a posto singolo. Segui il blocco del piano quando mostrato.
## Controlli della pagina Membri
| Controllo o valore | Cosa significa o fa |
| --- | --- |
| **Cerca membri** | Filtra le righe visibili per nome o email di un membro. |
| Posti utilizzati | Mostra i membri correnti rispetto alla capacità dello spazio di lavoro. Gli inviti in sospeso influiscono anche sul fatto che sia consentito un altro invito. |
| **Invita persone** | Apre il modulo di invito per i proprietari e gli amministratori del workspace idonei. |
| Campo Email | Accetta l'indirizzo email del collega. Non c'è selettore di ruolo nel modulo di invito. |
| **Invia invito** | Invia l'invito dopo che l'email è valida e un posto è disponibile. |
| **Attivo** | La persona ha aderito allo spazio di lavoro. |
| **In sospeso** / **Non ancora aderito** | L'invito non è stato accettato. |
| **Annulla** | Annulla immediatamente un invito in sospeso senza un'altra conferma. |
| **Rimuovi** | Apre una conferma prima che un proprietario o amministratore autorizzato rimuova un altro membro. |
| **Esci** | Apre una conferma prima di lasciare lo spazio di lavoro. |
## Invita un collega
1. Conferma il nome dello spazio di lavoro nelle impostazioni.
2. Apri **Membri**.
3. Rivedi i posti utilizzati e cerca l'email per evitare un invito duplicato.
4. Se il tuo ruolo e piano lo consentono, seleziona **Invita persone**.
5. Inserisci un indirizzo email valido.
6. Seleziona **Invia invito**.
7. Cerca **Invito inviato** o **Invito reinviato**.
8. Conferma che la persona appare come **In sospeso**.
L'invito non aggiunge la persona fino a quando non apre il link con l'account corretto e sceglie **Aderisci**. I link di invito possono mostrare stati già accettati, annullati, scaduti, account errato, posto pieno o altri stati di errore. Runner non promette una durata di invito fissa qui.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgXczT28QoDHrCtKfBidSYNn5cVvw1O6jUa09M)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Inserisci l'email del tuo collega in questo modulo. Lo screenshot mostra un invito vuoto; nessun invito è stato inviato.
## Accetta un invito
1. Apri il link di invito dall'email indirizzata a te.
2. Accedi con lo stesso indirizzo email che ha ricevuto l'invito.
3. Conferma l'invitante e il nome dello spazio di lavoro mostrati sulla pagina.
4. Seleziona **Aderisci a _nome spazio di lavoro_**.
5. Attendi **Aderito a _nome spazio di lavoro_** e conferma che Runner apre quello spazio di lavoro.
Selezionare **Aderisci** aggiunge il tuo account allo spazio di lavoro; non crea un negozio separato o cambia il ruolo di un altro membro. Se Runner mostra **Account sbagliato**, seleziona **Accedi come** seguito dall'indirizzo invitato, quindi completa l'accesso con quell'indirizzo. Se mostra **Lo spazio di lavoro è pieno**, seleziona **Capito** e chiedi all'invitante di liberare un posto o aggiornare il piano prima di usare di nuovo lo stesso link.
## Cambia il ruolo di un membro
1. Trova il membro desiderato su **Membri**.
2. Apri il menu **Ruolo** della riga quando le tue autorizzazioni lo consentono.
3. Seleziona il ruolo desiderato e attendi l'aggiornamento.
4. Conferma che la riga mostri il nuovo ruolo.
I proprietari possono assegnare ruoli di proprietario, amministratore o membro. Gli amministratori possono gestire amministratori e membri, ma non possono cambiare un proprietario o concedere la proprietà. Il modulo di invito non ha un selettore di ruoli; rivedi i ruoli dopo che il collega si è unito.
## Gestisci l'accesso con attenzione
### Annulla un invito in sospeso
1. Cerca l'email in sospeso.
2. Seleziona **Annulla** solo quando intendi invalidare quell'invito.
3. Verifica che la riga in sospeso non appaia più.
Il flusso selezionato non mostra una seconda conferma per **Annulla**.
### Rimuovi un membro o esci
1. Trova la riga del membro corretto.
2. Seleziona **Rimuovi**, o seleziona **Esci** sulla tua riga.
3. Leggi la conferma, inclusa la perdita di accesso ai progetti dello spazio di lavoro.
4. Annulla se l'accesso deve rimanere.
5. Conferma solo quando lo spazio di lavoro e la persona sono corretti.
Un proprietario non può essere rimosso dalla riga del proprietario nell'interfaccia selezionata. Le azioni di gestione dei membri seguono anche la gerarchia dei ruoli, quindi un'azione visibile o tentata può comunque essere rifiutata quando il tuo ruolo non lo consente.
## Risoluzione dei problemi
| Stato | Cosa fare |
| --- | --- |
| **Invita persone** è assente | Controlla che il workspace sia su Max o AppSumo License Tier 2-4 e chiedi a un proprietario o amministratore del workspace di inviare l'invito. |
| La capacità dei posti è raggiunta | Risolvi un invito in sospeso inutilizzato o chiedi al proprietario di rivedere il piano dello spazio di lavoro. |
| L'email è rifiutata | Controlla l'indirizzo completo e correggi eventuali errori di formattazione. |
| L'invito appartiene a un altro account | Accedi con l'email invitata prima di scegliere **Aderisci**. |
| L'invito è scaduto o annullato | Chiedi a un proprietario o amministratore del workspace di inviare un nuovo invito. |
| **Lo spazio di lavoro è pieno** | Chiedi all'invitante di liberare un posto o aggiornare il piano dello spazio di lavoro, quindi prova di nuovo il link. |
| **Invito già accettato** | Seleziona **Vai a Runner AI** e apri lo spazio di lavoro dal tuo selettore di spazi di lavoro. |
| La ricerca non mostra risultati | Cancella o accorcia la ricerca, quindi verifica lo spazio di lavoro selezionato. |
## Guide correlate
- [Impostazioni dello spazio di lavoro](/it/guides/workspace/settings)
- [Navigazione e ricerca](/it/guides/workspace/navigation-and-search)
- [Posta in arrivo e notifiche](/it/guides/workspace/inbox-and-notifications)
---
# Navigazione e ricerca
Source: https://www.runnerai.com/docs/it/guides/workspace/navigation-and-search
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Inizia controllando il nome del negozio. Gli strumenti della barra laterale agiscono su quel negozio; le impostazioni del workspace e personali hanno voci separate.
**Percorso di ingresso:** Apri un negozio → espandi la barra laterale, o apri il menu di navigazione su mobile.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGZocKoTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
1. Cerca nel tuo negozio; 2. Avvia una nuova attività; 3. Apri uno strumento del workspace; 4. Riapri un’attività salvata. Seleziona l’immagine per ingrandirla. Le indicazioni numerate si riferiscono all’interfaccia desktop in inglese.
## Prima di iniziare
- Salva una copia di una richiesta non inviata prima di cambiare negozi o attività.
- Le destinazioni disponibili dipendono dal tipo di negozio, ruolo, piano e funzionalità abilitate.
## Trova l'ambito giusto
| Dove guardare | Cosa puoi fare |
| --- | --- |
| Nome del negozio in cima alla barra laterale | Cambia negozi, apri **Crea negozio**, o apri **Impostazioni del workspace**. |
| **Negozio online** | Rivedi le pagine del negozio corrente e lo stato di pubblicazione. |
| **Crea**, **Cresci** e **Misura** | Espandi gli strumenti raggruppati per le operazioni del negozio, la crescita e i report. |
| **Agente** | Gestisci le abilità e la memoria disponibili del negozio. |
| **Impostazioni** della barra laterale | Apri le impostazioni con il negozio corrente nel contesto. |
| Campanello in alto a destra | Apri **Posta in arrivo** su desktop. Su mobile, usa la voce **Posta in arrivo** quando offerta nel menu. |
| Avatar in alto a destra → **Le mie impostazioni** | Apri le preferenze dell'account personale. |
| **Guadagna crediti** | Rivedi le azioni di ricompensa e referral disponibili. |
## Cambia negozi
1. Seleziona il nome del negozio in cima alla barra laterale.
2. Seleziona il negozio di cui hai bisogno dall'elenco.
3. Attendi che la sua pagina si apra.
4. Conferma il nuovo nome del negozio prima di selezionare **Nuova attività** o cambiare impostazioni.
Il menu del negozio elenca i negozi nel suo workspace. L'attuale barra laterale delle Impostazioni non espone **Workspace**. Usa una voce di cambio workspace solo quando Runner ne presenta una, poi apri **Impostazioni → Generale del Workspace** e conferma il nome del workspace. Vedi [Impostazioni](/it/guides/workspace/settings) per i controlli dell'ambito.
## Trova uno strumento o un'attività
1. Seleziona **Cerca** nella barra laterale del progetto, o premi `Command/Control + K`.
2. Digita un nome di destinazione visibile, come `Storefront`, o parte di un titolo di attività.
3. Scegli un risultato sotto **Centro di controllo** per uno strumento, o **Chat recenti** per una conversazione.
4. Conferma che la pagina o l'attività selezionata si apra nel negozio desiderato.
5. Premi `Escape` per chiudere la ricerca se non vuoi navigare.
[Navigazione e ricerca del progetto](/it/guides/work-with-runner/project-navigation-and-search) elenca i gruppi di strumenti e gli stati di recupero della ricerca. La ricerca naviga; non avvia il lavoro sullo strumento selezionato.
Cerca mostra le destinazioni disponibili sotto **Centro di controllo**. Seleziona un risultato per navigare, o premi Escape per mantenere la pagina corrente.
### Guarda: filtra la ricerca di navigazione
La registrazione tipizza **Analisi** e ispeziona la destinazione corrispondente. Si ferma prima di aprire il risultato; seleziona un risultato tu stesso per navigare.
## Risoluzione dei problemi
| Problema | Cosa fare |
| --- | --- |
| Le etichette della barra laterale sono nascoste | Espandila o apri il menu di navigazione mobile. |
| Una destinazione manca | Espandi il gruppo pertinente, prova la Ricerca, quindi verifica i prerequisiti della funzione. |
| Un negozio manca | Conferma l'area di lavoro e la tua appartenenza prima di creare un altro negozio. |
| La ricerca non trova nulla | Cancella la query e usa l'etichetta dello strumento attualmente visibile. |
| Un link apre un'altra scheda del browser | Torna a Runner dopo averlo letto; aprire una risorsa non cambia negozio. |
## Guide correlate
- [Gestisci Negozi](/it/guides/workspace/manage-stores)
- [Navigazione e ricerca del progetto](/it/guides/work-with-runner/project-navigation-and-search)
- [Posta in arrivo e notifiche](/it/guides/workspace/inbox-and-notifications)
- [Impostazioni dello spazio di lavoro](/it/guides/workspace/settings)
---
# Impostazioni dell'area di lavoro
Source: https://www.runnerai.com/docs/it/guides/workspace/settings
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
**Cosa copre questa guida:** Aprirai l'area delle impostazioni corretta e saprai quali modifiche interessano un'area di lavoro, un negozio o solo il tuo account.
Le impostazioni sono raggruppate per ambito. Conferma i nomi dell'area di lavoro e del negozio prima di modificare l'accesso, la fatturazione, i domini, gli script o i controlli di eliminazione.
**Percorsi di accesso:**
- Menu nome-negozio → **Impostazioni del workspace** apre le impostazioni dell'area di lavoro.
- Avatar utente in alto a destra → **Le mie impostazioni** apre le impostazioni personali.
- Barra laterale → **Impostazioni** apre le impostazioni con il negozio attuale in contesto.
## Prima di iniziare
- Conferma l'area di lavoro e, per le impostazioni del negozio, il gruppo **Negozio: _nome negozio_**.
- Attendi che lo stato **Salvataggio** sia completato prima di lasciare la pagina.
- Leggi la conferma finale prima di modificare l'accesso, la fatturazione, il dominio, lo script o le impostazioni di eliminazione.
## Controlli e risultati importanti
| Controllo | Cosa accade dopo averlo selezionato |
| --- | --- |
| **Nome** o **Descrizione** | Salva automaticamente una modifica valida dell'area di lavoro dopo che la modifica si interrompe. |
| **Generale del workspace** | Apre i dettagli per l'area di lavoro nominata nella barra laterale delle impostazioni. |
| **Elimina area di lavoro** | Apre una conferma distruttiva che richiede il nome completo dell'area di lavoro. |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Il gruppo dell'area di lavoro e il gruppo **Negozio** hanno impostazioni separate. Conferma l'ambito nominato prima di modificare.
## Sezioni delle impostazioni
| Ambito | Sezioni attualmente visualizzate | Note |
| --- | --- | --- |
| Workspace | **Generale del workspace**, **Membri**, **Piano & Fatturazione**, **Utilizzo e crediti** | I ruoli dei membri controllano quali modifiche hanno successo. |
| Progetto del negozio | **Generale dello store**, **Dominio**, **Script personalizzati**, **Agente** | **Esperimenti** appare solo quando abilitato. Le sezioni del progetto appaiono solo con un negozio in contesto. |
| Personale | **Le mie impostazioni**, e **Chiavi API** quando abilitate | Le modifiche personali e le chiavi API appartengono al tuo account. |
## Aggiorna i dettagli dell'area di lavoro
1. Apri **Impostazioni → Generale dell’area di lavoro**.
2. Conferma il nome dell'area di lavoro nella parte superiore del pannello delle impostazioni.
3. Modifica **Nome** o **Descrizione**.
4. Osserva il cambio dello stato di salvataggio da **Salvataggio** a **Salvato**.
5. Mantieni il pannello aperto fino al completamento del salvataggio.
Questi campi vengono salvati automaticamente. Un nome vuoto o non valido non viene salvato. Se il salvataggio non riesce, Runner può ripristinare l'ultimo valore del server e mostrare un errore. La descrizione dell'area di lavoro accetta fino al limite visualizzato dal campo, attualmente 500 caratteri.
L'aggiornamento dei dettagli dell'area di lavoro richiede autorizzazioni sufficienti per l'area di lavoro. L'eliminazione di un'area di lavoro è un'azione del proprietario anche se un altro ruolo può visualizzare parte dell'interfaccia delle impostazioni.
## Cambia il contesto delle impostazioni
1. Apri **Impostazioni** e leggi i nomi dell'area di lavoro e del negozio nella sua barra laterale.
2. Seleziona **Generale del workspace** per i dettagli dell'area di lavoro o **Generale dello store** per il negozio attuale.
3. Seleziona **Le mie impostazioni** per le preferenze personali.
L'attuale barra laterale non espone un elenco di **Workspace**. Usa un'entrata di cambio o creazione dell'area di lavoro solo quando Runner ne presenta una; non cercarla sotto **Le mie impostazioni**. Per lasciare un'area di lavoro, segui [Membri e inviti](/it/guides/workspace/members-and-invitations).
## Elimina un'area di lavoro con attenzione
1. Apri **Impostazioni → Generale dell’area di lavoro**.
2. Trova **Elimina area di lavoro**.
3. Leggi la conferma e il nome dell'area di lavoro interessata.
4. Inserisci il nome completo dell'area di lavoro solo quando è il target previsto.
5. Annulla se qualsiasi negozio, conversazione, accesso dei membri o dati dell'area di lavoro dovrebbe rimanere disponibile.
L'unica area di lavoro non può essere eliminata dall’interfaccia.
## Stati di accesso e risoluzione dei problemi
| Stato | Significato | Cosa fare |
| --- | --- | --- |
| **Salvataggio** | Runner sta archiviando una modifica automatica. | Mantieni il pannello delle impostazioni aperto. |
| **Salvato** | L'ultima modifica valida del campo è stata accettata. | Continua o chiudi le impostazioni. |
| Errore di salvataggio e ritorno del valore precedente | La modifica non è stata accettata. | Correggi il valore, conferma la tua autorizzazione e riprova. |
| **Crea la tua prima area di lavoro** | Il tuo account non ha un'area di lavoro disponibile. | Usa l'azione di creazione per continuare. |
| **Accesso all'area di lavoro negato** | Il tuo account non può aprire quell'area di lavoro. | Scegli **Vai alla tua area di lavoro**. |
| Schermata di rinnovo | L'area di lavoro non è attiva. | Scegli **Rinnova piano** se autorizzato, o cambia area di lavoro. |
| Una sezione è mancante | Non è disponibile per il ruolo corrente, il contesto del progetto, il piano o l'accesso alle funzioni. | Conferma il contesto e chiedi al proprietario dell'area di lavoro se necessario. |
## Guide correlate
- [Membri e inviti](/it/guides/workspace/members-and-invitations)
- [Gestisci negozi](/it/guides/workspace/manage-stores)
- [Navigazione e ricerca](/it/guides/workspace/navigation-and-search)
- [Immagini, modelli e competenze](/it/guides/work-with-runner/attachments-profiles-and-skills)
---
# Stati del negozio
Source: https://www.runnerai.com/docs/it/guides/workspace/store-statuses
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
Il riepilogo del negozio ti dice se esiste una versione pubblica. Apri **Negozio online** per verificare se la tua ultima modifica fa parte di quella versione.
**Percorso di ingresso:** Nome e riepilogo del negozio attuale → **Negozio online**.
## Leggi il riepilogo
| Etichetta | Cosa ti dice | Cosa controllare dopo |
| --- | --- | --- |
| **Bozza non pubblicata** | Il negozio non ha una versione pubblicata da usare come vetrina attiva. | Rivedi l'anteprima attuale e prepara la sua prima pubblicazione. |
| **In tempo reale** | Esiste una vetrina pubblica. | Apri l'URL pubblico e conferma che le modifiche previste siano visibili. |
| **Versione corrente** nella vetrina | Questa è l'ultima versione del progetto. | Confrontala con la versione pubblicata prima di presumere che sia attiva. |
| **Pubblicato** su una versione | Quella versione è associata a una pubblicazione completata. | Verifica separatamente la pagina pubblica e il checkout. |
I layout delle schede del negozio più vecchi possono usare **Bozza**, **Distribuzione in corso** e **Pubblicato**. Leggi **Distribuzione in corso** come un'operazione in corso e attendi il suo risultato. Un'etichetta attiva o pubblicata può ancora riferirsi a una versione di successo più vecchia dopo che un tentativo successivo fallisce.
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgtbyIXy0HWgOalkhv5dfRGQjiY7nSITscAEmU)
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
Questa è l'anteprima attuale del progetto. Usa i suoi controlli di versione e pubblicazione per confrontarla con il negozio attivo; un'anteprima visibile da sola non la rende pubblica.
## Verifica un cambiamento recente
1. Controlla il nome del negozio attuale.
2. Apri l'attività che ha richiesto la modifica e rivedi il suo stato più recente e **Dettagli**.
3. Apri **Negozio online** e conferma la modifica prevista nell'anteprima pronta attuale.
4. Controlla se quella versione è stata pubblicata.
5. Se lo è stata, apri l'URL pubblico e ripeti l'azione cliente pertinente.
Hai verificato la modifica solo quando la versione prevista e il suo risultato visibile concordano. Il completamento dell'attività da solo non prova che un'anteprima, una pubblicazione, un pagamento o un'azione del fornitore siano riusciti.
## Se il riepilogo sembra sbagliato
- Lascia che qualsiasi pubblicazione attiva finisca prima di iniziare un altro tentativo.
- Aggiorna la vista corrente una volta e leggi il risultato della pubblicazione più recente.
- Confronta le versioni corrente e pubblicata in [Cronologia delle versioni](/it/guides/storefront-and-publishing/version-history).
- Se la vetrina pubblica mostra ancora contenuti più vecchi, rivedi l'anteprima più recente prima di usare **Pubblica modifiche**.
- Se la pubblicazione è fallita, segui l'errore indicato invece di ripetere la stessa azione.
## Guide correlate
- [Gestisci Negozi](/it/guides/workspace/manage-stores)
- [Stati e dettagli dell'attività](/it/guides/work-with-runner/task-states-and-details)
- [Pubblica e ripubblica](/it/guides/storefront-and-publishing/publish-and-republish)
- [Verifica la vetrina live e il checkout](/it/guides/storefront-and-publishing/live-store-and-checkout)
---
# Politica di Utilizzo Accettabile
Source: https://www.runnerai.com/docs/it/legal/aup
## Politica di Utilizzo Accettabile di Runner AI
La presente Politica di Utilizzo Accettabile ("PUA") è emessa da Adaptive Machines, Inc. ("Runner AI", "noi", "ci") e disciplina l'utilizzo dei servizi di Runner AI.
**La regola principale per l'utilizzo di Runner AI è: Sei responsabile del rispetto della legge, delle regole dei tuoi partner e dei tuoi accordi con noi.**
Questi sono i principi alla base delle nostre aspettative in modo più dettagliato:
## Non puoi utilizzare Runner AI per fare nulla che sia illegale dove svolgi la tua attività
Comprendiamo che le leggi e i quadri normativi possono essere complessi, ma nella scelta di un mercato in cui entrare e di prodotti da vendere, tu, il commerciante, ti stai impegnando a prendere quel mercato sul serio, e ci fidiamo e ci aspettiamo che tu comprenda i confini applicabili. Allo stesso modo, devi rispettare il fatto che alcune attività commerciali non sono supportate dalla nostra piattaforma, come il caricamento di Informazioni Sanitarie Protette soggette all'HIPAA.
## Dovresti Sostenere l'Integrità e la Sicurezza della Piattaforma
Ci impegniamo a mantenere un ambiente commerciale sicuro e affidabile. Le attività che danneggiano l'integrità della nostra piattaforma o la sicurezza dei nostri utenti sono rigorosamente vietate. Questo include, ma non è limitato a:
### Beni Illegali e Regolamentati
Vendere beni contraffatti, droghe illegali, armi o qualsiasi altro prodotto che sia illegale nella tua giurisdizione o in quella dei tuoi clienti.
### Violazione della Proprietà Intellettuale
Violare i diritti di proprietà intellettuale altrui, inclusi diritti d'autore e marchi.
### Odio, Violenza e Contenuti Dannosi
Vendere prodotti o pubblicare contenuti che promuovono odio, discriminazione, violenza o facilitano l'autolesionismo intenzionale.
### Frode e Inganno
Impegnarsi in marketing ingannevole, truffe finanziarie o qualsiasi altra attività fraudolenta.
### Abuso della Piattaforma
Inviare spam, distribuire malware o tentare di interrompere i nostri servizi.
## Regole Specifiche Riguardanti le Funzionalità AI
L'utilizzo di qualsiasi funzionalità di intelligenza artificiale all'interno di Runner AI ("Funzionalità AI") è soggetto ai seguenti termini aggiuntivi:
### a. Responsabilità per l'Input
Sei l'unico responsabile di tutto il testo, i dati e le informazioni che fornisci alle Funzionalità AI ("Input"). Accetti di non fornire alcun Input che sia illegale, violi i diritti di terzi o contenga informazioni personali sensibili.
### b. Accuratezza e Responsabilità per l'Output
Il contenuto generato dalle Funzionalità AI ("Output") può contenere errori. Devi rivedere e verificare in modo indipendente tutto l'Output prima di pubblicarlo o fare affidamento su di esso. Runner AI non è responsabile per eventuali danni derivanti dall'utilizzo dell'Output.
### c. Usi Vietati delle Funzionalità AI
Non puoi utilizzare le Funzionalità AI per generare contenuti ingannevoli, creare contenuti di odio o molestie, o produrre spam.
## Devi seguire i nostri accordi con te
Sebbene non vogliamo gravarvi con molta burocrazia, i nostri Termini di Servizio sono importanti per il modo in cui operiamo. I nostri accordi ti vincolano come commerciante e spiegano le regole della piattaforma che devi seguire.
Runner AI offre una gamma di prodotti e servizi che sfruttano partnership con altre organizzazioni. Quando utilizzi uno di questi prodotti, stai interagendo con un'intera catena di fornitura di aziende. Runner AI coinvolge un ecosistema di processori che lavorano insieme. Se utilizzi questi servizi, devi rispettare il funzionamento della catena di fornitura e i termini che ti vengono richiesti.
## Le controversie più comuni sull'idoneità dei prodotti hanno origine al di fuori di Runner AI
Siamo una piattaforma di commercio: la maggior parte delle controversie sull'idoneità dei prodotti o sulla rimozione che gli imprenditori possono incontrare hanno origine al di fuori di Runner AI, inclusi regolatori e titolari di diritti di proprietà intellettuale di terze parti. In queste circostanze, ti daremo notifica e strumenti per auto-gestire i tuoi rischi e controversie quando appropriato.
## Ci aspettiamo che tu agisca in buona fede. Se non lo fai, potrebbe essere appropriata un'azione a livello di account
Non ci piace vedere persone che cercano di "ingannare" i sistemi per evitare vincoli con cui non sono d'accordo. Inoltre, non tolleriamo nessuno che frodi Runner AI, altri commercianti o acquirenti, utilizzi la nostra piattaforma per inviare spam o per altre pratiche dannose. In quei casi, mentre cerchiamo di ridurre al minimo l'impatto sull'attività come principio di primo ordine, l'azione a livello di account è spesso più appropriata.
Quando costruisci su Runner AI tenendo presenti questi principi, ti daremo notifica, ti concederemo opportunità di auto-rimediare ai conflitti, applicheremo per default l'enforcement a livello di prodotto e prenderemo azioni a livello di account come ultima risorsa quando appropriato. Infine, come con tutti i grandi prodotti, ci aspettiamo di iterare e aggiornare questi principi di tanto in tanto.
Se ritieni che un utente di Runner AI stia violando questa Politica di Utilizzo Accettabile, puoi contattare il Supporto Runner AI via email all'indirizzo support@adaptivemachines.ai.
---
# Politica sui Cookie
Source: https://www.runnerai.com/docs/it/legal/cookies
## Politica sui Cookie di Runner AI
La presente Politica sui Cookie spiega come Adaptive Machines, Inc. ("Runner AI", "noi", "ci" o "nostro") utilizza i cookie e tecnologie simili sul nostro sito web (runner.ai) e i servizi che forniamo ai nostri commercianti (collettivamente, i "Servizi"). Spiega cosa sono queste tecnologie e perché le utilizziamo, così come i tuoi diritti di controllare il nostro utilizzo di esse. Questa politica dovrebbe essere letta in combinazione con la nostra [Politica sulla Privacy](/it/legal/policies) principale.
## Cosa sono i cookie?
Un cookie è una piccola quantità di informazioni che viene scaricata sul tuo computer o dispositivo quando visiti determinati siti web. Utilizziamo diversi tipi di cookie sul sito web di Runner AI, inclusi cookie strettamente necessari, di prestazione, pubblicitari e di social media o contenuto. I cookie migliorano la tua esperienza di navigazione consentendo al sito web di ricordare le tue azioni e preferenze (come login e selezione della regione). Ciò significa che non devi reinserire queste informazioni ogni volta che torni al sito o navighi da una pagina all'altra. I cookie forniscono anche informazioni su come le persone utilizzano il sito web, ad esempio se è la prima volta che visitano o se sono visitatori frequenti. Leggi di più sui cookie (e altre tecnologie di tracciamento simili) e su come utilizziamo i dati raccolti attraverso queste tecnologie, nella nostra [Politica sulla Privacy](/it/legal/policies).
## Cookie sui Negozi dei Commercianti
Questa sezione è importante sia per i commercianti che utilizzano la nostra piattaforma che per i visitatori dei loro negozi.
**Per i Visitatori dei Negozi dei Commercianti:** Quando visiti il negozio di un commerciante alimentato da Runner AI, quel commerciante è il Titolare del Trattamento delle tue informazioni. Ciò significa che il commerciante decide quali cookie utilizzare sul proprio negozio, in particolare per analisi e pubblicità (ad es., Google Analytics, Facebook Pixel). Runner AI agisce come Responsabile del Trattamento, inserendo cookie che sono strettamente necessari per la funzionalità principale del negozio (ad es., carrello, checkout). Qualsiasi domanda sulle pratiche sulla privacy di un commerciante dovrebbe essere indirizzata al commerciante stesso.
**Per i Commercianti:** Come commerciante che utilizza Runner AI, sei il Titolare del Trattamento per i dati dei tuoi clienti. Sei responsabile della conformità con tutte le leggi sulla privacy applicabili, inclusa l'informativa ai tuoi clienti sui cookie che utilizzi (inclusi quelli delle app di terze parti che installi) e l'ottenimento del consenso valido laddove richiesto. Mentre Runner AI fornisce la piattaforma, sei responsabile della configurazione specifica delle impostazioni e delle politiche sulla privacy del tuo negozio.
## Quali cookie utilizziamo e perché?
### Cookie Necessari
Alcuni cookie sono necessari per consentirti di navigare sul nostro sito web, utilizzare le sue funzionalità e accedere ad aree sicure. L'uso di questi cookie è essenziale per il funzionamento del sito web. Ad esempio, utilizziamo cookie di input dell'utente per la durata di una sessione per tenere traccia del loro input quando compilano moduli che si estendono su più pagine.
### Cookie Funzionali
Utilizziamo anche cookie funzionali per ricordare le scelte che hai fatto o le informazioni che hai fornito, come il tuo nome utente, lingua o la regione in cui ti trovi. Ciò ci consente di personalizzare la tua esperienza sul sito web specificamente alle tue preferenze. Ad esempio, i cookie di autenticazione sono cookie funzionali che vengono utilizzati per la durata di una sessione (o persistenti, se accetti la funzione "ricordami") per consentire agli utenti di autenticarsi nelle visite successive o per accedere a contenuti autorizzati tra le pagine. I cookie funzionali che utilizziamo includono:
- **Cookie di sicurezza incentrati sull'utente:** Per rilevare abusi di autenticazione per una durata persistente limitata, come ripetuti tentativi di accesso falliti.
- **Cookie di sessione del lettore di contenuti multimediali (cookie flash):** Utilizzati per la durata di una sessione per memorizzare dati tecnici necessari per riprodurre contenuti video o audio.
- **Cookie di sessione di bilanciamento del carico:** Utilizzati per la durata della sessione per identificare lo stesso server nel pool per consentire al bilanciatore del carico di reindirizzare le richieste in modo appropriato.
- **Cookie persistenti di personalizzazione dell'interfaccia utente:** Utilizzati per memorizzare la preferenza di un utente riguardo a un servizio tra le pagine web.
### Cookie di Prestazione
Runner AI si dedica all'ottimizzazione dell'esperienza utente e utilizziamo molti strumenti per aiutarci a migliorare il nostro sito web e la nostra piattaforma di commercio. A tal fine, utilizziamo cookie di reportistica e analisi per raccogliere informazioni su come utilizzi il nostro sito web o le vetrine dei nostri commercianti, e con quale frequenza. I cookie di prestazione che utilizziamo includono:
- **Cookie di analisi di prima parte:** Utilizziamo questi cookie per stimare il numero di visitatori unici, per migliorare i nostri siti web e i siti web dei nostri commercianti, e per rilevare le parole più cercate nei motori di ricerca che portano a una pagina web.
- **Cookie di analisi di terze parti:** Utilizziamo anche Google Analytics e altri fornitori di analisi di terze parti elencati di seguito per aiutare a misurare come gli utenti interagiscono con il contenuto del nostro sito web.
### Cookie Pubblicitari
I cookie pubblicitari vengono utilizzati sul nostro sito web per personalizzare il marketing per te e i tuoi interessi e fornirti un servizio più personalizzato in futuro. Questi cookie ricordano che hai visitato il nostro sito web e possiamo condividere queste informazioni con terze parti, come inserzionisti. Senza questi cookie, gli annunci pubblicitari che vedi potrebbero essere meno rilevanti e interessanti per te.
### Cookie di Social Media e Contenuto
I cookie di social media e contenuto sono inseriti da molti plugin di social media (ad esempio il pulsante "mi piace" di Facebook) e altri strumenti destinati a fornire o migliorare il contenuto su un sito web (ad esempio servizi che consentono la riproduzione di file video o che creano sezioni di commenti). Integriamo questi moduli nella nostra piattaforma per migliorare l'esperienza di navigazione e interazione con i nostri siti web.
## Vetrine dei Commercianti
Quando i commercianti utilizzano la nostra piattaforma per alimentare i loro negozi online, inseriamo i seguenti cookie per i visitatori dei loro negozi.
### Cookie Necessari per il Funzionamento del Negozio
| Nome | Descrizione | Durata |
|------|-------------|---------|
| \_medusa\_jwt | Credenziale di accesso del visitatore | 7d |
## Cookie di Terze Parti
Inoltre, utilizziamo pixel e tag dalle seguenti terze parti, che a loro volta possono inserire cookie.
### Cookie Necessari per il Funzionamento dei Siti
| Terza Parte | Descrizione | Politica sulla Privacy |
|-------------|-------------|------------------------|
| Vercel | Utilizziamo Vercel per il routing edge. | [https://vercel.com/legal/privacy-policy](https://vercel.com/legal/privacy-policy) |
| Intercom | Utilizziamo Intercom per il servizio clienti. | [https://www.intercom.com/legal/privacy](https://www.intercom.com/legal/privacy) |
| Chatwoot | Utilizziamo Chatwoot, che ospitiamo direttamente su support.runnerai.com, per il servizio clienti. Imposta `cw_conversation` per mantenere la tua conversazione in chat tra pagine e visite, `cw_user_` per ricordare a quale contatto della chat appartiene il tuo browser quando hai effettuato l'accesso, e `cw_snooze_campaigns_till` per sospendere i messaggi delle campagne in chat per un'ora dopo che ne hai letto uno. `cw_conversation` e `cw_user_` durano un anno. | [Politica sulla Privacy](/it/legal/policies) |
### Reportistica e Analisi
| Terza Parte | Descrizione | Politica sulla Privacy |
|-------------|-------------|------------------------|
| Google Analytics | Utilizziamo Google Analytics per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Google Tag Manager | Utilizziamo Google Tag Manager per aiutare a gestire i fornitori di analisi. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| PostHog | Utilizziamo PostHog per l'analisi dei dati. | [https://posthog.com/privacy](https://posthog.com/privacy) |
### Pubblicità
| Terza Parte | Descrizione | Politica sulla Privacy |
|-------------|-------------|------------------------|
| Facebook Pixel | Utilizziamo Facebook Pixel per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://www.facebook.com/privacy/explanation](https://www.facebook.com/privacy/explanation) |
| Google Ads | Utilizziamo Google Ads per fornire pubblicità mirata agli individui che visitano i nostri siti web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Instagram | Utilizziamo Instagram per fornire pubblicità mirata agli individui che visitano i nostri siti web. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| TikTok | Utilizziamo TikTok per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Twitter | Utilizziamo Twitter per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube | Utilizziamo YouTube per fornire pubblicità mirata agli individui che visitano i nostri siti web. | [https://policies.google.com/privacy](https://policies.google.com/privacy) |
| Reddit | Utilizziamo Reddit per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Pinterest | Utilizziamo Pinterest per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Whatsapp | Utilizziamo Whatsapp per aiutare a misurare come gli utenti interagiscono con i nostri siti web. | [https://www.whatsapp.com/legal/privacy-policy](https://www.whatsapp.com/legal/privacy-policy) |
### Social Media e Contenuto
| Terza Parte | Descrizione | Politica sulla Privacy |
|-------------|-------------|------------------------|
| Facebook Connect | Utilizziamo Facebook Connect per consentire ai visitatori del nostro sito web di interagire e condividere contenuti tramite la piattaforma di social media di Facebook. | [https://www.facebook.com/policy.php](https://www.facebook.com/policy.php) |
| Instagram CDN | Utilizziamo Instagram CDN per fornire contenuti all'utente. | [https://privacycenter.instagram.com/policy](https://privacycenter.instagram.com/policy) |
| Twitter CDN | Utilizziamo Twitter per consentire ai visitatori del nostro sito web di interagire e condividere contenuti tramite la piattaforma di social media di Twitter. | [https://twitter.com/en/privacy](https://twitter.com/en/privacy) |
| YouTube CDN | Utilizziamo YouTube CDN per fornire contenuti all'utente. | [https://policies.google.com/privacy?hl=en](https://policies.google.com/privacy?hl=en) |
| Tiktok CDN | Utilizziamo Tiktok CDN per fornire contenuti all'utente. | [https://www.tiktok.com/legal/privacy-policy?lang=en](https://www.tiktok.com/legal/privacy-policy?lang=en) |
| Reddit CDN | Utilizziamo Reddit CDN per fornire contenuti all'utente. | [https://www.reddit.com/policies/privacy-policy](https://www.reddit.com/policies/privacy-policy) |
| Linkedin CDN | Utilizziamo Linkedin CDN per fornire contenuti all'utente. | [https://www.linkedin.com/legal/privacy-policy](https://www.linkedin.com/legal/privacy-policy) |
| Pinterest CDN | Utilizziamo Pinterest CDN per fornire contenuti all'utente. | [https://policy.pinterest.com/en/privacy-policy](https://policy.pinterest.com/en/privacy-policy) |
| Rednote CDN | Utilizziamo Rednote CDN per fornire contenuti all'utente. | [https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1](https://agree.xiaohongshu.com/h5/terms/ZXXY20230227002/-1) |
## Per quanto tempo rimarranno i cookie sul mio computer o dispositivo mobile?
La durata di permanenza di un cookie sul tuo computer o dispositivo mobile dipende dal fatto che sia un cookie "persistente" o "di sessione". I cookie di sessione durano fino a quando non smetti di navigare e i cookie persistenti durano fino alla scadenza o fino all'eliminazione. La maggior parte dei cookie che utilizziamo sono persistenti e scadranno tra 30 minuti e due anni dalla data in cui vengono scaricati sul tuo dispositivo. Consulta la sezione seguente su come controllare i cookie per ulteriori informazioni sulla loro rimozione prima della scadenza.
## Come controllare i cookie?
Puoi controllare e gestire i cookie in vari modi. Tieni presente che la rimozione o il blocco dei cookie può avere un impatto negativo sulla tua esperienza utente e parti del nostro sito web potrebbero non essere più completamente accessibili.
La maggior parte dei browser accetta automaticamente i cookie, ma puoi scegliere se accettare o meno i cookie attraverso i controlli del tuo browser, spesso trovati nel menu "Strumenti" o "Preferenze" del tuo browser. Per ulteriori informazioni su come modificare le impostazioni del browser o su come bloccare, gestire o filtrare i cookie, è possibile trovare informazioni nel file di aiuto del browser o attraverso siti come: [www.allaboutcookies.org](https://www.allaboutcookies.org).
Molti dei servizi pubblicitari di terze parti e altri servizi di tracciamento elencati sopra ti offrono l'opportunità di disattivare i loro sistemi di tracciamento. Puoi leggere ulteriori informazioni sulle informazioni che raccolgono e su come disattivare attraverso i link alle politiche sulla privacy elencati sopra.
---
# Accordo sul Trattamento dei Dati
Source: https://www.runnerai.com/docs/it/legal/dpa
## Accordo sul Trattamento dei Dati di Runner AI
### I. FINALITÀ
Il presente Accordo sul Trattamento dei Dati di Runner AI ("DPA") integra ed è incorporato per riferimento nei Termini di Servizio di Runner AI, unitamente a qualsiasi termine applicabile a qualsiasi servizio aggiuntivo di Runner AI che scegli di utilizzare (i "Termini") stipulato tra te (o "Commerciante") e Adaptive Machines, Inc. ("Runner AI", "noi", "ci", "nostro"), che delinea le finalità commerciali specifiche e i servizi relativi al presente DPA. In caso di conflitto tra i Termini e il presente DPA, il DPA prevarrà rispetto al trattamento dei Tuoi Dati Personali dei Clienti, come definito di seguito.
Tu e Runner AI (ciascuno una "Parte", insieme le "Parti"), concordano che il presente DPA stabilisce gli obblighi delle Parti che regolano il trattamento dei Tuoi Dati Personali dei Clienti. Tu agirai come Titolare del Trattamento e Runner AI agirà come Responsabile del Trattamento rispetto al trattamento dei Tuoi Dati Personali dei Clienti, in relazione al Tuo utilizzo dei nostri Servizi che si basano sul nostro trattamento dei Tuoi Dati Personali dei Clienti, ad eccezione dei servizi descritti nell'Appendice E.
Laddove il trattamento dei Dati Personali ai sensi del presente DPA sia soggetto ai requisiti di protezione dei dati nello Spazio Economico Europeo (il "SEE"), nel Regno Unito (il "RU") o in Svizzera, e Runner AI agisca come Responsabile del Trattamento, l'Appendice C integra il presente DPA. In caso di conflitto tra l'Appendice C e altre sezioni del presente DPA, l'Appendice C prevarrà rispetto al trattamento dei Tuoi Dati Personali dei Clienti soggetti ai requisiti di protezione dei dati del SEE, RU e Svizzera. Per evitare dubbi, l'Appendice C non si applicherà alle attività di trattamento descritte nell'Appendice E.
Laddove il trattamento dei Dati Personali ai sensi del presente DPA sia soggetto alle Leggi sulla Protezione dei Dati degli Stati Uniti, e Runner AI agisca come Responsabile del Trattamento o Fornitore di Servizi, l'Appendice D integra il presente DPA. In caso di conflitto tra l'Appendice D e altre sezioni del presente DPA, l'Appendice D prevarrà rispetto al trattamento dei Tuoi Dati Personali dei Clienti soggetti alle Leggi sulla Protezione dei Dati degli Stati Uniti. Per evitare dubbi, l'Appendice D non si applicherà alle attività di trattamento descritte nell'Appendice E.
Se ricevi Servizi Avanzati da Runner AI (come definiti nella Sezione 9 dei Termini di Servizio), Runner AI tratterà i Tuoi Dati Personali dei Clienti come Titolare del Trattamento o Impresa come stabilito nell'Appendice E. In caso di conflitto tra l'Appendice E e altre sezioni del presente DPA, l'Appendice E prevarrà rispetto al trattamento da parte di Runner AI dei Tuoi Dati Personali dei Clienti come Titolare del Trattamento o Impresa.
### II. DEFINIZIONI
I termini con lettera maiuscola utilizzati ma non definiti nel presente DPA avranno lo stesso significato attribuito loro nei Termini:
**A. Legge/i Applicabile/i sulla Protezione dei Dati:** Qualsiasi legge sulla protezione dei dati o sulla privacy applicabile al trattamento dei Dati Personali da parte di Runner AI ai sensi dei Termini, i loro regolamenti di attuazione e legislazione secondaria, ciascuno come può essere modificato, aggiornato o sostituito di volta in volta, comprese tali leggi che si applicano in base alla posizione o residenza del Commerciante e/o dei Tuoi Clienti.
**B. Cliente:** Un individuo o entità che visita, interagisce con e/o acquista un prodotto, bene o servizio dal/i Tuo/i Negozio/i.
**C. Richiesta di Diritti sui Dati:** Una richiesta valida e legittima da parte di un individuo di esercitare i diritti disponibili relativi ai Dati Personali ai sensi di una Legge Applicabile sulla Protezione dei Dati.
**D. Titolare del Trattamento o Impresa:** La Parte che determina le finalità e i mezzi del trattamento dei Dati Personali, o come altrimenti definito da qualsiasi Legge Applicabile sulla Protezione dei Dati.
**E. Responsabile del Trattamento o Fornitore di Servizi:** La Parte o altra entità o impresa che fornisce servizi per conto di e tratta Dati Personali su indicazione e per conto del Titolare del Trattamento o come definito da qualsiasi Legge Applicabile sulla Protezione dei Dati.
**F. Dati Personali:** Informazioni o dati definiti come "dati personali", "informazioni personali" o "informazioni personalmente identificabili" (o termine analogo) ai sensi delle Leggi Applicabili sulla Protezione dei Dati.
**G. Violazione dei Dati Personali:** In relazione ai Tuoi Dati Personali dei Clienti, deve essere interpretata in conformità con le Leggi Applicabili sulla Protezione dei Dati.
**H. "Trattare", "tratta" o "trattamento":** (a) Qualsiasi operazione o insieme di operazioni eseguite su Dati Personali o su insiemi di Dati Personali, con o senza mezzi automatizzati, come raccolta, registrazione, organizzazione, strutturazione, conservazione, adattamento o alterazione, recupero, consultazione, utilizzo, divulgazione mediante trasmissione, diffusione o altrimenti messa a disposizione, allineamento o combinazione, limitazione, cancellazione o distruzione; o (b) la definizione attribuita a tale/i termine/i ai sensi della/e Legge/i Applicabile/i sulla Protezione dei Dati.
**I. "Subresponsabile/i del Trattamento":** Società affiliate o Responsabili del Trattamento o Fornitori di Servizi di terze parti che possono trattare Dati Personali su indicazione di Runner AI allo scopo di fornire i Servizi.
**J. "Tu", "Tuo" o "Commerciante":** Indica ciascuna impresa che gestisci e che utilizza o beneficia dei Servizi, dei Servizi Avanzati o di altri Servizi Aggiuntivi ed è Parte dei Termini con Runner AI.
**K. "Tuoi Dati Personali dei Clienti":** Dati Personali da o su Tuoi Clienti esclusi eventuali Dati Personali sui Clienti che Runner AI riceve a seguito della relazione del Cliente con Runner AI, che è disciplinata dalla Politica sulla Privacy dei Consumatori di Runner AI e non dal presente DPA.
### III. NATURA DEL TRATTAMENTO E RUOLI DELLE PARTI
**Runner AI come Responsabile del Trattamento o Fornitore di Servizi.** Runner AI riceve e tratta i Tuoi Dati Personali dei Clienti al fine di fornirti i Servizi e come altrimenti stabilito di seguito. A seconda di quali Servizi richiedi o utilizzi, Runner AI tratterà le categorie di Dati Personali di cui all'Appendice A, nei modi e sulle basi ivi contenute.
Runner AI tratterà i Tuoi Dati Personali dei Clienti come Responsabile del Trattamento o Fornitore di Servizi solo per fornire i Servizi indicati nei Termini e in eventuali Termini supplementari e come necessario per fornire, sviluppare e migliorare i suoi Servizi e impegnarsi in qualsiasi altra finalità consentita dalle Leggi Applicabili sulla Protezione dei Dati.
**Runner AI come Titolare del Trattamento o Impresa.** Runner AI tratterà i Tuoi Dati Personali dei Clienti come Titolare del Trattamento o Impresa (a) nelle circostanze e nei modi stabiliti nell'Appendice E, e (b) per eventuali finalità aggiuntive compatibili con le istruzioni del Cliente e la Legge Applicabile sulla Protezione dei Dati.
### IV. OBBLIGHI DELLE PARTI
La seguente sezione descrive i rispettivi obblighi delle Parti rispetto al trattamento dei Dati Personali coperti dal presente DPA.
#### A. Conformità Generale
1. Le Parti rispetteranno i rispettivi obblighi ai sensi delle Leggi Applicabili sulla Protezione dei Dati.
2. Runner AI non avrà alcun obbligo di interpretare o consigliarti sui Tuoi obblighi ai sensi delle Leggi Applicabili sulla Protezione dei Dati, incluso rispetto al trattamento dei Dati Personali coperti dal presente DPA. Sei l'unico responsabile della determinazione dei Tuoi obblighi legali e normativi, inclusa la valutazione se le misure tecniche e organizzative dei Servizi siano coerenti con i Tuoi obblighi legali e normativi indipendenti.
#### B. Obblighi di Runner AI
##### 1. Sicurezza dei Dati
Runner AI implementerà e manterrà misure tecniche e organizzative appropriate progettate per proteggere i Tuoi Dati Personali dei Clienti contro il trattamento non autorizzato o illecito e contro la perdita accidentale, distruzione, danno, furto, alterazione o divulgazione, come stabilito nell'Appendice B.
##### 2. Notifica e Indagine sulla Violazione dei Dati Personali
a) Come richiesto dalle Leggi Applicabili sulla Protezione dei Dati, Runner AI fornirà notifica a Te al momento della conferma da parte di Runner AI di qualsiasi Violazione dei Dati Personali.
b) Tale notifica includerà le informazioni richieste ai sensi delle Leggi Applicabili sulla Protezione dei Dati nella misura in cui tali informazioni siano ragionevolmente disponibili per Runner AI. La risposta di Runner AI a, o la notifica di, una Violazione dei Dati Personali non è un riconoscimento da parte di Runner AI di alcuna colpa o responsabilità.
c) Runner AI accetta di indagare su qualsiasi Violazione dei Dati Personali e di utilizzare sforzi commercialmente ragionevoli per identificare, prevenire, mitigare e rimediare gli effetti.
#### C. Tuoi Obblighi Rispetto ai Dati Personali
##### 1. Informative sulla Privacy e Trasparenza
Dichiari e garantisci di essere in conformità con tutti gli obblighi ai sensi delle Leggi Applicabili sulla Protezione dei Dati di fornire informativa e trasparenza riguardo al Tuo trattamento dei Tuoi Dati Personali dei Clienti ai sensi dei Termini e in relazione al Tuo utilizzo dei Servizi. Coerentemente con le Leggi Applicabili sulla Protezione dei Dati, comunicherai agli individui pertinenti tutte le informative necessarie affinché Runner AI tratti legalmente ed equamente i Tuoi Dati Personali dei Clienti in relazione al presente DPA, incluso quando ricevi Servizi Avanzati o altri Servizi Aggiuntivi, fornendo un link alla Politica sulla Privacy dei Consumatori di Runner AI e alla Tua Politica sulla Privacy e fornendo altre informative come stabilito nella Sezione 9 dei Termini.
##### 2. Diritti e Autorizzazioni dei Clienti
Dichiari e garantisci di avere tutti i diritti, le autorizzazioni e i consensi necessari per rendere disponibili i Tuoi Dati Personali dei Clienti a Runner AI, e affinché Runner AI tratti i Tuoi Dati Personali dei Clienti al fine di permetterti di ricevere i Servizi, inclusi Servizi Avanzati o altri Servizi Aggiuntivi che ricevi, in conformità con i Termini, il presente DPA e le Leggi Applicabili sulla Protezione dei Dati.
##### 3. Richieste di Diritti sui Dati
Dichiari e garantisci di fornire la capacità ai Tuoi Clienti di esercitare Richieste di Diritti sui Dati, come richiesto dalle Leggi Applicabili sulla Protezione dei Dati, rispetto al trattamento dei Tuoi Dati Personali dei Clienti da parte di Runner AI per i quali sei il Titolare del Trattamento.
##### 4. Richieste Normative
A meno che non sia vietato dalla legge applicabile, ci notificherai prontamente in conformità con la disposizione sulla Notifica nei Termini di qualsiasi indagine o reclamo governativo, normativo o di terze parti riguardante il Tuo utilizzo dei Servizi.
### V. VARIE
#### A. Trasferimenti Globali di Dati
Riconosci che i Tuoi Dati Personali dei Clienti possono essere trasferiti e trattati in qualsiasi paese in cui Runner AI, le sue società affiliate o fornitori di servizi di terze parti si trovano. Qualsiasi trasferimento dei Tuoi Dati Personali dei Clienti a questi destinatari sarà effettuato in conformità con le Leggi Applicabili sulla Protezione dei Dati. Per ulteriori informazioni sui trasferimenti internazionali di dati, laddove Runner AI sia soggetta ai requisiti di protezione dei dati nel SEE, RU o Svizzera, vedere Sezione II(B)(8) dell'Appendice C.
#### B. Risposta alle Richieste Legali
1. Riconosci che, nel corso della fornitura dei Servizi a Te, Runner AI può condividere i Tuoi Dati Personali dei Clienti (i) per conformarsi a requisiti legali o per rispondere a ordini giudiziari o altre richieste governative o normative simili; o (ii) per prevenire o indagare su presunta frode, minacce alla sicurezza fisica, attività illegale o violazioni di un contratto (come i Termini di Servizio) o delle nostre politiche (come la nostra Politica di Utilizzo Accettabile).
2. Runner AI farà ragionevoli sforzi prima di produrre i Tuoi Dati Personali dei Clienti per garantire che tale divulgazione sia consentita ai sensi delle Leggi Applicabili sulla Protezione dei Dati e sarà trattata come informazione confidenziale ai sensi del quadro giuridico applicabile.
#### C. Divulgazione nelle Transazioni Societarie
Riconosci che, nel corso della fornitura dei Servizi a Te, Runner AI potrebbe essere tenuta a condividere i Tuoi Dati Personali dei Clienti con potenziali controparti di qualsiasi transazione societaria o di ristrutturazione.
#### D. Utilizzo di Fornitori di Servizi da parte di Runner AI
1. Riconosci e accetti che, nel corso della fornitura dei Servizi a Te, Runner AI possa utilizzare fornitori di servizi per trattare i Tuoi Dati Personali dei Clienti. Runner AI mantiene un elenco aggiornato di tutti i fornitori di servizi utilizzati. Se le Leggi Applicabili sulla Protezione dei Dati ti concedono tali diritti, puoi opporti all'utilizzo da parte di Runner AI di un fornitore di servizi, e se Runner AI non è in grado o non vuole accogliere tali richieste, puoi, in conformità con tali leggi, terminare il Tuo utilizzo dei Servizi interessati entro 30 giorni da tale notifica in conformità con i Termini.
2. L'utilizzo da parte di Runner AI di fornitori di servizi per trattare i Tuoi Dati Personali dei Clienti che fornisci sarà in conformità con le Leggi Applicabili sulla Protezione dei Dati. Laddove Runner AI ingaggi un fornitore di servizi, Runner AI stipulerà un accordo scritto con il fornitore di servizi che impone obblighi contrattuali sostanzialmente uguali a quelli stabiliti nel presente DPA.
#### E. Modifica del DPA
Riconosci e accetti che Runner AI può modificare il presente DPA di volta in volta pubblicando il DPA modificato e ristabilito pertinente sul sito web di Runner AI, disponibile su https://www.runnerai.com/docs/it/legal/dpa e tali modifiche al DPA sono efficaci dalla data di pubblicazione. Il Tuo utilizzo continuato dei Servizi dopo che il DPA modificato è pubblicato sul sito web di Runner AI costituisce il Tuo accordo a, e l'accettazione del, DPA modificato. Se non sei d'accordo con eventuali modifiche al DPA, non continuare a utilizzare i Servizi.
### VI. APPENDICI
1. [Appendice A - Categorie di Dati Personali](#appendice-a-categorie-di-dati-personali)
2. [Appendice B - Sicurezza dei Dati](#appendice-b-sicurezza-dei-dati)
3. [Appendice C - GDPR, UK GDPR e Appendice sul Trattamento dei Dati della Svizzera](#appendice-c-gdpr-uk-gdpr-e-appendice-sul-trattamento-dei-dati-della-svizzera)
4. [Appendice D - Leggi sulla Protezione dei Dati degli Stati Uniti](#appendice-d-leggi-sulla-protezione-dei-dati-degli-stati-uniti)
5. [Appendice E - Runner AI come Titolare del Trattamento o Impresa per Servizi Avanzati](#appendice-e-runner-ai-come-titolare-del-trattamento-o-impresa-per-servizi-avanzati)
---
## APPENDICE A: CATEGORIE DI DATI PERSONALI
Nell'ambito del Tuo utilizzo dei Servizi, e a seconda di quali Servizi utilizzi, potremmo ricevere e trattare le seguenti categorie di Dati Personali per fornire i Servizi:
- Identificatori, inclusi nome, indirizzo email, indirizzo postale, numero di telefono
- Categorie di informazioni personali elencate nello statuto dei Registri dei Clienti della California, inclusi nome, indirizzo postale e di fatturazione, numero di telefono, informazioni su carte di credito o debito
- Informazioni commerciali, inclusi prodotti che acquisti, inserisci nel carrello, preferisci o recensisci (se sei un cliente) e informazioni che ci fornisci su di te e sulla tua attività (se sei un commerciante)
- Foto e video, che possono includere immagini del viso, se scegli di fornirle
- Informazioni sull'attività di rete Internet o elettronica, incluse informazioni relative al dispositivo e al browser che utilizzi, connessione di rete, indirizzo IP e come navighi attraverso i nostri siti
- Dati di geolocalizzazione, inclusi il tuo indirizzo postale e di fatturazione
- Inferenze, o informazioni derivate da altre informazioni personali su di te, che potrebbero includere le tue preferenze, interessi e altre informazioni utilizzate per personalizzare la tua esperienza
- Informazioni personali sensibili, che possono includere:
- Identificatori rilasciati dal governo, inclusi numero di previdenza sociale, patente di guida, carta d'identità statale o numero di passaporto
- Le tue credenziali di accesso all'account (come accesso all'account, conto finanziario, numero di carta di debito o credito in combinazione con qualsiasi codice di accesso di sicurezza richiesto, password o credenziali che consentono l'accesso a un account)
---
## APPENDICE B: SICUREZZA DEI DATI
Runner AI manterrà un programma di sicurezza delle informazioni progettato per (a) consentirti di proteggere i Tuoi Dati Personali dei Clienti contro il trattamento non autorizzato o illecito e contro la perdita accidentale, distruzione, danno, furto, alterazione o divulgazione; (b) identificare rischi ragionevolmente prevedibili per la sicurezza e la disponibilità dei Servizi che ricevi; e (c) ridurre al minimo i rischi di sicurezza per i Servizi.
### I. Il programma di sicurezza delle informazioni di Runner AI includerà le seguenti salvaguardie:
#### A. Sicurezza Logica
##### 1. Controlli di Accesso
Runner AI renderà i suoi sistemi accessibili solo al personale autorizzato, e solo nella misura necessaria per mantenere e fornire i Servizi. Runner AI manterrà controlli di accesso e politiche progettate per gestire le autorizzazioni per l'accesso ai suoi sistemi, incluso attraverso l'uso di firewall e/o altre tecnologie e controlli di autenticazione.
##### 2. Accesso Utente Limitato
Runner AI (i) fornirà e limiterà l'accesso ai suoi sistemi in conformità con i principi del minimo privilegio basati sulle funzioni lavorative del personale, e (ii) richiederà l'autenticazione a due fattori (2FA) per l'accesso ai suoi sistemi.
##### 3. Valutazioni delle Vulnerabilità
Runner AI manterrà un programma di valutazione delle vulnerabilità e test di penetrazione, responsabile dell'indagine e del monitoraggio dei problemi identificati con i Servizi fino alla risoluzione quando necessario.
##### 4. Sicurezza delle Applicazioni
Runner AI mantiene un programma di sicurezza delle applicazioni responsabile della protezione dei Servizi dalle minacce alla sicurezza delle applicazioni.
##### 5. Gestione dei Cambiamenti
Runner AI manterrà controlli progettati per registrare, autorizzare, testare, approvare e documentare le modifiche alle risorse dei Servizi esistenti e documenterà i dettagli delle modifiche nei suoi strumenti di gestione dei cambiamenti o di distribuzione. Runner AI testerà le modifiche secondo i suoi standard di gestione dei cambiamenti prima della migrazione alla produzione.
##### 6. Integrità dei Dati
Ove appropriato, Runner AI manterrà controlli progettati per fornire l'integrità dei dati durante la trasmissione, l'archiviazione e il trattamento all'interno dei Servizi.
##### 7. Disponibilità
Runner AI (i) implementerà la ridondanza ove appropriato per i Servizi per ridurre al minimo l'effetto di un malfunzionamento sui Servizi, (ii) progetterà i Servizi per anticipare e tollerare i guasti, e (iii) implementerà processi appropriati progettati per spostare il traffico dei Dati Personali lontano dalle aree interessate quando necessario per recuperare dai guasti.
##### 8. Continuità Aziendale e Ripristino di Emergenza
Runner AI manterrà un programma di gestione del rischio progettato per supportare la continuità delle sue funzioni aziendali critiche, inclusi processi e procedure per l'identificazione, la risposta e il recupero da eventi che potrebbero impedire o compromettere materialmente la fornitura da parte di Runner AI dei Servizi che ricevi.
##### 9. Gestione degli Incidenti
Runner AI fornisce documentazione per consentirti di segnalare incidenti di sicurezza o disponibilità, porre domande sulla sicurezza o disponibilità e inviare informazioni su potenziali problemi di sicurezza o disponibilità. Runner AI manterrà piani di azione correttiva e piani di risposta agli incidenti progettati per rilevare, mitigare, indagare e rispondere a potenziali minacce alla sicurezza per i Servizi.
#### B. Sicurezza Fisica
Laddove necessario per proteggere i Servizi, Runner AI (i) implementerà misure ragionevoli progettate per prevenire l'accesso fisico non autorizzato, danni o interferenze ai Servizi, (ii) utilizzerà dispositivi di controllo appropriati progettati per limitare l'accesso fisico ai Servizi solo al personale autorizzato che ha una legittima necessità aziendale per tale accesso, e (iii) eseguirà revisioni periodiche per convalidare l'aderenza a questi standard.
#### C. Dipendenti di Runner AI
I dipendenti di Runner AI che sono autorizzati ad accedere ai Tuoi Dati Personali dei Clienti sono vincolati da obblighi di riservatezza come parte dei loro termini di impiego. Runner AI implementerà e manterrà programmi di formazione sulla sicurezza dei dipendenti riguardo ai requisiti di sicurezza delle informazioni di Runner AI. I programmi di formazione sulla consapevolezza della sicurezza saranno rivisti e aggiornati periodicamente.
### II. Modifiche alla presente Appendice
Runner AI rivede periodicamente le sue misure di sicurezza e può aggiornare la presente Appendice a sua esclusiva discrezione. Tali aggiornamenti sostituiranno le versioni precedenti di questa Appendice alla data in cui Runner AI pubblica la versione aggiornata.
---
## APPENDICE C: GDPR, UK GDPR E APPENDICE SUL TRATTAMENTO DEI DATI DELLA SVIZZERA
Laddove il trattamento dei Tuoi Dati Personali dei Clienti ai sensi del DPA sia soggetto ai requisiti di protezione dei dati nello Spazio Economico Europeo (il "SEE"), nel Regno Unito (il "RU") o in Svizzera (collettivamente, "Leggi Europee sulla Protezione dei Dati"), e Runner AI agisca come Responsabile del Trattamento, l'Appendice C integra il presente DPA.
### I. Natura del Trattamento e Ruolo delle Parti
#### A. Dati Personali
Ai sensi della presente Appendice tu agirai come Titolare del Trattamento e Runner AI agirà come Responsabile del Trattamento rispetto al trattamento dei Tuoi Dati Personali dei Clienti come descritto nell'Allegato 1, come necessario per soddisfare le finalità commerciali delineate nei Termini e fornirti i Servizi che scegli di utilizzare.
### II. Obblighi delle Parti
#### A. Tuoi Obblighi
Dovrai conformarti a:
- Leggi Europee sulla Protezione dei Dati vincolanti per Te in relazione al Tuo utilizzo dei Servizi; e
- I Tuoi obblighi stabiliti nel DPA, inclusi i Tuoi obblighi stabiliti nella presente Appendice.
Dichiari e garantisci di avere una base giuridica valida per trattare i Tuoi Dati Personali dei Clienti (incluso rendere tali dati disponibili a Runner AI) e di aver ottenuto eventuali consensi, diritti e autorizzazioni necessari e fornito eventuali informative necessarie agli individui per consentire il trattamento da parte di Runner AI dei Tuoi Dati Personali dei Clienti per fornire i Servizi, come richiesto dalle Leggi Europee sulla Protezione dei Dati.
#### B. Obblighi di Runner AI
##### 1. Istruzioni del Titolare e Violazione delle Leggi Europee sulla Protezione dei Dati
a) Le Parti concordano che i Termini unitamente al presente DPA costituiscono le tue istruzioni documentate riguardo al trattamento da parte di Runner AI dei Tuoi Dati Personali dei Clienti ("Istruzioni documentate").
b) Runner AI tratterà i Tuoi Dati Personali dei Clienti come Responsabile del Trattamento: (i) in conformità con le Tue Istruzioni documentate, o (ii) per conformarsi agli obblighi di Runner AI ai sensi delle leggi applicabili, soggetto a eventuali requisiti di notifica ai sensi della legge del SEE, dello stato membro del SEE, del RU o della Svizzera a cui Runner AI è soggetta.
c) Runner AI ti notificherà se riceve un'istruzione che ragionevolmente determina violi le Leggi Europee sulla Protezione dei Dati (ma Runner AI non ha alcun obbligo di monitorare attivamente la Tua conformità con le Leggi Europee sulla Protezione dei Dati).
##### 2. Obbligo di riservatezza
Runner AI garantirà che le persone che autorizza a trattare i Tuoi Dati Personali dei Clienti stipulino accordi scritti di riservatezza o siano soggette a obblighi statutari di riservatezza.
##### 3. Misure di sicurezza
a) Runner AI implementerà e manterrà misure tecniche e organizzative appropriate progettate per proteggere i Tuoi Dati Personali dei Clienti contro il trattamento non autorizzato o illecito e contro la perdita accidentale, distruzione, danno, furto, accesso non autorizzato, alterazione o divulgazione, come stabilito nell'Allegato 2.
b) Tenendo conto della natura dei Tuoi Dati Personali dei Clienti e del relativo trattamento, Runner AI fornirà tale ragionevole assistenza come puoi ragionevolmente richiedere per aiutarti a soddisfare i Tuoi obblighi di sicurezza ai sensi delle Leggi Europee sulla Protezione dei Dati.
c) Runner AI ti fornirà notifica, senza indebito ritardo, al momento in cui viene a conoscenza di una violazione della sicurezza che porta alla distruzione accidentale o illecita, perdita, alterazione, divulgazione non autorizzata di, o accesso a, Tuoi Dati Personali dei Clienti trasmessi, archiviati o altrimenti trattati.
d) Runner AI accetta di indagare su qualsiasi tale violazione della sicurezza e di utilizzare sforzi commercialmente ragionevoli per mitigarne gli effetti.
##### 4. Subresponsabili del Trattamento
a) Autorizzi generalmente Runner AI a ingaggiare Subresponsabili del Trattamento per trattare i Tuoi Dati Personali dei Clienti. Accetti inoltre che Runner AI possa ingaggiare le sue affiliate come Subresponsabili del Trattamento.
b) L'utilizzo da parte di Runner AI di Subresponsabili del Trattamento per trattare i Tuoi Dati Personali dei Clienti sarà in conformità con le Leggi Europee sulla Protezione dei Dati.
c) Runner AI mantiene un elenco aggiornato di tutti i Subresponsabili del Trattamento come stabilito nell'Allegato 3. Runner AI aggiornerà l'elenco dei Subresponsabili del Trattamento in modo appropriato e ti fornirà un meccanismo per ottenere notifica dell'aggiunta o sostituzione di un Subresponsabile del Trattamento. Puoi opporti all'utilizzo da parte di Runner AI di un nuovo Subresponsabile del Trattamento.
d) Nella misura in cui ti opponi all'utilizzo da parte di Runner AI di un Subresponsabile del Trattamento, e Runner AI non è in grado o non vuole accogliere tali richieste, puoi terminare il Tuo utilizzo dei Servizi interessati entro 30 giorni da tale notifica in conformità con i Termini.
e) Laddove Runner AI ingaggi un nuovo Subresponsabile del Trattamento, Runner AI stipulerà un accordo scritto con il Subresponsabile del Trattamento e Runner AI imporrà, al Subresponsabile del Trattamento, obblighi contrattuali sostanzialmente uguali a quelli stabiliti nel presente DPA. Runner AI sarà pienamente responsabile per gli atti e le omissioni dei suoi Subresponsabili del Trattamento nella stessa misura in cui Runner AI sarebbe responsabile se eseguisse i servizi di ciascun Subresponsabile del Trattamento direttamente ai sensi dei termini del presente DPA. La responsabilità di Runner AI sarà comunque soggetta alle condizioni e alla limitazione di responsabilità stabilite nei Termini.
##### 5. Assistenza al Titolare
Tenendo conto della natura dei Tuoi Dati Personali dei Clienti e del relativo trattamento, Runner AI fornirà tale ragionevole assistenza come puoi ragionevolmente richiedere per assisterti nell'adempimento dei Tuoi obblighi:
- per rispondere alle Richieste di Diritti sui Dati ai sensi delle Leggi Europee sulla Protezione dei Dati, rispetto a tutto il trattamento dei Tuoi Dati Personali dei Clienti da parte di Runner AI;
- per notificare alle autorità pertinenti e/o agli interessati una Violazione dei Dati Personali;
- per condurre valutazioni d'impatto sulla protezione dei dati e consultazioni preventive;
- per garantire la sicurezza del trattamento in conformità con la sezione 3.
##### 6. Valutazione della conformità
a) Runner AI può soddisfare il Tuo diritto di audit ai sensi delle Leggi Europee sulla Protezione dei Dati in relazione al trattamento dei Tuoi Dati Personali dei Clienti fornendoti - su Tua richiesta scritta e soggetto a riservatezza - con:
(i) I risultati dell'audit più recente di Runner AI, provenienti dagli auto-audit di Runner AI o preparati da un revisore indipendente di terze parti;
(ii) informazioni aggiuntive sotto il controllo di Runner AI se un'autorità di protezione dei dati o governativa lo richiede.
b) A condizione che e solo nella misura in cui le Leggi Europee sulla Protezione dei Dati ti concedano questo diritto, puoi esercitare il Tuo diritto di Audit: (i) nella misura in cui un revisore internazionalmente riconosciuto indipendente attesti che la fornitura da parte di Runner AI di un rapporto di audit non fornisce informazioni sufficienti per verificare la conformità di Runner AI con il presente DPA e con le Leggi Europee sulla Protezione dei Dati o (ii) come necessario per rispondere a un audit dell'autorità governativa. Ogni audit deve conformarsi ai seguenti parametri: (i) essere condotto da una terza parte indipendente che stipulerà un accordo di riservatezza con Runner AI; (ii) essere limitato nell'ambito alle questioni ragionevolmente richieste, e come reciprocamente concordato, per valutare la conformità di Runner AI con il presente DPA e la conformità delle parti con le Leggi Europee sulla Protezione dei Dati; (iii) avvenire in una data e ora reciprocamente concordate e solo durante il normale orario lavorativo di Runner AI; (iv) avvenire non più di una volta all'anno (a meno che non sia richiesto dalle Leggi Europee sulla Protezione dei Dati); (v) coprire solo le strutture controllate da Runner AI; (vi) limitare i risultati solo ai Tuoi Dati Personali dei Clienti; e (vii) trattare eventuali risultati come informazioni confidenziali nella massima misura consentita dalle Leggi Europee sulla Protezione dei Dati. Per chiarimento, Runner AI rispetterà i Tuoi diritti ai sensi di questa sezione 6 in conformità con i suoi obblighi di riservatezza con terze parti.
##### 7. Fine del trattamento
a) Durante il Tuo utilizzo dei Servizi, puoi sfruttare gli strumenti dell'account per accedere, restituire a te stesso o eliminare i Tuoi Dati Personali dei Clienti.
b) A seguito della cessazione, Runner AI, a Tua scelta, eliminerà o restituirà i Tuoi Dati Personali dei Clienti. Nonostante quanto precede, Runner AI può conservare i Tuoi Dati Personali dei Clienti: (i) come richiesto dalla legge, incluse le Leggi Europee sulla Protezione dei Dati; e (ii) in conformità con le sue politiche standard di backup o conservazione dei registri, a condizione che, in entrambi i casi, Runner AI mantenga la riservatezza dei, e in altro modo rispetti le disposizioni applicabili del presente DPA rispetto ai, Tuoi Dati Personali dei Clienti conservati, e non Tratti ulteriormente i Tuoi Dati Personali dei Clienti conservati se non per tale/i finalità e durata consentita da tali leggi applicabili.
##### 8. Trasferimenti Internazionali
a) Riconosci che nel corso della fornitura dei Servizi, Adaptive Machines, Inc., una società con sede negli Stati Uniti, tratterà i Tuoi Dati Personali dei Clienti su server situati negli Stati Uniti.
b) Quando Runner AI si impegna in un Trasferimento Internazionale (vale a dire un trasferimento dei Tuoi Dati Personali dei Clienti dallo Spazio Economico Europeo (SEE), dal Regno Unito (RU) o dalla Svizzera a un paese al di fuori di tali regioni che non è riconosciuto come fornitore di un livello adeguato di protezione dei dati), lo farà in conformità con le Leggi Europee sulla Protezione dei Dati.
c) Nella misura in cui Runner AI sia il destinatario dei Tuoi Dati Personali dei Clienti in un paese che non garantisce un livello adeguato di protezione dei dati, le Parti concordano che tali trasferimenti saranno soggetti a garanzie appropriate, specificamente i seguenti meccanismi di trasferimento: (i) Le Clausole Contrattuali Standard per il trasferimento di dati personali a paesi terzi ai sensi del Regolamento (UE) 2016/679 del Parlamento Europeo e del Consiglio, come approvate dalla Decisione di Esecuzione della Commissione Europea (UE) 2021/914 del 4 giugno 2021 (le "SCC dell'UE"); e/o (ii) Per i trasferimenti dal Regno Unito, l'Addendum Internazionale sul Trasferimento dei Dati alle clausole contrattuali standard della Commissione Europea, emesso dall'Ufficio del Commissario per le Informazioni del Regno Unito ai sensi della S119A(1) del UK Data Protection Act 2018 (l'"Addendum del RU"); e/o (iii) Per i trasferimenti dalla Svizzera, le SCC dell'UE come modificate per soddisfare i requisiti della Legge Federale Svizzera sulla Protezione dei Dati.
d) Accettando il presente DPA, si considera che tu abbia firmato i meccanismi di trasferimento applicabili, che sono incorporati per riferimento e formano parte integrante del presente DPA.
### ALLEGATO 1 - DATI PERSONALI
#### DESCRIZIONE DEL TRATTAMENTO DEI DATI PERSONALI
**I. Oggetto del Trattamento**
Fornitura dei Servizi Runner AI al Commerciante.
**II. Categorie di Interessati**
Clienti del Commerciante.
**III. Categorie di Dati Personali Trattati**
Vedi Appendice A sopra.
**IV. Frequenza del trasferimento**
Continua.
**V. Natura del Trattamento**
Raccolta, registrazione, hosting, accesso, utilizzo, trasferimento ed eliminazione di Dati Personali come descritto nei Termini.
**VI. Finalità per le Quali i Dati Personali sono Trattati per Conto del Titolare**
Per l'esecuzione e il miglioramento dei Servizi come descritto nei Termini.
**VII. Durata del Trattamento**
Durata dei Servizi ai sensi dei Termini o dell'accordo applicabile, più il periodo successivo a tale scadenza fino all'anonimizzazione, restituzione o eliminazione dei dati.
**VIII. Autorità di Controllo Competente**
L'autorità di controllo competente sarà determinata in conformità con il GDPR.
### ALLEGATO 2 - MISURE DI SICUREZZA
Le informazioni sulle misure di sicurezza sono fornite nell'Appendice B del DPA.
### ALLEGATO 3 - ELENCO DEI SUBRESPONSABILI DEL TRATTAMENTO
I Subresponsabili del Trattamento utilizzati da Runner AI per l'esecuzione dei Servizi ai sensi dei Termini sono elencati qui.
I Subresponsabili del Trattamento tratteranno le categorie di Dati Personali descritte sopra in relazione ai Servizi per la durata del loro accordo con Runner AI.
---
## APPENDICE D: LEGGI SULLA PROTEZIONE DEI DATI DEGLI STATI UNITI
La presente sezione si applica solo nella misura in cui: (i) le Leggi sulla Protezione dei Dati degli Stati Uniti si applicano a Te e/o ai Tuoi Dati Personali dei Clienti in relazione al Tuo utilizzo dei Servizi; (ii) le seguenti disposizioni siano richieste dalle Leggi sulla Protezione dei Dati degli Stati Uniti; e (iii) Runner AI agisca come Responsabile del Trattamento o Fornitore di Servizi. Per evitare dubbi, la presente Appendice D non si applicherà alle attività di trattamento descritte nell'Appendice E.
Le Parti concordano che i Termini unitamente al presente DPA costituiscono le tue istruzioni documentate riguardo al trattamento da parte di Runner AI dei Tuoi Dati Personali dei Clienti ("Istruzioni documentate").
A parte quanto stabilito nell'Appendice E se ricevi determinati Servizi Avanzati, Runner AI non: (i) conserverà, utilizzerà o divulgherà i Tuoi Dati Personali dei Clienti al di fuori della sua relazione commerciale diretta con Te o per qualsiasi altro scopo diverso dalle finalità limitate e specifiche identificate nel presente DPA e/o nei Termini, incluso fornire, sviluppare e migliorare i Servizi o come altrimenti consentito dalle Leggi Applicabili sulla Protezione dei Dati degli Stati Uniti, o (ii) "venderà" o "condividerà" i Tuoi Dati Personali dei Clienti o si impegnerà in "pubblicità mirata" con i Tuoi Dati Personali dei Clienti ai sensi del CCPA o di altre Leggi sulla Protezione dei Dati degli Stati Uniti; o (iii) combinerà i Tuoi Dati Personali dei Clienti con Dati Personali che riceve da altre fonti, in ciascun caso tranne come consentito dalle Leggi sulla Protezione dei Dati degli Stati Uniti.
Runner AI: (i) fornirà lo stesso livello di protezione della privacy richiesto alle Imprese o ai Titolari del Trattamento dalle Leggi sulla Protezione dei Dati degli Stati Uniti, e ti informerà se determina di non poter più soddisfare questi obblighi, nel qual caso puoi adottare misure ragionevoli e appropriate per fermare o rimediare a qualsiasi trattamento non autorizzato dei Tuoi Dati Personali dei Clienti, (ii) garantirà che il personale che autorizza a trattare i Tuoi Dati Personali dei Clienti stipuli accordi scritti di riservatezza o sia soggetto a obblighi statutari di riservatezza, (iii) su ragionevole richiesta scritta, e come parte del consentire di adottare misure ragionevoli e appropriate per garantire che Runner AI utilizzi i Tuoi Dati Personali dei Clienti in modo coerente con le Leggi sulla Protezione dei Dati degli Stati Uniti, fornire il rapporto SOC2 che mostra una ragionevole valutazione del programma di sicurezza delle informazioni di Runner AI; e (iv) alla cessazione dei suoi Servizi a Te, Runner AI avvierà il suo processo di eliminazione per eliminare, restituire o de-identificare i Tuoi Dati Personali dei Clienti forniti a Runner AI per il trattamento esclusivamente come Responsabile del Trattamento o Fornitore di Servizi.
Dichiari e garantisci che non condividerai con Runner AI alcun Dato Personale di un individuo che ha esercitato un diritto di rinuncia che ti sei impegnato a onorare o alcun Dato Personale sensibile di un individuo che non ha acconsentito al trattamento di tali dati sensibili in conformità con i requisiti delle Leggi Applicabili sulla Protezione dei Dati.
---
## APPENDICE E: RUNNER AI COME TITOLARE DEL TRATTAMENTO O IMPRESA PER SERVIZI AVANZATI
Runner AI agirà come Titolare del Trattamento o Impresa quando ricevi i Servizi Avanzati come definiti nella Sezione 9 dei Termini di Servizio. Runner AI può aggiornare i servizi e i prodotti per i quali agisce come Titolare del Trattamento o Impresa di volta in volta.
Nell'ambito della fornitura da parte di Runner AI dei Servizi Avanzati, accetti che Runner AI tratterà i Tuoi Dati Personali dei Clienti come Titolare del Trattamento o Impresa ai sensi delle Leggi Applicabili sulla Protezione dei Dati al fine di fornire, sviluppare e migliorare analisi, personalizzazione dei prodotti, pubblicità e altri servizi a Te e ad altri Commercianti che incorporano le interazioni e le transazioni dei Tuoi Clienti con il Tuo Negozio, con altri Commercianti e con Runner AI. Quando Runner AI tratta i Tuoi Dati Personali dei Clienti in questo modo, si applicano la Politica sulla Privacy dei Consumatori di Runner AI e la presente Appendice E del presente DPA. Puoi disabilitare l'utilizzo da parte di Runner AI dei Tuoi Dati Personali dei Clienti in questo modo disabilitando Runner AI Network Intelligence qui.
### 1. Informative sulla Privacy, Trasparenza e Diritti
Coerentemente con le Leggi Applicabili sulla Protezione dei Dati, comunicherai agli individui pertinenti tutte le informative necessarie affinché Runner AI tratti legalmente ed equamente i Tuoi Dati Personali dei Clienti per fornire Servizi Avanzati a Te in relazione alla presente Appendice E del DPA, incluso fornendo un link alla Politica sulla Privacy dei Consumatori di Runner AI nella tua politica sulla privacy e fornendo le informative come stabilito nella Sezione 9.2.5 dei Termini di Servizio.
### 2. Requisiti Europei
Se hai sede nel SEE, Regno Unito o Svizzera, o se i Tuoi Clienti sono nel SEE, Regno Unito o Svizzera, accetti, dichiari e garantisci di aver ottenuto il consenso dai Clienti, e fornire ai Clienti la capacità di esercitare il diritto di ritirare il consenso, opporsi a determinati trattamenti e rinunciare a determinati trattamenti, laddove richiesto dalle Leggi Applicabili sulla Protezione dei Dati. Per evitare dubbi, devi ottenere il consenso per la pubblicità mirata nell'ambito dei Servizi Avanzati e l'uso di cookie o altre tecnologie di archiviazione locale nella misura richiesta dalle Leggi Applicabili sulla Protezione dei Dati.
### 3. Responsabilità del Titolare
Tu sei un Titolare del Trattamento dei Tuoi Dati Personali dei Clienti e determinerai individualmente le finalità e i mezzi del Tuo trattamento dei Tuoi Dati Personali dei Clienti e come utilizzare e trattare i Tuoi Dati Personali dei Clienti, inclusa la determinazione della base giuridica per il Tuo trattamento ai sensi della Legge Applicabile sulla Protezione dei Dati. Runner AI è un Titolare del Trattamento dei Tuoi Dati Personali dei Clienti che tratta in conformità con la presente Appendice E e determinerà individualmente le finalità e i mezzi del suo trattamento di tali Dati Personali e come utilizzare e trattare tali Dati Personali, inclusa la determinazione della base giuridica per il suo trattamento ai sensi della Legge Applicabile sulla Protezione dei Dati.
Ciascuna Parte è individualmente responsabile della risposta alle Richieste di Diritti sui Dati che riceve relative al suo trattamento dei Tuoi Dati Personali dei Clienti come Titolare del Trattamento.
### 4. Nessun Effetto sul Resto del DPA
La presente Appendice E non influenzerà altrimenti alcun Termine, incluso il resto del presente DPA, che riflette una relazione Titolare del Trattamento-Responsabile del Trattamento tra Commercianti e Runner AI.
---
# Informativa sulla Privacy per tutti
Source: https://www.runnerai.com/docs/it/legal/policies
## Indice
1. [Introduzione](#introduzione)
2. [I nostri valori](#i-nostri-valori)
3. [Perché trattiamo le tue informazioni](#perché-trattiamo-le-tue-informazioni)
4. [I tuoi diritti sulle tue informazioni](#i-tuoi-diritti-sulle-tue-informazioni)
5. [Dove inviamo le tue informazioni](#dove-inviamo-le-tue-informazioni)
6. [Google user data and Google integrations](#google-user-data-and-google-integrations)
7. [Per quanto tempo conserviamo le tue informazioni](#per-quanto-tempo-conserviamo-le-tue-informazioni)
8. [Il nostro utilizzo del Machine Learning](#il-nostro-utilizzo-del-machine-learning)
9. [Come proteggiamo le tue informazioni](#come-proteggiamo-le-tue-informazioni)
10. [Come utilizziamo i "cookies" e altre tecnologie di tracciamento](#come-utilizziamo-i-cookies-e-altre-tecnologie-di-tracciamento)
11. [Come puoi contattarci](#come-puoi-contattarci)
12. [Informativa sulla Privacy Regionale degli Stati Uniti](#informativa-sulla-privacy-regionale-degli-stati-uniti)
13. [Informazioni Aggiuntive per Utenti in Determinate Regioni](#informazioni-aggiuntive-per-utenti-in-determinate-regioni)
## Introduzione
La presente Informativa sulla Privacy descrive come Adaptive Machines, Inc. ("Runner AI", "noi", "ci" o "nostro/a") raccoglie, utilizza e divulga informazioni personali quando utilizzi il nostro sito web e i nostri servizi.
Nella nostra missione di migliorare il commercio per tutti presso Runner AI, raccogliamo e utilizziamo informazioni su di te, nostro:
- commerciante che utilizza Runner AI per gestire la propria attività
- cliente che acquista presso un'attività alimentata da Runner AI
- visitatore dei siti web di Runner AI, o chiunque contatti il supporto di Runner AI
Se modifichiamo le nostre pratiche sulla privacy, potremmo aggiornare questa informativa sulla privacy. Se eventuali modifiche sono significative, te lo faremo sapere (ad esempio, tramite l'amministrazione di Runner AI o via email).
## I nostri valori
La fiducia è il fondamento della piattaforma Runner AI e include fidarsi di noi per fare la cosa giusta con le tue informazioni. Tre valori principali ci guidano mentre sviluppiamo i nostri prodotti e servizi. Questi valori dovrebbero aiutarti a comprendere meglio come pensiamo alle tue informazioni e alla privacy.
### Le tue informazioni appartengono a te
Analizziamo attentamente quali tipi di informazioni sono necessari per fornire i nostri servizi e cerchiamo di limitare le informazioni che raccogliamo solo a ciò di cui abbiamo realmente bisogno. Quando possibile, eliminiamo o rendiamo anonime queste informazioni quando non ne abbiamo più bisogno. Durante la creazione e il miglioramento dei nostri prodotti, i nostri ingegneri lavorano a stretto contatto con i nostri team di privacy e sicurezza per progettare pensando alla privacy. In tutto questo lavoro, il nostro principio guida è che le tue informazioni appartengono a te e miriamo a utilizzare le tue informazioni solo a tuo vantaggio.
### Proteggiamo le tue informazioni dagli altri
Se una terza parte richiede le tue informazioni personali, rifiuteremo di condividerle a meno che tu non ci dia il permesso o siamo legalmente obbligati. Quando siamo legalmente obbligati a condividere le tue informazioni personali, te lo diremo in anticipo, a meno che non sia legalmente vietato.
### Aiutiamo i commercianti a soddisfare i loro obblighi sulla privacy
Molti dei commercianti che utilizzano Runner AI non hanno il beneficio di un team dedicato alla privacy, ed è importante per noi aiutarli a soddisfare i loro obblighi sulla privacy. Per fare ciò, cerchiamo di costruire i nostri prodotti e servizi in modo che possano essere facilmente utilizzati in modo rispettoso della privacy. Forniamo anche FAQ dettagliate e documentazione che copre gli argomenti sulla privacy più importanti e rispondiamo alle domande relative alla privacy che riceviamo.
## Perché trattiamo le tue informazioni
Generalmente trattiamo le tue informazioni quando dobbiamo farlo per adempiere a un obbligo contrattuale (ad esempio, per elaborare i pagamenti del tuo abbonamento per utilizzare la piattaforma Runner AI), o quando noi o qualcuno con cui lavoriamo dobbiamo utilizzare le tue informazioni personali per un motivo correlato alla loro attività (ad esempio, per fornirti un servizio). Le leggi nello Spazio Economico Europeo ("SEE") e nel Regno Unito ("UK") chiamano questi motivi "interessi legittimi". Questi "interessi legittimi" includono:
- prevenzione di rischi e frodi
- risposta a domande o fornitura di altri tipi di supporto
- fornitura e miglioramento dei nostri prodotti e servizi
- fornitura di reporting e analisi
- test di funzionalità o servizi aggiuntivi
- assistenza con marketing, pubblicità o altre comunicazioni
Trattiamo informazioni personali per questi "interessi legittimi" solo dopo aver considerato i potenziali rischi per la tua privacy e bilanciato eventuali rischi con determinate misure, ad esempio fornendo chiara trasparenza nelle nostre pratiche sulla privacy, offrendoti il controllo sulle tue informazioni personali ove appropriato, limitando le informazioni che conserviamo, limitando ciò che facciamo con le tue informazioni, a chi inviamo le tue informazioni, per quanto tempo conserviamo le tue informazioni o le misure tecniche che utilizziamo per proteggere le tue informazioni.
Potremmo anche trattare le tue informazioni personali quando hai fornito il tuo consenso. In particolare, quando non possiamo fare affidamento su una base legale alternativa per il trattamento, quando ci indichi di trasferire informazioni a una terza parte, quando riceviamo i tuoi dati da una terza parte che li ha già ottenuti con consenso o quando siamo tenuti per legge a richiedere il tuo consenso (incluso nel contesto di alcune delle nostre attività di vendita e marketing). In qualsiasi momento, hai il diritto di ritirare il tuo consenso modificando le tue scelte di comunicazione, rinunciando alle nostre comunicazioni o contattandoci.
A seconda che tu sia un commerciante, cliente o visitatore, consulta le nostre informative sulla privacy supplementari, se pertinenti, per comprendere i nostri scopi di trattamento, le categorie di destinatari e la base legale per il trattamento di ciascun tipo di dati personali.
## I tuoi diritti sulle tue informazioni
Riteniamo che tu debba essere in grado di accedere e controllare le tue informazioni personali indipendentemente da dove vivi. A seconda di come utilizzi Runner AI, potresti avere il diritto di richiedere l'accesso a, correggere, modificare, eliminare, trasferire a un altro fornitore di servizi, limitare o opporti a determinati usi delle tue informazioni personali. Non ti addebiteremo di più o ti forniremo un livello di servizio diverso se eserciti uno qualsiasi di questi diritti. Si prega di notare che molti di questi diritti si applicano solo in determinate circostanze e tutti questi diritti possono essere limitati dalla legge.
Se acquisti qualcosa da o fornisci in altro modo le tue informazioni a un negozio alimentato da Runner AI e desideri esercitare questi diritti sulle informazioni relative al tuo acquisto o interazione, devi contattare direttamente il commerciante con cui hai interagito. Siamo un responsabile del trattamento ed elaboriamo informazioni per loro conto. Ovviamente aiuteremo i nostri commercianti a soddisfare queste richieste nella misura richiesta dalla legge, ad esempio fornendo loro gli strumenti per farlo e rispondendo alle loro domande.
Se sei un commerciante, dipendente di Runner AI, visitatore del sito web o altro individuo con cui Runner AI ha una relazione diretta, ti preghiamo di inviare una richiesta verificabile via email a support@adaptivemachines.ai. Si prega di notare che se ci invii una richiesta relativa alle tue informazioni personali, dobbiamo assicurarci che sia tu prima di poter rispondere. Per farlo, potremmo utilizzare una terza parte per raccogliere e verificare documenti di identificazione. Ulteriori informazioni sui diritti disponibili per i residenti negli Stati Uniti possono essere trovate di seguito sotto l'intestazione "Informativa sulla Privacy Regionale degli Stati Uniti".
Infine, poiché non esiste una comprensione comune su cosa significhi un segnale "Do Not Track", non rispondiamo a tali segnali in alcun modo particolare.
## Dove inviamo le tue informazioni
Siamo un'azienda americana, ma lavoriamo con ed elaboriamo dati su individui in tutto il mondo. Per gestire la nostra attività, potremmo inviare le tue informazioni personali al di fuori del tuo stato, provincia o paese. Questi dati possono essere soggetti alle leggi dei paesi in cui li inviamo. Adottiamo misure per proteggere le tue informazioni quando inviamo le tue informazioni oltre i confini.
A seconda che tu sia un commerciante, cliente, utente o visitatore, consulta le nostre informative sulla privacy supplementari, se pertinenti.
Infine, sebbene facciamo tutto il possibile per proteggere le tue informazioni, a volte potremmo essere legalmente obbligati a divulgare le tue informazioni personali (ad esempio, se riceviamo un'ordinanza del tribunale valida).
Quando trasferiamo informazioni personali dallo Spazio Economico Europeo (SEE), dal Regno Unito o dalla Svizzera verso paesi che non sono stati ritenuti fornire un livello adeguato di protezione dei dati, ci affidiamo a meccanismi legali come le Clausole Contrattuali Standard approvate dalla Commissione Europea per salvaguardare il trasferimento.
## Google user data and Google integrations
This section applies when you use Google Sign-In or connect Google Ads, Google Merchant Center, or another Google service to Runner AI.
### What Google user data we access and store
For Google Sign-In, we access the Google account information you authorize, such as your name, email address, profile image, and Google account identifier, to create or log in to your Runner AI account.
For Google Ads and Google Merchant Center integrations, we request the Google OAuth scopes needed to provide the ads features you choose, including `https://www.googleapis.com/auth/adwords` and `https://www.googleapis.com/auth/content`. Depending on the features you use, we may store OAuth access tokens, refresh tokens, granted scopes, token expiration data, accessible Google Ads customer account identifiers, account names, manager-account status, and selected account bindings. We may also access and process Google Ads campaign, ad group, ad, creative, asset, budget, bidding, targeting, performance metric, conversion value, ROAS, and change-history data, including the user email associated with a Google Ads account change, as well as Google Merchant Center account identifiers and account names.
### How we use Google user data
We use Google user data only to provide or improve user-facing Runner AI features that you request, including signing you in, connecting and refreshing your Google integrations, listing selectable Google Ads and Merchant Center accounts, showing ads dashboards and reports, generating requested AI ads analysis or campaign drafts, publishing or updating campaigns you approve, syncing account access, and troubleshooting or securing those features.
We do not sell Google user data. We do not use Google user data for retargeting, personalized advertising unrelated to your requested Runner AI ads features, credit-worthiness, lending, or transfer to data brokers or information resellers.
### With whom we share, transfer, or disclose Google user data
We share, transfer, or disclose Google user data only in the following circumstances:
- **Google LLC.** We send authorization codes, OAuth tokens, developer-token-authenticated requests, campaign settings, Merchant Center identifiers, and related API request data to Google APIs so that we can authenticate your account, read the Google Ads or Merchant Center data you authorized, and perform the Google Ads or Merchant Center actions you request.
- **Your authorized Runner AI organization users.** Google Ads account metadata, reports, metrics, creatives, change history, Merchant Center account metadata, and campaign drafts may be visible to users in your Runner AI organization according to their workspace permissions.
- **Service providers and subprocessors.** We may share Google user data with service providers that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI, subject to confidentiality and data-processing obligations. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- **Legal, safety, and business-transfer recipients.** We may disclose Google user data when required by law, to protect rights, safety, and security, to investigate abuse, or in connection with a merger, acquisition, financing, reorganization, bankruptcy, or sale of assets, as described elsewhere in this Privacy Policy.
Except as described above or with your explicit direction, we do not share, transfer, or disclose Google user data to third-party advertising platforms, data brokers, information resellers, or other third parties.
### Retention and user control
We retain connected Google integration tokens and account metadata while the integration remains enabled or as needed to provide the Services, comply with law, resolve disputes, enforce agreements, maintain security, or keep backups. Disconnecting Google Ads in Runner AI deletes the active Google Ads integration record, including stored OAuth tokens and account metadata. You can also revoke Runner AI's Google access from your Google account settings.
Runner AI's use and transfer of information received from Google APIs will adhere to the [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy), including the Limited Use requirements.
## Per quanto tempo conserviamo le tue informazioni
Conserveremo i tuoi dati personali solo per il tempo necessario a soddisfare gli scopi per cui li abbiamo raccolti. Per determinare il periodo di conservazione appropriato, consideriamo la quantità, la natura e la sensibilità dei tuoi dati personali, il potenziale rischio di danno derivante dall'uso o dalla divulgazione non autorizzati dei tuoi dati personali, gli scopi per cui trattiamo i tuoi dati personali e se possiamo raggiungere tali scopi attraverso altri mezzi e i requisiti legali applicabili. Conserveremo e utilizzeremo anche le tue informazioni personali nella misura necessaria per conformarci ai nostri obblighi legali, risolvere controversie e far rispettare le nostre politiche. Se smetti di utilizzare i nostri servizi o se elimini il tuo account con noi, elimineremo le tue informazioni o conserveremo le tue informazioni in formato aggregato e anonimizzato.
A seconda che tu sia un commerciante, cliente, utente o visitatore, consulta le nostre informative sulla privacy supplementari, se pertinenti, per ulteriori dettagli sulla conservazione delle tue informazioni personali.
## Il nostro utilizzo del Machine Learning
Per fornire le nostre funzionalità avanzate basate sull'IA per operazioni automatizzate e crescita, la nostra piattaforma utilizza il machine learning. Utilizziamo queste tecnologie per fornire servizi come analisi predittive, suggerimenti per campagne di marketing e raccomandazioni per l'ottimizzazione delle conversioni.
Le nostre funzionalità IA sono progettate come strumenti di supporto decisionale. Generano suggerimenti basati sui dati per la tua considerazione. Queste non sono decisioni automatizzate. Tu, il commerciante, mantieni il pieno controllo e sei l'unico responsabile della revisione, approvazione e implementazione di qualsiasi suggerimento fornito dalla nostra IA. Il Servizio eseguirà azioni solo su tua esplicita approvazione o in base alle impostazioni che hai preconfigurato. La nostra base legale per l'utilizzo dei tuoi dati per questi scopi è ulteriormente dettagliata nei nostri Termini di Servizio nella clausola "Utilizzo dei Dati per il Miglioramento dell'IA".
## Come proteggiamo le tue informazioni
I nostri team lavorano instancabilmente per proteggere le tue informazioni e per garantire la sicurezza e l'integrità della nostra piattaforma. Abbiamo anche revisori indipendenti che valutano la sicurezza della nostra archiviazione dei dati e dei sistemi che elaborano informazioni finanziarie. Tuttavia, sappiamo tutti che nessun metodo di trasmissione su Internet e nessun metodo di archiviazione elettronica può essere sicuro al 100%. Ciò significa che non possiamo garantire la sicurezza assoluta delle tue informazioni personali.
## Come utilizziamo i "cookies" e altre tecnologie di tracciamento
Utilizziamo cookies e tecnologie di tracciamento simili sul nostro sito web e quando forniamo i nostri servizi. Per ulteriori informazioni su come utilizziamo queste tecnologie, incluso un elenco di altre società che inseriscono cookies sui nostri siti, un elenco di cookies che inseriamo quando alimentiamo il negozio di un commerciante e una spiegazione di come puoi rinunciare a determinati tipi di cookies, consulta la nostra Politica sui Cookie.
## Come puoi contattarci
Se desideri chiedere informazioni, fare una richiesta relativa a o lamentarti di come trattiamo le tue informazioni personali, contatta il Supporto di Runner AI via email all'indirizzo support@adaptivemachines.ai, o inviaci una lettera agli indirizzi di seguito:
Adaptive Machines, Inc.
2911 Noyce Place, 189, Santa Clara, CA 95051, USA
Se acquisti qualcosa da o fornisci in altro modo le tue informazioni a un negozio alimentato da Runner AI, il commerciante è il tuo titolare del trattamento dei dati e noi agiamo come responsabile del trattamento per loro conto.
Se hai domande su come un commerciante o negozio tratta le tue informazioni personali, dovresti contattare il commerciante o visitare la loro informativa sulla privacy.
## Informativa sulla Privacy Regionale degli Stati Uniti
Questa Informativa sulla Privacy Regionale degli Stati Uniti ("Informativa USA") integra la nostra Informativa sulla Privacy e tutte le informative sulla privacy supplementari su /it/legal/policies (insieme, le "Informative sulla Privacy di Runner AI").
Questa Informativa USA è per individui residenti in determinati stati degli Stati Uniti ed è progettata per aiutarti a comprendere meglio come raccogliamo, utilizziamo e divulghiamo le tue informazioni personali e, a seconda di come utilizzi Runner AI e dove risiedi, come esercitare i diritti disponibili in base a varie leggi sulla privacy applicabili negli Stati Uniti, in particolare il California Consumer Privacy Act, il Colorado Privacy Act, il Connecticut Act Concerning Personal Data Privacy and Online Monitoring, lo Utah Consumer Privacy Act e il Virginia Consumer Data Protection Act (collettivamente, le "Leggi sulla Privacy USA").
### 11.1 Quali informazioni raccogliamo e condividiamo su di te
Per fornirti i nostri servizi, dobbiamo trattare informazioni su di te, incluse informazioni personali.
Non "vendiamo" le tue informazioni personali come tale termine è definito nelle Leggi sulla Privacy USA.
Ecco un riepilogo delle categorie di informazioni personali che potremmo raccogliere su di te in futuro e con chi potremmo aver divulgato tali informazioni, a seconda di come utilizzi Runner AI.
| Categorie di Informazioni Personali Raccolte | Destinatari delle Informazioni Personali |
|----------------------------------------------|------------------------------------------|
| Identificatori, inclusi nome, indirizzo email, indirizzo postale, numero di telefono; | Aziende che ci aiutano a fornirti i nostri servizi, inclusi fornitori di cloud storage, processori di pagamento, partner di evasione ordini, fornitori di sicurezza, fornitori di email, marketplace e fornitori di analisi dei dati; |
| Categorie di informazioni personali elencate nello statuto dei Registri Clienti della California, inclusi nome, indirizzo postale e di fatturazione, numero di telefono, informazioni su carte di credito o debito; | Inserzionisti e fornitori di marketing; |
| Informazioni commerciali, inclusi prodotti che acquisti, inserisci nel carrello, aggiungi ai preferiti o recensisci (se sei un cliente) e informazioni che ci fornisci su di te e sulla tua attività (se sei un commerciante); | Commercianti i cui negozi visiti o presso cui effettui acquisti; |
| Foto e video, che potrebbero includere immagini del viso, se scegli di fornirli. | Partner che ti aiutano a utilizzare i nostri Servizi, come fornitori di pagamento o logistica che scegli di integrare con il tuo Negozio. |
| Informazioni sull'attività di rete Internet o elettronica, incluse informazioni relative al dispositivo e al browser che utilizzi, connessione di rete, indirizzo IP e come navighi attraverso i nostri siti; | Forze dell'ordine o altre terze parti in relazione a richieste legali, per conformarci alla legge applicabile o per prevenire danni. |
| Dati di geolocalizzazione, inclusi il tuo indirizzo postale e di fatturazione; | |
| Inferenze o informazioni derivate da altre informazioni personali su di te, che potrebbero includere le tue preferenze, interessi e altre informazioni utilizzate per personalizzare la tua esperienza; | |
| Altre informazioni che fornisci; e | |
| Informazioni personali sensibili, che possono includere: Identificatori emessi dal governo, inclusi numero di previdenza sociale, patente di guida, carta d'identità statale o numero di passaporto; Le tue credenziali di accesso all'account (come login dell'account, conto finanziario, numero di carta di debito o credito in combinazione con qualsiasi codice di accesso di sicurezza richiesto, password o credenziali che consentono l'accesso a un account); | |
### 11.2 Perché raccogliamo e condividiamo le tue Informazioni Personali
Utilizziamo e condividiamo le tue informazioni personali per gli scopi stabiliti nelle Informative sulla Privacy di Runner AI. Per le categorie di informazioni personali sensibili che raccogliamo, utilizziamo o divulghiamo tali informazioni solo con il tuo consenso specifico quando richiesto, o come altrimenti consentito dalla legge.
### 11.3 Fonti di Informazioni Personali
Per rendere il commercio migliore per tutti presso Runner AI, raccogliamo e utilizziamo informazioni personali fornite da:
**Te:** Raccogliamo le informazioni che fornisci quando utilizzi la nostra piattaforma, incluso quando ti iscrivi a Runner AI come commerciante, visiti un negozio alimentato da Runner AI, compili informazioni sull'ordine, visiti uno dei siti web di Runner AI o contatti il Supporto di Runner AI. Raccogliamo informazioni sull'account e sul pagamento che ci fornisci (incluse informazioni sulla tua attività se sei un commerciante), negozi o articoli Runner AI che salvi nei preferiti, acquisti che effettui, recensioni che pubblichi e come altrimenti interagisci o comunichi con negozi o altri utenti sui nostri servizi. Raccogliamo anche informazioni su come navighi attraverso i nostri siti, inclusi i termini di ricerca che potresti inserire.
**I tuoi dispositivi:** Raccogliamo informazioni da e sui dispositivi che utilizzi, inclusi computer, telefoni e altri dispositivi connessi al web che utilizzi per accedere ai nostri servizi, e combiniamo queste informazioni tra i diversi dispositivi che utilizzi.
**Terze parti:** Riceviamo informazioni da partner che ci aiutano a fornirti i nostri servizi inclusi i seguenti:
- **Fornitori di Servizi.** Riceviamo informazioni dai nostri fornitori di servizi, che ci aiutano a fornire servizi ai nostri commercianti, come la revisione degli account per frodi o altre preoccupazioni.
- **Subprocessori.** Lavoriamo con subprocessori di terze parti per hosting cloud, distribuzione di contenuti, analisi dei dati, logging interno, servizi di evasione ordini e trasmissione di email, tra gli altri, per fornirti i nostri servizi. Per ulteriori informazioni, consulta i subprocessori di Runner AI.
- **Fornitori di analisi e cookie.** Riceviamo informazioni attraverso il nostro utilizzo di cookies, plugin social (come il pulsante "mi piace" di Facebook), pixel e tag per scopi commerciali, come fornire informazioni per aiutare a misurare come gli utenti interagiscono con i contenuti del nostro sito web. Per ulteriori informazioni su come utilizziamo queste tecnologie, consulta la nostra Politica sui Cookie.
### 11.4 Per quanto tempo conserviamo le tue informazioni
Poiché abbiamo bisogno delle tue informazioni personali per fornire i servizi di Runner AI, generalmente conserviamo le tue informazioni personali, incluse informazioni personali sensibili, mentre utilizzi i prodotti o servizi di Runner AI o fino a quando non ci dici di eliminare le tue informazioni. Potremmo anche conservare informazioni personali per conformarci agli obblighi legali o proteggere i nostri interessi o quelli di altri.
Se sei un commerciante che gestisce un negozio alimentato da Runner AI e chiudi il negozio, smetti di pagare le tue tasse di abbonamento o terminiamo il tuo account, conserviamo le informazioni del negozio per due anni prima di iniziare il processo di eliminazione.
Quando visiti o effettui un acquisto dal negozio alimentato da Runner AI di un commerciante, agiamo come fornitore di servizi o responsabile del trattamento per il commerciante, e il commerciante, non Runner AI, decide per quanto tempo le tue informazioni vengono conservate.
### 11.5 I tuoi diritti sulle tue informazioni
A seconda di dove vivi, di come utilizzi Runner AI e fatte salve determinate eccezioni, potresti avere alcuni o tutti i seguenti diritti:
- **Diritto di Sapere:** Il diritto di richiedere che ti divulghiamo le informazioni personali che raccogliamo, utilizziamo o divulghiamo su di te, le fonti da cui raccogliamo le tue informazioni personali e informazioni sulle nostre pratiche sui dati.
- **Diritto di Richiedere la Correzione:** Il diritto di richiedere che correggiamo le informazioni personali inesatte che conserviamo su di te.
- **Diritto di Richiedere la Cancellazione:** Il diritto di richiedere che eliminiamo qualsiasi informazione personale che abbiamo raccolto su di te.
Per esercitare i tuoi diritti, incluso il "diritto di sapere" e il "diritto di cancellare", invia una richiesta tramite support@adaptivemachines.ai.
Se hai visitato o effettuato un acquisto dal negozio alimentato da Runner AI di un commerciante, contatta direttamente il commerciante specifico. Se ci fai una richiesta, inoltreremo la tua richiesta al commerciante pertinente.
Si prega di notare che per proteggere le tue informazioni e l'integrità dei nostri prodotti e servizi, potremmo dover verificare la tua identità prima di elaborare la tua richiesta. In alcuni casi potremmo dover raccogliere informazioni aggiuntive per verificare la tua identità, come il tuo indirizzo email o un documento d'identità rilasciato dal governo.
Ai sensi delle Leggi sulla Privacy USA, puoi anche designare un agente autorizzato a fare queste richieste per tuo conto. Se utilizzi un agente autorizzato per inviare una richiesta, potremmo dover raccogliere informazioni aggiuntive, come un documento d'identità rilasciato dal governo, per verificare la tua identità prima di elaborare la tua richiesta per proteggere le tue informazioni.
In determinati stati, potresti avere il diritto di appellarti alla nostra decisione relativa a una richiesta relativa a questi diritti. Se desideri appellarti a una decisione, contatta il Supporto di Runner AI.
Non ti discrimineremo per aver esercitato uno qualsiasi di questi diritti.
## Informazioni Aggiuntive per Utenti in Determinate Regioni
### Per Utenti nello Spazio Economico Europeo (SEE), UK e Svizzera:
Se ti trovi nel SEE, UK o Svizzera, trattiamo i tuoi dati personali solo quando abbiamo una base legale valida. Per le informazioni in cui siamo il Titolare del Trattamento (ad esempio, per i nostri Commercianti e Visitatori del Sito Web), le nostre basi legali includono:
- **Esecuzione di un Contratto:** Per fornirti i nostri Servizi come descritto nei nostri Termini di Servizio.
- **Interesse Legittimo:** Per scopi come sicurezza, miglioramento della piattaforma e marketing, quando i nostri interessi non sono superati dai tuoi diritti di protezione dei dati.
- **Consenso:** Per usi specifici, come l'invio di email di marketing o l'inserimento di cookies non essenziali, quando chiediamo il tuo consenso.
- **Obbligo Legale:** Per conformarci ai nostri obblighi legali.
### Per Utenti in California:
Se sei residente in California, hai diritti ai sensi del CCPA/CPRA, incluso il diritto di sapere, cancellare, correggere e il Diritto di Rinunciare alla Vendita o Condivisione delle Tue Informazioni Personali per scopi di pubblicità comportamentale in contesti incrociati. Puoi esercitare questo diritto in qualsiasi momento facendo clic sul link "Non Vendere o Condividere le Mie Informazioni Personali" nel footer del nostro sito web o gestendo le tue preferenze sui cookie.
---
# Informativa sulla Privacy per i consumatori
Source: https://www.runnerai.com/docs/it/legal/policies/consumers
## Indice
1. [Introduzione](#introduzione)
2. [Quali Dati Personali Riceviamo](#quali-dati-personali-riceviamo)
3. [Come Utilizziamo i Tuoi Dati Personali](#come-utilizziamo-i-tuoi-dati-personali)
4. [Come Trattiamo i Tuoi Dati Personali per Conto dei Commercianti Runner AI](#come-trattiamo-i-tuoi-dati-personali-per-conto-dei-commercianti-runner-ai)
5. [Terze Parti che Possono Ricevere Dati Personali](#terze-parti-che-possono-ricevere-dati-personali)
6. [Partner e Integrazioni di Terze Parti](#partner-e-integrazioni-di-terze-parti)
7. [I Tuoi Diritti sulla Privacy e le Tue Scelte](#i-tuoi-diritti-sulla-privacy-e-le-tue-scelte)
8. [Conservazione](#conservazione)
9. [Come Contattarci](#come-contattarci)
10. [Modifiche a questa Informativa sulla Privacy](#modifiche-a-questa-informativa-sulla-privacy)
## Introduzione
La presente informativa sulla privacy descrive i dati personali che Runner AI riceve e/o tratta (che possono includere raccolta, organizzazione, strutturazione, archiviazione, utilizzo o divulgazione) quando interagisci con Runner AI o utilizzi i Servizi per Consumatori di Runner AI, come definiti nei Termini di Servizio per i Consumatori, incluso mentre fai acquisti presso un commerciante che utilizza o è alimentato dalla piattaforma di Runner AI ("Commercianti Runner AI" o "Commercianti"). Inoltre, ti preghiamo di consultare la nostra [informativa sulla privacy generale](/it/legal/policies) che si applica a tutti coloro le cui informazioni trattiamo. Se eventuali disposizioni di questa informativa sono in conflitto con le disposizioni dell'informativa sulla privacy generale, prevarranno le disposizioni di questa informativa.
## Quali Dati Personali Riceviamo
I Dati Personali sono qualsiasi informazione da o su una persona identificata o identificabile, ma non includono informazioni aggregate o anonimizzate. Riceviamo Dati Personali quando utilizzi o interagisci con Runner AI o i servizi di Runner AI, che possono includere le seguenti categorie:
### 1. Informazioni di Profilo e Contatto
Riceviamo informazioni di contatto o altre informazioni di profilo quando ti iscrivi o interagisci con i Servizi per Consumatori di Runner AI, che possono includere numero di telefono, indirizzo email o altre informazioni che scegli di fornirci. Potremmo collegare queste informazioni ai diversi dispositivi o account che utilizzi quando interagisci con Runner AI o utilizzi i Servizi per Consumatori di Runner AI.
### 2. Informazioni sul Dispositivo
Riceviamo informazioni sui computer, telefoni e altri dispositivi che utilizzi o con cui interagisci con Runner AI o i Servizi per Consumatori di Runner AI, incluso indirizzo IP (che può essere utilizzato per determinare la posizione generale), identificatori del dispositivo, ID dei cookie, il browser che utilizzi, la tua connessione di rete o altri identificatori univoci o informazioni sul dispositivo.
### 3. Informazioni di Pagamento
Riceviamo informazioni di pagamento quando effettui un acquisto tramite Runner AI o i Commercianti Runner AI, come il numero della tua carta di pagamento e la data di scadenza.
### 4. Utilizzo dei Servizi per Consumatori di Runner AI
Riceviamo informazioni relative al tuo utilizzo o alle tue interazioni con i Servizi per Consumatori di Runner AI, indipendentemente dal fatto che tu sia connesso a Runner AI o meno, come le tue interazioni con i Commercianti Runner AI, i Negozi che visiti, i prodotti che visualizzi e visiti, le recensioni e valutazioni dei prodotti che pubblichi e condividi, la tua cronologia degli ordini, altre attività di marketing relative ai Servizi per Consumatori di Runner AI e i Negozi preferiti.
### 5. Impostazioni e Preferenze sulla Privacy
Riceviamo informazioni sulle tue impostazioni e preferenze su Runner AI e sui nostri Commercianti, nonché informazioni sulle impostazioni di privacy del tuo browser e dispositivo.
### 6. Comunicazioni con Runner AI
Riceviamo informazioni, inclusi contenuti di messaggi ed email, quando comunichi con Runner AI (come per richieste di assistenza clienti, partecipazione a sondaggi, partecipazione a promozioni o ricerche).
### 7. Account di Social Network
Se scegli di collegare, connettere o accedere ai Servizi per Consumatori di Runner AI tramite un servizio online di terze parti, indichi al servizio di inviarci determinate informazioni su di te controllate da tale servizio, come le informazioni di profilo. Questa condivisione è soggetta alle informative sulla privacy applicabili e alle tue impostazioni di privacy di tale servizio.
## Come Utilizziamo i Tuoi Dati Personali
Runner AI utilizza i Dati Personali per i seguenti scopi a seconda di come interagisci con noi o quali servizi di Runner AI utilizzi e in base alla tua attività su tutti i dispositivi dove accedi o interagisci con Runner AI o i servizi di Runner AI:
### 1. Fornire, Migliorare e Personalizzare i Servizi di Runner AI
Per fornirti servizi personalizzati di Runner AI, inclusa la visualizzazione della tua cronologia degli acquisti e dello stato degli ordini in un unico posto, fornendo opzioni di pagamento facili quando fai acquisti, raccomandando prodotti, Commercianti e Negozi e personalizzando i prodotti presentati per te, e per migliorare i servizi di Runner AI, incluso in base al tuo utilizzo dei Servizi per Consumatori di Runner AI e all'attività con i nostri Commercianti.
### 2. Tracciare e Implementare le Tue Preferenze e Impostazioni sulla Privacy
Per tracciare e implementare le tue impostazioni e preferenze sulla privacy con Runner AI e i nostri Commercianti.
### 3. Eseguire Ricerca e Sviluppo Prodotti
Per sviluppare, testare e migliorare i servizi di Runner AI, inclusa la risoluzione dei problemi dei nostri prodotti e servizi, lo sviluppo di servizi nuovi o migliorati di Runner AI e l'analisi del tuo utilizzo e delle tue interazioni con i servizi di Runner AI.
### 4. Pubblicizzare, Promuovere e Commercializzare Runner AI
Per commercializzare, pubblicizzare e promuovere i servizi di Runner AI su e al di fuori di Runner AI, incluse comunicazioni personalizzate o pubblicità relative ai servizi di Runner AI su servizi di terze parti.
### 5. Fornire Pubblicità Personalizzata per i nostri Commercianti
Per fornire servizi pubblicitari ai nostri Commercianti, che possono includere pubblicità personalizzata.
### 6. Comunicare con Te
Per comunicare con te riguardo ai servizi di Runner AI, inclusi aggiornamenti sui prodotti, il tuo account e modifiche alle nostre politiche e termini. Utilizziamo anche le tue informazioni per risponderti quando ci contatti.
### 7. Autenticazione, Integrità, Sicurezza e Protezione
Per autenticare il tuo account, fornire un'esperienza di pagamento e acquisto sicura e per rilevare, indagare e prevenire comportamenti dannosi, attività fraudolente o esperienze non sicure, affrontare minacce alla sicurezza, proteggere la sicurezza pubblica e proteggere i Servizi di Runner AI per te e per i nostri Commercianti.
### 8. Motivi Legali
Per conformarci alla legge applicabile o rispondere a procedimenti legali validi, incluse richieste da parte delle forze dell'ordine o agenzie governative, per indagare o partecipare a discovery civile, contenzioso o altri procedimenti legali avversari e per far rispettare o indagare su potenziali violazioni dei nostri termini o politiche.
Runner AI può anche aggregare, de-identificare e/o anonimizzare qualsiasi informazione raccolta tramite i servizi di Runner AI in modo tale da non poter ragionevolmente collegare le informazioni a te o al tuo dispositivo. Potremmo utilizzare tali informazioni aggregate, de-identificate o anonime per qualsiasi scopo, incluso, ad esempio, per migliorare il servizio di Runner AI.
## Come Trattiamo i Tuoi Dati Personali per Conto dei Commercianti Runner AI
Runner AI tratta anche i tuoi Dati Personali dai Commercianti con cui interagisci o presso cui fai acquisti al fine di aiutare i Commercianti a gestire i loro Negozi e per fornire servizi aziendali ai nostri Commercianti. Quando Runner AI tratta Dati Personali in questo modo, agiamo su istruzione del Commerciante e si applicano i termini di servizio e l'informativa sulla privacy del Commerciante, non quelli di Runner AI. Per ulteriori informazioni su come i Commercianti raccolgono e utilizzano le informazioni personali quando visiti ed effettui acquisti nei loro Negozi, consulta i termini e l'informativa sulla privacy del Commerciante.
Inoltre, alcuni Commercianti potrebbero istruirci ad utilizzare i Dati Personali che condividono con noi per pubblicità mirata per questi e altri Commercianti che utilizzano questi servizi su siti di terze parti. Potresti avere la possibilità di rinunciare a consentire a un Commerciante di condividere le tue informazioni con noi per questi scopi direttamente sul sito di quel Commerciante.
## Terze Parti che Possono Ricevere Dati Personali
A seconda di quali servizi di Runner AI utilizzi o con cui interagisci, Runner AI può fornire Dati Personali alle seguenti categorie di terze parti:
### 1. Fornitori
Runner AI lavora con fornitori di servizi di terze parti per fornire, supportare e migliorare i servizi di Runner AI e l'infrastruttura tecnica, per servizi aziendali come l'elaborazione dei pagamenti, incluso in relazione agli acquisti effettuati quando utilizzi i Servizi di Runner AI, e per marketing e analisi aziendale.
### 2. Partner di Marketing, Pubblicità e Analisi
Potremmo utilizzare partner di terze parti per marketing, pubblicità e analisi aziendale per fornire pubblicità personalizzata e per aiutarci a capire come le persone utilizzano o interagiscono con i servizi di Runner AI e i nostri Commercianti. Questi partner possono ricevere informazioni sul tuo utilizzo o sulle tue interazioni con i servizi di Runner AI, incluso tramite cookie di terze parti o altre tecnologie.
### 3. Cambio di Controllo
Potremmo condividere Dati Personali con acquirenti effettivi o potenziali, i loro rappresentanti e altri partecipanti rilevanti in, o durante le negoziazioni di, qualsiasi vendita, fusione, acquisizione, ristrutturazione o cambio di controllo che coinvolga tutta o parte dell'attività o degli asset di Runner AI, incluso in relazione a procedure fallimentari o simili.
### 4. Motivi Legali
Potremmo condividere Dati Personali secondo necessità per: (1) far rispettare o indagare su potenziali violazioni dei suoi Termini di Servizio o politiche; (2) conformarci alla legge applicabile o rispondere a, indagare o partecipare a procedimenti legali validi, incluse da parte delle forze dell'ordine o agenzie governative; (3) proteggere i diritti e la proprietà nostri, dei nostri Commercianti e utenti; (4) soddisfare i nostri impegni di responsabilità aziendale e sociale; (5) rilevare, prevenire o indagare su potenziali frodi, abusi o problemi di sicurezza e protezione, incluse minacce al pubblico; e (6) risolvere controversie e far rispettare gli accordi.
### 5. Condivisione a Tua Discrezione
Quando fornisci il consenso, condividiamo le tue informazioni come descritto al momento del consenso, come quando ti connetti con un'applicazione o sito web di terze parti.
## Partner e Integrazioni di Terze Parti
Parti dei servizi di Runner AI possono collegarsi a servizi di terze parti. Runner AI non possiede né controlla queste terze parti. Quando interagisci con queste terze parti e scegli di utilizzare i loro servizi, il tuo utilizzo è soggetto alle informative sulla privacy di tali fornitori.
## I Tuoi Diritti sulla Privacy e le Tue Scelte
Potresti avere determinati diritti per gestire i tuoi Dati Personali a seconda di dove vivi. A seconda della tua giurisdizione, potrebbero applicarsi i seguenti diritti, fatte salve determinate eccezioni:
### 1. Accesso e Portabilità
Diritto di richiedere l'accesso ai tuoi Dati Personali.
### 2. Correzione / Rettifica
Diritto di correggere Dati Personali inesatti o incompleti in determinate circostanze.
### 3. Cancellazione / Eliminazione
Diritto di eliminare i Dati Personali su di te.
### 4. Diritto di rinunciare alla "condivisione" per pubblicità comportamentale cross-context o pubblicità mirata
Diritto di rinunciare alla "condivisione" dei tuoi Dati Personali per pubblicità comportamentale cross-context o pubblicità mirata (come ulteriormente descritto nella sezione Terze Parti che Possono Ricevere Dati Personali).
Puoi anche aggiornare le informazioni del tuo account nelle tue impostazioni nell'app. Per disattivare o eliminare il tuo account, invia un'email a support@adaptivemachines.ai. Potresti avere diritti aggiuntivi disponibili per te. La richiesta può essere inviata via email a support@adaptivemachines.ai. Inoltre, consulta la nostra [informativa sulla privacy generale](/it/legal/policies) per ulteriori informazioni.
## Conservazione
Conserviamo i Dati Personali per il tempo in cui abbiamo un'esigenza aziendale in corso per farlo (ad esempio, per fornire i servizi di Runner AI, per conformarci a requisiti legali, fiscali o contabili applicabili, per il rilevamento e la prevenzione di sicurezza e frodi o in relazione a processi di backup o disaster recovery), a meno che un diverso periodo di conservazione sia consentito o richiesto dalla legge applicabile.
I criteri utilizzati per determinare i nostri periodi di conservazione includono quanto segue:
1. La durata del tempo in cui abbiamo una relazione continuativa con te e forniamo i servizi di Runner AI a te (ad esempio, per tutto il tempo in cui hai un account con noi o continui ad utilizzare i nostri servizi);
2. Se modifichi o elimini le tue informazioni tramite i tuoi account;
3. Se Runner AI ha un obbligo legale di conservare i dati (ad esempio, determinate leggi richiedono a Runner AI di conservare registrazioni delle tue transazioni per un certo periodo di tempo); o
4. Se la conservazione è consigliabile alla luce della nostra posizione legale (come per quanto riguarda l'applicazione dei nostri accordi, la risoluzione delle controversie, le prescrizioni applicabili, il contenzioso o le indagini normative).
## Come Contattarci
Se desideri esercitare i tuoi diritti o se hai domande o preoccupazioni relative a questa Informativa sulla Privacy, puoi contattarci tramite support@adaptivemachines.ai.
## Modifiche a questa Informativa sulla Privacy
Potremmo aggiornare periodicamente questa Informativa sulla Privacy per tenere conto di modifiche nella nostra raccolta e/o trattamento dei Dati Personali e pubblicheremo l'Informativa sulla Privacy aggiornata sul nostro sito web, con una data "Ultimo Aggiornamento" nella parte superiore.
---
# Informativa sulla Privacy per i commercianti
Source: https://www.runnerai.com/docs/it/legal/policies/merchants
## Indice
1. [Introduzione](#introduzione)
2. [Quali informazioni raccogliamo su di te e perché](#quali-informazioni-raccogliamo-su-di-te-e-perché)
3. [Quando e Perché Condividiamo le Tue Informazioni con Altri](#quando-e-perché-condividiamo-le-tue-informazioni-con-altri)
4. [Google Ads and Google Merchant Center integrations](#google-ads-and-google-merchant-center-integrations)
5. [I Tuoi Diritti Riguardo alle Tue Informazioni](#i-tuoi-diritti-riguardo-alle-tue-informazioni)
6. [Per Quanto Tempo Conserviamo le Tue Informazioni](#per-quanto-tempo-conserviamo-le-tue-informazioni)
7. [Le Informazioni dei Tuoi Clienti](#le-informazioni-dei-tuoi-clienti)
## Introduzione
Se sei un commerciante che utilizza Runner AI per supportare la tua attività, raccogliamo e utilizziamo le tue informazioni personali per fornirti l'accesso alla nostra piattaforma e ai suoi servizi e generalmente per aiutarti a gestire meglio la tua attività e le relazioni con i clienti.
Quando trattiamo informazioni personali dei tuoi clienti ("Utenti Finali"), lo facciamo come Responsabile del Trattamento per tuo conto, nostro Commerciante. Tu, il Commerciante, sei il Titolare del Trattamento per le informazioni dei tuoi Utenti Finali. Ciò significa che sei responsabile della conformità legale con le leggi applicabili sulla protezione dei dati, inclusa la fornitura della tua informativa sulla privacy e l'ottenimento di eventuali consensi necessari dai tuoi Utenti Finali.
Inoltre, ti preghiamo di consultare la nostra [informativa sulla privacy generale](/it/legal/policies), che si applica a tutti coloro le cui informazioni trattiamo.
## Quali informazioni raccogliamo su di te e perché
Raccogliamo informazioni personali quando ti iscrivi a Runner AI, quando utilizzi la nostra piattaforma o quando ci fornisci in altro modo informazioni. Potremmo anche utilizzare fornitori di servizi di terze parti per aiutarci a esaminare gli account per frodi o altri problemi. Generalmente, abbiamo bisogno di informazioni su di te per consentirti di utilizzare la nostra piattaforma. Trattiamo i tuoi dati personali per adempiere al nostro contratto con te o perché mantenere la nostra relazione commerciale, prevenire rischi e frodi, fornirti servizi efficienti, migliorare i nostri prodotti e servizi e rispondere alle tue richieste di servizio si allineano con i nostri interessi legittimi. In alcuni casi, tratteremo le tue informazioni personali solo con il tuo consenso.
| Cosa raccogliamo | Come lo utilizziamo |
|-----------------|---------------------|
| Informazioni che ci fornisci su di te e sulla tua attività, come il tuo nome, il nome del tuo personale o di altri individui associati alla tua attività, nome dell'azienda, indirizzo, indirizzo email e numero di telefono. | Per fornirti l'utilizzo della nostra piattaforma e altri servizi correlati (ad esempio, per confermare la tua identità, per contattarti riguardo a problemi con la piattaforma, per fatturare) Per pubblicizzare e promuovere prodotti o funzionalità a te Per conformarci ai requisiti legali Per prevenire l'uso fraudolento dei nostri servizi |
| Informazioni di pagamento che ci fornisci, come il numero della tua carta di credito o debito o il numero del tuo conto bancario. | Per fornirti l'utilizzo della nostra piattaforma e altri servizi correlati Per addebitare i nostri servizi |
| Informazioni su come accedi ai siti web di Runner AI, al tuo account e alla nostra piattaforma, incluse informazioni sul dispositivo e sul browser che utilizzi, la tua connessione di rete, il tuo indirizzo IP e dettagli su come navighi nei nostri siti web e nella piattaforma. Raccogliamo alcune di queste informazioni utilizzando "cookies" o altre tecnologie simili direttamente dal tuo dispositivo. Per ulteriori informazioni su come utilizziamo queste tecnologie, consulta la nostra Politica sui Cookie. | Per fornirti l'utilizzo e per migliorare la nostra piattaforma e altri servizi correlati (ad esempio, identificando modi per rendere la nostra piattaforma più facile da usare o navigare) Per pubblicizzare e promuovere prodotti o funzionalità a te Per prevenire l'uso fraudolento dei nostri servizi |
| Copie di documenti d'identità rilasciati dal governo e/o una foto di te mentre tieni il tuo documento d'identità che ci fornisci | Se abbiamo bisogno di verificare la tua identità (ad esempio, per proteggerti contro il furto d'identità o frodi) Per verificare che stiamo parlando con te se ci contatti Per aiutarci a determinare o verificare la proprietà dell'account Per conformarci ai requisiti legali |
| Google account, Google Ads, and Google Merchant Center information you authorize Runner AI to access, such as Google sign-in profile information, OAuth tokens and granted scopes, accessible Google Ads customer accounts, account names, manager-account status, selected account bindings, campaign and creative data, performance metrics, change history, and Merchant Center account identifiers and names. | To sign you in, connect and refresh your Google integrations, list selectable ad and Merchant Center accounts, show ads dashboards and reports, generate requested AI ads analysis or campaign drafts, publish or update campaigns you approve, sync account access, troubleshoot issues, and secure the integration. |
Lavoriamo anche con aziende che ci forniscono informazioni su commercianti o potenziali commercianti (ad esempio, per proteggerci dalle frodi o se stiamo sponsorizzando un evento).
## Quando e Perché Condividiamo le Tue Informazioni con Altri
Gestire un'attività è difficile e lavoriamo con molteplici aziende per aiutarci a fornirti una gamma di servizi per supportare la tua attività. A volte condividiamo le tue informazioni personali con queste aziende per aiutarci a fornirti i servizi di Runner AI.
Condividiamo anche le tue informazioni personali con altri:
- Per prevenire o indagare su sospette frodi, minacce alla sicurezza fisica, attività illegali o violazioni del contratto o degli altri accordi del nostro sito web.
- Per aiutarci con il marketing e la pubblicità.
- Per conformarci ai requisiti legali o rispondere a ordinanze del tribunale o richieste governative simili.
- Per vendite o acquisti di asset, vendite di azioni, acquisti o fusioni, fallimento o altre transazioni commerciali o riorganizzazioni, condivideremo i tuoi dati personali con potenziali acquirenti, venditori, nuovi proprietari o altre terze parti pertinenti secondo necessità durante le negoziazioni o in relazione a un cambio di controllo aziendale (come una riorganizzazione, fusione o vendita dei nostri asset).
Inoltre, quasi ogni commerciante che utilizza la piattaforma Runner AI utilizza anche servizi non Runner AI per supportare la propria attività (canali di vendita, gateway di pagamento o fornitori di spedizione).
Runner AI non ha alcun controllo su come questi servizi utilizzano le tue informazioni personali e dovresti verificare qualsiasi altro servizio che utilizzi per assicurarti che soddisfi le tue aspettative sulla privacy.
## Google Ads and Google Merchant Center integrations
If you connect Google Ads or Google Merchant Center to Runner AI, we use the Google user data you authorize only to provide the connected ads features you request. We share, transfer, or disclose that Google user data only with:
- Google LLC, to exchange OAuth codes and tokens, call Google Ads and Merchant Center APIs, read the data you authorized, and perform the Google Ads or Merchant Center actions you request.
- Authorized users in your Runner AI organization, according to their workspace permissions.
- Service providers and subprocessors that help us operate, secure, host, store, analyze, support, or troubleshoot Runner AI. If you use AI ads features, Google Ads metrics, creatives, change history, campaign structure, and campaign drafts may be processed by our AI model providers to generate the ads analysis, summaries, recommendations, or drafts you request. We do not share Google OAuth access tokens or refresh tokens with AI model providers.
- Legal, safety, and business-transfer recipients when required by law or as described in our overall Privacy Policy.
We do not sell Google user data, and we do not share it with third-party advertising platforms, data brokers, or information resellers except as described above or with your explicit direction. For more detail, see [Google user data and Google integrations](/it/legal/policies#google-user-data-and-google-integrations) in our overall Privacy Policy.
## I Tuoi Diritti Riguardo alle Tue Informazioni
Puoi accedere e correggere gran parte delle tue informazioni personali direttamente tramite il tuo amministratore Runner AI. Per le informazioni che non puoi accedere o correggere direttamente nel tuo amministratore Runner AI, ti preghiamo di inviare una richiesta di interessato tramite il nostro support@adaptivemachines.ai. Per ulteriori informazioni, consulta la nostra [informativa sulla privacy generale](/it/legal/policies). Si prega di notare che determinati diritti degli interessati si applicano solo in circostanze specifiche e tutti questi diritti possono essere limitati dalla legge.
## Per Quanto Tempo Conserviamo le Tue Informazioni
Poiché abbiamo bisogno delle tue informazioni personali per fornire i servizi di Runner AI, generalmente conserviamo le tue informazioni personali per tutto il tempo in cui utilizzi i prodotti o servizi di Runner AI. Se chiudi il tuo negozio, smetti di pagare le tasse di abbonamento o terminiamo il tuo account, conserveremo le informazioni del negozio per due anni prima di iniziare a eliminare o anonimizzare le informazioni personali. Non lo faremo immediatamente se riattivi il tuo account o se ci sono reclami legali o audit relativi alla tua attività. Se ci contatti per richiedere l'eliminazione delle informazioni del tuo negozio, inizieremo il processo di eliminazione o anonimizzazione delle informazioni personali dopo 90 giorni, a meno che non siamo tenuti per legge a conservare informazioni specifiche. Se hai domande su questo processo, contatta il nostro team di supporto tramite support@adaptivemachines.ai. Ricorda che dopo aver anonimizzato le tue informazioni personali, potremmo continuare a utilizzare informazioni non identificative per migliorare i nostri servizi.
## Le Informazioni dei Tuoi Clienti
Per aiutare a far crescere la tua attività, raccogliamo e utilizziamo informazioni personali sui tuoi clienti. Tipicamente, raccogliamo e utilizziamo queste informazioni personali come da te indicato. Legalmente, siamo un "responsabile del trattamento" e "fornitore di servizi", come questi termini sono utilizzati in determinate leggi applicabili sulla privacy, incluse quelle negli Stati Uniti, Canada, Europa e Regno Unito.
Poiché decidi tu come utilizzare le informazioni personali dei tuoi clienti, devi assicurarti che i tuoi clienti comprendano come tu (e come noi per tuo conto) raccogliamo e trattiamo le loro informazioni personali. Per farlo, dovresti almeno pubblicare un'informativa sulla privacy nel tuo negozio che descriva le informazioni che raccogli, come le utilizzi e con chi le condividi.
Se raccogli qualsiasi informazione personale "sensibile" dai clienti (ad esempio, informazioni sul numero di previdenza sociale, patente di guida, carta d'identità statale o numero di passaporto di un consumatore; informazioni di accesso all'account, informazioni su conti finanziari, numeri di carte di debito o credito e eventuali codici di sicurezza o password richiesti; informazioni di geolocalizzazione precisa; dati sanitari o genetici, origine razziale o etnica, convinzioni religiose o filosofiche o appartenenza sindacale; contenuto di posta, email o messaggi di testo di un consumatore; o dati sui reati penali), dovresti ottenere il consenso esplicito dal cliente per utilizzare e trattare queste informazioni.
---
# Informativa sulla Privacy per i visitatori
Source: https://www.runnerai.com/docs/it/legal/policies/visitors
## Indice
1. [Introduzione](#introduzione)
2. [Informazioni che Raccogliamo su di Te e Perché](#informazioni-che-raccogliamo-su-di-te-e-perché)
3. [Quando e Perché Condividiamo le Tue Informazioni con Altri](#quando-e-perché-condividiamo-le-tue-informazioni-con-altri)
4. [I Tuoi Diritti Riguardo alle Tue Informazioni](#i-tuoi-diritti-riguardo-alle-tue-informazioni)
## Introduzione
Se visiti un sito web di Runner AI o contatti l'assistenza clienti di Runner AI, tipicamente utilizziamo le tue informazioni personali per fornirti il servizio specifico che stai utilizzando. Inoltre, ti preghiamo di consultare la nostra [Informativa sulla Privacy generale](/it/legal/policies), che si applica a tutti coloro le cui informazioni trattiamo.
## Informazioni che Raccogliamo su di Te e Perché
Quando visiti i nostri siti web o contatti il supporto di Runner AI, raccogliamo le seguenti informazioni personali su di te. Trattiamo i tuoi dati personali per adempiere ai nostri obblighi contrattuali nei tuoi confronti, per mantenere la nostra relazione commerciale, prevenire rischi e frodi, fornire servizi efficienti, migliorare i nostri prodotti e servizi e rispondere alle tue richieste in conformità con i nostri interessi legittimi. In alcuni casi, trattiamo le tue informazioni personali solo con il tuo consenso.
| Cosa raccogliamo | Come lo utilizziamo |
|-----------------|---------------------|
| Informazioni su di te che ci fornisci su te stesso, come il tuo nome, indirizzo, indirizzo email e numero di telefono. | Per fornirti l'utilizzo e per migliorare l'app o il servizio che stai cercando di utilizzare (ad esempio, per confermare la tua identità, per contattarti riguardo a problemi con la piattaforma, per fatturare) Per verificare che stiamo parlando con te Per pubblicizzare e promuovere prodotti o funzionalità a te Per conformarci ai requisiti legali |
| Informazioni di pagamento che ci fornisci, come il numero della tua carta di pagamento o il numero del tuo conto bancario. | Per consentirti di effettuare un pagamento |
| Informazioni su come accedi e utilizzi i siti web di Runner AI e altri servizi, incluse informazioni sul dispositivo e sul browser che utilizzi, la tua connessione di rete, il tuo indirizzo IP e dettagli su come navighi attraverso i nostri siti, inclusi i termini di ricerca che potresti inserire. Raccogliamo alcune di queste informazioni utilizzando "cookies" o altre tecnologie simili direttamente dal tuo dispositivo. Per ulteriori informazioni su come utilizziamo queste tecnologie, consulta la nostra Politica sui Cookie. | Per fornirti l'utilizzo e per migliorare i nostri siti web e servizi correlati (ad esempio, identificando modi per rendere la nostra piattaforma più facile da usare o navigare) Per personalizzare la tua esperienza utilizzando i nostri siti web (ad esempio, modificando il layout delle nostre pagine web) Per pubblicizzare e promuovere prodotti o funzionalità a te |
## Quando e Perché Condividiamo le Tue Informazioni con Altri
Condividiamo le tue informazioni personali con aziende che ci aiutano a fornirti servizi. Potremmo anche condividere le tue informazioni:
- Per prevenire o indagare su frodi, minacce alla sicurezza, attività illegali o violazioni di contratti (ad esempio, i nostri Termini di Servizio).
- Per supportare gli sforzi di marketing e pubblicità.
- Per conformarci agli obblighi legali o rispondere a ordinanze del tribunale, richieste governative.
- Durante transazioni commerciali (ad esempio, fusioni, acquisizioni, vendite di asset, fallimento), condividiamo dati con potenziali acquirenti, venditori o terze parti pertinenti coinvolte in negoziazioni o ristrutturazioni.
## I Tuoi Diritti Riguardo alle Tue Informazioni
Ti preghiamo di inviare una richiesta di interessato tramite support@adaptivemachines.ai se desideri accedere o richiedere che eliminiamo le tue informazioni personali. Tieni presente che dopo aver anonimizzato le tue informazioni, continueremo a utilizzare informazioni non identificabili per migliorare i nostri servizi. Si prega di notare che alcuni diritti degli interessati si applicano solo in determinate circostanze e tutti questi diritti possono essere limitati dalla legge.
---
# Elenco dei Subresponsabili del Trattamento
Source: https://www.runnerai.com/docs/it/legal/subprocessors
## Elenco dei Subresponsabili del Trattamento
Per supportare la fornitura dei nostri Servizi, Adaptive Machines, Inc. ("Runner AI", "noi" o "ci") utilizza fornitori di servizi di terze parti come subresponsabili del trattamento per elaborare dati personali. Le entità affiliate a Runner AI e i subresponsabili del trattamento di terze parti aiutano Runner AI a elaborare dati personali per i commercianti in conformità con il nostro [Accordo sul Trattamento dei Dati](/it/legal/dpa).
I Subresponsabili del Trattamento utilizzati da Runner AI per l'esecuzione dei Servizi secondo i Termini sono elencati di seguito.
## Subresponsabili del trattamento di terze parti
| Subresponsabile | Servizio fornito | Sede centrale aziendale | Dati che possono essere trattati |
|-----------------|------------------|-------------------------|-----------------------------------|
| Vercel Inc. | Servizi di hosting e distribuzione | USA | Dati della piattaforma necessari per ospitare e servire l'applicazione |
| Google LLC | Hosting cloud e trattamento dati | USA | Tutti i dati della piattaforma |
| Google DeepMind | Servizi di intelligenza artificiale conversazionale | USA | Dati personali se inseriti nella chatbox di Runner AI |
| OpenRouter, Inc. | Servizi di intelligenza artificiale conversazionale | USA | Dati personali se inseriti nella chatbox di Runner AI |
| Klaviyo, Inc. | Trasmissione email | USA | Dati personali necessari per fornire il servizio Email di Runner AI |
---
# Termini di Servizio
Source: https://www.runnerai.com/docs/it/legal/tos
## Termini di Servizio
### Indice
1. [Termini dell'Account](#1-termini-dellaccount)
2. [Attivazione dell'Account](#2-attivazione-dellaccount)
3. [Diritti di Runner AI](#3-diritti-di-runner-ai)
4. [Le Tue Responsabilità](#4-le-tue-responsabilità)
5. [Pagamento di Tariffe e Tasse](#5-pagamento-di-tariffe-e-tasse)
6. [Riservatezza](#6-riservatezza)
7. [Limitazione di Responsabilità e Indennizzo](#7-limitazione-di-responsabilità-e-indennizzo)
8. [Proprietà Intellettuale e I Tuoi Materiali](#8-proprietà-intellettuale-e-i-tuoi-materiali)
9. [Servizi Aggiuntivi](#9-servizi-aggiuntivi)
10. [Feedback e Recensioni](#10-feedback-e-recensioni)
11. [Procedura di Notifica e Rimozione DMCA](#11-procedura-di-notifica-e-rimozione-dmca)
12. [Privacy e Protezione dei Dati](#12-privacy-e-protezione-dei-dati)
13. [Parte Contraente di Runner AI](#13-parte-contraente-di-runner-ai)
14. [Durata e Risoluzione](#14-durata-e-risoluzione)
15. [Modifiche](#15-modifiche)
16. [Condizioni Generali](#16-condizioni-generali)
**Ultimo aggiornamento: 15 ottobre 2025**
Benvenuto su Runner AI! Registrandoti per un Account Runner AI (come definito nella Sezione 1) o utilizzando qualsiasi Servizio Runner AI (come definito di seguito), accetti di essere vincolato dai seguenti termini e condizioni (i "Termini di Servizio").
Come utilizzato in questi Termini di Servizio, "Società", "noi", "ci" e "nostro" si riferiscono a Adaptive Machines, Inc. (come definito nella Sezione 13). "Tu" indica l'Utente Runner AI (se ti registri o utilizzi un Servizio Runner AI come individuo), o l'azienda che impiega l'Utente Runner AI (se ti registri o utilizzi un Servizio Runner AI come azienda) e una qualsiasi delle sue affiliate.
Runner AI fornisce una piattaforma di commercio completa che consente ai commercianti di unificare le loro attività di commercio. Tra le altre caratteristiche, questa piattaforma include una gamma di strumenti per i commercianti per costruire e personalizzare negozi online, vendere in più luoghi (inclusi web, mobile, social media, marketplace online e altre località online ("Servizi Online"), gestire prodotti, inventario, pagamenti, evasione, spedizione, operazioni commerciali, marketing e pubblicità, e interagire con clienti esistenti e potenziali. Qualsiasi tale servizio o servizi offerti da Runner AI sono indicati in questi Termini di Servizio come il/i "Servizio/i". Qualsiasi nuova funzionalità o strumento che viene aggiunto ai Servizi attuali sarà anche soggetto ai Termini di Servizio. Puoi rivedere la versione corrente dei Termini di Servizio in qualsiasi momento su https://www.runnerai.com/docs/it/legal/tos.
Devi leggere, essere d'accordo e accettare tutti i termini e le condizioni contenuti o espressamente riferiti in questi Termini di Servizio, inclusa la [Politica di Utilizzo Accettabile](/it/legal/aup) ("PUA"), la [Politica sulla Privacy](/it/legal/policies) e l'[Accordo sul Trattamento dei Dati](/it/legal/dpa) ("DPA") di Runner AI prima di poter registrarti per un Account Runner AI o utilizzare qualsiasi Servizio Runner AI.
Si prega di leggere i Termini di Servizio, incluso qualsiasi documento a cui si fa riferimento in questi Termini di Servizio, per il quadro completo dei tuoi requisiti legali. Utilizzando Runner AI o qualsiasi servizio Runner AI, accetti questi termini. Assicurati di controllare occasionalmente per aggiornamenti.
## 1. Termini dell'Account
### Cosa significa
Sei responsabile del tuo Account, dei Materiali che carichi sul Servizio Runner AI e del funzionamento del tuo Negozio Runner AI. Se violi i termini di servizio di Runner AI possiamo cancellare il tuo accesso al servizio. Se abbiamo bisogno di contattarti, comunicheremo tramite l'Indirizzo Email Principale.
(1) Per accedere e utilizzare i Servizi, devi registrarti per un account Runner AI ("Account"). Per completare la registrazione del tuo Account, devi fornirci il tuo nome legale completo, indirizzo aziendale, numero di telefono, un indirizzo email valido e qualsiasi altra informazione indicata come richiesta. Runner AI può rifiutare la tua richiesta di un Account, o cancellare un Account esistente, per qualsiasi motivo, a nostra esclusiva discrezione.
(2) Devi avere il maggiore tra: (i) 18 anni, o (ii) almeno l'età della maggiorità nella giurisdizione in cui risiedi e da cui utilizzi i Servizi per aprire un Account.
(3) Confermi di ricevere qualsiasi Servizio fornito da Runner AI per scopi di svolgimento di un'attività commerciale e non per alcuno scopo personale, domestico o familiare.
(4) Riconosci che Runner AI utilizzerà l'indirizzo email che fornisci all'apertura di un Account o come aggiornato da te di volta in volta come metodo principale per la comunicazione con te ("Indirizzo Email Principale"). Devi monitorare l'Indirizzo Email Principale che fornisci a Runner AI e il tuo Indirizzo Email Principale deve essere in grado sia di inviare che di ricevere messaggi. Le tue comunicazioni email con Runner AI possono essere autenticate solo se provengono dal tuo Indirizzo Email Principale.
(5) Sei responsabile di mantenere la tua password sicura. Runner AI non può e non sarà responsabile per eventuali perdite o danni derivanti dalla tua mancata manutenzione della sicurezza del tuo Account e password. Possiamo richiedere misure di sicurezza aggiuntive in qualsiasi momento e ci riserviamo il diritto di modificare questi requisiti a nostra discrezione.
(6) Il supporto tecnico rispetto ai Servizi è fornito solo agli Utenti Runner AI. Le domande sui Termini di Servizio dovrebbero essere inviate al Supporto Runner AI.
(7) Accetti di non riprodurre, duplicare, copiare, vendere, rivendere o sfruttare qualsiasi porzione del Servizio, uso dei Servizi o accesso ai Servizi senza l'espressa autorizzazione scritta di Runner AI.
(8) Accetti di non aggirare, bypassare o eludere nessuna delle limitazioni tecniche dei Servizi, utilizzare alcuno strumento per abilitare funzionalità o funzionalità che sono altrimenti disabilitate nei Servizi, o decompilare, disassemblare o altrimenti decodificare i Servizi.
(9) Accetti di non accedere ai Servizi o monitorare alcun materiale o informazione dai Servizi utilizzando alcun robot, spider, scraper o altri mezzi automatizzati.
(10) Comprendi che i tuoi Materiali possono essere trasferiti non criptati e comportare (a) trasmissioni su varie reti; e (b) modifiche per conformarsi e adattarsi ai requisiti tecnici delle reti o dispositivi di collegamento. "Materiali" indica I Tuoi Marchi, contenuto protetto da copyright, qualsiasi prodotto o servizio che vendi attraverso i Servizi (inclusa descrizione e prezzo), e qualsiasi foto, immagine, video, grafica, contenuto scritto, file audio, codice, informazioni o altri dati forniti o resi disponibili da te o dalle tue affiliate a Runner AI o alle sue affiliate.
## 2. Attivazione dell'Account
### Cosa significa
Solo una persona può essere il "Proprietario del Negozio", di solito la persona che si registra per il Servizio Runner AI. Il Proprietario del Negozio è responsabile dell'Account, è vincolato da questi Termini di Servizio ed è responsabile delle azioni di altri che accedono all'Account. Se ti registri per conto del tuo datore di lavoro, il tuo datore di lavoro è il Proprietario del Negozio responsabile del tuo Account.
### 2.1 Proprietario del Negozio
(1) Fatta salva la Sezione 2.1.2, la persona che si registra per il Servizio aprendo un Account sarà la parte contraente ("Proprietario del Negozio") ai fini dei nostri Termini di Servizio e sarà la persona autorizzata a utilizzare qualsiasi Account corrispondente che possiamo fornire al Proprietario del Negozio in relazione al Servizio. Sei responsabile di garantire che il nome del Proprietario del Negozio (incluso il nome legale della società che possiede il Negozio, se applicabile) sia chiaramente visibile sul sito web del Negozio.
(2) Se ti stai registrando per i Servizi per conto del tuo datore di lavoro, il tuo datore di lavoro sarà il Proprietario del Negozio. Se ti stai registrando per i Servizi per conto del tuo datore di lavoro, allora devi utilizzare il tuo indirizzo email aziendale e dichiari e garantisci di avere l'autorità di vincolare il tuo datore di lavoro ai nostri Termini di Servizio.
(3) Il tuo Negozio Runner AI può essere associato solo a un Proprietario del Negozio. Un Proprietario del Negozio può avere più Negozi Runner AI. "Negozio" indica il negozio online (sia ospitato da Runner AI che su un sito web di terze parti), o le sedi di vendita al dettaglio fisiche associate all'Account.
### 2.2 Account del Personale
(1) In base al tuo piano tariffario Runner AI, puoi creare uno o più account del personale ("Account del Personale") consentendo ad altre persone di accedere all'Account. Ogni Account del Personale deve includere un nome legale completo e un account email valido. Con gli Account del Personale, il Proprietario del Negozio può impostare le autorizzazioni e consentire ad altre persone di lavorare nel loro Account determinando il livello di accesso degli Account del Personale a informazioni commerciali specifiche (ad esempio, puoi limitare l'accesso dell'Account del Personale alle informazioni di vendita nella pagina Report o impedire agli Account del Personale di modificare le impostazioni generali del negozio).
(2) Il Proprietario del Negozio è responsabile di: (a) garantire che i suoi dipendenti, agenti e subappaltatori, inclusi tramite Account del Personale, rispettino questi Termini di Servizio; e (b) qualsiasi violazione di questi Termini di Servizio da parte dei dipendenti, agenti o subappaltatori del Proprietario del Negozio. Il Proprietario del Negozio riconosce e accetta che il Proprietario del Negozio sarà responsabile dell'adempimento di tutti i suoi obblighi ai sensi dell'Accordo, indipendentemente dal fatto che sublicenzi o subappalti tali obblighi a terzi, inclusi ma non limitati a affiliate o sussidiarie del Proprietario del Negozio.
(3) Il Proprietario del Negozio e gli utenti sotto gli Account del Personale sono ciascuno indicati come "Utente Runner AI".
### 2.3 Fornitori di Pagamento di Terze Parti
I nostri Servizi si integrano con vari fornitori di pagamento di terze parti per consentirti di elaborare pagamenti per le tue transazioni. Il tuo rapporto con tali fornitori di pagamento è regolato dai rispettivi termini e condizioni. Sei l'unico responsabile della creazione e del mantenimento dei tuoi account con questi fornitori e per tutte le attività relative all'elaborazione dei tuoi pagamenti.
## 3. Diritti di Runner AI
### Cosa significa
Runner AI ha il diritto di controllare a chi rendiamo disponibili i nostri Servizi e possiamo modificarli in qualsiasi momento. Abbiamo anche il diritto di rifiutare o rimuovere Materiali da qualsiasi parte dei Servizi, incluso il tuo Negozio. Possiamo offrire i nostri servizi ai tuoi concorrenti, ma non condivideremo mai le tue informazioni riservate con loro nel farlo. In caso di controversia sulla proprietà di un Account Runner AI, possiamo congelare un Account Runner AI o trasferirlo al legittimo proprietario, come determinato da noi.
(1) I Servizi hanno una gamma di funzionalità e funzionalità. Non tutti i Servizi o funzionalità saranno disponibili per tutti i Commercianti in ogni momento e non siamo obbligati a rendere disponibili Servizi o funzionalità in alcuna giurisdizione. Salvo dove vietato in questi Termini di Servizio o dalla legge applicabile, ci riserviamo il diritto di modificare i Servizi o qualsiasi loro parte per qualsiasi motivo.
(2) Runner AI non pre-controlla i Materiali ed è a nostra esclusiva discrezione rifiutare o rimuovere qualsiasi Materiale da qualsiasi parte dei Servizi, anche se determiniamo a nostra esclusiva discrezione che i beni o servizi che offri attraverso i Servizi, o i Materiali caricati o pubblicati sui Servizi, violano questi Termini di Servizio.
(3) L'abuso verbale o scritto di qualsiasi tipo (incluse minacce di abuso o ritorsione) di qualsiasi dipendente, membro o funzionario di Runner AI comporterà l'immediata risoluzione dell'Account.
(4) Ci riserviamo il diritto di fornire i nostri Servizi ai tuoi concorrenti e non facciamo alcuna promessa di esclusività. Inoltre riconosci e accetti che i dipendenti e i contractors di Runner AI possono anche essere clienti o commercianti di Runner AI e che possono competere con te, anche se non possono utilizzare le tue Informazioni Riservate (come definito nella Sezione 6) nel farlo.
(5) In caso di controversia riguardante la proprietà dell'Account, ci riserviamo il diritto di richiedere documentazione per determinare o confermare la proprietà dell'Account. La documentazione può includere, ma non è limitata a, una copia scansionata della tua licenza commerciale, documento d'identità rilasciato dal governo con foto, le ultime quattro cifre della carta di credito in archivio o conferma del tuo status di dipendente di un'entità.
(6) Runner AI si riserva il diritto di determinare, a nostra esclusiva discrezione, la legittima proprietà dell'Account e trasferire un Account al legittimo Proprietario del Negozio. Se non siamo in grado di determinare ragionevolmente il legittimo Proprietario del Negozio, senza pregiudizio per i nostri altri diritti e rimedi, Runner AI si riserva il diritto di sospendere o disabilitare temporaneamente un Account fino a quando la risoluzione sia stata determinata tra le parti in controversia.
## 4. Le Tue Responsabilità
### Cosa significa
Sei responsabile del tuo Negozio Runner AI, dei beni o servizi che vendi e della tua relazione con i tuoi clienti, non noi.
(1) Riconosci e accetti di fornire informazioni di contatto pubbliche, una politica di rimborso e tempistiche di evasione degli ordini sul tuo Negozio Runner AI.
(2) Riconosci e accetti che i Servizi non sono un marketplace, e qualsiasi contratto di vendita effettuato attraverso i Servizi è direttamente tra te e il cliente. Sei il venditore registrato per tutti gli articoli che vendi attraverso i Servizi. Sei responsabile della creazione e del funzionamento del tuo Negozio Runner AI, dei tuoi Materiali, dei beni e servizi che puoi vendere attraverso i Servizi e di tutti gli aspetti delle transazioni tra te e i tuoi clienti. Ciò include, ma non è limitato a, autorizzare l'addebito al cliente rispetto all'acquisto del cliente, rimborsi, resi, evasione di vendite o servizio clienti, transazioni fraudolente, divulgazioni legali richieste, conformità normativa, presunta o effettiva violazione di leggi applicabili (incluse ma non limitate a leggi sulla protezione dei consumatori in qualsiasi giurisdizione in cui offri prodotti o servizi in vendita), o la tua violazione di questi Termini di Servizio. Dichiari e garantisci che il tuo Negozio, i tuoi Materiali e i beni e servizi che vendi attraverso i Servizi saranno veritieri, accurati e completi, e non violeranno alcuna legge, regolamento o diritti di terzi applicabili. Per evitare dubbi, Runner AI non sarà il venditore o il commerciante registrato e non avrà alcuna responsabilità per il tuo Negozio o gli articoli venduti ai clienti attraverso i Servizi.
(3) Sei l'unico responsabile dei beni o servizi che puoi vendere attraverso i Servizi (inclusa descrizione, prezzo, tariffe, tasse che calcoli, difetti, divulgazioni legali richieste, conformità normativa, offerte o contenuto promozionale), inclusa la conformità con qualsiasi legge o regolamento applicabile.
(4) Non puoi utilizzare i Servizi Runner AI per alcuno scopo illegale o non autorizzato né puoi, nell'uso del Servizio, violare alcuna legge nella tua giurisdizione (incluse ma non limitate a leggi sul copyright), le leggi applicabili a te nella giurisdizione del tuo cliente o le leggi dello Stato del Delaware. Rispetterai tutte le leggi, regole e regolamenti applicabili (inclusi ma non limitati all'ottenimento e al rispetto dei requisiti di qualsiasi licenza o permesso che possa essere necessario per gestire il tuo negozio o che possa essere detenuto da te) nel tuo uso del Servizio e nell'adempimento degli obblighi ai sensi dei Termini di Servizio.
## 5. Pagamento di Tariffe e Tasse
### Cosa significa
Un metodo di pagamento valido (come una carta di credito) deve rimanere in archivio per pagare tutte le tariffe del servizio, incluse le tariffe di abbonamento, transazione e aggiuntive richieste per tutti i negozi. Sarai fatturato per le tue Tariffe di Abbonamento ogni 30 giorni. Eventuali Tariffe di Transazione o Tariffe Aggiuntive saranno addebitate al tuo metodo di pagamento. Se non siamo in grado di elaborare il pagamento delle Tariffe utilizzando il tuo metodo di pagamento, possiamo effettuare tentativi successivi per elaborare il pagamento delle Tariffe utilizzando il tuo metodo di pagamento. Se il pagamento delle Tariffe non ha successo entro 30 giorni dal nostro tentativo iniziale di elaborare il pagamento, Runner AI può congelare il tuo negozio. Sei responsabile di tutte le tasse relative al tuo Negozio o all'uso dei Servizi. Potresti essere tenuto a rimettere le Tasse a Runner AI o ad auto-rimettere alla tua autorità fiscale locale. Nessun rimborso.
(1) Pagherai le Tariffe applicabili al tuo abbonamento al Servizio Online e ("Tariffe di Abbonamento") e qualsiasi altra tariffa applicabile, incluse ma non limitate a tariffe applicabili relative al valore delle vendite effettuate attraverso il tuo Negozio quando utilizzi un fornitore di pagamento di terze parti per elaborare i pagamenti dei clienti. ("Tariffe di Transazione"), e qualsiasi tariffa relativa al tuo acquisto o utilizzo di qualsiasi prodotto o servizio come spedizione, Credit Boost Pack o Servizi di Terze Parti ("Tariffe Aggiuntive"). Insieme, le Tariffe di Abbonamento, le Tariffe di Transazione e le Tariffe Aggiuntive sono indicate come le "Tariffe".
(2) Devi mantenere un metodo di pagamento valido in archivio con noi per pagare tutte le Tariffe sostenute e ricorrenti. Runner AI addebiterà le Tariffe applicabili a qualsiasi metodo di pagamento valido che autorizzi ("Metodo di Pagamento Autorizzato"), e Runner AI continuerà ad addebitare il Metodo di Pagamento Autorizzato per le Tariffe applicabili fino alla risoluzione dei Servizi, e tutte le Tariffe in sospeso siano state pagate per intero. Salvo diversamente indicato, tutte le Tariffe e altri addebiti sono in dollari statunitensi, e tutti i pagamenti saranno in valuta statunitense.
(3) Le Tariffe di Abbonamento sono pagate in anticipo e saranno fatturate in intervalli di 30 giorni (ciascuna tale data, una "Data di Fatturazione"). Le Tariffe di Transazione e le Tariffe Aggiuntive saranno addebitate di volta in volta a discrezione di Runner AI. Sarai addebitato in ciascuna Data di Fatturazione per tutte le Tariffe in sospeso che non sono state precedentemente addebitate. Le Tariffe appariranno su una fattura, che sarà inviata al Proprietario del Negozio tramite l'Indirizzo Email Principale fornito. Inoltre, una fattura apparirà nella pagina Account della console amministrativa del tuo Negozio. Gli utenti hanno circa due settimane per sollevare e risolvere eventuali problemi con la fatturazione delle Tariffe di Abbonamento.
(4) Se non siamo in grado di elaborare il pagamento delle Tariffe utilizzando un Metodo di Pagamento Autorizzato, possiamo effettuare tentativi successivi per elaborare il pagamento utilizzando qualsiasi Metodo di Pagamento Autorizzato. Se non siamo in grado di elaborare con successo il pagamento delle Tariffe utilizzando un Metodo di Pagamento Autorizzato entro 30 giorni dal nostro tentativo iniziale, possiamo sospendere e revocare l'accesso al tuo Account e ai Servizi. Il tuo Account sarà riattivato al pagamento di eventuali Tariffe in sospeso, più le Tariffe applicabili al tuo prossimo ciclo di fatturazione. Potresti non essere in grado di accedere al tuo Account o alla tua vetrina durante qualsiasi periodo di sospensione.
(5) Tutte le Tariffe sono esclusive di tasse federali, statali, locali o altre governative sulle vendite, beni e servizi, armonizzate o altre tasse, tariffe o addebiti ora in vigore o emanate in futuro ("Tasse").
(6) Sei responsabile di tutte le Tasse applicabili che derivano da o come risultato del tuo abbonamento o acquisto di prodotti e servizi di Runner AI. Nella misura in cui Runner AI addebita queste Tasse, sono calcolate utilizzando le aliquote fiscali che si applicano in base all'indirizzo di fatturazione che ci fornisci. Tali importi sono in aggiunta alle Tariffe per tali prodotti e servizi e saranno fatturati al tuo Metodo di Pagamento Autorizzato. Se sei esente dal pagamento di tali Tasse, devi fornirci prova della tua esenzione, che in alcune giurisdizioni include un certificato originale che soddisfa i requisiti legali applicabili che attesta lo status di esenzione fiscale. L'esenzione fiscale si applicherà solo da e dopo la data in cui riceviamo prova soddisfacente per Runner AI della tua esenzione. Se non ti vengono addebitate Tasse da Runner AI, sei responsabile di determinare se le Tasse sono pagabili e, in tal caso, di auto-rimettere le Tasse alle autorità fiscali appropriate nella tua giurisdizione.
(7) Per evitare dubbi, tutte le somme pagabili da te a Runner AI ai sensi di questi Termini di Servizio saranno pagate libere e chiare da eventuali detrazioni o ritenute di qualsiasi tipo. Diverse dalle Tasse addebitate da Runner AI a te e rimesse alle autorità fiscali appropriate per tuo conto, eventuali detrazioni o ritenute che sono richieste dalla legge saranno sostenute da te e pagate separatamente all'autorità fiscale pertinente. Runner AI avrà il diritto di addebitare l'intero importo delle Tariffe stipulate ai sensi di questi Termini di Servizio al tuo Metodo di Pagamento Autorizzato ignorando qualsiasi tale detrazione o ritenuta che possa essere richiesta.
(8) Sei l'unico responsabile della determinazione, raccolta, ritenuta, segnalazione e rimessa di tasse, dazi, tariffe, sovrattasse e addebiti aggiuntivi applicabili che derivano da o come risultato di qualsiasi vendita sul tuo Negozio Runner AI o del tuo uso dei Servizi. I Servizi non sono un marketplace. Qualsiasi contratto di vendita effettuato attraverso i Servizi è direttamente tra te e il cliente.
(9) Devi mantenere una posizione accurata nella console amministrativa del tuo Negozio Runner AI. Se cambi giurisdizione devi aggiornare prontamente la tua posizione nella console amministrativa.
(10) Runner AI non fornisce rimborsi.
## 6. Riservatezza
### Cosa significa
Sia tu che Runner AI accettate di utilizzare le Informazioni Riservate dell'altro solo per adempiere agli obblighi in questi Termini di Servizio. Le Informazioni Riservate devono essere protette e rispettate.
(1) "Informazioni Riservate" includerà, ma non sarà limitata a, tutte le informazioni associate all'attività di una parte e non conosciute pubblicamente, incluse informazioni commerciali specifiche, processi e formule tecniche, software, liste di clienti, liste di potenziali clienti, nomi, indirizzi e altre informazioni riguardanti clienti e potenziali clienti, progetti di prodotti, vendite, costi (incluse eventuali tariffe di elaborazione pertinenti), listini prezzi e altre informazioni finanziarie non pubblicate, piani aziendali e dati di marketing, e qualsiasi altra informazione riservata e proprietaria, sia o meno contrassegnata come riservata o proprietaria. Le Informazioni Riservate di Runner AI includono tutte le informazioni che ricevi relative a noi, o ai Servizi, che non sono note al grande pubblico incluse informazioni relative al nostro programma e pratiche di sicurezza.
(2) Ciascuna parte accetta di utilizzare le Informazioni Riservate dell'altra parte esclusivamente come necessario per l'adempimento dei suoi obblighi ai sensi di questi Termini di Servizio e in conformità con eventuali altri obblighi in questi Termini di Servizio inclusa questa Sezione 6. Ciascuna parte accetta che prenderà tutte le misure ragionevoli, almeno sostanzialmente equivalenti alle misure che prende per proteggere le proprie informazioni proprietarie, per prevenire la duplicazione, divulgazione o utilizzo di tali Informazioni Riservate, diverse da (i) da o ai suoi dipendenti, agenti e subappaltatori che devono avere accesso a tali Informazioni Riservate per adempiere agli obblighi di tale parte qui stabiliti, che ciascuno tratterà tali Informazioni Riservate come previsto qui, e che sono ciascuno soggetto a obblighi di riservatezza verso tale parte che sono almeno altrettanto stringenti di quelli contenuti qui; o (ii) come richiesto da qualsiasi legge, regolamento o ordine di qualsiasi tribunale di giurisdizione appropriata sulle parti e la materia contenuta in questi Termini di Servizio, a condizione che, se legalmente consentito, la parte ricevente darà alla parte divulgante pronta notifica scritta e utilizzerà sforzi commercialmente ragionevoli per garantire che tale divulgazione sia trattata come riservata. Le Informazioni Riservate non includeranno alcuna informazione che la parte ricevente possa provare: (A) era già di dominio pubblico, o era già conosciuta da o in possesso della parte ricevente, al momento della divulgazione di tali informazioni; (B) è sviluppata indipendentemente dalla parte ricevente senza uso di o riferimento alle Informazioni Riservate dell'altra parte, e senza violare alcuna disposizione di questi Termini di Servizio; o (C) è successivamente ottenuta legittimamente dalla parte ricevente da una fonte diversa dalla parte divulgante senza violare alcuna disposizione di questi Termini di Servizio.
## 7. Limitazione di Responsabilità e Indennizzo
### Cosa significa
Non siamo responsabili per danni o cause legali che derivano se violi la legge, violi questo accordo o vai contro i diritti di una terza parte. Il Servizio è fornito "così com'è" e "come disponibile". Non forniamo garanzie e la nostra responsabilità è limitata in caso di errori o interruzioni.
(1) Comprendi espressamente e accetti che, nella misura consentita dalle leggi applicabili, Runner AI e i suoi fornitori non saranno responsabili per eventuali danni diretti, indiretti, incidentali, speciali, consequenziali o esemplari, inclusi ma non limitati a, danni per perdita di profitti, avviamento, uso, dati o altre perdite intangibili derivanti da o relative all'uso di o all'impossibilità di utilizzare il Servizio o questi Termini di Servizio (comunque derivanti, inclusa negligenza).
NELLA MASSIMA MISURA CONSENTITA DALLA LEGGE, NONOSTANTE QUALSIASI COSA CONTRARIA QUI CONTENUTA, LA NOSTRA RESPONSABILITÀ NEI TUOI CONFRONTI PER EVENTUALI DANNI DERIVANTI DA O RELATIVI A QUESTI TERMINI (PER QUALSIASI CAUSA E INDIPENDENTEMENTE DALLA FORMA DELL'AZIONE), SARÀ IN OGNI MOMENTO LIMITATA ALL'IMPORTO DELLE TARIFFE CHE HAI PAGATO A NOI NEI SEI (6) MESI PRECEDENTI (O, SE NON SONO STATE PAGATE TARIFFE, A UN MASSIMO DI CINQUANTA DOLLARI STATUNITENSI ($50)). L'ESISTENZA DI PIÙ DI UN RECLAMO NON AUMENTERÀ QUESTO LIMITE.
(2) Accetti di indennizzare e tenere noi e (come applicabile) il nostro genitore, sussidiarie, affiliate, partner di Runner AI, funzionari, direttori, agenti, dipendenti e fornitori indenni da qualsiasi reclamo o richiesta, inclusi ragionevoli onorari legali, fatti da terzi dovuti a o derivanti da (a) la tua violazione di questi Termini di Servizio o dei documenti che incorpora per riferimento (inclusa la PUA); (b) o la tua violazione di qualsiasi legge o dei diritti di una terza parte; o (c) qualsiasi aspetto della transazione tra te e il tuo Cliente, inclusi ma non limitati a rimborsi, transazioni fraudolente, presunta o effettiva violazione di leggi applicabili (incluse ma non limitate a leggi federali e statali sulla protezione dei consumatori), o la tua violazione dei Termini di Servizio.
(3) Sarai responsabile di qualsiasi violazione dei Termini di Servizio da parte delle tue affiliate, agenti o subappaltatori e sarai responsabile come se fosse la tua stessa violazione.
(4) Il tuo uso dei Servizi è a tuo esclusivo rischio. I Servizi sono forniti "così come sono" e "come disponibili" senza alcuna garanzia o condizione, espressa, implicita o statutaria.
(5) Runner AI non garantisce che i Servizi saranno ininterrotti, tempestivi, sicuri o privi di errori.
(6) Runner AI non garantisce che i risultati che possono essere ottenuti dall'uso dei Servizi saranno accurati o affidabili.
In particolare, riconosci che i Servizi utilizzano algoritmi di intelligenza artificiale e machine learning per fornire funzionalità come operazioni automatizzate e suggerimenti di crescita. Comprendi che questi sono sistemi probabilistici e Runner AI non fornisce alcuna garanzia riguardo alla redditività, successo o risultati specifici di qualsiasi azione intrapresa sulla base degli output o suggerimenti di questi sistemi AI.
(7) Runner AI non è responsabile di alcuno dei tuoi obblighi fiscali o responsabilità relativi all'uso dei Servizi di Runner AI.
(8) Runner AI non garantisce che la qualità di prodotti, servizi, informazioni o altri materiali acquistati o ottenuti da te attraverso i Servizi soddisferà le tue aspettative, o che eventuali errori nei Servizi saranno corretti.
(9) In nessun caso Runner AI sarà responsabile per qualsiasi perdita di ricavi, dati o buona volontà dei clienti derivante dall'uso di Esperimenti o dalle prestazioni di qualsiasi esperimento generato dall'IA.
## 8. Proprietà Intellettuale e I Tuoi Materiali
### Cosa significa
Tutto ciò che carichi rimane tuo (se era tuo) ed è tua responsabilità, ma Runner AI può utilizzare e pubblicare le cose che carichi. Tutto ciò che viene caricato su Runner AI rimane proprietà e responsabilità del suo proprietario iniziale. Tuttavia, Runner AI riceverà una licenza dei materiali pubblicati attraverso la nostra piattaforma che possiamo utilizzare per gestire e promuovere i nostri Servizi.
### 8.1 I Tuoi Materiali
(1) Non rivendichiamo la proprietà dei Materiali che fornisci a Runner AI; tuttavia, richiediamo una licenza per quei Materiali. Concedi alla società un diritto e una licenza non esclusivi, trasferibili, sublicenziabili, esenti da royalty, mondiali per ospitare, utilizzare, distribuire, esporre, modificare, eseguire, copiare, archiviare, eseguire pubblicamente, comunicare al pubblico (incluso tramite telecomunicazione), trasmettere, riprodurre, rendere disponibile, visualizzare e tradurre, e creare opere derivate di qualsiasi Materiale fornito da te in relazione ai Servizi. Possiamo utilizzare i nostri diritti ai sensi di questa licenza per gestire, fornire e promuovere i Servizi e per adempiere ai nostri obblighi ed esercitare i nostri diritti ai sensi dei Termini di Servizio. Dichiari, garantisci e accetti di avere tutti i diritti necessari nei Materiali per concedere questa licenza. Rinunci irrevocabilmente a tutti i diritti morali che potresti avere nei Materiali a favore di Runner AI e accetti che questa rinuncia possa essere invocata da chiunque ottenga diritti nei materiali attraverso Runner AI, incluso chiunque a cui Runner AI possa trasferire o concedere (incluso tramite licenza o sublicenza) eventuali diritti nei Materiali.
(2) Se possedevi i Materiali prima di fornirli a Runner AI allora, nonostante li carichi sul tuo Negozio Runner AI rimangono tuoi, soggetto a eventuali diritti o licenze concessi nei Termini di Servizio o altrove. Puoi rimuovere il tuo Negozio Runner AI in qualsiasi momento eliminando il tuo Account. La rimozione del tuo Negozio Runner AI non termina eventuali diritti o licenze concessi ai Materiali che Runner AI richiede per esercitare eventuali diritti o adempiere a eventuali obblighi sorti durante la Durata.
(3) Accetti che Runner AI può, in qualsiasi momento, rivedere ed eliminare qualsiasi o tutti i Materiali inviati ai Servizi, sebbene Runner AI non sia obbligato a farlo.
(4) Concedi a Runner AI un diritto e una licenza non esclusivi, trasferibili, sublicenziabili, esenti da royalty, mondiali per utilizzare i nomi, marchi, marchi di servizio e loghi associati al tuo Negozio ("I Tuoi Marchi") per gestire, fornire e promuovere i Servizi e per adempiere ai nostri obblighi ed esercitare i nostri diritti ai sensi dei Termini di Servizio. Questa licenza sopravviverà a qualsiasi risoluzione dei Termini di Servizio esclusivamente nella misura in cui Runner AI richieda la licenza per esercitare eventuali diritti o adempiere a eventuali obblighi sorti durante la Durata.
### 8.2 Proprietà Intellettuale di Runner AI
(1) Accetti di non poter utilizzare alcun marchio, logo o marchio di servizio di Runner AI, sia registrato che non registrato, inclusi ma non limitati al marchio nominativo Runner AI e al marchio grafico Runner AI ("Marchi Runner AI") a meno che tu non sia autorizzato a farlo da Runner AI per iscritto. Accetti di non utilizzare o adottare alcun marchio che possa essere considerato confondibile con i Marchi Runner AI. Accetti che eventuali variazioni o errori di ortografia dei Marchi Runner AI sarebbero considerati confondibili con i Marchi Runner AI.
(2) Accetti di non acquistare, registrare o utilizzare parole chiave di motori di ricerca o altre pay-per-click (come Google Ads), marchi, indirizzi email, nomi di social media o nomi di dominio (inclusi senza limitazione domini di primo livello, sottodomini e URL di pagina) che utilizzano o includono Runner AI o Marchi Runner AI o che utilizzano o includono termini che possono essere confondibili con i Marchi Runner AI.
(3) Riconosci e accetti che i Termini di Servizio non ti danno alcun diritto di implementare brevetti Runner AI.
### 8.3 Utilizzo dei Dati per il Miglioramento dell'AI
Per monitorare, migliorare e proteggere i nostri Servizi, e per ottimizzare i nostri algoritmi e modelli di intelligenza artificiale, ci concedi un diritto perpetuo, irrevocabile, mondiale, esente da royalty di utilizzare i tuoi 'Materiali' e i dati operativi associati in forma anonimizzata e aggregata. Ci impegniamo che tale utilizzo non identificherà alcun individuo specifico, commerciante o i loro clienti, e sarà utilizzato esclusivamente per lo scopo di migliorare la qualità complessiva del servizio e le capacità tecniche della nostra piattaforma.
## 9. Servizi Aggiuntivi
### 9.1 Integrazioni di Spedizione di Terze Parti
I nostri Servizi possono integrarsi con vari corrieri di spedizione e servizi di terze parti per gestire la tua evasione. Il tuo utilizzo di tali servizi di terze parti è soggetto ai rispettivi termini e condizioni, e sei l'unico responsabile del tuo rapporto con loro.
### 9.2 Servizi Beta
#### Cosa significa
I Servizi Beta possono essere offerti di volta in volta. Non fanno parte dei Servizi regolari, e potrebbero avere errori o cambiare in qualsiasi momento. Utilizzi i Servizi Beta a tuo rischio, e non siamo responsabili per eventuali perdite o danni che potrebbero derivare dall'utilizzo di un Servizio Beta. Potresti essere tenuto a mantenere riservata la tua partecipazione ai Servizi Beta.
Di volta in volta, Runner AI può, a sua esclusiva discrezione, invitarti a utilizzare, su base di prova, funzionalità pre-release o beta che sono in sviluppo e non ancora disponibili a tutti i commercianti ("Servizi Beta"). I Servizi Beta non fanno parte dei Servizi, e i Servizi Beta possono essere soggetti a termini e condizioni aggiuntivi, che Runner AI ti fornirà prima del tuo utilizzo dei Servizi Beta. Tali Servizi Beta e tutte le conversazioni e i materiali associati ad essi saranno considerati Informazioni Riservate di Runner AI e soggetti alle disposizioni di riservatezza in questo accordo. Senza limitare la generalità di quanto sopra, accetti che non farai alcuna dichiarazione pubblica o divulgherai in altro modo la tua partecipazione ai Servizi Beta senza il previo consenso scritto di Runner AI. Runner AI non fornisce alcuna dichiarazione o garanzia che i Servizi Beta funzioneranno. Runner AI può interrompere i Servizi Beta in qualsiasi momento a sua esclusiva discrezione. Runner AI non avrà alcuna responsabilità per eventuali danni o danni derivanti da o in relazione a un Servizio Beta. I Servizi Beta potrebbero non funzionare allo stesso modo di una versione finale. Runner AI può modificare o non rilasciare una versione finale o commerciale di un Servizio Beta a nostra esclusiva discrezione.
### 9.3 Runner AI Pixel Manager
#### Cosa significa
Il Runner AI Pixel Manager ti consente o a una terza parte di tracciare gli eventi dei clienti aggiungendo pixel al tuo Negozio Runner AI. Se utilizzi il Runner AI Pixel Manager, sei responsabile dell'ottenimento di tutti i consensi necessari dai visitatori del negozio e dai clienti di cui tracci gli eventi.
Runner AI ti consente di aggiungere pixel al tuo Negozio Runner AI per consentirti o a una terza parte di tracciare gli eventi dei clienti (il "Runner AI Pixel Manager"). Puoi gestire i tuoi pixel dall'interfaccia utente nella console amministrativa del tuo Negozio Runner AI.
(1) In aggiunta ai termini applicabili al tuo utilizzo dei Servizi in generale (inclusi questi Termini di Servizio, la Politica di Utilizzo Accettabile e la Politica sulla Privacy di Runner AI), i seguenti termini si applicano al tuo accesso e utilizzo del Runner AI Pixel Manager:
- a. Rispetterai tutte le leggi applicabili e otterrai tutti i consensi necessari da ogni visitatore del sito e cliente di cui tracci gli eventi;
- b. Se fornisci a Runner AI qualsiasi dato raccolto utilizzando pixel, inclusi nomi, indirizzi email, numeri di telefono o altri dati che identificano personalmente un individuo, otterrai tutti i diritti e i consensi necessari prima di fornire a Runner AI le suddette informazioni;
- c. Accetti che Runner AI possa disabilitare qualsiasi pixel che Runner AI identifica come dannoso, a esclusiva discrezione di Runner AI; e
- d. Non utilizzerai, e non consentirai a terze parti di utilizzare, pixel:
- i. per impegnarsi in o promuovere qualsiasi attività illegale, violativa, diffamatoria o altrimenti dannosa; o
- ii. per disabilitare, interferire con o eludere qualsiasi aspetto dei Servizi.
(2) Runner AI può raccogliere informazioni associate al Runner AI Pixel Manager, come il modo in cui i pixel vengono utilizzati, e come e quali script vengono aggiunti. Runner AI può utilizzare questi dati per migliorare, mantenere, proteggere e sviluppare il Runner AI Pixel Manager.
### 9.4 Esperimenti (Beta) ed Esperimenti Automatizzati
#### Cosa significa
Esperimenti è una funzionalità sperimentale che utilizza l'IA per testare diverse versioni del tuo negozio. Attivandola, ci permetti di mostrare variazioni generate dall'IA del tuo negozio ad alcuni dei tuoi visitatori, inclusi ma non limitati a layout, prezzi e regole di spedizione.
Solo l'Amministratore del tuo negozio può abilitare questa funzionalità e decidere quanto traffico testare (partendo dal 10% per impostazione predefinita). Poiché questa è una funzionalità Beta, non vi è alcuna garanzia che aumenterà le tue vendite o funzionerà perfettamente ogni volta. La usi a tuo rischio.
(1) **Autorizzazione per Traffico Sperimentale**: Abilitando attivamente Esperimenti all'interno dei Servizi, autorizzi espressamente Runner AI a condurre esperimenti automatizzati sul tuo Negozio. Riconosci e accetti che:
- **Allocazione del Traffico**: All'attivazione, il Sistema allocherà automaticamente il dieci percento (10%) o il rapporto di traffico concordato del traffico web del tuo Negozio a un gruppo sperimentale (il "Gruppo Sperimentale").
- **Controllo dell'Utente**: Mantieni il diritto di aumentare, diminuire o disabilitare manualmente questa allocazione di traffico in qualsiasi momento attraverso il pannello di amministrazione.
- **Variazioni Sperimentali**: I visitatori nel Gruppo Sperimentale potrebbero vedere variazioni, inclusi ma non limitati a layout del negozio, prezzi dei prodotti, tariffe di spedizione e altri contenuti o logiche del negozio, che differiscono dalla versione principale del tuo Negozio. Sei responsabile della conformità alle leggi locali riguardanti la determinazione dinamica dei prezzi e la divulgazione ai consumatori.
(2) **Controllo Amministrativo**: L'accesso alle impostazioni di Esperimenti è limitato agli Utenti con permessi "Admin". Solo un Amministratore autorizzato ha l'autorità di:
- Abilitare o disabilitare la funzionalità Esperimenti;
- Regolare le impostazioni sperimentali, incluse le percentuali di allocazione del traffico.
Runner AI non sarà responsabile per alcuna impostazione modificata da individui a cui hai concesso accesso amministrativo.
(3) **Dichiarazione di Non Responsabilità Beta e Limitazione di Responsabilità**: Esperimenti è fornito come funzionalità "Beta" e non fa parte dei Servizi standard. Nonostante qualsiasi disposizione contraria in questi Termini di Servizio:
- **Evoluzione del Servizio**: La funzionalità, le prestazioni e i layout dell'interfaccia utente di Esperimenti possono cambiare, essere sospesi o interrotti da Runner AI in qualsiasi momento senza preavviso.
- **Nessuna Garanzia di Risultati**: Runner AI non fa dichiarazioni né garanzie riguardo al risultato di qualsiasi esperimento. Non garantiamo tassi di conversione specifici, aumenti di ricavi, posizionamenti nei motori di ricerca o altri risultati aziendali.
- **Assunzione del Rischio**: Riconosci che il contenuto sperimentale generato dall'IA può contenere errori. Il tuo uso di Esperimenti è a tuo esclusivo rischio, e Runner AI non è responsabile per alcun impatto negativo sulle prestazioni del tuo Negozio, inclusi ma non limitati a perdita di ricavi, errori di prezzo o controversie con i clienti, derivanti da tali esperimenti.
## 10. Feedback e Recensioni
### Cosa significa
Accogliamo con favore il feedback dei clienti ma non siamo obbligati a garantire che idee e suggerimenti riguardanti i nostri Servizi o i servizi di terze parti rimangano riservati e possiamo utilizzare il feedback in qualsiasi modo desideriamo.
Runner AI accoglie con favore idee e/o suggerimenti riguardanti miglioramenti o aggiunte ai Servizi. In nessuna circostanza alcuna divulgazione di qualsiasi idea, suggerimento o materiale correlato o qualsiasi recensione dei Servizi, Servizi di Terze Parti o qualsiasi Fornitore di Terze Parti (collettivamente, "Feedback") a Runner AI sarà soggetta a alcun obbligo di riservatezza o aspettativa di compensazione. Inviando Feedback a Runner AI (sia inviato direttamente a Runner AI che pubblicato su qualsiasi forum o pagina ospitati da Runner AI), rinunci a tutti i diritti nel Feedback e che Runner AI è libero di implementare e utilizzare il Feedback se desiderato, come fornito da te o come modificato da Runner AI, senza ottenere permesso o licenza da te o da terze parti. Qualsiasi recensione di un Servizio di Terze Parti o Fornitore di Terze Parti che invii a Runner AI deve essere accurata per quanto di tua conoscenza, e non deve essere illegale, oscena, minacciosa, diffamatoria, invasiva della privacy, violativa di diritti di proprietà intellettuale, o altrimenti dannosa per terze parti o censurabile. Runner AI si riserva il diritto (ma non l'obbligo) di rimuovere o modificare Feedback di Servizi di Terze Parti o Fornitori di Terze Parti, ma non ispeziona regolarmente il Feedback pubblicato.
## 11. Procedura di Notifica e Rimozione DMCA
### Cosa significa
Runner AI rispetta i diritti di proprietà intellettuale e anche tu dovresti farlo. Se riceviamo una Notifica DMCA, possiamo disabilitare l'accesso o rimuovere il contenuto presumibilmente violativo dal tuo Negozio. Se non ritieni che il reclamo sia valido, puoi inviare una contro-notifica. Se ritieni che uno dei nostri commercianti stia violando i tuoi diritti di proprietà intellettuale, puoi inviare una Notifica DMCA a Runner AI. Disabiliteremo rapidamente l'accesso o rimuoveremo il contenuto e notificheremo il commerciante.
Runner AI supporta la protezione della proprietà intellettuale e chiede ai commercianti di Runner AI di fare lo stesso. È nostra politica rispondere a tutte le notifiche di presunta violazione del copyright. Se qualcuno ritiene che uno dei nostri commercianti stia violando i suoi diritti di proprietà intellettuale, può inviare una Notifica DMCA all'agente designato di Runner AI utilizzando support@adaptivemachines.ai. Al ricevimento di una Notifica DMCA, possiamo rimuovere o disabilitare l'accesso ai Materiali ritenuti essere una violazione del copyright. Una volta fornita una notifica di rimozione, il commerciante può rispondere con una contro-notifica utilizzando l'email se si oppone al reclamo. Il reclamante originale ha 14 giorni lavorativi dopo che riceviamo una contro-notifica per ottenere un'ordinanza del tribunale che impedisca al commerciante di impegnarsi nell'attività violativa, altrimenti ripristiniamo il materiale.
## 12. Privacy e Protezione dei Dati
### Cosa significa
L'uso e la raccolta di informazioni personali da parte di Runner AI sono regolati dalla nostra Politica sulla Privacy. L'uso e la raccolta di informazioni personali dei clienti da parte di Runner AI sono ulteriormente regolati dal nostro Accordo sul Trattamento dei Dati.
Runner AI è fermamente impegnata a proteggere la privacy delle tue informazioni personali e delle informazioni personali dei tuoi clienti. Utilizzando il Servizio, riconosci e accetti che la raccolta, l'utilizzo e la divulgazione di queste informazioni personali da parte di Runner AI sono regolati dalla nostra [Politica sulla Privacy](/it/legal/policies).
Nella misura in cui Runner AI tratta informazioni personali dei tuoi clienti come "responsabile del trattamento" o "fornitore di servizi" ai sensi di determinate leggi sulla privacy o protezione dei dati, incluso il Regolamento Generale sulla Protezione dei Dati dell'UE o del Regno Unito e il California Consumer Privacy Act, la raccolta e l'uso di informazioni personali da parte di Runner AI sono anche soggetti al nostro [Accordo sul Trattamento dei Dati](/it/legal/dpa).
## 13. Parte Contraente di Runner AI
"Parte Contraente" indica Adaptive Machines, Inc., una società del Delaware, con la sua sede principale in 131 Continental Dr Suite 305 Newark, DE, 19713 US
Le parti si sottomettono irrevocabilmente e incondizionatamente alla giurisdizione esclusiva dei tribunali statali e federali situati nello Stato del Delaware rispetto a qualsiasi controversia o reclamo derivante da o in relazione ai Termini di Servizio. La Convenzione delle Nazioni Unite sui Contratti per la Vendita Internazionale di Beni non si applicherà a questi Termini di Servizio ed è qui espressamente esclusa.
## 14. Durata e Risoluzione
### Cosa significa
Puoi cancellare il tuo abbonamento in qualsiasi momento dalle impostazioni del tuo account. Possiamo terminare il tuo account in qualsiasi momento. Per i Negozi con un piano gratuito, Runner AI si riserva il diritto di eliminare permanentemente il Negozio e tutti i dati associati se il Negozio rimane inattivo per un periodo di quattordici (14) giorni consecutivi.
(1) La durata di questi Termini di Servizio inizierà alla data del completamento della tua registrazione per l'uso di un Servizio e continuerà fino alla risoluzione da parte nostra o da parte tua, come previsto di seguito (la "Durata").
(2) Puoi cancellare il tuo Account e terminare i Termini di Servizio in qualsiasi momento accedendo alle impostazioni del tuo account.
(3) Senza limitare altri rimedi, possiamo sospendere o terminare il tuo Account o i Termini di Servizio per qualsiasi motivo, senza preavviso e in qualsiasi momento (a meno che non sia altrimenti richiesto dalla legge), incluso se sospettiamo che tu (per condanna, accordo, indagine assicurativa o di deposito in garanzia, o altrimenti) ti sia impegnato in attività fraudolenta in relazione all'uso dei Servizi. La risoluzione dei Termini di Servizio sarà senza pregiudizio per eventuali diritti o obblighi sorti prima della data di risoluzione.
(4) Alla risoluzione dei Servizi da parte di una delle parti per qualsiasi motivo:
- Runner AI cesserà di fornirti i Servizi e non sarai più in grado di accedere al tuo Account;
- salvo diversamente previsto nei Termini di Servizio, non avrai diritto ad alcun rimborso di eventuali Tariffe, pro rata o altrimenti;
- qualsiasi saldo in sospeso dovuto a Runner AI per il tuo utilizzo dei Servizi fino alla data effettiva di tale risoluzione diventerà immediatamente dovuto e pagabile per intero; e
- il tuo Negozio Runner AI sarà messo offline.
(5) Se ci sono Tariffe in sospeso dovute da te alla data di risoluzione del Servizio, riceverai una fattura finale via email. Una volta che tale fattura è stata pagata per intero, non ti verrà addebitato di nuovo.
(6) Account Gratuiti Inattivi: Per i Negozi con un piano di abbonamento gratuito (escluse le "prove gratuite" temporanee di un piano a pagamento), Runner AI si riserva il diritto di eliminare permanentemente il Negozio e tutti i dati associati se il Negozio rimane inattivo per un periodo di quattordici (14) giorni consecutivi. Runner AI fornirà un avviso tramite l'Indirizzo Email Principale prima di tale eliminazione. Riconosci che Runner AI non avrà alcuna responsabilità per qualsiasi perdita di dati derivante dall'eliminazione di un Negozio inattivo ai sensi di questa Sezione.
## 15. Modifiche
### Cosa significa
Se apportiamo una modifica materiale ai Termini di Servizio che influisce negativamente sui tuoi diritti ai sensi dei Termini di Servizio o sul tuo utilizzo dei nostri Servizi in modo materiale, ti notificheremo in anticipo (a meno che la modifica non riguardi requisiti legali o per prevenire abusi dei nostri Servizi, tra le altre cose).
(1) Ci riserviamo il diritto, a nostra esclusiva e assoluta discrezione, di aggiornare o modificare qualsiasi porzione dei Termini di Servizio in qualsiasi momento. Ti forniremo ragionevole preavviso delle modifiche ai Termini di Servizio che influiscono materialmente in modo negativo sul tuo utilizzo dei Servizi o sui tuoi diritti ai sensi dei Termini di Servizio inviando un'email all'Indirizzo Email Principale, fornendo notifica attraverso la console amministrativa di Runner AI, o con mezzi simili. Tuttavia, Runner AI può apportare modifiche che influiscono materialmente in modo negativo sul tuo utilizzo dei Servizi o sui tuoi diritti ai sensi dei Termini di Servizio in qualsiasi momento e con effetto immediato (i) per motivi legali, normativi, di prevenzione di frodi e abusi, o di sicurezza; o (ii) per limitare prodotti o attività che riteniamo non sicuri, inappropriati o offensivi. A meno che non indichiamo diversamente nella nostra notifica (se applicabile), eventuali modifiche ai Termini di Servizio saranno efficaci immediatamente al momento della pubblicazione di tali termini aggiornati in questa posizione. Il tuo accesso continuato a o l'utilizzo dei Servizi dopo che forniamo tale notifica, se applicabile, o dopo che pubblichiamo tali termini aggiornati, costituisce la tua accettazione delle modifiche e il consenso a essere vincolato dai Termini di Servizio come modificati. Se non sei d'accordo con i Termini di Servizio modificati, devi smettere di accedere e utilizzare i Servizi.
(2) Runner AI può modificare le Tariffe per i Servizi di volta in volta. Ti forniremo un preavviso di 30 giorni prima di eventuali modifiche alle Tariffe inviando un'email all'Account Email Principale, fornendo notifica attraverso la console amministrativa di Runner AI, o con mezzi simili. Runner AI non sarà responsabile nei tuoi confronti o nei confronti di terzi per eventuali modifiche, cambiamenti di prezzo, sospensione o interruzione dei Servizi (o di qualsiasi loro parte).
## 16. Condizioni Generali
(1) I Termini di Servizio, inclusi i documenti che incorpora per riferimento, costituiscono l'intero accordo tra te e Runner AI e regolano il tuo utilizzo dei Servizi e del tuo Account, sostituendo eventuali accordi precedenti tra te e la società (inclusi, ma non limitati a, eventuali versioni precedenti dei Termini di Servizio).
(2) Il mancato esercizio o applicazione da parte di Runner AI di qualsiasi diritto o disposizione dei Termini di Servizio non costituirà una rinuncia a tale diritto o disposizione. Se una qualsiasi disposizione dei Termini di Servizio, inclusi tutti i termini e le condizioni e altri documenti che incorpora per riferimento, è ritenuta da un tribunale di giurisdizione competente contraria alla legge, tale disposizione sarà modificata e interpretata in modo da realizzare al meglio gli obiettivi della disposizione originale nella massima misura consentita dalla legge, e le disposizioni rimanenti dei Termini di Servizio rimarranno in pieno vigore ed effetto.
(3) Salvo per Runner AI e le sue affiliate, te o chiunque acceda ai Servizi Runner AI ai sensi di questi Termini di Servizio, a meno che non sia diversamente previsto in questi Termini di Servizio, nessuna persona o entità che non sia parte di questi Termini di Servizio avrà alcun diritto di far rispettare alcun termine di questi Termini di Servizio, indipendentemente dal fatto che tale persona o entità sia stata identificata per nome, come membro di una classe o come rispondente a una particolare descrizione. Per evitare dubbi, ciò non influenzerà i diritti di eventuali cessionari o trasferiti consentiti di questi Termini.
(4) Questi Termini di Servizio e qualsiasi controversia o reclamo derivante da o in relazione ad essi saranno regolati e interpretati in conformità con le leggi dello Stato del Delaware, senza riguardo ai suoi principi di conflitto di leggi.
(5) I Termini di Servizio possono essere disponibili in lingue diverse dall'inglese. Nella misura di eventuali incoerenze o conflitti tra questi Termini di Servizio in inglese e i Termini di Servizio di Runner AI disponibili in un'altra lingua, prevarrà la versione inglese più recente dei Termini di Servizio. Eventuali controversie derivanti da questi Termini di Servizio saranno risolte in inglese a meno che non sia diversamente determinato da Runner AI (agendo a sua esclusiva discrezione) o come richiesto dalla legge applicabile.
(6) Tutti i termini e le disposizioni dei Termini di Servizio saranno vincolanti per e a beneficio delle parti dei Termini di Servizio e dei rispettivi eredi, successori, cessionari consentiti e rappresentanti legali. La società avrà il permesso di assegnare questi Termini di Servizio senza preavviso a te o consenso da parte tua. Non avrai alcun diritto di assegnare o altrimenti trasferire i Termini di Servizio, o uno qualsiasi dei tuoi diritti o obblighi qui previsti, a terze parti senza il previo consenso scritto di Runner AI, da concedere o rifiutare a esclusiva discrezione di Runner AI.
(7) Se una qualsiasi disposizione, o parte della disposizione, in questi Termini di Servizio è, per qualsiasi motivo, ritenuta non valida, illegale o inapplicabile in qualsiasi aspetto, allora tale invalidità, illegalità o inapplicabilità non influenzerà alcuna altra disposizione (o la parte non influenzata della disposizione) dei Termini di Servizio, e i Termini di Servizio saranno interpretati come se tale disposizione non valida, illegale o inapplicabile, o parte della disposizione, non fosse mai stata contenuta nei Termini di Servizio.
(8) Alla risoluzione, tutti i diritti e gli obblighi correlati ai sensi dei Termini di Servizio terminano immediatamente, tranne per il fatto che (a) rimarrai responsabile dell'adempimento di tutti i tuoi obblighi in relazione alle transazioni stipulate prima della risoluzione e per eventuali responsabilità maturate prima o come risultato della risoluzione; e le Sezioni 1 (Termini dell'Account), 5 (Pagamento di Tariffe), 6 (Riservatezza), 7 (Limitazione di Responsabilità e Indennizzo), 8.1 (Proprietà Intellettuale e I Tuoi Materiali), 10 (Feedback e Recensioni), 12 (Privacy e Protezione dei Dati), 13 (Parte Contraente di Runner AI), 14 (Cancellazione e Risoluzione), 15 (Modifiche), e 16 (Condizioni Generali) sopravviveranno alla risoluzione o scadenza di questi Termini di Servizio.
---
Adaptive Machines, Inc.
131 Continental Dr Suite 305 Newark, DE, 19713 US
---
# アカウントと設定
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings
Runnerは、ワークスペース、現在のストア、またはあなたに影響を与えるかによって、設定をグループ化します。これにより、共有請求とメンバーがストア固有のドメインと個人プロフィールから分離されたままになります。
## このガイドの内容
各設定グループがどこに存在するか、どのページがロール、プラン、公開済みストア、またはステージング機能を必要とするかを理解します。
## 利用可能性と前提条件
- サインインしている必要があります。
- ワークスペースまたはプロジェクトのメニューから**設定**を開きます。
- ストア設定は、プロジェクト内から設定を開いた場合にのみ表示されます。
- 編集前に、設定サイドバーのワークスペース名またはストア名を確認します。個人用の操作はアカウント名の下にあります。
- ほかのデバイスのセッションを終了する場合や、アカウントを削除する場合は、Runnerサポートに連絡してください。[セキュリティとセッション](/ja/guides/account-and-settings/security-and-sessions)を参照してください。
- 一部のコントロールにはワークスペース オーナーまたは管理者権限が必要です。
- ドメイン、APIキー、および実験ページは、プラン、公開状態、またはステージング利用可能性によって非表示またはゲートされる場合があります。
## 設定を開く
1. 対象のワークスペースまたはプロジェクトでメニューを開きます。
2. **設定** を選択します。
3. **ワークスペース: _ワークスペース名_**の選択欄を確認し、そのグループ、**ストア: _ストア名_**、またはアカウント名の下からページを選択します。ストア内で設定を開くと、ストアの一般設定から始まる場合があります。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
ページを選ぶ前に、ワークスペースとストアの見出しを確認します。アカウントの操作はその下にあります。画像は英語の画面です。
## 設定マップ
| グループとページ | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| ワークスペース → **一般** | ワークスペースの名前を変更または説明します。 | 有効な変更は自動的に保存されます。危険ゾーンにはワークスペース削除も含まれます。 |
| ワークスペース → **メンバー** | 人を招待し、アクティブまたは保留中のアクセスを管理します。 | オーナーは招待、招待のキャンセル、またはメンバーの削除ができます。対象メンバーは退出できます。 |
| ワークスペース → **プラン＆請求** | 現在のプランと利用可能な請求アクションを確認します。 | プラン カード、確認、チェックアウト、請求管理、および追加クレジット オプションがアカウント状態に応じて表示されます。 |
| ワークスペース → **使用状況とクレジット** | 残高、ソース、および支出を理解します。 | 1つの日付範囲コントロールが概要、グラフ、カテゴリ カード、およびアクティビティ フィードを更新します。 |
| ストア → **一般** | 現在のストアのアイデンティティと検索外観を管理します。 | 名前、ページ タイトル、説明、ファビコン、ウォーターマーク、およびストア削除コントロールが表示されます。 |
| ストア → **ドメイン** | ドメインを接続、購入、更新、または転送します。 | 利用可能性はプラン、公開、権限、およびドメイン状態に依存します。 |
| ストア → **カスタム スクリプト** | ストアフロントにJavaScriptを追加します。 | **変更を保存** を選択するまで、変更は保存されません。 |
| ストア → **エージェント** | このプロジェクトで利用可能なスキルを選択します。 | このストアの構成可能なスキルを追加または無効にできます。 |
| ストア → **実験** | 自動実験目標とトラフィックを構成します。 | このベータ ページは有効になっている場合にのみ表示され、公開済みストアが必要です。 |
| アカウント名 → **マイ設定** | 言語、週次パフォーマンスメール、操作音を選択します。 | 設定が保存されます。言語を変更すると、現在のページが選択言語で再読み込みされます。 |
| アカウント名 → **APIキー** | プログラムからアクセスするための認証情報を作成します。 | 完全なシークレットは一度だけ表示されます。取り消しは元に戻せません。このページは条件付きです。 |
## 正しいスコープを選択
1. メンバー、共有クレジット、プラン、および請求には **ワークスペース** を使用します。
2. 現在のストアフロント、ドメイン、スクリプト、およびプロジェクト エージェント設定には **ストア** を使用します。
3. 自分のプロフィール、言語、APIキーには**個人**を使用します。
4. 機密アクションの前に、ダイアログに表示されるワークスペースとストア名を確認します。
## 一般的な状態と制限
- **保存しています…** の後に **保存されました** は、自動保存フィールドが完了したことを確認します。
- 無効なコントロールは、権限の欠落、プラン ゲート、ストア前提条件、または既に進行中の操作を示す場合があります。
- 請求ページとドメイン ページは現在の条件と金額を表示します。古いスクリーンショットまたはコピーされた価格に依存しないでください。
- 破壊的なアクションは確認が必要ですが、正確な確認はアクションによって異なります。
- 非表示ページは、現在のインターフェースがアカウントに公開していない限り、コピーされたリンクを通じて開かれるべきではありません。
## トラブルシューティング
- ストア グループが見つからない場合は、設定を閉じ、目的のプロジェクトに入り、設定を再度開きます。
- ページがアップグレードまたは公開優先状態を表示する場合は、意図したワークフローに適合する場合にのみその前提条件を完了してください。
- 自動保存が失敗した場合、以前の値は残るか戻ります。フィールドを修正して再試行してください。
- 変更されているワークスペースが不確かな場合は、ダイアログを閉じ、そのワークスペースから設定を再度開きます。
- アカウント セキュリティ ヘルプが必要だが、承認されたエントリが表示されない場合は、直接ルートを推測するのではなく、runner サポートに連絡してください。
## 関連ガイド
- [ワークスペース一般](/ja/guides/account-and-settings/workspace-general)
- [メンバーと招待](/ja/guides/workspace/members-and-invitations)
- [サブスクリプションプラン](/ja/guides/plans-and-billing/subscription-plans)
- [ストア一般](/ja/guides/account-and-settings/store-general)
- [セキュリティとセッション](/ja/guides/account-and-settings/security-and-sessions)
---
# 実験設定
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/ai-lab
実験設定は、対象となる公開済みストアの自動ストアフロント実験を構成します。Runner が選択した1つのビジネス目標をライブ トラフィックの一部で最適化することを意図している場合に使用します。
## このガイドの内容
ベータ設定を有効にする方法、目標とトラフィック配分を選択する方法、保存する方法、開始状態または停止状態を認識する方法を理解します。
## 利用可能性と前提条件
- **実験** は条件付きベータページであり、アカウントで有効にされていない限り非表示です。
- ストアは公開済みである必要があります。ドラフトは公開が必要な利用不可状態を表示します。
- 実験を有効にするには、リンクされた **実験利用規約** への同意が必要です。
- ライブ実験設定を変更すると、ストアフロント訪問者に影響を与える可能性があります。保存する前に、選択した目標とトラフィックを確認してください。
## エントリパス
対象のプロジェクトで、**設定 → ストア: _ストア名_ → 実験** を選択します。
## コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **実験を有効にする** スイッチ | ストアのLab構成を表示または停止します。 | オンにすると目標とトラフィック コントロールが表示されます。保存は有効な構成を送信します。オフにするとアクティブな構成の停止が開始されます。 |
| **実験利用規約** | ベータ有効化に関連する利用規約を確認します。 | 法的セクションが新しいタブで開きます。 |
| **目標を定義** | 実験が改善すべきメトリクスをRunnerに伝えます。 | 目標を選択するとそのカードがアクティブとしてマークされます。 |
| **トラフィック** スライダー/入力 | 実験に割り当てられたストアフロント トラフィックのシェアを選択します。 | 値は表示された最小値と100%の範囲内に留まります。 |
| クイック パーセンテージ ボタン | 一般的なトラフィック値を選択します。 | スライダーと数値が一緒に更新されます。 |
| **保存** | 有効な目標とトラフィック設定を適用します。 | Runnerは構成操作を開始し、完了するまでコントロールを無効にします。 |
利用可能な目標には、コンバージョン率、カートに追加率、チェックアウト開始率、バナー エンゲージメント率、ボタン クリックスルー率、平均注文額が含まれます。
以下の設定手順は、公開の前提条件を満たした後に使用できます。モデル選択が表示される場合は、保存前に利用可能なモデルを確認してください。選択肢はアカウントによって異なります。ストアが下書きの場合は、[公開](/ja/guides/storefront-and-publishing)を参照してください。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgQW4QL8Z7SKFNWPlB41r2ExXnDq3eRHhj6fkc)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
未公開のストアには、実験の操作ではなく前提条件が表示されます。実験の開始や測定は行っていません。画像は英語の画面です。
## 実験を構成
1. ストアを公開してから、**ストア → 実験** を開きます。
2. ベータの説明と **実験利用規約** を読みます。
3. **実験を有効にする** をオンにします。
4. 1つの目標を選択します。
5. 表示された最小値以上のトラフィック配分を選択します。
6. 選択した目標とパーセンテージを確認します。
7. **保存** を選択します。
8. 開始ステータスが完了するのを待ち、離れる前に保存された状態を確認します。
## 実験を停止
1. 同じストアの実験設定に戻ります。
2. **実験を有効にする** をオフにします。
3. **実験を停止しています。お待ちください…** を待ちます。
4. 操作が終了した後、無効な状態を確認します。
操作が進行中に切り替えを繰り返さないでください。
## 状態と制限
- 公開されていないストアは、機能が現在利用できないことを示し、最初に公開するよう求めます。
- **実験を開始しています。お待ちください…** は同時変更をブロックします。
- **実験を停止しています。お待ちください…** は同時変更をブロックします。
- 保存前に目標が必須です。
- トラフィックは表示された最小値から100%に制限されます。
- 設定エントリ全体は、機能が有効になっていないアカウントでは存在しない場合があります。
## トラブルシューティング
- 実験が見つからない場合は、コピーされた直接リンクに依存しないでください。機能はアカウントで有効になっていません。
- ページが公開を求める場合は、ライブ実験を構成する前に公開を完了してください。
- 保存で目標が必須であると報告される場合は、1つの目標カードを選択して再試行してください。
- コントロールが無効な場合は、現在の開始または停止操作が完了するのを待ってください。
- 保存された状態が不明な場合は、もう一度切り替える前にページを再度開いてください。
## 関連ガイド
- [ストア一般](./store-general)
- [サブスクリプションプラン](../plans-and-billing/subscription-plans)
- [アカウントと設定の概要](/ja/guides/account-and-settings)
---
# APIキー
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/api-keys
APIキーは、プログラムによるRunner アクセスのための個人的なシークレットです。信頼できるアプリケーションに対してのみ1つを作成し、安全に保存し、不要になったら取り消します。
## このガイドの内容
ワンタイム シークレットを作成して保存する方法、既存のキーを公開せずに識別する方法、確認付きでキーを取り消す方法を理解します。
## 利用可能性と前提条件
- **APIキー** は条件付きであり、アカウントで有効になっている場合にのみ表示されます。
- 画面には、**各キーはあなたとして動作します**と表示されます。キーは個人アカウントに属し、特定のストア専用ではありません。
- [ワークスペースの一般設定](/ja/guides/account-and-settings/workspace-general)にある読み取り専用の**分析APIキー**とは異なります。
- 完全なキーをチャット、エージェント メモリ、スキル、スクリーンショット、ソース管理、または製品ドキュメントに入れないでください。
## エントリパス
**設定 → アカウント名 → APIキー**を選択します。項目がない場合、現在のアカウントでは利用できません。
## コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **新しいキーを生成** | 新しい認証情報を作成します。 | ダイアログが開き、オプションの名前フィールドが表示されます。 |
| **名前** | シークレットを公開せずに後でアプリケーションを識別します。 | 名前がキー テーブルに表示されます。空白の場合は無題のキーが作成されます。 |
| **キーを作成** | 認証情報を生成します。 | Runnerが **APIキーが生成されました** を開き、完全なシークレットを1回表示します。 |
| 目のアイコン | 保存する前に、新しく生成された完全な値を確認します。 | ワンタイム値は成功ダイアログで表示またはマスクされます。 |
| コピー アイコン | 新しいキーを正確にコピーします。 | Runnerはそれをクリップボードにコピーし、確認を表示します。 |
| **保存しました** | ワンタイム シークレット ビューを閉じます。 | 完全な値がダイアログから削除され、そこに再度表示することはできません。 |
| 既存キー テーブル | キーを安全に識別します。 | Runnerは名前、プレフィックス、作成日、最後に使用した日を表示し、完全なシークレットは表示しません。 |
| 削除アイコン | 既存のキーを取り消します。 | 確認により、取り消しは元に戻せないことが説明されます。 |
| **取り消す** | 選択したキーを無効にします。 | 成功後、キーはリストから削除され、認証に使用できなくなります。 |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg0z7QP9dmUDVzwn9xNJv4t2isec7IFkOaWAro)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
空の一覧は初期状態です。この例ではシークレットの生成や表示を行っていません。画像は英語の画面です。
## 認証情報を作成する前にダイアログを確認する
1. **新しいキーを生成**を選択します。
2. 任意の**名前**欄を確認します。`Reporting integration` などの名前を付けると、後でアプリケーションを識別できます。
3. 確認だけの場合は**キャンセル**を選択します。**キーを作成**を選択するまでキーは作成されません。
以下の手順は、APIキーを利用でき、新しいシークレットを安全に保存する準備ができた場合に行います。
## キーを生成して保存
1. **アカウント名 → APIキー**を開きます。
2. **新しいキーを生成** を選択します。
3. アプリケーションまたは環境など、説明的な名前を入力します。シークレットを名前に入れないでください。
4. **キーを作成** を選択します。
5. **APIキーが生成されました** で、必要な場合のみキーを公開し、コピーを選択します。
6. 信頼できるシークレット マネージャーに保存します。
7. **保存しました** を選択する前に、保存された値を確認します。
8. テーブル プレフィックスを使用して、完全な値を公開せずに後でキーを識別します。
Runnerは、完全なキーが再度表示されないことを警告します。ダイアログを保存せずに閉じた場合は、そのキーを取り消し、シークレットを回復しようとするのではなく、置き換えを作成してください。
## キーを取り消す
1. 名前とプレフィックスで目的のキーを照合します。
2. その削除アイコンを選択します。
3. **取り消す** 確認を確認します。
4. 依存するアプリケーションが使用を停止する準備ができている場合にのみ、**取り消す** を選択します。
5. **APIキーが取り消されました** を確認し、アプリケーションから古いシークレットを削除します。
取り消しは破壊的であり、元に戻すことはできません。アクセスが再度必要な場合は、新しいキーを作成します。
## 状態と制限
- **APIキーはまだありません** は通常の空の状態です。
- 新しいキーの完全な値は、成功ダイアログにのみ表示されます。
- 既存の行は、回復可能なキーではなく、プレフィックスと使用日を表示します。
- **最終使用日時** の下の **なし** は、Runnerがそのキーのリクエストを記録していないことを意味します。
- 作成ボタンと取り消しボタンは進行状況を表示し、繰り返し送信しないでください。
## トラブルシューティング
- APIキーが見つからない場合は、コピーされた直接リンクを使用しないでください。機能はこのアカウントで無効になっています。
- クリップボード コピーが失敗した場合は、新しい値を公開し、安全なシークレット マネージャーに手動でコピーしてから、再度非表示にします。
- 完全なキーを失った場合は、その行を取り消し、置き換えを生成します。
- 取り消し後にアプリケーションが機能しなくなった場合は、新しく作成されたキーで更新してください。古いキーは復元できません。
- 間違ったキーが選択された場合は、確認をキャンセルし、名前とプレフィックスを再度比較してください。
## 関連ガイド
- [セキュリティとセッション](./security-and-sessions)
- [個人設定とワークスペース](./personal-settings-and-workspaces)
- [メモリ安全性](../agent/memory)
---
# カスタム スクリプトとストア エージェント
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/custom-scripts-and-store-agent
カスタム スクリプトはストアフロント動作を変更し、ストア エージェントは現在のプロジェクトでRunnerが使用できるスキルを変更します。どちらもストア固有の設定であり、特に注意深く確認する必要があります。
## このガイドの内容
スクリプトを追加して保存する方法、削除せずに一時停止する方法、現在のプロジェクトのみのスキルを追加または無効にする方法を理解します。
## 利用可能性と前提条件
- 目的のプロジェクト内から設定を開きます。
- カスタム JavaScriptはストアフロント動作を変更できます。理解して信頼できるコードのみを追加してください。
- スキル アクションは、利用可能なワークスペース スキルと、システム スキルが構成可能かどうかに依存します。
- 完全なエージェント ページとプラン ゲートは、より広いスキル利用可能性を制御します。
## エントリパス
- スクリプト: **設定 → ストア: _ストア名_ → カスタムスクリプト**
- プロジェクトのスキル: **設定 → ストア: _ストア名_ → エージェント**
## カスタム スクリプト コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **スクリプトを追加** | ストアフロント スクリプト エントリを作成します。 | 新しい有効なスクリプト行が空のJavaScript コードで開きます。 |
| スクリプト行 | エディターを展開または折りたたみます。 | **スクリプト名** と **JavaScriptコード** が表示されます。 |
| 目のアイコン / 非表示目のアイコン | 1つのスクリプトを有効または無効にします。 | ローカル行が状態を変更します。変更を保存を選択して適用します。 |
| 削除アイコン | スクリプトを保留中リストから削除します。 | 行は2番目のダイアログなしで消えます。変更を保存が削除を適用します。 |
| **変更を保存** | すべての保留中のスクリプト編集を適用します。 | Runnerはスクリプト リスト全体を保存し、成功またはエラー メッセージを表示します。 |
Runnerは最大10個のスクリプト エントリを許可します。何も変更されていない場合、変更を保存ボタンは無効のままです。
空のエディターで、導入前に入力欄を確認できます。この例では追跡スクリプトを保存していません。画像は英語の画面です。
## スクリプトを追加または変更
1. **ストア → カスタム スクリプト** を開きます。
2. **スクリプトを追加** を選択します。
3. 明確な **スクリプト名** と信頼できる **JavaScriptコード** を入力します。
4. スクリプトがストアフロントで実行される場合のみ、有効なままにします。
5. **変更を保存** が全リストを適用するため、他のすべての行を確認します。
6. **変更を保存** を選択し、**保存されました** を待ちます。
7. 保存後、ストアフロントを安全に確認します。
Runnerは1つのスクリプト エラーがページをクラッシュさせるのを防止しようとしますが、それは未知のコードを安全にしません。スクリプトはプライバシー、パフォーマンス、トラッキング、カスタマー エクスペリエンスに影響を与える可能性があります。
### まずスクリプトの下書きを確認する
**スクリプトを追加**を選択し、名前を `Store analytics` にして、目のアイコンをオフにします。コードは空のままにし、**変更を保存**は選択しません。信頼できる提供元のコードを追加する前に、エディターと無効状態を確認できます。実際に保存した後は、一覧を開き直してコードと有効状態の両方を確認してください。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
プロジェクトのスキルには、ストア見出し下の**エージェント**を選択します。画像は英語の入口画面であり、スキルの追加や無効化を示していません。
## ストア エージェント コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| アクティブ スキル行 | このプロジェクトで利用可能なスキルを確認します。 | 行は名前、説明、システムまたはカスタム タイプを表示します。 |
| **無効にする** | 構成可能なスキルをこのプロジェクトのみから削除します。 | スキルはこのプロジェクトのアクティブ リストから削除されます。グローバルに削除されません。 |
| **スキルを追加** | 利用可能なワークスペース スキルをこのプロジェクトに追加します。 | リストされたスキルを選択するか、**カスタム スキルを作成…** を選択して、現在のプロジェクトで有効にします。 |
| **カスタム スキルを作成…** | 新しいカスタム機能を作成します。 | スキル エディターが開き、成功後にプロジェクト リストが更新されます。 |
## プロジェクト スキルを構成
1. **ストア → エージェント** を開きます。
2. 現在アクティブなスキルを確認します。
3. **スキルを追加** を選択してから、利用可能なスキルを選択するか、**カスタム スキルを作成…** を選択します。
4. 成功メッセージを待ち、スキルが表示されることを確認します。
5. 構成可能なスキルがこのプロジェクトに適用されなくなった場合は、**無効にする** を使用します。
6. プロジェクトのナビゲーションで**エージェント**を開くと、スキルの詳細、一時停止、編集、インポート、削除を操作できます。
## 状態と制限
- スクリプト変更は **変更を保存** が成功するまでローカルのままです。
- スクリプト行を削除する場合、変更を保存する前に個別の確認はありません。
- 10個のスクリプトに達すると、**スクリプトを追加** が無効になります。
- ストア エージェントは読み込み、エラー、**スキルが有効になっていません**、またはアクティブ リストを表示できます。
- 固定システム スキルは **無効にする** を表示しません。
- ストア エージェントで無効にすると、このプロジェクトのスコープが変更されます。スキルは削除またはグローバルに一時停止されません。
## トラブルシューティング
- スクリプトがまだ実行されている場合は、その無効な状態の後に **変更を保存** が続いたことを確認します。
- 保存が失敗した場合、以前に保存されたリストは変更されません。コードを修正するか、エラー後に再試行してください。
- **スキルを追加** に予期されたエントリがない場合は、完全なエージェント ページと現在のプランを確認してください。
- **無効にする** がない場合、システム スキルはこのプロジェクトで構成可能ではありません。
- 新しいスキルがグローバルに表示されるがここに表示されない場合は、ストア エージェントからプロジェクトに追加してください。
## 関連ガイド
- [ストア一般](./store-general)
- [エージェント スキル](../agent/skills)
- [スキルを作成、インポート、管理](../agent/create-import-manage-skills)
- [APIキー安全性](./api-keys)
---
# 削除、復旧、および退出
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/delete-recover-and-leave
Runnerは、ストアの削除、ワークスペースの削除、ワークスペースからの退出、アカウント削除のために異なる確認フローを使用します。破壊的なアクションの前に、正確なスコープを確認してください。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
削除操作を開く前に、**Settings** で対象がワークスペースかストアかを確認してください。この画像はナビゲーションのみを示しており、削除や復元は実行していません。
画像の注釈は英語です。画像を選択すると拡大できます。
## このガイドの内容
各アクションが何を削除するか、どのような確認が必要か、条件付きストア復旧がいつ表示される可能性があるかを理解します。
## 利用可能性と前提条件
- 変更しているアイテムの権限が必要です。
- 最後のワークスペースは削除できません。
- ストアの復元は、従来の画面で条件付きで利用できます。**最近削除した項目**が表示され、対象ストアが一覧にある場合のみ使用してください。現在のストアナビゲーションでの提供は保証されません。
- 削除を承認する際に、条件付き復旧を保証として扱わないでください。
- 現在のグローバル アバターと設定メニューは、保護されたアカウント セキュリティ ページを公開しません。Runnerまたはrunner サポートが承認されたエントリを提供する場合にのみ、アカウント削除を使用してください。
## エントリパスとアクション マップ
| アクションとエントリパス | 確認 | 成功後に何が起こるか |
| --- | --- | --- |
| 設定 → ストア: _ストア名_ → **一般 → 削除** | 正確なストア名を入力して**削除**を選択します。 | ストアが削除されます。現在のストアを削除した場合は、別の利用可能なストアか新規作成画面が開きます。 |
| 条件付き複数選択 → **選択したものを削除** | `DELETE` を入力してから、**すべて削除** を選択します。 | 操作が成功した後、選択されたストアはアクティブ グリッドから削除されます。 |
| 条件付きの従来のストア一覧 → **最近削除した項目 → プロジェクトを復元** | 破壊的な確認操作はありません。プロジェクトを復元を選択します。 | ストアが有効なプロジェクト一覧に戻り、ワークスペースのリソースが再び準備されます。 |
| 設定 → ワークスペース → 一般 → **ワークスペースを削除** | オーナーがワークスペース名を正確に入力してから、**削除** を選択します。 | Runnerはワークスペースを削除し、別の利用可能なワークスペースに切り替えます。 |
| 設定 → ワークスペース → メンバー → あなたの行 → **退出** | 名前付きワークスペース ダイアログを確認してから、**退出** を選択します。 | プロジェクトへのアクセスが失われ、Runnerは別の利用可能なワークスペースまたはチューザーにリダイレクトされます。 |
| アカウント削除 → support@adaptivemachines.ai にメール | Runnerアカウントのメールアドレスからリクエストを送信します。 | Runnerサポートが次の手順を返信します。 |
## 1つのストアを削除
1. 対象ストアで**設定 → ストア: _ストア名_ → 一般**を開き、ワークスペース名とストア名を確認します。
2. **削除** を選択します。
3. ストア データに関する警告を読みます。
4. ストア名を正確に入力します。
5. 破壊的な **削除** ボタンを選択します。
6. 削除結果を待ちます。別のストアか新規作成画面が開いたことを確認し、削除したストアが利用できなくなったことを確認します。
確認では、アクションを元に戻すことができないことを警告します。一部のアカウントは個別の復旧機能を表示しますが、存在しないか利用できない可能性があります。復旧が表示されると仮定して削除しないでください。
## 利用可能な場合に従来の画面からストアを復元する
1. ワークスペースに従来のストア一覧と**最近削除した項目**が表示される場合のみ進みます。
2. **最近削除した項目**を開きます。現在のストアナビゲーションで探したり、直接リンクを推測したりしないでください。
3. 名前と削除日でストアを照合します。
4. **プロジェクトを復旧** を1回選択します。
5. **プロジェクトが復旧されました** を待ち、ストアがアクティブ リストに戻ることを確認します。
6. 必要なワークスペース リソースが利用可能になった後にのみ開きます。
**最近削除した項目**がない場合、その画面には復元機能がありません。必要に応じてサポートに連絡してください。このガイドは復元の提供や可能期間を保証するものではありません。
## ワークスペースを削除
1. ワークスペース オーナーとして、正確なワークスペースの **設定 → ワークスペース → 一般** を開きます。
2. **ワークスペースを削除** を選択します。
3. 永続的な削除警告を読みます。
4. ワークスペース名を正確に入力します。
5. **削除** を選択します。
6. Runnerが別のワークスペースに切り替わることを確認します。
これは唯一のワークスペースのため削除できません。最初からやり直したい場合は、先に別のワークスペースを作成してください。ワークスペースの削除は永続的で復旧不可能として提示されます。
## ワークスペースから退出
1. **設定 → ワークスペース → メンバー** を開きます。
2. **（あなた）** とマークされたあなたの行を見つけます。
3. 利用可能な場合は **退出** を選択します。
4. ワークスペース名を確認し、ダイアログで **退出** を選択します。
5. リダイレクトされ、プロジェクト アクセスがなくなったことを確認します。
退出はワークスペースを残りのメンバーのために削除しません。オーナー行はメンバー ページでこの退出アクションを提供しません。
## アカウント削除をリクエスト
1. Runnerアカウントのメールアドレスから support@adaptivemachines.ai にメールします。
2. アカウントの削除を依頼します。
3. Runnerサポートからの返信の指示に従います。
このリクエストは、1つのストアまたはワークスペースを削除するより広いです。続行する前に [セキュリティとセッション](./security-and-sessions) を確認してください。
## トラブルシューティング
- 無効な最終ボタンは、確認テキストが正確に一致しないか、アクションがまだ実行中であることを意味します。
- 削除エラーが出ても、何も変わっていないとは限りません。一覧を更新し、対象を確認してから再試行してください。
- **復旧しています…** は、現在のリクエストが完了するまで他の復旧ボタンをロックします。
- 復元エラーの場合は、有効な一覧と最近削除した一覧を確認してから再試行してください。
- 退出エラーの場合は、現在のアクセス権とワークスペースを確認してから再試行してください。
- アカウント削除について返信がない場合も、リクエストを何度も送らないでください。代わりに、同じメールのスレッドで返信してください。
## 関連ガイド
- [ストア一般](./store-general)
- [ワークスペース一般](./workspace-general)
- [メンバーと招待](../workspace/members-and-invitations)
- [セキュリティとセッション](./security-and-sessions)
---
# 個人設定とワークスペース
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/personal-settings-and-workspaces
個人設定は、プロジェクト共通のRunner設定を変更します。別のチームで作業するには、ワークスペース切り替えを使用してください。
## このガイドの内容
ワークスペース設定を変更せずに、画面の言語、週次パフォーマンスメール、操作音を選択します。
## 利用可能性と前提条件
- サインインしている必要があります。
- 確認した**マイ設定**画面には、言語、週次パフォーマンスメール、操作音があります。プロフィールの操作はアカウントや画面によって異なります。
- ワークスペースの作成とメンバーシップアクションは、アカウント権限または現在のワークスペース状態によって制限される場合があります。
## エントリパス
- 個人の設定: **設定 → アカウント名 → マイ設定**
- ワークスペースの切り替え: [ワークスペースのナビゲーション](/ja/guides/workspace)を参照してください。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgBH6DLmxmaXn1xqodiYlA9g46Lh3VyHFBkOze)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
画面の設定には**マイ設定**を選択します。**APIキー**は、個人の認証情報を管理する別のページを開きます。画像は英語の画面です。
## マイ設定コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **言語** | Runnerのインターフェース言語を変更します。 | Runnerは選択を保存し、現在のページをそのロケールで再読み込みします。 |
| **週間パフォーマンスメール** | ストアのパフォーマンスレポートを週に1回メールで受け取ります。 | スイッチでRunnerがレポートを送信するかどうかを保存します。初期設定では有効です。 |
| **インターフェースサウンド** | タップ、切り替え、通知の際に小さなクリック音を鳴らします。 | スイッチで設定を保存します。無音にするにはオフにします。 |
## 言語またはレポートメールを変更する
1. アカウント名の下にある**マイ設定**を開きます。
2. ページを再読み込みしてよいタイミングで**言語**を選択します。
3. 再読み込み後、選んだ言語が画面に使われていることを確認します。
4. ストアレポートの配信を変更する場合のみ、**週間パフォーマンスメール**を変更します。
5. 保存を待ち、ページを開き直して確認します。
## プロフィールを変えずに設定を確認する
1. **マイ設定**を開き、**インターフェース音**を探します。
2. クリックや通知で音を鳴らすかを選択します。
3. 保存を待ち、**マイ設定**を閉じて開き直します。
4. スイッチが選択した状態のままであることを確認します。
ワークスペースの切り替えや作成には、[ワークスペースガイド](/ja/guides/workspace)を使用します。現在の設定サイドバーには公開の**ワークスペース**ページはありません。退出するには、[メンバーと招待](/ja/guides/workspace/members-and-invitations)を参照してください。
## 状態と制限
- 言語の更新は、永続化とナビゲーションが完了するまでコントロールをビジー状態に保ちます。
- マイ設定には、セッション、アカウント削除、APIキーの操作はありません。[セキュリティとセッション](./security-and-sessions)と[APIキー](./api-keys)を参照してください。
## トラブルシューティング
- 言語が変わらない場合は、現在の更新が完了するまで待ってから、もう一度選択します。
- 別のワークスペースの設定を開いた場合は、ダイアログを閉じ、ワークスペースを切り替えてから設定を開き直します。
- 退出する必要がある場合は、そのワークスペースのメンバーページを開き、ここで退出を探さないでください。
## 関連ガイド
- [メンバーと招待](../workspace/members-and-invitations)
- [ワークスペース一般](./workspace-general)
- [セキュリティとセッション](./security-and-sessions)
- [削除、復旧、退出](./delete-recover-and-leave)
---
# セキュリティとセッション
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/security-and-sessions
Runnerには、セッションを一覧表示したりアカウントを削除したりするアプリ内ページはありません。ログアウトはアバターメニューから行います。ほかのデバイスのセッション終了とアカウント削除のリクエストには、Runnerサポートが対応します。
## このガイドの内容
使用中のデバイスでログアウトする方法と、ほかのセッションの終了やアカウント削除をRunnerサポートに依頼する方法がわかります。
## 利用可能性と前提条件
- ログアウトするには、サインインしている必要があります。
- サポートへのリクエストは、Runnerアカウントのメールアドレスから送信してください。サポートはこれで、アカウントがあなたのものであることを確認できます。
- アカウント削除は取り消せません。アカウントに属するすべてのデータが削除されます。
## このデバイスでログアウトする
1. 上部ナビゲーションでアバターを選択します。
2. **ログアウト**を選択します。
3. Runnerにサインアウト後のホームページが表示されることを確認します。
## ほかのデバイスのセッションを終了する
1. まだアクセスできる各デバイスでログアウトします。
2. デバイスにアクセスできない場合や、見覚えのないサインインがある場合は、support@adaptivemachines.ai にメールしてください。
3. 対象のアカウントと、確認した内容を伝えてください。
## アカウント削除をリクエストする
1. Runnerアカウントのメールアドレスから support@adaptivemachines.ai にメールします。
2. アカウントの削除を依頼します。
3. Runnerサポートからの返信の指示に従います。
ストアやワークスペースを削除しても、アカウントは削除されません。これらの操作については、[削除、復旧、退出](./delete-recover-and-leave)を参照してください。
## トラブルシューティング
- **ログアウト**の後もサインイン中と表示される場合は、ページを再読み込みしてください。
- サポートがリクエストをアカウントと照合できない場合は、サインインに使うメールアドレスから再送してください。
## 関連ガイド
- [APIキー](./api-keys)
- [個人設定とワークスペース](./personal-settings-and-workspaces)
- [削除、復旧、退出](./delete-recover-and-leave)
---
# ストア一般
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/store-general
ストア一般は、ワークスペース全体ではなく、現在のストアフロントを制御します。ストアの名前を変更し、ブラウザと検索の外観を更新し、その削除境界を確認するために使用します。
## このガイドの内容
ストアアイデンティティフィールドを更新し、ファビコンを保存し、プランゲートウォーターマークコントロールを理解し、間違ったストアを削除することを避けることができるようになります。
## 利用可能性と前提条件
- 目的のプロジェクト内から設定を開きます。そうしないと、ストアグループは表示されません。
- 検索フィールドには、ストアバックエンド設定の読み込みが必要です。
- Runnerウォーターマークを削除するには、そのコントロールの横に表示されているプランが必要です。
- ストア削除は破壊的で、正確なストア名が必要です。
## エントリパス
対象のプロジェクトで、**設定 → ストア: _ストア名_ → 一般**を選択します。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgmQFsXqauBTaAcSgDVk9xvzqRJFb723NYlMZE)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
ワークスペースではなく、ストアの見出し下の**一般**を選択します。英語のナビゲーション画像であり、項目の編集や保存は示していません。
## コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| 関連ワークスペース、作成者、作成時刻 | 表示しているストアと所有権コンテキストを確認します。 | これらの詳細は読み取り専用です。 |
| **名前** | Runner内でストアの名前を変更します。 | 有効な変更は自動的に保存されます。 |
| **ページタイトル** | ブラウザタブと検索結果に表示されるタイトルを設定します。 | 有効な変更は自動的に保存され、プレビューが更新されます。 |
| **説明** | ストアの短い検索説明を設定します。 | 有効な変更は自動的に保存されます。 |
| ファビコンボタン | ブラウザタブアイコンを変更します。 | **アップロード**と**AI生成**の選択肢を含むポップオーバーが開きます。 |
| **画像をアップロード** | 独自のファビコンファイルを使用します。 | Runnerはファイルを検証し、**保存**する前にプレビューを表示します。 |
| **実行** | プロンプトからファビコンを生成します。 | Runnerは生成されたプレビューを表示します。**保存**するまで適用されません。 |
| ウォーターマークを削除スイッチ | Runnerストアフロントウォーターマークを制御します。 | 変更はコントロールの横に表示されているプランでのみ利用可能です。 |
| **ショッパーチャット** | ストアフロントで買い物客がすぐに回答を得られるようにします。 | スイッチでストア設定を保存し、開いているプレビューを更新します。初期設定では有効です。 |
| **削除** | 現在のストアを削除します。 | **ストアを削除**が開き、正確なストア名が必要です。 |
## ストアアイデンティティを更新する
1. **ストア → 一般**を開き、関連ワークスペースとストア名を確認します。
2. **名前**、**ページタイトル**、または**説明**を編集します。
3. 各自動保存フィールドの後、**保存済み**を待ちます。
4. ファビコンセクションの横にあるブラウザスタイルのプレビューを確認します。
ページタイトルと説明は、フィールドに表示されている現在の文字制限を適用します。フィールドがテキストを受け入れなくなった場合は、制限の周りに貼り付けるのではなく、短縮してください。
### 例: ストア名と検索タイトルを分ける
キャンドル店なら、Runnerの**名前**は `Candle Studio`、**ページタイトル**は `Candle Studio | Hand-poured candles` にできます。実際に販売する商品の短い**説明**を書きます。**保存済み**が表示されたら一般設定を開き直し、値を確認します。検索エンジンへの反映には時間がかかり、別の文章が検索結果に使われる場合もあります。
## ファビコンを変更する
1. 現在のファビコンボタンを選択します。
2. **アップロード**または**AI生成**を選択します。
3. アップロードの場合は、表示されたファイルサイズ制限の下にあるICO、PNG、またはSVGファイルを選択します。
4. AI生成の場合は、オプションのプロンプトを入力して**実行**を選択します。
5. プレビューを確認します。
6. **保存**を選択して適用します。ポップオーバーを閉じると、保存されていないプレビューが破棄されます。
## 状態と制限
- 自動保存フィールドは、保存、成功、またはエラーフィードバックを表示します。
- ファビコンアップロードはサポートされていない形式と大きすぎるファイルを拒否します。
- 生成中…とアップロード中…は進行状態です。プレビューを待ちます。
- ウォーターマーク制御はプランバッジを表示し、変更をブロックできます。
- ストア削除は、プロジェクトとその名前が読み込まれるまで利用できません。
## 危険ゾーン
**削除**を選択すると、すべてのストアデータが失われることを警告する確認が開きます。 最終ボタンは、正確なストア名を入力するまで無効のままです。 一部のアカウントは条件付き復旧を個別に公開していますが、削除を決定するときに復旧に依存してはいけません。
## トラブルシューティング
- ストアグループが不在の場合は、プロジェクト内から設定を再度開きます。
- タイトルまたは説明が戻った場合は、その検証の問題を修正して保存済みを待ちます。
- ファビコンアップロードが失敗した場合は、タイプとサイズを確認してから、ファイルを再度選択します。
- 生成されたファビコン作成が失敗した場合は、プロンプトを修正し、前の試行が終了した後のみ再試行します。
- ウォーターマークを削除がブロックされている場合は、プランバッジを使用して利用可能性を確認します。
## 関連ガイド
- [カスタムドメインを接続する](../storefront-and-publishing/custom-domains)
- [カスタムスクリプトとストアエージェント](./custom-scripts-and-store-agent)
- [削除、復旧、退出](./delete-recover-and-leave)
---
# ワークスペース一般
Source: https://www.runnerai.com/docs/ja/guides/account-and-settings/workspace-general
ワークスペース一般はRunnerワークスペースの共有アイデンティティを制御します。チーム名または説明が変更されたとき、またはワークスペース危険ゾーンを確認する必要があるときに使用します。
## このガイドの内容
ワークスペースの詳細を更新でき、変更が正常に保存されたことを認識できるようになります。
## 利用可能性と前提条件
- 共有名または説明を変更するには、ワークスペース管理者または所有者が必要です。
- ワークスペース削除を完了できるのはワークスペース所有者のみです。
- Runnerは、最後に残ったワークスペースの削除を許可しません。
## エントリパス
**設定**を開き、サイドバーの**ワークスペース: _ワークスペース名_**を確認して、そのグループの**一般**を選択します。
## コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **名前** | 他のメンバーに表示される完全なワークスペース名を設定します。 | 有効な変更は編集後に自動的に保存されます。 |
| **説明** | ワークスペースまたはチームの目的を説明します。 | 有効な変更は自動的に保存されます。 |
| **ワークスペースを削除** | 不要になったワークスペースを削除します。 | 名前確認ポップオーバーが開きます。ボタンは最後のワークスペースに対して無効になります。 |
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgTBoRI6D7lIPXqUA4xQWKLGpygc8jMtzfNJri)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
この例には分析キーがありません。ワークスペース情報の変更と分析用認証情報の作成は別の操作です。画像は英語の画面です。
## ワークスペースの詳細を更新する
1. **設定 → ワークスペース → 一般**を開きます。
2. **名前**または**説明**を編集します。
3. フィールドを離れてステータスを確認します。
4. 設定を閉じるか、ワークスペースを切り替える前に**保存済み**を待ちます。
5. 永続化された値を確認する必要がある場合は、ページを再度開きます。
**確認:** 設定を閉じ、同じワークスペースの一般設定を開き直して、名前または説明の保存を確認します。保存中…の表示中は確認完了ではありません。
## 状態と制限
- 名前は空にすることはできず、表示された検証制限内に留まる必要があります。
- 説明はワークスペースの短い概要を受け入れ、表示された文字制限があります。
- 保存中…は変更がまだ進行中であることを意味します。
- **保存済み**は現在の値が受け入れられたことを確認します。
- 保存エラーは前の保存された値を復元または保持します。
- **ワークスペースを削除**は、これが最後のワークスペースの場合、無効になります。
## 分析APIキーは対象範囲が異なります
ワークスペースの一般設定には、外部レポートツール向けの読み取り専用**分析APIキー**が表示される場合があります。ログイン中のアカウントとして動作する[個人用APIキー](/ja/guides/account-and-settings/api-keys)とは異なります。作成や共有の前に対象範囲を確認してください。分析キー一覧が空でも、個人用キーの一覧が空という意味ではありません。
## 削除境界
**ワークスペースを削除**を選択しても、すぐには削除されません。Runnerは所有者に正確なワークスペース名を入力するよう求め、破壊的な**削除**ボタンを有効にします。削除はこのスクリーンから復元できず、ワークスペースのデータと設定を削除します。
## トラブルシューティング
- 空の名前が以前の値に戻った場合は、有効な空でない名前を入力します。
- **保存済み**が表示されない場合は、ダイアログを開いたままにして、エラーを確認して再試行します。
- ワークスペースを削除が無効になっている場合は、これが最後のワークスペースであるか、ワークスペースが読み込まれていない可能性があります。
- 間違ったワークスペースの設定を開いた場合は、ダイアログを閉じて、目的のワークスペースから再度開きます。
## 関連ガイド
- [メンバーと招待](../workspace/members-and-invitations)
- [個人設定とワークスペース](./personal-settings-and-workspaces)
- [削除、復旧、退出](./delete-recover-and-leave)
---
# 高度な機能
Source: https://www.runnerai.com/docs/ja/guides/advanced
Runnerには、顧客を調査し、作業を計画し、再利用可能なワークフローを構築し、イベントを受け取るための高度な方法が含まれています。これらのページは、利用可能性とエントリポイントがワークスペースによって異なる可能性があるため、コアストアジャーニーから意図的に分離されています。
> **利用可能性:** **リサーチ**は**計測**、**Fly**はメインナビゲーション、**Webhook**は**構築**に表示される場合があります。**ワークフロー**は条件付きです。ワークスペースに入口が表示されるか、サポートから提供された場合のみ使用します。非表示のページに進むためにURLを推測・編集しないでください。項目がない場合は[機能の利用可能性](/ja/guides/advanced/feature-availability)を参照してください。
| 機能 | 用途 | ガイド |
| --- | --- | --- |
| リサーチ | ビジネスの質問を構造化された研究とレポートに変えます。 | [リサーチ](/ja/guides/advanced/research) |
| Fly | ミッションを設定し、ガイド付きビジネス計画ワークスペースに従います。 | [Fly](/ja/guides/advanced/fly) |
| ワークフロー | Runnerがエントリを提供する場合、再利用可能なマルチステップフローを表示して実行します。 | [ワークフロー](/ja/guides/advanced/workflows) |
| Webhook | Runnerがエントリを提供する場合、サポートされているイベント配信を構成します。 | [Webhook](/ja/guides/advanced/webhooks) |
**成長**と**計測**のツールについては、[自動化、テスト、作成](/ja/guides/automate-test-and-create)を参照してください。
---
# 機能の利用可能性
Source: https://www.runnerai.com/docs/ja/guides/advanced/feature-availability
Runnerはワークスペース、ロール、プラン、ストアタイプ、公開状態、接続されたサービス、データ、段階的リリースアクセスに応じて異なる機能を表示できます。
**エントリパス:** Runner ドキュメント → **高度な機能** → **機能の利用可能性**。
## 一般的な利用可能性ゲート
| 表示内容 | 考えられる要件 | 対応方法 |
| --- | --- | --- |
| エントリが見つからない | 機能がステージング中、無効化、またはこのワークスペースで利用不可です。 | ワークスペースを確認し、オーナーまたはサポートに問い合わせてください。推測したURLを使用しないでください。 |
| アップグレードメッセージ | 現在のプランにはこのアクションが含まれていないか、制限に達しています。 | **プラン & 請求**を開き、現在の画面上のオファーを確認してください。 |
| 公開要件 | ツールはライブストアまたは公開されたサイトデータが必要です。 | 公開チェックリストを完了し、公開成功後に戻ってください。 |
| 接続ボタン | プロバイダーまたはアカウントを最初に接続する必要があります。 | 指定されたアプリを開き、公式の接続フローを完了してください。 |
| 空のダッシュボード | 機能は利用可能ですが、選択されたストア、フィルター、または期間のデータがありません。 | ストア、日付範囲、公開、およびイベント収集を確認してください。 |
| 権限メッセージ | ワークスペースロールはこのアクションを実行できません。 | オーナーに完了してもらうか、アクセスを変更してください。 |
| ページが見つかりません | ルートは利用不可、廃止、またはこのコンテキストで無効です。 | 表示されているナビゲーションを通じて戻り、エントリ自体が壊れている場合はサポートに連絡してください。 |
## 順序を確認
1. 選択されたワークスペースとストアを確認します。
2. 項目がないと判断する前に、プロジェクトの**構築**、**成長**、**計測**を展開します。モバイルでは先にプロジェクトメニューを開きます。
3. ページが前提条件を指定しているかどうかを確認します。
4. ワークスペース設定からロールと現在のプランを確認します。
5. 必要な公開、データ、またはアプリ接続を確認します。
6. 最近のアクセスまたは接続変更後に1回リロードします。
7. 正確なページ、表示状態、ワークスペース、およびストア名を含めてサポートに連絡してください。 ### 想定しないこと
- 非表示のエントリは、すべてのアカウントから機能が削除されたことを証明しません。
- 空のページは、収集が壊れていることを証明しません。
- ソースルートは、ワークスペースが機能を使用できることを証明しません。
- 接続成功は、エンドツーエンドの結果なしに、ダウンストリームのチェックアウト、フルフィルメント、またはレポートを証明しません。
## ページがプレビューだけの場合
アップグレードの案内で実際の操作が制限されていても、機能プレビューにサンプルカードが表示される場合があります。ストアの実データと解釈する前に案内を読んでください。状態の一覧は[状態と利用可能性](../help-and-reference/states-and-availability)を参照してください。
## 関連ガイド
- [状態と利用可能性](../help-and-reference/states-and-availability)
- [サブスクリプションプラン](../plans-and-billing/subscription-plans)
- [公開、チェックアウト、アプリのトラブルシューティング](../help-and-reference/troubleshoot-publishing-checkout-apps)
- [サポートとコミュニティ](../help-and-reference/support-and-community)
---
# Fly
Source: https://www.runnerai.com/docs/ja/guides/advanced/fly
Flyは、ストア目標をミッションに変え、提案された作業を確認し、1つのダッシュボードから進捗を追跡するためのガイド付きワークスペースです。
## エントリパス
ストアプロジェクトを開き、利用可能な場合は**Fly**を選択します。エントリが見つからない場合は、[機能の可用性](./feature-availability)を参照してください。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgOvxtCXuJCcW62zHrU8smjSnqvixd1twlAf4u)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
開始する前に、最初のミッションとその段階を確認します。これは設定画面であり、実行中のミッションではありません。画像は英語の画面です。
## 開始する前に
- Flyは現在のプロジェクトで有効にする必要があります。
- 作業を承認する前に、ストア、ミッション、および影響を受ける提案タスクを確認してください。
- 提案、中止、および次のミッションアクションは実際のプロジェクト作業を変更できます。確認テキストを最終的な権限として使用してください。
## 最初のミッションを開始する
ミッションのないプロジェクトは自動的にオンボーディングを開きます。
1. **Fly**を開き、提案されたストアの目標を読みます。
2. ダッシュボードに既存のミッションがある場合は、新規作成せず、その内容を確認します。
3. 提案と各段階を確認します。**最初の有料注文を獲得**の案内には5段階と**このミッションを開始**が表示されます。開始する場合のみ選択し、それ以外は案内を閉じます。
4. 提案を確認する前に、意図したミッションがダッシュボードに表示されていることを確認します。
**確認:** 案内を開いただけではミッションの提案が表示されるだけです。確定し、ダッシュボードに表示された時点でミッションが存在します。
| コントロール | 選択後に起こること |
| --- | --- |
| **最初のミッションを開始** | プロジェクトにまだミッションがない場合、オンボーディングを再度開きます。 |
| **このミッションを開始** | 案内のミッションを開始します。確定前に目標と段階を確認します。 |
| ミッション設定に表示される**このミッションを設定** | 現在のプロジェクトに提案されたミッションを作成し、Flyダッシュボードを開きます。確定前にストアと目標を確認します。 |
確定せずに案内を閉じると、新しいミッションは作成されません。**最初のミッションを開始**から戻れます。
オンボーディング後、**最初の提案を取得**は読み取り専用のローンチチェックリストを開くことができます。**ストアフロントを構築**に**詳細を表示**が表示される場合、プロジェクトの最初のRunner会話を開きます。最初の会話が記録されていない場合、ボタンは表示されません。
## ダッシュボードを読む
ダッシュボードは、現在のミッションとストアアクティビティを一緒にもたらします。小さい画面では、同じセクションが垂直に積み重ねられます。
| セクション | 表示内容 |
| --- | --- |
| ミッション進捗 | アクティブな目標とそれに向けた進捗。 |
| 注文、収益、セッション | 本日のストア信号の見出し。これらは読み取り専用の概要です。 |
| **フィード** | 最近の信号とFlyの現在の観察。ストーリーを選択してビューアを開きます。 |
| **進行中の作業** | 実行中または対応待ちの承認済み提案。カードを選択して提案の詳細を開きます。 |
| **過去の作業** | 完了または失敗した提案。カードを選択して確認します。**さらに表示**で古いエントリを読み込みます。 |
| **やることリスト** | 注意が必要なタスク。**前へ**と**次へ**で複数ページのアイテムを移動します。 |
| ストアプレビュー | 利用可能な場合、現在の公開状態を表示します。選択して**ストア**を開きます。 |
| **チャットを開く** | Flyチャットを開いて、ミッションまたは表示されている作業について質問できます。**チャットを閉じる**で閉じます。 |
| **すべて確認済み** | やることリストまたは提案に決定が必要な場合に表示されます。Flyがストアを監視し続けていることを確認します。実行中のすべてのタスクが完了していることを意味しません。 |
| **Runnerを探索** | キューがクリアされている場合、有効な場合は**Creative Studioを開く**、**スキルを参照**、および**オートメーションを探索**を提供します。各ボタンはそのプロジェクトツールを開き、それ自体で作業を開始しません。 |
空の**進行中の作業**または**過去の作業**セクションは非表示になる場合があります。これは、その状態に何もないことを意味し、プロジェクト履歴が削除されたことではありません。
Flyチャットでは、**新しい会話**は新しいスレッドを開始し、履歴は以前のものを再度開きます。最初のメッセージが会話を作成します。送信に失敗した場合、ドラフトはコンポーザーに残り、書き直さずに再試行できます。
### Flyストーリーを読む
ストーリービューアはヘッダーに**合計のうち現在のアイテム**を表示します。前後の矢印を使用してアイテム間を移動するか、ビューアを閉じてダッシュボードに戻ります。ストーリーにリンクされたソースチップが含まれている場合、それを選択すると、その正確なソースが新しいブラウザタブで開きます。ストーリーが読み込めない場合は、Flyを離れずに**再試行**を選択します。マーケットニュースカードは、最新でなくなった後に消える場合があります。
## 提案を確認する
作業を開始する前に、ダッシュボードから提案を開きます。提案には複数のタスクが含まれる場合があります。タスクを選択すると、それが依存する前提条件も含まれる場合があります。
| コントロールまたは状態 | 次に起こること |
| --- | --- |
| タスク選択 | 承認するタスクを選択します。必要な前提条件タスクが含まれるため、選択された作業は順序で実行できます。 |
| **承認して実行** | 選択されたタスクを承認し、実行を開始します。タスクが選択されていない場合は利用できません。接続されたアクションは実際の効果を持つことができます。 |
| **却下** | 確認を開きます。確認すると提案が閉じられ、タスクは実行されません。これは取り消せません。 |
| **中止** | 作業が実行中にこの提案を中止しますか?を開きます。**中止を確認**は未完了のタスクを停止します。完了した作業は保持されます。**実行を続ける**で確認を閉じます。 |
| **プレビュー** | プレビューが利用可能な場合、完了したワークフロー結果を開きます。 |
| **詳細を表示** | サポートされている最初の提案タスクで、関連するRunner会話を開いて、作業コンテキストを確認できます。 |
| 対応待ち | 要求された手動アクションを完了して**解決**を選択するまで、実行は一時停止されます。 |
| **役に立った** / **役に立たなかった** | **役に立った**はすぐに保存されます。**役に立たなかった**は編集可能な理由と詳細を開きます。閉じた場合は既存のフィードバックが保持され、変更は**送信**後にのみ保存されます。 |
いくつかのレビュー段階の提案ページは、提案チャットパネルも表示します。それを使用してその提案について質問します。**承認して実行**、**却下**、**中止**、または**解決**を置き換えません。
**結果**セクションは、提案がレビュー中、実行中、または検証中は非表示のままです。結果データが準備できた場合にのみ、完了または失敗後に表示されます。アクティブな作業中に結果セクションが見つからないことは、提案が失敗したことの証拠ではありません。
ドキュメントとメディアの結果では、**ダウンロード**で利用可能な成果物を保存し、**メディアを復元**で利用できないメディアの取得を再試行し、**チャットで続ける**で編集可能なフォローアップ指示を開きます。これらの操作は提案の承認またはレビューステータスを変更しません。
提案にFly動画生成が含まれている場合、現在のタスクは1つの6秒720p動画とオーディオを生成します。タスクプロンプトで別の期間を要求しても、その出力長は変わりません。
## ユーザー所有のタスクを解決する
**あなたのタスク**とマークされたタスクが、あなただけが完了できるアクションで一時停止されている場合、その指示を読み、カード外でアクションを完了してから、**解決**を選択します。
**解決**は、要求されたアクションを完了したことの確認です。Runnerはその外部結果を独立して検証しません。Runnerが状態をチェックしている間、カードは**タスクアクションを読み込み中**を表示します。送信中は、ボタンは解決中…を表示します。このタスクはもう対応を待っていません。は、現在のカードから解決できないことを意味します。このタスクを解決できませんでした。もう一度お試しください。が表示される場合は、接続を確認してもう一度試してください。要求されたアクションが実際に完了する前に、タスクを解決済みとしてマークしないでください。
## やることリストを解決する
適格なワンクリックタスクでのみ**解決**を選択します。Runnerはダッシュボードからの確認を記録します。ファイル出力を含むより詳細なタスクは、やることリストで読み取り専用のままです。関連する提案を開いて、その指示と現在の状態を確認します。
解決に失敗した場合、タスクを開いたままにして、接続を確認した後、もう一度試してください。ステータスが変わるまで、タスクが完了したと仮定しないでください。
## 進行中および過去の作業を追跡する
1. **進行中の作業**のカードを開いて、現在の提案とタスク状態を確認します。
2. **対応待ち**と表示されている場合は、要求された手動アクションを完了して、提案を再度承認する代わりに**解決**を選択します。
3. 未完了の作業を停止する必要がある場合にのみ中止を使用します。既に完了した作業はロールバックされません。
4. **過去の作業**を開いて、結果と失敗した提案を確認します。
5. 失敗の場合、提案タイトルと表示されているタスクエラーを保持してから、ヘルプを求めてください。
## ミッションを完了し、次のミッションを選択する
Runnerがミッションが達成されたことを認識すると、**ミッション完了**がガイド付きフローを開きます。別の目標を選択する前に閉じた場合、**次のミッションを選択**がフローを再度開くことができます。
1. **ジャーニーを確認**を選択して、ミッション要約、重要な瞬間、およびFlyがあなたと一緒に完了した作業を確認します。
2. **次に何があるかを確認**を選択して、提案された次のミッションを確認します。
3. 利用可能なプリセットまたは増加/減少コントロールでターゲットを調整してから、**続行**を選択します。
4. ロールアウト概要を注意深く読みます。
5. 新しいターゲットが正しい場合にのみ**ミッションを開始**を選択します。
6. 次のミッションがライブになったら、**ミッションコントロールに移動**を選択してダッシュボードに戻ります。
**ミッションを開始**は実際のプロジェクト効果を持ちます。既に実行中のタスクは続行され、提案生成は新しい目標に対して再開され、対応していない提案は閉じられるため、Flyは新しいターゲット用に再生成できます。現在の進捗は引き継がれます。
## トラブルシューティング
| 状態 | 次のステップ |
| --- | --- |
| オンボーディングが自動的に開く | ミッションを設定するか、オンボーディングを閉じて後で戻ります。 |
| ダッシュボードが表示される | ミッションが存在します。重複を作成する代わりにダッシュボードを使用します。 |
| **対応待ち** | 提案を開き、特定の手動アクションを完了してから、**解決**を選択します。 |
| 中止の競合またはステータスが他の場所で変更された | 提案を更新して、その現在の状態を使用します。 |
| 完了したプレビューの読み込みに失敗 | ワークフロープレビューで**再試行**を選択するか、完了した提案を再度開いて最新の結果を取得します。 |
| 提案が失敗 | **過去の作業**から開いて、表示されているタスクエラーを保持します。 |
| 最終検証が復旧できない | 提案は進行中の作業に留まる代わりに失敗として決済されます。**過去の作業**から開いて、再試行する前に表示されているエラーを保持します。 |
| 次のミッションを開始できない | もう一度試してください。別のセッションが既に開始している場合、ダッシュボードはライブミッションに更新されます。 |
| エントリが見つからないか、ページが見つからない | このコンテキストではFlyは利用できません。[機能の可用性](./feature-availability)を参照してください。 |
## 関連ガイド
- [機能の可用性](./feature-availability)
- [タスク状態と詳細](../work-with-runner/task-states-and-details)
- [Runnerタスクのトラブルシューティング](../help-and-reference/troubleshoot-runner-tasks)
---
# リサーチ
Source: https://www.runnerai.com/docs/ja/guides/advanced/research
リサーチはプロジェクトスコープの場所を提供して、買い手のニーズ、概念、ポジショニング、およびその他のビジネス上の決定を調査します。
## エントリパス
ストアのプロジェクトを開き、利用可能な場合は**計測**を展開して**リサーチ**を選択します。モバイルでは先にプロジェクトメニューを開きます。項目がない場合、このワークスペースには機能が公開されていません。[機能の利用可能性](./feature-availability)を参照してください。
## 開始する前に
- リサーチは現在のプロジェクトで有効にする必要があります。
- 少なくとも5文字のビジネスの質問を1つ準備し、不要な顧客データを削除してください。
- ライブスカウティング、パネル、およびレポートは外部データまたはクレジットを使用できます。開始する前に、利用可能な各アクションを確認してください。
## 研究を開始または再度開く
リサーチホームには2つのモードがあります:**新しい研究**と**保存されたパネル**。
| コントロール | 選択後に起こること |
| --- | --- |
| **新しい研究** | 質問フォームとプロジェクトの最近の研究を開きます。 |
| 質問欄 | 調査するビジネス上の判断を入力します。有効な質問を入力するまで**調査を開始**は利用できません。 |
| シナリオカード | 提案された研究方向を質問フィールドに配置して、編集できるようにします。 |
| **調査を開始** | 現在の質問から実際の調査を作成し、案内付きの作業画面を開きます。 |
| **まず完成例を見る** | 読み取り専用の例を開きます。実際の調査は作成されず、実調査を必要とする操作は利用できない場合があります。 |
| 最近の研究カード | そのプロジェクトの既存の研究を再度開きます。 |
| **保存されたパネル** | 再利用のために保存されたパネルを開きます。 |
| **調査を立ち上げる** | 保存済みパネルを選択し、**新しい調査**に戻ります。新しい質問を入力し、**調査を開始**を選択して作成します。 |
| **さらに読み込む** | 追加の研究または保存されたパネルを読み込みます。 |
| **再試行** | 現在のライブラリまたは失敗したステージを再度リクエストします。 |
1つの焦点を絞った決定を質問として使用してください。「最初の購入者向けにどの製品クレームをリードすべきか?」のような質問は、「マーケティング」のような広いトピックよりも、研究に明確なジョブを与えます。
## ガイド付きステージを移動
左側の研究は質問と選択肢を提供します。関連する選択肢を選択し、必要に応じてカスタム回答を追加してから、現在のステージの主要なアクションを使用してください。
| アクション | Runnerが開始すること |
| --- | --- |
| **研究計画を構築** | 質問と回答を研究計画に変えます。 |
| **入力を変更** | スカウティングが開始される前に計画入力を再度開きます。 |
| **研究計画を再構築** | 変更された入力に基づいて、現在の計画を新しい計画に置き換えます。 |
| **スカウティングを開始[ソース]**(例:**スカウティングXを開始**) | 承認された計画で指定されたソースでスカウティングを開始します。 |
| **検証パネルを構築** | 調査結果に異議を唱えて検証するために使用される対象者パネルを構築します。 |
| **パネルディスカッションを開始** | パネルの会話を開始します。 |
| **概要、議事録、レポートを生成** | 完了したディスカッションから最終的な書面による成果物を生成します。 |
| **再試行**の後にステージ名 | 失敗したステージを繰り返します。同じ入力を盲目的に繰り返さないように、最初に失敗を確認してください。 |
正確な主要なアクションは、各ステージが準備できるにつれて変わります。現在の計画、調査結果、またはパネルに満足するまで、後のステージのアクションを選択しないでください。
## 研究成果物を確認
デスクトップでは、ガイド付きチャットと成果物キャンバスが並んで配置され、サイズを変更できます。モバイルでは、**研究チャット**と**成果物**を使用して切り替えます。
| 成果物タブ | 含まれるもの |
| --- | --- |
| **概要** | 研究タイムラインと、どのステージが準備完了または保留中かを示します。準備完了のアイテムを選択すると、その成果物が開きます。 |
| **計画** | 承認された研究アプローチ。計画が完了するまで空のままです。 |
| **[ソース]スカウト**(例:**Xスカウト**) | スカウティングの進捗と研究の現在のソースのソース。 |
| **調査結果** | スカウティング後に生成されたテーマと証拠。 |
| **パネル** | 調査結果から構築された検証対象者。 |
| **ディスカッション** | パネルの会話とフォローアップの回答。 |
| **レポート** | ディスカッション完了後の最終レポートワークスペース。 |
保留中のタブはエラーではありません。その空の状態は、最初にどのステージを完了する必要があるかを説明します。概要タイムラインは、利用不可のステージも保留中としてマークします。
## 有用なパネルを保存
**パネル**を開き、その対象者が将来の研究に役立つ場合は**パネルを保存**を選択します。保存フォームにパネル名とオプションの説明を入力してから、確認します。Runnerは**パネルが将来の研究のために保存されました**を報告し、パネルは**保存されたパネル**の下に表示されます。
保存は再利用のためにパネルを保持します。別の研究を開始しません。例のプレビューでは、例がライブプロジェクトデータではないため、保存は利用不可です。
## レポートを読んで共有
最終レポートワークスペースは3つのビューを分離します:
- **レポート**は完全な研究結果を提示します。
- **概要**は短い決定焦点バージョンを提供します。
- **議事録**はパネルディスカッションを記録します。
**共有**を選択して、サポートされている場合、現在の研究リンクをデバイスの共有パネルと共有します。ネイティブ共有が利用不可の場合、Runnerはリンクをコピーして**研究リンクがコピーされました**を表示します。共有はダウンロードされた静的レポートではなくリンクを送信します。受信者は適切なアクセスが必要です。
## パネルディスカッションを続ける
ディスカッションステージ中に、フォローアップコンポーザーを使用して、より明確な回答を求めるか、別の角度をテストしてください。
| コントロール | 結果 |
| --- | --- |
| **調査結果に異議を唱える** | 編集できるチャレンジプロンプトでコンポーザーを埋めます。 |
| **パネルに質問** | 編集できる直接パネルの質問でコンポーザーを埋めます。 |
| **対象者を変更** | 異なる対象者を検討するリクエストでコンポーザーを埋めます。 |
| **フォローアップを送信** | 現在のメッセージをライブパネルディスカッションに送信します。 |
提案チップはテキストを準備します。**フォローアップを送信**を選択するまで何も送信しません。コンポーザーが制限を超えているか、研究の準備ができていない場合、送信アクションは利用不可のままです。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| 例 | 完了したデモンストレーション、ライブプロジェクト研究ではありません。**新しい研究**に戻って、独自のものを作成してください。 |
| 保留中の成果物 | 前のステージが完了していません。概要または研究チャットに戻り、利用可能なステージを続けてください。 |
| ステージが実行中 | Runnerは次の成果物を準備しています。後で最近の研究を通じて戻ることができます。 |
| 再試行可能な失敗 | 表示されているエラーを読んでから、ステージ固有の**再試行**を1回使用します。 |
| 復旧がブロックされている | **研究をリロード**を選択して、続行する前に現在のサーバー状態を読み込みます。 |
| フォローアップが失敗する | メッセージを保持し、提供されている場合は再試行を使用するか、再送信する前に研究をリロードしてください。 |
| 研究またはパネルライブラリが失敗する | **再試行**を選択します。質問と表示されているエラーを保持してください。 |
| 空の研究履歴 | このプロジェクトはまだ研究を行っていません。1つの焦点を絞った質問で開始してください。 |
## 推奨パス
1. **新しい研究**を開き、1つの決定焦点の質問を入力します。
2. **調査を開始**を選択し、案内に沿って選択肢に回答します。
3. 計画を確認します。スカウティング前にスコープが間違っている場合は**入力を変更**を使用します。
4. Scout、Findings、Panel、Discussionを移動し、各準備完了の成果物を確認します。
5. パネルの対象者が再度役立つ場合にのみパネルを保存します。
6. レポート、概要、議事録を生成して読みます。
7. アクセスすべき人とのみ研究リンクを共有します。
8. 重複した研究を開始する代わりに、特定のギャップにフォローアップを使用します。
## 実際の調査の前に例を確認する
1. **計測 → リサーチ → 新しい調査**を開きます。
2. **まず完成例を見る**を選択します。
3. 利用できる成果物タブで、例の計画とレポートを読みます。
4. **新しい調査**に戻り、調べたい判断を1つ書きます。
5. 実際の調査を作成する準備ができた場合のみ、**調査を開始**を選択します。
**確認:** 例では調査を作成せずに出力形式を確認できます。自分の調査では、作業画面に質問が表示されていることを確認します。その後の情報収集やレポート作成には、それぞれ進行状況と結果があります。
## 関連ガイド
- [機能の利用可能性](./feature-availability)
- [実験](../automate-test-and-create/experiments)
- [分析概要](../analytics-and-seo/analytics-overview)
- [サポートとコミュニティ](../help-and-reference/support-and-community)
---
# Webhook
Source: https://www.runnerai.com/docs/ja/guides/advanced/webhooks
Webhookを使用すると、別のサービスがRunnerプロジェクトから選択されたイベントを受け取ることができます。これは高度なセキュリティに敏感な機能です。どのサービスがイベントを受け取るべきか、そのサービスがそれらを検証する方法を知っている場合にのみ使用してください。
## エントリパス
ワークスペースに表示される場合は、**構築 → Webhook**を開きます。項目がない場合はURLを推測せず、[機能の利用可能性](./feature-availability)を参照するか、サポートに有効状態を確認してください。
## 開始する前に
- WebhookはRunnerが承認されたエントリを公開する場合にのみ使用してください。
- 意図した受信サービスと、それがイベントを検証する方法を知ってください。
- エンドポイントアドレス、署名シークレット、および配信されたデータを機密として扱ってください。
## Runnerが表示するもの
RunnerのWebhook作業画面、または提供元の埋め込みポータルが表示されます。画面に一致する手順を使用してください。
### Runnerの作業画面を確認する
**条件付き:** Runnerの作業画面が有効な場合は、次のタブを使用します。
| タブ | 確認する内容 |
| --- | --- |
| **エンドポイント** | 設定済みの受信先と状態。 |
| **カタログ** | 送信先が受信するイベントを選ぶ前に、利用可能なイベントの種類。 |
| **ログ** | 記録された配信と返された状態。 |
| **アクティビティ** | 最近のWebhookの動作。 |
1. **エンドポイント**で確認する送信先を特定します。
2. **カタログ**で関連するイベントの種類を確認します。
3. **ログ**で、その送信先への配信記録を確認します。
4. 成功と判断する前に、受信サービス側の記録と状態を照合します。
**確認:** 保存されたエンドポイントは設定の確認です。特定のイベントの配信は、成功した配信記録と一致する受信側の記録で確認します。空のログは配信の動作を証明しません。テスト、再送、再実行はイベントを送るため、意図したテストでのみ使用してください。
### 提供元の埋め込みポータル
Runnerは埋め込み管理ポータルを表示する前にWebhookサービスを準備します。
| ページ状態またはコントロール | 意味または実行内容 |
| --- | --- |
| **読み込み中…** | Runnerはwebhookサービスの準備ができているかどうかを確認しています。 |
| **Webhookプラットフォームは初期化中です** | セットアップはまだ進行中です。ページを開いたままにして待つか、後で戻ってください。 |
| **初期化が予想より長くかかっています** | セットアップは通常の待機後に完了していません。**再試行**はRunnerにサービスを再度プロビジョニングするよう要求します。 |
| **再試行中…** | 再試行が進行中です。リクエストが完了するまで、ボタンは利用不可のままです。 |
| エラーメッセージ | Runnerはサービスを準備できませんでした。表示されているメッセージをサポート用に保持してください。 |
| 埋め込みwebhookポータル | サービスの準備ができています。このプロバイダー管理ポータル内の正確なラベルとコントロールは変更される可能性があるため、このガイドの固定ボタン名に依存するのではなく、そこに表示されている指示に従ってください。 |
| **Shopifyを再接続** | 古いShopify接続が新しいwebhook権限を必要とする場合、Shopify統合ページを開きます。Shopifyイベントの到着を期待する前に再接続してください。 |
## 長い初期化から復旧
1. 初期化メッセージが完了するまで待ちます。
2. **初期化が予想より長くかかっています**が表示される場合は、**再試行**を1回選択します。
3. 埋め込みポータルが初期化画面を置き換えるまで待ちます。
4. エラーが再度表示される場合は、プロジェクト名と正確なメッセージを保存してから、繰り返し再試行する代わりにサポートに連絡してください。
## 要求されたときにShopifyを再接続
1. **Shopifyストアを再接続**通知を読みます。
2. **Shopifyを再接続**を選択します。
3. Shopify統合ページで接続フローを完了します。
4. Webhookに戻り、イベント配信に依存する前に再接続通知が消えたことを確認します。
再接続はストアの統合認可を変更します。そのストア接続を管理することが許可されている人だけが続行する必要があります。
## セキュリティに関する注記
- エンドポイントアドレス、署名シークレット、およびイベントコンテンツを機密として扱ってください。
- 宛先を追加または変更するのは、その所有者が正しい安全なアドレスを提供した場合のみです。
- 埋め込みポータル内に表示されるすべての確認を確認します。そのアクションは将来の配信に影響を与える可能性があります。
- 署名値が公開された場合は、より多くのイベントを送信する前に、Runnerのwebhookサービスと受信システムの両方で置き換えてください。
## トラブルシューティング
| 問題 | 次のステップ |
| --- | --- |
| Webhookエントリなし | この機能はこのワークスペースで公開されていません。[機能の利用可能性](./feature-availability)を確認してください。 |
| 初期化が完了しない | **再試行**を1回使用してから、繰り返される場合は正確な状態を報告してください。 |
| エラーメッセージが表示される | 完全なメッセージとプロジェクト名をサポート用に保持してください。 |
| Shopify再接続通知が残る | 統合ページから再接続を完了してから、Webhookを1回リロードしてください。 |
| 埋め込みポータルが空白または異なる動作をする | 1回リロードしてください。それが続く場合、表示されているものをキャプチャしてください。埋め込みプロバイダーインターフェースはアカウントまたはリリースによって異なる場合があります。 |
## 関連ガイド
- [機能の利用可能性](./feature-availability)
- [セキュリティとセッション](../account-and-settings/security-and-sessions)
- [アプリのトラブルシューティング](../apps-and-integrations/troubleshooting)
- [サポートとコミュニティ](../help-and-reference/support-and-community)
---
# ワークフロー
Source: https://www.runnerai.com/docs/ja/guides/advanced/workflows
ワークフローは反復可能なプロセスを、Runnerが同じ入力とルールで再度実行できる接続されたステップに変えます。
> **条件付き:** ワークフローインターフェースは存在しますが、現在の標準プロジェクトナビゲーションはワークフローエントリを公開していません。Runnerがワークスペースの承認されたワークフローエントリを表示するか、Runnerサポートが承認されたパスを提供する場合にのみ使用してください。推測したり、URLを編集したりしてアクセスしないでください。プランがプレビューのみを許可する場合、Runnerはページを表示しながらコントロールをブロックしたままにすることができます。
## エントリパス
Runnerがワークスペースに**ワークフロー**エントリを表示する場合にのみ開いてください。ページには現在のプロジェクトのワークフローが一覧表示されます。エントリがない場合は、直接URLを試す代わりに[機能の利用可能性](./feature-availability)を使用するか、サポートに連絡してください。
## 開始する前に
- ワークフローアクセスは、現在の機能ロールアウトとプランに依存します。
- ワークフローをテストまたはデプロイする前に、プロジェクトと接続されたサービスを確認してください。
- プレビューまたは保存されたドラフトはアクティブではありません。デプロイとアクティベーションは別の重要なアクションです。
## ワークフロー一覧
ワークフローがない場合は、**ワークフローを作成**を選択します。リストに既にアイテムがある場合は、**新しいワークフロー**を使用します。
| コントロール | 選択後の動作 |
| --- | --- |
| **ワークフローを作成**または**新しいワークフロー** | **ワークフローを作成**を開きます。 |
| **空のワークフロー** | **無題のワークフロー**を作成し、ビルダーを開きます。 |
| テンプレートカード | そのテンプレートからワークフローを作成し、ビルダーを開きます。テンプレートの読み込みに失敗した場合、**再試行**でそれらを再度リクエストします。 |
| ワークフロー名 | そのワークフローをビルダーで開きます。 |
| **名前を変更** | 名前を編集可能にします。入力またはクリックで保存されます。Escapeでキャンセルします。 |
| **上部に固定** / **固定を解除** | ワークフローをピン留めグループに移動するか、グループから削除します。ワークフローは実行されません。 |
| **複製** | コピーを作成し、ビルダーでコピーを開きます。 |
| **エクスポート** | ワークフローをJSONファイルとしてダウンロードします。デプロイまたは実行されません。 |
| **削除** | 確認を開きます。確認するとそのワークフローが永久に削除され、元に戻すことはできません。 |
各行の「その他」メニューを使用して、**名前を変更**、**上部に固定**または**固定を解除**、**複製**、**エクスポート**、**削除**を見つけます。
行ラベルは、バージョンが**稼働中**か、**新しい下書きあり**か、エンドポイントを公開しているか、スケジュールまたはイベントにバインドされているかを示すこともできます。一時停止またはプランブロックラベルは、自動トリガーが現在アクティブでないことを意味します。
### 複数のワークフローを操作する
1つ以上の行の横にあるチェックボックスを選択します。選択バーは選択数を表示し、以下を提供します:
- **エクスポート**で選択したワークフローをダウンロードします。
- **削除**で一括確認を開きます。確認するとすべての選択されたワークフローが永久に削除されます。
- **クリア**で選択を削除し、ワークフローは変更しません。
**すべて選択**は現在のリストに表示されているワークフローを選択します。一括削除の前に常に数を再確認してください。
## ビルドと保存
ビルダーキャンバスは、ステップを追加し、接続し、各ステップが受け取るものと実行することを構成する場所です。**コンポーネントを追加**は検索可能なコンポーネントライブラリを開きます。キャンバスコントロールはズームイン、ズームアウト、ワークフローを画面に合わせる、接続されたステップを自動的に配置します。
変更は自動的に保存されます。別の保存ボタンはありません。戻る矢印は保留中の保存を完了してからワークフロー一覧に戻ります。
| 保存状態 | 実行すること |
| --- | --- |
| **保存中…** | ページを閉じるかデプロイする前に待機してください。 |
| **たった今に保存**（時刻は変わります） | 最新のキャンバス変更が保存されています。 |
| **保存に失敗しました** | 接続を確認した後、**再試行**を選択してください。 |
| **競合 - 変更は保存されませんでした** | より新しい保存バージョンがあります。**再読み込み**で競合するローカル編集を破棄し、保存されたバージョンを読み込みます。 |
下部パネルには**プレイグラウンド**と**実行履歴**が含まれています。プレイグラウンドで、実行する前に必要なテキスト、製品、またはメディア入力を完成させます。必要な入力がない場合、実行コントロールは利用不可のままです。結果は出力エリアに表示されます。
ビルダーの「その他」メニューは**JSONのエクスポート**と**JSONをインポート…** も提供します。エクスポートは現在のキャンバスをダウンロードします。インポートは現在のキャンバスを直ちに置き換え、確認なしで自動保存をトリガーするため、バックアップをエクスポートし、インポート前に選択したファイルを確認してください。
## 適切なテストを選択する
テストは非常に異なる結果をもたらす可能性があります。
| コントロール | 選択後の動作 |
| --- | --- |
| **シミュレート** | シミュレーションダイアログを開きます。生成されたサンプルデータを使用するか、JSONを貼り付けて、**シミュレーションを実行する**を選択します。メール、Slackポスト、ストア変更などの書き込み側アクションはスタブされます。 |
| **ライブテスト** | ライブテストダイアログを開きます。生成されたデータ、貼り付けたJSON、または利用可能な最近のイベントを使用します。**ライブテストを実行する**は実際のAPI呼び出しを行い、メッセージを送信するか接続されたサービスを変更できます。実行は履歴でテストとしてマークされます。 |
| **待機をスキップ** | ライブテスト中に、構成された待機期間をスキップして、テストをより早く続行できます。他の実際の効果は削除されません。 |
| **ワークフローの実行** | 構成されたワークフローを直ちに開始し、実行履歴を開きます。そのステップは実際の効果を持つ可能性があります。すべてのステップと入力を最初にレビューしてください。 |
| **停止** | 現在の実行を停止するようリクエストします。既に完了した作業は元に戻されません。 |
| **キャッシュ** | 再実行時に、入力が変更されていない適格なノードをスキップして、変更されたダウンストリーム作業に焦点を当てることができます。 |
シミュレーションを使用して分岐とデータフローを確認します。ライブテストは、接続されたアカウントで実際の副作用が許容される場合にのみ使用してください。
どちらのテストも、デプロイ前でも選択したトリガーを使用します。**スケジュール**または**1 回限り**のトリガーでは、その時点でトリガーが発火したものとして実行が開始されるため、1 回限りのワークフローを予定日より前にテストできます。
## 実行履歴をレビューする
下部パネルで**実行履歴**を開いて、以前の実行を確認します。**本番**、**テスト**、または**すべての実行**でリストをフィルタリングし、実行を選択してそのノード結果、出力、タイミング、エラーを検査します。ステータスには「完了」「失敗」「実行中」「キャンセルされました」が含まれます。
リストが**まだ実行されていません**と表示される場合、現在のワークフローには記録された実行がありません。別の実行を開始することは、失敗したものの修正ではありません。最初に失敗した実行を開き、そのエラーを読んでください。
一部の適格な失敗したノードは **「ノード」から再試行**を提供します。これは別の確認なしに直ちに新しい試行を開始します。ダウンストリームアクションは再度実行できるため、失敗した実行によって既に生成されたメッセージまたはストア変更を最初に確認してください。
## デプロイとアクティベート
**デプロイ**を選択して**デプロイワークフロー**を開きます。続行する前に、変更サマリー、APIコントラクト互換性、検証結果、オプションのチェンジログをレビューしてください。
デプロイされたワークフローは、オプションでイベント、繰り返しのスケジュール、または 1 回限りの実行にバインドできます。これらのトリガータイプの1つだけを一度に選択できます。1 回限りの実行には、ご自身のタイムゾーンで入力した将来の日時が必要です。
- **デプロイワークフロー**は選択された設定でバージョンを公開します。
- **有効化してデプロイ**は、新しいイベント、スケジュール、または 1 回限りのバインディングがオートメーションをアクティブにする場合に表示されます。確認するとバージョンを公開し、将来のトリガーが実際の効果で自動的に実行されることを許可します。
保存エラー、未解決の競合、または検証問題がデプロイをブロックできます。繰り返しデプロイを選択する代わりに、それを解決してください。
本番ステータスには、**未デプロイ**、**新しい下書きあり**、または**稼働中**と、トリガーが表示されます。初回デプロイ前は、選択したトリガー（**イベント**、**スケジュール**、**1 回限り**、または**手動**）か、**トリガーなし**が表示されます。デプロイ後は、トリガーがバインドされていない場合は**手動**、それ以外はバインディングの状態（**有効**、**予約済み**、**完了**、**一時停止中**など）が表示されます。既存のバインディングを開くと、重要なコントロールが提供されます:
- **一時停止**は自動トリガーを停止しますが、ワークフローとバインディングを保持します。
- **トリガーを再開**は保持されたバインディングが再度トリガーされることを許可します。
- **トリガーを削除**はバインディングを永久に削除しますが、ワークフローは削除しません。
各アクションは確認を開き、理由を含めることができます。デプロイ中に既存のバインディングからチェックを削除すると、そのバインディングを永久に削除するのではなく一時停止します。
## バージョン履歴とロールバック
**バージョン履歴**を選択して**バージョン履歴**パネルを開きます。
| アクション | 結果 |
| --- | --- |
| **ロールバックの確認** | **このバージョンにロールバックしますか？** を開きます。**ロールバックの確認**で選択されたデプロイされたバージョンが現在のデプロイされたバージョンに取って代わります。これは将来の実行が何をするかを変更できますが、現在のドラフトキャンバスは置き換えません。 |
| ドラフト履歴の**復元** | 確認後、現在のキャンバスを選択された保存されたドラフトで置き換えます。保存されていないまたはより新しいキャンバス変更が失われる可能性があります。 |
ロールバック理由をオプションで追加して、他のワークスペースメンバーが変更を理解できるようにしてください。復元されたキャンバスとデプロイメント状態をレビューしてから、別の実行を開始してください。
## 安全な操作チェックリスト
1. 正しいプロジェクトとワークフローにいることを確認してください。
2. テストまたはデプロイの前に、**たった今に保存**などと表示されるまで待ってください。
3. すべての必要な入力を完成させてレビューしてください。
4. 可能な場合は**シミュレーションを実行する**で開始してください。
5. ライブテストまたはワークフローを実行するのは、接続されたサービスの効果が許容される場合のみです。
6. デプロイする前に**実行履歴**と出力を検査してください。
7. **有効化してデプロイ**、ロールバック、復元、削除を最終レビューが必要な重要なアクションとして扱ってください。
## トラブルシューティング
| 問題 | 次のステップ |
| --- | --- |
| **ワークフロー**エントリが表示されない | これは標準ナビゲーションでは予想されます。URLを推測しないでください。[機能の利用可能性](./feature-availability)を参照するか、Runnerサポートにワークスペースが承認されたエントリを持っているかどうかを確認してください。 |
| コントロールがプランプレビューでブロックされている | 画面上のプランメッセージに従うか、ワークスペース所有者にアクセスについて確認してください。 |
| テンプレートリストが失敗する | **再試行**を選択するか、**空のワークフロー**を作成してください。 |
| 実行ボタンが利用不可 | すべての必要な入力を完成させ、無効な値を修正してください。 |
| 保存競合が表示される | **再読み込み**を選択する前に、保存されたバージョンが勝つべきかどうかを決定してください。ローカルの競合する編集は破棄されるためです。 |
| 実行が失敗する | **実行履歴**で開き、表示されたエラーと入力を保持し、同じ実行を繰り返し開始しないでください。 |
| デプロイがブロックされている | デプロイダイアログに表示されている保存、競合、コントラクト、または検証メッセージを解決してください。 |
## 次の段階に進む前に結果を確認する
保存後、同じワークフローを開き直し、手順と入力があることを確認します。保存は確認の準備ができた状態であり、実行済みとは限りません。テストやデプロイが利用できる場合は、実行結果と出力を確認してからデプロイへ進みます。失敗した場合は、入力や失敗した手順を修正してから再試行してください。
## 関連ガイド
- [オートメーション](../automate-test-and-create/automations)
- [タスク状態と詳細](../work-with-runner/task-states-and-details)
- [Runnerタスクのトラブルシューティング](../help-and-reference/troubleshoot-runner-tasks)
- [機能の利用可能性](./feature-availability)
---
# エージェントのカスタマイズ
Source: https://www.runnerai.com/docs/ja/guides/agent
**Runnerにあなたの仕事の進め方を教える**という見出しの**エージェント**画面は、スキルとメモリをまとめて検索できる場所です。役立つ手順を繰り返す、変わりにくい事実を覚える、不要な機能を停止するときに使用します。
## このガイドの内容
エージェントのカスタマイズを開き、既存の機能を見つけ、スキルまたはメモリのどちらが適切なツールかを選択できるようになります。
## 利用可能性と前提条件
- ストアプロジェクトへのアクセスが必要です。
- スキルは現在のプランに依存する可能性があります。プランにスキルが含まれていない場合、Runnerはアクションを有効にする代わりに利用可能なアップグレードパスを表示します。
- メモリは、統合メモリ機能がアカウントに対して有効な場合にのみ表示されます。
- 古い**スキル**、**メモリ**、**カスタマイズ**リンクはこのエージェントページにリダイレクトされます。
## エージェントのカスタマイズを開く
プロジェクトのサイドバーで**エージェント**を選択します。**すべて**、**スキル**、**メモリ**で絞り込みます。**おすすめ**、**追加済み**、**見つける**は同じページ内のセクションであり、別のナビゲーションタブではありません。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
フィルターでスキルかメモリを絞り込みます。有効な既存スキルは**追加済み**に表示されます。おすすめを見るだけではインストールされません。画像は英語の画面です。
## メインコントロール
| エントリまたはボタン | 有用な理由 | 次の動作 |
| --- | --- | --- |
| **スキルとメモリを検索** | 各セクションを探さずに機能を見つけます。 | 一致するスキルとメモリを表示します。クリアすると一覧全体に戻ります。 |
| **すべて** | エージェントページで利用可能なすべてを確認します。 | Runnerはスキルエリアと、有効な場合はメモリを表示します。 |
| **スキル** | 再利用可能な指示と能力に焦点を当てます。 | Runnerは推奨、追加、一時停止、発見可能なスキルを表示します。 |
| **メモリ** | Runnerが保持すべき事実に焦点を当てます。 | Runnerはスコープでグループ化されたメモリを表示します。メモリが利用不可の場合、このタブは非表示になります。 |
| **追加** | スキルをインストールまたは再アクティベートします。 | Runnerがアクションを完了した後、スキルは**追加**に移動します。 |
| **追加** | スキルがアクティブであることを確認します。 | 構成可能なスキルの場合、それを選択するとそのスキルが一時停止されます。 |
| **インポート** | URLから互換性のあるスキルを持ち込みます。 | Runnerはソースをチェックし、編集可能なインポートまたは複数スキルの選択画面を開きます。 |
| **スキルを作成** | 再利用可能なカスタム指示を書きます。 | スキルエディターが開きます。保存する前に必須フィールドを完成させる必要があります。 |
| **メモリを追加** | 安定した事実または好みを保存します。 | **新しいメモリ**ダイアログが開きます。 |
## スキルとメモリのどちらかを選択する
1. Runnerが反復可能なプロセス、フォーマット、または指示セットに従うべき場合は**スキル**を使用します。
2. Runnerが簡潔な事実、好み、修正、慣例、または決定を保持すべき場合は**メモリ**を使用します。
3. 秘密を両方から遠ざけてください。パスワード、APIキー、支払い詳細、またはプライベート認証情報を保存しないでください。
4. **すべて**に戻り、用語を検索して、新しいアイテムが表示されることを確認します。
## 状態と制限
- **あなたにお勧め**は少数のトレンドスキルを表示します。
- **追加**にはアクティブなスキルが含まれます。**一時停止**には非アクティブなスキルが含まれます。
- **発見**には、読み込み中の行、検索結果、または結果なしのメッセージが表示されることがあります。
- システムスキルは表示専用または固定の場合があります。カスタムスキルでは編集や削除を行える場合があります。
- 空のメモリエリアは**メモリを追加**を提供します。一致なしの検索は何も削除せずに**検索をクリア**を提供します。
- 読み込み、プラン、利用不可状態は機能が追加されたことを意味しません。
## トラブルシューティング
- **メモリ**が不在の場合、機能は現在のアカウントに対して有効になっていません。スキルを使用し続けるか、後で表示されるナビゲーションから再度確認してください。
- **追加**がアップグレード画面を開く場合、請求決定を行う前にプランを比較してください。
- 検索が何も見つけない場合、クエリをクリアし、**すべて**、**スキル**、**メモリ**を個別に確認してください。
- 変更が失敗する場合、ダイアログを開いたままにして、表示された問題を修正し、再試行してください。トーストまたは読み込み状態が変更が完了したことを意味すると仮定しないでください。
## 関連ガイド
- [スキルを使用および一時停止する](/ja/guides/agent/skills)
- [スキルの作成、インポート、管理](/ja/guides/agent/create-import-manage-skills)
- [メモリを追加および編集する](/ja/guides/agent/memory)
- [エージェントコマンドパレットを使用する](/ja/guides/agent/command-palette)
---
# エージェントコマンドパレット
Source: https://www.runnerai.com/docs/ja/guides/agent/command-palette
エージェントコマンドパレットは、エージェント機能のキーボード優先ショートカットです。必要なものがわかっていて、完全なエージェントページを参照したくない場合に便利です。
## このガイドの内容
パレットを開き、3つの機能グループを検索し、キーボードを使用し、各結果を選択することが何をするかを理解できるようになります。
## 利用可能性と前提条件
- プロジェクト内にいる必要があります。
- スキルはプランアクセスと各スキルの構成可能な状態の対象のままです。
- メモリ結果は、統合メモリが有効な場合にのみ表示されます。
- このパレットはプロジェクトナビゲーション検索とは異なります: **Command/Ctrl + K**は宛先と会話を検索し、**Command/Ctrl + Shift + K**はエージェント機能を開きます。
## エントリパス
パレットが利用可能なプロジェクトでは、macOSで**Command + Shift + K**、WindowsとLinuxで**Ctrl + Shift + K**を押します。結果を選ぶ前に、**スキル**と**メモリ**のフィルターを確認します。ナビゲーション検索が開いた場合は閉じ、サイドバーの**エージェント**を使用します。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
ショートカットで機能パレットが開かない場合は、**エージェント**画面で同じスキルを探します。英語の画像は代替のページであり、コマンドパレットではありません。
## コントロール
| エントリまたはキー | 有用な理由 | 次の動作 |
| --- | --- | --- |
| 検索フィールド | 名前、説明、カテゴリ、タイプでスキルを検索し、コンテンツ、タグ、タイプ、スコープでメモリを検索します。 | 結果は追加、発見、メモリの下で更新されます。 |
| **すべて** | すべての利用可能な機能タイプを検索します。 | スキルとメモリがまとめて表示されます(利用可能な場合)。 |
| **スキル** | インストール済みおよび発見可能なスキルに結果を制限します。 | メモリ行は非表示になります。 |
| **メモリ** | 保存されたメモリに結果を制限します。 | このタブはメモリが利用不可の場合は非表示になります。 |
| 上下矢印 | マウスなしで結果を移動します。 | ハイライトされた行が変わります。 |
| Enter | ハイライトされた行を選択します。 | 結果はそのタイプ固有のアクションを実行します。 |
| Escape | 何も変更せずに離れます。 | パレットが閉じます。 |
## 選択が実行すること
| 結果タイプ | 選択時の動作 |
| --- | --- |
| 追加された構成可能なスキル | プランがそれを許可する場合、Runnerはそのスキルのアクティブ状態を切り替えます。 |
| 固定システムスキル | そのスキルが切り替えられない場合、行は変わりません。 |
| スキルを発見 | Runnerはスキルの追加を開始します。行は追加中…を表示できます。 |
| メモリ | パレットが閉じ、そのメモリに基づいた検索で**エージェント → メモリ**を開きます。 |
| プランアクセスなしのスキル | Runnerは**エージェント → スキル**を開き、プランゲートが利用可能な次のステップを説明します。 |
## パレットを使用する
1. **Command/Ctrl + Shift + K**を押します。
2. スキル名、ソース、またはメモリコンテンツから特徴的な単語を入力します。
3. 必要に応じて、**スキル**または**メモリ**を選択してリストを絞り込みます。
4. 矢印キーを使用して行をハイライトします。
5. 右側のアクションテキスト(**追加**または**開く**など)をレビューします。
6. それがあなたが望むアクションである場合にのみEnterを押します。
7. エージェントページまたは更新されたパレット状態で結果を確認します。
## 状態と制限
- **表示するものがありません**は、現在のタブとクエリが行を返さなかったことを意味します。
- 追加中…は進行状態であり、インストールが完了したことの確認ではありません。
- パレットは迅速な選択に最適化されています。作成、編集、削除、メモリスコープ、詳細なスキル設定は完全なエージェントページに残ります。
- アクティブなスキルを選択すると、それを一時停止できます。Enterを押す前に行の状態を読んでください。
## トラブルシューティング
- ショートカットでプロジェクト検索や複数のダイアログが開いた場合は、Escapeで閉じ、サイドバーの**エージェント**で同じ機能を管理します。
- メモリが不在の場合、アカウントは現在統合メモリサーフェスを持っていません。
- Enterがスキルを切り替える代わりにエージェントページを開く場合、表示されたプランゲートに従ってください。
- 結果がない場合は、検索をクリアするか**すべて**を選択してください。
- スキルが変わらない場合、それは固定システムスキルかもしれません。
## 関連ガイド
- [エージェントのカスタマイズ概要](/ja/guides/agent)
- [スキル](./skills)
- [メモリ](./memory)
- [サブスクリプションプラン](../plans-and-billing/subscription-plans)
---
# スキルの作成、インポート、管理
Source: https://www.runnerai.com/docs/ja/guides/agent/create-import-manage-skills
カスタムスキルを使用すると、繰り返し使用するための独自の指示をパッケージ化できます。互換性のあるスキルが既に存在し、追加する前にレビューしたい場合、インポートは便利です。
## このガイドの内容
スキルを作成またはインポートする方法、各エディターコントロールを理解し、元に戻せる一時停止と永続的な削除を区別できるようになります。
## 利用可能性と前提条件
- **エージェント → スキル**へのアクセス権を持つプロジェクトを開きます。
- スキルはプランアクセスが必要です。
- インポートには、Runnerが読み取ることができる互換性のあるソースURLが必要です。
- 信頼していない指示をインポートしないでください。保存する前に、名前、説明、コンテンツ、設定、含まれるファイルをレビューしてください。
## エントリパス
- 作成: サイドバーの**エージェント → スキル**フィルター → **見つける**の**スキルを作成**。
- インポート: サイドバーの**エージェント → スキル**フィルター → **見つける**の**インポート**。
- 編集・削除: サイドバーの**エージェント → スキル**フィルター → **追加済み**の行 → **その他の操作**。
## スキルエディターの操作
| エントリまたはボタン | 有用な理由 | 次の動作 |
| --- | --- | --- |
| **名前** | リストとコマンドでスキルを識別できるようにします。 | Runnerは保存する前に名前が入力されていることを確認します。 |
| **説明** | スキルをいつ使用すべきかを説明します。 | 説明はスキルリストと選択画面に表示されます。 |
| **コンテンツ** | 再利用する指示を保存します。 | **編集**で書き、**プレビュー**で表示を確認します。 |
| **詳細設定** | 呼び出しや組織の任意設定を表示します。 | 変更が必要な場合のみ展開します。 |
| **Markdown に切り替え** / **フォームに切り替え** | スキルの編集方法を切り替えます。 | Markdownまたは項目形式のエディターを開きます。切り替えだけでは保存されません。 |
| **カテゴリ** | 関連するスキルをグループ化します。 | このオプションのラベルはスキルの整理方法に影響します。 |
| **ショートカットラベル** | スキルにわかりやすいコマンドラベルを付けます。 | 任意のラベルはコマンド操作に表示されます。 |
| **有効** | 作成・編集したスキルを有効にするか選択します。 | 新しいスキルは初期状態でオンです。一時停止状態で作成するには、作成前にオフにします。 |
| **AI自動呼び出しを無効化** | Runnerがスキルを自動的に選択するのを防ぎます。 | スキルは手動で引き続き使用できます。 |
| **ユーザー呼び出し可能** | 手動スラッシュコマンド使用を許可します。 | オフにすると他の許可された使用を保持しながら手動呼び出しを削除します。 |
| **引数ヒント** | コマンド後の予想される入力を表示します。 | ヒントはURLまたは問題番号などの例を表示できます。 |
| ファイルエリア | スキルに必要な補足テキストやアセットを追加します。 | Runnerは保存する前にファイルごと、および全体の上限を確認します。 |
| **キャンセル** | 現在の編集を適用せずに離れます。 | ダイアログが閉じます。保存されていない変更は破棄されます。 |
| **作成** / **保存** | 有効なスキルを保存します。 | 成功するとエディターが閉じ、一覧が更新されます。 |
## カスタムスキルを作成する
1. サイドバーの**エージェント**を開き、**スキル**フィルターを選択します。
2. **発見**で、**スキルを作成**を選択します。
3. `homepage-copy-review` のような小文字とハイフンの**名前**、短い**説明**、スキルの**コンテンツ**を入力します。すべて必須です。
4. 内容の**プレビュー**で指示を確認します。任意設定が必要な場合のみ**詳細設定**を展開します。
5. **有効**と変更した呼び出しの詳細設定を確認します。これらはRunnerがスキルを使用する方法を決めます。
6. **作成**を選択します。
7. 有効の設定に応じて、スキルが**追加**または**一時停止**に表示されることを確認します。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzg4coukNWsuzxoOMdaP6hbmvT5BXVptGwrSeWq)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
**作成**前に指示を確認する例です。下書きは未保存です。画像は英語の画面です。
### 動画: スキルの下書きを確認する
英語の録画では、例をMarkdownとフォームのプレビューで切り替え、最後にキャンセルしています。保存する場合は**作成**を選択し、一覧に表示されることを確認します。
## スキルをインポートする
1. **エージェント**を開き、**スキル**フィルターを選択して、**見つける**の**インポート**を探します。
2. 互換性のあるソースURLを貼り付けます。
3. **インポート**を選択します。
4. スキルが1つ見つかった場合、Runnerはインポート内容が入力されたエディターを開きます。複数のスキルを含むソースの場合、Runnerは選択画面を開きます。
5. インポートされたすべてのフィールドと除外されたファイルまたはサイズ警告をレビューします。
6. 必要な変更を行い、**作成**を選択します。
7. 手順を閉じる前に、スキルがエージェントページに表示されることを確認します。
インポートはレビューされていないコンテンツを信頼できるようにしません。インポートされた指示を、Runnerの作業に影響を与える可能性のある他のコンテンツと同様に扱ってください。
## 編集、一時停止、または削除
1. カスタムスキルの行を選択するか、**その他のアクション → 編集**を開きます。
2. 必要な項目を変更して**保存**を選択します。スキルを開き直し、更新した指示を確認します。
3. 失わずに使用を停止するには、**追加**を選択して**一時停止**に移動します。
4. 削除するには、**その他のアクション → 削除**を開きます。
5. スキル名が表示された確認ダイアログを読み、削除する場合だけ**削除**を選択します。
削除は破壊的です。これは一時停止と同じではなく、ページはそれを元に戻せないアクションとして提示しません。システムスキルは削除を提供しません。
## 状態と制限
- 名前、説明、またはコンテンツが不足していると保存がブロックされ、検証メッセージが表示されます。
- インポートするスキル名が重複している場合、拒否されるか、すでに存在すると表示されることがあります。
- 受け入れられた制限を超えるファイルはスキップされる可能性があります。合計サイズ警告はコンテンツが削減されるまで保存をブロックできます。
- 保存、インポート、または削除が実行中の場合、別のアクションを実行する前に成功またはエラーメッセージを待ってください。
- ビューのみのシステムスキルは詳細を表示できますが、カスタムスキル編集コントロールを公開しません。
## トラブルシューティング
- **インポート**が利用不可のままの場合、既存スキルの確認が終わるまで待ち、URL欄が空でないことを確認してください。
- インポートがバッチチューザーを開く場合、認識して必要なスキルのみを選択してください。
- 保存がブロックされている場合、必要なフィールドとエディターの上部のファイル警告を確認してください。
- **追加**を選択した後にスキルが消えた場合、再作成する前に**一時停止**を確認してください。
- 削除に失敗した場合、スキルは残ります。エラーを閉じ、権限を確認してから再試行してください。
## 関連ガイド
- [スキル](./skills)
- [エージェントのカスタマイズ概要](/ja/guides/agent)
- [エージェントコマンドパレットを使用する](./command-palette)
- [エージェント設定を保存する](../account-and-settings/custom-scripts-and-store-agent)
---
# メモリ
Source: https://www.runnerai.com/docs/ja/guides/agent/memory
メモリは、Runnerが保持すべき簡潔なファクト（作成環境設定、修正されたビジネスルール、または承認された決定など）用です。これにより、タスク全体での繰り返しの説明が減ります。
## このガイドの内容
メモリを追加、検索、編集、および安全に削除できるようになります。
## 利用可能性と前提条件
- ストアプロジェクトが必要です。
- **メモリ**タブは、統合メモリがアカウントに対して有効になっている場合にのみ表示されます。
- メモリはスキルプランゲートとは別です。
- パスワード、APIキー、支払い詳細、プライベート認証情報、またはその他のシークレットをメモリに保存しないでください。
## エントリパス
サイドバーの**エージェント**を選択し、**メモリ**フィルターを選択します。
## メモリコントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **メモリを追加** | Runnerが保持すべき新しいファクトを保存します。 | **新しいメモリ**ダイアログが開きます。 |
| **コンテンツ** | Runnerが保持すべきファクトを述べます。 | このテキストは表示されるメモリになります。 |
| **スコープ** | ファクトが適用されるべき場所を選択します。 | **このストア**、**個人**、または**組織**を選択します。 |
| **タイプ** | ファクトの種類を説明します。 | 環境設定、修正、慣例、知識、または決定を選択します。 |
| **タグ** | メモリを見つけやすく、グループ化しやすくします。 | 1つ以上のカンマ区切りのタグを入力します。保存するには少なくとも1つのタグが必要です。 |
| **重要度** | Runnerがファクトをどの程度重視するかを伝えます。 | 低、中、または高を選択します。 |
| **メモリを追加** | 有効な新しいメモリを保存します。 | 成功後、ダイアログが閉じ、メモリがそのスコープグループに表示されます。 |
| 編集アイコン | メモリを修正または改善します。 | **メモリを編集**が現在の値で開きます。 |
| **保存** | 編集を適用します。 | 更新が成功した後、行が更新されます。 |
| 削除アイコンまたは**削除** | メモリを削除します。 | Runnerは破壊的な確認ダイアログを開きます。 |
## メモリを追加する
1. サイドバーの**エージェント**を開き、**メモリ**フィルターを選択します。
2. **メモリを追加**を選択します。
3. **コンテンツ**に「このストアの見出しは文頭のみ大文字にする」など、明確な事実を1つ書きます。
4. 最も狭い正しい**スコープ**を選択します。
5. 最も近い**タイプ**を選択します。
6. `copy, headings` のような役立つ**タグ**をカンマ区切りで追加します。
7. **重要度**を設定します。情報が競合する場合にRunnerが優先すべきファクトについては、高を控えめに使用します。
8. **メモリを追加**を選択します。
9. 新しい行が意図されたスコープの下に表示されることを確認します。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
未保存の設定例です。**メモリを追加**を選ぶ前に、必要最小限の範囲を選択します。画像は英語の画面です。
### 動画: メモリの範囲を選ぶ
英語の録画では、設定例の範囲を確認してキャンセルしています。メモリは保存していません。上記の手順を実施し、新しい行を確認して保存を確かめてください。
## メモリを編集または削除する
1. スコープグループを参照するか、検索を使用してメモリを見つけます。
2. 編集アイコンを選択し、項目を更新して**保存**します。行を開き直し、新しい内容と範囲を確認します。
3. 削除するには、削除アイコンを選択するか、編集ダイアログ内の**削除**を選択します。
4. **メモリを削除**を確認し、**削除**を選択して確認します。
このダイアログからメモリを削除することは取り消せません。キャンセルは削除せずに確認を閉じます。
## 状態と制限
- 新しいアカウントは**まだメモリがありません**と**メモリを追加**アクションを表示できます。
- 一致しない検索は、隠されているメモリの数を示し、**検索をクリア**を提供します。
- 保存ボタンが利用可能になる前に、コンテンツと少なくとも1つのタグが必要です。
- メモリはスコープでグループ化され、タイプ、スコープ、使用回数、および最近の使用時間を表示します。
- メモリはRunnerがファクトを利用可能にします。すべての指示またはセーフティ境界をオーバーライドすることは保証されません。
## トラブルシューティング
- **メモリ**タブが表示されない場合は、古いダイレクトリンクではなく、表示されているナビゲーションを使用してください。この機能は現在のアカウントに対して有効になっていません。
- **メモリを追加**が無効になっている場合は、コンテンツと少なくとも1つのカンマ区切りのタグを追加します。
- 検索後にリストが空に見える場合は、**検索をクリア**を選択します。
- 編集が失敗した場合、前のメモリは残ります。表示された問題を修正して再試行します。
- メモリが広すぎるスコープに適用されている場合は、編集してより狭いスコープを選択します。
## 関連ガイド
- [メモリの種類とスコープ](./memory-types-and-scopes)
- [エージェントカスタマイズの概要](/ja/guides/agent)
- [エージェントコマンドパレットを使用する](./command-palette)
- [APIキーのセーフティ](../account-and-settings/api-keys)
---
# メモリの種類とスコープ
Source: https://www.runnerai.com/docs/ja/guides/agent/memory-types-and-scopes
スコープは、ファクトが間違った作業に到達するのを防ぎます。一方、タイプと重要度は、Runnerがそれを解釈するのに役立ちます。このページは、メモリが複数のタスクに適用されるべきだが、必ずしもすべてのストアまたはユーザーに適用される必要がない場合に使用します。
**アクセス方法:** **サイドバー → エージェント → メモリ → メモリを追加**。編集するには既存のメモリを開きます。
## このガイドの内容
最も狭い正しいスコープを選択し、メモリを分類し、機密データを保存せずにタグと重要度を使用できるようになります。
## 利用可能性と前提条件
- 統合メモリがアカウントに対して有効になっている必要があります。
- **サイドバー → エージェント → メモリ → メモリを追加**を開くか、既存のメモリを編集します。
- パスワード、APIキー、カードデータ、認証コード、またはその他のシークレットにはスコープを使用しないでください。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgabaEIEROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
**範囲**で適用先、**種類**で情報の性質を選びます。英語の画像は未保存の例です。[メモリの追加と編集](/ja/guides/agent/memory)に手順と録画があります。
## スコープの選択肢
| スコープ | 使用する場合 | 次に何が起こるか |
| --- | --- | --- |
| **このストア** | ファクトが現在のストアフロント、カタログ、ブランド、またはワークフローに固有である。 | Runnerはメモリをストアスコープの下にグループ化し、このストアの作業に適用できます。新しいメモリは、デフォルトでこのスコープ、**環境設定**タイプ、重要度**中**を使用します。 |
| **個人** | ファクトが独自の作業環境設定を説明している。 | Runnerはそれを個人としてグループ化し、ワークスペース全体のルールとして共有しません。 |
| **組織** | ファクトはワークスペース全体で共有される承認されたルールまたは慣例である。 | Runnerはそれを組織の下にグループ化し、1つのストアを超えた作業に情報を提供できます。 |
最も狭いスコープを選択してください。ただし、それでも有用である必要があります。たとえば、ストア固有の配送ルールは、本当にどこにでも適用される場合を除き、組織メモリであってはなりません。
## タイプの選択肢
| タイプ | 良い使用方法 | 例 |
| --- | --- | --- |
| **環境設定** | 望ましいスタイルまたは作業の選択 | 「簡潔で編集的な製品説明を使用してください。」 |
| **修正** | Runnerが以前に間違ったファクト | 「返品期間は承認されたポリシードキュメントに記載されています。」 |
| **慣例** | 繰り返し可能な命名またはフォーマットルール | 「コレクション見出しにセンテンスケースを使用してください。」 |
| **知識** | 安定したビジネスまたは製品ファクト | 「フラッグシップコレクションはStudio Essentialsと呼ばれています。」 |
| **決定** | 将来の作業が尊重すべき承認された選択 | 「ゲストチェックアウトを有効にしたままにしてください。」 |
メモリに秘密を含めないでください。保護された認証情報の値を保存する代わりに、その場所を参照してください。
## 重要度とタグ
| コントロール | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **低** | 有用だが任意のファクトを利用可能に保ちます。 | 情報が競合する場合、Runnerはそれに低い重みを与えます。 |
| **中** | 安定した作業ファクトに通常の優先度を使用します。 | Runnerはそれにデフォルトの中程度の重みを与えます。 |
| **高** | 重要な承認されたルールまたは決定をマークします。 | 関連するメモリから選択する場合、Runnerはそれにより多くの重みを与えます。 |
| **タグ** | 検索とグループ化を簡単にします。 | カンマ区切りのタグはメモリとともに保存されます。少なくとも1つが必要です。 |
重要度は優先度のヒントであり、現在のリクエスト、アカウント権限、またはセーフティ制限を無視する指示ではありません。
## メモリを分類する
1. ファクトを1つの明確な文として記述します。
2. それがどこに適用されるべきかを尋ねます：このストアのみ、自分のみ、または組織全体。
3. ファクトが存在する理由に基づいて、最も近いタイプを選択します。
4. 小さな特定のタグセットを追加します。
5. 低または高を選択する明確な理由がない限り、中程度の重要度から始めます。
6. 保存し、行が予想されるスコープ見出しの下に表示されることを確認します。
## 状態と制限
- リストには、タイプ、スコープ、メモリが使用された回数、および相対的な最近の使用時間が表示されます。
- スコープを編集すると、保存が成功した後、メモリが別のグループに移動します。
- メモリの選択は関連性と優先度に依存します。高いメモリがすべての応答に表示されることは保証されません。
## トラブルシューティング
- メモリが間違ったストアに影響を与える場合は、正しいプロジェクトでそのスコープを**このストア**に変更します。
- 2つのメモリが競合する場合は、両方を高に上げる代わりに、古いものを編集または削除します。
- 検索がメモリを見落とす場合は、そのコンテンツまたはタグの単語を試してから、フィルターをクリアします。
- 共有された慣例が協力者に表示されない場合は、個人ではなく**組織**として保存されたことを確認します。
## 関連ガイド
- [メモリを追加および編集](./memory)
- [エージェントカスタマイズの概要](/ja/guides/agent)
- [セキュリティとセッション](../account-and-settings/security-and-sessions)
---
# スキル
Source: https://www.runnerai.com/docs/ja/guides/agent/skills
スキルは、Runnerに作業の種類に対する繰り返し可能な指示セットを提供します。同じプロンプトを毎回書き直す代わりに、信頼できるプロセスを将来の会話全体で利用可能にしたい場合に便利です。
## このガイドの内容
スキルを追加し、それがアクティブであるかどうかを判断し、一時停止し、システムスキルとカスタムスキルで利用可能なアクションを理解できるようになります。
## 利用可能性と前提条件
- エージェント機能を管理する権限を持つストアプロジェクトを開きます。
- スキルの使用はプランゲートです。現在のプランに含まれていない場合、Runnerはアップグレードパスを表示します。
- 一部のシステムスキルは一時停止、編集、または削除できません。
## エントリパス
サイドバーの**エージェント**で**スキル**フィルターを選び、同じページの**おすすめ**、**追加済み**、**見つける**までスクロールします。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgbfacL5GPQUs8tnu5T3OaZHYfyR9pc0geGSv2)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
**追加**や**追加済み**を選ぶ前に、スキルの提供元と状態を確認します。英語の画像は既存のスキルであり、新規インストールの結果ではありません。
## スキルセクションとコントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **あなたにお勧め** | トレンドスキルの小さなセットをすばやく確認します。 | **追加**を選択するとインストールが開始されます。 |
| **追加済み** | どのスキルがアクティブであるかを確認します。 | 各行はスキル名、説明、タイプ、および利用可能なアクションを表示します。 |
| **一時停止中** | 現在オフになっているスキルを見つけます。 | **追加**を選択すると、設定可能なスキルが再度有効になります。 |
| **発見** | 追加のスキルを参照または検索します。 | スキル名は新しいタブでそのソースを開くことができます。**追加**はそれをワークスペースにインストールします。 |
| スキル行 | スキルの詳細を読みます。 | カスタムスキルは編集モードで開きます。システムスキルはビューモードで開きます。 |
| **追加済み**ボタン | アクティブな設定可能なスキルを一時停止します。 | 更新が成功した後、スキルは**一時停止中**に移動します。 |
| **追加**ボタン | スキルをインストールまたは再度有効にします。 | ボタンは進行状況を表示し、スキルは**追加済み**の下に表示されます。 |
| その他のアクション | 編集、表示、または削除アクションを見つけます。 | 利用可能なアクションは、スキルがシステムかカスタムかによって異なります。 |
## 発見されたスキルを追加する
1. サイドバーの**エージェント**で**スキル**フィルターを選び、同じページの**おすすめ**、**追加済み**、**見つける**までスクロールします。
2. 必要なタスクまたはフォーマットを検索します。
3. スキル名、ソース、および説明を確認します。
4. **追加**を選択します。
5. 進行状況の状態が終了するまで待ちます。
6. チャットで依存する前に、スキルが**追加済み**の下に表示されることを確認します。
## スキルを一時停止または再度有効にする
1. **追加済み**の下でスキルを見つけます。
2. その**追加済み**ボタンを選択します。
3. それが**一時停止中**に移動することを確認します。
4. 再度有効にするには、一時停止中セクションで**追加**を選択します。
一時停止は可逆的です。定義を削除せずに、スキルがアクティブになるのを停止します。
## システムスキルとカスタムスキル
| スキルタイプ | 典型的なアクション | 重要な制限 |
| --- | --- | --- |
| **システム** | 詳細を表示します。スキルが許可する場合のみ一時停止 | 固定システムスキルは削除を提供せず、一時停止を提供しない場合があります。 |
| **カスタム** | 編集、一時停止、再度有効化、または削除 | 削除には確認が必要であり、単に一時停止するのではなく、スキルを削除します。 |
## 状態と制限
- 追加中...はインストールがまだ実行中であることを意味します。**追加済み**を待ちます。
- 検索結果は、公開スキルディレクトリとワークスペースに既にあるスキルから取得できます。
- プランゲートはアクティベーションをブロックします。既存のスキル定義は削除しません。
- インポートされたコンテンツは、受け入れられた制限を超えるファイルを省略できます。保存する前に警告を確認してください。
- **この検索のskills.sh結果がありません**は、互換性のある発見結果が返されなかったことを意味します。追加されたスキルには影響しません。
## トラブルシューティング
- **追加**が完了しない場合は、表示されたエラーを確認した後、1回再試行してください。ボタンがビジーの間は繰り返しクリックしないでください。
- スキルを一時停止できない場合は、固定システムスキルの可能性があります。詳細を開いて確認します。
- 予想されるスキルが表示されない場合は、検索をクリアして、**追加済み**と**一時停止中**の両方を確認します。
- 新しく追加されたスキルが1つのプロジェクトで利用可能でない場合は、そのプロジェクトの**設定 → ストア → エージェント**でスキル選択を確認します。
## 関連ガイド
- [スキルを作成、インポート、および管理する](./create-import-manage-skills)
- [エージェントカスタマイズの概要](/ja/guides/agent)
- [エージェントコマンドパレットを使用する](./command-palette)
- [ストアエージェント設定](../account-and-settings/custom-scripts-and-store-agent)
---
# 分析とSEO
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo
記録された行動は**計測 → 分析**、**SEO & GEO**の概要は**成長 → SEO**から始めます。調べる内容に合わせて下のガイドを選択してください。
> **利用可能性：** **分析**はプランと記録されたストアデータに依存します。**SEO**には有料プラン（Plus以上、またはAppSumo License Tier 2・3・4）が必要です。公開ストアフロント、プロバイダーアクセス、および十分な公開データにも依存する場合があります。
| 目標 | ここから始めます |
| --- | --- |
| パフォーマンスページ全体を理解する | [分析概要](/ja/guides/analytics-and-seo/analytics-overview) |
| レポートウィンドウを変更する | [メトリックとフィルター](/ja/guides/analytics-and-seo/metrics-filters) |
| ファネルまたはカート摩擦を見つける | [トラフィックとコンバージョン](/ja/guides/analytics-and-seo/traffic-and-conversion) |
| ストアフロント可視性レビューを開始する | [SEO概要](/ja/guides/analytics-and-seo/seo-overview) |
| オーガニック検索推定値を読む | [検索パフォーマンス](/ja/guides/analytics-and-seo/search-performance) |
| リンクと技術的な問題を検査する | [バックリンクとサイト監査](/ja/guides/analytics-and-seo/backlinks-and-site-audit) |
| AI回答での可視性を理解する | [AI可視性](/ja/guides/analytics-and-seo/ai-visibility) |
| プロンプトをテストしてソースを検査する | [プロンプト、キーワード、および引用](/ja/guides/analytics-and-seo/prompts-keywords-citations) |
| 空またはブロックされたページから回復する | [データと公開のトラブルシューティング](/ja/guides/analytics-and-seo/troubleshoot-data-and-publication) |
これらのビューは利用可能なデータをレポートまたは分析します。レポートを開いてもストアフロントは変更されず、セットアップ画面はトラフィック、ランキング、またはAI言及が改善されたことの証拠ではありません。
---
# AI可視性
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/ai-visibility
AI可視性は、利用可能なAI検索データがブランド、競合他社、または公開ソースを言及しているかどうかを検査するのに役立ちます。
> **条件付き：** AI可視性は、ワークスペースアクセス、プラン、プロバイダーの利用可能性、公開ストアフロント、および十分なデータに依存する場合があります。セットアップを完了しても、言及が作成されたり、可視性が向上したりすることはありません。
## エントリパス
ストアのプロジェクト → **成長 → SEO → AIでの表示 → 開く**。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
新しいストアは公開条件を満たす必要があります。サンプルデータは説明用で、分析結果ではありません。画像は英語の画面です。
## 開始する前に
初回設定チェックリストが表示される場合は、公開の要件を満たしてからレポートを確認します。**プレビュー・サンプルデータ**の値は例であり、ストアの実績ではありません。以下は対応するレポートが利用可能になった場合の手順です。
- ストアフロントを公開し、主なSEO適格性ステップを完了します。
- Runnerが追跡する予定の公開ストアフロントドメインを検出することを確認します。セットアップは別の編集可能なブランドフィールドを提供しません。
- 関連する競合他社のみを追加して、シェアオブボイスの比較が有用なままになるようにします。
- オプションのエントリが利用可能で、それを認可したい場合にのみ、Google Search Consoleを接続します。
## コントロールとクリック結果
| コントロール | 選択後に何が起こるか |
| --- | --- |
| 検出されたストアフロント | セットアップがそのスタートターゲットとして使用する公開ストアを表示します。 |
| セットアップの競合他社フィールド | セットアップの選択肢に比較ブランドを追加します。名前を入力しても、ルックアップは実行されません。 |
| スタータープロンプトプレビュー | セットアップのプロンプトアイデアの例を表示します。それらをプレビューしても、プロンプト結果は実行または保存されません。 |
| Google Search Console → **接続** | オプションのGoogle Search Console接続用に**アプリ**を開きます。 |
| **続行** | 現在の入力が有効な場合、次のセットアップステップに進みます。 |
| **今のところスキップ** | セットアップを閉じ、ブランドルックアップを開始せず、スナップショットを作成しません。 |
| **ブランド調査を実行** | 検出されたストアフロントのAI表示を設定する3段階の画面を開きます。 |
| **セットアップを完了** | 検出されたストアフロントと競合他社の選択肢を送信し、セットアップを閉じ、ブランドルックアップを開始します。ルックアップが完了するまで、結果は保留中のままです。 |
| **Runnerにこれを修正させる** | 保存されたAI可視性証拠と推奨される改善を含む新しいRunnerの会話を開きます。ストアを編集または公開することはありません。 |
| **引用ギャップを確認** | 欠落している引用機会に焦点を当てた証拠ベースのRunnerの会話を開きます。変更を加える前に、その提案を確認してください。 |
## セットアップを完了する
1. **成長 → SEO**を開き、**AIでの表示**カードを開きます。
2. **ブランド調査を実行**を選択して設定を開きます。
3. 検出された公開ストアフロントが確認する予定のストアであることを確認します。
4. 関連する競合他社の小さなセットを追加し、**続行**を選択します。
5. 完了したテストとして扱わずに、スタータープロンプトプレビューを確認してから、続行します。
6. オプションが有用で、アカウントを接続する権限がある場合にのみ、Search Consoleを接続します。
7. **セットアップを完了**を選択して送信し、ブランドルックアップを開始します。
8. 完了した状態を待ちます。保留中の間は、重複したルックアップを開始しないでください。
9. 言及、推定AI検索ボリューム、シェアオブボイス、クエリ、および引用されたソースを一緒に読みます。
## ダッシュボードを読む
- **言及**は、追跡されたブランドを参照する利用可能な応答またはレコードをカウントします。
- **シェアオブボイス**は、利用可能なデータセット内で追跡されたブランドを比較します。インターネット全体ではありません。
- **クエリ**は、収集された結果に関連付けられた質問を表示します。
- **引用されたソース**は、利用可能な回答で参照されているページを表示し、制御していないサイトを含めることができます。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| 保留中 | ルックアップは受け入れられましたが、完了していません。再度開始する前に待ちます。 |
| 言及なしで完了 | 結果にブランドへの言及がありません。セットアップが失敗したと仮定する代わりに、クエリとソースを確認します。 |
| 失敗 | 表示されたエラーを開き、公開ターゲットを確認し、後で再試行します。 |
| プロバイダーが利用不可またはアクセスが不足している | リクエストされたモデルまたはデータソースは現在使用できません。完了したセクションを使用し、後で再試行してください。 |
| データが不足している | プロバイダーはターゲットの信頼できるビューを生成できませんでした。サイトを公開に保ち、より多くの発見可能なコンテンツを取得した後に再度訪問します。 |
## 調査を始める前に確認する
設定を開くと、検出されたストアと競合を確認できます。**設定を完了**は調査を開始し、有料の利用枠を使う場合があります。実行せずにフォームを確認するには**今はスキップ**を使用します。完了後は、対象と返された根拠を確認してからダッシュボードを解釈します。
## 関連ガイド
- [プロンプト、キーワード、および引用](./prompts-keywords-citations)
- [SEO概要](./seo-overview)
- [検索パフォーマンス](./search-performance)
---
# 分析概要
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/analytics-overview
分析は、選択したストアの訪問、買い物の行動、売上の記録を結び付けて理解するために役立ちます。
## エントリパス
ストアのプロジェクト → **計測 → 分析**。
## 開始する前に
- プランに該当のレポート機能が必要です。プランのプレビューは実測結果ではありません。
- 有意義なアクセス・売上レポートには、公開済みストアと買い物客の行動記録が必要です。
- 比較時には、ストア、期間、フィルターをそろえます。
## 表示されたレイアウトを選ぶ
**純売上**、**GMV**、**セッション**、**コンバージョン率**の下にスクロールする1ページがある場合は、下の[従来のダッシュボードの手順](#if-you-see-the-earlier-dashboard)を使用します。グループ化されたレポートナビゲーションがある場合は、次の作業画面の手順を使用します。グラフの上に**今週のレポート**と**その他のレポート**がある場合は、[そのレイアウトの手順](#if-you-see-the-sections-layout)を使用します。レイアウトごとに操作項目は異なります。
## レポートを選ぶ
**条件付き:** **ストアフロント分析**が表示される場合は、以下のグループ形式を使用します。ワークスペースによっては、後述する従来の1ページ形式が表示されます。
| 操作 | 開く内容 |
| --- | --- |
| **概要** | 選択したストアの活動概要。**詳細を見る**があれば基になるレポートを確認できます。 |
| **コマース** | コマース、ファネル、商品、獲得、目標のレポート。 |
| **行動** | ページ、イベント、経路など、対応する閲覧レポート。 |
| **オーディエンス** | 訪問者、ユーザー、セグメント、属性のレポート。 |
| **ライブページ** | 利用可能な現在の活動の表示。 |
| **設定** | 追跡などの分析設定。開くだけではイベントは作成されません。 |
| 日付選択 | 選択期間でレポートを更新します。 |
| 表示される場合の**比較** | 対応する比較期間を追加します。 |
## 最初のレポートを確認する
1. **概要**を開き、選択したストアを確認します。
2. **7d**や**30d**など、実際の活動が含まれる期間を選びます。
3. 概要を読み、**コマース**で売上とファネルを確認します。
4. 調べる内容に合う詳細レポートを開きます。例えば、購入手続きの問題を調べる前にファネルの段階を比較します。
5. データがある場合は、**行動**で対象ページや経路を確認します。
6. **概要**に戻り、詳細と全体を比較します。
**確認:** 結果の基になるレポート、期間、イベントを識別できる状態です。空のレポートだけでは、収集の動作もストアの故障も確認できません。
## その他のレポートが表示される場合 [#if-you-see-the-sections-layout]
概要には**訪問者**、**売上**、**注文**、**購入した訪問者**、**訪問者あたりの売上**、**現在オンライン**が表示され、その下に推移グラフとチャネル、商品、地域の一覧があります。期間、**日別** / **週別**、**フィルター**はその上にあります。
**その他のレポート**を選ぶと**すべてのレポート**が開き、すべてのレポートがグループ別に表示されます。
| グループ | レポート |
| --- | --- |
| **販売** | **売上**、**商品**、**ファネル**、**チャネル**、**目標**。 |
| **お客様** | **訪問者**、**お客様一覧**、**セグメント**、**ライブ**、利用できる場合は**地図**。 |
| **ストアの状態** | **ページ**、**イベント**、**速度とエラー**、**セッション**、**リプレイ**、**トラッキングの状態**。 |
| **設定** | **トラッキング**、**機能フラグ**、**カスタムダッシュボード**、**API**、**使用量**、**設定**。開いてもイベントは作成されません。 |
**ファネル**や**地図**など、レポート名で一覧を検索できます。レポートの中では、タブで同じグループのほかのレポートに切り替え、戻る矢印で概要に戻ります。
1. グラフの上の期間を確認します。
2. 上部の数値を合わせて読みます。購入率は横の訪問者数がなければあまり意味がありません。
3. 直近の 1 週間全体を見るには**今週のレポート**を選びます。デバイス別の売上、購入までの訪問回数と日数、購入の多い時間帯、上位の国が表示されます。
4. **その他のレポート**を選び、知りたいことに合うレポートを開きます。たとえば購入者の流入元は**チャネル**です。
新しいストアでは、グラフを描けるだけの人が訪れるまで**新しいストア**と訪問数が表示されます。**サンプルデータ · あなたのストアではありません**のバッジは、数値が例であり実際の結果ではないことを示します。**近日公開**と表示されたパネルにはまだデータソースがありません。ストアの問題ではありません。
## 従来のダッシュボードが表示される場合 [#if-you-see-the-earlier-dashboard]
期間を選び、**純売上**、**GMV**、**セッション**、**コンバージョン率**を合わせて読みます。商品、流入元、ファネル、離脱、返金までスクロールします。
## トラブルシューティング
| 状態 | 次の操作 |
| --- | --- |
| ダッシュ、ゼロ、空のグラフ | 任意フィルターを解除し、期間を広げ、実際の訪問や注文の存在を確認します。 |
| アップグレードの案内・プランプレビュー | 収集を調査する前に、プランと請求でアクセスを確認します。 |
| 読み込み中 | リクエストの完了を待ってから再びフィルターを変更します。 |
| 一部のレポートだけにデータがある | 各レポートに必要なイベントを確認します。注文前でも訪問は存在します。 |
| 読み込めない | 一度再読み込みし、再発したらレポート名、期間、エラーを記録します。 |
| このパネルを読み込めませんでした。 | 表示されていれば**再試行**を選び、なければページを再読み込みします。ほかのパネルには引き続きデータが表示されます。 |
| ナビゲーションに項目がない | **計測**を展開し、ワークスペースを確認します。[機能の利用可能性](../advanced/feature-availability)を参照してください。 |
## 関連ガイド
- [メトリックとフィルター](./metrics-filters)
- [トラフィックとコンバージョン](./traffic-and-conversion)
- [データと公開のトラブルシューティング](./troubleshoot-data-and-publication)
---
# バックリンクとサイト監査
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/backlinks-and-site-audit
バックリンクとサイト監査は、同じSEOワークスペースからサイト外の参照とサイト内の技術的な問題を検査するのに役立ちます。
> **条件付き：** 両方のセクションには、適格な分析ターゲットが必要です。リンクとクロールデータは不完全な場合があり、オプションのLighthouse結果は成功したページチェックに依存します。
## エントリパス
ストアのプロジェクト → **成長 → SEO → 被リンク**または**サイトの健全性**カード → **開く**。技術レポートでは**サイト監査**と表示される場合があります。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
新しいストアは公開条件を満たす必要があります。サンプルデータは説明用で、分析結果ではありません。画像は英語の画面です。
## 開始する前に
初回設定チェックリストが表示される場合は、公開の要件を満たしてからレポートを確認します。**プレビュー・サンプルデータ**の値は例であり、ストアの実績ではありません。以下は対応するレポートが利用可能になった場合の手順です。
- ストアフロントを公開し、正常に開きます。
- 初期SEO分析を完了します。
- リンクコンテキスト、技術的なクロール、またはその両方が必要かどうかを決定します。
- 自動化された問題ラベルだけからページを削除またはリダイレクトしないでください。影響を受けたページを最初に検査します。
## バックリンクコントロールと結果
| コントロールまたはセクション | 表示または実行内容 |
| --- | --- |
| **バックリンク** | 総リンク数、参照ドメイン、トップドメイン、およびトップリンク済みページを開きます。 |
| フォロー/ノーフォロービュー | プロバイダーがその情報を含める場合、リンクタイプを分離します。 |
| 新規/失われた履歴 | プロバイダーによって記録されたリンク変更を表示します。 |
| 壊れたバックリンク | 利用不可の宛先につながるように見えるリンクをリストします。 |
| スパムスコア | レビュー用のプロバイダー信号を提供します。ドメインが有害であることの証拠ではありません。 |
| **Runnerにこれらを監査させる** | 保存されたバックリンク証拠と監査リクエストを含む新しいRunnerの会話を開きます。リンクを削除したり、ストアを変更したりしません。 |
## サイト監査コントロールと結果
| コントロールまたはセクション | 表示または実行内容 |
| --- | --- |
| **新しい監査を開始** | クロールセットアップを開きます。ストアフロントを変更しません。 |
| 最大ページコントロール | 監査がクロールしようとする公開サイトの量を制限します。 |
| **Lighthouseを含める** | サポートされているパフォーマンス、アクセシビリティ、ベストプラクティス、およびSEOチェックを追加します。 |
| **監査を実行** | 設定されたクロールを開始します。 |
| **問題** | グループ化された検出結果をリストして、説明、推奨事項、および影響を受けたページを開くことができます。 |
| **ページ** | ステータス、タイトル、H1、単語数、画像数、および応答時間を含む各クロール済みURLを表示します。 |
| **Runnerにすべてを修正させる** | 保存された監査証拠と広範な修正リクエストを含む新しいRunnerの会話を開きます。ストアを編集または公開しません。 |
| 問題行 | 問題が重要な理由、推奨事項、および影響を受けたページを開きます。 |
| **Runnerで修正** | 選択された問題、影響を受けたURL、および修正リクエストを含む新しいRunnerの会話を開きます。ストアを編集または公開しません。 |
## 焦点を絞った監査を実行する
1. **サイト監査**を開きます。
2. **新しい監査を開始**を選択します。
3. 公開ストアに適切なページ制限を選択します。
4. 追加のページ品質チェックが必要な場合にのみ、Lighthouseを有効にします。
5. **監査を実行**を選択し、完了を待ちます。
6. **問題**を使用して高影響度の検出結果から始め、**ページ**を使用して影響を受けたURLとページレベルのデータを検査します。
7. 問題を開き、影響を受けたページを手動で確認します。
8. 1つの適切な検出結果に対して**Runnerで修正**を使用するか、広範なレビューリクエストに対して**Runnerにすべてを修正させる**を使用します。どちらもRunnerの会話を開き、提案された作業を受け入れたり公開したりする前に確認する必要があります。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| バックリンクなし | プロバイダーはターゲットのリンクデータを見つけませんでした。リンクが存在しないことの証拠ではありません。 |
| 失われたリンク | プロバイダーは以前のリンクを見なくなりました。アクションを実行する前に、ソースと宛先を開きます。 |
| クロール失敗 | 公開URLに到達可能であり、ブロックされていないことを確認してから、より小さな監査を実行します。 |
| Lighthouseが利用不可 | 完了したクロール結果を使用し、後でオプションのチェックを再試行します。 |
| 問題数がゼロ | この監査では一致する問題は返されませんでした。通常のストアフロント確認を続行します。 |
## 再クロールの前に既存の指摘を確認する
1. **被リンク**で利用可能なリンクと参照ドメインを確認します。
2. SEO概要に戻り、**サイトの健全性**を開きます。
3. 監査がある場合は、問題を選び、推奨事項と対象URLを読みます。
4. 対象の公開ページを開き、問題が当てはまるか確認します。
5. 修正キューがある場合は、Runnerへ渡す前に選択した修正を確認します。
**確認:** 対象URL、根拠、修正案を1つ把握できた状態です。指摘の選択や会話を開く操作だけでは、修正や公開は行われません。
## 関連ガイド
- [SEO概要](./seo-overview)
- [検索パフォーマンス](./search-performance)
- [データと公開のトラブルシューティング](./troubleshoot-data-and-publication)
---
# メトリクスとフィルター
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/metrics-filters
同じ期間とフィルターを使い、アクセス、注文、売上を適切に比較します。
## エントリパス
ストアのプロジェクト → **計測 → 分析** → レポートの操作。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEkGsXzhdR6T0uwqnz73letZimQpFvYfSrhLM)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
1ページ形式の分析の日付メニューで、過去24時間、7日間、30日間を選択します。画像は英語の画面です。
## 開始する前に
- 現在の活動、最近1週間、長期傾向のどれを調べるか決めます。
- 途中までの当日と、完了した過去の1日は直接比較できません。
- フィルターはレポートやワークスペースの分析レイアウトによって異なります。
## コントロールとクリック結果
まずレイアウトを確認します。1ページ形式では**過去24時間**、**過去7日間**、**過去30日間**を選べます。**ストアフロント分析**の作業画面では、以下を使用します。
| 操作 | 結果 |
| --- | --- |
| **今日** / **昨日** | 当日または前日を選択します。 |
| **7d** / **30d** | 直近1週間または1か月を選択します。 |
| カスタム日付 | 開始日と終了日を選択します。 |
| 表示される場合の**比較** | 比較期間を追加・解除します。 |
| 表示される場合の**セグメント** | 選択した対象者に絞り込みます。 |
| 追加フィルター | 一致するイベントや記録に制限します。質問に必要な条件だけを使い、フォームの上限を守ります。 |
従来のダッシュボードでは、代わりに**過去24時間**、**過去7日間**、**過去30日間**を選択します。
### その他のレポートの横にある操作
アナリティクスのページでグラフの上に**今週のレポート**と**その他のレポート**がある場合は、次の操作を使います。
| 操作 | 結果 |
| --- | --- |
| 期間 | **今日**、**昨日**、**過去 7 日間**、**過去 30 日間**、**過去 90 日間**、**今月**、カスタム…から選びます。矢印で前後の期間に移動します。 |
| 期間メニューの比較 | 各数値を、直前の同じ長さの期間と並べて表示します。30 日間の場合は**直前の 30 日間と比較**と表示されます。 |
| **フィルター** | **流入元**、**国**、**デバイス**、**閲覧した商品**でレポートを絞り込みます。下部のボタンに該当する訪問者数が表示されます（例：**136 人の訪問者を表示**）。選ぶとフィルターが適用されます。 |
| フィルターのチップ | 有効なフィルターは、**訪問者 136 人中 40 人を表示中**のような件数と一緒にレポートの上に表示されます。チップから外すか、**すべてクリア**を選びます。 |
| **日別** / **週別** | 推移グラフで日をまとめる単位を変えます。 |
**閲覧した商品**はその商品を見た訪問者だけを残すため、すべてのレポートがそのお客様についての内容になります。**商品**や**ライブ**など一部のレポートは期間やフィルターを使わないため、そこでは操作が表示されません。
## 期間を比較する
1. レポートを開き、1ページ形式では**過去7日間**または**過去30日間**、作業画面では**7d**、**30d**、またはカスタム日付を選択します。
2. 更新を待ち、日付表示が選択と一致することを確認します。
3. 利用可能な場合は**比較**を有効にし、比較対象期間を確認します。
4. 特定の対象者やイベントを調べる場合のみ、セグメントまたはフィルターを1つ適用します。
5. 数値を読む前に、選択条件が表示されていることを確認します。
6. 条件を解除し、比較をオフにして全体表示に戻ります。
**確認:** 表示値の対象期間と条件を説明できる状態です。両方の検索結果が空でも、フィルター解除で対象範囲は広がります。
## 指標と件数を合わせて読む
- コンバージョン率を解釈する前に、記録されたセッションと購入件数を確認します。
- GMVと純売上は別の売上指標として読みます。
- 少数のサンプルで割合が急変した場合は、追加の根拠が必要です。
- 外部サービスと比較する前に、期間の長さ、フィルター、指標の定義をそろえます。
## トラブルシューティング
| 状態 | 次の操作 |
| --- | --- |
| 期間を変えても空 | フィルターを解除し、その期間の関連活動を確認します。 |
| フィルターがない | そのレポートが対応する操作を使用します。全画面で同じ項目があるとは限りません。 |
| フィルター上限 | 不要な条件を外してから追加します。 |
| 値が予想外に変わる | 日付、セグメント、比較期間、例外的な注文や返金を確認します。 |
| 更新に失敗 | 一度再読み込みし、選択期間とエラーをサポート用に記録します。 |
## 関連ガイド
- [分析概要](./analytics-overview)
- [トラフィックとコンバージョン](./traffic-and-conversion)
- [データと公開のトラブルシューティング](./troubleshoot-data-and-publication)
---
# プロンプト、キーワード、引用
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/prompts-keywords-citations
AI可視性の詳細セクションは、どの質問があなたのブランドを表示し、どのソースが利用可能な回答をサポートするかを学ぶのに役立ちます。
> **条件付き：** Prompt Explorerとそのモデルはプランまたはプロバイダーゲートされる可能性があります。プロンプトを実行すると新しいモデル出力がリクエストされ、有料容量を使用する可能性があります。実行前に現在のワークスペース通知を確認してください。
## エントリパス
ストアのプロジェクト → **成長 → SEO → AIでの表示 → 開く → プロンプト**、**キーワード**、または**引用**。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
新しいストアは公開条件を満たす必要があります。サンプルデータは説明用で、分析結果ではありません。画像は英語の画面です。
## 開始する前に
初回設定チェックリストが表示される場合は、公開の要件を満たしてからレポートを確認します。**プレビュー・サンプルデータ**の値は例であり、ストアの実績ではありません。以下は対応するレポートが利用可能になった場合の手順です。
- AI可視性セットアップを完了します。
- 1つの焦点を絞った買い物客の質問を書きます。
- 少なくとも1つの利用可能なモデルを選択します。
- 現在の公開ソースを参照したい場合のみ、ウェブ検索を使用します。
## コントロールとクリック結果
| コントロール | 選択後の動作 |
| --- | --- |
| プロンプトフィールド | テストする質問を受け入れ、入力が長すぎる場合に警告します。 |
| モデルセレクター | リクエストする利用可能なモデル応答を選択します。 |
| **ウェブ検索を許可** | サポートされているモデルがこの実行で公開ウェブソースを参照できるようにします。 |
| ブランドハイライト | 結果ビューにどのブランド言及を呼び出すかを指示します。モデルにブランドを言及させることを強制しません。 |
| **Prompt Explorerを実行** | 選択されたモデルリクエストを開始します。ストアを編集したり、可視性の改善を保存したりしません。 |
| **プロンプト** | 追跡または探索された質問と利用可能な結果を表示します。 |
| **キーワード** | AI可視性データセットに関連する用語を表示します。 |
| **引用** | 利用可能なモデル回答で引用されたソースを表示します。 |
| **言及** | 追跡されたブランドが検出された応答またはレコードを表示します。 |
## 1つの買い物客の質問を探索する
1. **プロンプト**を開きます。
2. 買い物客が尋ねるかもしれない1つの自然言語の質問を入力します。
3. 必要な利用可能なモデルまたはモデルを選択します。
4. **ウェブ検索を許可**を有効にするかどうかを決定します。
5. オプションで、ハイライト用に追跡されたブランドを選択します。
6. **Prompt Explorerを実行**を1回選択します。
7. リクエストされた各モデルが完了するか失敗するのを待ちます。
8. 応答、**ブランドが言及されました**または**ブランドが言及されていません**の状態、引用、関連クエリを比較します。
9. **キーワード**と**引用**を開いて、繰り返されるトピックとソースを見つけます。
## 結果を安全に解釈する
- 1つの回答はサンプルであり、安定したランキングではありません。
- 「ブランドが言及されていません」はその応答を説明し、すべての可能な回答ではありません。
- 引用はモデルがソースを参照したことを意味します。Runnerがソースを支持することを意味しません。
- ウェブ検索オフとウェブ検索オンの結果は異なる質問に答え、同一のテストとして扱うべきではありません。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| 実行ボタンが無効です | 有効なプロンプトを入力し、少なくとも1つのモデルを選択します。 |
| 1つのモデルが失敗します | 完了したモデル結果を使用し、後で失敗したプロバイダーを再試行します。 |
| 引用がありません | 回答は公開ソースを使用または返さなかった可能性があります。目標に合う場合のみウェブ検索で再試行します。 |
| 無関係な結果 | プロンプトを製品、対象者、または購入ニーズについてより具体的にします。 |
| プロバイダーアクセスエラー | 利用可能なモデルを選択するか、ワークスペース所有者にアクセスについて尋ねます。 |
## まず保存された根拠を確認する
1. SEO概要から**AIでの表示**を開き、**引用**を選択します。
2. 利用可能な出典と対応する回答を確認し、リンクがあれば開きます。
3. Runnerに戻り、出典を関連するプロンプトやキーワードと比較します。
4. 保存済みの調査で疑問が解決しない場合のみ、**プロンプトエクスプローラー**を新たに実行します。
**確認:** 指摘の基になる回答と引用ページを特定できる状態です。保存済みブランド調査と新規プロンプト実行は別のサンプルです。保存された根拠を開いても再実行されません。
## 関連ガイド
- [AI可視性](./ai-visibility)
- [検索パフォーマンス](./search-performance)
- [データと公開のトラブルシューティング](./troubleshoot-data-and-publication)
---
# 検索パフォーマンス
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/search-performance
検索パフォーマンスは、Runnerが利用可能なデータで最も重要と思われるクエリとページを特定するのに役立ちます。
> **条件付き：** これらの推定値は、適格なSEO分析がプロバイダーデータを返した後にのみ表示されます。新しいドメインまたはトラフィックが少ないドメインはデータがほとんどまたはまったくない可能性があります。
## エントリパス
ストアのプロジェクト → **成長 → SEO → 検索パフォーマンス**カード → **開く**。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
新しいストアは公開条件を満たす必要があります。サンプルデータは説明用で、分析結果ではありません。画像は英語の画面です。
## 開始する前に
初回設定チェックリストが表示される場合は、公開の要件を満たしてからレポートを確認します。**プレビュー・サンプルデータ**の値は例であり、ストアの実績ではありません。以下は対応するレポートが利用可能になった場合の手順です。
- 公開ターゲットに対して正常なSEO分析を完了します。
- Runnerが表示する分析されたドメインを使用します。特にプロジェクトが複数のドメインを持つ場合。
- プロバイダー推定値を方向性のあるシグナルとして読みます。最初のパーティ分析と正確に一致しない可能性があります。
## メインセクション
| セクション | 意味 |
| --- | --- |
| 推定オーガニックトラフィック | 無料検索からのアクセスのプロバイダー推定値。 |
| オーガニックキーワード | ドメインが利用可能な可視性データを持つ検索用語。 |
| ドメインランク | 利用可能なプロバイダーからの比較権限または可視性測定。 |
| トップ3キーワード | 検索結果の上位付近にランクされていると推定されるキーワード。 |
| **トップキーワード** | 利用可能なポジションまたはトラフィック情報を持つクエリ。 |
| **トップページ** | 最も強い推定オーガニック可視性を受け取っている公開ページ。 |
| **Runnerに質問** | 保存されたレポート証拠と提案された改善リクエストを含む新しいRunner会話を作成します。ストアを編集または公開しません。 |
| **5つのクイックウィンを見る** | 同じ証拠に基づいたRunner引き渡しを作成して、チャットで優先順位付けされた機会を尋ねることができます。提案された作業を適用または公開する前に確認してください。 |
| **再度分析** | 新しいスナップショットをリクエストします。コンテンツやランキングは変更しません。 |
## 検索機会を確認する
1. 分析が完了した後、**検索パフォーマンス**を開きます。
2. 分析されたドメインが意図した公開ストアフロントであることを確認します。
3. 概要メトリクスを約束ではなくベースラインとして読みます。
4. **トップキーワード**をスキャンして、製品と対象者に一致する用語を探します。
5. 対応する**トップページ**を開くか、メモします。
6. ページコンテンツを各有用なキーワードの背後にある買い物客の質問と比較します。
7. Runnerまたはストアエディターを通じてストアフロント変更を行い、別途公開します。
8. 十分な時間が経過して公開ソースが変更された場合、後で戻って**再度分析**を選択します。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| オーガニックデータなし | プロバイダーがドメインに十分な情報を持たない可能性があります。公開を確認して、後で再度試してください。 |
| キーワードはあるが一致するページがない | ページリストと公開サイトを開きます。プロバイダーはクエリを別のURLに属性付けする可能性があります。 |
| 推定値が分析と異なります | 分析はストアイベントを記録します。SEOは外部検索推定値を使用します。比較する前に質問を調整します。 |
| 新しく公開されたコンテンツが見つかりません | 検索発見は即座ではありません。ページが公開されていることを確認して、更新する前に待ちます。 |
## 確認できる改善を1つ選ぶ
レポートの**キーワード**と**ページ**で、有用な検索語と公開ページを結び付けます。**修正キューを開く**がある場合は、Runnerで作業を始める前に修正案と対象ページを確認します。
**確認:** 検索語、ページ、変更案を説明できる状態です。外部の検索数値は推定値です。任意のGoogle Search Console接続から実際のクリックを取得できる場合がありますが、自動接続ではなく、推定値とも異なります。
## 関連ガイド
- [SEO概要](./seo-overview)
- [バックリンクとサイト監査](./backlinks-and-site-audit)
- [トラフィックとコンバージョン](./traffic-and-conversion)
---
# SEO概要
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/seo-overview
SEOは、公開ストアフロントが検索結果とAI生成回答でどのように発見されるかを検査するのに役立ちます。
## エントリパス
ストアのプロジェクト → **成長 → SEO**。**SEO & GEO**概要から各レポートを開きます。
## SEOを初めて開く場合
初回ツアーは画面の使い方を説明します。**ツアーをスキップ**で概要を開けます。新しいストアの**ストアを見つけてもらいましょう**には、ストア公開、自動AIチェック、自動キーワード追跡の3段階があります。公開要件から始めます。
**プレビュー・サンプルデータ**はレポート形式の例であり、ストアの実測値ではありません。以下の手順は、必要な設定が完了して実際の結果がある場合に使用します。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
新しいストアは公開条件を満たす必要があります。サンプルデータは説明用で、分析結果ではありません。画像は英語の画面です。
## 開始する前に
- ワークスペースで適格なカスタムターゲットを提供していない限り、ストアフロントを公開します。
- 分析を開始する前に、公開ページが読み込まれることを確認します。
- 新しく公開されたサイトについて検索およびAIプロバイダーがデータを持つまで時間を許可します。
- 分析をランキングまたは言及の保証ではなく、利用可能なソースのスナップショットとして扱います。
## メインコントロールとクリック結果
| コントロール | 選択後の動作 |
| --- | --- |
| 概要のレポートカード → **開く** | **検索パフォーマンス**、**AIでの表示**、**被リンク**、**サイトの健全性**を開きます。 |
| 表示される修正キューや確認パネル | 作業前に修正案と対象ページを確認できます。 |
| **検索パフォーマンス** | オーガニックトラフィック、キーワード、ランク、トップキーワード、トップページの推定値を開きます。 |
| **バックリンク** | リンク、参照ドメイン、リンク履歴、リンク品質ビューを開きます。 |
| **サイト監査** | 技術的なクロールと問題結果を開きます。 |
| AI可視性セクション | 利用可能な場合、ダッシュボード、プロンプト、キーワード、引用、または言及を開きます。 |
| **分析** | 適格なターゲットの分析を開始します。ストアフロントを編集または公開しません。 |
| **再度分析** | 更新された分析をリクエストし、更新が完了したら古い結果を置き換えます。 |
| **公開** | ストアがまだドラフトの場合、別の公開準備パスを開始します。 |
| Google Search Console → **接続** | その接続が利用可能な場合、Google Search Consoleでフィルターされたアプリを開きます。 |
## SEOレビューを開始する
1. **成長 → SEO**を開き、概要の対象を確認します。
2. 公開ゲートが表示される場合は、公開パスを使用して、ライブURLが機能した後にのみ戻ります。
3. まず既存のレポートを読みます。新しい分析が必要な場合のみ、現在の利用量の案内を確認して**分析**を選択します。
4. 分析状態が完了するまで待ちます。同じ分析を繰り返し開始しないでください。
5. **検索パフォーマンス**、**被リンク**、**サイトの健全性**のカードでレポートを確認します。
6. 概要に戻り、**AIでの表示**の詳細セクションを確認します。
7. 意味のある公開変更後、またはRunnerが結果を古いとマークした場合は、**再度分析**で再実行します。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| 公開ゲート | 現在のストアフロントは公開分析に適格ではありません。公開して、ライブURLを確認してから戻ります。 |
| 分析中 | Runnerは利用可能なデータを収集しています。完了を待ちます。 |
| 更新済み | 表示されたスナップショットは正常に完了しました。 |
| 古い | 公開データが変更された可能性があります。更新が有用な場合は**再度分析**を使用します。 |
| 部分的な結果 | 一部のプロバイダーはデータを返し、他は返しませんでした。利用可能なセクションを使用して、後で失敗したセクションのみを再試行します。 |
| ターゲットに到達できません | アナライザーは公開ページを読み込めませんでした。公開URLを直接開き、アクセスまたは公開の問題を修正してから、再度分析します。 |
## 関連ガイド
- [検索パフォーマンス](./search-performance)
- [バックリンクとサイト監査](./backlinks-and-site-audit)
- [AI可視性](./ai-visibility)
- [データと公開のトラブルシューティング](./troubleshoot-data-and-publication)
---
# トラフィックとコンバージョン
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/traffic-and-conversion
トラフィックとコンバージョンビューは、買い物客がどこに到着し、どこまで進行し、どこでジャーニーが注意を必要とするかを確認するのに役立ちます。
## エントリパス
ストアのプロジェクト → **計測 → 分析 → 概要**、**コマース**、または**行動**。従来のダッシュボードでは概要カードの下へスクロールします。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgvR648EFhEHcK82Y0dyL6sSr9NUGjnQeMWZJk)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
アクティビティ未記録のストアの1ページ形式の分析です。Alpha診断のイラストはストアの問題の根拠ではありません。画像は英語の画面です。
## 開始する前に
- 1つの時間範囲を選択し、セクションを比較する際はアクティブに保ちます。
- ストアはトラフィック分析のために記録されたセッションが必要であり、売上または払い戻し分析のために注文が必要です。
- ファネルを買い物客が去った理由の証拠ではなく、検査する場所の証拠として使用します。
## 質問に合うレポートを開く
1ページ形式では期間を固定し、**トラフィックセッション**、流入元、売上推移、ファネル、離脱、返金へスクロールします。以下のグループ形式の入口は、分析作業画面がある場合のみ使用します。
| 調べる内容 | 作業画面の場所 |
| --- | --- |
| 買い物がどこで止まったか | **コマース** → ファネルレポート |
| 貢献した商品や流入元 | **コマース** → 商品または獲得レポート |
| 確認すべきページや経路 | **行動** → ページまたは経路レポート |
概要の**詳細を見る**が該当レポートにつながる場合は使用します。利用可能性とデータはストアによって異なります。
アナリティクスのページでグラフの上に**今週のレポート**と**その他のレポート**がある場合は、**その他のレポート**から次のレポートを開きます。
| 知りたいこと | レポート |
| --- | --- |
| 買い物はどこで止まったか | **ファネル** |
| どのチャネルとキャンペーンが購入者を連れてきたか | **チャネル**。**最後のクリック**と**最初の訪問**を切り替えて、どの訪問が成果になるかを比べます。 |
| どの商品が、どこから売れているか | **商品**。商品を選ぶと、流入元、地域、一緒に買われた商品が表示されます。 |
| どの流入元と入口ページが訪問を注文につなげているか | **訪問者**。各流入元の購入率を訪問数と合わせて読みます。 |
| 購入者はどこに住んでいるか | **地図** |
| 人はどのページで離れるか | **ページ** → **離脱ページ** |
## セクションとクリック結果
| セクションまたはコントロール | 表示または実行内容 |
| --- | --- |
| **トラフィックセッション** | 選択された期間のアクセストレンドを表示します。 |
| 売上ソースビュー | ソースデータが利用可能な場合、記録された売上をソース別に分類します。 |
| 製品純売上ビュー | 純売上への製品貢献を比較します。 |
| **コンバージョン率**ファネル | **トラフィック**、**カートに追加**、**チェックアウト**、**購入**を通じた進行を表示します。 |
| **ショッピングカート放棄率** | 完了した購入に到達しなかったカートを要約します。 |
| **払い戻し率** | レポート期間の払い戻されたアクティビティを表示します。 |
| 時間範囲セレクター | 新しい期間のすべてのセクションを再計算します。 |
## コンバージョン低下を診断する
1. 1ページ形式ではファネルまでスクロールし、作業画面では該当の**コマース**レポートを開きます。十分なセッションがある期間を選びます。データがない場合は、コンバージョンを診断する前に収集と期間を確認します。
2. トラフィックが上昇、低下、または安定したかどうかを確認します。
3. トラフィックソースを比較して、ミックスが変更されたかどうかを確認します。
4. 隣接するファネルステージ間の最大低下を見つけます。
5. **トラフィック→カートに追加**が低下する場合、製品情報、価格設定、信頼、製品ページの明確さを検査します。
6. **カートに追加→チェックアウト**が低下する場合、カートコスト、配送の明確さ、チェックアウトへのルートを検査します。
7. **チェックアウト→購入**が低下する場合、不要な実際の注文を配置せずに支払いとチェックアウトパスをテストします。
8. 払い戻しを別途確認して、購入後の問題がトップラインの売上内に隠されないようにします。
**確認:** 変更提案の前に、段階、ページ、期間、根拠の件数を示します。対象のストアページで仮説を検証してください。ファネルは確認場所を示しますが、減少の原因までは証明しません。
## トラブルシューティング
| 状態 | 意味と次のステップ |
| --- | --- |
| ファネルステージがゼロです | 選択された範囲でそのステージに到達した一致するイベントがありません。安全なストアフロント操作で追跡を確認します。 |
| トラフィックは存在するが売上はありません | ストアは記録された購入なしでアクセスを受け取りました。最初の大きなファネル低下を検査します。 |
| 売上は存在するがソースは空白です | ソース属性はそれらの売上に対して利用できませんでした。推測でソースを割り当てないでください。 |
| 払い戻し率が急激に変更されます | 結論を引き出す前に、基礎となる注文期間と注文数を確認します。 |
| チャートが別のサービスと一致しません | 合計を比較する前に、日付範囲、タイムゾーン、イベント定義、フィルターを調整します。 |
## 関連ガイド
- [メトリクスとフィルター](./metrics-filters)
- [分析概要](./analytics-overview)
- [検索パフォーマンス](./search-performance)
---
# データと公開のトラブルシューティング
Source: https://www.runnerai.com/docs/ja/guides/analytics-and-seo/troubleshoot-data-and-publication
このページを使用して、欠落した結果がストア状態、日付範囲、プランアクセス、機能アクセス、または外部データソースから来ているかどうかを特定します。
## エントリパス
- ストアイベント: プロジェクト → **計測 → 分析**。
- 公開検索とAI表示: プロジェクト → **成長 → SEO**。
[](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgGWQf4eTjKSvqNCku6G2oLnTm47agxUZ0wt1A)
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
公開条件を満たしていないため、SEOレポートがありません。サンプルデータは分析完了の結果ではありません。画像は英語の画面です。
## 開始する前に
- 正確なページ、ストア、選択された期間、表示されたメッセージをメモします。
- 問題が1つのセクションまたはページ全体に影響するかどうかを確認します。
- SEOの場合、別の分析を開始する前に、公開ストアフロントを直接開きます。
- 分析の場合、選択された期間が予想されるイベントを含む可能性があることを確認します。
## コントロールとクリック結果
| コントロール | 選択後の動作 |
| --- | --- |
| 分析の時間範囲 | 選択された期間のレポートを更新します。欠落したトラフィックまたは注文イベントは作成しません。 |
| **分析** | 現在の公開ターゲットで利用可能なSEOまたはAI可視性分析を開始します。 |
| **再度分析** | 意味のある公開サイト変更後に新しいスナップショットをリクエストします。 |
| **再試行** | 提供される場合、失敗したセクションまたはリクエストを繰り返します。公開、アクセス、またはプロバイダーの前提条件は修正しません。 |
## トラブルシューティング
| 表示内容 | 可能性のある意味 | 次のステップ |
| --- | --- | --- |
| アップグレードまたはプラン画面 | 現在のプランはページを含みません。 | プランアクセスを確認します。繰り返しの再読み込みはロック解除しません。 |
| ナビゲーションエントリが見つかりません | 機能はこのワークスペースで有効になっていません。 | 条件付きとして扱い、ワークスペース所有者またはサポートに尋ねます。 |
| **ストアフロントを公開して分析を開始** | SEOに適格な公開ターゲットがありません。 | 公開を完了し、ライブURLを開いてから、SEOに戻ります。 |
| 分析ダッシュ、ゼロ、または空のチャート | 選択された期間に一致するイベントが存在しません。 | より長いウィンドウを試して、ストアにアクセスまたは注文があることを確認します。 |
| 訪問数と一緒に**新しいストア**が表示される | 数値に意味が出るだけの人が訪れると、グラフが表示されます。 | ストアのリンクを共有します。残りの訪問数が表示されます。 |
| **サンプルデータ · あなたのストアではありません** | ページには例の数値が表示されており、実際の結果ではありません。 | **サンプルデータを見る**を選んだ場合は、**プロジェクトデータに戻る**を選びます。**Proにアップグレード**が表示される場合はプランにこのレポートが含まれていないため、アップグレードする