Embeds

Grundlagen #

Diese werden verwendet, um Empfehlungen direkt in jede E-Mail innerhalb jedes E-Mail-Clients einzubetten. Es ist der einfachste und flexibelste Weg, bestehende E-Mail-Flows mit Clerks KI zu verbessern.

Eingebettete E-Mail-Empfehlungen bestehen aus einem Embed, in dem du den Namen, die Produktlogik und andere Einstellungen konfigurierst, sowie einem Design, das das Aussehen und das Gefühl der Empfehlungen steuert.

Sobald du Embed und Design konfiguriert hast, kannst du den Embedcode einfach in deine E-Mail-Plattform kopieren und einfügen, um die Ergebnisse an dieser Stelle anzuzeigen.

Konfiguration #

Jede eingebettete E-Mail-Empfehlung verfügt über eine Reihe von Einstellungen, mit denen du sie an dein individuelles E-Mail-Setup anpassen kannst.

Produktlogiken #

Email bietet eine große Auswahl an Product Logics, die du zur Anzeige von Empfehlungen nutzen kannst.

Diese reichen von allgemeinen Logiken wie Best Sellers oder Hot Products bis hin zu vollständig personalisierten wie Recommendations Based On Orders. Product Logics werden auf der Embed-Seite einer eingebetteten E-Mail-Empfehlung konfiguriert.

E-Mail-Plattform #

Clerk bietet Integrationen mit einer Vielzahl von E-Mail-Plattformen an. Für eingebettete Empfehlungen werden die Integrationen verwendet, um zwei spezifische Informationen aus dem E-Mail-Client mittels Merge Tags abzurufen:

• Die E-Mail-Adresse des Empfängers, um mit spezifischen Produktlogiken zu personalisieren.
• Einen Cachebuster, der einen eindeutigen Wert für jede gesendete E-Mail hinzufügt, um Caching zu verhindern, das sonst dieselben Produkte in mehreren E-Mails anzeigen würde.

Durch die Auswahl deiner Plattform aus der Liste werden diese Merge Tags automatisch zum Embedcode hinzugefügt.

Wenn deine E-Mail-Plattform noch nicht Teil der Integrationen ist, wähle einfach Other und füge die Merge Tags manuell ein.

Zusätzliche Argumente #

Einige Logiken erfordern zusätzliche Informationen wie Kategorie-IDs oder Schlagwörter, die im Tab Insert into e-mail hinzugefügt werden.

Embedcode #

Wenn ein Nutzer eine E-Mail mit einem Embedcode öffnet, wird ein Aufruf an Clerks API gemacht, um die Produkte abzurufen. Diese werden über das von dir konfigurierte Design in einem Headless-Browser gerendert und als Bild zur Anzeige in der E-Mail zurückgegeben.

Struktur #

Unten siehst du ein Beispiel für einen Embedcode, der 2 Produkte anzeigt. Jedes Produkt besteht aus einem Link zur Produktseite und einem Bild des Produkts.

<center> 
    <a  class="clerk-email-product" 
        href="https://api.clerk.io/v2/campaigns/click?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=0&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" 
        target="_blank" 
        style="text-decoration: none; ">
        <img src="https://api.clerk.io/v2/campaigns/embed?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=0&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" />
    </a>
    <a  class="clerk-email-product" 
        href="https://api.clerk.io/v2/campaigns/click?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=1&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" 
        target="_blank" 
        style="text-decoration: none; ">
        <img src="https://api.clerk.io/v2/campaigns/embed?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=1&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" />
    </a>
</center>

Links verwenden Aufrufe an campaigns/click, die den Kunden durch Clerks Tracking-System und dann zur Produktseite leiten.

Bilder nutzen Aufrufe an campaigns/embed, die das Bild zum Anzeigen in der E-Mail zurückgeben.

Parameter #

Dies sind die Datenpunkte, die bei den API-Aufrufen verwendet werden:

Der Cachebuster ist notwendig, weil ein einzelner E-Mail-Empfehlungs-Embedcode verwendet werden kann, um Produkte in Tausenden von E-Mails anzuzeigen. Er macht einfach API-Aufrufe an Clerk, wenn die E-Mail von einem Nutzer geöffnet wird.

Da der Bild-Link gleich bleibt, werden viele E-Mail-Clients diesen zwischenspeichern und immer dieselben Produkte anzeigen, anstatt einen neuen API-Aufruf zu machen. Der Cachebuster stellt sicher, dass die E-Mail-Clients jede E-Mail als individuelle Anfrage betrachten.

Tracking #

Die Leistung der eingebetteten Empfehlungen wird durch die URL-Parameter nachverfolgt, die beim Weiterleiten des Nutzers zur Produktseite enthalten sind.

Struktur #

Die Landing-URL enthält:

• Google Analytics UTM-Codes
• Clerks eigene Tracking-Parameter, die von Clerk.js erkannt werden.

Hier ein Beispiel für eine URL:

https://www.theschwartz.com/?utm_source=clerk&utm_medium=email&utm_campaign=personalised-recommendations&utm_content=clerk-recommendations&clerk_product=28081&clerk_labels=Personalised+Recommendations&clerk_api=recommendations%2Akeywords&clerk_n=0&clerk_external=1&clerk_email=gAAAAABnoLO_YDvTRvfT4ed8pRIYjqQzo38JtrdwRIM-VYDuJO8awxImzfgDB3M-Jfr29WUoayvYNV4XxqixK3-bvukeYy6uDEgRfvuomLxhpVLVn6xoUPk%3D

Parameter #

Die UTM-Parameter für Google Analytics können in Tracking Code unter Insert into e-mail angepasst werden, um das gewünschte Tracking abzubilden, während die Clerk-Parameter automatisch im API-Request an campaigns/click hinzugefügt werden.

Die enthaltenen Parameter sind: