Shop-Integrationen
Die Endpunkte hinter der App LLM Pulse für Shopify: einen Shop seinem Projekt zuordnen, über KI-Assistenten vermittelte Bestellungen des Shops übermitteln und wieder abrufen sowie Katalogprodukte in Prompts mit Kaufabsicht für das Tracking umwandeln. Da sie einen API-Schlüssel erfordern, sind sie ab Tarif Scale verfügbar. Für Konten mit einem White-Label-Portal oder einer Einbettung stehen sie nicht zur Verfügung; diese Konten erhalten ERR_INTEGRATION_UNAVAILABLE (403).
GET/store_connection
Teilt einer Shop-App mit, ob das Konto des API-Schlüssels sie nutzen kann und zu welchem Projekt der Shop gehört. project ist das bestehende Projekt, dessen Domain der Domain des Shops entspricht, andernfalls eines, dessen Domain eine übergeordnete Domain oder eine Subdomain davon ist, andernfalls null. Passen mehrere bestehende Projekte gleich gut, ist project gleich null und ambiguous gleich true. candidates listet alle bestehenden Projekte des Kontos auf, damit die App eine Auswahl anbieten kann. Dieser Endpunkt erwartet keinen Parameter project_id.
platformerforderlich,shopifydomainerforderlich, die Domain des Shops, mit oder ohne URL-Schema
GET/ai_orders
Liefert die über KI vermittelten Bestellungen, die eine Shop-App für ein Projekt übermittelt hat: Gesamtwerte, eine Zeile pro KI-Assistent und eine tägliche Zeitreihe. Jeder Wert von revenue ist eine Dezimalzahl als Zeichenfolge in der Währung aus dem Feld currency, das null ist, wenn im Zeitraum keine Bestellung gespeichert ist. Teammitglieder benötigen die Berechtigung „Lesen“ für KI-Traffic.
- Parameter:
project_id(erforderlich),platform(Standard:shopify),from/to(JJJJ-MM-TT; Standard: die 90 Tage bis heute; höchstens 400 Tage).
GET/catalog_prompt_suggestions
Listet die aus einem Shop-Katalog vorgeschlagenen Prompts mit Kaufabsicht auf, die ältesten zuerst, jeweils mit Status und dem Produkt, aus dem der Vorschlag stammt. Teammitglieder benötigen die Berechtigung „Lesen“ für Prompts.
project_iderforderlichstatuspending|accepted|rejectedproduct_external_idpageper_pageStandard: 50, maximal 100
PUT/ai_orders
Ersetzt die täglichen über KI vermittelten Bestellungen und Umsätze eines Zeitraums. Senden Sie als referrer den unveränderten verweisenden Host oder die utm_source des ersten Besuchs jeder Bestellung: LLM Pulse klassifiziert den Wert und ignoriert alles, was kein KI-Assistent ist. Die Antwort nennt die Anzahl der gespeicherten Zeilen (stored) und der ignorierten Einträge (ignored). Jede gespeicherte Zeile dieses Projekts und dieser Plattform zwischen from und to wird ersetzt. Wenn Sie denselben Zeitraum erneut übermitteln, bleibt das Ergebnis daher gleich, und nichts wird doppelt gezählt. Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Aktualisieren“ für KI-Traffic.
- Anfragetext (JSON):
project_id(erforderlich),platform(erforderlich,shopify),currency(erforderlich, ISO 4217),fromundto(erforderlich, JJJJ-MM-TT, höchstens 400 Tage),days(erforderlich, bis zu 400 Einträge mitday,referrer,ordersundrevenue).
POST/catalog_prompt_suggestions
Generiert Prompts mit Kaufabsicht für bis zu 20 Katalogprodukte und speichert sie als ausstehende Vorschläge in der Warteschlange „Vorgeschlagene Prompts“ des Projekts. data enthält nur die neuen Vorschläge, und skipped zählt die Prompts, die das Projekt bereits als Vorschlag hatte. Der Endpunkt nutzt dasselbe stündliche Kontingent für Prompt-Vorschläge wie die App (ERR_QUOTA_EXCEEDED, sobald es aufgebraucht ist). Schlägt die Generierung fehl, wird ERR_GENERATION_FAILED (502) zurückgegeben, und die Anfrage kann wiederholt werden. Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Erstellen“ für Prompts.
- Anfragetext (JSON):
project_id(erforderlich),platform(erforderlich,shopify),products(erforderlich, 1 bis 20 Objekte;external_idundtitleerforderlich,handle,product_type,vendor,tags,collectionsundurloptional),country_codeundlanguage_code(Standard: die Werte des Projekts).
POST/catalog_prompt_suggestions/accept
Startet das Tracking ausstehender Vorschläge: Aus jedem Vorschlag wird ein Prompt, der einer Collection mit dem Namen seines Produkts zugeordnet wird. Vorschläge, die nicht mehr ausstehen, kommen in skipped zurück, mit ihrem Status als Grund. Würden die neuen Prompts das Prompt-Limit des Tarifs überschreiten, gibt der Aufruf ERR_LIMIT_REACHED zurück und übernimmt keinen Vorschlag. Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Erstellen“ für Prompts.
project_iderforderlichidserforderlich, bis zu 100 IDs von Vorschlägen, alle für dasselbe Land und dieselbe Sprache
POST/catalog_prompt_suggestions/reject
Markiert ausstehende Vorschläge als abgelehnt. Vorschläge, die nicht mehr ausstehen, bleiben unverändert, und rejected zählt die geänderten Vorschläge. Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Aktualisieren“ für Prompts.
project_iderforderlichidserforderlich, bis zu 100 IDs von Vorschlägen