Show Menu
THEMEN×

Installieren des SDK

Die bevorzugte Methode zur Verwendung des Adobe Experience Platform Web SDK ist über Adobe Experience Platform Launch . Suchen Sie nach dem AEP Web SDK im Erweiterungskatalog, installieren Sie die Erweiterung und konfigurieren Sie sie.
Das AEP Web SDK steht Ihnen auch auf einem 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.
URL-Struktur: https://cdn1.adoberesources.net/alloy/ # /alloy.min.js OR metal.js für die nicht minimierte Version.
Beispiel:

Code hinzufügen

The first step in implementing the Adobe Experience Platform Web SDK is to copy and paste the following "base code" as high as possible in the <head> tag of your HTML:
<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/2.1.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/2.1.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. The Promise implementation used by the SDK is natively supported by all target browsers except Internet Explorer. To use the SDK on Internet Explorer, you need to have window.Promise polyfilled .
So stellen Sie fest, ob Sie bereits über ein window.Promise -Polyfill verfügen:
  1. Open your 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.
Wenn Sie sich dafür entscheiden, eine andere Promise-Implementierung zu laden, stellen Sie sicher, dass sie unterstützt Promise.prototype.finally .

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/2.1.0/alloy.min.js"></script>