Skip to main content
Diese Anleitung erklärt, wie Sie Produktkollektionen mithilfe der Product Recommendation API abrufen können, ohne das Kameleoon-HTML-Element einzubetten. Verwenden Sie den folgenden Endpoint:

Warum die API verwenden?

Verwenden Sie die API für mobile Anwendungen.
Je nach Ihren Anforderungen bietet dieser Ansatz mehrere Vorteile:
  • Vollständige Kontrolle: Passen Sie die Anzeige der Variation an Ihre Design- und UX-Standards an.
  • Bessere Leistung: Verwenden Sie optimierte API-Aufrufe, um Seitenladeverzögerungen im Vergleich zu skriptbasierten Lösungen zu reduzieren.
  • Einfacheres Debugging: Protokollieren, überwachen und debuggen Sie Integrationen innerhalb Ihrer Client-Codebasis mit Standardwerkzeugen.
  • Keine Abhängigkeit von Drittanbieter-Skripten: Verwenden Sie direkte Aufrufe, um externe Skripte zu vermeiden, potenzielle Konflikte zu reduzieren und mit Sicherheitsrichtlinien übereinzustimmen.
  • SPA-freundlich: Integrieren Sie direkt in Single-Page-Anwendungen, um Timing-Probleme zu vermeiden und in das clientseitige Routing zu passen.
  • Widerstandsfähigkeit gegen Ad Blocker: Liefern Sie Experimente konsistent ohne Drittanbieter-Skripte oder spezifische HTML-Marker. Weitere Details darüber, wie Ad Blocker Kameleoon beeinflussen, finden Sie in den FAQ.

Ziel

Rufen Sie eine Produktkollektion von der Empfehlungs-Engine ab und rendern Sie sie in Ihrem Frontend. Das folgende Bild zeigt beispielsweise eine auf einer Homepage gerenderte Kollektion:
Product Collections

Voraussetzungen

  • Ein gültiges Kameleoon-Konto mit einer Store-ID (shop_id).
    • Holen Sie Ihre shop_id in Recommendations > Settings > Store settings in der Kameleoon App. Kontaktieren Sie Ihren Customer Success Manager, falls erforderlich, um den Schlüssel zu erhalten.
Store Key
  • Eine collection_id aus dem Bereich Product Collections des Dashboards. Dieser Abschnitt listet Ihre konfigurierten Kollektionen und deren IDs auf.
Collection ID
  • Eine Device-ID (did) und eine Session-ID (sid). (Nur erforderlich, wenn Filter oder Algorithmen verwendet werden, die auf historischen Geräte-/Benutzerdaten basieren).
    • Für Kameleoon Web Experimentation holen Sie diese aus den folgenden Cookies:
      • KameleoonProducts_device_idDevice-ID (did)
      • KameleoonProducts_session_codeSession-ID (sid)
    • Andernfalls generieren Sie diese Werte manuell.

Schritte

1. Cookies abrufen (nur Kameleoon Web Experimentation)

Generieren Sie diese Werte manuell für Backend-Implementierungen oder Umgebungen ohne Kameleoon Web Experimentation. Details finden Sie im Init-Endpoint.

2. Anfrage

Endpoint:
Ersetzen Sie {collection-id} durch den Wert aus den Voraussetzungen.
Um die Kollektion plattformübergreifend für Benutzer zu personalisieren, verwenden Sie die als Kameleoon Custom Data konfigurierte external_id anstelle der did.
Beispiel:

3. Antwort

Die mobile App kann html ignorieren.
Die API gibt kein CSS zurück; Sie müssen die Ausgabe manuell gestalten.
Beispiel: