Hinzufügen des Einbettungscodes

In dieser Lektion implementieren Sie den asynchronen Einbettungscode der Entwicklungsumgebung Ihrer Tag-Eigenschaft. Außerdem lernen Sie zwei Hauptkonzepte von Tags kennen: Umgebungen und Einbettungscodes.

NOTE
Adobe Experience Platform Launch wird als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform integriert. In der Benutzeroberfläche wurden verschiedene terminologische Änderungen eingeführt, die Sie bei der Verwendung dieses Inhalts beachten sollten:

Lernziele

Am Ende dieser Lektion können Sie:

  • Einbettungscode für Ihre Tag-Eigenschaft abrufen
  • den Unterschied zwischen einer Entwicklungs-, Staging- und Produktionsumgebung erläutern
  • Tag-Einbettungscode zu einem HTML-Dokument hinzufügen
  • Die optimale Position des Tag-Einbettungscodes im Verhältnis zu anderem Code im <head> eines HTML-Dokuments erklären

Kopieren des Einbettungscodes

Der Einbettungscode ist ein <script> -Tag, das Sie auf Ihren Webseiten platzieren, um die in -Tags erstellte Logik zu laden und auszuführen. Wenn Sie die Bibliothek asynchron laden, lädt der Browser die Seite weiter, ruft die Tag-Bibliothek ab und führt sie parallel aus. In diesem Fall ist nur ein Einbettungscode vorhanden, den Sie in den <head> einfügen. (Wenn Tags synchron bereitgestellt werden, gibt es zwei Einbettungscodes: einen für den <head> und einen weiteren für den </body>.)

Klicken Sie im Eigenschaftenübersichtsbildschirm im linken Navigationsbereich auf Umgebungen , um zur Umgebungsseite zu gelangen. Beachten Sie, dass die Entwicklungs-, Staging- und Produktionsumgebungen für Sie erstellt wurden.

Klicken Sie auf „Umgebungen“ in der oberen Navigationsleiste

Diese Umgebungen entsprechen den typischen Phasen im Prozess der Code-Entwicklung und -Veröffentlichung. Der Code wird zuerst von einem Entwickler in einer Entwicklungsumgebung geschrieben. Wenn sie ihre Arbeit abgeschlossen haben, senden sie den Code an eine Staging-Umgebung, in der QA- und andere Teams ihn überprüfen können. Sobald die QA und andere Teams zufrieden sind, wird der Code dann in der Produktionsumgebung veröffentlicht. Dies ist die öffentlich zugängliche Umgebung, die Besucher beim Aufrufen Ihrer Website nutzen.

Tags ermöglichen zusätzliche Entwicklungsumgebungen, was in großen Organisationen nützlich ist, in denen mehrere Entwickler gleichzeitig an verschiedenen Projekten arbeiten.

Dies sind die einzigen Umgebungen, die wir zum Abschluss des Tutorials benötigen. Mithilfe von Umgebungen können Sie unterschiedliche Versionen Ihrer Tags-Bibliotheken unter verschiedenen URLs hosten, sodass Sie neue Funktionen sicher hinzufügen und den richtigen Benutzern (z. B. Entwicklern, QA-Technikern, der Öffentlichkeit usw.) zur Verfügung stellen können. zur richtigen Zeit zur Verfügung stellen können.

Kopieren wir nun den Einbettungscode:

  1. Klicken Sie in der Zeile Entwicklung auf das Installationssymbol Installationssymbol , um das Modal zu öffnen.

  2. Beachten Sie, dass Tags standardmäßig den asynchronen Einbettungscodes entsprechen.

  3. Klicken Sie auf das Kopiersymbol Kopiersymbol , um den Einbettungscode in die Zwischenablage zu kopieren.

  4. Klicken Sie auf Schließen , um das Modal zu schließen.

    Installationssymbol

Implementieren des Einbettungscodes im <head> der HTML-Beispielseite

Der Einbettungscode sollte im <head>-Element aller HTML-Seiten implementiert werden, die die Eigenschaft gemeinsam nutzen werden. Möglicherweise verfügen Sie über eine oder mehrere Vorlagendateien, die den <head> global auf der gesamten Site steuern. So ist es einfach, Tags hinzuzufügen.

Kopieren Sie den HTML-Beispielseitencode und fügen Sie ihn in einen Code-Editor ein. Brackets ist ein kostenloser Open-Source-Editor, falls Sie einen benötigen.

