Implementierung von Analytics für Target

Bei der Implementierung von Adobe Analytics als Berichtsquelle für Adobe Target (A4T) sind mehrere Schritte erforderlich. Der Prozess variiert je nachdem, ob Sie A4T mit Adobe Experience Platform Web SDK oder mit at.js implementieren.

Adobe Experience Platform Web SDK- BadgeImplementierungsschritte für eine Adobe Experience Platform Web SDK-Implementierung

In den folgenden Abschnitten werden die Schritte beschrieben, die zum Bereitstellen dieser Integration auf Ihrer Site erforderlich sind, wenn Sie das Platform Web SDK verwenden möchten:

Schritt 1: Anfordern der Bereitstellung für Analytics und Target

Vor der Implementierung von A4T müssen Sie für Analytics und Target bereitgestellt werden. Verwenden Sie dieses Formular, um die Bereitstellung anzufordern.

Schritt 2: Einrichten der Benutzerberechtigungen

Die Benutzerkontoanforderungen müssen erfüllt sein, bevor Sie eine Aktivität erstellen können, die auf Analytics in Target basiert. Siehe Anforderungen an Benutzerberechtigungen.

Schritt 3: Erstellen einer Edge-Konfiguration

Erstellen Sie eine Edge-Konfiguration mit Adobe Experience Platform Launch mithilfe des Edge-Konfigurationstools. Konfigurieren Sie die Analytics and Target Edge-Konfigurationseinstellungen.

Schritt 4: Installieren und Konfigurieren des Platform Web SDK

Um mit der Bereitstellung von Target-Erlebnissen zu beginnen und Analytics für Tracking- und Analysezwecke anzuwenden, Installieren und Konfigurieren Sie das Platform Web SDK auf Ihren Webseiten.

Schritt 5: Aktivieren der Optionen für die Verwendung von A4T

Klicken Sie in der Target -Benutzeroberfläche auf Administration > Visual Experience Composer und wählen Sie dann entweder Pro Aktivität auswählen oder Adobe Analytics.

  • **Pro Aktivität auswählen ermöglicht Ihnen die Auswahl zwischen und beim Erstellen der einzelnen Aktivitäten.**TargetAnalytics
  • **Adobe legt Analytics als Berichtsquelle für alle von Ihnen erstellten Aktivitäten fest.**Analytics

at.js badgeImplementierungsschritte für eine at.js-Implementierung

In den folgenden Abschnitten werden die Schritte beschrieben, die zum Bereitstellen dieser Integration auf Ihrer Site erforderlich sind, wenn Sie at.js verwenden möchten:

Schritt 1: Anfordern der Bereitstellung für Analytics und Target

Nachdem Sie Analytics als Berichtsquelle für Target implementiert haben, müssen Sie für Analytics und Target bereitgestellt werden. Verwenden Sie dieses Formular, um die Bereitstellung anzufordern.

Schritt 2: Einrichten der Benutzerberechtigungen

Die Benutzerkontoanforderungen müssen erfüllt sein, bevor Sie eine Analytics-basierte Aktivität in Target erstellen können. Siehe Anforderungen an Benutzerberechtigungen.

Schritt 3: Implementieren des Experience Cloud-Besucher-ID-Service

Mit dem Besucher-ID-Service können Sie Benutzer über Adobe Experience Cloud-Lösungen hinweg identifizieren. Implementieren oder migrieren Sie die erforderliche Version der Experience Cloud-Besucher-ID. Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Siehe Implementieren des Experience Cloud-ID-Diensts für Target in der Experience Cloud-Besucher-ID-Dienst -Dokumentation.

Schritt 4: Aktualisierung von AppMeasurement für JavaScript oder s_code

Implementieren oder migrieren Sie die erforderliche Version von appMeasurement.js. Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Neue Implementierungen finden Sie unter Übersicht über die JavaScript-Implementierung im Analytics-Implementierungshandbuch.

Informationen zur Migration finden Sie unter Migration zu AppMeasurement für JavaScript im Analytics-Implementierungshandbuch.

Schritt 5: Herunterladen und Aktualisieren von at.js

Implementieren oder migrieren Sie mithilfe Ihres Produktionskontos zur erforderlichen Version von at.js. Es müssen keine Änderungen am Code vorgenommen werden.

Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Schritt 6: "at.js"hosten

Wenn Sie at.js bereits bereitgestellt haben, können Sie Ihre vorhandene Datei durch die aktualisierte Version ersetzen. Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Alternativ kann diese Datei zusammen mit dem Besucher-ID-Service und AppMeasurement for JavaScript-Dateien gehostet werden. Diese Dateien müssen auf einem Webserver gehostet werden, der für alle Seiten Ihrer Site zugänglich ist. Für den nächsten Schritt benötigen Sie den Pfad zu den Dateien.

