Shopanbindung via URL
💡 Wie übergebe ich die Produkte in den Warenkorb vom Onlineshop
1. URL zur Anbindung herausfinden
Finde heraus welche URL Dein Shopsystem benutzt um eine Warenkorb-Anbindung zu ermöglichen.
Dazu solltest du zuerst die für den Onlineshop zuständige IT befragen. Alternativ kann Dir der Support oder die Dokumentation des Onlineshops weiterhelfen.
Je nach Shop-System gibt es hierfür einen unterschiedlichen Aufbau der URL. Im Allgemeinen wird der Link folgendermaßen aufgebaut:
<domain>/<url-endpoint>?{{#each recommendations}}
p{{add @index 1}}={{this.ean}}&
q{{add @index 1}}={{this.quantity}}&
u{{add @index 1}}={{this.unit}}&
{{/each}}
Hierbei wird nacheinander jede Empfehlung der Ergebnisseite mit einer ID/Artikelnummer (p), einer Menge (q) und einer Einheit (u) am Warenkorblink ergänzt.
2. "CTA API Button" hinzufügen
Sobald Du den API Link besitzt:
Navigiere in der Workbench Result Page -> Top Section
Füge oben rechts über das Drop Down den Button “CTA API Button” hinzu
Hinterlege den Link im Feld “Template for api call”
Gebe dem Button ein Label bspw, “In den Warenkorb”
3. Beispiele um Produkte in den Warenkorb zu legen
Beispiel: Allgemein
Template:
www.customer.de/shop?{{#each recommendations}}p{{add @index 1}}={{this.id}}&q{{add @index 1}}={{this.amount}}&{{/each}}
Ergebnis:
www.customer.de/shop?p1=AB12&q1=1&p2=AW94&q2=2&p3=DG01&q3=1&
Beispiel: Shopify
Template:
https://customershop.myshopify.com/cart/add?{{#each recommendations}}id[]={{this.id}}&quantity=1&{{/each}}
Ergebnis:
https://customershop.myshopify.com/cart/add?id[]=AB12&quantity=1&id[]=AW94&quantity=2&id[]=DG01&quantity=1&
Beispiel: Produkte anhand bestimmter Attribute in den Warenkorb legen
Nur Produkte mit dem Datenattribut shop_id sollen inklusive Menge in den Warenkorb gelegt werden:
Template:
customer.shop/addtocart?p={{#each recommendations}}{{#if this.shop_id}}{{#unless @first}}-{{/unless}}{{this.shop_id}}{{/if}}{{/each}}&qp={{#each recommendations}}{{#if this.shop_id}}{{#unless @first}}-{{/unless}}{{this.Menge}}{{/if}}{{/each}}
Ergebnis:
customer.shop/addtocart?p=AB12-AW94-DG01&qp=1-2-1
Beispiel: Produkte aus Sort Groups in den Warenkorb legen
Die Produkte sind im Ergebnis in Gruppen unterteilt (Sort Groups), die Artikelnummer steht im Attribut sku. Die Produktmenge ist im Attribut Menge enthalten.
Template:
customer.shop/checkout.addtocart.html?{{#each sortGroups}}p{{add @index 1}}={{#each this.products}}{{this.sku}}{{/each}}&q{{add @index 1}}={{this.Menge}}&{{/each}}
Ergebnis:
customer.shop/checkout.addtocart.html?p1=AB12&q1=1&p2=AW94&q2=2&p3=DG01&q3=1&