---
title: "Academy App"
canonical_url: "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen"
locale: de
meta:
"og:title": "Academy App"
---
[Zur Startseite](https://academy.laioutr.com/)
- [Apps](https://academy.laioutr.com/bereiche/apps)
- [Suche und Empfehlungen](https://academy.laioutr.com/leitfaeden/suche-und-empfehlungen)
- [Battery Included: Suche und Empfehlungen anbinden](https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen)
# Battery Included: Suche und Empfehlungen anbinden
Die App Battery Included liefert Volltextsuche, Suchvorschläge und Produktempfehlungen aus einer BatteryIncluded-Collection in die Storefront. Benötigt werden die Collection-ID, ein API-Key und eine Commerce-App wie Shopify für die Produktdaten.
## Bevor du startest
- Tarif
- Laioutr Commerce (Growth oder höher) und ein eigenes BatteryIncluded-Konto
- Rolle
- Developer-Rolle in der Umgebung, um Einstellungen in Configuration zu speichern
- Dauer
- 8 Min.
### Voraussetzungen
- BatteryIncluded-Collection, die den Katalog indexiert
- API-Key dieser Collection
- Installierte und konfigurierte Commerce-App, z. B. Shopify
- Produkt-IDs in BatteryIncluded passen zu den IDs der Commerce-App
Zuletzt geprüft am 15. Oktober 2026
Liefert Volltextsuche mit Filtern und Sortierung, Suchvorschläge während der Eingabe und Produktempfehlungen aus BatteryIncluded. Die Produktdaten zu den Treffern lädt Orchestr aus der Commerce-App.
[Entwicklerdokumentation](https://docs.laioutr.com/apps/app-docs/battery-included)
## So funktioniert es
1. Collection anlegen und Katalog indexierenWo: BatteryIncluded-Dashboard · Rolle: E-Commerce-Team oder Developer · Dauer: 30 min
2. Collection-ID und API-Key kopierenWo: BatteryIncluded-Dashboard · Rolle: Developer · Dauer: 2 min
3. App installierenWo: Cockpit, Apps · Rolle: Developer · Dauer: 2 min
4. collection und apiKey eintragen, Verbindung testen, speichernWo: Cockpit, Configuration · Rolle: Developer · Dauer: 5 min
5. Deployment startenWo: Cockpit, Deployments · Rolle: Developer · Dauer: 5 min
6. Suche, Vorschläge und Empfehlungen prüfenWo: Studio und Storefront · Rolle: Content Manager · Dauer: 10 min
## Konfiguration
| Feld | Zweck | Woher | Pflicht | Pro Environment |
| --- | --- | --- | --- | --- |
| `baseURL` | Adresse der BatteryIncluded API. | Standardwert https://api.batteryincluded.io, nur bei abweichender Adresse ändern. | Nein | Ja |
| `collection` | Kennung der Collection, die den Katalog enthält. Die Kennung steht in jedem API-Pfad. | BatteryIncluded-Dashboard, Collection-Einstellungen | Ja | Ja |
| `apiKey` | API-Key für die Anmeldung bei BatteryIncluded. Wird nur auf dem Server verwendet und verschlüsselt gespeichert. | BatteryIncluded-Dashboard, Zugangsdaten der Collection | Ja | Ja |
## Häufige Fehler
- Die Suche liefert keine Treffer.
- **Ursache:** Die Collection-ID ist falsch, die Collection ist leer oder der API-Key hat keinen Zugriff.
- **Lösung:** collection und apiKey in Configuration prüfen, Test connection ausführen und die Indexierung in BatteryIncluded kontrollieren.
- Treffer oder Empfehlungen erscheinen ohne Bild, Name oder Preis.
- **Ursache:** Die Produkt-IDs in BatteryIncluded passen nicht zu den IDs der Commerce-App.
- **Lösung:** IDs in der Collection auf das Format der Commerce-App umstellen und neu indexieren.
- Geänderte Einstellungen wirken nicht.
- **Ursache:** Die Werte sind gespeichert, aber noch nicht deployt.
- **Lösung:** Unter Deployments ein neues Deployment starten.
- Ergebnisse erscheinen in der falschen Sprache.
- **Ursache:** Die Collection enthält die Sprache der Storefront nicht.
- **Lösung:** Die fehlende Sprache in BatteryIncluded ergänzen und neu indexieren.
**Battery Included** ist eine App für Suche und Empfehlungen. Das Paket `@laioutr-app/battery-included` verbindet die Storefront mit der BatteryIncluded API und liefert drei Funktionen: Volltextsuche mit Filtern, Sortierung und Seitenwechsel, Suchvorschläge während der Eingabe und Produktempfehlungen, etwa „ähnliche Produkte“ oder „wird oft zusammen gekauft“.
BatteryIncluded indexiert den Katalog, die Produktdaten selbst kommen weiter aus der Commerce-App, zum Beispiel Shopify. Die App liefert Treffer und Empfehlungen als Produkt-IDs, Orchestr lädt dazu die vollständigen Produktdaten aus dem Commerce-Backend. Deshalb müssen die IDs in BatteryIncluded zu denen der Commerce-App passen.
Warenkorb, Navigation und Kategorien liefert Battery Included nicht. Suchvorschläge laufen nach anderen Quellen und lassen sich so mit Vorschlägen anderer Apps kombinieren. Die App setzt keine Cookies. Die Sprache jeder Anfrage folgt der Sprache der Storefront, die Collection muss diese Sprachen enthalten.
## Schritt für Schritt
1. 1 ### Schritt 1: Collection vorbereiten
Im BatteryIncluded-Konto eine Collection anlegen, die den Katalog der Commerce-App indexiert. Collection-ID und API-Key notieren.
2. 2 ### Schritt 2: App installieren
Im Projekt **Apps** öffnen, Battery Included im Tab **Search** suchen und **Install** wählen.
3. 3 ### Schritt 3: Zugangsdaten eintragen
Im Menü der Umgebung **Configuration** öffnen und Battery Included wählen. `collection` und `apiKey` eintragen, `baseURL` nur bei einer abweichenden API-Adresse ändern.
4. 4 ### Schritt 4: Verbindung testen und speichern
Mit **Test connection** prüfen, ob die Werte funktionieren, dann **Save settings** wählen.
5. 5 ### Schritt 5: Deployment starten
Unter **Deployments** mit **Deploy** ein neues Deployment starten. Gespeicherte Einstellungen wirken erst mit dem nächsten Deployment.
6. 6 ### Schritt 6: Suche und Empfehlungen in Studio prüfen
In Studio die Suchergebnisseite und eine Produktseite öffnen. Treffer, Vorschläge und Empfehlungen erscheinen in der Vorschau mit echten Produktdaten.
## Ergebnis prüfen
Auf der Storefront einen Suchbegriff eingeben: Während der Eingabe erscheinen Vorschläge, die Ergebnisseite zeigt Treffer mit Filtern und Sortierung. Auf einer Produktseite erscheinen Empfehlungen mit Bild, Name und Preis aus der Commerce-App.
## Häufige Fragen
Ersetzt Battery Included die Commerce-App?
Nein. Battery Included liefert nur Suche, Vorschläge und Empfehlungen. Produktdaten, Warenkorb und Kategorien kommen weiter aus der Commerce-App.
Warum erscheinen Treffer ohne Produktdaten?
Die Produkt-IDs in der Collection passen nicht zu den IDs der Commerce-App. Die IDs in BatteryIncluded auf das Format der Commerce-App ausrichten, etwa die Shopify-ID oder die SKU.
Ist der API-Key im Browser sichtbar?
Nein. Der API-Key wird nur auf dem Server verwendet. Cockpit speichert ihn verschlüsselt und zeigt danach nur die letzten vier Zeichen.
Braucht Battery Included einen Eintrag im Consent-Banner?
Die App selbst setzt keine Cookies, alle Anfragen laufen ohne Besucherkennung. Die Einordnung für die Datenschutzerklärung prüft das Datenschutzteam.
## Passend dazu
- [Apps finden, installieren und konfigurieren](https://academy.laioutr.com/artikel/apps-finden-installieren-und-konfigurieren)6 Min.
Apps stehen im Cockpit unter Apps als Katalog bereit, werden je Umgebung installiert und unter Configuration eingerichtet. Die Storefront nutzt sie ab dem nächsten Deployment.
- [Zugangsdaten eintragen und Verbindung testen](https://academy.laioutr.com/artikel/zugangsdaten-eintragen-und-verbindung-testen)5 Min.
Zugangsdaten einer App werden je Umgebung unter Configuration eingetragen, mit Test connection geprüft und mit Save settings gespeichert. Wirksam werden sie mit dem nächsten Deployment.
- [Suche und Suchergebnisseite einrichten](https://academy.laioutr.com/artikel/suche-und-suchergebnisseite-einrichten)6 Min.
Die Suche besteht aus dem Suchfeld mit Vorschlägen im Shop-Header und der Suchergebnisseite mit Suchbegriff, Trefferzahl, Filtern und Produktraster. Vorschläge und Treffer liefert die Such- oder Commerce-App über Orchestr, die Qualität der Suche hängt also vom angebundenen Suchdienst ab.
- [Shopify anbinden](https://academy.laioutr.com/apps/shopify-anbinden)10 Min.
Die Shopify-App verbindet einen Shopify-Shop über Storefront API, Customer Account API und Admin API mit Laioutr. Produkte, Kollektionen, Warenkorb, Menüs, Inhalte und Kundenlogin kommen direkt aus Shopify.
- [Nimstrata: KI-Suche und Empfehlungen über die Google Retail API](https://academy.laioutr.com/apps/nimstrata-ki-suche-und-empfehlungen-google-retail)10 Min.
Die App Nimstrata verbindet die Storefront über Retail Connect mit der Google Retail API: KI-gestützte Suche, Kategorielisten, Suchvorschläge, Empfehlungen und Event-Tracking. Voraussetzung sind ein Nimstrata-Projekt mit Katalog und die Shopify-App im selben Projekt.
## [Suche und Empfehlungen](https://academy.laioutr.com/leitfaeden/suche-und-empfehlungen)
In diesem Leitfaden suchen
1. [Battery Included: Suche und Empfehlungen anbinden](https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen)8 Min.
2. [Nimstrata: KI-Suche und Empfehlungen über die Google Retail API](https://academy.laioutr.com/apps/nimstrata-ki-suche-und-empfehlungen-google-retail)10 Min.
## Structured Data
```json
{
"@context": "https://schema.org",
"@graph": [
{
"@id": "https://academy.laioutr.com/#website",
"@type": "WebSite",
"inLanguage": "de",
"name": "Default",
"url": "https://academy.laioutr.com/",
"workTranslation": {
"@id": "https://academy.laioutr.com/#website"
}
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#webpage",
"name": "Academy App",
"url": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen",
"@type": [
"WebPage",
"FAQPage"
],
"breadcrumb": {
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#breadcrumb"
},
"isPartOf": {
"@id": "https://academy.laioutr.com/#website"
},
"mainEntity": [
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/1"
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/2"
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/3"
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/4"
}
],
"potentialAction": [
{
"@type": "ReadAction",
"target": [
"https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen"
]
}
]
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#breadcrumb",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"name": "Home",
"item": "https://academy.laioutr.com/",
"position": 1
},
{
"@type": "ListItem",
"name": "Apps",
"item": "https://academy.laioutr.com/bereiche/apps",
"position": 2
},
{
"@type": "ListItem",
"name": "Suche und Empfehlungen",
"item": "https://academy.laioutr.com/leitfaeden/suche-und-empfehlungen",
"position": 3
},
{
"@type": "ListItem",
"name": "Battery Included: Suche und Empfehlungen anbinden",
"item": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen",
"position": 4
}
]
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/1",
"@type": "Question",
"inLanguage": "de",
"name": "Ersetzt Battery Included die Commerce-App?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Nein. Battery Included liefert nur Suche, Vorschläge und Empfehlungen. Produktdaten, Warenkorb und Kategorien kommen weiter aus der Commerce-App.
"
}
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/2",
"@type": "Question",
"inLanguage": "de",
"name": "Warum erscheinen Treffer ohne Produktdaten?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Die Produkt-IDs in der Collection passen nicht zu den IDs der Commerce-App. Die IDs in BatteryIncluded auf das Format der Commerce-App ausrichten, etwa die Shopify-ID oder die SKU.
"
}
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/3",
"@type": "Question",
"inLanguage": "de",
"name": "Ist der API-Key im Browser sichtbar?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Nein. Der API-Key wird nur auf dem Server verwendet. Cockpit speichert ihn verschlüsselt und zeigt danach nur die letzten vier Zeichen.
"
}
},
{
"@id": "https://academy.laioutr.com/apps/battery-included-suche-und-empfehlungen#/schema/question/4",
"@type": "Question",
"inLanguage": "de",
"name": "Braucht Battery Included einen Eintrag im Consent-Banner?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Die App selbst setzt keine Cookies, alle Anfragen laufen ohne Besucherkennung. Die Einordnung für die Datenschutzerklärung prüft das Datenschutzteam.
"
}
}
]
}
```