Schritt 7: Verweisen auf at.js auf allen Seiten der Site

Fügen Sie at.js unterhalb von VisitorAPI.js ein, indem Sie dem Tag auf jeder Seite die folgende Codezeile hinzufügen:

Für at.js:

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

Die Datei VisitorAPI.js muss vor at.js geladen werden. Wenn Sie eine vorhandene at.js- oder mbox.js-Datei aktualisieren, überprüfen Sie die Ladereihenfolge.

Die Standardeinstellung für die Integration von Target und Analytics aus Implementierungsperspektive besteht darin, die von der Seite übergebene SDID zu verwenden, um die Anforderung Target und Analytics automatisch am Backend zuzuordnen.

Sie können steuern, wie und wann Analysedaten zu Berichtszwecken an Target Analytics gesendet werden. Wenn Sie die Standardeinstellungen Target und Analytics nicht automatisch mit den Analysedaten über die SDID verknüpfen möchten, setzen Sie analyticsLogging = client_side über window.targetGlobalSettings. Hinweis: Keine Version unter 2.1 unterstützt diesen Ansatz.

Beispiel:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Diese Einrichtung hat einen globalen Effekt, d. h. jeder Aufruf von at.js hat analyticsLogging: "client_side", die innerhalb der Target-Anforderungen gesendet werden, und für jede Anfrage wird eine Analytics-Nutzlast zurückgegeben. Wenn diese Option eingerichtet ist, sieht das Format der zurückgegebenen Payload wie folgt aus:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

Die Payload kann dann über die Dateneinfüge-API an Analytics weitergeleitet werden. Bei Aktivitäten mit automatischer Zuordnung und automatischem Targeting müssen Sie auch die sessionId weiterleiten. Weitere Informationen finden Sie unter Analytics for Target (A4T) reporting im Handbuch Adobe Target SDKs.

Wenn keine globale Einstellung gewünscht wird und ein bedarfsorientierter Ansatz vorzuziehen ist, verwenden Sie die at.js-Funktion getOffers(), indem Sie analyticsLogging übergeben: "client_side". Die Analytics-Payload wird nur für diesen Aufruf zurückgegeben und das Target-Backend leitet die Payload nicht an Analytics weiter. Bei diesem Ansatz gibt jede at.js Target-Anfrage standardmäßig die Payload zurück, jedoch nur, wenn dies gewünscht und spezifiziert ist.

Beispiel:

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Dieser Aufruf ruft eine Antwort auf, aus der Sie die Analyse-Nutzlast extrahieren können.

Die Antwort sieht wie folgt aus:

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

Die Payload kann dann über die Dateneinfüge-API an Analytics weitergeleitet werden.

Schritt 8: Validieren der Implementierung

Laden Sie Ihre Seiten, nachdem Sie die JavaScript-Bibliotheken aktualisiert haben, um sicherzustellen, dass die mboxMCSDID-Parameterwerte in Target-Aufrufen mit dem sdid-Parameterwert im Analytics-Seitenansichtsaufruf übereinstimmen.

Es ist besonders wichtig zu bestätigen, dass diese Werte in Einzelseiten-Apps (SPA) übereinstimmen, bei denen die Reihenfolge der Aufrufe nicht immer vorhersehbar ist.

HINWEIS

Die Übereinstimmung dieser Werte ist erforderlich, damit A4T ordnungsgemäß funktioniert.

Schritt 9: (Optional) Entfernen des vorherigen Integrationscodes

Adobe empfiehlt, die vorherige Integration zu entfernen, um Ihre Implementierung zu vereinfachen und die Notwendigkeit zur Beseitigung von Systemdiskrepanzen zu beseitigen. Sie können sämtlichen Code entfernen, den Sie für eine vorherige Integration von SC zu T&T bereitgestellt haben, einschließlich mboxLoadSCPlugin.

Schritt 10: Aktivieren der Optionen für die Verwendung von Analytics als Berichtsquelle für Target

Klicken Sie in Target auf Administration > Visual Experience Composer und wählen Sie entweder Pro Aktivität auswählen oder Adobe Analytics aus, um die Optionen zu aktivieren.

  • **Pro Aktivität auswählen ermöglicht Ihnen die Auswahl zwischen und beim Erstellen der einzelnen Aktivitäten.**TargetAnalytics
  • **Adobe legt Analytics als Berichtsquelle für alle von Ihnen erstellten Aktivitäten fest.**Analytics

Auf dieser Seite