Zum Hauptinhalt springen
GET
/
endpoint
Sitzung initialisieren
curl --request GET \
  --url https://api.example.com/endpoint
Bevor Sie eine andere API-Methode in der Product Recommendation API verwenden, rufen Sie die init-API auf. Der Initialisierungsprozess akzeptiert den aktuellen Benutzeridentifikator und fordert die Projekteinstellungen sowie die Benutzereinstellungen an.

​
HTTP-Anfrage

GET https://api.products.kameleoon.com/init

​
Wann initialisieren

Je nach Plattform gibt es unterschiedliche Anforderungen, wann Sie init ausführen müssen:
  • cURL: Initialisieren Sie bei jedem Rendern der Seite.
  • Web: Initialisieren Sie bei jedem Öffnen der Seite (einschließlich Single-Page-Anwendungen).
  • iOS oder Android: Initialisieren Sie bei jedem Start der Anwendung.
Beim ersten Start auf einem neuen Gerät fehlt ein Gerätekennzeichner. Rufen Sie die Methode init ohne Device-ID auf, um eine zu generieren. Für die Backend-Empfehlungslogik mit Kameleoon Web Experimentation rufen Sie diese API auf und speichern Sie die IDs im Cookie KameleoonProducts_session_code für sid und KameleoonProducts_device_id für did.

​
Abfrageparameter

ParameterTypErforderlichBeschreibung
shop_idStringTrueIhr Store Key. Sie finden ihn in Recommendations > Settings > Store settings in der Kameleoon App. Sie können sich auch an Ihren Customer Success Manager wenden, um den Schlüssel zu erhalten
didStringFalseEine Device-ID. Wenn bereits eine Device-ID vorhanden ist, geben Sie diese hier an. Wenn Sie keine did angeben, generiert die API eine neue in der Kameleoon-Datenbank. Verwenden Sie diese generierte ID als Device-ID für alle zukünftigen Anfragen
sidStringTrue*Eine Session-ID ist ein temporärer Identifikator, der dem Benutzer für die aktuelle Sitzung zugewiesen wird. Sie muss eine eindeutige Zeichenfolge sein und wird bei jeder neuen Sitzung neu generiert. Geben Sie für die anfängliche init-Anfrage keine sid an. Die sid wird von Kameleoon generiert und in der API-Antwort zurückgegeben. Wenn in der Anfrage eine sid angegeben wird, die nicht im System vorhanden ist, tritt ein Fehler auf.
Obwohl der Parameter sid erforderlich ist, fügen Sie ihn bei der ersten Initialisierung nicht hinzu, da das System ihn generiert und in der Antwort zurückgibt (als seance).Sobald die sid generiert ist, verwenden Sie die vom System generierte sid für Anfragen innerhalb der aktuellen Sitzung.