Show Menu
THEMEN×

Installieren des SDK

Das Adobe Experience Platform Web SDK steht Ihnen in einem Content Versand-Netzwerk (CDN) zur Verfügung. Sie können auf diese Datei verweisen oder sie herunterladen und in Ihrer eigenen Infrastruktur hosten. Es ist in einer minimierten und nicht-minimierten Version verfügbar. Die nicht minimierte Version ist hilfreich zum Debugging.

Code hinzufügen

Der erste Schritt bei der Implementierung des Adobe Experience Platform Web SDK besteht darin, den folgenden „Basis-Code“ so weit wie möglich in das <head> -Tag Ihres HTML-Codes einzufügen:
<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
  (window,["alloy"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/1.0.0/alloy.min.js" async></script>

Der Basis-Code erstellt eine globale Funktion namens alloy . Verwenden Sie diese Funktion, um mit dem SDK zu interagieren. Wenn Sie der globalen Funktion einen anderen Namen geben möchten, können Sie den alloy -Namen wie folgt ändern:
<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
  (window,["mycustomname"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/1.0.0/alloy.min.js" async></script>

In diesem Beispiel wird die globale Funktion in mycustomname anstatt alloy umbenannt.
Um potenzielle Probleme zu vermeiden, verwenden Sie einen Namen, der mindestens ein Zeichen enthält, das keine Ziffer ist und nicht mit dem Namen einer Eigenschaft in Konflikt steht, die bereits unter window gefunden wurde.
Dieser Basis-Code lädt neben der Erstellung einer globalen Funktion auch zusätzlichen Code, der in einer externen Datei \( alloy.js \) enthalten ist, die auf einem Server gehostet wird. Standardmäßig wird dieser Code asynchron geladen, damit Ihre Web-Seite so leistungsfähig wie möglich ist. Dies ist die empfohlene Implementierung.

Unterstützen von Internet Explorer

Dieses SDK nutzt Promises, um die Fertigstellung asynchroner Aufgaben zu kommunizieren. Die vom SDK verwendete Implementierung von Promises wird nativ von allen Ziel-Browsern mit Ausnahme von Internet Explorer unterstützt. Um das SDK in Internet Explorer verwenden zu können, benötigen Sie ein window.Promise - Polyfill .
So stellen Sie fest, ob Sie bereits über ein window.Promise -Polyfill verfügen:
  1. Öffnen Sie Ihre Website in Internet Explorer.
  2. Öffnen Sie die Debugging-Konsole des Browsers.
  3. Geben Sie window.Promise in die Konsole ein und drücken Sie die Eingabetaste.
Wenn etwas anderes als undefined angezeigt wird, verfügen Sie vermutlich bereits über ein window.Promise -Polyfill. Eine weitere Möglichkeit, um festzustellen, ob ein window.Promise -Polyfill vorliegt, ist das Laden Ihrer Website nach Abschluss der oben genannten Installationsanweisungen. Wenn das SDK einen Fehler ausgibt, in dem ein Promise erwähnt wird, verfügen Sie vermutlich über kein window.Promise -Polyfill.
Wenn Sie festgestellt haben, dass Sie ein window.Promise -Polyfill benötigen, fügen Sie das folgende Skript-Tag über dem zuvor bereitgestellten Basis-Code ein:
<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

Dadurch wird ein Skript geladen, das sicherstellt, dass window.Promise eine gültige Implementierung des Promise ist.

Synchrones Laden der JavaScript-Datei

As explained in the section Adding the code , the base code you have copied and pasted into your website's HTML loads an external file with additional code. Dieser zusätzliche Code enthält die Kernfunktionalität des SDK. Jeder Befehl, den Sie ausführen möchten, während diese Datei geladen wird, wird in die Warteschlange gestellt und nach dem Laden der Datei verarbeitet. Dies ist die leistungsstärkste Installationsmethode.
Unter bestimmten Umständen möchten Sie die Datei jedoch möglicherweise synchron laden \(weitere Details zu diesen Umständen werden später dokumentiert\). Dadurch wird verhindert, dass der Rest des HTML-Dokuments vom Browser analysiert und gerendert wird, bis die externe Datei geladen und ausgeführt wurde. Diese zusätzliche Verzögerung vor der Anzeige von Primärinhalten für Nutzer wird in der Regel nicht empfohlen, kann aber je nach den Umständen sinnvoll sein.
Um die Datei synchron statt asynchron zu laden, entfernen Sie das async -Attribut aus dem zweiten script -Tag, wie nachstehend dargestellt:
<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
  (window,["alloy"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/1.0.0/alloy.min.js"></script>