HTML-Seitencode
code language-html
<!doctype html>
<html lang="en">
<head>
    <title>Tags: Sample HTML Page</title>
    <!--Preconnect and DNS-Prefetch to improve page load time. REPLACE "techmarketingdemos" WITH YOUR OWN AAM PARTNER ID, TARGET CLIENT CODE, AND ANALYTICS TRACKING SERVER-->
    <link rel="preconnect" href="//dpm.demdex.net">
    <link rel="preconnect" href="//fast.techmarketingdemos.demdex.net">
    <link rel="preconnect" href="//techmarketingdemos.demdex.net">
    <link rel="preconnect" href="//cm.everesttech.net">
    <link rel="preconnect" href="//techmarketingdemos.tt.omtrdc.net">
    <link rel="preconnect" href="//techmarketingdemos.sc.omtrdc.net">
    <link rel="dns-prefetch" href="//dpm.demdex.net">
    <link rel="dns-prefetch" href="//fast.techmarketingdemos.demdex.net">
    <link rel="dns-prefetch" href="//techmarketingdemos.demdex.net">
    <link rel="dns-prefetch" href="//cm.everesttech.net">
    <link rel="dns-prefetch" href="//techmarketingdemos.tt.omtrdc.net">
    <link rel="dns-prefetch" href="//techmarketingdemos.sc.omtrdc.net">
    <!--/Preconnect and DNS-Prefetch-->
    <!--Data Layer to enable rich data collection and targeting-->
    <script>
    var digitalData = {
        "page": {
            "pageInfo" : {
                "pageName": "Home"
                }
            }
    };
    </script>
    <!--/Data Layer-->
    <!--jQuery or other helper libraries-->
    <script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
    <!--/jQuery-->
    <!--Tags Header Embed Code: REPLACE THE NEXT LINE WITH THE EMBED CODE FROM YOUR OWN DEVELOPMENT ENVIRONMENT-->
    <script src="//assets.adobedtm.com/launch-EN93497c30fdf0424eb678d5f4ffac66dc.min.js" async></script>
    <!--/Tags Header Embed Code-->
</head>
<body>
    <h1>Tags: Sample HTML Page</h1>
    <p>This is a very simple page to demonstrate basic implementation concepts of Tags</p>
    <p>See <a href="https://docs.adobe.com/content/help/de-DE/experience-cloud/implementing-in-websites-with-launch/index.html">Implementing the Experience Cloud in Websites with Tags</a> for the complete tutorial</p>
</body>
</html>

Ersetzen Sie den vorhandenen Einbettungscode in Zeile 34 (oder den umliegenden Zeilen) durch den Code in der Zwischenablage und speichern Sie die Seite. Öffnen Sie die Seite jetzt in einem Webbrowser. Wenn Sie die Seite mit dem file://-Protokoll laden, müssen Sie in Ihrem Code-Editor „https:“ am Anfang der Einbettungscode-URL hinzufügen). Die Zeilen 33 bis 36 Ihrer Beispielseite sollten etwa wie folgt aussehen:

    <!--Tags Header Embed Code: REPLACE LINE 39 WITH THE EMBED CODE FROM YOUR OWN DEVELOPMENT ENVIRONMENT-->
    <script src="https://assets.adobedtm.com/launch-ENa21cfed3f06f4ddf9690de8077b39e81-development.min.js" async></script>
    <!--/Tags Header Embed Code-->

Öffnen Sie die Entwicklertools Ihres Webbrowsers und rufen Sie die Registerkarte „Netzwerk“ auf. An dieser Stelle sollte ein 404-Fehler für die URL der Tag-Umgebung angezeigt werden:
404 error

Der 404-Fehler wird erwartet, da Sie noch keine Bibliothek in dieser Tags-Umgebung erstellt haben. Hierzu kommen wir in der nächsten Lektion. Wenn anstelle eines 404-Fehlers die Meldung „Fehlgeschlagen“ angezeigt wird, haben Sie wahrscheinlich vergessen, das https://-Protokoll im Einbettungscode hinzuzufügen. Sie müssen das https://-Protokoll nur angeben, wenn Sie die Beispielseite mit dem file://-Protokoll laden. Nehmen Sie die Änderung vor und laden Sie die Seite neu, bis der 404-Fehler angezeigt wird.

Best Practices für die Implementierung von Tags

