Implementierung von Analytics für Target

Bei der Implementierung von Adobe Analytics als Berichtsquelle für Adobe Target (A4T) sind mehrere Schritte erforderlich. Der Vorgang hängt davon ab, ob Sie A4T mit der Adobe Experience Platform Web SDK oder mit at.js implementieren.

Implementierungsschritte für eine Adobe Experience Platform Web SDK-Implementierung platform

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

Schritt 1: Bereitstellung für Analytics und Target anfordern

Bevor Sie A4T implementieren, müssen Sie für Analytics und Target bereitgestellt werden. Verwenden Sie dieses Formular, um die Bereitstellung anzufordern.

Schritt 2: Einrichten der Benutzerberechtigungen

Die Anforderungen an Benutzerkonten 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 mithilfe des Edge-Konfigurations-Tools. Konfigurieren Sie Erstellen und Konfigurieren von Datenströmen.

Schritt 4: Installieren und Konfigurieren von Platform Web SDK

Um mit der Bereitstellung Target Erlebnisse zu beginnen und Analytics für Tracking- und Analysezwecke anzuwenden, SiePlatform Web SDK auf Ihren SiteSeiten.

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 Select per activity oder Adobe Analytics.

Implementierungsschritte für eine at.js-Implementierung section_73961BAD5BB4430A95E073DE5C026277

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 Anforderungen an Benutzerkonten müssen erfüllt sein, bevor Sie eine Analytics Aktivität in Target erstellen können. Siehe Anforderungen an Benutzerberechtigungen.

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

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

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

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

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

Informationen zu neuen Implementierungen finden Sie unter Übersicht über die JavaScript im Analytics-Implementierungshandbuch.

Eine Migration finden Sie unter Migrieren nach AppMeasurement für JavaScript im Analytics-Implementierungshandbuch.

Schritt 5: at.js herunterladen und aktualisieren

Implementieren Sie at.js mit Ihrem Produktionskonto oder migrieren Sie dazu. Es müssen keine Änderungen am Code vorgenommen werden.

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

Schritt 6: Hosten von at.js

Wenn Sie zuvor at.js 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: Referenzieren von at.js auf allen Seiten der Site step7

Fügen Sie at.js unter VisitorAPI.js ein, indem Sie die folgende Codezeile im -Tag auf jeder Seite 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 der Datei „at.js“ geladen werden. Wenn Sie eine vorhandene at.js-Datei aktualisieren, stellen Sie sicher, dass Sie die Ladereihenfolge überprüfen.

Die Standardeinstellung für die Integration von Target und Analytics besteht aus Sicht der Implementierung darin, die von der Seite übergebene SDID zu verwenden, um die Target und Analytics Anfrage automatisch im Backend zusammenzufügen.

Sie können steuern, wie und wann Analysedaten zu Target zu Reporting-Zwecken an Analytics gesendet werden. Wenn Sie sich nicht für die Standardeinstellungen anmelden möchten, Target und Analytics die Analysedaten automatisch über die SDID zusammenfügen, legen Sie analyticsLogging = client_side über window.targetGlobalSettings fest. Hinweis: Keine Version unter 2.1 unterstützt diesen Ansatz.

Beispiel:

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

Diese Einrichtung hat globale Auswirkungen, was bedeutet, dass bei jedem Aufruf von at.js analyticsLogging: „client_side“ innerhalb der Target-Anfragen gesendet und für jede Anfrage eine Analytics-Payload zurückgegeben wird. 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 „Data Insertion API an Analytics weitergeleitet. Bei automatischen Zuordnungs - und automatischen Targeting -Aktivitäten müssen Sie auch die Sitzungs-ID weiterleiten. Weitere Informationen finden Sie unter Berichterstellung von Analytics for Target (A4T im Handbuch Adobe Target SDKs.

Wenn eine globale Einstellung nicht gewünscht ist und ein eher bedarfsorientierter Ansatz vorzuziehen ist, verwenden Sie die at.js-Funktion getOffers(), indem Sie analyticsLogging: „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 standardmäßig die Payload zurück, jedoch nur, wenn sie gewünscht und angegeben wird.

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 „Data Insertion " an Analytics weitergeleitet.

Schritt 8: Validieren der Implementierung step8

Laden Sie die Seiten, nachdem Sie die JavaScript-Bibliotheken aktualisiert haben, um zu bestätigen, 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 Single Page Applications (SPA) übereinstimmen, in denen die Reihenfolge der Aufrufe nicht immer vorhersehbar ist.

Schritt 9: (Optional) Entfernen des vorherigen Integrationscodes

Adobe empfiehlt, die vorherige Integration zu entfernen, um Ihre Implementierung zu vereinfachen und Diskrepanzen zwischen den Systemen zu beseitigen. Sie können jeden Code entfernen, den Sie für eine frühere Integration von SC in 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 > Reporting und wählen Sie entweder Select per activity oder Adobe Analytics aus, um die Optionen zu aktivieren.