Nehmen wir einen Moment Zeit, um einige der Best Practices für die Implementierung von Tags zu überprüfen, die auf der Beispielseite veranschaulicht werden:

  • Daten-Layer:

    • Wir empfehlen dringend, eine Datenschicht auf Ihrer Site zu erstellen, die alle Attribute enthält, die zum Füllen von Variablen in Analytics, Target und anderen Marketing-Lösungen erforderlich sind. Diese Beispielseite enthält nur einen sehr einfachen Daten-Layer. Ein echter Daten-Layer kann viele weitere Details über Seite, Besucher, Warenkorbdetails usw. enthalten. Weitere Informationen zu Daten-Layern finden Sie in Customer Experience Digital Data Layer 1.0.

    • Definieren Sie Ihre Datenschicht vor dem Tag-Einbettungscode, um die Möglichkeiten von Experience Cloud-Lösungen zu maximieren.

  • JavaScript Helper-Bibliotheken: Wenn Sie bereits eine Bibliothek wie JQuery in der <head> Ihrer Seiten implementiert haben, laden Sie sie vor Tags, um ihre Syntax in Tags und Target zu nutzen.

  • HTML5-Doctype: Der HTML5-Doctype ist für Target erforderlich.

  • Vorabladen und DNS-Vorabruf: Verwenden Sie diese Funktionen, um die Seitenladezeit zu optimieren. Siehe auch: /https://w3c.github.io/resource-hints/

  • Codeausschnitt zur Vorab-Ausblendung für asynchrone Target-Implementierungen: Weitere Informationen dazu finden Sie in der Lektion zu Target. Wenn Target jedoch über asynchrone Tag-Einbettungscodes bereitgestellt wird, sollten Sie einen Codeausschnitt zur Vorab-Ausblendung auf Ihren Seiten vor den Tag-Einbettungscodes fest codieren, um das Flackern von Inhalten zu verhindern.

Im Folgenden finden Sie eine Zusammenfassung dieser Best Practices in der empfohlenen Reihenfolge. Beachten Sie, dass es einige Platzhalter für kontospezifische Details gibt:

<!doctype html>
<html lang="en">
<head>
    <title>Basic Demo</title>
    <!--Preconnect and DNS-Prefetch to improve page load time. REPLACE "techmarketingdemos" WITH YOUR OWN AAM PARTNER ID, TARGET CLIENT CODE, AND ANALYTICS TRACKING SERVER-->
    <link rel="preconnect" href="//dpm.demdex.net">
    <link rel="preconnect" href="//fast.techmarketingdemos.demdex.net">
    <link rel="preconnect" href="//techmarketingdemos.demdex.net">
    <link rel="preconnect" href="//cm.everesttech.net">
    <link rel="preconnect" href="//techmarketingdemos.tt.omtrdc.net">
    <link rel="preconnect" href="//techmarketingdemos.sc.omtrdc.net">
    <link rel="dns-prefetch" href="//dpm.demdex.net">
    <link rel="dns-prefetch" href="//fast.techmarketingdemos.demdex.net">
    <link rel="dns-prefetch" href="//techmarketingdemos.demdex.net">
    <link rel="dns-prefetch" href="//cm.everesttech.net">
    <link rel="dns-prefetch" href="//techmarketingdemos.tt.omtrdc.net">
    <link rel="dns-prefetch" href="//techmarketingdemos.sc.omtrdc.net">
    <!--/Preconnect and DNS-Prefetch-->
    <!--Data Layer to enable rich data collection and targeting-->
    <script>
    var digitalData = {
        "page": {
            "pageInfo" : {
                "pageName": "Home"
                }
            }
    };
    </script>
    <!--/Data Layer-->
    <!--jQuery or other helper libraries-->
    <script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
    <!--/jQuery-->
    <!--prehiding snippet for Adobe Target with asynchronous tags deployment-->
    <script>
        (function(g,b,d,f){(function(a,c,d){if(a){var e=b.createElement("style");e.id=c;e.innerHTML=d;a.appendChild(e)}})(b.getElementsByTagName("head")[0],"at-body-style",d);setTimeout(function(){var a=b.getElementsByTagName("head")[0];if(a){var c=b.getElementById("at-body-style");c&&a.removeChild(c)}},f)})(window,document,"body {opacity: 0 !important}",3E3);
    </script>
    <!--/prehiding snippet for Adobe Target with asynchronous tags deployment-->
    <!--Tags Header Embed Code: REPLACE LINE 39 WITH THE INSTALL CODE FROM YOUR OWN DEVELOPMENT ENVIRONMENT-->
    <script src="//assets.adobedtm.com/launch-EN93497c30fdf0424eb678d5f4ffac66dc.min.js" async></script>
    <!--/Tags Header Embed Code-->
</head>
<body>
    <h1>Tags Basic Demo</h1>
    <p>This is a very simple page to demonstrate basic concepts of tags</p>
</body>
</html>

Jetzt wissen Sie, wie Sie den Tag-Einbettungscode zu Ihrer Site hinzufügen können!

Weiter mit "Hinzufügen eines Datenelements, einer Regel und einer Bibliothek">

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2